home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / fxemail1.zip / fxemail.doc < prev    next >
Text File  |  1997-06-09  |  4KB  |  116 lines
  1. WHAT IT DOES
  2.  
  3. FxEmail is a utility designed to be used in conjunction with FaxWorks
  4. Pro. It requires Object REXX rather than Traditional REXX. Object REXX
  5. is available with Warp 4. Please see the README file on your boot drive
  6. to see how to switch REXX support.
  7.  
  8. FaxWorks Pro allows you to designate an email helper application on the
  9. PROGRAM settings page.  You can then send faxes to email addresses.  The
  10. helper app is handed the name of the fax file, the recipient email
  11. address and a standard subject.
  12.  
  13. FxEmail functions both as a helper app for FaxWorks and as a helper app
  14. for the receiving email program.
  15.  
  16. On the sending end, it encodes the fax using base64 and transfers it
  17. using SMTP.  At the receiving end, it is called as a REXX Exit by the
  18. email client.  It extracts the Fax file and "receives" it into Faxworks.
  19.  
  20. USING IT TO SEND
  21.  
  22. The command line for the FaxWorks setting page:
  23.  
  24. FxEmail SMTP-MIME %FILE% %ADDRESS% %SUBJECT%
  25.  
  26. USING IT TO RECEIVE
  27.  
  28. This is more problematical -- since each program is different.  I have
  29. tested it only with PMMail 1.92.
  30.  
  31. It is used as a REXX exit along with a filter which looks for "FAX Via
  32. FxEmail" on the Subject line.
  33.  
  34. The command line reads:
  35.  
  36. d:\FaxWorks\FxEMail FXRCV
  37.  
  38. The path should reflect your configuration.
  39.  
  40. CONFIGURATION FILES
  41.  
  42. Two configuration files are required.  One in the FaxWorks directory and
  43. one in the directory from which you run you email program.  With PMMail,
  44. that might be d:\Southsde\PMMail.
  45.  
  46. The program uses the FaxWorks config for sending and the maildir config 
  47. for receiving.  The program itself is run out of the Faxworks directory.
  48.  
  49. Both config files must exist for FxEmail to work.  Create the files by
  50. getting an OS/2 prompt, making the FaxWorks directory the current
  51. directory and typing:  "FxEMail CFG".  You will be prompted for
  52. information.  Specimen answers are given if there is no existing config
  53. file.  Otherwise the current settings are shown.  Make your changes and
  54. indicate that you are finished when asked.  The program will create and
  55. save both config files.
  56.  
  57. INSTALLATION
  58.  
  59. Put FxEmail.cmd in your Faxworks Directory.
  60.  
  61. PutFxRemail.cmd in you email directory -- the one where the .exe
  62. file resides.
  63.  
  64. Install Munpack and Mpack in a directory in your path.
  65.  
  66. Install the two DLL's in a directory in your LIBPath.
  67.  
  68. Create the config files.
  69.  
  70. EXTRA UTILITY
  71.  
  72. FxREmail.cmd is a small command that can be run as a real REXX EXIT from
  73. PMMail rather than with a filter.  It looks at each email message as it
  74. comes in and calls FxEmail only on the Fax messages.
  75.  
  76. ODDITIES
  77.  
  78. I have tested FxEmail with FaxWorks Pro -- actually PMFax versions 3.0 
  79. and 3.01.01j.  It works with both.  For some reason, it runs in the
  80. foreground under the latter.
  81.  
  82. PMMail has some odd quirks.  First, it seems to have a built-in filter
  83. for Fax files.  If you specify your own filter for the same file, it
  84. freezes after downloading that file.  I have changed the subject line to
  85. avoid this conflict.
  86.  
  87. PMMail says it passes the fully qualified path of the message file.  It
  88. does not.  It passes the path relative to the directory from which
  89. PMMail was run.  For the true REXX EXIT, it also seems to add a space
  90. before the path, which I had to strip off to make FxREMail.cmd work.
  91.  
  92. There is a another SMTP option:  SMTP-UU which works exactly like the
  93. MIME version but uuencodes instead.  I believe PostRoad and PMMail use
  94. uuencoding for their built in FaxWorks support, for some reason.  For
  95. some reason, PMMail does not recognize the resulting message file,
  96. however.  When I figure out what it needs, I will modify this feature
  97. and document it. UUencode feature requires UUenview.cmd, which is 
  98. readily available as sharewhere.
  99.  
  100. WARNING
  101.  
  102. I wrote this for myself.  I am not a programmer.  I do not guarantee or
  103. warrant it in any way.  You use it at your own risk.
  104.  
  105. Your license is for noncommercial use on an evaluation basis.  Email me
  106. if you want a full license.  I will provide you with licensed versions
  107. of the DLL's.  There will be a small charge, since I have to pay for
  108. those licenses.
  109.  
  110. cbarr@ibm.net
  111.  
  112.  
  113.  
  114.  
  115.  
  116.