home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / utils / omail / omail.doc < prev    next >
Encoding:
Text File  |  1989-04-02  |  7.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                       OMAIL 3.0
  8.                                     April 2, 1989
  9.  
  10.  
  11.  
  12.      OMAIL is a command-line driven program  that creates the necessary files to
  13.      do  a  variety of  FidoNet mail  services,  primarily those  handling files
  14.      through Net Mail,  sending and receiving files. You can run OMAIL either by
  15.      typing in commands, or as part of your batch file(s). There are a number of
  16.      changes added to this version for Binkley Term and future versions of Opus.
  17.  
  18.       USAGE: 
  19.  
  20.      The first argument must be one of these.
  21.  
  22.      POLL ....... Generate a Null *.?LO file for each Net/Node listed 
  23.      GET ........ WaZoo Request File(s) from Net/Node (may need !Password) 
  24.      UPDATE ..... Ask for a newer version of a file.                  *
  25.      SEND ....... Send File(s) to Net/Node 
  26.      TRUNC ...... Send FIle(s) to Net/Node, truncate after sending.   *
  27.      KILL ....... Send File(s) to Net/Node, Delete after sending.     *
  28.      RUN ........ Create a *.QLO file for Binkley ( >2.10)            *
  29.      STOP ....... Create a *.$$5 file to stop outbound calls.
  30.      HOLD ....... Mark mail for Net/Node as Hold.                     *
  31.      DIRECT ..... Mark mail for Net/Node as Direct.                   *
  32.      CRASH ...... Mark mail for Net/Node as Crash.                    *
  33.  
  34.  
  35.      If you do not use "C:\OUTBOUND" as your outbound holding directory, you can
  36.      use the "-pd:\your\path" to  overrides the default outbound matrix  path of
  37.      C:\Outbound with your own  path. If you aren't using  C:\Outbound I suggest
  38.      you  patch OMAIL.COM as explained  at the end of this  document, but if you
  39.      don't feel up to patching OMAIL.COM, you  can get along quite well by using
  40.      the -p on the command line. 
  41.  
  42.      You can also using OMAIL.COM to handle multi-zone mail by changing the path
  43.      you use on  the command line. If your outbound path  is C:\Outbound and you
  44.      are in Zone  1, have a zone-aware  mailer, and want to make  a request from
  45.      Zone 2,  you would  tell OMAIL.COM  your path  was C:\Outbound.002,  so you
  46.      would type in: 
  47.  
  48.           -pC:\Outbound.002
  49.  
  50.      on the command line.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                           1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                       OMAIL 3.0
  74.                                     April 2, 1989
  75.  
  76.  
  77.  
  78.      You may Poll/Send/Get to/from multiple boards  and files, but each Net/Node
  79.      MUST begin with the -[c][h][d] where:
  80.  
  81.                C ........ Continuous Mail packet is created. 
  82.                H ........ Hold Mail packet is created. 
  83.                D ........ Direct Mail packet is created. 
  84.                S ........ Used only to stop calls to a board
  85.                Q ........ Used to create return lists for Binkley. (QLO files)
  86.  
  87.      You  can operate  on multiple  boards, but  you can  carry on  one TYPE  of
  88.      transaction each run.  If you need  to use a  password with a  file-request
  89.      then only the LAST password entered will have any effect. Be careful!
  90.  
  91.      There are a couple of new features added with this version. One of them  is
  92.      that you can  enter a Net/Node Stop,  which will create a  zero-length file
  93.      hhhhHHHH.$$5 which will over-ride OPUS or  Binkley from making any outbound
  94.      calls to that board until it successfully calls you.
  95.  
  96.      Another addition by Steve Antonoff of  133/302 (Centurion Opus/HST) is that
  97.      if you are  entering a series  of attaches/requests to  boards in the  same
  98.      net, you only  need to enter the Net of the  first board on the list, Omail
  99.      will fill in that Net number until it hits another Net/Node combination.
  100.  
  101.      Example:
  102.  
  103.      Omail send fnews*.arc -d119/4 -d13 -d14 -d30 -h50 -h1060/342 -h500
  104.  
  105.      Takes care  of my  distribution of  FidoNews to  the boards  in my  Net and
  106.      PointNet. 
  107.  
  108.      Omail also will fill in a path by  itself now. If you put Omail.Com into  a
  109.      directory that is included in your Environment PATH, you can run Omail from
  110.      any directory on the drive that has your outbound directory on it and Omail
  111.      will fill out  the full path\file name(s).  (Also fixed a minor  problem in
  112.      earlier version that didn't handle files in root directory properly.)
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                           2
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                                       OMAIL 3.0
  140.                                     April 2, 1989
  141.  
  142.  
  143.  
  144.      **************************************************************************
  145.  
  146.      For the self-assured Hacker: In Omail.Com you'll find a string like this:
  147.  
  148.      00C:\Outbound\00*********************00
  149.  
  150.      This is  provided as a patching  area so you  can put in your  own outbound
  151.      directory path  into Omail.Com if  it differs from  the default  instead of
  152.      having  to use  the '-p' command  line option.  Your new default  path MUST
  153.      start at the first '\' (although you can change that if needed, such as put
  154.      a drive  letter in?), be terminated with a NULL, and end before the NULL at
  155.      the end of the string of asterisks. (A NULL is the hex 00)
  156.  
  157.      PLEASE! Do not  distribute a hacked  version! That will  only lead to  con-
  158.      fusion if there are problems.
  159.  
  160.      Remember: If you break it in two, you own both parts. 
  161.  
  162.      **************************************************************************
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                                           3
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                                       OMAIL 3.0
  206.                                     April 2, 1989
  207.  
  208.  
  209.  
  210.      Additions in Omail 2.0: January 14, 1989
  211.  
  212.      New keywords  are: HOLD,  CRASH, DIRECT,  and TRUNC,  explained above.  Use
  213.      TRUNC with caution. It will tell Opus/Binkley to make a file 0 length after
  214.      sending it. Although not listed, NORM is interchangeable with DIRECT.
  215.  
  216.      It  is also  no longer  necessary to  use '-d'  or '-s'  for  each net/node
  217.      address. If  the keyword is  STOP, Omail.Com the flags  don't mean anything
  218.      anyway. If the  keyword is POLL, GET,  SEND, or TRUNC,  if you don't use  a
  219.      '-x' flag,  Omail.Com will  assume  a DIRECT  flag.  So the  following  are
  220.      equivalent:
  221.  
  222.      Omail send somefile.ext -d119/5
  223.      Omail send somefile.ext 119/5
  224.  
  225.      Omail STOP  now deletes  an existing  *.$$? file  for  that address  before
  226.      creating the *.$$5  file. This was causing problems if there was a *.$$1 in
  227.      place already. Opus wouldn't pick up the *.$$5 file. 
  228.  
  229.      -------------------------------------------------------------------
  230.      Additions to OMAIL 3.0 April 2, 1989
  231.  
  232.      Added UPDATE to do update requests, KILL to delete a file after it has been
  233.      sent,  and QLO  files  for Binkley  Term.  The addition  of  QLO files  was
  234.      suggested by Steve Barnes, but I have to admit I have no idea what it does.
  235.  
  236.      Both UPDATE and KILL will work with wildcards, so be careful!
  237.  
  238.      -------------------------------------------------------------------
  239.  
  240.      You are welcome to  use this program in  any legal and friendly  manner you
  241.      may wish so long  as no money changes hands  in its distribution. If  you'd
  242.      like to  contribute something  in appreciation  for the  effort in  keeping
  243.      OMAIL updated, you might send $10-$15 as a donation. This is NOT required.
  244.  
  245.  
  246.                                              Doug Boone FidoNet 119/5 
  247.                                              (916) 893-9019 data 
  248.                                              (916) 891-0748 voice
  249.                                              P.O. Box 5108 
  250.                                              Chico, CA      95928 
  251.       
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                           4
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.