home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / mailproc.zip / readme.eng < prev    next >
Text File  |  1999-05-30  |  5KB  |  134 lines
  1.                 MailProc 1.0
  2.                 ============
  3.  
  4.  
  5. 1. Introduction
  6.  
  7. I have written this program to be able to access my office computer via
  8. email which is the only way it can communicate with the internet. When 
  9. MailProc runs on my office computer, it will process the emails containing
  10. a special subject and reply with the result. During processing each line 
  11. of the body will be treated as a separate command. These commands will be
  12. put in a CMD file, which is then passed to the OS/2 command processor. 
  13. The output (and the errors) of the CMD is redirected to a log file, which 
  14. is then mailed back to the sender of the command email. In this way you
  15. can have unlimited access to the computer running MailProc.
  16.  
  17.  
  18. 2. Installation
  19.  
  20. You can install MailProc on every OS/2 Warp machine with TCP/IP and REXX 
  21. socket support installed. To be able to use the program you should have a 
  22. pop account and access to an SMTP server which will accept mail from you. 
  23.  
  24. Since you are reading this, you have probably already unzipped the zip
  25. file in a directory. Copy the CMD files to a directory where you want to
  26. have the program installed. MailProc can be installed on every file system
  27. OS/2 can access.
  28.  
  29. The components of this package come with default settings. You must change 
  30. some basic setting needed to access your email account and specify the 
  31. subject of the command emails (basically your password to MailProc). Please
  32. be aware! If you do not change the default, anyone downloading this zip file
  33. will find it and may gain unlimited access to your computer!!!
  34.  
  35. To change the default configuration you should open the CMD files with a 
  36. text editor and change the parameters under the comment line containing 
  37. "... you must configure...". You may change additional settings located 
  38. under the comment lines containing "...you may configure...". Do not change
  39. anything under the line "Do not change anything under this line!!!" unless
  40. you know what you are doing. 
  41.  
  42.  
  43. 3. Summary of the parameters you must change
  44.  
  45. 3.1 MAILPROC.CMD (main program)
  46. pop        : The name of the pop server you use to receive email.
  47. smtp        : The name of the smtp server you use to send email.
  48. user        : Your pop user id (login name on the pop server).
  49. pwd         : Your pop password transformed with convert.cmd to make 
  50.           it non readable. 
  51.  
  52. 3.2 GETCMAIL.CMD (get command emails via pop server)
  53. cmail_subject    : Secret subject of the command email.
  54.  
  55. 3.3 SNDCMAIL.CMD (send reply via smtp server)
  56. mail_from    : Email address sender reply message (your office email).
  57. def_mail_to    : Email address default recipient (your home email).
  58.  
  59.  
  60. 4. Summary of the parameters you may change
  61.  
  62. 4.1 MAILPROC.CMD (main program)
  63. begin_hour1     : Begin hour for polling emails on workdays.
  64. end_hour1     : End hour for polling emails on workdays.
  65. period1     : Pause between polls in seconds on workdays.
  66. begin_hour2     : Begin hour for polling emails on weekends.
  67. end_hour2     : End hour for polling emails on weekends.
  68. period2     : Pause between polls in seconds on weekends.
  69. logfile     : The name of the main log file located in the LOGS dir.
  70. dialeron    : Command to dial your isp (should return).
  71. dialeroff    : Command to stop the dialer.
  72.  
  73. 4.2 GETCMAIL.CMD (get command emails via pop server)
  74. NewMailFileMask : File mask for command, log and message files.
  75. max_mail_size   : Maximum size command email.
  76. tracing        : State extra logging.
  77. tracefile    : The name of the extra log file in de LOGS directory.
  78.  
  79. 4.3 SNDCMAIL.CMD (send reply via smtp server)
  80. mailerstring     : String identifying MailProc.
  81. def_subj    : Default reply subject.
  82. tracing     : State extra logging.
  83. tracefile    : The name of the extra log file in de LOGS directory.
  84.  
  85.  
  86. 5. Using MailProc
  87.  
  88. If you correctly configured MailProc, you should be able to start is
  89. by simply issuing mailproc in its directory. I start it via de Startup 
  90. folder of my OS/2 system. MailProc will create 3 directories in its
  91. work directory: WAIT, DONE and LOGS. In WAIT you will find the jobs
  92. which are waiting to be processed and DONE contains the correctly 
  93. processed jobs. In the LOGS directory you can find the log files the
  94. program produces.
  95.  
  96. A few ideas of command emails before you ask:
  97.  
  98. Action:            Commands:
  99. ----------------------------------------------------------------------
  100. Receive a text file    type <file to receive>
  101. ----------------------------------------------------------------------
  102. Receive a binary file    mpack.exe -s myfile -o file.txt <file to rec.>
  103.             type file.txt
  104.  
  105. You can find mpack and munpack on hobbes.nmsu.edu to convert binary
  106. files to MIME text and vica versa.
  107.  
  108.  
  109. 6. Disclaimer
  110.  
  111. This is a freeware product and can be used at your own risk. It is highly
  112. improbable that it can cause any damage. However, you should keep in mind
  113. that the person, who can execute command emails on your system, has in
  114. principle unlimited access. He/She can access all the data located on 
  115. your PC or located on network resources attached to your PC. He/She can
  116. even format your PC! Keep your subject a secret!
  117.  
  118.  
  119. 7. Contacting the Author
  120.  
  121. If you have any suggestions, comments or bug reports, please send me an
  122. email. My address is kadzsol@xenia.sote.hu. You can find the latest version 
  123. of this package at http://xenia.sote.hu/~kadzsol/rexx/sajat/mailproc.zip.
  124.  
  125.  
  126. 8. Acknowledgments
  127.  
  128. Special thanks to P.J. Mueller and C. Lechleitner for publishing rnr.cmd 
  129. and getpop.cmd.
  130.  
  131.  
  132. Zsolt Kádár
  133. 05.30.1999.
  134.