home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / blackb10.zip / BLACKB.INF (.txt) < prev    next >
OS/2 Help File  |  1995-02-10  |  150KB  |  261 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Disclaimer ΓòÉΓòÉΓòÉ
  3.  
  4. Copyright 1995 by Kim Kruse Hansen. All rights reserved. 
  5.  
  6. Commercial distribution and/or use is prohibited without written consent by the 
  7. author. 
  8.  
  9. Except when otherwise stated in writing the author provide BlackBoard/2 "as is" 
  10. without warranty of any kind, either expressed or implied, including , but not 
  11. limited to , the implied warranties of merchantability and fitness for a 
  12. particular purpose. The entire risk as to the quality and performance of 
  13. BlackBoard/2 , and the accuracy of its associated documentation is with you. 
  14.  
  15. Should BlackBoard/2 or its associated documenation prove defective, you assume 
  16. the cost of all necessary servicing , repair or correction. 
  17.  
  18. In no event will Kim Kruse Hansen be responsible in any way for the behaviour 
  19. of BlackBoard/2. In no event will Kim Kruse Hansen and or any other party who 
  20. may redistribute BlackBoard/2 as permitted above, be liable to you for damages, 
  21. including lost profits or other special ,incidental or consequental damages 
  22. arising out of the use  or inability to use (including but not limitied to loss 
  23. of data or data being rendered inaccurate or losses sustained by third parties 
  24. or a failure of the program to operate with any other programs) BlackBoard/2, 
  25. even if Kim Kruse Hansen has been advised of the possibility of such damages , 
  26. or for any claim by another party. 
  27.  
  28.  
  29. ΓòÉΓòÉΓòÉ 2. Prerequisites ΓòÉΓòÉΓòÉ
  30.  
  31. BlackBoard/2 requires DB2/2 1.x and Os/2 2.11 or Os/2 Warp. If you have a 
  32. database system other than DB2/2 , I can't help and you won't be able to run 
  33. BlackBoard/2. I currently have no plans to support other database systems than 
  34. IBM DB2/2. 
  35.  
  36. BlackBoard/2 has been tested with DB2/2 at syslevel WRx7015 ,WRx7025. 
  37.  
  38.  
  39. ΓòÉΓòÉΓòÉ 3. Introduction ΓòÉΓòÉΓòÉ
  40.  
  41.                                   BlackBoard/2
  42.  
  43. BlackBoard/2 is a PM program designed to ease the design of DB2/2 databases. 
  44.  
  45. The program was developed and is being maintained by Kim Kruse Hansen Denmark. 
  46. If you have suggestions and or questions please feel free to contact me. I can 
  47. be reached at the following address 
  48.  
  49.                                 Kim Kruse Hansen
  50.                               Vestergade 133 B 1,4
  51.                                  8600 Silkeborg
  52.                                      Denmark
  53.                              Voice Tlf +45-86802182
  54.  
  55. If you are on the InterNet I can be reached at : 
  56.  
  57. deckkh@inet.uni-c.dk
  58.  
  59. If you are a member of the international Fido network you can get in touch with 
  60. me using NetMail. My Fido network adress is : 
  61.  
  62.                                   2:236/100.13.
  63.  
  64. New version of this program will be available for download at my FidoNet Boss 
  65. Node : 
  66.  
  67.                                    The Jam BBS
  68.                                     2:236/100
  69.                                   +45-45806383
  70.  
  71.  
  72. ΓòÉΓòÉΓòÉ 4. Whats new ΓòÉΓòÉΓòÉ
  73.  
  74. This section describes whats happended to BlackBoard/2 since the last release. 
  75.  
  76. o 25. januar 1995 
  77.  
  78.   First beta 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 5. How to ΓòÉΓòÉΓòÉ
  82.  
  83. To start BlackBoard/2 run BlackB.EXE. It requires the name of the database as a 
  84. parameter. If you have accepted the default database name start BlackBoard/2 
  85. like this : 
  86.  
  87. c:\BlackB>BlackB BLACKB 
  88.  
  89. If you dont supply the database as a program parameter BlackBoard/2 will 
  90. present you with a list of the databases available on your workstation. 
  91.  
  92.  
  93. You can also start it from the BlackBoard/2 folder by clicking on the 
  94. BlackBoard/2 program icon. 
  95.  
  96. After an initial copyright message stating my copyright to the product you will 
  97. enter the project window. 
  98.  
  99. Use the right mouse button to popup the context sensitive menu. Select new to 
  100. create a new project. Projects are defined in the project editor. 
  101.  
  102. Here is a snapshot of the project editor : 
  103.  
  104. The name of a projects must be unique and can not be edited after creation. 
  105.  
  106. When you have created a project in the project editor it will appear in project 
  107. window. If you double click on it the new window should appear. This is the 
  108. actual database design window. Again use the right mouse button to invoke a 
  109. context menu. 
  110.  
  111. The screen above shows a project where I have created 2 tables : 
  112. Customer,Order. The tables were created using the table editor : 
  113.  
  114. The only thing in the table editor that perhaps requires a bit of explanation 
  115. is the check button Foreign Table. When checked this means that the table is 
  116. part of the current project , but that you only refer to it in your project. 
  117. Foreign tables are NOT saved , when you save a project. 
  118.  
  119. Each table in your project is represented by a rectangle. Within each rectangle 
  120. some information is displayed about the table. The info in Yellow is the 
  121. description of the table. The info in green is the actual table name. When you 
  122. create columns for a table the column names or the column descriptions will 
  123. also be displayed within the rectangle. 
  124.  
  125. Move the tables around the workspace by dragging them to a new position . You 
  126. can even drag tables between 2 windows. When you do this the dropped table gets 
  127. the Foreign table attribute automatically.The order table is dependant on the 
  128. customer table. From the line connecting the 2 tables you can gather some 
  129. information. 
  130.  
  131. o The color of the line shows the desired delete rule between the tables. 
  132.  
  133. o The color of the end points shows the cardiality between the tables. 
  134.  
  135. o The type of endpoints shows the relationsship between the tables. A square 
  136.   endpoint shows a parent table and a diamond endpoint shows a dependent table. 
  137.  
  138. Shown above is the same project as before. This time I have defined a column in 
  139. the Customer table : custid. Notice the color of the column name. This column 
  140. is the primary key in the Customer table. In the order table you can also see 
  141. the Custid column. Again notice the color. (I hope you have a color monitor :-) 
  142.  
  143. Columns are created using the column editor : 
  144.  
  145. Some of the windows in the column editor requires some explanation. 
  146.  
  147. o Foreign name 
  148.  
  149.   This is only relevant for columns which are part of the primary key for a 
  150.   table. Use this  when you want a column to have a differnet name in the 
  151.   dependant tables. 
  152.  
  153. o Value set 
  154.  
  155.   This is for documentation use only. Suppose you have a status column which 
  156.   can contain certain values. Describe all legal values in this window. 
  157.  
  158. o User type 
  159.  
  160.   Use this to define a userdefined datatype. Fx create a type named FIRSTNAME 
  161.   with a definition : char(32). If you later decide that you the definition 
  162.   should have been : char(50) the just redefine FIRSTNAME and the change will 
  163.   be reflected in all other tables where you have used the FIRSTNAME type. 
  164.   Userdefined types have project scope. 
  165.  
  166. o Type 
  167.  
  168.   This window lists all available datatypes including evt. userdefined types.
  169.  
  170. So how did I define the relationship between the Order and the Customer table. 
  171. I did this by dragging the Order table on top of the Customer table. 
  172. Put in generel terms you drag the dependant table and drop it on the parent 
  173. table. 
  174.  
  175. On the context menu for the dependant table you will find an entry called keys. 
  176. If you click on Keys you will enter the Key editor. 
  177.  
  178. Shown above is a snapshot of the Key editor. It allows you to define the delete 
  179. rule and cardiality for a foreign key. When you change any of these settings 
  180. notice that the changes are reflected in the database design windows by the 
  181. colours of endpoints and connecting lines. 
  182.  
  183. BlackBoard/2 can be customized to display information in various ways. You 
  184. change the settings by invoking the settings editor : 
  185.  
  186. REMEMBER TO SAVE YOUR PROJECT WHEN YOU ARE DONE 
  187.  
  188.  
  189. ΓòÉΓòÉΓòÉ 6. Misc info ΓòÉΓòÉΓòÉ
  190.  
  191.  
  192. There is NO protection against 2 or more people editing the same project. Well 
  193. not in current release anyway. 
  194.  
  195. There is NO automatic layout feature. 
  196.  
  197. A database reengineering facility is under development but should not be 
  198. expected to appear in any future freeware versions of BlackBoard/2. 
  199.  
  200.  
  201. ΓòÉΓòÉΓòÉ 7. Installation ΓòÉΓòÉΓòÉ
  202.  
  203. Since you are reading this you must already have unzipped the BlackB10.ZIP 
  204. package file. You must place the DLL's contained in BLACKB10.ZIP in a directory 
  205. in a directory on your LIBPATH. 
  206.  
  207. If this is a first time installation you should run the CMD file CreateDB.CMD 
  208. to create the database that BlackBoard/2 requires to operate. When the database 
  209. has been created then the database will be automatically binded. 
  210.  
  211. The database will be created on drive C with the name BLACKB , if this is not 
  212. what you want then you should edit CreateDB.CMD. 
  213.  
  214. The database can without problems be placed on a remote DB2/2 server. If you 
  215. want this kind of setup you should run the CreateDB.CMD on your DB2/2 server. 
  216. On the client workstations accessing the database run the DB2/2 Directory 
  217. services program Direct.Exe to catalog the database. 
  218.  
  219. If any of this causes problems please contact your DB2/2 systems programmer in 
  220. your organisation. 
  221.  
  222. The CMD file DT.CMD creates the BlackBoard/2 folder. 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 8. KKHQuery ΓòÉΓòÉΓòÉ
  226.  
  227. KKHQuery is meant as a replacement for some of the functionality of the IBM 
  228. supplied Query Manager. 
  229.  
  230. It allows you create a query and run it against a DB2 database. The query will 
  231. run asyncronously and present the resulting rows of the query are presented in 
  232. a separate window. 
  233.  
  234. At the moment you are only able to run 1 Query at a time. That is you are able 
  235. to start multiple queries but only 1 of them will complete succesfully ! 
  236.  
  237. When you start KKHQuery you will see a copyright message and then you will see 
  238. a window showing the DB2 databases defined in your system catalog. 
  239.  
  240. When you have selected a database and KKHQuery has connected to it you will 
  241. enter the main query window. 
  242.  
  243. Like in BlackBoard/2 KKHQuery operates through context sensitive menues. So 
  244. just press the right mouse button to define a new query. 
  245.  
  246. The query is defined in the statement editor. 
  247.  
  248. Press run to run your sql statement. 
  249.  
  250. The result of your query is presented in a container like the one shown above. 
  251.  
  252. The pushbutton Stop allows you stop a long running query and the pushbutton 
  253. Show allows you to view a temporary result of a long running query. The SQLCODE 
  254. and nr of rows will be shown in the status window. 
  255.  
  256. To use KKHQuery against a database the package DYNSQL.BND should be bound 
  257. against the your database. You do this with the SQLBIND program : 
  258.  
  259. c:\BlackB>SqlBInd DYNSQL.BND JBUDB999 
  260.  
  261.