home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / QGWAR203.ZIP / QGWAR.DOC < prev    next >
Encoding:
Text File  |  1992-03-03  |  13.7 KB  |  328 lines
  1.  
  2.  
  3.                                QGwar v2.03
  4.  
  5.                     BBS Interface Package for Global Wars
  6.                   Copyright 1989-1992 by Andrew J. Fletcher
  7.  
  8.  
  9.  
  10.     WHAT IS IT:  QGWAR is designed to be a complete interface package
  11.                  between GLOBAL WAR and the BBS software you are running.
  12.                  QGWAR will simplify the loading, and running of Global
  13.                  Wars, even in a Multi-node enviroment.  As an added bonus
  14.                  QGWAR automatically creates and updates (when required)
  15.                  a Rankings, Hall of Fame, and Information ANSI and/or
  16.                  ASCII Bulletin that reflects the current status of the
  17.                  running games.
  18.  
  19.                  QGWAR has been tested on the following BBS packages:
  20.  
  21.                    - QuickBBS          - XBBS         - Telegard
  22.                    - ProBoard          - SuperBBS     - Simplex
  23.                    - RemoteAccess      - Wildcat      - Maximus
  24.                    - Gap               - PcBoard (?)
  25.  
  26.                  Additional features include:
  27.  
  28.                    - Support for GAMESTAT <c> 1991 RoyaLink Software
  29.                      written by Greg King
  30.  
  31.  
  32.     WHY USE IT:  QGWAR is an extremely fast interface program.  It was
  33.                  designed to be compact, quick, and unobtrusive  (It
  34.                  does it's job and then gets out of the way).  As a
  35.                  complete interface package for GLOBAL WAR, QGWAR also
  36.                  gives you the option of creating ANSI and ASCII bulletins
  37.                  for online viewing via your BBS software.
  38.  
  39.                  SysOps can place the GLOBAL WAR files in any sub-directory
  40.                  on drives C through Z, it uses less memory then shelling
  41.                  to a batch file via Command.com /C and its faster, and
  42.                  nothing special needs to be done to run QGWAR on a BBS
  43.                  running multiple nodes under a LAN or DESQview.
  44.  
  45.  
  46.     DISCLAIMER:  This program has been tested to work.  But, things happen
  47.                  so I cannot be held liable for any effects that this soft-
  48.                  ware  may have on your system.  The only gaurantee that
  49.                  is provided is that this software WILL occupy disk space.
  50.  
  51.                           USE THIS PROGRAM AT YOUR OWN RISK!!
  52.  
  53.  
  54.     REGISTRATION
  55.  
  56.         Registration for QGWAR is $5.00.  Those who register will receive
  57.         a "registration key" that should be placed on line 1 of the
  58.         QGWARE.CFG file.  This key will work with all future versions of
  59.         QGWAR.  See the registration form for futher informaton.
  60.         NOTE:  QGWAR is not crippled in any way.  There are no pauses or
  61.         beeps.  The only thing a non registerd sysop will see is that all
  62.         the the bulletins have the word UNREGISTERED somewhere in the file
  63.         that QGWAR creates.
  64.  
  65.  
  66.     PROGRAM SETUP:
  67.  
  68.     A.  QUICKBBS/REMOTEACCESS and simular BBS types that use optional
  69.         commandline strings
  70.  
  71.  
  72.         1)  Place the GLOBAL WAR files in the directory/drive of your
  73.             choice.
  74.  
  75.         2)  Place the QGWAR.EXE in the directory/drive of your choice. If
  76.             you are running multiple lines (i.e. RemoteAccess) there is NO
  77.             need to place a copy in each line.
  78.  
  79.         3)  Create or edit your existing TYPE 7 EXIT that loads GLOBAL WAR.
  80.             (Note:  QGWAR is NOT designed to work using a TYPE 15 EXIT!!!)
  81.             On the TYPE 7 option line add/edit the following:
  82.  
  83.  
  84.             c:\ra\qgwar.exe  [qgwar options  - see samples below]
  85.             ─────┬─────────  ──────────────────┬─────────────────
  86.                  │                             │
  87.                  │                             │
  88.             complete DOS path to the           │
  89.             where you placed QGWAR.EXE         │
  90.                                                │
  91.                                                │
  92.             QGwar.exe  [pathname] [Global War Option] [baud] [port] [time]
  93.                        [first name] [last name] [Type 7]
  94.  
  95.             WHERE:
  96.  
  97.             pathname.... Complete pathname for the location of the Global
  98.                          War files.  (Example:  C:\ra\doors\gwar\war.exe)
  99.  
  100.             Global War
  101.             Option...... Use the /C option - this is the Global War command
  102.                          line parameter option.  See the Global War docs
  103.                          for more information if needed.
  104.  
  105.             Baud........ The baud rate of the caller (*B) or the actual
  106.                          locked baud rate (19200/38400 etc).
  107.  
  108.             Port........ The com port (1=COM1)
  109.                          QuickBBS/RemoteAccess use *P if running a multi-
  110.                          node system.
  111.  
  112.             Time........ BBS time remaining
  113.                          Quickbbs/RemoteAccess use *T or use any time you
  114.                          wish.   XBBS use *T, *t or any time you wish.
  115.  
  116.             First Name.. QuickBBS/RemoteAccess systems use the *F, XBBS
  117.                          systems have many options available.  You may use
  118.                          Real or Handles.  See the XBBS docs for more
  119.                          information.
  120.  
  121.             Last Name... QuickBBS/RemoteAccess system can use the *L
  122.                          XBBS systems have many options available.  You
  123.                          may use Real or Handles.  Again see the XBBS docs
  124.                          for more information
  125.  
  126.             Type 7...... Additional Type 7 Options available (ie Memory
  127.                          swapping etc)
  128.  
  129.  
  130.           SAMPLE TYPE 7 CALLS:
  131.  
  132.           a.  General (most systems) /w Memory Swapping Enabled
  133.  
  134.               c:\ra\qgwar.exe c:\ra\doors\gwar\war.exe /C *B *P *T *F *L *M
  135.  
  136.           b.  Locked baud sample Type 7 Exit would be:
  137.  
  138.               c:\ra\QGwar.exe c:\ra\doors\gwar\war.exe /C 19200 *P *T *F *L
  139.  
  140.               (Actually if you are running Global War using the FOSSIL
  141.               calls there is no need to specify locked baud rates as the
  142.               fossil handles all the handshaking use *B instead)
  143.  
  144.           c.  Local baud sample Type 7 exit would be:
  145.  
  146.               QGwar.exe c:\qbbs\doors\gwar\war.exe /C 0 *P *T *F *L
  147.  
  148.  
  149.         GOTO STEP 4 (below)
  150.  
  151.  
  152.     B:  WILDCAT/GAP and other BBS packages that use the Wildcat
  153.         DOOR.SYS drop file.
  154.  
  155.         1)  Place the GLOBAL WAR files in the directory/drive of your
  156.             choice.
  157.  
  158.         2)  Place the QGWAR.EXE in the directory/drive of your choice. If
  159.             you are running multiple lines (i.e. Wildcat) there is NO
  160.             need to place a copy in each line.
  161.  
  162.         3)  Create the necessary DOOR##.BAT for loading the door and
  163.             use the following command line.  DO NOT change directories
  164.             before loading QGWAR.EXE as it looks for the DOOR.SYS in
  165.             the current directory.  There is no need to create unique
  166.             batch files for each node.
  167.  
  168.             The DOOR##.BAT should contain the following only:
  169.  
  170.               echo off
  171.               c:\wc3\mscl\qgwar.exe c:\wc3\doors\gwar\war.exe /c
  172.               ─────────┬─────────── ────────────┬──────────── ─┬─
  173.                        │                        │              │
  174.                        │                        │              │
  175.               complete drive/path               │   Global War option, DO
  176.               for QGWAR.EXE                     │   NOT USE "/D"
  177.                                                 │
  178.                                                 │
  179.                                      Complete drive and path for the
  180.                                      Global War WAR.EXE (Global War
  181.                                      main executable)
  182.  
  183.           SAMPLE BATCH FILE:
  184.  
  185.           echo off
  186.           c:\wc3\mscl\qgwar.exe c:\wc3\doors\gwar\war.exe /C
  187.  
  188.  
  189.           Note:  This batch file will work with all nodes, whether the
  190.                  port is locked or unlocked, and the initial starting
  191.                  directory will be restored upon program termination.
  192.  
  193.  
  194.         GOTO STEP 4 (below)
  195.  
  196.  
  197.     B:  TELEGARD Setup (This has been tested on TELEGARD 2.5q,
  198.         using X00.SYS locked open at 38400 baud.)
  199.  
  200.         1)  Make a directory DIRECTLY off your root directory
  201.             called c:\war. De_Archive your Global War game files
  202.             or Move your existing game files into this directory.
  203.             (This is done because of TELEGARD's limited command
  204.             line character input.
  205.  
  206.         2)  Place QGWAR.EXE in your main BBS Directory.
  207.  
  208.         3)  Make your menu modifications, use the format below.
  209.  
  210.             Menu filename: ONLINE
  211.             Command #6 of 17
  212.  
  213.             1. Long descript :(G)lobal War
  214.             2. Short descript:(G)lobal War
  215.             3. Cmd letters   :G
  216.             4. ACS required  :""
  217.             5. Cmdkeys       :D-
  218.             6. MString       :qgwar.exe d:\war\war.exe /c @B @P @T @F @L
  219.             Flags         :None
  220.             Q. Quit
  221.  
  222.             Edit menu (?=help) :
  223.  
  224.  
  225.  
  226.         4)  To release the power of QGWAR's advanced features create
  227.             an ASCII file called QGWAR.CFG and place it in the Global War
  228.             directory. There is a sample QGWAR.CFG provided that you can
  229.             edit to suite your individual needs.  See the sample file for
  230.             information on setting up the advanced features.  If this file
  231.             is not present QGWAR will just function as a BBS interface.
  232.  
  233.         5)  Edit your BBS Menus for viewing the ANSI/ASCII files created
  234.             by QGWAR that you specified in the QGWAR.CFG file.
  235.  
  236.         6)  Modify your War.cfg,  Winners.war files, and Winners.top by
  237.             "fake" editing them.  (This will efectively change the file
  238.             last modified date).  By doing this you will trick QGWAR into
  239.             updating or creating the Bulletins requested by QGWAR (QGWAR
  240.             when ran only updates files that have been modified in the
  241.             last 45 minutes)
  242.  
  243.         7)  Now run QGWAR once via the bbs to make sure everything is setup
  244.             and running correctly.
  245.  
  246.  
  247.  
  248.     NOTES:
  249.  
  250.     1.  If you accidently delete any of the ANSI/ASCII files created by
  251.         QGWAR they will not be re-created until the coresponding data
  252.         file has been updated.  The following is a list of the output
  253.         files and the data file they are related with....
  254.  
  255.             Information Bulletin   -   WAR.CFG
  256.             Rankings Bulletin      -   WINNERS.WAR
  257.             Hall of Fame Bulletin  -   WINNERS.TOP
  258.  
  259.  
  260.         To force update these files, just "fake" edit the file and then
  261.         run QGWAR from the BBS and the display files will automatically
  262.         be recreated.  Programming note, QGWAR only updates files that
  263.         have been modified within the last 45 minutes.
  264.  
  265.     2.  Remember - if you modify WAR.CFG you must run QGWAR within 45
  266.         minutes or QGWAR will not update the Information Bulletin.
  267.  
  268.  
  269.     GAMESTAT <c> 1991 RoyaLink Software by Greg King
  270.  
  271.        WHAT DOES IT DO?
  272.        Gamestat reads in the doors that are played and adds them to a
  273.        random file.  Upon execution, it first adds one day to the existing
  274.        records.  It then updates the doors that have been played, adding
  275.        any new ones.  It then divides the number of times played by the
  276.        days the door has been availible.  Then it sorts the records by
  277.        the average plays per day, creates a graphical representation of
  278.        usage and outputs the top 15 to the file you specified in the
  279.        config file.
  280.  
  281.        This program is available at:
  282.            -  the author's BBS at (805) 488-7430 (2400-9600 HST)
  283.               FidoNet 1:206/2503   (call for latest version)
  284.  
  285.            -  The Diplomat BBS at (619) 560-7765 (1200-9600 HST)
  286.               FidoNet 1:202/211     Filename:  GAMESTAT11.ZIP
  287.  
  288.  
  289.     FILES INCLUDED:
  290.  
  291.       QGWAR.CFG       - Sample QGWAR Configuration file
  292.       QGWAR.DOC       - QGWAR Documentation (This file)
  293.       QGWAR.EXE       - QGWAR Executable file (80286/80386)
  294.       QGWAR!.EXE      - QGWAR Executable file (Generic)
  295.       REGISTER.DOC    - Registration information
  296.       SAMPLES.ZIP     - Samples of the ANSI/ASCII bulletins
  297.                         created by QGWAR.
  298.       WHATS.NEW       - What's new file
  299.  
  300.  
  301. SUPPORT
  302.  
  303.        Should you experience any bugs or errors while running this
  304.        program, you can reach me via netmail at 1:202/211 or call
  305.        The Diplomat BBS at (619) 560-7765 (1200-9600 HST).  I am also
  306.        a regular reader of the DOORWARE echo.  If you leave me a
  307.        message try and be as discriptive as possible.
  308.  
  309.  
  310.    ----------------------------------------
  311.    - Thanks to the following Beta Testers -
  312.    ----------------------------------------
  313.  
  314.         Name                  BBS                    Location         Number
  315.    ~~~~~~~~~~~~~~~  ~~~~~~~~~~~~~~~~~~~~~~~~~~  ~~~~~~~~~~~~~~~~  ~~~~~~~~~~~~~
  316.    Doug Atherton     Lost Byte                   Santee CA         619-258-6325
  317.    Al Bruner         The SW/SE Connection BBS    San Diego CA      619-467-0335
  318.    Jim Bunch         The Santee Experiment       Santee CA         619-562-8758
  319.    Earl F. Carey     Interface                   San Diego CA      619-297-7733
  320.    Kevin Doyle       The Admiral Benbow Inn      San Diego CA      619-271-9749
  321.    Jim Finch         The Lost City               San Diego CA      619-584-8038
  322.    Dave Foy          Foy's Trading Post          Santee CA         619-562-3646
  323.    William Hampton   The Felicia BBS             Newport News VA   804-591-0736
  324.    Danny Klopfer     Dan's BBS                   San Diego, CA     619-279-4774
  325.    Tim Thompson      The Underground BBS         San Diego, CA     619-460-0863
  326.  
  327.  
  328.