 Ŀ
  Q-README           Copyright 1988-1991 by Rik Brown                      
                                                                           
                     QNS v3.11 (02/19/91) information                      
                                                                           
                     QNS = Qmodem Networking Scripts                       
 

  WHAT DOES QNS DO?
  -----------------
  QNS automates mail runs for sysops using RNET or PCRELAY software for
  importing and exporting mail to/from the PCBoard message bases via various
  mail doors. It is designed to operate from one's nightly event, but can be
  invoked anytime from the QNS batch file.

    Designed to automate the exchange of messages between two PCBoard BBSs
    or a PCBoard and a user. Allows the dialing of 2 different numbers in
    rotation when a busy signal is reached. Allows one to reject low speed
    connects, set the number of redial tries, # of connect attempts, # of
    upload attempts, # of download attempts, etc. Has a built in debugging
    mode, and maintains a running log of activity, plus a capture of the most
    recent session for further debugging.

  *.LOG is a Qmodem log created by this script.
  *.CAP is a Qmodem capture of the last session created by this script.

  SUPPORT
  -------
  The latest version of QNS is available on Travel Online BBS under the
  name of QNS*.ZIP and is a FREE download for first time users.

    TRAVEL ONLINE BBS

    (314) 973-4073  Hayes ULTRA v.32  ST. LOUIS, MO  (PC-Pursuit: MOSLO)
    (314) 625-4045  Hayes ULTRA v.32  LAKE ST. LOUIS, MO (AT&T, MCI)

  I will try to help if you leave comments to me on TRAVEL ONLINE. I cannot
  support QNS on echomail networks or SALT AIR BBS. Please let me know if
  you encounter any problems or have suggestions for improvements.

    Rik Brown -- Sysop -- Travel Online BBS

  WHAT ARE THE LATEST VERSIONS?
  -----------------------------
  QNS has several years background with thousands of successful mail runs
  performed. I use QNS on a nightly basis to call several PCBoards. The
  latest versions are as follows:

  QNS v3.11 (02/19/91) for RNET  Qmodem 4.x  PCBoard 14.x  Various doors
  * Current doors: QMAIL 3.0 - 4.0, MARKMAIL 1.x - 2.x, PCRELAY 4.x
  QNS v2.00 (08/21/89) for QNET  Qmodem 4.x  PCBoard 14.x  Qmail Door 2.x
  QNS v1.04 (12/12/88) for QNET  Qmodem 3.x  PCBoard 14.x  Qmail Door 2.x

  IMPORTANT NEWS FOR THIS VERSION
  -------------------------------
  Both the QMAIL 4.0 and MARKMAIL 2.0 doors are in beta testing at the
  time of this release. If we find major changes in the doors which call
  for a revision of QNS, we will release an updated version. Hopefully,
  this will not be required.

  This version uses COLOR for QNS screens. If you are running monochrome,
  please refer to your Qmodem manual and adjust the ATWRITE ATTRIBUTEs in
  the script files.

  I have made the script more generic in that it can be set to use a "PCBoard
  Script Prompts" selection for boards offering multilingual operations. This
  should make it work properly on any current PCBoard even if the sysop has
  customized the standard PCBoard prompts. If your sysop has made any changes
  in the standard prompts, ask that a script prompts language selection be
  available if it is not already (check further with your sysop).

  DISCLAIMER
  ----------
  This version has been tested on my system and may or may not work on yours.
  Use only at your own risk. I hope you will find it useful. It is copyrighted
  code, but sysops and BBS users are allowed non-commercial PERSONAL usage.

  It is written with high speed modems such as the Hayes ULTRA v.32 modem in
  mind. Qmodem initializes the modem per your Qmodem set up.

  REQUIREMENTS
  ------------
  Requires a registered version of DSZ (suggest Zmodem protocol) for error
  handling. DSZ.COM must exist in a directory in your DOS PATH such as
  C:\UTIL.

  FILES INCLUDED IN QNS*.ZIP AND SAMPLE LOCATIONS
  -----------------------------------------------
    Q-README      C:\QMODEM\SCRIPT   Text file you are reading

    QNS.BAT       C:\BATCH           QNS master batch file (runs the session)
    QNSRZ.BAT     C:\BATCH           DSZ protocol batch file (receive)
    QNSSZ.BAT     C:\BATCH           DSZ protocol batch file (send)

    Q-SETUP  CMD  C:\QMODEM\SCRIPT   QNS setup script
    Q-SETUP  CFG  C:\QMODEM\SCRIPT  (Created by QNS.BAT using DOS COPY)
    Q-LOGON  SCR  C:\QMODEM\SCRIPT   QNS logon script

    Q-MM1.SCR     C:\QMODEM\SCRIPT   MarkMail 1.x door script
    Q-MM2.SCR     C:\QMODEM\SCRIPT   MarkMail 2.x door script
    Q-QM3.SCR     C:\QMODEM\SCRIPT   Qmail    3.x door script
    Q-QM4.SCR     C:\QMODEM\SCRIPT   Qmail    4.x door script
    Q-RELAY.SCR   C:\QMODEM\SCRIPT   PCRelay  4.x door script

    Q-LOGOFF.SCR  C:\QMODEM\SCRIPT   End online session script
    Q-FINISH.SCR  C:\QMODEM\SCRIPT   End online session script

    MIDI          C:\QMODEM\SCRIPT   CFG file for SOUND MANAGEMENT (PC-Relay)
    MUSIC         C:\QMODEM\SCRIPT   CFG file for SOUND OF MUSIC   (MarkMail)
    SALTAIR       C:\QMODEM\SCRIPT   CFG file for SALT AIR         (Qmail)
    TRAVEL        C:\QMODEM\SCRIPT   CFG file for TRAVEL ONLINE    (Qmail)

  HOW TO SET UP QNS
  -----------------
  Setting up QNS is simple. But, beforing doing so, be sure that you are
  able to operate mail runs manually without QNS. Once you are able to do
  so manually and thus sure that you have all your directories set up
  properly for RNET or PCRELAY, you are then ready to setup up QNS to
  automate mail runs for you.

  * Place all of the above files in their respective directories.
    ------------------------------------------------------------

    The batch files should be in a directory in your DOS PATH.

    The rest of the files should be in your Qmodem SCRIPT directory as
    defined in your Qmodem setup (alt-N).

  * Adjust the path/file names in the three batch files to fit your system.
    ----------------------------------------------------------------------

    The QNS.BAT file is currently coded for my directories as follows:

      QMODEM = R:\QMODEM              Where QMODEM.EXE is located
      RNET   = C:\RNET                Where RNET  mail is processed
      RELAY  = R:\RELAY\NODEMIDI      Where RELAY mail is processed

    The QNS.BAT file needs to be edited to conform to your drive/directories
    for QMODEM and RNET (or RELAY if you are running PCRELAY software).

    Carefully go through each line and edit the drives/directories to match
    your own locations. You may first want to invoke this batch file without
    parameters to see a list of command line parameters for your reference.

    The QNSRZ.BAT and the QNSSZ.BAT files call DSZ and reads the errorlevel
    passed by the DSZ exit code when transferring mail packets. These two
    batch files are coded for Zmodem per my DSZ command line.

    You may wish to examine the first line of these two batch files and make
    any alterations to it except to the %1\%2 in the DSZ command line which
    is required. You must have a registered version of DSZ for these to work.

  * Adjust the information in the CFG file which you will use.
    ---------------------------------------------------------

    Edit the configuration file for the BBS to which you are calling. You
    may create (DOS COPY) and edit any individual CFG file for each BBS
    that you call. I have included several sample CFG files for boards
    which I call to exchange mail:

      MIDI     config file for SOUND MANAGEMENT, Chicago, IL  PCRELAY
      MUSIC    config file for SOUND OF MUSIC, Oceanside, NY  MARKMAIL2/RNET
      SALTAIR  config file for SALT AIR, Salt Lake City, UT   QMAIL4/RNET
      TRAVEL   config file for TRAVEL ONLINE, St. Louis, MO   QMAIL4/RNET

    If you call any of these boards it will be very simple for you to just
    change these to fit your needs such as editing my name to yours and
    putting in your proper password, etc. Each line is commented below it.

    Be sure to check each ODD numbered (1,3,5,etc.) line for compatability
    with your set up. Each one of these lines is utilized by the script.

    There is no error checking to make sure you have placed the proper
    information on each line. So please be careful as proper information must
    be passed to the script for proper execution.

    The even numbered (2,4,6,etc.) comment lines are included for easy
    reference as to what must be filled in above. The comment lines do not
    contain information utilized by the script but they must remain as they
    are counted by the script as a buffer between the ODD configuration lines.

  * Note that the script files themselves need NO EDITING.
    -----------------------------------------------------

    All editable info is in the BATCH files and the CFG files.
