home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / cset21v3.zip / INF / DDE3LTT.INF (.txt) < prev    next >
OS/2 Help File  |  1993-10-12  |  55KB  |  360 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Special Notices ΓòÉΓòÉΓòÉ
  3.  
  4. References in this help to IBM products, programs, or services do not imply 
  5. that IBM intends to make these available in all countries in which IBM 
  6. operates. 
  7.  
  8. Any reference to an IBM licensed program in this help is not intended to state 
  9. or imply that only IBM's licensed program may be used. Any functionally 
  10. equivalent product, program, or service that does not infringe any of IBM's 
  11. intellectual property rights may be used instead of the IBM product, program, 
  12. or service. 
  13.  
  14. Evaluation and verification of operation in conjunction with other products, 
  15. except those expressly designated by IBM, is the user's responsibility. 
  16.  
  17. IBM may have patents or pending patent applications covering subject matter in 
  18. this help. The furnishing of this help does not give you any license to these 
  19. patents. 
  20.  
  21. The following terms, denoted by an asterisk (*) in this help, are trademarks of 
  22. the IBM Corporation in the United States and/or other countries: 
  23.  
  24. IBM 
  25. OS/2 
  26. Operating System/2 
  27. Presentation Manager 
  28. WorkFrame/2. 
  29.  
  30. The following terms used in this publication are trademarks of Microsoft 
  31. Corporation. They are denoted by a double asterisk (**) when they appear in the 
  32. text. 
  33.  
  34. Microsoft 
  35. Windows. 
  36.  
  37. This help contains examples of data and reports used in daily business 
  38. operations. To illustrate them as completely as possible, the examples include 
  39. the names of individuals, companies, brands, and products. All of these names 
  40. are fictitious and any similarity to the names and addresses used by an actual 
  41. business enterprise is entirely coincidental. 
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ 2. Start Here ΓòÉΓòÉΓòÉ
  45.  
  46. The IBM* Library Manager lets you create and maintain libraries of object code. 
  47. Library Manager lets you do all that the WorkFrame/2's command line library 
  48. utility, LIB, does while also adding the advantages of a graphical user 
  49. interface. 
  50.  
  51. Like LIB, Library Manager works with standard libraries and import libraries 
  52. but not with dynamic link libraries (DLLs). 
  53.  
  54. This tutorial describes how to use Library Manager to: 
  55.  
  56. o Create a library 
  57. o Add object files to a library 
  58. o Change the characteristics of a library 
  59. o Generate a listing file. 
  60. o Copy object modules to a directory 
  61. o Delete object modules from a library. 
  62.  
  63. Note:  To follow the steps in this tutorial, you need to create a directory on 
  64.        your hard drive as a work space. The tutorial assumes this directory is 
  65.        called 
  66.  
  67.                       D:\TEMPDIR
  68.  
  69.        but you can use another one if you already have a directory with this 
  70.        name. The directory and its contents can be deleted when you have 
  71.        finished the tutorial. Create this directory before moving on to the 
  72.        next panel. 
  73.  
  74. The tutorial takes about 20 minutes to complete. If you feel you need more 
  75. information about using the controls in the Library Manager program, use the 
  76. help that comes with the program. 
  77.  
  78. When you are finished with a tutorial panel, continue to the next one by 
  79. selecting the Forward push button at the bottom of the tutorial window. 
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 3. Overview ΓòÉΓòÉΓòÉ
  83.  
  84.  
  85. ΓòÉΓòÉΓòÉ <hidden>   ΓòÉΓòÉΓòÉ
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ <hidden>   ΓòÉΓòÉΓòÉ
  89.  
  90. You can do many library tasks from the main Library Manager window (shown on 
  91. the left). 
  92.  
  93. The Library field identifies the name of the library you are working on. The 
  94. Object modules container shows the object modules contained in the library. In 
  95. the lower part of the window, the controls grouped under the heading Object 
  96. files let you list files in different directories. You can perform most common 
  97. library operations by simply dragging files and modules between the Object 
  98. modules and Object files controls. Other operations can be performed through 
  99. the pop-up menus found in both the Object modules container and the Object 
  100. files list. Use the online help to learn more about these menus. 
  101.  
  102. For more information, consult the online help. If you want to start this 
  103. tutorial from the Library Manager, select Tutorial from the Help pull-down. 
  104.  
  105.  
  106. ΓòÉΓòÉΓòÉ 4. Dragging Techniques ΓòÉΓòÉΓòÉ
  107.  
  108. The diagram below illustrates some of the operations you can perform through 
  109. direct manipulation. 
  110.  
  111.   ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  112.   Γòæ  IBM Library Manager          Γòæ
  113.   ΓòæΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòæ
  114.   Γòæ                               Γòæ
  115.   Γòæ  Object modules               Γòæ       ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  116.   Γòæ  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ Γòæ       Γòæ A Desktop Object           Γòæ
  117.   Γòæ  Γöé  ΓöîΓöÇΓöÉ     ΓöîΓöÇΓöÉ             Γöé Γòæ  5    ΓòæΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓòæ
  118.   Γòæ  Γöé  ΓööΓöÇΓöÿ     ΓööΓöÇΓöÿ           ΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ                          Γòæ
  119.   Γòæ  Γöé  OBJ1    OBJ2            Γöé Γòæ       Γòæ                            Γòæ
  120.   Γòæ  Γöé                       ΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ                          Γòæ
  121.   Γòæ  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ Γòæ  6    Γòæ                            Γòæ
  122.   Γòæ            Γöé1  Γöé2             Γòæ       Γòæ                            Γòæ
  123.   Γòæ  Files     Γöé   Γöé              Γòæ       Γòæ                            Γòæ
  124.   Γòæ  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÉ            Γòæ       Γòæ                Γöé          Γòæ
  125.   Γòæ  Γöéobj1.obj Γöé    Γöé            Γòæ  3    ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓöéΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓöéΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  126.   Γòæ  Γöéobj2.obj      ΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ           Γöé
  127.   Γòæ  Γöéobj3.obj     ΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  128.   Γòæ  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ            Γòæ  4
  129.   Γòæ                               Γòæ
  130.   ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  131.  
  132. You can: 
  133.  
  134. o Add object modules to the library by dragging object files to the object 
  135.   modules container (1 and 6). Object files can be dragged from the Files list 
  136.   or from anywhere on the Desktop. 
  137.  
  138. o Copy object modules to a directory (2) or folder (5) where they become object 
  139.   files. 
  140.  
  141. o Copy object files to the Desktop (3) and copy Desktop object files to the 
  142.   Files list (4). 
  143.  
  144. You will use some of these direct manipulations in this tutorial. 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 5. Lesson 1: Opening the Library Manager Window ΓòÉΓòÉΓòÉ
  148.  
  149. If you haven't already started the Library Manager utility, do so by 
  150. double-clicking on the Library Manager icon, , in the Tools folder and 
  151. selecting OK when the Product information window appears. 
  152.  
  153. In the following sections of the tutorial, you will be following instructions 
  154. in the panels. At this time you may want to size the tutorial window so you can 
  155. see both it and the Library Manager window. 
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 6. Lesson 2: Creating a New Library ΓòÉΓòÉΓòÉ
  159.  
  160. This lesson shows you how to create a new library. The new library will be 
  161. called TUTLIB.LIB and will reside in the directory D:\TEMPDIR. 
  162.  
  163.  1. Select New from the File pull-down to initialize the controls for a new 
  164.     library. 
  165.  
  166.  2. Replace the text [Untitled] in the Library field with 
  167.  
  168.            d:\tempdir\tutlib.lib
  169.  
  170.     to specify the location and name of the new library. 
  171.  
  172. If the name you typed did not end with the extension ".LIB", Library Manager 
  173. would have appended it. 
  174.  
  175. Note:  To open an existing library, you would select Open from the File 
  176.        pull-down. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 7. Lesson 3: Copying Object Files to the Library ΓòÉΓòÉΓòÉ
  180.  
  181. There are three small object files in the PRJ\LIBTUT subdirectory of the 
  182. WorkFrame/2* directory. Copy these object files to the new library by doing the 
  183. following: 
  184.  
  185.  1. Select the drive where the WorkFrame/2 product is installed using the Drive 
  186.     list. 
  187.  
  188.  2. Using the Directory list, switch to the directory where the WorkFrame/2 
  189.     product is installed. Then switch to the PRJ directory and, lastly, to the 
  190.     LIBTUT directory 
  191.  
  192.  3. Ensure that <Object and Library Files> is selected as the Type of files. 
  193.     The Files directory should now list three object files: TUT1.OBJ, TUT2.OBJ, 
  194.     and TUT3.OBJ. 
  195.  
  196.  4. Click on these files so that they are selected. Then drag them to the 
  197.     Object modules window. 
  198.  
  199. As shown below, the Object modules container now has three object modules: 
  200. TUT1, TUT2, and TUT3. 
  201.  
  202.  
  203. ΓòÉΓòÉΓòÉ 8. Lesson 4: Changing Library Characteristics ΓòÉΓòÉΓòÉ
  204.  
  205. Now that you have created a library and added object modules to it, you can: 
  206.  
  207. o Set the library's page size 
  208. o Specify whether or not searches into the library are to be case-sensitive 
  209. o Include or exclude extended dictionary information. 
  210.  
  211. Because the library is new, these controls are initially set at their default 
  212. values. If the library was not new, the controls would indicate what 
  213. characteristics the library currently has and you could change them as 
  214. required. 
  215.  
  216. In the following steps, you will set the library's page size to 128 and not 
  217. include any dictionary information. 
  218.  
  219.  1. Click on the Settings... item in the Options pull-down to open the Settings 
  220.     note book. 
  221.  
  222.  2. Click on the New library page. 
  223.  
  224.  3. Deselect the Create extended dictionary checkbox to not include an extended 
  225.     dictionary in the library when it is created. 
  226.  
  227.  4. Use the arrows next to the Page size field to adjust the page size to 128. 
  228.  
  229.  5. Close the Settings note book. 
  230.  
  231.  
  232. ΓòÉΓòÉΓòÉ 9. Lesson 5: Creating a Listing ΓòÉΓòÉΓòÉ
  233.  
  234. A listing is an ASCII file indicating the contents of the library. For details 
  235. about interpreting a list file, see the LIB Utility Reference reference in the 
  236. WorkFrame/2 Information folder. 
  237.  
  238. To create a list file and specify its level of detail: 
  239.  
  240.      Select ListingLevel 2 from the Options pull-down. 
  241.  
  242.      The listing is created when the Library Manager is closed or when the 
  243.      library is saved. It will have the same name as the library except that 
  244.      the extension will be LST instead of LIB. 
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ 10. Lesson 6: Creating Object Files from Object Modules ΓòÉΓòÉΓòÉ
  248.  
  249. You may have the situation where you would like to use one or more object 
  250. modules in a library as object files. 
  251.  
  252. In the following steps, you will switch to the directory you created and copy 
  253. two of the object modules to it. 
  254.  
  255.       1. Using the Drive and Directory controls, change the current driver and 
  256.          directory to D:\TEMPDIR. 
  257.  
  258.          At this point, the Files list should be empty since it was created at 
  259.          the beginning of the tutorial and no files have been saved to it. 
  260.  
  261.       2. Click on the TUT2 and TUT3 modules in the Object modules container. 
  262.  
  263.       3. Drag the selected modules from the Object modules container to the 
  264.          Files list. You will see two object files, TUT2.OBJ and TUT3.OBJ, 
  265.          appear as shown below. 
  266.  
  267.  
  268. ΓòÉΓòÉΓòÉ 11. Lesson 7: Deleting An Object Module ΓòÉΓòÉΓòÉ
  269.  
  270. In this lesson, you will remove an object module from the library. Note that 
  271. removing a library's object module does not delete the object file associated 
  272. with it. 
  273.  
  274.       1. Select the TUT3 module in the Object modules container. 
  275.  
  276.       2. Drag it to the Shredder icon on the Desktop. 
  277.  
  278.       3. When the confirmation window appears, select its Delete push button to 
  279.          delete the module. 
  280.  
  281.      You can also delete object modules using the pop-up menu in the Object 
  282.      modules container. 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 12. Lesson 8: Closing the Library Manager ΓòÉΓòÉΓòÉ
  286.  
  287.       1. Select Save from the File pull-down to save the library. 
  288.  
  289.       2. Close Library Manager by double-clicking on its system menu icon. As 
  290.          Library Manager closes, it will create the list file which you can 
  291.          browse with a text editor. 
  292.  
  293.      After the Library Manager window has closed, you can take a look at the 
  294.      listing it created in the D:\TEMPDIR directory. 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 13. Summary ΓòÉΓòÉΓòÉ
  298.  
  299. You have now finished the Library Manager tutorial. 
  300.  
  301. Once you have exited the tutorial, you can delete the D:\TEMPDIR directory and 
  302. its contents. To learn about controls not covered in this tutorial, use the 
  303. online help. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ <hidden> Library ΓòÉΓòÉΓòÉ
  307.  
  308. A library is an organized collection of object code which contains functions 
  309. and data that are already assembled or compiled. Once an object file is 
  310. incorporated into a library, it becomes an object module. 
  311.  
  312. Libraries are used to: 
  313.  
  314.      o Support high level languages. Most compilers include libraries to 
  315.        perform standard operations, such as input/output and floating-point 
  316.        mathematics. 
  317.  
  318.        When your program refers to a library routine, the compiler and linker 
  319.        combine the library routine with your program. 
  320.  
  321.      o Perform complex and specialized activities, such as database management 
  322.        or advanced graphics. You can use your own libraries or specialized 
  323.        libraries supplied by a vendor. 
  324.  
  325.      o Support your own work. If you have created routines that you use with a 
  326.        variety of programs, you may want to consolidate these routines into a 
  327.        library. You can then link to one library. 
  328.  
  329.  
  330. ΓòÉΓòÉΓòÉ <hidden> Output Library ΓòÉΓòÉΓòÉ
  331.  
  332. If you specify a file in outlibrary, LIB creates a new output file with the 
  333. modifications and leaves your input file intact. Otherwise, LIB replaces your 
  334. input file with the modified file. In the latter case, a backup of your 
  335. original input file is stored in the current directory with the file name 
  336. extension ".BAK". 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ <hidden> Object File ΓòÉΓòÉΓòÉ
  340.  
  341. An object file is produced by a compiler or assembler from one or more source 
  342. files. An object file has an extension of ".OBJ". (as in "MYPROJ.OBJ").  In 
  343. LIB, HPFS file names are also supported as long as the file name ends with 
  344. ".OBJ" (as in "MYOBJECTFILE.NEW.OBJ"). 
  345.  
  346.  
  347. ΓòÉΓòÉΓòÉ <hidden> Object Module ΓòÉΓòÉΓòÉ
  348.  
  349. The object module is a self-contained unit within a library of precompiled or 
  350. preassembled routines. When individual object files are combined into a single 
  351. library file, they become object modules. 
  352.  
  353. In LIB, an object module is referred to by its name, without a file extension. 
  354. For example, assume that the object file KEELING.OBJ is inserted into a 
  355. library. It then becomes an object module and is simply referred to as KEELING. 
  356.  
  357.  
  358. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  359.  
  360. Trademark of IBM.