home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / cs2pmm_m.zip / cs2pmm_m.INF (.txt) < prev    next >
OS/2 Help File  |  1999-11-16  |  21KB  |  413 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Overview ΓòÉΓòÉΓòÉ
  3.  
  4. This electronic book is the User's Guide for the program Cs2PMM_m. 
  5.  
  6. Cs2PMM_m.cmd. is a small REXX script which reads the .msg and .sav files 
  7. produced by Golden CommPass (hereafter GCP) and converts them to a format that 
  8. is acceptable to PMMail/2.  I wrote it because I had almost 8MB of saved 
  9. mail/forum messages to which I wanted to gain convenient access.  This program 
  10. will take care of your GCP files.  There is another nifty utility from the 
  11. Hobbes archive, mailcut, which will make a similar conversion of saved Netscape 
  12. messages, thereby allowing you to get all of you e-Mail under 'one roof', 
  13. PMMail/2, which has superior message management capabilities compared to either 
  14. of these earlier programs. 
  15.  
  16. I recommend that you read at least the How-To section before starting to 
  17. convert files - reconverting numerous files due to an earlier misunderstanding 
  18. of how the program works is not much fun! 
  19.  
  20. Hypertext links and a table of contents are available in this electronic Book 
  21. to allow different users to ferret out information of specific interest with a 
  22. minimum of effort.  The 'Search' function is also active. 
  23.  
  24. About 
  25.  
  26.  
  27. ΓòÉΓòÉΓòÉ 2. System requirements ΓòÉΓòÉΓòÉ
  28.  
  29. Cs2PMM_m utilizes the 'REXX Utilities' which are supplied with OS/2 and 
  30. installed by default. 
  31.  
  32.  
  33. ΓòÉΓòÉΓòÉ 3. Input Files ΓòÉΓòÉΓòÉ
  34.  
  35. Cs2PMM_m was designed to read the message files created by Golden CommPass. 
  36. These files have the following name patterns: 
  37.  
  38.      *.msg contains the last set of messages that were downloaded 
  39.  
  40.      *.sav contains the messages the user asked GCP to 'save' 
  41.  
  42.  
  43. ΓòÉΓòÉΓòÉ 4. Output Files ΓòÉΓòÉΓòÉ
  44.  
  45. Each translated messages will be placed in an ASCII text file with the name 
  46. C#######.msg in a directory as detailed in the following How-to section. 
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 5. How to Install and Use the program ΓòÉΓòÉΓòÉ
  50.  
  51. Installation is easy - copy the files included in the .zip package you 
  52. downloaded to any convenient directory which is on your system path.  To 
  53. refresh your memory of your directory choices, type 
  54.  
  55. echo %path%
  56.  
  57. at the command prompt.  The following files are contained in the archive 
  58. package: 
  59.  
  60.  ΓûáCs2PMM_m.cmdThe REXX script 
  61.  ΓûáCs2PMM_m.infThe User's Guide you are reading 
  62.  ΓûáJCCALJUL.cmdA REXX script by Jaime A. Cruz, Jr. that calculates the Julian 
  63.       date 
  64.  ΓûáJCDOW.cmdA REXX script by Jaime A. Cruz, Jr. that calculates the day of the 
  65.       week 
  66.  ΓûáJCLEPYER.cmdA REXX script by Jaime A. Cruz, Jr. that identifies leap years 
  67.  ΓûáReadme.txtShort notes to get you started with the installation. 
  68.  
  69.  Since this is a command-line driven program and one that you will probably use 
  70.  only once, the program does not need or create any desktop objects.  It does 
  71.  not modify anything in the system files ('.ini's, config.sys, etc.) 
  72.  
  73.  Cs2PMM_m reads each message file which matches the filename pattern you 
  74.  supply, processes the messages, tagging each as required by PMMail/2 and as 
  75.  detailed in the Translation Details section, and outputs each translated 
  76.  message to a unique file in a directory whose name is based on the input 
  77.  message filename. 
  78.  
  79.  The syntax at the command-line is: 
  80.  
  81.  cs2pmm_m -f[ ]sourceFile [-c#] [-d[ebug]] [-q[uiet]] [-h[elp]] 
  82.  
  83.  This program has been tested with GCP saved message files only.  Possibly, the 
  84.  older TAPCIS files are in the same format and will translate correctly, but I 
  85.  do not have any of these with which to verify this. 
  86.  
  87.  The program must be executed from within the directory containing the source 
  88.  files which match the pattern 'sourceFile'.  If no extension is supplied with 
  89.  the 'sourcefile', then '.sav' is assumed.  The output will be text file(s) 
  90.  named in the pattern 'C000000#.msg' which will be placed in the output 
  91.  directory for the message file.  The output directory name is the GCP input 
  92.  file name with the extension changed to '.FLD'.  You will be prompted for 
  93.  permission to overwrite files if the directory exists and contains messages 
  94.  files. 
  95.  
  96.  For the benefit of 4OS2 users, a space is permitted between the -f and the 
  97.  filename (that TAB key is fantastic! no?). 
  98.  
  99.  The optional '-c#' will be the value that the program uses to construct the 
  100.  ####### portion of the filename of the output text file(s).  # is a numeric 
  101.  value in the range 0 to 9,999,999 (without commas when entered on the command 
  102.  line).  The output filenames will be constructed starting at the supplied 
  103.  'count'.  If this 'count' is omitted, 0 is assumed. 
  104.  
  105.  The optional '-d[ebug]' will cause the program to spout out a copy of some of 
  106.  the header data fields for each found message as it executes - hopefully 
  107.  enough to satisfy you that the conversions are working correctly.  You can use 
  108.  the Pause / Enter keys to pause / continue the program execution when running 
  109.  in debug mode.  The -d option significantly slows the processing, so you 
  110.  probably only want to use it if a problem is suspected. 
  111.  
  112.  The optional '-q[uiet]' will suppress all program output except for error 
  113.  messages.  In this mode 'Yes' is assumed for the processing permission and 
  114.  overwrite permission questions.  E.g., processing proceeds without verifying 
  115.  the filename pattern - and any .msg files in existing directories are 
  116.  overwritten. 
  117.  
  118.  The optional '-h[elp]' will cause the program to display the command-line 
  119.  syntax and offer the option to open this User's Guide. 
  120.  
  121.  Example Usage 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 5.1. Example Usage ΓòÉΓòÉΓòÉ
  125.  
  126. cs2pmm_m -fos2user -c500 -d
  127. would translate the GCP saved message file named 'os2user.sav' from the current 
  128. directory, would generate output message files in the folder 'os2user.fld' in 
  129. the current directory starting with the name 'C0000500.msg', and would display 
  130. debugging information for each message found during the process. 
  131.  
  132. cs2pmm_m -f os2*.msg -q
  133. would translate all GCP saved message file(s) whose name matched the pattern 
  134. 'os2*.msg' from the current directory, would generate output message files 
  135. starting with the name 'C0000000.msg', and would not prompt the user for 
  136. processing permission or overwrite permission(s) ('Yes' is the assumed answer 
  137. to these questions when in 'Quiet' mode). For each GCP message file, a 
  138. directory with the same name as the root of the message file name and the 
  139. extension '.FLD' would be created in the current directory to receive the .msg 
  140. files. 
  141.  
  142.  
  143. ΓòÉΓòÉΓòÉ 5.2. Importing the messages into PMMail/2 ΓòÉΓòÉΓòÉ
  144.  
  145. After running Cs2PMM_m as described above, for each group (output directory) of 
  146. translated messages: 
  147.  
  148.    1. Open PMMail/2 and create a new folder in the PMMail/2 account to receive 
  149.       the new messages.  If you want the messages to be placed in an existing 
  150.       folder, I still recommend creating this 'temporary' folder; you can 
  151.       'drag-n-drop', sort, filter, etc. the new messages to any location and 
  152.       any account after they are imported. 
  153.  
  154.    2. Go to the command-line, drill down to the PMMail/2 folder you just 
  155.       created and then move all of the new 'C#######.msg' files into it. 
  156.  
  157.    3. Return to PMMail/2 and select the new folder; then use Folder->Re-Index 
  158.       to add the msg file(s) generated by this script to the folder.  The 
  159.       messages are now treated like any other in PMMail/2 
  160.  
  161.  
  162. ΓòÉΓòÉΓòÉ 6. Translation details ΓòÉΓòÉΓòÉ
  163.  
  164. First principles first:  Absolutely no data from the source message files is 
  165. lost or discarded - everything is written to the output files.  As explained in 
  166. the next section regarding the chosen field mappings, a couple of data items 
  167. are not normally visible in PMMail/2; however, these too can be seen by 
  168. choosing Window->View Full Header from the PMMail/2 menu when the message 
  169. window is open. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ 6.1. Goals and Notes ΓòÉΓòÉΓòÉ
  173.  
  174. The information stored in the GCP message headers is not the same as that 
  175. supplied in a typical SMTP (internet mail) header.  Therefore, some decisions 
  176. had to be made as to where the various pieces of information would be placed in 
  177. the output (PMMail/2) message headers. 
  178.  
  179. Assumptions:  It is presumed that you will want to (initially at least) keep 
  180. the messages grouped by 'Forum'.  E.g., it is intended that you create a 
  181. PMMail/2 folder for each CompuServe 'Forum' and place the translated forum 
  182. messages into this folder. This approach is not a strict requirement; all of 
  183. the translated messages could be placed in a single PMMail/2 folder, but it 
  184. would be difficult to manage them in such an arrangement - some CompuServe 
  185. 'Section' names are the same in multiple 'Forums', making it impossible to sort 
  186. by 'Forum' if you place all messages in the same PMMail/2 folder. 
  187.  
  188. Message Management: Once the messages are in PMMail/2, all of the message 
  189. management features of PMMail/2 are available to you.  You can sort by 
  190. 'Subject', 'To Name', 'CompuServe Section / Subject', 'From Name', 'Thread 
  191. No.', 'Date', etc. and move them into different folders at will.  Text searches 
  192. are much more powerful within PMMail/2 as well, allowing you to span 'Forums' 
  193. in a single search etc. 
  194.  
  195. A primary goal was to preserve the 'threading' information from the CompuServe 
  196. forums.  A secondary goal was to maintain an association with the appropriate 
  197. forum 'Section' since that is the only context within which some of the 
  198. discussions are useful.  This was accomplished by using some fields in the 
  199. PMMail/2 message that would otherwise be blank - as explained next. 
  200.  
  201.  
  202. ΓòÉΓòÉΓòÉ 6.2. Translation Table ΓòÉΓòÉΓòÉ
  203.  
  204. GCP Mail messages can contain useful E-Mail addressing information whereas the 
  205. addressing information in the GCP forum messages is of limited use.  Therefore, 
  206. 'Incoming' CompuServe mail is translated slightly differently than 'Outgoing' 
  207. CompuServe mail and forum messages. This is illustrated in the following table. 
  208.  
  209. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  210. ΓöéPMMail/2        ΓöéGCP Forums and  ΓöéGCP 'Incoming'  ΓöéComments                    Γöé
  211. Γöé                Γöé'Outgoing' Mail ΓöéMail            Γöé                            Γöé
  212. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  213. ΓöéSubject         ΓöéForum Section,  ΓöéSubject         ΓöéConcatenated                Γöé
  214. Γöé                ΓöéSubject         Γöé                Γöé                            Γöé
  215. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  216. ΓöéDate (& Time)   ΓöéDate            ΓöéDate            ΓöéThis is "Date and Time of   Γöé
  217. Γöé                Γöé                Γöé                ΓöéMessage" in the PMMail/2    Γöé
  218. Γöé                Γöé                Γöé                Γöésort list                   Γöé
  219. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  220. ΓöéDate Received   Γöé                Γöé                ΓöéField remains blank. This   Γöé
  221. Γöé                Γöé                Γöé                Γöéfield is not displayable in Γöé
  222. Γöé                Γöé                Γöé                ΓöéPMMail/2                    Γöé
  223. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  224. ΓöéFrom Real Name  ΓöéFrom            ΓöéFrom (extracted Γöé                            Γöé
  225. Γöé                Γöé                ΓöéReal) Name      Γöé                            Γöé
  226. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  227. ΓöéFrom E-Mail     ΓöéFrom            ΓöéFrom (extracted)Γöé                            Γöé
  228. Γöé                Γöé                ΓöéE-mail address  Γöé                            Γöé
  229. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  230. ΓöéTo Real Name    ΓöéIf part of a    ΓöéTo (extracted   Γöé                            Γöé
  231. Γöé                Γöéthread, Thread  ΓöéReal) Name      Γöé                            Γöé
  232. Γöé                ΓöéNo. - else,     Γöé                Γöé                            Γöé
  233. Γöé                ΓöéMessage No.     Γöé                Γöé                            Γöé
  234. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  235. ΓöéTo E-Mail       ΓöéTo              ΓöéTo (extracted)  Γöé                            Γöé
  236. Γöé                Γöé                ΓöéE-Mail address  Γöé                            Γöé
  237. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  238. This mapping allows you to sort the resulting imported messages such that a 
  239. thread stays together (sort order = 'To Real Name'->'Subject'->'From real 
  240. Name'); or the messages of a subject stay together (sort order = 
  241. 'Subject'->'From Real Name'), or by date, of course, or whatever suits your 
  242. purpose. 
  243.  
  244. An effort is made to recover any SMTP (internet) formatted addresses from 
  245. 'Incoming' mail messages, allowing you to successfully use the 'Reply-to' 
  246. function in PMMail/2. 
  247.  
  248.  
  249. ΓòÉΓòÉΓòÉ 7. Errors ΓòÉΓòÉΓòÉ
  250.  
  251. Following are error conditions that could be reported - and suggested 
  252. solutions: 
  253.  
  254.    1. "-Could not locate the help file ... " 
  255.  
  256.    2. "-Could not locate the helpfile Cs2PMM-m.inf. ..." 
  257.  
  258.    3. "-Could not locate the required file JCCALJUL.cmd. ..." 
  259.  
  260.    4. "-Could not locate the required file JCDOW.cmd. ..." 
  261.  
  262.    5. "-Could not locate the required file JCLEPYER.CMD. ..." 
  263.  
  264.           Explanation: Either the file is really missing, or the program files 
  265.            are not installed in the proper directory. 
  266.  
  267.           Solution: Reinstall the program files per the installation 
  268.            instructions. 
  269.  
  270.    6. "-Could not find the OS/2 REXX Utilities" 
  271.  
  272.           Explanation: The complete REXX package is not installed on your 
  273.            system. 
  274.  
  275.           Solution: By default, the OS/2 installation program installs REXX 
  276.            support and the REXX utilities .dll's.  To use Cs2PMM_m, both 
  277.            REXX.dll and REXXUTIL.dll must be in a directory which is on the 
  278.            LIBPATH.  Normally, this is \OS2\DLL.  If these .dll's are not on 
  279.            your system, I do not know how to solve this problem short of a 
  280.            reinstallation - the OS/2 'Selective Install' utility does not offer 
  281.            an option for 'REXX' only. 
  282.  
  283.    7. "-Could not find any GCP message file(s) to match, 'filename' in the 
  284.       current directory." 
  285.  
  286.           Solution: Verify that you are executing Cs2PMM_m from the directory 
  287.            where the GCP message files reside - you cannot successfully launch 
  288.            the program from any other directory. 
  289.  
  290.    8. "-The supplied -c[out] value, 'value', is not numeric.  The value must be 
  291.       in the range 0 to 9,999,998" 
  292.  
  293.           Solution: Use a value within the specified range.  Note that commas 
  294.            are not permitted in the actual value used on the command-line. 
  295.  
  296.  Following are error conditions which will not cause a specific error message 
  297.  to be generated - and suggested solutions: 
  298.  
  299.    1. If you attempt to execute the program from a directory other than the one 
  300.       containing the GCP message files, the program will terminate normally and 
  301.       indicate that it 'processed' the correct quantity of GCP message files. 
  302.       But if you observe the reported quantity of .msg files written, you will 
  303.       see that the value is 0 in each case. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 8. Other Utilities, Hints ΓòÉΓòÉΓòÉ
  307.  
  308. There is a freeware program on the Hobbes archive by the name of 'mailcut.zip' 
  309. which will translate Netscape v 2 thru v 4 saved message files to text files 
  310. just as Cs2PMM_m does for GCP files. Follow the instructions given above to 
  311. import the resulting files to PMMail/2 
  312.  
  313. Hint: Because Cs2PMM_m uses standard I/O, you can redirect the output generated 
  314. by the -d[ebug] option to a file using the '>' operator if desired.  You have 
  315. to use the -q[uiet] command-line option or else 'answer' the Cs2PMM_m prompts 
  316. without ever seeing them when redirecting in this manner. You could use this 
  317. technique to recover - in one file - all of the e-Mail addresses found by 
  318. Cs2PMM_m during processing. You could then write a simple REXX script to 
  319. extract these e-Mail addresses for import to PMMail/2. 
  320.  
  321. Hint: GCP messages which do not have a complete 'date' field will be displayed 
  322. in PMMail/2 with the creation date of the .msg file - i.e. the date and time 
  323. when you ran Cs2PMM_m.  I observed this behavior for only one type of message - 
  324. GCP spam e-Mail. Conveniently, this 'feature' means that when you sort by 'Date 
  325. of Message' in PMMail/2, all of the spam will be at the bottom of the list, 
  326. making it easy to locate (and delete if you so desire). 
  327.  
  328. Hint: If you make a mistake when transferring files to the PMMail/2 directory, 
  329. use PMMail/2 to 'Select All' messages in the folder and then delete them. 
  330. Then, before moving new messages into the same folder, go to the PMMail/2 
  331. 'Trash' folder and empty it. If you do not follow these steps, the results will 
  332. not be what you want or expect.  You cannot simply 'overwrite' the messages in 
  333. a PMMail/2 folder with new data - they must be deleted by PMMail/2 first. 
  334.  
  335. Hint:  I found that the best way to handle the transfer of the converted 
  336. messages to the PMMail/2 folders was to open icon views of the source and 
  337. target folders on the desktop and, using 'View->Select All' and 'drag-n-drop', 
  338. carefully distribute the converted messages to the (already created) PMMail/2 
  339. folders.  The PMMail/2 folder names will not match the description you see in 
  340. PMMail/2, but the naming pattern is fairly obvious after you study it for a 
  341. minute or so. 
  342.  
  343. Thanks: Many thanks to Jaime A. Cruz, Jr. (jaime.cruz@cendant.com) for 
  344. providing the REXX date manipulation routines to the public domain as a part of 
  345. his 'Hello.cmd' utility.  The files in the Cs2PMM_m package are unedited 
  346. identical copies of those in the 'Hello.cmd' package, so if those are already 
  347. on your path, you don't need these.  For reference, the tested versions are: 
  348.  
  349. CCALJUL.CMD     3880   4-02-96   9:52 Jaime A. Cruz, Jr. REXX script, (public domain)
  350. CDOW.CMD        2827   4-01-96  15:43 Jaime A. Cruz, Jr. REXX script, (public domain)
  351. CLEPYER.CMD     1239   3-28-96  15:20 Jaime A. Cruz, Jr. REXX script, (public domain)
  352.  As an aside, 'Hello.cmd' is quite handy as a daily reminder of upcoming dates, 
  353. events, etc.  If you use the 'Scheduler' utility from BackAgain/2 (another 
  354. well-written native OS/2 utility) or another CRON-like daemon, you can schedule 
  355. the 'Hello' script to run once a day to remind you of upcoming events, etc.  Or 
  356. you can put the 'Hello' utility in your startup folder - but this isn't too 
  357. effective on my OS/2 systems - they never quit, so the Startup folder may not 
  358. executes for weeks!  Check it out at Hobbes. 
  359.  
  360.  
  361. ΓòÉΓòÉΓòÉ 9. Support ΓòÉΓòÉΓòÉ
  362.  
  363. Are you kidding?  This is freeware - there is no support.  However, if you 
  364. would like to contact the author, I can be reached via e-Mail to 
  365. bmj01@innovative-engineering.com. 
  366.  
  367.  
  368. ΓòÉΓòÉΓòÉ 10. Legal Notices ΓòÉΓòÉΓòÉ
  369.  
  370.    1. FREEWARE: This software is freeware, released to the public domain by the 
  371.       author.  There is no license required or granted for the use of this 
  372.       software.  You are free to modify this software:  You are free to 
  373.       redistribute this software:  However, upon such modification, all 
  374.       instances of the author's name shall be removed from the software. 
  375.       Furthermore, this helpfile (Cs2PMM_m.inf) shall not be distributed with 
  376.       modified copies of the software. 
  377.  
  378.    2. DISCLAIMER OF WARRANTY: To the maximum extent permitted by applicable 
  379.       law, the author disclaims all warranties, either express or implied, 
  380.       including, but not limited to, implied warranties of merchantability and 
  381.       fitness for a particular purpose, with regard to the Software and 
  382.       accompanying documentation. The author does not warrant that the program 
  383.       will meet your requirements; or will operate in the environment which you 
  384.       may select; or will not modify the source data with which it is used. 
  385.  
  386.       In no event shall the author be liable for any damages whatsoever, 
  387.       including without limitation, damages for loss of business profits, 
  388.       business interruption, loss of information, or other pecuniary loss, or 
  389.       for indirect, consequential, incidental or punitive damages, however 
  390.       caused, arising out of the use of or inability to use this product. 
  391.  
  392.    3. TRADEMARKS: The following products referenced in this document and their 
  393.       trademarks are the property of the companies shown: 
  394.  
  395.       OS/2, REXXInternational Business Machines 
  396.       PMMail/2  BluePoint Software Works, Inc. 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 11. Glossary of Terms and Acronyms ΓòÉΓòÉΓòÉ
  400.  
  401.  GCP       Golden CommPass 
  402.  Hobbes    Very large repository of OS/2 software at http://hobbes.nmsu.edu/ 
  403.  Y2K       Year 2000 (related) 
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  407.  
  408. This is version 0 9-Nov-1999 of the Cs2PMM_m User's Guide. 
  409. Cs2PMM_m.cmd Version history: 
  410.  
  411.      9-Nov-1999 . v 0 9-Nov-1999 : Initial compilation 
  412.  Written by: Bruce M. Judd 
  413.  bmj01@innovative-engineering.com