home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / mime2cis.arj / MIME2CIS.DOC < prev    next >
Encoding:
Text File  |  1996-09-12  |  4.7 KB  |  139 lines
  1. MIME2CIS Copyright 1996 (c) Murray F Freeman
  2.                             Postfach 119
  3.                             CH 6052 Hergiswil
  4.                             Switzerland
  5.  
  6. Registration fee US$10.  GO SWREG number 12483 
  7.   
  8. The program does the following:
  9.  
  10. Strips out the Internet Routing Garbage at the start of CIS emails.
  11.  
  12. Converts MIME encoded extended ASCII characters to either DOSCIM or WINCIM
  13. format, so that ß appears not as =DF, but as the sz character used in German.
  14.  
  15. MIME2CIS will also:
  16.  
  17.    * call MUNPACK to decode embedded MIME: BASE64 files.
  18.    * call UUDECODE to decode embedded UUENCODED files.
  19.    * adds returns to Line feeds
  20.    * remind you to register until you do so!! 
  21.    * places the unpacked files into your BASKET.IN directory
  22.    * Logs unpacked filenames into an file called 'MLOG'
  23.    * optionally scans your download directory for files to unpack
  24.  
  25.                                                                 
  26. NOTE UUDECODE AND MUNPACK are included for your convenience, they are not 
  27. part of MIME2CIS and are not part of the licensed software.
  28.  
  29.  
  30.  
  31. INSTALLATION:
  32. -------------
  33.  
  34. if your 'CSERVE' directory is on C or D, just run:
  35.  
  36.                         install.bat
  37.  
  38. otherwise run:
  39.                         install [your_directory]
  40.  
  41. WINCIM:
  42. -------
  43.  
  44. If you are running windows, add to your compuserve folder, the program
  45. MIME2CIS.exe located in the BASKET.IN directory.  Using File New, browse into
  46. the diretory
  47.  
  48. \cserve\fcabinet\basket.in then click on MIME2CIS.EXE
  49.  
  50. Then, when you want to run MIME2CIS, double click on this icon after 
  51. you download your mail, (use ALT TAB to switch from WINCIM into Program Manager,
  52. start MIME2CIS from the ICONO, then ALT TAB to go back to WINCIM).
  53.  
  54. if you would like MIME2CIS to also process the files in your download directory, 
  55. then add to MIME2CIS.EXE the following 
  56.  
  57.                 MIME2CIS.EXE -dc:\cserve\download
  58.  
  59. (or any other directory where attachments may be found).
  60.  
  61. DOSCIM:
  62. ------
  63.  
  64. if you are running DOSCIM, just use the menu item Special then Dos to 
  65. temporarily goto DOS, then run MIME.bat to process your in-basket after 
  66. you have downloaded your emails.  Edit MIME.BAT for the download directory 
  67. on your system.
  68.  
  69.  
  70. DIRECTORIES
  71. -----------
  72.  
  73. To make every thing run immediately, the UUDECODE and MUNPACK programs have
  74. been put into your BASKET.IN directory.  If you prefer, you can copy these 
  75. programs to any directory in your PATH.  These programs are freeware from 
  76. the public domain.  They are included in this ZIP file only for your 
  77. convienence.
  78.  
  79. If you want MIME2CIS to automatically copy the files into another directory, 
  80. use the -d option (-dc:\cserve\download for example).  If there are any
  81. NONAME.* files in that directory, they will also be processed and unpacked.
  82.  
  83.  
  84. RESULTS
  85. -------
  86.  
  87. After running MIME2CIS, any emails that contained packed information, are 
  88. unpacked and stored in the BASKET.IN directory, 
  89.  
  90. If you select the -dc:\cserve\download option, your files will be stored in 
  91. that directory.
  92.  
  93. In the case of MIME encoded files, the results of the conversion can be
  94. viewed simply with your WINCIM In Basket function.
  95.  
  96. In the case of UUENCODED files, the data in the In Basket has not been changed,
  97. but the unpacked file is either in your BASKET.IN directory or in the
  98. directory you setup with the -d option.
  99.  
  100. FILE ATTACHMENTS
  101. ----------------
  102.  
  103. Sometime emails arrive with attachments. WINCIM places these into the
  104. \cserve\download directory. They are called NONAME.DAT, or if there are 
  105. many, NONAME.001 etc.
  106.  
  107. MIME2CIS will unpack these too if you specify the -d option.
  108.  
  109.  
  110. ATTRIBUTES
  111. ----------
  112.  
  113. To avoid processing files more than once, MIME2CIS uses the ACHIVE attribute 
  114. to detect which files to process.  Afterwards the attribute bit is reset.  If
  115. you want to process older emails, that have been backed up and may have their
  116. attribute fields set to 0, you need to reset them to one. Type 
  117.  
  118. attrib +a *.plx
  119.  
  120. and your will be ready to run MIME2CIS.  When you copy the files from the 
  121. IN BASKET to any other directory, the attribute bit will be set again, so 
  122. future backups will store the processed emails.
  123.  
  124.  
  125. RESULTS
  126. -------
  127.  
  128. Always check your BASKET.IN directory (or other directory specified with the 
  129. -d option) for the results of the unpacking.  If the same filename was used
  130. in multiple MIME files, then MUNPACK will assign sequence numbers (test.doc 
  131. becomes test.1 test.2 etc).  If this happens, the original EMAIL will not be 
  132. changed, even though the contents may have been unpacked. This is to handle 
  133. the case where an error occurs in the unpacking, your original file is not 
  134. changed if this happens.
  135.  
  136.  
  137. Murray Freeman
  138. 20 August 1996
  139.