home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / GUILIB.ZIP / READ.ME < prev   
Text File  |  1992-05-01  |  12KB  |  235 lines
  1.                                 G U I L I B
  2.  
  3.                  (G)raphical (U)ser (I)nterface (LIB)brarian
  4.  
  5.  
  6.  
  7. Inventory list:
  8.  
  9.    READ.ME              Documentation for installation
  10.  
  11.  
  12.    GUILIB.EXE           PM Library change control system
  13.  
  14.    BTRCALLS.DLL         Btrieve dynamic link library
  15.    GUIBTR.DLL           Btrieve access for GUI products
  16.    GUISEC.DLL           Security module
  17.    GUIPRINT.DLL         Print module
  18.  
  19.    GLUSERS.BTR          User profiles
  20.    GLMESSAG.BTR         GUILIB Message data
  21.    GLASSOC.BTR          GUILIB File Associations
  22.    GLBRANCH.BTR         GUILIB Branch data (code branching)
  23.    GLLANG.BTR           GUILIB Languages
  24.    GLOUT.BTR            GUILIB Checked out data
  25.    GLPROD.BTR           GUILIB Product profiles
  26.    GLMAIN.BTR           GUILIB Main file database
  27.    GLLINK.BTR           GUILIB Product link data
  28.    GLUPDATE.BTR         GUILIB Update history data
  29.  
  30.  
  31. Other ABS products;
  32.  
  33.    ABSCOMP.EXE          PM File compare utility
  34.    EZDOS.EXE            File management utility  OS/2 and DOS
  35.    GUIMAIL.EXE          PM Mail system
  36.  
  37. ***************************************************************************
  38.    WARNING!!!  -- This application (GUILIB) is NOT FREEWARE!!!  It is a 
  39. Shareware application and MUST be registered after 30 days.
  40.    Please register your copy as I value any and all comments about this 
  41. system and I need to know if I should continue developing the system.  I 
  42. appologize for not having any real documentation yet.  The documentation 
  43. is currently being written.
  44. ***************************************************************************
  45.  
  46.    Be warned, this is pre-release code and is subject to lots of changes.
  47. DON'T trust it with your only copy of your source and object files.  Keep
  48. regular backups.
  49.  
  50.         GUILIB requires OS/2 1.2 or higher and can run in a stand-alone
  51. environment.
  52.  
  53.         On the NETWORK select a drive designator to assign to the Library
  54. system.  This should be a drive assigned to a PUBLIC directory, that is 
  55. everyone that enters the network has read/write/create/delete access to.
  56.  
  57.         Create a directory called \LIBRARY or any other name of your
  58. choice.  Copy all of the files into this directory.
  59.  
  60.         The user rights for the \LIBRARY area should be read, execute,
  61. and write.  The system will create a directory off of the \LIBRARY
  62. directory called USERAREA.  Users should have all rights to this as this
  63. is where the user specific work files are placed.
  64.  
  65.     For this example we have chosen drive P:.  On the network the 
  66. LAN alias for the public area on this system is called LIBRARY.  In the
  67. network it is known as \\LAN99\LIBRARY.
  68.  
  69.  
  70. *********************************************************************
  71. Change config.sys as follows on each MACHINE:
  72.  
  73. Add to LIBPATH=...;P:\LIBRARY;
  74.        SET PATH=...;P:\LIBRARY;
  75.        SET DPATH=...;P:\LIBRARY;
  76.  
  77. SET GUILIB=P:\LIBRARY
  78.  
  79.       MAKE SURE THAT THERE ARE NO ; or \ or ANYTHING ELSE AFTER THE
  80.       PATH.
  81.  
  82.    NOTE: Some people may be pointing to the root of LIBRARY after doing
  83.    the net use command.  These people should have their GUILIB= as;
  84.  
  85. SET GUILIB=P:\
  86.  
  87. *********************************************************************
  88. On each machine add the following to the STARTUP.CMD file.
  89.  
  90. LOGON XXX9999 /P=YYYY     (THIS WILL LOG THE USER ONTO THEIR NETWORK)
  91.                           (XXX = IDENTIFIER, 9999 = EMPLOYEE ID.)
  92.                           (YYYY = PASSWORD TO THE NETWORK)
  93.  
  94. NET USE P: \\LAN99\LIBRARY   <- THIS WILL ASSIGN DRIVE P: TO USER
  95. P:
  96. CD \LIBRARY               <- CHANGE TO LIBRARY DIRECTORY CREATED BY YOU
  97. START GUILIB.EXE XXX9999 /P=YYYY /I   <- START GUILIB, LOGON TO IT)
  98. C:                                     ( /I = ICONIZE SYSTEM)
  99.  
  100.  
  101.         To get started, start up GUILIB from the desk top.  A Logon
  102. panel will appear.  Use the User ID of "Master" and a password of "PASSWORD"
  103. (NOTE: logons are CASE sensitive).  Select from the action bar, "Edit" and
  104. then "Users...".  This will bring up a panel for adding and updating user 
  105. information.
  106.  
  107.     Add yourself as a Library Administrator and all others as Normal
  108. Users.  When adding user ID's, I would suggest using the same ID as you
  109. use on the Network logon.  Set up all default passwords the same and
  110. instruct your users to logon and change the default.  
  111.  
  112.     All information except the Net Address and the Middle initial
  113. is mandatory.  I would also suggest that you make the users working
  114. directory the same as the user ID or as close as you can make it if you
  115. use ID's longer than 8 characters.  ALL WORK DIRECTORIES SHOULD BE
  116. UNIQUE!!!!
  117.  
  118.     To add a new product to the library, select New from the File
  119. pulldown on the action bar.  This will display a dialog asking for a new
  120. or existing product name.  If you type in a new name, the program will ask
  121. for a drive and directory of where to add this product.  I would suggest
  122. that you place it under the same directory as the GUILIB executables.  
  123. Using the example above, this would be P:\LIBRARY\PRODNAME.  This will keep
  124. each product in its own directory structure.  The next thing that will
  125. happen is an Association dialog will "Pop" up.
  126.  
  127.     The Association dialog is where you describe the characteristics of
  128. your product.  It asks for the following information;
  129.     Group Name:    This would be a name for the main type of file
  130.             that will be placed in this group, i.e., Executables,
  131.             Source, Link, Support, etc.
  132.     Sub Group Name:    This further breaks down the Group into components;
  133.             Exec, Dynamic Link Libs, Help Manager, Cobol, Headers,
  134.                         etc.
  135.     File Pattern:    This is the file pattern of all files that will be
  136.             placed in this Group - Sub Group;  *.EXE, *.DLL, *.C,
  137.             *.HLP, *.CBL, etc.
  138.     Directory:    This is the path spec of where these files will be 
  139.             placed.  I would suggest that all of one group go
  140.             in the same directory.  This is not a requirement.
  141.             Ex.; P:\LIBRARY\PRODNAME\EXEC
  142.     File Type:    Two choices exist, Source and Non-Source.  Source files
  143.             MUST be text files.  These files will be run thru
  144.             the file compare function at check-in time to keep
  145.             deltas of all the changes.  Non-Source files are
  146.             simply copied back into the library at check-in time
  147.             and only the log files are updated.
  148.     Attributes:    Normal file attributes settings.
  149.     Language:    This is an optional field that can be any source file
  150.             language name like Cobol, C, Pascal, etc.
  151.     Max Users:    This tells the system how to lock the files at check
  152.             out time.  If it is set to 1, only one user at a time
  153.             may check out the file.  Set to a higher number, the 
  154.             system will allow up to that many copied of the file
  155.             to be checked out.  At check in time, all source changes
  156.             from each user are merged back into the original copy.
  157.             NOTE: GUILIB makes no assumptions that the merged code 
  158.             is valid.  All source file should be re-compiled and
  159.             re-tested.
  160.  
  161.     Template Push Button:    Once you have a product setup the way you want
  162.             it, you can hit this button for a New Product to pull 
  163.             in the Associations from an existing product.  This
  164.             will keep you from having to re-type everything for
  165.             each product.
  166.  
  167.     The last step in adding a new product is to add the files.  When you
  168. exit the Associations dialog, a File dialog will appear.  This dialog allows
  169. you to change the drive and path to where your existing files are placed.
  170. When you see your files in the list box, you may then manually select the
  171. files you want placed in the library, or you may hit the Select All button.
  172. The Select All button runs thru the list and selects all files that match the
  173. Associations file patterns.  If a file pattern is not used, the file will
  174. not be selected.  When you hit the Ok button to accept the list, all of the
  175. selected files will be copied to the library and put into their proper
  176. directories.
  177.  
  178.     At this point you are now ready to start the check out, check in 
  179. process.
  180.  
  181.         As always, everything has a price.  The price for using this is
  182. $15.00.  This will register you as a user and will allow me to send you
  183. upgrades of the system as they are made.
  184.  
  185.         If you have any problems, give me a call or write at;
  186.  
  187.                         Mike B. Baker
  188.                  Automated Business Solutions
  189.                       6548 Brookside Cr.
  190.                     Columbia, S.C.  29206
  191.                        (803) 782-4777
  192.  
  193. ╔═════════════════════════════════════════════════════════════════════════════╗
  194. ║                              Registration                                   ║
  195. ╠═══════════════════════════════════════╦═════════════════════════════════════╣
  196. ║ Name                                  ║ Title                               ║
  197. ║                                       ║                                     ║
  198. ╠═══════════════════════════════════════╩═════════════════════════════════════╣
  199. ║ Company                                                                     ║
  200. ║                                                                             ║
  201. ╠═════════════════════════════════════════════════════════════════════════════╣
  202. ║ Address                                                                     ║
  203. ║                                                                             ║
  204. ╠════════════════════════════════════╦════════════════════════════╦═══════════╣
  205. ║ City                               ║ State                      ║ Zip       ║
  206. ║                                    ║                            ║           ║
  207. ╠════════════════════════════════════╩════╦═══════════════════════╩═══════════╣
  208. ║ Business Phone                          ║ Fax #                             ║
  209. ║                                         ║                                   ║
  210. ╠═════════════════════════════════════════╩═══════════════════════════════════╣
  211. ║ Date                                                                        ║
  212. ║                                                                             ║
  213. ╠═════════════════════════════════════════════════════════════════════════════╣
  214. ║ Product(s)                                                                  ║
  215. ║                                                                             ║
  216. ╠═════════════════════════════════════════════════════════════════════════════╣
  217. ║ Comments                                                                    ║
  218. ║                                                                             ║
  219. ║ ─────────────────────────────────────────────────────────────────────────── ║
  220. ║                                                                             ║
  221. ║ ─────────────────────────────────────────────────────────────────────────── ║
  222. ║                                                                             ║
  223. ║ ─────────────────────────────────────────────────────────────────────────── ║
  224. ║                                                                             ║
  225. ║ ─────────────────────────────────────────────────────────────────────────── ║
  226. ║                                                                             ║
  227. ║ ─────────────────────────────────────────────────────────────────────────── ║
  228. ║                                                                             ║
  229. ║ ─────────────────────────────────────────────────────────────────────────── ║
  230. ║                                                                             ║
  231. ║ ─────────────────────────────────────────────────────────────────────────── ║
  232. ║                                                                             ║
  233. ║                                                                             ║
  234. ╚═════════════════════════════════════════════════════════════════════════════╝
  235.