home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / RPOST101.ZIP / RNETPOST.DOC < prev    next >
Encoding:
Text File  |  1991-07-26  |  8.4 KB  |  192 lines
  1.  
  2.  
  3.  
  4.  
  5.                                  RNETPOST.EXE
  6.  
  7.  
  8.  
  9.                     RNet REP Packet Post Processor Utility
  10.                                 Version 1.01
  11.  
  12.  
  13.  
  14.                     Runtime released to the Public Domain
  15.  
  16.  
  17.  
  18.                                Fri Jul 26 1991
  19.  
  20.  
  21.  
  22.    RNETPOST is a utility designed to process an EchoMail REP/QWK packet
  23.    formatted messages after QNet, RNet, TNet, MarkMail, QMail, or any
  24.    other QWK system has produced it.  You must give RNETPOST a file to
  25.    work on, this usually being MESSAGES.DAT (from a mail door, extracted
  26.    from a QWK packet) or HOST_ID.MSG (from a mail tosser, extracted from
  27.    a REP packet).
  28.  
  29.    RNETPOST will:
  30.  
  31.     ■ Check for duplicate messages within the file using a CRC16 calculation
  32.       backed up by header TO/FROM/SUBJECT comparisons. During testing, this
  33.       function found DUP's that I caused with the NASA processing.  Special
  34.       thanks to Mark "Ace" Corl for this feature (one of the bad guys).
  35.  
  36.     ■ Send DUP messages to a specified PCBoard 14.x messagebase for later
  37.       Sysop review.  The Sysop can later copy the messages back into the
  38.       original messagebase for export if the DUP should have been allowed.
  39.       [This operation is optional]
  40.  
  41.     ■ Send ALL messages that are in the file to a specified messagebase for
  42.       later Sysop review.  This is useful to allow the Sysop to see what their
  43.       users are up to.  Thanks to Ed Hopper for this "spy" feature (one of the
  44.       good guys)  [This too is optional]
  45.  
  46.     ■ Check for messages over a specified number of days old.  This is very
  47.       useful for catching pointer problems, dup uploads from lower systems,
  48.       and offline reader users who forget to delete their REP's.  Messages
  49.       deleted as a result of age are sent to the DUP specified messagebase (if
  50.       one is specified).  [Yep, this is optional]
  51.  
  52.     ■ Look neat when running and consume about 20K of disk space.  [Yep, this
  53.       too is optional -- use DEL RNETPOST.EXE to disable (heh)]
  54.  
  55.  
  56.  
  57.  
  58.                                  DISTRIBUTION
  59.                                  ------------
  60.  
  61.    RNETPOST is distributed with the following files:
  62.  
  63.      RNETPOST.EXE - The actual program.  This is all you actually need.
  64.      RNETPOST.DOC - The documentation(?) you are reading(?).
  65.      REXAMPLE.BAT - An example batchfile for showing operation.
  66.  
  67.    These files, if distributed separately, use the naming convention of
  68.    RPOSTvvv.ZIP (vvv refers to the release version number).  The initial
  69.    release, for example, is RPOST100.ZIP.
  70.  
  71.  
  72.                              OPERATIONAL OVERVIEW
  73.                              --------------------
  74.  
  75.    RNETPOST is operated entirely from the commandline.  The only required
  76.    parameter you need to specify is the name/location of a HOSTID.MSG file
  77.    (HOSTID refers to the MailDoor "name" given to your host's BBS) or a
  78.    MESSAGES.DAT file from a QWK packet.
  79.  
  80.    The HOSTID.MSG file to be processed must be extracted from the source
  81.    HOSTID.REP file.  This version does not know how to extract the needed
  82.    file from your REP files (I had it working with PKZIP/PKUNZIP, but some
  83.    folks use other packing systems.. thus, I just left it up to you to
  84.    handle).  See the example BAT file for suggested operation.
  85.  
  86.    If you startup RNETPOST without any parameters, it will display a screen
  87.    reminding you of its operation and available switches.
  88.  
  89.    Note that any and all switches may be specified via the DOS environment
  90.    using SET RNETPOST=[options] such as SET RNETPOST=-b -m -z -n14.
  91.  
  92.    RNETPOST *should* automatically detect the kind of screen/system you are
  93.    running on.  If something fails the auto-detect, you can force the issue
  94.    using the following optional commandline switches:
  95.  
  96.      -b  =  Force BIOS writes.  This is needed if the auto-detect fails and
  97.             you are running a multi-tasker.  If you are running a multi-
  98.             tasker and see "bleed through", add -b to the commandline.
  99.  
  100.      -m  =  Force Monochrome color mapping.  If you have difficulty seeing
  101.             the screen (such as when using a LCD display), use -m to force
  102.             the colors to be re-mapped to monochrome (B/W).
  103.  
  104.      -c  =  Force reduction of CGA "snow".  Again, the auto-detection should
  105.             correctly determine when you are running an older CGA card.  If
  106.             not, simply add -c.
  107.  
  108.    You may combine as needed:  If you have a CGA snow problem on a LCD screen
  109.    and running a multi-tasker, you could specify -cmb (all together, no
  110.    spaces, leading dash required).
  111.  
  112.  
  113.  
  114.  
  115.                             MESSAGEBASE OPERATIONS
  116.                             ----------------------
  117.  
  118.    RNETPOST is designed to copy some or all of the messages to any specified
  119.    messagebases for the Sysop to review later.  You have two options for what
  120.    messages and where they go:
  121.  
  122.      -dD:/DIR/MSGS = Messagebase for DUP and OLD messages to be sent to.
  123.                      Specify the actual messagebase filename to write the
  124.                      DUP and OLD messages to.  If you do not specify the -d
  125.                      option, DUP and OLD messages will not be copied anywhere
  126.                      (they will still be killed in the REP though).
  127.  
  128.      -d##          = Specify the conference number where DUP and OLD messages
  129.                      should be sent.  See the note below about using
  130.                      conference numbers instead of messagebase filenames.
  131.  
  132.      -sD:/DIR/MSGS = Messagebase destination for ALL messages.  Named the the
  133.                      "SPY" function by Ed Hopper, this option, if specified,
  134.                      will force all messages in the REP (except DUP and OLD)
  135.                      to be copied to the specified messagebase.  If you also
  136.                      want DUP and OLD messages sent to the same messagebase,
  137.                      simply specify -d and -s to the same messagebase.  If
  138.                      you do not specify -s, this operation will be disabled.
  139.  
  140.      -s##          = You may optionally use a conference number in place of
  141.                      the conference messagebase name.  See below about using
  142.                      conference numbers in this way.
  143.  
  144.      -n##          = Age checking.  Specify the number of days old that
  145.                      messages may be to be allowed to be echoed.  A good
  146.                      setting for this might be -n4, which tells RNETPOST to
  147.                      delete any messages older than 4 days.  This is similar
  148.                      to the ProPack /N operation.
  149.  
  150.    If you are running a single node system and/or if you are writing messages
  151.    to messagebases which are not accessable concurrently (ie, are private to
  152.    the Sysop), than you may specify the -z switch.  By specifying -z on the
  153.    commandline, RNETPOST will not flush the DOS directory structure between
  154.    messages.  Directory flushing allows other nodes to determine the true
  155.    end-of-file while another task is working on it.  By not flushing the
  156.    directory structure (-z), message insertion speed is 3x normal.  A disk
  157.    cashe system will also greatly speed message operations.
  158.  
  159.    To use conference numbers in place of messagebase filenames, you must have
  160.    one of RNETCONF, CONFINFO, or CNAMES in the current directory or specified
  161.    via DOS environment variables RNETCONF, CONFINFO, or CNAMES (makes sense?)
  162.    If, if you have PCBoard 14.5 and want to use CNAMES (65534 conference
  163.    support), add "SET CNAMES=D:\PCB\MAIN\CNAMES" to your autoexec or to the
  164.    batch calling RNETPOST.
  165.  
  166.  
  167.  
  168.                             TO CONTACT THE AUTHOR
  169.                             ---------------------
  170.  
  171.    If this DOC and/or the example batch file are not enough to explain the
  172.    operation or RNETPOST or if you have any problems/bugs to report, please
  173.    contact the author:
  174.  
  175.      ROBERT VOSTREYS
  176.  
  177.      via BBS:  Faster-Than-Light BBS
  178.                404-292-8761  [2400]
  179.                404-299-3930  [HST1440]
  180.  
  181.      via Echo: AtlArea   - AtlSysop or NetLANTA
  182.                ILink     - Admin, MM-RNet, or Sysops
  183.                MetroLink - Admin or MMail
  184.                RIME      - Admin, Common, or Sysops
  185.                SmartNet  - Admin, MMail, or Sysops
  186.                UNI'net   - via SmartNet Admin
  187.  
  188.      via Mail: Robert Vostreys, FTL Sysop
  189.                Post Office Box 2315
  190.                Stone Mountain, GA  30086-2315
  191.  
  192.