README ====== WPS Class Collection 1 WPS Class Collection 1 is the first of a series of SOM/WPS classes. This collection will contain the following classes: HWIAdr - Address Class HWIAdrF - AddressFolder Class HWIAdrRF - AdressReferenceFolder Class HWIKon - Contact Class HWIKonF - ContactFolder Class Please open an OS/2 command window. To create a directory on your harddisk use the MD (MakeDirectory) command. E.g.: MD C:\HWI This will create a directory called HWI on your harddisk C:. Now change the current directory location: CD C:\HWI Please insert the WPS Class Collection 1 disk into the drive that does support 3 1/2" disks. Copying the files is that easy: XCOPY A:\*.* C:\HWI\*.* If your disk drive for 3 1/2" disks has a different name than A: please change that name in the command shown above. WPS Class Collection 1 will copy the following files onto your system: HWIADR.DLL - the Address Class HWIADR.HLP - the Address Class help system HWIADRF.DLL - the AddressFolder Class HWIADRRF.DLL - the AddressReferenceFolder Class HWIKON.DLL - the Contact Class HWIKON.HLP - the Contact Class help system HWIKONF.DLL - the ContactFolder Class HWICC1.TXT - the WPS Class Collection 1 README (this file) HWIC.DLL - generic DLLs. If you own other products from me, HWIT.DLL these will contain these files too. You should always take the latest one (date/time). The size of these modules is NOT important. You can only drop the correct objects into the new Folder. The relationship: HWIAdrF <-- HWIAdr HWIKonF <-- HWIKon For successful work you need to add the directory, containing the files mentioned above, to your LIBPATH and SET HELP statement. Both can be found in your CONFIG.SYS file. If you added them right now, you need to shutdown and reboot. SOM/WPS classes need to be registered into the IBM SOM/WPS environment. There are several ways to do so. Some use REXX scripts, I would always suggest to use the ClassBrowser. ClassBrowser is a separate Shareware application that fit's all needs for SOM/WPS developer and user. For info on how to obtain ClassBrowser see the APPLICATIONS section below. After copying the files into a directory and adding this directory to your LIBPATH and HELP environment, the following steps are neccessary to register the classes. 1.) Locate Class/Register in ClassBrowser. 2.) Enter the class name in the first entryfield. It's important to write the class name exactly as shown above. SOM/WPS does distinguish between small and capital letters (e.g. HWIAdr). 3.) Enter the filename (modulname) into the second entryfield. Please don't add the drive, not the directories nor the extension ... just the modulname (e.g. HWIADR). It is possible to enter the full qualified filename, but I would always suggest to go the other way. If you enter the full qualified modulename there's no way to move the directory, containing the class, to a different location. If the directory is found in your LIBPATH, you can move the directory, containing the class, to a different location. Please remember that you'll have to add this new directory to the LIBPATH and PATH before moving. 4.) Press Ok. This will register the class with SOM/WPS. After this the new list of classes shows up, you will see the newly created class at the bottom of the list. The modulename is expanded to the full qualified name, but this will change after moving the modules, containing the classes, to a different location. 5.) Repeat steps 1 thru 4 for all classes that are found in the WPS Class Collection 1. All classes (yes, the WPFolder ones too) don't add templates by themself. It's up to you, to do so. Why? If I would add template creation to the WPFolder class, deregistration of classes would be far more complicated, as it already is currently. To create templates of the classes you'll have to complete the following steps: 1.) Select the desired class in the container listing of ClassBrowser (e.g. HWIAdr). 2.) Locate Instance/Create. 3.) Enter a title. For example Address for HWIAdr, AddressFolder for HWIAdrF, AddressReferenceFolder for HWIAdrRF, Contact for HWIKon and finally ContactFolder for HWIKonF. 4.) Select in the Combobox labeled Folder. 5.) Locate and press the Setup Pushbutton. 6.) Select TEMPLATE=YES in the listbox of the dialog. 7.) Press Ok. The dialog will disappear and the TEMPLATE=YES string will be placed into the Entryfield, labeled Setup, on the parent dialog. 8.) Press Ok. 9.) Repeat steps 1 thru 8 for all classes. For example titles see step 3. All classes now own an entry in the Templates Folder. After successful registration and successful creation of templates you are prepared for the OS/2 view of objects. Here are some things you can do: - Drag and Drop templates to every location in you private Desktop hierarchie. - Move objects. - Copy objects. - Delete objects. For successful work with the SOM/WPS here is an example how I did organize my Desktop (yes I'm using my own classes). - Desktop (Folder) - Data (Folder) - Company X (Folder) - Address (AdressFolder) - 1. Address (Address) - 2. Address (Address) - Contacts (ContactFolder) - Bee, Mr. (Contact) - Two, Laura (Contact) - Documents (Folder) - *.DES, *.DOC, *.SDW, *.TXT files (Document Files) - References (AddressReferenceFolder) - Wilhelm, Harald (Shadow of Wilhelm, Harald Address (not AddressFolder)) - Reminders (ReminderFolder) - Birthday (Reminder) - Gates, Billy-Boy (Folder) - Address (AddressFolder) - Gates, Bill (Address) - Microsoft (Folder) - Images (Folder) - OS2Apps (Folder) - Excel (Folder) - US (Folder) - 0300 (Folder) - *.IMG (Disk Images) - Wilhelm, Harald (Folder) - Address (AddressFolder) - Wilhelm, Harald (Address) - Documents (Folder) - *.DES, *.DOC, *.SDW, *.TXT files (Document Files) - Projects (Folder) - HWIAdr (Workframe Composite Project Folder) - DLL (Workframe Project) - Source (Folder) - References (AddressReferenceFolder) - Company X (Shadow of 1. Address) - Sheets (Folder) - *.XLS (Sheets files) I think you got an idea. Everybody I was in contact with has a Folder below Data. If I open that folder, I can get fast access to images, documents I wrote to the company or the peoples, Projects for companies I worked for, Address Information as well as references (a place for shadows e.g. this is the girl-friend of this boy, or this man is working for that company. For a proper order I always use the complete name of the company (e.g. HaWi Software). Private contacts get their name written with the Prename after a colon (e.g. Wilhelm, Harald). The Data directory has a shadow on my Desktop that's all. To answer your question . Yes, I have everything in my Desktop hierarchie. All kind of files are placed in the 1500 directories below my Desktop directory. The only thing I had to do, was to move the Desktop directory from my C: drive to a bigger one. Actually I have 400MB of data in my Desktop directory. Most people suggest to use Shadows instead. I don't like them. OS/2 will noticable slow down when thousands of objects have thousands of shadows. My solution does not need any Shadows, but wait ... the entries in my AddressReferenceFolders are Shadows, but these are the only Shadows, trust me. All classes place their data into the OS2.INI file. This is the only way, to have a data/object relationship after a reinstall. Because my classes own private data there's no buildin mechanism for saving that data. Good luck for DeskMan/2 users. All classes have an exit for DeskMan/2. DeskMan/2 will know about and understand the data for all of my classes. DeskMan/2 can be used to reinstall all objects after a reinstall of the Operating System. All you need to do, is to Drag and Drop the Desktop onto DeskMan/2, that's all. Please recognize that there's no other mechanism to save the objects data. DeskMan/2 is the only way to go for my classes. PLEASE DO BACKUPS ON A REGULAR BASE. IF YOU HAVE ANY IDEAS FOR ENHANCEMENTS OF THE EXISTING CLASSES AND/OR IDEAS FOR NEW CLASSES, PLEASE LET ME NOW. AS THE DIGIT 1 IN THE WPS CLASS COLLECTION 1 SAYS ... THERE'S LOT TO COME. APPLICATIONS ============ The following Shareware applications from me are available as Shareware. I would suggest to place all my products in one directory. Because all my products share a common code base, it will save you lots of RAM and a huge amout of disk space when doing so: ClassBrowser ------------ ClassBrowser is a PM based SOM/WPS class browser that doesn't need any registration in SOM because it's an EXE. It shows much more information about the classes than any other SOM/WPS class browser. ClassBrowser is Warp optimized and will not run on releases before Warp. ClassBrowser is Shareware registration ID 4284. Registration fee is USD 25. SyslevelEditor --------------- SyslevelEditor is a PM based tool to create new, and to modify and view existing Syslevel files. SyslevelEditor shows much more information about the contents of Syslevel files than any other Syslevel Editor. SyslevelEditor is Warp optimized and will not run on releases before Warp. SyslevelEditor is Shareware registration ID 4334. Registration fee is USD 25. WPS Class Collection 1 ---------------------- The WPS Class Collection 1 contains various WPS classes for home and business users. These classes can be added and removed with the ClassBrowser (see above). The classes put their data into the system INI files and have an exit mechanism for DeskMan/2. DeskMan/2 users can save the privat class data of these classes. The following classes can be found in that package: HWIAdr - Address Class HWIAdrF - AddressFolder Class HWIAdrRF - AdressReferenceFolder Class HWIKon - Contact Class HWIKonF - ContactFolder Class All classes can be dropped on any place within your private Desktop hierarchie. The HWICC1.TXT file does contain some hints and tips how to set up a WPS aware Desktop hierarchie. The entire WPS Class Collection 1 is Warp optimized and will not run on releases before Warp. The WPS Class Collection 1 is Shareware registration ID 4395. Registration fee is USD 25. XBase Spy --------- XBase Spy is a PM based tool to view existing DBASE III and DBASE IV databases. It allows to pack databases and to maintain indeces applied to these databases. Registration fee is USD 25. Harald Wilhelm Am Scheidweg 60 D-50765 Koeln (Cologne) Germany Phone: +49 (0) 221 5909099 Fax: +49 (0) 221 5909099 CIS: 100031,1250 INET: hawikln@ibm.net