home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / qns311.zip / Q-README < prev    next >
Text File  |  1991-02-19  |  9KB  |  186 lines
  1.  ┌──────────────────────────────────────────────────────────────────────────┐
  2.  │ Q-README           Copyright 1988-1991 by Rik Brown                      │
  3.  │                                                                          │
  4.  │                    QNS v3.11 (02/19/91) information                      │
  5.  │                                                                          │
  6.  │                    QNS = Qmodem Networking Scripts                       │
  7.  └──────────────────────────────────────────────────────────────────────────┘
  8.  
  9.   WHAT DOES QNS DO?
  10.   -----------------
  11.   QNS automates mail runs for sysops using RNET or PCRELAY software for
  12.   importing and exporting mail to/from the PCBoard message bases via various
  13.   mail doors. It is designed to operate from one's nightly event, but can be
  14.   invoked anytime from the QNS batch file.
  15.  
  16.     Designed to automate the exchange of messages between two PCBoard BBSs
  17.     or a PCBoard and a user. Allows the dialing of 2 different numbers in
  18.     rotation when a busy signal is reached. Allows one to reject low speed
  19.     connects, set the number of redial tries, # of connect attempts, # of
  20.     upload attempts, # of download attempts, etc. Has a built in debugging
  21.     mode, and maintains a running log of activity, plus a capture of the most
  22.     recent session for further debugging.
  23.  
  24.   *.LOG is a Qmodem log created by this script.
  25.   *.CAP is a Qmodem capture of the last session created by this script.
  26.  
  27.   SUPPORT
  28.   -------
  29.   The latest version of QNS is available on Travel Online BBS under the
  30.   name of QNS*.ZIP and is a FREE download for first time users.
  31.  
  32.     TRAVEL ONLINE BBS
  33.  
  34.     (314) 973-4073  Hayes ULTRA v.32  ST. LOUIS, MO  (PC-Pursuit: MOSLO)
  35.     (314) 625-4045  Hayes ULTRA v.32  LAKE ST. LOUIS, MO (AT&T, MCI)
  36.  
  37.   I will try to help if you leave comments to me on TRAVEL ONLINE. I cannot
  38.   support QNS on echomail networks or SALT AIR BBS. Please let me know if
  39.   you encounter any problems or have suggestions for improvements.
  40.  
  41.     Rik Brown -- Sysop -- Travel Online BBS
  42.  
  43.   WHAT ARE THE LATEST VERSIONS?
  44.   -----------------------------
  45.   QNS has several years background with thousands of successful mail runs
  46.   performed. I use QNS on a nightly basis to call several PCBoards. The
  47.   latest versions are as follows:
  48.  
  49.   QNS v3.11 (02/19/91) for RNET ■ Qmodem 4.x ■ PCBoard 14.x ■ Various doors
  50.   * Current doors: QMAIL 3.0 - 4.0, MARKMAIL 1.x - 2.x, PCRELAY 4.x
  51.   QNS v2.00 (08/21/89) for QNET ■ Qmodem 4.x ■ PCBoard 14.x ■ Qmail Door 2.x
  52.   QNS v1.04 (12/12/88) for QNET ■ Qmodem 3.x ■ PCBoard 14.x ■ Qmail Door 2.x
  53.  
  54.   IMPORTANT NEWS FOR THIS VERSION
  55.   -------------------------------
  56.   Both the QMAIL 4.0 and MARKMAIL 2.0 doors are in beta testing at the
  57.   time of this release. If we find major changes in the doors which call
  58.   for a revision of QNS, we will release an updated version. Hopefully,
  59.   this will not be required.
  60.  
  61.   This version uses COLOR for QNS screens. If you are running monochrome,
  62.   please refer to your Qmodem manual and adjust the ATWRITE ATTRIBUTEs in
  63.   the script files.
  64.  
  65.   I have made the script more generic in that it can be set to use a "PCBoard
  66.   Script Prompts" selection for boards offering multilingual operations. This
  67.   should make it work properly on any current PCBoard even if the sysop has
  68.   customized the standard PCBoard prompts. If your sysop has made any changes
  69.   in the standard prompts, ask that a script prompts language selection be
  70.   available if it is not already (check further with your sysop).
  71.  
  72.   DISCLAIMER
  73.   ----------
  74.   This version has been tested on my system and may or may not work on yours.
  75.   Use only at your own risk. I hope you will find it useful. It is copyrighted
  76.   code, but sysops and BBS users are allowed non-commercial PERSONAL usage.
  77.  
  78.   It is written with high speed modems such as the Hayes ULTRA v.32 modem in
  79.   mind. Qmodem initializes the modem per your Qmodem set up.
  80.  
  81.   REQUIREMENTS
  82.   ------------
  83.   Requires a registered version of DSZ (suggest Zmodem protocol) for error
  84.   handling. DSZ.COM must exist in a directory in your DOS PATH such as
  85.   C:\UTIL.
  86.  
  87.   FILES INCLUDED IN QNS*.ZIP AND SAMPLE LOCATIONS
  88.   -----------------------------------------------
  89.     Q-README      C:\QMODEM\SCRIPT   Text file you are reading
  90.  
  91.     QNS.BAT       C:\BATCH           QNS master batch file (runs the session)
  92.     QNSRZ.BAT     C:\BATCH           DSZ protocol batch file (receive)
  93.     QNSSZ.BAT     C:\BATCH           DSZ protocol batch file (send)
  94.  
  95.     Q-SETUP  CMD  C:\QMODEM\SCRIPT   QNS setup script
  96.     Q-SETUP  CFG  C:\QMODEM\SCRIPT  (Created by QNS.BAT using DOS COPY)
  97.     Q-LOGON  SCR  C:\QMODEM\SCRIPT   QNS logon script
  98.  
  99.     Q-MM1.SCR     C:\QMODEM\SCRIPT   MarkMail 1.x door script
  100.     Q-MM2.SCR     C:\QMODEM\SCRIPT   MarkMail 2.x door script
  101.     Q-QM3.SCR     C:\QMODEM\SCRIPT   Qmail    3.x door script
  102.     Q-QM4.SCR     C:\QMODEM\SCRIPT   Qmail    4.x door script
  103.     Q-RELAY.SCR   C:\QMODEM\SCRIPT   PCRelay  4.x door script
  104.  
  105.     Q-LOGOFF.SCR  C:\QMODEM\SCRIPT   End online session script
  106.     Q-FINISH.SCR  C:\QMODEM\SCRIPT   End online session script
  107.  
  108.     MIDI          C:\QMODEM\SCRIPT   CFG file for SOUND MANAGEMENT (PC-Relay)
  109.     MUSIC         C:\QMODEM\SCRIPT   CFG file for SOUND OF MUSIC   (MarkMail)
  110.     SALTAIR       C:\QMODEM\SCRIPT   CFG file for SALT AIR         (Qmail)
  111.     TRAVEL        C:\QMODEM\SCRIPT   CFG file for TRAVEL ONLINE    (Qmail)
  112.  
  113.   HOW TO SET UP QNS
  114.   -----------------
  115.   Setting up QNS is simple. But, beforing doing so, be sure that you are
  116.   able to operate mail runs manually without QNS. Once you are able to do
  117.   so manually and thus sure that you have all your directories set up
  118.   properly for RNET or PCRELAY, you are then ready to setup up QNS to
  119.   automate mail runs for you.
  120.  
  121.   * Place all of the above files in their respective directories.
  122.     ------------------------------------------------------------
  123.  
  124.     The batch files should be in a directory in your DOS PATH.
  125.  
  126.     The rest of the files should be in your Qmodem SCRIPT directory as
  127.     defined in your Qmodem setup (alt-N).
  128.  
  129.   * Adjust the path/file names in the three batch files to fit your system.
  130.     ----------------------------------------------------------------------
  131.  
  132.     The QNS.BAT file is currently coded for my directories as follows:
  133.  
  134.       QMODEM = R:\QMODEM              Where QMODEM.EXE is located
  135.       RNET   = C:\RNET                Where RNET  mail is processed
  136.       RELAY  = R:\RELAY\NODEMIDI      Where RELAY mail is processed
  137.  
  138.     The QNS.BAT file needs to be edited to conform to your drive/directories
  139.     for QMODEM and RNET (or RELAY if you are running PCRELAY software).
  140.  
  141.     Carefully go through each line and edit the drives/directories to match
  142.     your own locations. You may first want to invoke this batch file without
  143.     parameters to see a list of command line parameters for your reference.
  144.  
  145.     The QNSRZ.BAT and the QNSSZ.BAT files call DSZ and reads the errorlevel
  146.     passed by the DSZ exit code when transferring mail packets. These two
  147.     batch files are coded for Zmodem per my DSZ command line.
  148.  
  149.     You may wish to examine the first line of these two batch files and make
  150.     any alterations to it except to the %1\%2 in the DSZ command line which
  151.     is required. You must have a registered version of DSZ for these to work.
  152.  
  153.   * Adjust the information in the CFG file which you will use.
  154.     ---------------------------------------------------------
  155.  
  156.     Edit the configuration file for the BBS to which you are calling. You
  157.     may create (DOS COPY) and edit any individual CFG file for each BBS
  158.     that you call. I have included several sample CFG files for boards
  159.     which I call to exchange mail:
  160.  
  161.       MIDI     config file for SOUND MANAGEMENT, Chicago, IL  PCRELAY
  162.       MUSIC    config file for SOUND OF MUSIC, Oceanside, NY  MARKMAIL2/RNET
  163.       SALTAIR  config file for SALT AIR, Salt Lake City, UT   QMAIL4/RNET
  164.       TRAVEL   config file for TRAVEL ONLINE, St. Louis, MO   QMAIL4/RNET
  165.  
  166.     If you call any of these boards it will be very simple for you to just
  167.     change these to fit your needs such as editing my name to yours and
  168.     putting in your proper password, etc. Each line is commented below it.
  169.  
  170.     Be sure to check each ODD numbered (1,3,5,etc.) line for compatability
  171.     with your set up. Each one of these lines is utilized by the script.
  172.  
  173.     There is no error checking to make sure you have placed the proper
  174.     information on each line. So please be careful as proper information must
  175.     be passed to the script for proper execution.
  176.  
  177.     The even numbered (2,4,6,etc.) comment lines are included for easy
  178.     reference as to what must be filled in above. The comment lines do not
  179.     contain information utilized by the script but they must remain as they
  180.     are counted by the script as a buffer between the ODD configuration lines.
  181.  
  182.   * Note that the script files themselves need NO EDITING.
  183.     -----------------------------------------------------
  184.  
  185.     All editable info is in the BATCH files and the CFG files.
  186.