home *** CD-ROM | disk | FTP | other *** search
/ Lion Share / lionsharecd.iso / rasbqbbs / qatest10.zip / QATEST.DOC < prev    next >
Text File  |  1991-10-17  |  15KB  |  442 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  ▄▓▓▓▓   █▀▀▄  ▄▄  ▄▄▄  ▄▄▄ ▄  ▄ ▄▄▄ █     █  ▄▄  ▄▄▄  ▄▄▄ tm
  17.  █▓▓▓▓   █  █ █  █ █  █ █▄  █▀▄█  █   █ █ █  █  █ █  █ █▄
  18.  █▓▓▓▓   █▀▀▄ ▀▄▄▀ █▄▄▀ █▄▄ █  █  █    █ █   █▀▀█ █▀▀▄ █▄▄  presents
  19.  ▀▀▀▀
  20.  
  21.  ▄▒▒▒▒   ▄▀▀▄    ▄▀▀▄  ▀▀█▀▀ ▄▄▄  ▄▄▄ ▄▄▄ tm
  22.  █▒▒▒▒   █  █ ▄▄ █  █    █   █▄  ▀▄▄   █
  23.  █▒▒▒▒    ▀▀▄    █▀▀█    █   █▄▄ ▄▄▄▀  █   Version 1.0
  24.  ▀▀▀▀        
  25.  
  26.  ▄░░░░   DOCUMENTATION
  27.  ▀▀▀▀
  28.  
  29.          Q-A Test  Version 1.0          (Registration fee $5.00)
  30.  
  31.  
  32.          Questionnaire File Simulator for RemoteAccess, QuickBBS
  33.          & SuperBBS
  34.  
  35.  
  36.          Copyright (c) 1991 by RodentWare.  All rights reserved.
  37.          Written by Michael Reece.
  38.  
  39.  
  40.          Documentation is Copyright (c) 1991 by CGL-Software.
  41.          Written by Peter Kling.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.      Q-A Test  Version 1.0  Documentation                         (Page  1)
  63.  
  64.  
  65.  
  66.  
  67.       TABLE OF CONTENTS
  68.  
  69.            Item of Interest                                    Page No.
  70.  
  71.            Cover Page .............................................. 1
  72.            Purpose ................................................. 2
  73.            ShareWare Notice ........................................ 2
  74.            Monies .................................................. 2
  75.            Keys .................................................... 3
  76.            Disclaimer .............................................. 3
  77.            System Requirements ..................................... 4
  78.            Installation ............................................ 4
  79.            Program Information ................................. 4 & 5
  80.            Documentation Package ................................... 5
  81.            Product Support Echo .................................... 5
  82.            Special Notice .......................................... 6
  83.            RodentWare Support System ........................... 6 & 7
  84.            Copyright Notices ....................................... 7
  85.            Acknowlegements & Credits ............................... 7
  86.  
  87.  
  88.  
  89.      PURPOSE
  90.  
  91.      Q-A Test  is  a handy  utility  to provide a  means of reviewing  your
  92.      questionnaires  without  actually  logging onto  your  bulletin  board
  93.      system.
  94.  
  95.  
  96.  
  97.      SHAREWARE NOTICE
  98.  
  99.      While this product is distributed freely, it is not free.  It has been
  100.      released  under  a  software  concept  known as  ShareWare.  ShareWare
  101.      allows you to evaluate a program to determine  if it suits your needs,
  102.      and register it with the author if you plan to continue usingit.  This
  103.      means that you have the  right to test this product for a period of no
  104.      more than  thirty  (30)  days.   At the  end of the  30 day evaluation
  105.      period, you must register your copy with the author, or stop using it.
  106.  
  107.      By registering the  ShareWare programs  you use, you encourage support
  108.      of that product, as well as the  creation of other ShareWare products.
  109.      The more people who register,  the more  programmers turn to te Share-
  110.      Ware concept.  It's that simple.
  111.  
  112.  
  113.  
  114.      MONIES
  115.  
  116.      There are currently two ways to  register  a  RodentWare product.  The
  117.      least expensive method is to  register  an individual program, such as
  118.      this one.   The  second method  is to  register as a "supporter" which
  119.      entitiles you to use any  RodentWare  products for your single regist-
  120.      ration.
  121.  
  122.  
  123.  
  124.  
  125.      Q-A Test  Version 1.0  Documentation                         (Page  2)
  126.  
  127.  
  128.  
  129.  
  130.      KEYS
  131.  
  132.      After registering your RodentWare products, you will recieve a special
  133.      "key file."  At startup,  all RodentWare  programs first check for the
  134.      existance  of  such  a key  to determine  if the  file  is registered.
  135.  
  136.      For a  registration  fee of  $5.00 (US)  you will receive a QATEST.KEY
  137.      registration KEY,  valid for Q-A Test only.   All versions of Q-A Test
  138.      will use the  same keyfile,  so you will never have to re-register the
  139.      same program.
  140.  
  141.      For a registration fee of  $50.00 (US)  you will receive a  RODENT.KEY
  142.      registration KEY, valid for  ALL RodentWare programs.  All versions of
  143.      all RodentWare programs will check for the same keyfile.   By choosing
  144.      to register  as a  RodentWare  "supporter,"  you will automatically be
  145.      registered  for  ALL RodentWare releases;  past,  present, and future.
  146.  
  147.      Please see the text file  RODENT.REG  included in the Q-A Test archive
  148.      for registration information.
  149.  
  150.  
  151.  
  152.      DISCLAIMER & LEGAL MATTERS
  153.  
  154.      The software  and accompanying  materials (including  instructions for
  155.      use) are  provided "as is" without warranty of  any kind. Further, the
  156.      author  disclaims  all warranties,  expressed  or  implied, including,
  157.      without  limitation the  warranties of merchantability  and of fitness
  158.      for any purpose.  The  author does not warrant, guarantee, or make any
  159.      representations regarding the use, or  the results  of the use, of the
  160.      software  or written materials in terms of correctness, accuracy, reli-
  161.      ability, currentness or otherwise.  
  162.  
  163.      The author shall not be liable for any direct, indirect, consequential,
  164.      or incidental damages (including damages for loss of business profits,
  165.      business interruption , loss of  business information , and the  like)
  166.      which may result from the use or inability to use the software even if
  167.      the author has been advised of the possibility of such damages.  
  168.  
  169.      You may copy  this package  for backup purposes. You may also copy and
  170.      share unmodified  copies of the whole package, providing that the Copy-
  171.      right Notices are reproduced and included on all copies.
  172.  
  173.      You may not sell the product for  a fee and/or  distribute the product
  174.      along  with other  products without  written permission,  nor may  you
  175.      modify  or  remove  the  Copyright Notices  from the  programs or  the
  176.      documentation files, or  in any  way modify, adapt, translate, reverse
  177.      engineer, decompile  and/or disassemble  any of  the software  in this
  178.      package.  User clubs, if they are NOT commercial, are allowed to ask a
  179.      small amount  of money for distribution  and storage when they want to
  180.      share this package amongst their members.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.      Q-A Test  Version 1.0  Documentation                         (Page  3)
  189.  
  190.  
  191.  
  192.  
  193.      SYSTEM REQUIREMENTS
  194.  
  195.      The following equipment, software, and files are necessary to run this
  196.      program:
  197.  
  198.        An operational bulletin board system running RemoteAccess, QuickBBS,
  199.        SuperBBS, or any BBS software  that uses an  identical questionnaire
  200.        language.
  201.  
  202.        QATEST.EXE file included in the UserFlag archive.
  203.  
  204.  
  205.  
  206.      INSTALLATION
  207.  
  208.      To install Q-A Test for  use on your  RemoteAccess (RA) BBS,  copy the
  209.      file QATEST.EXE to your BBS  system directory, or to a directory where
  210.      you keep your questionnaire (*.Q-A) files.
  211.  
  212.  
  213.  
  214.      PROGRAM INFORMATION
  215.  
  216.      Simply, Q-A Test will simulate a RemoteAccess,  QuickBBS,  or SuperBBS
  217.      questionnaire file.
  218.  
  219.      The command line is:
  220.  
  221.      QATEST <Filename[.Ext]> [TextPath]
  222.  
  223.      Filename is the name of the questionnaire file to test.   An extension
  224.      of .Q-A is assumed unless specified.
  225.  
  226.      TextPath is the path to your BBS textfiles directory.   This is needed
  227.      for the DISPLAYFILE  option.   If this is  not  specified, the current
  228.      directory is assumed.
  229.  
  230.      The following commands are supported:
  231.  
  232.        ASK <Len> <Num>
  233.        CAPITALISE <ON|OFF>
  234.        CHANGECOLOR <Foreground> <Background>
  235.        CLEARSCREEN
  236.        DISPLAY "<Text>"
  237.        DISPLAYFILE <1-8 character name>
  238.        GETCHOICE <Choices> <Num>
  239.        LISTANSWER <Num>
  240.        QUIT
  241.        WAITENTER
  242.  
  243.  
  244.        IF..ENDIF statements are parsed correctly.
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.      Q-A Test  Version 1.0  Documentation                         (Page  4)
  252.  
  253.  
  254.  
  255.  
  256.      PROGRAM INFORMATION continued
  257.  
  258.      The following commands are not fully supported:
  259.  
  260.        EXEC <Command>
  261.        The EXEC will only display "Shell to: <command>"
  262.  
  263.        MENUCMND <Command> <Data>
  264.        The MENUCMND will only display "Menu Command: <command> <data>"
  265.  
  266.      The following statements are also supported:
  267.  
  268.        OUTPUTANSWER "<Description>" <Num>
  269.        POSTINFO
  270.  
  271.        SETFLAG  <Flag><Number> <ON|OFF>
  272.        SETSECURITY <Level>
  273.  
  274.      QATEST will keep a temporary answer  ("ASW")  file where it stores the
  275.      OUTPUTANSWER and POSTINFO results.  This file is called QATEST.$$$ and
  276.      is displayed  at the end  of the  questionnaire.  It is always deleted
  277.      afterwards.
  278.  
  279.      QATEST also keeps a temporary  "LOG"  file where it stores the SETFLAG
  280.      and SETSECURITY results.  This file is called QATEST.%%% and, like the
  281.      QATEST.$$$ file, is displayed at the end of the questionnaire.   It is
  282.      always deleted afterwards.   The logging  format  is identical to RA's
  283.      Frontdoor-style logging format.  However, QATEST is still fully compat-
  284.      ible with QBBS/SBBS questionnaires as well.
  285.  
  286.  
  287.  
  288.      DOCUMENTATION
  289.  
  290.      This  documentation is  copyrighted (C) 1991 by CGL-SoftWare.  The Q-A
  291.      Test Documentation  package  was  written by  Peter Kling.  To  obtain
  292.      printed copied  of this  documentation, please contact:
  293.  
  294.        CGL-SoftWare
  295.        P.O. Box 8453,
  296.        Albany, New York,  12208.
  297.        518-437-1267 BBS - 1:267/169.0 FidoNet
  298.        518-437-1268 BBS - 1:267/269.0 FidoNet
  299.  
  300.      Please include $5.00 (US) per copy for shipping and handling.
  301.  
  302.  
  303.  
  304.      PRODUCT SUPPORT ECHO
  305.  
  306.      A  special  announcment  goes out to  all of you to invite you to join
  307.      with the  RodentWare authors,  supporters, and growing number of users
  308.      in a  new support  echo  titled  'RODENT'.   The RODENT echo is to aid
  309.      support to all RodentWare users  without  adding more wear and tear on
  310.      the other echoes.   Ask your *EC about receiving this echo -- it is on
  311.      the Fidonet Zone 1 BACKBONE!
  312.  
  313.  
  314.      Q-A Test  Version 1.0  Documentation                         (Page  5)
  315.  
  316.  
  317.  
  318.  
  319.      SPECIAL NOTICE
  320.  
  321.      A special thank you goes out to all of the RodentWare supporters, beta
  322.      testers, and support echo participants.  There has never been a better
  323.      bunch of supportive people.  Anytime a suggestion was needed they were
  324.      there.   Additionally if you would like to become a member of the beta
  325.      team or support network,  please contact either Michael Reece or Peter
  326.      Kling.
  327.  
  328.  
  329.  
  330.      RODENTWARE SUPPORT SITES
  331.  
  332.      Below is a listing of RodentWare Support Sites.  These bulletin boards
  333.      should have all of the  latest  RodentWare programs available for File
  334.      REQuest and/or Download.
  335.  
  336.        RodentWare BBS                CGL-SoftWare BBS
  337.        RodentWare Headquarters       RodentWare Distribution Site
  338.        SysOp: Michael Reece          SysOp: Peter Kling
  339.        Buffalo, NY USA               Albany, NY USA
  340.        716 837-6879 (data)           518 437-1267 (data)
  341.        1:260/150 (@Fidonet) 2400     1:267/169 (@Fidonet) HST V42 bis
  342.                                      1:267/269 (@Fidonet) 2400
  343.      
  344.        The Dart Board                Happy Hour BBS
  345.        SysOp: Karen & Mark Maynor    SysOp: Tom Stoltz
  346.        Saratoga Springs, NY USA      Raymore, MO USA
  347.        518 587-4028 (data)           816 332-1133 (data)
  348.        1:267/69 (@Fidonet) HST-DS    1:103/102 (@Fidonet) HST
  349.  
  350.        End of the World              The Dog House
  351.        SysOp: Lou Ludwig             SysOp: Dave Lockard
  352.        Fortuna, CA USA               Charlotte Hall, MD USA
  353.        707 725-5785 (Data)           301 884-3686 (Data)
  354.        1:125/12 (@Fidonet) HST       1:109/605 (@Fidonet)
  355.  
  356.        The Low Country               Computer Castle
  357.        SysOp: Tom Echols             SysOp: Michael Lewis
  358.        Burton, SC USA                Gray, LA USA
  359.        803 524-5056 (Data)           504 876-3138 (Data)
  360.        1:372/15 (@Fidonet) HST       2400   
  361.  
  362.        The Fox's Den                 The Other Side of the Hill
  363.        SysOp: Jym Fox                SysOp: Robby Barra
  364.        Jackson, MS USA               Tyler, TX USA
  365.        601 353-6731 (Data)           903 597-1239 (Data)
  366.        1:361/101 (@Fidonet) 9600     1:3801/3 (@Fidonet) HST
  367.  
  368.        The Master's BBS              Odyssey BBS
  369.        SysOp: Mike Levonius          SysOp: Stan Hirschman
  370.        Garden Grove, CA USA          Edina, MN USA
  371.        714 539-2477 (Data)           612 832-5127 (Data)
  372.        1:103/101 (@Fidonet) 2400     1:282/40 (@Fidonet) HST
  373.        1:103/102 (@Fidonet) HST V42b
  374.  
  375.  
  376.  
  377.      Q-A Test  Version 1.0  Documentation                         (Page  6)
  378.  
  379.  
  380.  
  381.  
  382.      RODENTWARE SUPPORT SITES continued
  383.  
  384.        MadDog's MadHouse
  385.        SysOp: Ricahrd Williams
  386.        Frankfort, IL USA
  387.        618 937-1831 (Data)
  388.        1:2290/20 (@Fidonet) 2400
  389.  
  390.  
  391.  
  392.      COPYRIGHT NOTICES
  393.  
  394.      QA-Test  Version 1.0  Copyright (c) 1991 by RodentWare.
  395.      Written by Michael Reece, The RodentWare BBS, 716-837-6879, 1:260/150.
  396.  
  397.      RodentWare, 24 Hawthorne Ave, Buffalo NY 14223-3014, USA
  398.      Voice: 716-837-4741
  399.  
  400.      QA-Test  Documentation  Copyright (c) 1991 by CGL-Software.
  401.      Written by Peter Kling, CGL-SoftWare, 518-437-1267, 1:267/169.
  402.  
  403.      CGL-Software, P. O. Box  8453,  Albany  NY  12208  USA
  404.      Voice: 518-458-7802
  405.  
  406.  
  407.  
  408.      ACKNOWLEGEMENTS & CREDITS
  409.  
  410.      Michael Reece and RodentWare would like to thank the following:
  411.  
  412.        Borland International, Inc. for Turbo Pascal 6.0
  413.        Peter Kling & CGL-Software for documentation.
  414.        The Fidonet PASCAL echo for coding help and suggestions.
  415.  
  416.      Turbo Pascal is a trademark of Borland International, Inc.
  417.      GCL-Software & CGL are trademarks of Peter Kling & CGL-Software.
  418.      RodentWare is a trademark of Michael Reece & RodentWare.
  419.      RemoteAccess is a trademark of Andrew Milner & Continental Software.
  420.      QuickBBS is a trademark of Steve Gabrilowitz & Richard Creighton.
  421.      SuperBBS is a trademark of Aki Antman.
  422.  
  423.  
  424.  
  425.      **********************************************************************
  426.      * SysOps: We thank you for making our programs on available your BBS *
  427.      * for downloading, please do not add  files to the original archive. *
  428.      * BBS ads are welcome in the archive COMMENT only!  Do not place new *
  429.      * files, or  modify existing  files, INSIDE  the  archive.  Changing *
  430.      * archive format (ie from  ARJ to ZIP or LZH) is fine as long as you *
  431.      * are positive that  ALL of the  original files (and no EXTRA files) *
  432.      * are placed inside the new archive.                    - RodentWare *
  433.      **********************************************************************
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.      Q-A Test  Version 1.0  Documentation                         (Page  7)
  441.  
  442.