home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / pquic200.zip / PQUIC.DOC < prev    next >
Text File  |  1994-05-22  |  17KB  |  383 lines
  1.  
  2.      The following documentation is Copyright Cory Wright 1991, 1994.
  3.    ---------------------------------------------------------------------
  4.  
  5.    ██████   █████  ██   ██ ███████ ██████      █████  ██   ██ ██  █████
  6.     ██  ██ ██   ██ ██   ██  ██   █  ██  ██    ██   ██ ██   ██ ██ ██   ██
  7.     █████  ██   ██ ██ ▄ ██  ████    █████     ██   ██ ██   ██ ██ ██
  8.     ██     ██   ██ ███ ███  ██   █  ██  ██    ██   ██ ██   ██ ██ ██   ██
  9.    ████     █████  ██   ██ ███████ ███  ██     █████   █████  ██  █████
  10.                                                    ██
  11.    ---------------------------------------------------------------------
  12.     Questionnaire & User Information Control (QUIC) for GT v15.00-18.00
  13.  PowerQUIC is Copyright Cory Wright 1991, 1992, 1994.  All rights reserved.
  14.  
  15.  
  16.  
  17.  
  18.                               Cory Wright
  19.                             TRC Development
  20.                             P. O. Box 53041
  21.                        Knoxville, TN  37950-3041
  22.                                   USA
  23.  
  24.                        The Rising Connection BBS
  25.                      919/783-8946  HAYES OPTIMA 288
  26.  
  27.                          The InfoStation BBS
  28.                      606/269-7128  HAYES OPTIMA 288
  29.  
  30.         TRC Development directly supports this product 24 hours
  31.       daily via The Rising Connection BBS or The InfoStation BBS.
  32.  
  33.  
  34.  
  35.     Purpose
  36.     -------
  37.     PowerQUIC is  designed to replace the  questionnaire functions provided
  38.     by the GT  Power BBS system. It can  be run as a door  or, depending on
  39.     the version of GT you own, as  an extension from the main menu. The key
  40.     benefit of using  PowerQUIC is that users can be  upgrade online, via a
  41.     questionnaire, without having  to call back in order  to take advantage
  42.     of their  new access level.  PowerQUIC keeps questionnaire  data in the
  43.     same format  as GT Power, so  your answer files look  exactly the same.
  44.     All options  are configurable. You  do not even  have to adjust  access
  45.     levels unless you  want to. PowerQUIC offers a  powerful alternative to
  46.     GT's built-in questionnaire system.
  47.  
  48.  
  49.     Compatibility
  50.     -------------
  51.     PowerQUIC has  been tested with GT  versions 15.00 through 17.00  of GT
  52.     Power  by P&M  Software. PowerQUIC  operates successfully  and is fully
  53.     compatible with  those versions. TRC  Development and Cory  Wright will
  54.     only provide support to those running  the versions of the GT code with
  55.     which PowerQUIC has been tested.
  56.  
  57.                                                                      Page 2
  58.  
  59.     Setup
  60.     -----
  61.     Setting up  PowerQUIC can be  simple. If you  learn better by  example,
  62.     skim over  these instructions, then  go look at  the sample CommandFile
  63.     included in this archive.
  64.  
  65.       THINGS TO REMEMBER
  66.       ------------------
  67.       1.  THIS PROGRAM MUST BE OVERLAYED.
  68.       2.  THIS  PROGRAM  MUST  HAVE  ITS  OUTPUT  REDIRECTED.  (I recommend
  69.           GATEWAY with DVDOOR to watch carrier.)
  70.  
  71.     Since PowerQUIC can run in several  different places, it is not easy to
  72.     tell you how to overlay this program.  Here are a few guidelines -- but
  73.     look at the GT documentation to make  doubly sure you are telling GT to
  74.     overlay in the right place. Use /V:L  on the GT command line if you are
  75.     using PowerQUIC in the logon or logoff batch files. Use /V:D if you are
  76.     using PowerQUIC in a  door. If you are not sure, use  /V:DL to get both
  77.     bases covered. If you do not like the idea of overlaying doors, you can
  78.     go ahead and place the /V:D (or  /V:DL, etc...) on the GT command line,
  79.     and  "ampersand out"  (&) the  doors you  do not  want overlayed in the
  80.     GTDDIR.BBS  file. Please  refer to  the GT  host documentation for more
  81.     specific information on how to go about selectively overlaying doors.
  82.  
  83.     Redirection can be  tricky. I recommend picking up a  copy of DVDOOR by
  84.     Ken Thompson. DVDOOR  is available on The Rising  Connection BBS (phone
  85.     number on page 1). I'm sure you understand that DVDOOR is a copyrighted
  86.     program,  and we  are unable  to package  it with  this program at this
  87.     time. Sorry if you have to  make another phone call... You'll also need
  88.     GATEWAY (v2.00 by Hans Kellner, circa  1987 -- but it still works great
  89.     unless you use Desqview) to send things out to the modem. Both of these
  90.     files are available  on The Rising Connection BBS.  DOORWAY by Marshall
  91.     Dudley is another  option (necessary if you use  Desqview); however, if
  92.     you  are just  starting out  or if  you do  not have  any other use for
  93.     Doorway, it is overkill for the job. Keep it simple. GATEWAY and DVDOOR
  94.     will do the job just fine.
  95.  
  96.     You will need to set up GATEWAY in your CONFIG.SYS file.
  97.  
  98.       device = gateway2.sys -d -1
  99.  
  100.     COM1: is -1, COM2: is -2 -- you get the drift.
  101.  
  102.     Setup DVDoor in accordance with its documentation.
  103.  
  104.                                                                      Page 3
  105.  
  106.     Batch file
  107.     ----------
  108.     This  is a  simplified batch  file to  use GATEWAY.  Make sure  you are
  109.     running DVDOOR in  accordance with its instructions so  that if someone
  110.     drops carrier  while using PowerQUIC,  your board is  not sitting there
  111.     like a dead duck.
  112.  
  113.     %1 gate%2
  114.     pquic <CommandFile> [DEFAULT]
  115.     %1 con
  116.  
  117.     That's it!  Quick, easy and simple!
  118.  
  119.  
  120.     Operation
  121.     ---------
  122.     PowerQUIC is  run from the  DOS command line  -- most often  in a batch
  123.     file.  Command line formats include:
  124.  
  125.       * PQUIC /?       - gives synopsis of program and command line format.
  126.  
  127.       * PQUIC REGISTER - go into registration mode to enter your CRC you
  128.                          received when you registered the program.
  129.  
  130.       * PQUIC <CommandFile> [DEFAULT]  - normal operation.
  131.  
  132.     PowerQUIC needs you to write what  is called a CommandFile in order for
  133.     it to  operate. See the format  of the CommandFile below.  You may also
  134.     specify the  word DEFAULT as the  2nd parameter if you  do not like the
  135.     colors PowerQUIC gleaned from your GT configuration.
  136.  
  137.  
  138.     CommandFiles
  139.     ------------
  140.     A CommandFile is one file that you use to offer one or more related (or
  141.     unrelated) questionnaires to  your users. It is up to  you to decide if
  142.     you wish to use more than one file.
  143.  
  144.     Each  CommandFile can  contain up  to 20  separate questionnaires.  The
  145.     CommandFile must be  in a specific format (given  below). You may place
  146.     questionnaires  end to  end, but  this  is  the format  for 1  complete
  147.     questionnaire. See the example file in this archive for details.
  148.  
  149.     Line 1:  # Questionnaire Title
  150.     Line 2:  D:\GT\ANSWER1.BBS
  151.     Line 3:  ZY XT GB A9
  152.     Lines 4-??: Text of questionnaire.
  153.  
  154.     The text of the questionnaire can be as lengthy as you wish. What is in
  155.     column 1 of each line dictates how PowerQUIC processes the line.
  156.  
  157.                                                                      Page 4
  158.  
  159.     If  a semicolon  is in  column 1,   the line  is a  comment and  is not
  160.     displayed to the user.
  161.  
  162.     If nothing  is in column  1, the  line  is displayed to  the user (this
  163.     could be instructions, questions, or blank lines).
  164.  
  165.     If a  question mark '?'  is in column  1, the line  takes on a  special
  166.     format. It must look like the following:
  167.  
  168.     ?(-----)
  169.  
  170.     You may  have up to 75  dashes. The number of  dashes dictates how long
  171.     the user's answer  is allowed to be. The above  example would allow a 5
  172.     letter answer from the user.
  173.  
  174.     If  column 1  has an  asterisk '*'   in it,  the user  must answer  the
  175.     question. Think of it as a forced answer!
  176.  
  177.     *(----------)
  178.  
  179.     This would  make the user  give an  answer  and give them  10 spaces to
  180.     answer in.
  181.  
  182.     You can also try things like the  following in order to give the user a
  183.     template for a phone number:
  184.  
  185.     What is your phone number?
  186.     *(###-###-####)
  187.  
  188.  
  189.     When does it end?
  190.     -----------------
  191.     If you just  have one questionnaire to set up  in this particular file,
  192.     then  you  are  now  done!  Otherwise,  you  can  put  a  total  of  20
  193.     questionnaires in one  CommandFile. You may want to  remind the user to
  194.     save  the answers  and 'sum  up' the  questionnaire at  the end  of the
  195.     questionnaire text  (PowerQUIC automatically prompts  the user to  save
  196.     his  answers). If  you want  to add  more questionnaires,  just place a
  197.     pound sign (#) and a title, and continue onward. Again, see the example
  198.     file included in this archive for more information.
  199.  
  200.     Forcing a Questionnaire
  201.     -----------------------
  202.     If you  want to force a  questionnaire, then place the  word 'force' in
  203.     the questionnaire title (after the pound  '#' sign). The user will then
  204.     be informed that  the questionnaire is mandatory and  will be forced to
  205.     answer it. Remember, it would be silly to put more than 1 questionnaire
  206.     in a CommandFile  that has a forced questionnaire. Even  if you have 18
  207.     other questionnaires in  the same CommandFile, they will  never be seen
  208.     by the user since PowerQUIC jumps right to the FORCED one!!!
  209.  
  210.                                                                      Page 5
  211.  
  212.     Entering your Registration Code
  213.     -------------------------------
  214.     Type "PQUIC REGISTER"  on the command line. A  registration screen will
  215.     be presented  where you will  enter the registration  name and CRC  you
  216.     received from TRC Development. Press 'Q'  to quit and save the changes.
  217.     Upon exit, if you have properly entered the information, PowerQUIC will
  218.     tell  you that  your program   is registered;  otherwise, you  will see
  219.     instructions on how to register your unregistered copy.
  220.  
  221.  
  222.     Limitations
  223.     -----------
  224.     Until  PowerQUIC is  registered, only  one limitation  is imposed. Your
  225.     callers  will only  have 5  minutes left  for their  current call  upon
  226.     returning  to the  BBS. This  function is  not intended  to cripple the
  227.     program,  but to  allow you  to evaluate  the software. Registration of
  228.     PowerQUIC is  easy and is outlined  at the end of  this document and in
  229.     the REGISTER.PQ file.
  230.  
  231.  
  232.     Standard Demo License
  233.     ---------------------
  234.     PowerQUIC is a Shareware program, and  uploading of the code to various
  235.     bulletin  boards and  Shareware libraries  is encouraged;  however, the
  236.     following limitations must be expressed:
  237.  
  238.     1) Under no circumstances should the code be modified or distributed in
  239.     any other form than what it  was originally supplied by the author. The
  240.     exception is  that PowerQUIC may  be compressed using  techniques other
  241.     than ZIP, but the de-compressed form of PowerQUIC must remain intact.
  242.  
  243.     2)  PowerQUIC  may  not  be  redistributed  in  any  manner  other than
  244.     electronic file transfer unless cleared  with the author beforehand. No
  245.     money   may   be   received   for   PowerQUIC  except   to   cover  for
  246.     telecommunications / service  charges, and in such a  case the cost may
  247.     not exceed $5.00 US.
  248.  
  249.     PowerQUIC may  be run for a  period of time adequate  to allow for full
  250.     testing of the software. If, after  running the code for one month, you
  251.     decide not  to purchase the  registration license and  number, you must
  252.     forfeit  this  license  and  remove  PowerQUIC  from  operation on your
  253.     system(s). You may  keep a copy online for  distribution purposes only.
  254.     PowerQUIC may  not be hacked or  modified in ANY manner,  including but
  255.     not limited  to modifications leading  to the use  of features intended
  256.     for  registered   users  only.  These  features   are  marked  in  this
  257.     documentation  under "Limitations."  Also, the  registration license is
  258.     non-transferable and under no  circumstance may the registration number
  259.     of another individual be used to enable these features or for any other
  260.     purpose.
  261.  
  262.                                                                      Page 6
  263.  
  264.     Registration License
  265.     --------------------
  266.     1) Once purchasing the registration license, limitations are lifted and
  267.     the license is extended for life. Future releases of PowerQUIC  will be
  268.     be made available for  the same version  of GT at no additional charge.
  269.     In the event an upgrade of GT necessitates a significant change in the
  270.     code, a nominal upgrade fee may apply.
  271.  
  272.     2) Registering  PowerQUIC entitles the registering  party access to The
  273.     Rising Connection BBS or whatever  location support is maintained. This
  274.     privilege is guaranteed  for as long as the  program is being developed
  275.     and supported. Access may be terminated  if any rules or regulations of
  276.     the bulletin board are broken by the registering party.
  277.  
  278.     3)  The registration  license is  non-refundable and  non- transferable
  279.     without  prior consent  of the  author, Cory  Wright. The  name of  the
  280.     bulletin board  may be changed if  evidence is given that  the board is
  281.     truly changing names and in such a case the old registration number may
  282.     not  be used  under any  circumstances. A  processing fee  may apply to
  283.     change a BBS Name.
  284.  
  285.     4) A  copy of the legal  software license is enclosed  in this archive.
  286.     You  will also  receive your  own hard-printed  copy when  you register
  287.     PowerQUIC. You  may also write  to the address  on page one  for a copy
  288.     before you purchase the software.
  289.  
  290.     Disclaimer
  291.     ----------
  292.     The author, Cory Wright, takes  no responsibility nor liability for any
  293.     data loss, incurred  costs, or equipment damage resulting  from the use
  294.     of PowerQUIC.
  295.  
  296.   ------------------------------------------------------------------------
  297.     PowerQUIC and all forms of PQUIC.EXE from source to executable are
  298.     property of Cory Wright.  GT Power is copyrighted by P & M Software.
  299.   ------------------------------------------------------------------------
  300.  
  301.  
  302.     Thanks where thanks is due
  303.     --------------------------
  304.     I must thank Douglas  Pippel for his support and  assistance during the
  305.     birth, development, and testing of this PowerQUIC project. Douglas runs
  306.     The Event Horizon  (813-726-6710) in Clearwater, FL and  carries a wide
  307.     variety of utilities for GT.
  308.  
  309.                                                                      Page 7
  310.  
  311.     Registration
  312.     ------------
  313.     Registration of PowerQUIC is easy!
  314.  
  315.     Fill  in the  registration form  on the  next page  and send  it to the
  316.     address shown. You may send a check  or money order. Please do not send
  317.     cash.
  318.  
  319.     For the fastest response time, use your VISA or MASTERCARD and call
  320.     The InfoStation BBS or The Rising Connection (BBS telephone numbers
  321.     are listed on the first page) for instant, online registration.  You
  322.     could be using PowerQUIC in the next 15 minutes!
  323.  
  324.  
  325. =============================================================================
  326. TRC Development  -  Registration Form  -  TRC Development - Registration Form
  327. =============================================================================
  328.  
  329. Name: _____________________________________________________________________
  330.  
  331. Address: __________________________________________________________________
  332.  
  333.          __________________________________________________________________
  334.  
  335.          __________________________________________________________________
  336.  
  337.  
  338. Voice Number: ____________________        Data/BBS Number: ________________
  339.  
  340. Type your BBS name below EXACTLY as you wish it registered:
  341.  
  342. => ________________________________________________________________________
  343.  
  344.  
  345. Qty  Program Description                                 US$
  346. ---  -------------------------------                 ------------
  347.  
  348. ___  PowerQUIC             (no disk)                     $20 each
  349.      [Single User License]
  350.  
  351. ___  All TRC Programs for GT on 360k
  352.      5.25" disk                                      add $2  each
  353.  
  354. ___  All TRC Programs for GT on 720k
  355.      3.5" disk                                       add $4  each
  356.  
  357.                                    Subtotal    __________________
  358.  
  359. Shipping/Handling (per order) USA:  $3.00
  360. (not based on quantity)   Foreign:  $5.00          ______________
  361.  
  362.      Tennessee residents, add 8.25% sales tax      ______________
  363.  
  364.                                       Total    __________________
  365.  
  366. -------------------------------------------------------------------------
  367. CHECK, MONEY ORDER, POSTAL MONEY ORDERS, VISA, MC ACCEPTED FOR ALL ORDERS
  368. CALL EITHER BBS ON THE FRONT PAGE AND ORDER ONLINE FOR VISA/MC ORDERS.
  369. -------------------------------------------------------------------------
  370. Make all checks and money orders payable to Cory Wright and send to:
  371.  
  372. Cory Wright
  373. P. O. Box 53041
  374. Knoxville, TN  37950-3041
  375.  
  376. Quantity discount and site license information is available upon request.
  377. =============================================================================
  378. TRC use only:  RECV ___/___/____   USMAIL ___/___/____  SN ________
  379. ===========================================================================
  380.  
  381. ** END OF POWERQUIC DOCUMENTATION ** Copyright Cory Wright 1991
  382.  
  383.