home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / hwicc1.zip / HWICC1.TXT < prev    next >
Text File  |  1995-02-16  |  12KB  |  287 lines
  1. README
  2. ======
  3.  
  4. WPS Class Collection 1
  5.  
  6. WPS Class Collection 1 is the first of a series of SOM/WPS classes. This
  7. collection will contain the following classes:
  8.  
  9.    HWIAdr   - Address Class
  10.    HWIAdrF  - AddressFolder Class
  11.    HWIAdrRF - AdressReferenceFolder Class
  12.    HWIKon   - Contact Class
  13.    HWIKonF  - ContactFolder Class
  14.  
  15. Please open an OS/2 command window. To create a directory on your harddisk use
  16. the MD (MakeDirectory) command. E.g.:
  17.  
  18.    MD C:\HWI
  19.  
  20. This will create a directory called HWI on your harddisk C:. Now change the
  21. current directory location:
  22.  
  23.    CD C:\HWI
  24.  
  25. Please insert the WPS Class Collection 1 disk into the drive that does support
  26. 3 1/2" disks. Copying the files is that easy:
  27.  
  28.    XCOPY A:\*.* C:\HWI\*.*
  29.  
  30. If your disk drive for 3 1/2" disks has a different name than A: please change
  31. that name in the command shown above.
  32.  
  33. WPS Class Collection 1 will copy the following files onto your system:
  34.  
  35.    HWIADR.DLL   - the Address Class
  36.    HWIADR.HLP   - the Address Class help system
  37.    HWIADRF.DLL  - the AddressFolder Class
  38.    HWIADRRF.DLL - the AddressReferenceFolder Class
  39.    HWIKON.DLL   - the Contact Class
  40.    HWIKON.HLP   - the Contact Class help system
  41.    HWIKONF.DLL  - the ContactFolder Class
  42.    HWICC1.TXT   - the WPS Class Collection 1 README (this file)
  43.    HWIC.DLL     - generic DLLs. If you own other products from me,
  44.    HWIT.DLL       these will contain these files too. You should always take
  45.                   the latest one (date/time). The size of these modules is NOT
  46.                   important.
  47.  
  48. You can only drop the correct objects into the new Folder. The relationship:
  49.  
  50.    HWIAdrF  <-- HWIAdr
  51.    HWIKonF  <-- HWIKon
  52.    
  53. For successful work you need to add the directory, containing the files
  54. mentioned above, to your LIBPATH and SET HELP statement. Both can be found
  55. in your CONFIG.SYS file. If you added them right now, you need to shutdown
  56. and reboot.
  57.  
  58. SOM/WPS classes need to be registered into the IBM SOM/WPS environment. There
  59. are several ways to do so. Some use REXX scripts, I would always suggest to
  60. use the ClassBrowser. ClassBrowser is a separate Shareware application that
  61. fit's all needs for SOM/WPS developer and user. For info on how to obtain
  62. ClassBrowser see the APPLICATIONS section below.
  63.  
  64. After copying the files into a directory and adding this directory to your
  65. LIBPATH and HELP environment, the following steps are neccessary to register
  66. the classes.
  67.  
  68. 1.) Locate Class/Register in ClassBrowser.
  69.  
  70. 2.) Enter the class name in the first entryfield. It's important to write the
  71.     class name exactly as shown above. SOM/WPS does distinguish between small
  72.     and capital letters (e.g. HWIAdr).
  73.     
  74. 3.) Enter the filename (modulname) into the second entryfield. Please don't
  75.     add the drive, not the directories nor the extension ... just the
  76.     modulname (e.g. HWIADR).
  77.     It is possible to enter the full qualified filename, but I would always
  78.     suggest to go the other way. If you enter the full qualified modulename
  79.     there's no way to move the directory, containing the class, to a
  80.     different location. If the directory is found in your LIBPATH, you can
  81.     move the directory, containing the class, to a different location.
  82.     Please remember that you'll have to add this new directory to the LIBPATH
  83.     and PATH before moving.
  84.     
  85. 4.) Press Ok. This will register the class with SOM/WPS. After this the new
  86.     list of classes shows up, you will see the newly created class at the
  87.     bottom of the list. The modulename is expanded to the full qualified name,
  88.     but this will change after moving the modules, containing the classes, to
  89.     a different location.
  90.     
  91. 5.) Repeat steps 1 thru 4 for all classes that are found in the WPS Class
  92.     Collection 1.
  93.     
  94. All classes (yes, the WPFolder ones too) don't add templates by themself. It's
  95. up to you, to do so. Why? If I would add template creation to the WPFolder
  96. class, deregistration of classes would be far more complicated, as it already
  97. is currently. To create templates of the classes you'll have to complete the
  98. following steps:
  99.  
  100. 1.) Select the desired class in the container listing of ClassBrowser
  101.     (e.g. HWIAdr).
  102.  
  103. 2.) Locate Instance/Create.
  104.  
  105. 3.) Enter a title. For example Address for HWIAdr, AddressFolder for HWIAdrF,
  106.     AddressReferenceFolder for HWIAdrRF, Contact for HWIKon and finally
  107.     ContactFolder for HWIKonF.
  108.     
  109. 4.) Select <WP_TEMPS> in the Combobox labeled Folder.
  110.  
  111. 5.) Locate and press the Setup Pushbutton.
  112.  
  113. 6.) Select TEMPLATE=YES in the listbox of the dialog.
  114.  
  115. 7.) Press Ok. The dialog will disappear and the TEMPLATE=YES string will be
  116.     placed into the Entryfield, labeled Setup, on the parent dialog.
  117.     
  118. 8.) Press Ok.
  119.  
  120. 9.) Repeat steps 1 thru 8 for all classes. For example titles see step 3. All
  121.     classes now own an entry in the Templates Folder.
  122.     
  123. After successful registration and successful creation of templates you are
  124. prepared for the OS/2 view of objects. Here are some things you can do:
  125.  
  126. - Drag and Drop templates to every location in you private Desktop hierarchie.
  127.  
  128. - Move objects.
  129.  
  130. - Copy objects.
  131.  
  132. - Delete objects.
  133.  
  134. For successful work with the SOM/WPS here is an example how I did organize my
  135. Desktop (yes I'm using my own classes).
  136.  
  137.  - Desktop                                  (Folder)
  138.    - Data                                   (Folder)
  139.      - Company X                            (Folder)
  140.        - Address                            (AdressFolder)
  141.          - 1. Address                       (Address)
  142.          - 2. Address                       (Address)
  143.        - Contacts                           (ContactFolder)
  144.          - Bee, Mr.                         (Contact)
  145.          - Two, Laura                       (Contact)
  146.        - Documents                          (Folder)
  147.          - *.DES, *.DOC, *.SDW, *.TXT files (Document Files)
  148.        - References                         (AddressReferenceFolder)
  149.          - Wilhelm, Harald                  (Shadow of Wilhelm, Harald Address (not AddressFolder))
  150.        - Reminders                          (ReminderFolder)
  151.          - Birthday                         (Reminder)
  152.      - Gates, Billy-Boy                     (Folder)
  153.        - Address                            (AddressFolder)
  154.          - Gates, Bill                      (Address)
  155.      - Microsoft                            (Folder)
  156.        - Images                             (Folder)
  157.          - OS2Apps                          (Folder)
  158.            - Excel                          (Folder)
  159.              - US                           (Folder)
  160.                - 0300                       (Folder)
  161.                  - *.IMG                    (Disk Images)
  162.      - Wilhelm, Harald                      (Folder)
  163.        - Address                            (AddressFolder)
  164.          - Wilhelm, Harald                  (Address)
  165.        - Documents                          (Folder)
  166.          - *.DES, *.DOC, *.SDW, *.TXT files (Document Files)
  167.        - Projects                           (Folder)
  168.          - HWIAdr                           (Workframe Composite Project Folder)
  169.            - DLL                            (Workframe Project)
  170.            - Source                         (Folder)
  171.        - References                         (AddressReferenceFolder)
  172.          - Company X                        (Shadow of 1. Address)
  173.        - Sheets                             (Folder)
  174.          - *.XLS                            (Sheets files)
  175.          
  176. I think you got an idea. Everybody I was in contact with has a Folder below
  177. Data. If I open that folder, I can get fast access to images, documents I wrote
  178. to the company or the peoples, Projects for companies I worked for, Address
  179. Information as well as references (a place for shadows e.g. this is the
  180. girl-friend of this boy, or this man is working for that company. For a proper
  181. order I always use the complete name of the company (e.g. HaWi Software).
  182. Private contacts get their name written with the Prename after a colon (e.g.
  183. Wilhelm, Harald).
  184.  
  185. The Data directory has a shadow on my Desktop that's all.
  186.  
  187. To answer your question <g>. Yes, I have everything in my Desktop hierarchie.
  188. All kind of files are placed in the 1500 directories below my Desktop
  189. directory. The only thing I had to do, was to move the Desktop directory from
  190. my C: drive to a bigger one. Actually I have 400MB of data in my Desktop
  191. directory.
  192.  
  193. Most people suggest to use Shadows instead. I don't like them. OS/2 will
  194. noticable slow down when thousands of objects have thousands of shadows. My
  195. solution does not need any Shadows, but wait ... the entries in my
  196. AddressReferenceFolders are Shadows, but these are the only Shadows, trust me.
  197.  
  198. All classes place their data into the OS2.INI file. This is the only way, to
  199. have a data/object relationship after a reinstall. Because my classes own
  200. private data there's no buildin mechanism for saving that data. Good luck for
  201. DeskMan/2 users. All classes have an exit for DeskMan/2. DeskMan/2 will know
  202. about and understand the data for all of my classes. DeskMan/2 can be used to
  203. reinstall all objects after a reinstall of the Operating System. All you need
  204. to do, is to Drag and Drop the Desktop onto DeskMan/2, that's all. Please
  205. recognize that there's no other mechanism to save the objects data. DeskMan/2
  206. is the only way to go for my classes.
  207.  
  208. PLEASE DO BACKUPS ON A REGULAR BASE.
  209.  
  210. IF YOU HAVE ANY IDEAS FOR ENHANCEMENTS OF THE EXISTING CLASSES AND/OR IDEAS
  211. FOR NEW CLASSES, PLEASE LET ME NOW. AS THE DIGIT 1 IN THE WPS CLASS
  212. COLLECTION 1 SAYS ... THERE'S LOT TO COME.
  213.  
  214.  
  215.  
  216. APPLICATIONS
  217. ============
  218.  
  219. The following Shareware applications from me are available as Shareware. I
  220. would suggest to place all my products in one directory. Because all my
  221. products share a common code base, it will save you lots of RAM and a huge
  222. amout of disk space when doing so:
  223.  
  224. ClassBrowser
  225. ------------
  226.  
  227. ClassBrowser is a PM based SOM/WPS class browser that doesn't need any
  228. registration in SOM because it's an EXE. It shows much more information
  229. about the classes than any other SOM/WPS class browser. ClassBrowser is
  230. Warp optimized and will not run on releases before Warp. ClassBrowser is
  231. Shareware registration ID 4284.
  232.  
  233. Registration fee is USD 25.
  234.  
  235. SyslevelEditor
  236. ---------------
  237.  
  238. SyslevelEditor is a PM based tool to create new, and to modify and view
  239. existing Syslevel files. SyslevelEditor shows much more information about
  240. the contents of Syslevel files than any other Syslevel Editor. SyslevelEditor
  241. is Warp optimized and will not run on releases before Warp. SyslevelEditor is
  242. Shareware registration ID 4334.
  243.  
  244. Registration fee is USD 25.
  245.  
  246. WPS Class Collection 1
  247. ----------------------
  248.  
  249. The WPS Class Collection 1 contains various WPS classes for home and business
  250. users. These classes can be added and removed with the ClassBrowser (see
  251. above). The classes put their data into the system INI files and have an exit
  252. mechanism for DeskMan/2. DeskMan/2 users can save the privat class data of
  253. these classes. The following classes can be found in that package:
  254.  
  255.  HWIAdr   - Address Class
  256.  HWIAdrF  - AddressFolder Class
  257.  HWIAdrRF - AdressReferenceFolder Class
  258.  HWIKon   - Contact Class
  259.  HWIKonF  - ContactFolder Class
  260.  
  261. All classes can be dropped on any place within your private Desktop hierarchie.
  262. The HWICC1.TXT file does contain some hints and tips how to set up a WPS aware
  263. Desktop hierarchie. The entire WPS Class Collection 1 is Warp optimized and
  264. will not run on releases before Warp. The WPS Class Collection 1 is Shareware
  265. registration ID 4395.
  266.  
  267. Registration fee is USD 25.
  268.  
  269. XBase Spy
  270. ---------
  271.  
  272. XBase Spy is a PM based tool to view existing DBASE III and DBASE IV databases.
  273. It allows to pack databases and to maintain indeces applied to these databases.
  274.  
  275. Registration fee is USD 25.
  276.  
  277.  
  278.  
  279.  Harald Wilhelm
  280.  Am Scheidweg 60
  281.  D-50765 Koeln (Cologne)
  282.  Germany
  283.  Phone: +49 (0) 221 5909099
  284.  Fax:   +49 (0) 221 5909099
  285.  CIS:   100031,1250
  286.  INET:  hawikln@ibm.net
  287.