home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / rnet109u.zip / RNET.DOC < prev    next >
Text File  |  1993-01-26  |  72KB  |  1,426 lines

  1.  
  2. RNET.DOC                                                                Page 1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.    ╓──────┐ ╓────┐╓─┐ ╓─────┐ ╓─────┐
  10.    ║ ╒══╗ │ ║ ╒╗ │║ │ ║ ╒═══╛ ╚═╗ ╒═╛    Version: 1.09
  11.    ║ └──╜ │ ║ │║ │║ │ ║ └─┐     ║ │      Release: Tue Jan 26 1993
  12.    ║ ╒═╗ ╒╛ ║ │║ │║ │ ║ ╒═╛     ║ │
  13.    ║ │ ║ └┐ ║ │║ └╜ │ ║ └───┐   ║ │      Copyright 1989-93 Robert Vostreys
  14.    ╚═╛ ╚══╛ ╚═╛╚════╛ ╚═════╛   ╚═╛      All Rights Reserved Worldwide
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.    PCBoard 14.x EchoConference driver for "QWK" packet based EchoNetworks.
  22.  
  23.  
  24.   _____________________________Naming Conventions____________________________
  25.  
  26.   RNet is distributed using the filenaming convention of:  RNETvvvx.zzz.
  27.   VVV refers to the version, such as '109' for version 1.09, '200' for
  28.   version 2.00.  The X refers to a letter code specifying alpha, beta,
  29.   registered, and shareware release versions.  Alpha and beta versions of
  30.   RNet begin at 'A' and continue no further than 'P'.  The registered release
  31.   version is distributed as RNETvvvR.zzz, the shareware release version is
  32.   distributed as RNETvvvU.zzz ('U' for unregistered).  The final ZZZ refers
  33.   to the compression utility extension, which will usually be .ARC or .ZIP or
  34.   whatever.  When referring to this distribution file in the documentation,
  35.   it will usually be referred to as "ZIP file."
  36.  
  37.  
  38.   _____________________________Distribution File_____________________________
  39.  
  40.      The following files should be present within the distribution ZIP file:
  41.  
  42.         RNET.EXE       Main executable program
  43.  
  44.         RNET.DOC       The documentation you are currently reading (RTFM!)
  45.         RNET_REF.DOC   Quick reference for RNet configuration and operation
  46.         REGISTER.DOC   Shareware registration form and information
  47.         CHANGES.vvv    Changes from version to version (history files)
  48.         ECHOS.DOC      Description and information about EchoConferencing
  49.         MESSAGES.DOC   Listing of errors which are not otherwise explained
  50.         RNETCONF.DOC   Information on PCBCONF and PROCONF interfacing
  51.         PCBCONF.EXE    Interface utility for PCBoard CNAMES conferences
  52.         PROCONF.EXE    Interface utility for ProDoor CONFINFO conferences
  53.  
  54.         SAMPLE1.CFG    Sample (verbose) configuration file with comments
  55.         SAMPLE2.CFG    Sample (brief) HOST_ID.CFG configuration file
  56.  
  57.         MAILRUN.BAT    Example BAT for making a host mail transfer
  58.         LOWMEM.BAT     Example BAT for using external compression
  59.  
  60. RNET.DOC                                                                Page 2
  61.  
  62.   Alpha/Beta versions usually do not include the .DOC files but instead
  63.   include the CHANGES.vvv file for that version.  Please be sure to read this
  64.   file if you are working with an alpha or beta version of RNet!
  65.  
  66.  
  67.   _____________________________Distribution Rules____________________________
  68.  
  69.   Sysops MAY place 'ZIP Comments' on the RNet distribution ZIP file if they
  70.   normally do such with all their download files.
  71.  
  72.   Sysops MAY NOT place additional files (such as 'README.1ST' or 'BBS_AD')
  73.   within the distribution ZIP file nor may they use the PKZIP -AV
  74.   verification stamp.
  75.  
  76.   Distribution of the alpha, beta, and registered versions is restricted to
  77.   those systems with specific permission to distribute such.  Do not
  78.   distribute any version of RNet except the unregistered (RNETxxxU) version!
  79.  
  80.  
  81. RNET.DOC                                                                Page 3
  82.  
  83.  
  84.  
  85.   ___________________________Contacting the Author___________________________
  86.  
  87.   Problems, questions, and suggestions should be directed to Robert Vostreys:
  88.  
  89.      Modem:         Faster-Than-Light BBS
  90.                     Node1: 404-292-8761 [300 to 2400 / soon HST]
  91.                     Node2: 404-299-3930 [300 to 14400 v.32bis]
  92.  
  93.      US Mail:       Robert Vostreys, FTL Sysop
  94.                     Post Office Box 2315
  95.                     Stone Mountain, GA  30086-2315
  96.  
  97.      EchoMail:      ILink:     Sysops, MM-RNet, or Admin EchoConferences.
  98.                     SmartNet:  Sysops, MarkMail, or Admin EchoConferences.
  99.                     RIME:      Sysops or Admin EchoConferences (route ->FTL).
  100.                     Atlanta:   AtlSysops or NetLANTA EchoConferences.
  101.                     GEnie:     R.Vostreys
  102.  
  103.  
  104.   _________________________________Shareware_________________________________
  105.  
  106.   Since you have likely read statements under the heading "Shareware" often,
  107.   I'll not bother going into the idea again.  Simply be aware that RNet is
  108.   shareware ($20US suggested), the registered version has some additional
  109.   features, and that the file REGISTER.DOC contains the shareware
  110.   registration form and information.
  111.  
  112.   Any and all registered users may download and operate any 1.xx beta and
  113.   registered versions of RNet as desired.  The registered and beta versions
  114.   are always available from:
  115.  
  116.                 Faster-Than-Light      404-292-8761 / 299-3930
  117.                 The Right Place<tm>    404-276-2607 / 476-0847
  118.  
  119.  
  120. RNET.DOC                                                                Page 4
  121.  
  122.  
  123.  
  124.   __________________________________Overview_________________________________
  125.  
  126.   RNet is a utility to transfer messages from one BBS to another using the
  127.   QWK packet format.  The transfer/sharing of messages between BBS's is
  128.   commonly referred to as "EchoMail", "NetMail", or "EchoConferencing."  For
  129.   more information on echo network design and the terms used within this
  130.   document, see ECHOS.DOC.
  131.  
  132.   RNet will insert QWK packet messages into your PCBoard 14.x messagebases
  133.   and export new messages in a REP packet for insertion into a host system's
  134.   messagebases.  If you are familiar with the operation of EZ-Reader, Deluxe,
  135.   AmigaReader or similar QWK packet offline readers, most of the terms and
  136.   ideas used here will be familiar.
  137.  
  138.   The actual transfer of QWK/REP packets is left up to you and your choice of
  139.   communications programs.  Canned scripts and programs such as RoboComm or
  140.   Intellicom will work well to automate mail transfers.
  141.  
  142.   Usually, RNet is used in a system "event" to process incoming and outgoing
  143.   mail to a network host during the night (when long distance carrier rates
  144.   are lower).  RNet is designed to be extremely dependable, which may
  145.   substitute safety at the expense of speed.
  146.  
  147.   While RNet is for use with PCBoard 14.x (or ProDoor/ProBBS), your host need
  148.   not be running a PCBoard system.  TomCat! is an example of a WildCat! door
  149.   and MarkMail is an example of a PCBoard/ProDoor door.
  150.  
  151.   RNet is designed to be very verbose (both on-screen, error/warning reports,
  152.   report generation options, callerlog reporting in two formats), and even
  153.   shows on the Node Chat display when running.  If something goes wrong or
  154.   if a condition exists(ed) that warrants attention, a log entry will be made
  155.   to ERROR.LOG with any other information you might need.  There are a
  156.   variety of reports and logs that can be produced as desired.
  157.  
  158.  
  159. RNET.DOC                                                                Page 5
  160.  
  161.  
  162.  
  163.   ________________________________Feature List_______________________________
  164.  
  165.   Support for most (all?) QWK packet mail doors that support NetStatus.
  166.  
  167.   Limited to 32,765 conferences _per_ configuration / host QWK packet.
  168.   Limited to 32,765 conferences _per_ CNAMES or CONFINFO file (or create your
  169.   own conference location file (RNETCONF) using a text editor for complete
  170.   control.)
  171.  
  172.   You may have an unlimited number of hosts and configuration files.
  173.  
  174.   Complete multi-node concurrent access to local conferences supported -- you
  175.   will never lose a message due to concurrent messagebase insertions, even if
  176.   running RNet on several nodes concurrently importing into the same
  177.   messagebases.  Includes support for the new PCBoard 14.5 DOS 3.1 record
  178.   locking method.
  179.  
  180.   Support for PCBoard 14.x CNAMES (39 and 65534 conference versions) and
  181.   ProDoor CONFINFO (255 and 2040 conference versions).
  182.  
  183.   Always sends Host Sysop their private (R/O) messages.  Always imports
  184.   private messages addressed to the Local Sysop.  This allows you and your
  185.   host to have a private conversation even on public-transfer-only networks.
  186.  
  187.   Support for multiple hosts (using the same messagebases) with or without
  188.   cross echoing as desired.  This is useful for gateway connections between
  189.   two or more networks.
  190.  
  191.   Private (R/O) messages can be passed or limited on a global or conference-
  192.   by-conference basis.
  193.  
  194.   You may choose to honor or ignore the PCBoard 14.x "ECHO" flag.
  195.  
  196.   Completely definable tagline. The registered version of RNet allows you to
  197.   define the ENTIRE tagline (no software "id" involved -- what you define is
  198.   what you get!)
  199.  
  200.   A separate text-editable pointer file is maintained for each host.  Pointer
  201.   files are automatically backed up when a new REP packet is created.
  202.  
  203.   Special "Network Sysop" functions are supported to allow the network
  204.   administration to route very important messages to your MAIN BOARD if
  205.   needing such attention.
  206.  
  207.   Writes logs and pointer files to the location where the configuration file
  208.   was found. This allows you to execute RNet from wherever is convenient for
  209.   your particular system configuration.
  210.  
  211.   Local display (processing screen) supports 25/43/50 line modes.
  212.  
  213.   Conference usage analysis reports showing activity in network conferences
  214.   and percentage of traffic generated locally.
  215.  
  216.   Message filtering: RNet will expand TABs, strip unneeded spaces, remove
  217.   bells/^S/^X, pack blank lines from taglines, and even decrypt John Hancock
  218.   encrypted taglines if desired.
  219.  
  220. RNET.DOC                                                                Page 6
  221.  
  222.  
  223.  
  224.   Handles and reports bad or corrupted PCBoard messagebases and NDX files.
  225.  
  226.   Automatically builds a pointer file for each host.  If you add a
  227.   conference, you need not reset a pointer as RNet will assume you want to
  228.   start at the high message number.
  229.  
  230.   Intelligent pointer handling.  If a pointer is set to a message lower than
  231.   the lowest message, RNet will reset the pointer to the low message.  If a
  232.   pointer is set above the high message, RNet will reset the pointer to the
  233.   high message.  You may safely change pointers to any value if needed (such
  234.   as to force export of an entire messagebase for a crashed host or to make a
  235.   backup).
  236.  
  237.   Warns you if you receive a conference in a QWK packet that you have not yet
  238.   configured on your end.
  239.  
  240.   Special commandline operations to force RNet to import/export only a single
  241.   specific conference or to "continue" importing in a QWK packet that stopped
  242.   for some reason (such as disk full).  No need to reprocess the entire
  243.   packet insertion!
  244.  
  245.   Automatic appending of messages to the REP packet if a REP packet is found
  246.   present when running an export.  This is can be enabled and is suggested
  247.   since it allows you to continue "building" on a REP even if your host is
  248.   busy or down.
  249.  
  250.   TCANNING of messages to/from specific users.  You can even TCAN messages
  251.   that are "from" a user, but not those "to" that user and/or vice-versa.
  252.  
  253.   Users (and the Sysop for that matter) can "watch" RNet's operation on the
  254.   Node Chat display in PCBoard. RNet looks like a normal "user". The "City"
  255.   display is used to relay what RNet is specifically doing at that time.
  256.  
  257.   Option to delete QWK packets after successful import automatically.  If an
  258.   import is unsuccessful, RNet will leave the QWK packet there for your
  259.   further investigation.
  260.  
  261.   Networks which support NETNEWS type conferences have a much easier time
  262.   with RNet.  RNet can automatically copy messages in special conferences
  263.   (such as Administration level conferences) into a NetNews conference.
  264.   Also, special messages (from a specific name/person, with a specific
  265.   keyword/subject) can be posted in the NetNews and transferred out along the
  266.   Administration level conferences.  This keeps ALL chitchat out of NetNews
  267.   style conferences.
  268.  
  269.   Automatic processing of multiple QWK packets (such as *.QWK, *.QW0,.. up to
  270.   *.QW9).  Useful if using a "pre-built" packet door such as QMail 4.xx which
  271.   may result in your downloading multiple packets for RNet to process.
  272.  
  273.   Automatic import speed determination.  RNet watches what other users are
  274.   doing via the USERNET.DAT file to decide how safe it is to import messages
  275.   quickly or safely.  If someone on another node (even another RNet) is
  276.   entering a message, RNet will flush the DOS directory structure after each
  277.   message for safety in importing messages.  Otherwise, RNet flushes after
  278.   each conference is completed.  SAFETY FIRST!
  279.  
  280.  
  281. RNET.DOC                                                                Page 7
  282.  
  283.  
  284.  
  285.   _________________________________NetStatus_________________________________
  286.  
  287.   NetStatus refers to your having the "permission" of a host system to echo a
  288.   messagebase (or bases).  You might have NetStatus on perhaps only one or
  289.   two conferences of that particular host's conferences -- that is up to the
  290.   discretion of your host.
  291.  
  292.   The host Sysop _must_ enable NetStatus for you before you can transfer any
  293.   messages back and forth!  Usually this is done with your being accepted
  294.   into an echo network such as ILink or SmartNet, or it may simply be that
  295.   you and another sysop wish to echo (transfer) a debate conference between
  296.   your boards.  Your host must enable NetStatus for your user record within
  297.   the maildoor you will be using for echoing messages.
  298.  
  299.   If you do not have NetStatus, RNet will write a log entry to ERROR.LOG and
  300.   skip the conference(s) in question.  If you are setting up for echomail and
  301.   do not yet have NetStatus on the host system, you will not be permitted to
  302.   import messages from the host system.  Exporting of messages with RNet will
  303.   correctly create a REP file, but they will not be accepted on the host
  304.   without NetStatus enabled.
  305.  
  306.  
  307.   _________________________________MailDoors_________________________________
  308.  
  309.   For RNet to process messages to/from a host system your host must support a
  310.   QWK packet format mail door.  This is where you will download QWK packets
  311.   (which contain new messages coming from the host/upper network) and upload
  312.   your REP packets (containing messages from your system/lower network).
  313.  
  314.   Each BBS running a mail door is assigned a HOST_ID.  If your host was, for
  315.   example, "Faster-Than-Light BBS", the assigned HOST_ID might be "FTL".
  316.  
  317.   Ask your host what the HOST_ID is if not obvious from within the mail door.
  318.  
  319.   When you request new messages from your host's mail door, a HOST_ID.QWK
  320.   packet will be constructed with new messages.  Using the above example, the
  321.   packet would be called FTL.QWK.
  322.  
  323.   When RNet collects new messages from your system to be sent up to the host,
  324.   it will create a HOST_ID.REP packet, such as FTL.REP.
  325.  
  326.   Different mail doors support different maximum conferences for echomail.
  327.   These limitations are for the number of conferences the HOST can support,
  328.   not how many conferences you might wish to have.  RNet always supports up
  329.   to 32765 conferences _per_ RNETCONF configuration on your system!  Host
  330.   conference support by door (as of November 1990):
  331.  
  332.       KMail v1.xx      Up to 32765 conferences available on the host system.
  333.       MarkMail v1.xx     '     256       ''          ''          ''
  334.       MarkMail v2.xx     '   32765       ''          ''          ''
  335.       QMail v2.xx        '     128       ''          ''          ''
  336.       QMail v3 & 4.xx    '     256       ''          ''          ''
  337.       QMail v4(beta)     '    2048?      ''          ''          ''
  338.       TomCat! v1.xx      '     256       ''          ''          ''
  339.  
  340.  
  341. RNET.DOC                                                                Page 8
  342.  
  343.  
  344.  
  345.   ______________________________Echo Conferences_____________________________
  346.  
  347.   Echo conferences are the same as any normal conference on your board except
  348.   that the EchoFlag is used/supported.  In PCBSM/PROSM, create a conference
  349.   as normal.  Then, under the field asking about "Echo mail in conference",
  350.   specify YES.  Beyond that single difference, an Echo conference is the same
  351.   as any other (in setup that is).
  352.  
  353.   Be sure you specify enough "Index (NDX) blocks" to handle the inflow of
  354.   network message traffic.  If you pack your messagebases often (daily or
  355.   perhaps weekly), you can probably get away with one or two blocks.  If, on
  356.   the other hand, you want to keep a large number of messages on-hand or if
  357.   the traffic is extremely heavy (as with most debate conferences), you will
  358.   more than likely want to use four or perhaps six blocks.  Larger values
  359.   waste space unless you intend to keep 10,000 messages in a given conference
  360.   concurrently (or if you never pack the messagebases).
  361.  
  362.   Normally, messages entered in an Echo conference will not be echoed (send
  363.   out over the network) without the EchoFlag turned on.  When a user enters a
  364.   message, they will be prompted "Echo this message?"  If they specify YES,
  365.   then the message will be echoed.  If they specify No, then the message will
  366.   remain on the local system only.  Note that this can be overridden with the
  367.   "IGNOREECHO=" keyword in the HOST_ID configuration file.
  368.  
  369.  
  370.   ________________________________Commandline________________________________
  371.  
  372.   RNet needs only simple information on the commandline to operate.  Most of
  373.   the information RNet needs is derived from the HOST_ID.CFG configuration
  374.   file.  You need only tell RNet what kind of operation you want it to do
  375.   (such as IMPORT or EXPORT) and the HOST_ID.
  376.  
  377.      Commandline syntax:  RNET Operation HOST_ID [Param1 Param2]
  378.  
  379.      Operation must be one of:  EXPORT  IMPORT  SET  TOP.
  380.  
  381.   HOST_ID is *required* for all operations.  HOST_ID is specified for what
  382.   configuration, QWK, and REP packet filenames to look for and should not
  383.   contain an extension.  You should contact your Host Sysop to find out what
  384.   the HOST_ID is for your host's system.  Examples of HOST_ID include FTL,
  385.   TRP, EXECNET, CHEERS, HIGHER, and SEMWARE.
  386.  
  387.   Param1 and Param2 are used to specify additional information relating to
  388.   the operation being executed.  Param1, for example, is used to specify the
  389.   conference to use for SET and TOP operations.  See the text under each
  390.   operation for specific usage.
  391.  
  392.   If you neglect to specify an operation RNet will display a help screen to
  393.   remind you of the syntax.  On this screen you will see the copyright
  394.   notice, current version number, credits to Sysops who were helpful in
  395.   implementing or testing that version, and the Alpha, beta, registered, or
  396.   unregistered status.
  397.  
  398.  
  399. RNET.DOC                                                                Page 9
  400.  
  401.  
  402.  
  403.   ___________________________________EXPORT__________________________________
  404.  
  405.      Syntax:  RNET EXPORT HOST_ID [ONLY LocalConf#]
  406.  
  407.   Export instructs RNet to scan your messagebases for new outgoing messages
  408.   to be sent to your host.  Any new messages found will be placed in a
  409.   compressed HOST_ID.REP packet (appending or overwriting, depending on the
  410.   instructions in the HOST_ID.CFG configuration).  You would normally execute
  411.   this operation before calling your host for mail.
  412.  
  413.   If needed, you may specify ONLY and a local conference number which will
  414.   export new messages in the specified conference _only_.
  415.  
  416.   Examples:
  417.  
  418.      RNET EXPORT CHEERS       ;Export new messages for host CHEERS!
  419.      RNET EXPORT TRP          ;Export new messages for host TRP
  420.      RNET EXPORT TRP ONLY 5   ;Export only new messages in local conference 5
  421.  
  422.  
  423.   ___________________________________IMPORT__________________________________
  424.  
  425.      Syntax:  RNET IMPORT HOST_ID [ONLY|SKIPTO LocalConf#]
  426.  
  427.   Import is used to insert new messages from a QWK packet into your local
  428.   messagebases.  RNet will uncompress the HOST_ID.QWK packet(s), verify
  429.   NetStatus, and import the messages it finds.  You would normally execute
  430.   this operation after having downloaded mail from the host.
  431.  
  432.   There are two optional Param1 specifications accepted for the import
  433.   operation: ONLY and SKIPTO.  If either of these are specified you must also
  434.   specify a local conference number (Param2).
  435.  
  436.   ONLY allows you to import host messages in a specified conference.  This is
  437.   very useful for recovering from problems such as a disk full condition or
  438.   similar disaster.
  439.  
  440.   SKIPTO allows you to import host messages in conferences beyond a specified
  441.   local conference.  This is very useful for continuing an aborted import.
  442.   Simply look at the log to find the last imported conference then use that
  443.   local conference number as Param2.   RNet will then "pick up where it left
  444.   off" and continue importing host messages.
  445.  
  446.   Examples:
  447.  
  448.      RNET IMPORT CHEERS       ;Import messages from host CHEERS!
  449.      RNET IMPORT TRP          ;Import messages from host TRP
  450.      RNET IMPORT TRP ONLY 5   ;Import messages destined for conference 5
  451.      RNET IMPORT TRP SKIPTO 5 ;Resume aborted import at conference 5
  452.  
  453.  
  454. RNET.DOC                                                               Page 10
  455.  
  456.  
  457.  
  458.   ____________________________________SET____________________________________
  459.  
  460.      Syntax:  RNET SET HOST_ID LocalConf# PointerValue
  461.               RNET SET HOST_ID LocalConf# MessagesFromTop
  462.  
  463.   Though the host pointer file can be edited with a standard text editor
  464.   (such as QEdit or Edlin), you may change a messagebase pointer with the
  465.   commandline SET operation.  Specify Param1 as the local conference number
  466.   to change, Param2 as the value to change the pointer to.  If Param2 is
  467.   below the lowest numbered message, the lowest message will be used.  If
  468.   Param2 is above the highest message, the highest message number will be
  469.   used.  And finally, if Param2 is a negative value, RNet will use that value
  470.   subtracted from the highest (top) message number.
  471.  
  472.   Examples:
  473.  
  474.      RNET SET FTL 10 99999    ;set conf 10 pointer to high message.
  475.      RNET SET FTL 10 1        ;set conf 10 pointer to low message.
  476.      RNET SET FTL 10 -100     ;set conf 10 pointer to 100 from the top.
  477.  
  478.  
  479.   ____________________________________TOP____________________________________
  480.  
  481.   This works very similarly to the SET operation but has the advantage of
  482.   allowing you to change all the messagebase pointers at once.  If Param1 is
  483.   specified as a local conference number, RNet will reset that conference
  484.   pointer to the high message in that messagebase.  If Param1 is "ALL", RNet
  485.   will reset all conference pointers to the high message in each messagebase.
  486.  
  487.   Examples:
  488.  
  489.      RNET TOP TRP 1           ;set conf 1 pointer to last (top) message.
  490.      RNET TOP TRP ALL         ;set ALL conf pointers to top.
  491.  
  492.  
  493. RNET.DOC                                                               Page 11
  494.  
  495.  
  496.  
  497.   ___________________________Environment Variables___________________________
  498.  
  499.   RNet will look for and make use of the following environment variables.
  500.   Note that none of these environment variables are required, but are simply
  501.   searched for and used if RNet cannot find what it needs elsewhere.
  502.  
  503.   RNET=      Specify the D:\DIR\ where RNet should search for the HOST_ID.CFG
  504.              file.  RNet will first search the default (current) directory.
  505.              To maintain some compatibility with the old QNet 1.xx system,
  506.              RNet will look for the QWIKMAIL= environment if the RNET=
  507.              environment is not found.
  508.  
  509.              Example:  SET RNET=D:\PCB\RNET\
  510.  
  511.   RNETCONF=  Specify the complete D:\DIR\FILENAME that RNet should use for
  512.              its needed conference information (about your board).  If a
  513.              filename is not specified, RNet will use the RNETCONF= value as
  514.              a base drive/directory and search for RNETCONF there.  By
  515.              default, RNet looks for the file RNETCONF in the current
  516.              directory.  Use the RNETCONF= environment if you want RNet to
  517.              look elsewhere and/or if you want it to use a different filename
  518.              for RNETCONF.
  519.  
  520.              Example:  SET RNETCONF=D:\PCB\RNET\
  521.                or      SET RNETCONF=D:\PCB\RNET\RNETCONF.2
  522.  
  523.   TMP=       Specify the D:\DIR\ where RNet should place working files (such
  524.              as the uncompressed QWK and REP packets).  The drive specified
  525.              must have enough space to handle your largest packet.  RNet will
  526.              also look for the TEMP= and QWORKDIR= environment variables, in
  527.              that order.  Note that the HOST_ID configuration keyword
  528.              WORKDIR= takes priority over the environment.  If you wish to
  529.              have RNet use one of these environment variables, neglect to put
  530.              WORKDIR= in the HOST_ID.CFG file.
  531.  
  532.              Example:  SET TMP=Z:\SCRATCH99\
  533.  
  534.   NODE=      The NODE= environment is used to tell RNet what node number it
  535.              is running on so that it can correctly update NODE CHAT and
  536.              CALLERS log.  The value must be from 0 to 99.  If NODE= is
  537.              specified in the HOST_ID.CFG, it takes precedence over the NODE=
  538.              environment.
  539.  
  540.              Example:  SET NODE=1
  541.  
  542.  
  543. RNET.DOC                                                               Page 12
  544.  
  545.  
  546.  
  547.   ____________________________Configuration Files____________________________
  548.  
  549.   For every host you will be echoing from you will need to create a
  550.   configuration (HOST_ID.CFG) file.  You may create as many CFG files as
  551.   desired or even multiple CFG files for each host.
  552.  
  553.   A CFG file is a simple ASCII text file listing keywords and information.
  554.   RNet will parse the HOST_ID.CFG file (HOST_ID being what was given on the
  555.   commandline that specifies the net name of your host system) to get the
  556.   information it needs.
  557.  
  558.   RNet will first check the default directory, then look for a RNET=
  559.   environment variable (specifying a drive:\directory path) to try to find
  560.   the HOST_ID.CFG file.  If it fails to find the CFG file, RNet will abort
  561.   operation reporting "[host] Configuration file not found!"
  562.  
  563.   Configuration files can and should be created with a standard text editor
  564.   such as QEdit or even Edlin.  Blank lines and lines beginning with a
  565.   semi-colon (";") will be ignored.  Each keyword should be specified on a
  566.   separate line and should have no trailing spaces between the keyword itself
  567.   and an equals ("=") sign that should follow.  Please see the example CFG
  568.   files included in this ZIP file for a template to use.
  569.  
  570.   In a future version a Configuration program will be included to ease the
  571.   configuration process.  Meanwhile, it is recommended that you use an
  572.   existing template (example) CFG file to work with -- simply use the DOS
  573.   COPY command to copy/rename a SAMPLE?.CFG to the needed HOST_ID.CFG
  574.   configuration file.
  575.  
  576.   Most keywords have synonym words (SYN) listed in the description.  These
  577.   alternate keywords have the same meaning as the base keyword and may be
  578.   used interchangably.
  579.  
  580.   The minimum keywords needed for any configuration file:
  581.  
  582.      HOSTSYSOP     (the host sysop name)
  583.      SYSOP         (your name)
  584.      HOSTORIGIN    (host system tagline)               [or HTAG0]
  585.      ORIGIN        (your system tagline)               [or TAG0]
  586.      CONF          (one per conference being echoed)   [or CONVERT]
  587.  
  588.   Highly recommended to be included in any configuration file:
  589.  
  590.      REPLYPROCESS  (so you know exactly what to expect)
  591.      WORKDIR       (or allow environment to specify)
  592.      NODE          (or allow environment to specify)
  593.      USERNET       (even if only specifying "NONE")
  594.  
  595.   You might do well using the example HOST_ID.CFG file as a base for creating
  596.   your configuration files.  Simply copy or rename the HOST_ID.CFG file to
  597.   the proper name for your host (replace HOST_ID with the node/netname of the
  598.   host maildoor, such as FTL or TRP, or EXECNET), then edit the file as
  599.   needed.  Remove any excess CONF statements to avoid exporting messages into
  600.   the wrong conferences!
  601.  
  602.  
  603. RNET.DOC                                                               Page 13
  604.  
  605.  
  606.  
  607.   _________________________Keywords: Names and Users_________________________
  608.  
  609.   HOSTSYSOP    Actual name of your host sysop.  This is the name that
  610.                incoming messages addressed to/from "SYSOP" on your host
  611.                systems board will be translated into.
  612.                SYN: HOST_SYSOP
  613.  
  614.   SYSOP        Your name.  Messages addressed to/from "SYSOP" on your system
  615.                will be translated into this name for outgoing messages.
  616.                SYN: LOCAL_SYSOP LOCALSYSOP
  617.  
  618.   MAKESYSOP    YES|NO; Should RNet address incoming mail to "SYSOP"?  If you
  619.                specify YES to this keyword, RNet will translate any incoming
  620.                messages addressed to/from your name into "SYSOP".
  621.                SYN: MAKE_SYSOP
  622.  
  623.   PRIVATEUSER  Up to 25 users may be specified as "private mail users".  Any
  624.                users specified by a PRIVATEUSER= entry in the CFG file will
  625.                be allowed to send private (R/O) messages despite the global
  626.                PRIVATE= setting.  Useful for moderators, hosts, net sysops,
  627.                and administration folks to send private messages up the
  628.                network.  Note that this does not change the settings of your
  629.                host's mail door -- private messages sent from the host are
  630.                controlled by the host.
  631.                SYN: PRIVATE_USER SPECIAL_USER PRIVATE_MAIL SPECIALUSER
  632.  
  633.                Example:  PRIVATEUSER=GEORGE CARLIN
  634.  
  635.   TCAN         You may specify up to 25 names (one full name per line) which
  636.                RNet should refuse to process.  Any message addressed to/from
  637.                this user will not be imported or exported but instead written
  638.                to TCAN.LOG in the current directory.
  639.                SYN: TRASHCAN TRASH BADUSER BAD_USER
  640.  
  641.   TOCAN        You may specify up to 10 names with the TOCAN keyword (one
  642.                name per occurrence of TOCAN in the CFG file).  If a message
  643.                is addressed TO this name, RNet will refuse to import/export
  644.                it. As with TCAN, the refused messages are written to TCAN.LOG
  645.                for your review.
  646.                SYN: TRASHCAN_TO TO_TCAN
  647.  
  648.   FRCAN        The same as TOCAN except checks the name against the FROM
  649.                field for each message instead of the TO field.
  650.                SYN: TRANSHCAN_FROM FROMTCAN FROM_TCAN
  651.  
  652.  
  653. RNET.DOC                                                               Page 14
  654.  
  655.  
  656.  
  657.   HANDLE       Up to 50 handle/alias translations may be specified.  This
  658.                keyword allows translation of the user name in the TO/FROM
  659.                fields in two ways.  Because there are two forms for this
  660.                keyword it has confused folks in the past.  Hopefully, these
  661.                explanations and examples will help.
  662.  
  663.                Format:   HANDLE=AlwaysFromThis,AlwaysToThis
  664.                Example:  HANDLE=SPARKY,MARK HERRING
  665.  
  666.                    This example will translate "SPARKY" to "MARK HERRING".
  667.                    *Everytime* "SPARKY" is seen in the to/from fields of a
  668.                    message it will be changed into "MARK HERRING".  The name
  669.                    "SPARKY" will basically never appear locally or on the
  670.                    network, as it will *always* be changed to "MARK HERRING".
  671.  
  672.                    During     the name       is changed to
  673.                    ---------  -------------  -------------
  674.                    IMPORT     SPARKY         MARK HERRING
  675.                    IMPORT     MARK HERRING   MARK HERRING
  676.                    EXPORT     SPARKY         MARK HERRING
  677.                    EXPORT     MARK HERRING   MARK HERRING
  678.  
  679.                The second method of name translation allows you to change a
  680.                name one way during import and the other during export.  Thus,
  681.                you can specify how a name appears on your board which is
  682.                different from the way it appears over the network.  Note the
  683.                addition of the asterisk in the following example:
  684.  
  685.                Format:   HANDLE=*ExportAsThis,ImportAsThis
  686.                Example:  HANDLE=*SPARKY,MARK HERRING
  687.  
  688.                    The asterisk is used to signify that you wish the
  689.                    translation to "reverse" when doing an export.  Anytime
  690.                    the name "SPARKY" or "MARK HERRING" is seen during an
  691.                    import, it is changed into "MARK HERRING".  Anytime
  692.                    "SPARKY" or "MARK HERRING" is seen during an export it is
  693.                    instead changed into "SPARKY".
  694.  
  695.                    During     the name       is changed to
  696.                    ---------  -------------  -------------
  697.                    IMPORT     SPARKY         MARK HERRING
  698.                    IMPORT     MARK HERRING   MARK HERRING
  699.                    EXPORT     SPARKY         SPARKY
  700.                    EXPORT     MARK HERRING   SPARKY
  701.  
  702.                    Thus the name "SPARKY" will always appear over the network
  703.                    while the name "MARK HERRING" will always appear on your
  704.                    board.
  705.  
  706.                Use HANDLE=Name1,Name2 when you *always* want 'Name1' to
  707.                be changed into 'Name2'.
  708.  
  709.                Use HANDLE=*Name1,Name2 when you want 'Name1' to appear
  710.                on the network and 'Name2' to appear on your board.
  711.  
  712.                SYN: ALIAS NAME_CHANGE
  713.  
  714. RNET.DOC                                                               Page 15
  715.  
  716.  
  717.  
  718.  
  719.   _____________________________Keywords: Taglines____________________________
  720.  
  721.   Taglines are always forced into a standard format.  Before the first
  722.   tagline that is to appear on a message, a tearline must appear.  A tearline
  723.   is composed of a line with three dashes ("---") optionally followed by
  724.   additional text (FidoNet compatable method).  All taglines follow this
  725.   tearline and begin with either " ■ " or " * ".  RNet will automatically fix
  726.   taglines from other software packages that do not conform to this standard
  727.   and will remove blank lines from between taglines.  RNet will automatically
  728.   chop off any taglines in excess of two.
  729.  
  730.   HOSTORIGIN   Use HOSTORIGIN to specify what tagline to place on messages
  731.                that originate from your HOST system.  The host's mail door
  732.                does not place any taglines on messages, it is up to your end
  733.                of things.  The tagline should conform to whatever network
  734.                standards are currently in effect.  Note that the synonym
  735.                HTAG0 is commonly used instead of HOSTORIGIN.
  736.                SYN: HTAG0 HOST_ORIGIN HOST_TAG HOST_TAGLINE HOSTTAG
  737.  
  738.                Example:  HOSTORIGIN= ■ Host board name ■ City ■ Phone Number
  739.  
  740.   HTAG0..9     The ten HTAGx statements allow you to specify up to ten
  741.                different host taglines.  HTAG0 is the same as HOSTORIGIN and
  742.                may be used in place of it.  To specify which of these ten
  743.                taglines is to be used as the host tagline on any given
  744.                conference, see the CONF statement below.
  745.  
  746.   ORIGIN       ORIGIN is used to specify the tagline to be placed on messages
  747.                coming from your system.  All messages exported from your
  748.                system that originated from your system will have this tagline
  749.                placed on them.  The tagline should conform to the network
  750.                standards of the network in question.
  751.                SYN: TAG0 TAGLINE LOCALTAG LOCAL_TAG
  752.  
  753.                Example:  ORIGIN= * BBS Name, City, Phone Number
  754.  
  755.   TAG0..9      The ten TAGx keywords allow you to specify up to ten different
  756.                taglines for messages originating from your system.  TAG0 is a
  757.                replacement for ORIGIN and can be used in place of it.  To
  758.                specify which of these ten taglines are to be used for each
  759.                specific conference, see the CONF statement.
  760.  
  761.   FORCETAG     YES|NO.  If you specify YES for this keyword, RNet will
  762.                *always* append a tagline (host or origin, as appropriate) on
  763.                all messages processed.  Note that if the tagline addition
  764.                causes more than two taglines to be appended to the message,
  765.                any in excess of two will be stripped.  This is used mostly
  766.                for forcing tagging of messages for debugging use.
  767.                SYN: FORCE_TAG FORCE
  768.  
  769.                Default: NO (disabled; add tagline only when/if needed)
  770.  
  771.  
  772. RNET.DOC                                                               Page 16
  773.  
  774.  
  775.  
  776.   FORCENOTAG   YES|NO.  Specify YES to this keyword if you want to force RNet
  777.                *not* to append any taglines to any messages processed.  In
  778.                smaller and in-company business echo networks, you might
  779.                desire to have no taglines.
  780.                SYN: NOTAG FORCE_NO_TAG
  781.  
  782.                Default: NO (disabled; add tagline if needed)
  783.  
  784.   RTAG         YES|NO|ORIGIN.  The RTAG keyword enables (YES) or disables
  785.                (NO) the " ■ RNet v.vvx: " on the beginning of each tagline.
  786.                If RTAG=ORIGIN is specified, RNet will use the Fido standard
  787.                " * ORIGIN: " at the beginning of the line and append ":RNet
  788.                v.vvx" to the end.  Note that this keyword is subject to
  789.                different effects depending on the version/release of RNet:
  790.  
  791.                  Alpha/Beta: specifying NO changes the tagline id to a
  792.                  shorter id (" ■ Rvvvx:").  This information is used for
  793.                  beta debugging (watching) RNet operate over several large
  794.                  networks where strict control is not possible.
  795.  
  796.                  Unregistered: RTAG=YES and RTAG=NO have no effect.
  797.  
  798.                  Registered: specifying RTAG=NO will completely remove the
  799.                  " ■ RNet" part of the tagline.  In this case, the text you
  800.                  specify for host/origin (HTAGx and TAGx) taglines will be
  801.                  the *complete* text used for the taglines.
  802.  
  803.                SYN: RNETTAG RNET_TAG R_TAG
  804.  
  805.   FIXJH        YES|NO.  This keyword tells RNet if it should automatically
  806.                decrypt encrypted John Hancock version 2.xx taglines.  Some
  807.                networks do not allow encrypted taglines so this option allows
  808.                you to decrypt them automatically.  If you specify FIXJH=YES,
  809.                both incoming and outgoing messages will be checked and
  810.                decrypted.
  811.                SYN: FIX_JH_TAGS
  812.  
  813.                Default: NO (leave encrypted JH taglines alone)
  814.  
  815.  
  816.   ________________________Keywords: Packet Processing________________________
  817.  
  818.   COMPRESS     Specify the program and options needed to compress a REP
  819.                packet for sending to your host.  Check with your host about
  820.                what program/method should be used for packet compression
  821.                (most commonly PKZIP).  All appropriate filenames will be
  822.                added to this command when RNet calls it, so only specify the
  823.                command and switches (if any) needed.  NOTE: If the program
  824.                needed is not in the current directory or along the DOS PATH=
  825.                environment, specify the complete d:\dir\filename.ext.
  826.                SYN: PKPAK ARC PAK PKZIP ZIP
  827.  
  828.                Default:  PKZIP -m -ex
  829.  
  830.  
  831. RNET.DOC                                                               Page 17
  832.  
  833.  
  834.  
  835.   UNCOMPRESS   Specify the command (program) needed to uncompress an incoming
  836.                QWK packet from your host.  Check with your host as to what
  837.                program is needed.  The command must accept placing of a
  838.                directory specification on the end (last parameter) for RNet
  839.                to place the files in the work directory.  If this does not
  840.                work correctly (ie, is not supported by the decompression
  841.                program), you will need to remove all references (CFG and
  842.                environment) to WORKDIR= so RNet uses the current directory.
  843.                SYN: PKUNPAK UNARC UNPAK PKUNZIP UNZIP
  844.  
  845.                Default:  PKUNZIP -o
  846.  
  847.   WORKDIR      Use WORKDIR to specify the drive/directory where RNet should
  848.                place scratch files and uncompressed QWK packets.  If you have
  849.                a large enough RAM drive, specify that.  When RNet is done
  850.                processing, it will only delete the files it created or
  851.                uncompressed, thus, you may even use the current directory
  852.                safely if desired.
  853.  
  854.                Note that the drive/directory pointed to by WORKDIR must
  855.                already exist or RNet will report an error. A recommended
  856.                drive/directory would be the "play" or "scratch" directory
  857.                used by the processing node for up/download processing.
  858.  
  859.                This setting (WORKDIR) overrides the TMP= environment.
  860.  
  861.   REPLYPROCESS APPEND|OVERWRITE.  Specify APPEND for this keyword if you want
  862.                RNet to append new outgoing messages to an existing REP
  863.                packet.  This allows you to keep adding to the end of a REP
  864.                packet when your host has been busy.
  865.  
  866.                *WARNING*: if you use this option, you must delete your
  867.                HOST_ID.REP packet after successful upload to your host.
  868.                Failure to do so will result in uploading duplicate messages!
  869.                SYN: REPLY_PROCESS
  870.  
  871.                Default:  Delete (overwrite) existing HOST_ID.REP packets.
  872.  
  873.   ARCHIVE      The only option for this keyword is EXTERNAL and should only
  874.                be specified if you are prepared to handle it.  If you specify
  875.                ARCHIVE=EXTERNAL, RNet will not shell to DOS to execute the
  876.                COMPRESS and UNCOMPRESS commands, but will instead assume that
  877.                you are going to handle these functions before and after
  878.                calling RNet.  If you are in a tight memory situation, you
  879.                will likely need to use this option.  Please see LOWMEM.BAT
  880.                for more information and an example of how to handle
  881.                compression/decompression in this manner.
  882.  
  883.   QWKPATH      Specify the d:\dir\ where RNet should look for QWK packets
  884.                from your host.  RNet will automatically process multiple
  885.                packets (HOST_ID.QW?) if found, in numerical order.  You
  886.                should use this keyword to point to the download d:\dir\ that
  887.                your terminal communications program downloads QWK packets to.
  888.                SYN: QWK QWKS QWK_PATH QWKPACKETS QWK_PACKETS
  889.  
  890.                Default:  Current drive/directory
  891.  
  892. RNET.DOC                                                               Page 18
  893.  
  894.  
  895.  
  896.   REPPATH      Use this keyword to specify the d:\dir\ where RNet should
  897.                create HOST_ID.REP packets for sending to your host.  Usually
  898.                this will be the d:\dir\ where your terminal program expects
  899.                to find files for uploading.
  900.                SYN: REPLOC REP_PATH REPDIR REP_DIR
  901.  
  902.                Default:  Current drive/directory
  903.  
  904.   KILLQWK      YES|NO.  The KILLQWK keyword allows you to instruct RNet to
  905.                delete the HOST_ID.QWK packets after *successful* import.  If
  906.                anything goes wrong or if RNet has reported any warnings, the
  907.                packet will NOT be deleted.  This can be useful for your event
  908.                batch file to figure out if the import process proceeded
  909.                without any problems simply by looking for the existence of
  910.                *.QW? after import processing.  If *.QW? exists, something
  911.                went wrong.  If you do not use this option, be sure to
  912.                manually delete or move the packet before your next mailrun to
  913.                avoid inserting duplicate messages.
  914.                SYN: KILL_QWK DELETEQWK DELETE_QWK
  915.  
  916.                Default:  NO (QWK packets are not automatically deleted)
  917.  
  918.   CHECKREP     YES|NO.  If you wish, RNet can check for, and prompt you for
  919.                what to do with an existing REP packet (during both IMPORT and
  920.                EXPORT setup operations) when it finds one.  Specify
  921.                CHECKREP=YES to have RNet look for any existing REP packets,
  922.                and if one exists, prompt you to:  Delete the packet and
  923.                continue;  Retain the packet and abort operation; Continue
  924.                normally (default).  RNet will wait for 10 seconds for you to
  925.                make a decision.  This option is available so that if you do
  926.                manual processing of a mailrun, you will be prompted about the
  927.                disposition of any existing REP packets that you may have
  928.                forgotten to manually delete.
  929.                SYN: CHECK_REP
  930.  
  931.                Default:  NO (do not prompt operator for REP disposition)
  932.  
  933.   CKPOINTERS   YES|NO.  By default, RNet will automatically check all its
  934.                current pointers against the existing messagebases (which can
  935.                take a minute or two if you have 2000+ echo conferences).  If
  936.                it finds a problem, it will automatically correct the pointer
  937.                file.  Pointers are checked against the current High and Low
  938.                message numbers in the conference messagebase to determine
  939.                that the pointer is valid.  You may specify CKPOINTERS=NO to
  940.                disable this safety feature (this is *not* recommended!).
  941.                SYN: CHECKPOINTERS CHECK_POINTERS
  942.  
  943.                Default: YES (check all pointers every time RNet is run)
  944.  
  945.  
  946. RNET.DOC                                                               Page 19
  947.  
  948.  
  949.  
  950.   _________________________Keywords: Message Handling________________________
  951.  
  952.   PRIVATE      YES|NO.  This is a global specification as to if private (R/O)
  953.                messages are allowed on the network in question.  If the
  954.                network you are connecting to allows *all* users in *all*
  955.                conferences to send private (R/O) messages, specify
  956.                PRIVATE=YES.  Note that RNet will honor the PCBoard/ProDoor
  957.                conference configuration (PCBSETUP/PROSM) which specifies that
  958.                all messages should be private (R/O) regardless of this
  959.                keyword setting.  Use PRIVATE=NO and PRIVATECONF (see below)
  960.                to specify private messages are allowed only in specific
  961.                conferences.
  962.                SYN: SENDPRIVATE SEND_PRIVATE
  963.  
  964.                Default: NO (send only public messages)
  965.  
  966.   COMMENTS     YES|NO.  This keyword specifies if Sysop COMMENT security
  967.                messages should be exported.  This is useful if you are
  968.                running multiple BBS's and want to send all messages from one
  969.                system to another via RNet.  Note that PRIVATE must be
  970.                specified YES as well for this option to be in effect.
  971.                SYN: SENDCOMMENTS SEND_COMMENTS
  972.  
  973.                Default: NO (do not send COMMENT security messages)
  974.  
  975.   PRIVATECONF  You may specify a list of local conference numbers (separated
  976.                by commas) in which private messages are permitted to be
  977.                transmitted.  This option is added such that you may have a
  978.                network which only allows private (R/O) messages in certain
  979.                conferences.  You may specify as many PRIVATECONF statements
  980.                as needed or desired.  Note that using PRIVATE=YES is the
  981.                global of this keyword.
  982.                SYN: PRIVATE_CONF
  983.  
  984.                Example:  PRIVATECONF=1,10,11,12,200,201
  985.  
  986.   IGNOREECHO   As with PRIVATECONF, you may specify a list of conferences
  987.                (ie, by local conference number) in which you want to ignore
  988.                the PCBoard 14.x EchoFlag status.  This is useful if you have
  989.                an automated process or another mail package that turns off
  990.                the EchoFlag for some reason and you want to export the
  991.                messages despite the EchoFlag.  Normally, RNet will not export
  992.                messages that do not have the EchoFlag specifically enabled on
  993.                them.
  994.                SYN: IGNORE_ECHO
  995.  
  996.                Example:  IGNOREECHO=5,6,7,10,11,12,200,201
  997.  
  998.   ANSICONF     This keyword is used to enable ANSI escape sequences in any
  999.                given conference(s).  List conferences by local conference
  1000.                number (as with IGNOREECHO above).  RNet will "fix" translated
  1001.                (filtered) ANSI sequences when it can in these conferences.
  1002.                SYN: ANSI ACCEPT_ANSI
  1003.  
  1004. RNET.DOC                                                               Page 20
  1005.  
  1006.  
  1007.  
  1008.   KEYCODE      KEYCODE is used to support multiple or cross echoed networks
  1009.                within the same conferences.  KEYCODE specifies a single
  1010.                character, preferably one of !, @, #, $, %, ^, &, or a single
  1011.                alphanumeric character, which is to be used to specify the
  1012.                network of origin of a message.
  1013.  
  1014.                If you are only echoing a single network or if you are not
  1015.                involved in cross echoing of multiple networks into the same
  1016.                conferences (ie, not a 'gateway'), simply specify KEYCODE=! or
  1017.                something similar (DO NOT USE "*") and ignore the rest of this
  1018.                description.
  1019.  
  1020.                Specify a different KEYCODE for each network you will be
  1021.                echoing.  For example, if echoing ILink, you might specify
  1022.                KEYCODE=I, and for CanConfMail, specify KEYCODE=C.  Doing
  1023.                this, if you echo both networks into the same physical
  1024.                conference, messages from either network will be sent out to
  1025.                the other automatically (along with all replies and messages
  1026.                coming from "lower" on the networks).  This is known as a
  1027.                'Gateway' connection.
  1028.  
  1029.                If you wish to import multiple networks into the same
  1030.                conference and do not want to send the messages from one
  1031.                network to the other, specify the same KEYCODE for both
  1032.                networks (such as KEYCODE=! for in both configurations).  In
  1033.                this case (both KEYCODEs being the same), messages from one
  1034.                network host will *not* be sent to the other while all
  1035.                messages originating from your board (or lower on the
  1036.                network(s)) *will* be exported to both network hosts.  Not
  1037.                likely desired or needed, but the ability is there.
  1038.  
  1039.                Basic logic description:  All messages imported will have the
  1040.                defined KEYCODE assigned to them.  During export processing,
  1041.                any messages that have the exact KEYCODE on them will not be
  1042.                exported (thus avoiding bouncing messages back up the net).
  1043.                Messages sent up to your board from lower on the network will
  1044.                always have a keycode of "*".  If you did not want to send
  1045.                messages from lower on the network up the network (who knows
  1046.                why you would want to do this?!), specify a KEYCODE of "*".
  1047.                SYN: BBSKEY BBS_KEY BBS_KEYCODE
  1048.  
  1049.                Example:  KEYCODE=!
  1050.  
  1051.   ___________________________Keywords: Conferences___________________________
  1052.  
  1053.   CONF         You must specify one CONF statement for every echo conference
  1054.                you are intending to echo with your host.  The CONF keyword is
  1055.                used to specify how your local conference numbers correspond
  1056.                to the host's conference numbers.  You may also use it to
  1057.                specify an alternate tagline to be used for each conference
  1058.                (see HTAG0..9 and TAG0..9 above).  Commonly, the synonym
  1059.                CONVERT is used for CONF.
  1060.  
  1061.                Format:  CONF=Local#,Host#:Tag#
  1062.  
  1063.                Note that the ":Tag#" part of the CONF statement is optional
  1064.  
  1065. RNET.DOC                                                               Page 21
  1066.  
  1067.  
  1068.                and only needed if you wish to specify using taglines other
  1069.                than HTAG0 and TAG0 (see HTAG0..9 above).
  1070.  
  1071.                You may place "comments" after the CONF statement (avoid using
  1072.                a ":" in the comment!) such as listing the conference name.
  1073.                The examples below are valid as they are.  See also the
  1074.                SAMPLE?.CFG files.
  1075.                SYN: CONVERT CONFERENCE
  1076.  
  1077.                Example:  CONF=1,55      (my 1 = host 55, use H/TAG0 tags)
  1078.                Example:  CONF=2,56:0    (my 2 = host 56, use H/TAG0 tags)
  1079.                Example:  CONF=3,60:1    (my 3 = host 60, use H/TAG1 tags)
  1080.                Example:  CONF=4,61:1    (my 4 = host 61, use H/TAG1 tags)
  1081.                Example:  CONF=5,62:1    (Sysops Echo)
  1082.  
  1083.  
  1084.   _____________________________Keywords: NetNews_____________________________
  1085.  
  1086.   NetNews keywords are used to allow a network to support a special "NetNews"
  1087.   type conference that has only special news messages from the network
  1088.   administration.  The philosophy behind the RNet NetNews conference support
  1089.   is to create a conference that is not echoed, but instead has messages
  1090.   inserted in it that come from another conference.  The messages inserted
  1091.   into this special NetNews conference are designated by key words and users
  1092.   as defined by the following keywords.  Ask your network administration if
  1093.   this form of NetNews conference support is available and/or simply monitor
  1094.   the administration conferences and figure out for yourself what "special"
  1095.   messages should be extracted into a special conference (presumably, public
  1096.   for all users to read).
  1097.  
  1098.   All messages imported/exported in the NETADMIN conference are checked.  Any
  1099.   message that is addressed to ALL, addressed from NETADMIN, and the subject
  1100.   contains the text specified by NETSUBJECT, will be copied to the NETNEWS
  1101.   conference as public and non-echo.
  1102.  
  1103.   NETNEWS      Specify the local conference (by number) to be used as the
  1104.                destination for NetNews type messages.  Messages which match
  1105.                the parameters specified by the other keywords will be copied
  1106.                into this conference.  This will commonly NOT be an echo
  1107.                conference and usually has the "Make all messages private"
  1108.                option turned on in PCBSM/PROSM.  RNet will insert messages
  1109.                here as public (despite the "Make private" setting).
  1110.                SYN: NET_NEWS NET_NEWS_CONF
  1111.  
  1112.                Example:  NETNEWS=15     (use local conference 15 for NetNews)
  1113.  
  1114.   NETADMIN     Specify a local conference number that is normally used for
  1115.                Administration level messages.  This conference will be
  1116.                checked during processing for messages that match NETADMINID
  1117.                and NETSUBJECT.  Messages which match the requirements will be
  1118.                copied to the NETNEWS conference.  The original messages will
  1119.                still be imported/exported in this conference so that it is
  1120.                passed to other systems up and down the network.
  1121.                SYN: NET_ADMIN NET_ADMIN_CONF
  1122.  
  1123.                Example:  NETADMIN=44    (search conf 44 for NetNews messages)
  1124.  
  1125.  
  1126. RNET.DOC                                                               Page 22
  1127.  
  1128.  
  1129.   NETADMINID   Use this keyword to specify the name that a message must be
  1130.                FROM to qualify as a NetNews message.  Usually this is either
  1131.                a special alias (such as "Network Administration") or someone
  1132.                in the administration. The message in question must also be
  1133.                addressed to "ALL" to qualify -- this keeps replies and other
  1134.                comments from appearing in the NetNews conference.
  1135.                SYN: NET_ADMIN_ID NETADMIN_NAME NET_ADMIN_NAME
  1136.  
  1137.                Example:  NETADMINID=NETWORK ADMINISTRATION
  1138.  
  1139.   NETSUBJECT   Messages in the NETADMIN conference are checked, and assuming
  1140.                the message matches the NETADMINID the NETSUBJECT is checked.
  1141.                Specify a key phrase or word that must appear in the subject
  1142.                of the message to qualify as a NetNews message.  Usually this
  1143.                is something along the lines of "** ANNOUNCEMENT **".  The
  1144.                subject need not match exactly, but must contain the phrase or
  1145.                words specified with this keyword (which is *not* case
  1146.                sensitive).
  1147.                SYN: NET_SUBJECT
  1148.  
  1149.                Example:  NETSUBJECT=** ANNOUNCEMENT **
  1150.  
  1151.   Logic example:  Using the examples above, if a message appears in local
  1152.   conference 44 (either during import or export processing, so it works even
  1153.   when the message is going "up" the network) is addressed to "ALL", is from
  1154.   "NETWORK ADMINISTRATION" and has the text "** ANNOUNCEMENT **", that
  1155.   message will be copied to local conference 14 as public and non-echo.
  1156.  
  1157.  
  1158.   ________________________Keywords: Multinode/NodeChat_______________________
  1159.  
  1160.   If you are running a multinode system concurrently with your RNet event
  1161.   processing (which is perfectly safe, by the way), you should specify the
  1162.   following keywords to help RNet determine how to proceed.  RNet honors and
  1163.   will check the PCBoard messagebase LOCKED field when inserting messages in
  1164.   all cases.  Assuming you specify these keywords correctly, you may "watch"
  1165.   RNet processing via the NODE CHAT display.
  1166.  
  1167.   NODE         This keyword, when used, will override the environment
  1168.                variable NODE.  If you specify a value of 1-99, RNet will
  1169.                "login" to that node as far as the Node Chat and CALLERS logs'
  1170.                are concerned (see CALLERLOG below).  Specify a value of 0 and
  1171.                USERNET=NONE if running a single node system.  Specify a value
  1172.                of 0 and correctly specify USERNET=d:\dir\usernet.dat to have
  1173.                RNet use the NODE= environment.
  1174.                SYN: PCB_NODE NODE_NUMBER PCBNODE NODENUMBER
  1175.  
  1176.                Example:  NODE=3  (mail events are processed by node 3)
  1177.  
  1178.   USERNET      Specify the d:\dir\filename.ext of the PCBoard node chat
  1179.                USERNET.DAT file.  RNet will show up as a node on the Node
  1180.                Chat display reporting exactly what it is doing (Init,
  1181.                Exporting xxx, Importing xxx, Cleanup, etc) via the city/state
  1182.                field.  RNet must have this keyword specified correctly for
  1183.                its automatic speed selection from fast/slow.  If RNet sees a
  1184.                user on another node who is: Unavailable, Entering a message,
  1185.                or Out of code in door, then RNet will use a slow (safer)
  1186.  
  1187. RNET.DOC                                                               Page 23
  1188.  
  1189.  
  1190.                concurrent message entry routine.  If all users are Available
  1191.                or doing other things, RNet will use a faster insertion
  1192.                routine (it will not flush the directory structure between
  1193.                each message).
  1194.  
  1195.                If running a single node system specify USERNET=NONE.
  1196.                SYN: NETUSER NETUSERS NETDATA NETINFO
  1197.  
  1198.                Example:  USERNET=D:\PCB\MAIN\USERNET.DAT
  1199.  
  1200.   _____________________________Keywords: Reports_____________________________
  1201.  
  1202.   CONFREPORT   Specify the complete d:\dir\filename.ext that RNet should
  1203.                write the conference analysis report to.  This report shows
  1204.                each configured conference, number of messages exported/
  1205.                imported, locally created, percentages comparisons to traffic
  1206.                locally and netwide.  Very handy report to keep around!
  1207.                SYN: CONF_REPORT REPORTFILE REPORT_FILE
  1208.  
  1209.                Example:  CONFREPORT=D:\PCB\GEN\BLT20
  1210.  
  1211.   SUPERLOG     If you want this report, specify a d:\dir\filename.ext for
  1212.                this keyword.  The SUPERLOG (aka ALLMESSAGELOG), is a listing
  1213.                of every message imported or exported by conference, message
  1214.                number, subject, date, addressed to and from.  This log can
  1215.                quickly eat up valuable disk space (similar to the way a
  1216.                CALLERS log can), so don't let it sit around without attention
  1217.                too long.
  1218.                SYN: ALLMESSAGELOG
  1219.  
  1220.                Example:  SUPERLOG=D:\PCB\GEN\ALLMSGS.LOG
  1221.  
  1222.   DAILY        YES|NO.  Enable or disable the daily report analysis logging.
  1223.                RNet will normally create a log report listing each conference
  1224.                and the number of imported/exported messages.  These reports
  1225.                are automatically maintained for the last six days based on
  1226.                the day of the week.  The files created are in the default
  1227.                directory named VERBOSE.XXX where XXX is the day of the week
  1228.                (such as SUN, MON, TUE).  RNet always deletes "tomorrow's"
  1229.                report so that the reports do not consume excess drive space.
  1230.                Specify NO if you want to disable this reporting function.
  1231.                SYN: DAILYLOG DAILY_LOG
  1232.  
  1233.   CALLERLOG    If you want RNet to report the number of messages imported and
  1234.                exported in each conference to the CALLERS log, use CALLERLOG
  1235.                to specify the d:\dir\filename.ext for your CALLERS log file.
  1236.                If you are running a multinode system, do NOT include the node
  1237.                number on the end of the file as RNet will automatically
  1238.                append this.  If running a single node system (ie, NODE=0),
  1239.                RNet will not append a node number to the filename.  RNet will
  1240.                report itself logging in, a baud rate of (Event), Graphics on,
  1241.                and IMPORT or EXPORT for the city/state field.  Next, it will
  1242.                list each conference that has at least one message of traffic
  1243.                in it and the total number of messages imported or exported.
  1244.                Finally, RNet will report the number of minutes used and
  1245.                logoff "normally" (if that is the case).
  1246.                SYN: CALLER_LOG CALLERS
  1247.  
  1248. RNET.DOC                                                               Page 24
  1249.  
  1250.  
  1251.  
  1252.                Example:  CALLERLOG=D:\PCB\MAIN\CALLERS
  1253.  
  1254.   LONGCALLER   YES|NO.  If you specify YES for this keyword, the CALLERLOG
  1255.                report will be much more verbose.  The LONGCALLER report lists
  1256.                every message imported/exported as if a "user" had left the
  1257.                messages in the first place.  This can be useful for caller
  1258.                analysis programs to know exactly how much message traffic is
  1259.                occuring in each conference.
  1260.                SYN: VERBOSECALLERLOG VERBOSE_CALLER_LOG LONG_CALLER_LOG
  1261.  
  1262.                Default: NO (use the short callerlog report format)
  1263.  
  1264.  
  1265.   ____________________________Keywords: Additional___________________________
  1266.  
  1267.   EXTENDED     YES|NO.  This keyword is used to clarify to RNet if your host
  1268.                is using or supporting more than 255 conferences.  This may or
  1269.                may not be needed depending on the mail door you are using on
  1270.                your host.  If you are using MarkMail 2.xx or KMail with
  1271.                conferences numbered higher than 255 on your host (your local
  1272.                conference numbers are not important), you may need to specify
  1273.                EXTENDED=YES to be sure RNet understands.  RNet should be able
  1274.                to determine this for itself, but since there is no agreed-to
  1275.                standard, RNet may need some help figuring it out.
  1276.                SYN: EXTENDED_CONFS EXTENDEDCONFS
  1277.  
  1278.   RUN          You may specify as many RUN statements in your configuration
  1279.                file as desired.  When RNet encounters the RUN keyword in the
  1280.                configuration file, it takes the text following the equals
  1281.                sign and executes a DOS COMMAND.COM/C shell with the command
  1282.                specified.  This is useful if you want to be sure RNet does
  1283.                something every time it is run without having to remember to
  1284.                run a batch file to access RNet.  A common use is to force
  1285.                RNEt to update its RNETCONF file with any changes to your
  1286.                conference setup since the last time it ran.
  1287.  
  1288.                Example: RUN=PCBCONF d:\pcb\main\cnames -i
  1289.                Example: RUN=IF EXIST *.QW? COPY *.QW? D:\HOLDQWKS
  1290.                Example: RUN=MD S:\WORK
  1291.  
  1292.  
  1293. RNET.DOC                                                               Page 25
  1294.  
  1295.  
  1296.  
  1297.   ____________________________Initial Installation___________________________
  1298.  
  1299.   [This assumes that you have already arranged NetStatus with your host BBS
  1300.   and is the most common setup design folks use for RNet.  Additional steps
  1301.   (such as step 5) are added to account for differing situations.]
  1302.  
  1303.    1.  Create a directory for RNet.  Copy all the files from the distribution
  1304.        ZIP into this directory.  Later, you can delete any files you don't
  1305.        need or want (such as the SAMPLE?.CFG files).
  1306.  
  1307.    2.  Run either PCBCONF.EXE or PROCONF.EXE to create the RNETCONF file --
  1308.        RNet will not operate without this file being created.  If running
  1309.        PCBoard 14.x, use PCBCONF.  If running ProDoor 2.9+, use PROCONF.
  1310.  
  1311.          Syntax:  PCBCONF D:\DIR\CNAMES
  1312.          Syntax:  PROCONF D:\DIR\CONFINFO
  1313.  
  1314.    3.  Use a text editor such as QEdit or Edlin to create a HOST_ID.CFG file.
  1315.        If desired, use one of the SAMPLE?.CFG files as a starting point by
  1316.        renaming or copying it to the appropriate HOST_ID.CFG name.
  1317.  
  1318.          Example:  FTL.CFG      (Faster-Than-Light BBS as host)
  1319.          Example:  TRP.CFG      (The Right Place<tm> BBS as host)
  1320.          Example:  EXECNET.CFG  (Executive Network BBS as host)
  1321.  
  1322.        See the documentation above for more information on HOST_ID.CFG files.
  1323.  
  1324.    4.  Run RNet to create a pointer file.  RNet will automatically check
  1325.        the pointers against the messagebases after the pointer file is
  1326.        created.  The TOP operation is selected in case you have another
  1327.        utility you have been using for echomail so that messages will not be
  1328.        lost (see step 5).
  1329.  
  1330.          Syntax:  RNET TOP HOST_ID
  1331.  
  1332.    5.  If you were previously running another echomail utility, run it one
  1333.        last time to export any messages which need to be exported.  This is
  1334.        done _after_ step 4 so that any messages entered on another node
  1335.        between steps 4 and 5 will not be lost.
  1336.  
  1337.        If you were previously running QNet or another QWK packet echomail
  1338.        package, place the newly created REP (if there is one) where you have
  1339.        instructed RNet to look for/create REPs.  Commonly, this is either the
  1340.        RNet directory or the directory where your terminal program expects to
  1341.        find files for uploading.  Assuming you have RNet set to APPEND to
  1342.        REPs (default configuration), RNet will append any new outgoing
  1343.        messages to this REP the next time you run an EXPORT.
  1344.  
  1345.        If you were previously running a non-QWK compatible echomail package,
  1346.        you should upload/send/do-whatever-is-needed the file up to your host
  1347.        -- it might be convenient to do this while handling step 6.
  1348.  
  1349.    6.  Call the host system and configure the mail door.  Open the mail door
  1350.        you will be using for your echomail transfers.  Configure the mail
  1351.        door for the conferences you will be transferring -- set all pointers
  1352.        as appropriate, usually by "topping" all conferences.
  1353.  
  1354. RNET.DOC                                                               Page 26
  1355.  
  1356.  
  1357.  
  1358.        If you were previously using a QWK packet system, you probably need
  1359.        change nothing.  If you have a REP file for upload, you should upload
  1360.        it now.  (If you do upload it, don't forget to delete it!)
  1361.  
  1362.    7.  Download a QWK packet.  You might want to change the pointers on all
  1363.        of the conferences you will be echoing such that you get SOMETHING in
  1364.        every conference.  In other words, set the pointer for each conference
  1365.        to one less than the high message number.  This should result in you
  1366.        getting one message per conference.  Download the QWK to the directory
  1367.        where you have told RNet to expect to find QWK's.
  1368.  
  1369.    8.  Logoff the host, go back to the RNet directory and execute a RNET
  1370.        IMPORT HOST_ID -- this assumes that you did get a QWK packet while in
  1371.        the mail door.  Watch the operation to be sure that nothing is wrong
  1372.        (conferences go where they should, work directory exists, etc).  Make
  1373.        any changes to the HOST_ID.CFG as needed.  After successful IMPORT of
  1374.        the QWK packet, be sure to delete it (if you have KILLQWK=NO).
  1375.  
  1376.    9.  Setup an automated method (suggested) of transferring the mail.
  1377.        Usually this is done via EVENT.SYS and a communications program script
  1378.        or perhaps a package such as RoboComm.
  1379.  
  1380.   10.  If you have any questions or problems, you host will probably have the
  1381.        quickest answers and can help.  If RNet refuses to run or has a
  1382.        problem, it will report (both to the screen and to an ERROR.LOG file)
  1383.        where it is having difficulties.  Check drive & directory entries
  1384.        carefully, as they are the most common problem causing elements.
  1385.  
  1386.        If RNet says: "NetStatus Not Enabled", try adding EXTENDED=YES to your
  1387.        CFG file.  If it still says "NetStatus Not Enabled", you need to call
  1388.        your host to enable NetStatus (some doors don't "believe" the NetStatus
  1389.        until told a couple times... sheesh).
  1390.  
  1391.  
  1392. RNET.DOC                                                               Page 27
  1393.  
  1394.  
  1395.  
  1396.   _________________________Copyrights and Trademarks_________________________
  1397.  
  1398.   All programs mentioned are copyrighted and/or trademarked by their
  1399.   respective holders.  Please refer to each respective program to determine
  1400.   the actual copyright/trademark holder as appropriate or needed.
  1401.  
  1402.  
  1403.   ______________________________Acknowledgments______________________________
  1404.  
  1405.   Roger Sligar -- Sysop of The Right Place<tm> in Atlanta.  He gets top
  1406.                   billing around here for all his support/prodding/effort and
  1407.                   uncountable hours of chasing down bugs/messages across the
  1408.                   world!  It was the desire to safely and dependably run a
  1409.                   couple echo's with TRP that was the invention of RNet.
  1410.  
  1411.   Mark Herring -- Inventor of the QWK format and offline readers/maildoors.
  1412.                   Without his original ideas to bring offline readers to the
  1413.                   PCBoard market, RNet would never have existed.
  1414.  
  1415.   ILink        -- (formally InterLink).  A good international network of good
  1416.                   folks who very quickly adopted RNet into wide use.  It is
  1417.                   for the continued growth of networks like ILink that RNet
  1418.                   is constantly being improved.
  1419.  
  1420.   ... and to the many registered Sysops who are running RNet! -- Thank you for
  1421.   your support and as always, please let me know of any ideas or suggestions
  1422.   you have!  I hope you and your users enjoy the wild and wonderful world of
  1423.   EchoConferences!
  1424.  
  1425.  
  1426.