home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / GAPDEMO3.ZIP / GAPMAN6.TXT < prev    next >
Text File  |  1995-01-03  |  527KB  |  12,322 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.            ***************************************************************
  29.            *                                                             *
  30.            *                             GAP                             *
  31.            *                        Communications                       *
  32.            *                                                             *
  33.            *                                                             *
  34.            *                                                             *
  35.            *                                                             *
  36.            *                                                             *
  37.            *                      Guide To Operations                    *
  38.            *                                                             *
  39.            *                         Third Edition                       *
  40.            *                                                             *
  41.            ***************************************************************
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.           This manual  is (C)  Copyrighted  1987-1992  by  GAP  Development
  51.           Company.
  52.  
  53.           ALL RIGHTS  RESERVED. No part of this manual shall be reproduced,
  54.           stored in  a retrieval  system,  or  transmitted  by  any  means,
  55.           electronic, mechanical,  photocopying, recording,  or  otherwise,
  56.           without written  permission from  GAP Development Company.  While
  57.           every precaution  has been  taken  in  the  preparation  of  this
  58.           manual, GAP  Development Company  assumes no  responsibility  for
  59.           errors or omissions. Neither is any liability assumed for damages
  60.           resulting from the use of the information contained herein.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.           The GAP Communications logos (including the following slogan) are
  69.           trademarks of GAP Development Company:
  70.  
  71.                       The Future in Electronic Information Systems
  72.  
  73.  
  74.  
  75.           GAP Communications,  including but  not limited  to:  GAPBBS.EXE,
  76.           GAPSETUP.EXE,     GAPUSER.EXE,      GAPMENU.EXE,     GAPPACK.EXE,
  77.           GAPRELBD.EXE,     GAPCALL.EXE,      GAPDOOR.EXE,     GAPCOMM.EXE,
  78.           GAPREPRT.EXE, GAPFILE.EXE, GAPMAINT and any other program that is
  79.           distributed   under    the   GAP   Communications   logo   is/are
  80.           trademarked/copyrighted by GAP Development Company.
  81.  
  82.           IBM and TopView are trademarks of International Business Machines
  83.           Corporation.
  84.  
  85.           DesqView is a trademark of Quarterdeck.
  86.  
  87.           Courier HST is a trademark of USRobotics, Inc.
  88.  
  89.           Hayes  and  Smartmodem  are  trademarks  of  Hayes  Microcomputer
  90.           Products, Inc.
  91.  
  92.           LANtastic is a trademark of Artisoft, Inc.
  93.  
  94.           Novell and NetWare are trademarks of Novell, Inc.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.                                                                    Contents
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.           Introduction                                                    1
  114.  
  115.                Minimum Requirements                                       3
  116.  
  117.  
  118.           Setup                                                           5
  119.  
  120.                Directory Structure                                        5
  121.                File Locations                                             7
  122.                Forum File Locations                                       9
  123.                Installation                                               9
  124.  
  125.  
  126.           Configuration                                                  11
  127.  
  128.                Sysop Security Levels                                     13
  129.                File Names                                                15
  130.                Drive/Path Specifications                                 17
  131.                Modem Configuration                                       18
  132.                BPS Rate Restriction                                      21
  133.                Main Menu Commands                                        22
  134.                File Menu Commands                                        24
  135.                View/Change Stats Commands                                25
  136.                Miscellaneous Information - One                           26
  137.                Miscellaneous Information - Two                           29
  138.                Miscellaneous Information - Three                         32
  139.                Subscription Configuration                                35
  140.                File System Options                                       37
  141.                Events.i.Events                                           40
  142.                Strings and Prompts                                       40
  143.                Function Key Macros                                       42
  144.                Forum Configuration.i.Forum                               43
  145.                Files Menu Options                                        48
  146.                Sysop Configuration                                       49
  147.  
  148.  
  149.  
  150.  
  151.  
  152.                                       Page iii
  153.  
  154.  
  155.  
  156.           GAP Communications                                       Contents
  157.  
  158.  
  159.  
  160.  
  161.           System Files                                                   51
  162.  
  163.                Default Directory                                         51
  164.                Help Directory                                            57
  165.                Main Directory                                            57
  166.                   SECLEV Editor                                          60
  167.                Gen Directory                                             62
  168.                Forum Files                                               67
  169.                   Default Directory                                      67
  170.                   Gen Directory                                          68
  171.                   Upload Directory                                       68
  172.                Special Batch Files                                       68
  173.                   ARCTRANS.BAT                                           69
  174.                   UPCHECK.BAT                                            69
  175.                   LOGON.BAT                                              73
  176.                QWK/REP Sub-System                                        74
  177.                   Description                                            74
  178.                   Setting Up                                             74
  179.  
  180.  
  181.           Modem Configuration                                            79
  182.  
  183.                General Information                                       79
  184.                Sample Configurations                                     81
  185.  
  186.  
  187.           Doors                                                          87
  188.  
  189.                Doors Data File Editor                                    88
  190.  
  191.  
  192.           Questionnaires                                                 93
  193.  
  194.                Description                                               93
  195.                Setup                                                     94
  196.                Overview                                                  94
  197.                Processor Commands                                       103
  198.                Examples                                                 103
  199.                Miscellaneous Information                                106
  200.  
  201.  
  202.           Events                                                        107
  203.  
  204.                Description                                              107
  205.                Setup                                                    107
  206.  
  207.  
  208.  
  209.  
  210.                                        Page iv
  211.  
  212.  
  213.  
  214.           GAP Communications                                       Contents
  215.  
  216.  
  217.  
  218.  
  219.                Running the Events                                       110
  220.                Batch Files                                              111
  221.                Examples                                                 111
  222.  
  223.  
  224.           Text Files                                                    113
  225.  
  226.                General Information                                      113
  227.                Security Files                                           114
  228.                Security Menus                                           115
  229.                Security News                                            115
  230.                UserInfo Files                                           116
  231.                AnsiCmds                                                 117
  232.                   Special AnsiCmds                                      119
  233.                XCodes                                                   119
  234.                   Creating XCodes                                       120
  235.  
  236.  
  237.           Caller Log                                                    123
  238.  
  239.                Errors                                                   125
  240.  
  241.  
  242.           Call Waiting                                                  127
  243.  
  244.                Sysop Defined Screens                                    135
  245.                Sysop Mail                                               138
  246.  
  247.  
  248.           User Editor                                                   139
  249.  
  250.                Command Keys                                             144
  251.                Special Fields                                           145
  252.  
  253.  
  254.           System Operation                                              147
  255.  
  256.                Main Menu Commands                                       147
  257.                   Enter Mail Sub-Commands                               150
  258.                   Read Mail Sub-Commands                                150
  259.                   View/Change Stats Sub-Commands                        152
  260.                File System Commands                                     153
  261.                   File Commands                                         154
  262.                   Archive Commands                                      155
  263.                   Miscellaneous Commands                                156
  264.  
  265.  
  266.  
  267.  
  268.                                        Page v
  269.  
  270.  
  271.  
  272.           GAP Communications                                       Contents
  273.  
  274.  
  275.  
  276.  
  277.                Sysop Commands                                           156
  278.                   Function Keys                                         156
  279.                   Sysop Functions                                       158
  280.  
  281.  
  282.           FileBase Editor                                               161
  283.  
  284.                Description                                              161
  285.                Setup                                                    161
  286.                Running Gapfile                                          166
  287.                Utilities                                                172
  288.                Selection List                                           177
  289.                Saving                                                   177
  290.                CD-ROM Usage                                             178
  291.                Command Line Interface                                   186
  292.                Indirection Files                                        188
  293.  
  294.  
  295.           External Protocols                                            189
  296.  
  297.                General Information                                      189
  298.  
  299.  
  300.           Questions & Answers                                           195
  301.  
  302.  
  303.  
  304.           Index                                                         205
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                        Page vi
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.           Chapter 1
  337.  
  338.  
  339.  
  340.                                                                Introduction
  341.  
  342.  
  343.  
  344.  
  345.  
  346.           Welcome to GAP Communications!
  347.  
  348.           Because of the overwhelming response from System Operators around
  349.           the world,  GAP has become the standard in on-line communications
  350.           software.
  351.  
  352.           Remote communications,  or Bulletin  Board  Systems  (BBS),  have
  353.           become the  wave of the future. Bulletin boards are no longer the
  354.           private domain  of the  hobbyist. Companies  throughout the world
  355.           are using  GAP Communications  to  provide  on-line  information,
  356.           technical support,  as well  as local  and remote E-Mail services
  357.           for their staff.
  358.  
  359.           Whether you  are a  private user  who needs  fully powered remote
  360.           access to your home computer system, a person who simply wants to
  361.           open his  computer up to anyone who wishes to call in and utilize
  362.           the  benefits   you  provide,   a  small  business,  or  a  large
  363.           corporation, GAP Communications is your software of choice.
  364.  
  365.           With GAP  Communications,  you  are  always  open  for  business.
  366.           Customers and  your staff can access your office or home computer
  367.           24 hours  a day  to   transfer data  or  leave  important  memos,
  368.           reports or sales orders. On a local area network, GAP provides E-
  369.           Mail capabilities far surpassing those of dedicated mail systems.
  370.  
  371.           This manual  was written  to assist  you, the  new GAP  Sysop, to
  372.           install, run,  and maintain  the GAP Communications software. Our
  373.           goal is  to get  you up and running in the shortest possible time
  374.           and to answer any questions which you may have.
  375.  
  376.           Before beginning  the  installation  process,  please  read  this
  377.           manual carefully.  Installing a BBS system can be complicated due
  378.           to the many individual files involved.
  379.  
  380.  
  381.  
  382.  
  383.  
  384.                                        Page 1
  385.  
  386.  
  387.  
  388.           GAP Communications                                   Introduction
  389.  
  390.  
  391.  
  392.  
  393.           The Installation  program contained  on the  Master  Distribution
  394.           diskette number  1 together  with the  Setup program  (which will
  395.           automatically be  invoked after the install process) will provide
  396.           you with a basic BBS system in minimal time.
  397.  
  398.           GAP is  basically made  up of  3 types  of files  - "executable",
  399.           "system" and "text". The executable files are those programs that
  400.           are required  to make  your BBS  system operate. The system files
  401.           are those  files that are either created by GAP as needed, or are
  402.           initially created  by you if you wish to use a feature associated
  403.           with the  file. System  files are  generally placed  in your MAIN
  404.           directory, however  some of  them are unique to each node and are
  405.           therefore placed  in your  DEFAULT directory.  Files in  the MAIN
  406.           directory are  shareable between  nodes.  Files  in  the  DEFAULT
  407.           directory are  specific to  each node  and are  not shared.  Text
  408.           files are  those files  that are  displayed to  your users. These
  409.           include Menu,  Help, Bulletin,  News, and  Welcome  files.  These
  410.           files are  created by  you using a Text Editor and an ANSI Editor
  411.           (if you  wish to  provide color  versions of  these files).  Text
  412.           files are  also shareable between nodes. However, because sending
  413.           files through a network can be time consuming, instead of placing
  414.           these files  in the  shareable MAIN directory, they are placed in
  415.           the static  GEN directory  which can be either a directory shared
  416.           by all  nodes or  a directory  that is  on the local hard disk of
  417.           each node.  Since the  Text files  are static  in  nature  (their
  418.           contents do not change or change only on a pre-determined basis),
  419.           these files may be placed on a RAM disk to speed up access time.
  420.  
  421.           GAP comes  with default  system and  text  files  which  will  be
  422.           installed for  you automatically.  You are  encouraged to look at
  423.           and modify  these files to suit your own tastes. You may not like
  424.           the way we have laid out the Menus or you may not like the colors
  425.           we have  chosen. Please  feel free to change any and all of these
  426.           files to  reflect the  type of  user interface  you would like to
  427.           convey to your callers.
  428.  
  429.           The basic  user interface  that your  callers will  see when they
  430.           dial in  comes from your Main and File Menus. You are responsible
  431.           for providing  the menus  since GAP  will only provide a "command
  432.           prompt" when it is waiting for user input. Because you design the
  433.           menus yourself,  your BBS  will look and feel the way you want it
  434.           to.
  435.  
  436.           Each of  the chapters  in this  manual will lead you step by step
  437.           into the  configuration and  design  of  your  own  personal  BBS
  438.  
  439.  
  440.  
  441.  
  442.                                        Page 2
  443.  
  444.  
  445.  
  446.           GAP Communications                                   Introduction
  447.  
  448.  
  449.  
  450.  
  451.           system. The  largest and most important chapter is Configuration.
  452.           Most of  the configuration for GAP is performed through GAPSETUP.
  453.           This  program   provides  extensive   on-line  help,   so  if   a
  454.           configuration  option   is  confusing   or   you   need   further
  455.           explanation,  it  is  available  by  pressing  the  F1-Help  key.
  456.           Although our  installation program  will have  you up and running
  457.           with a  fully configured  BBS in  under 10  minutes, in  order to
  458.           provide the  user interface  you wish  to convey to your callers,
  459.           you will need to go through the configuration one step at a time.
  460.           It is  perfectly normal  to make  mistakes or to change your mind
  461.           about something.  If you  make a  mistake about  a  configuration
  462.           option and  things just  don't seem  to work  quite right,  don't
  463.           worry about it. We've all been there. Just try again.
  464.  
  465.  
  466.           Minimum Requirements
  467.  
  468.           +    IBM AT  or 100%  compatible (386  required to run Multi User
  469.                under a Multi Tasking system such as DesqView).
  470.           +    640K memory (2 megabytes or more if Multi Tasking).
  471.           +    1 360K floppy drive.
  472.           +    1 Hard Disk (40 MB minimum).
  473.           +    CGA, EGA, or VGA monitor.
  474.           +    Hayes AT Command set compatible modem.
  475.           +    DOS 3.3 or greater.
  476.           +    ANSI.SYS which is loaded upon boot up.
  477.           +    SHARE.EXE (if  running under  a network  or  other  type  of
  478.                multiuser system).
  479.  
  480.           Multi Tasking  programs are not recommended, although they may be
  481.           used since GAP is fully DESQview aware.
  482.  
  483.           The Multi  User versions  of GAP  are not  Multi Tasking, meaning
  484.           they require  either a  Network or some sort of Multi Tasker such
  485.           as DesqView.
  486.  
  487.           GAP was  designed to be run on a dedicated computer. As such, the
  488.           sysop should  keep his TSR programs down to a minimum (or not use
  489.           them at  all). A  good disk cache program is an exception to this
  490.           rule.
  491.  
  492.           A working  knowledge of  DOS is  mandatory. The ability to create
  493.           and/or understand  batch files  is needed.  If you  are using the
  494.           multi-user version,  you must  already know  how to  set up  your
  495.           network  before  attempting  to  install  GAP.  We  will  provide
  496.  
  497.  
  498.  
  499.  
  500.                                        Page 3
  501.  
  502.  
  503.  
  504.           GAP Communications                                   Introduction
  505.  
  506.  
  507.  
  508.  
  509.           information on  how to  configure GAP  for LANtastic  and NetWare
  510.           Lite,  however   it  is   impossible  for  us  to  give  detailed
  511.           information on Network setup since such information takes volumes
  512.           and our main concern is with getting your GAP system installed as
  513.           quickly as possible. Since GAP was designed for the professional,
  514.           this document  assumes  the  sysop  has  some  knowledge  of  DOS
  515.           essentials.
  516.  
  517.           You should  have or  create a  CONFIG.SYS file with the following
  518.           parameters :
  519.  
  520.                FILES=25            <- IMPORTANT
  521.                BUFFERS=40
  522.  
  523.           Your AUTOEXEC.BAT  file should  contain  a  path  statement  that
  524.           includes the GAP DEFAULT directory:
  525.  
  526.                PATH=C:\;C:\DOS;C:\GAP
  527.  
  528.           To run  the program efficiently, you should be using some type of
  529.           Disk Caching  program with  a minimum  of 256k  allocated to  the
  530.           cache in  expanded memory.  If you are using an XT, allocate 128k
  531.           of regular  memory to  the cache.  When using  a disk  cache, you
  532.           should lower the number of buffers in the CONFIG.SYS file to 3.
  533.  
  534.           If you are running the Multi Node version of GAP, you should have
  535.           received, in  addition to  this manual,  a  supplemental  booklet
  536.           called Multi Node Operation. This booklet provides information on
  537.           configuring your network or multi tasker for GAP.
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.                                        Page 4
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.           Chapter 2
  568.  
  569.  
  570.                                                                       Setup
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.           Directory Structure
  578.  
  579.           In order  to insure  correct operation  of your BBS, we recommend
  580.           that you use a directory structure that is consistent and easy to
  581.           manage.
  582.  
  583.           The Install  program creates  the necessary  GAP directories  for
  584.           you, however  you may want to use the chart on the following page
  585.           as a  guideline should  you need  to create a directory structure
  586.           for other nodes or as a visual means to understanding the general
  587.           layout of GAP.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.                                        Page 5
  617.  
  618.  
  619.  
  620.           GAP Communications                                          Setup
  621.  
  622.  
  623.  
  624.  
  625.           GAP Directory Structure
  626.  
  627.           *****************************************************************
  628.           *                                                               *
  629.           *    Root Directory                                             *
  630.           *         |                                                     *
  631.           *         +-- GAP DEFAULT Directory                             *
  632.           *                 |                                             *
  633.           *                 +-- Download Directories                      *
  634.           *                 |                                             *
  635.           *                 +-- Forum DEFAULT Directory                   *
  636.           *                 |       |                                     *
  637.           *                 |       +-- Download Directories              *
  638.           *                 |       |                                     *
  639.           *                 |       +-- GEN Directory                     *
  640.           *                 |       |                                     *
  641.           *                 |       +-- UPLOAD Directory                  *
  642.           *                 |                                             *
  643.           *                 +-- GEN Directory                             *
  644.           *                 |                                             *
  645.           *                 +-- HELP Directory                            *
  646.           *                 |                                             *
  647.           *                 +-- MAIN Directory                            *
  648.           *                 |       |                                     *
  649.           *                 |       +-- UserInfo Files                    *
  650.           *                 |                                             *
  651.           *                 +-- UPLOAD Directory                          *
  652.           *                 |                                             *
  653.           *                 +-- QWK/REP Directory                         *
  654.           *                                                               *
  655.           *****************************************************************
  656.  
  657.  
  658.           The DEFAULT  Directory is  the home  directory for the BBS and in
  659.           the case of a Forum, it is the base directory for that Forum.
  660.  
  661.           The MAIN  Directory is  where the dynamic files are placed. These
  662.           include  the  User  and  Main  Message  database,  the  Filebase,
  663.           Questionnaires and  their answer  files, as  well as  other files
  664.           that contain sensitive information.
  665.  
  666.           The GEN  Directory is  where the  static files  are placed. Since
  667.           these files  rarely change  while a  caller is  on-line  the  GEN
  668.           directory may  be placed  on a RAM disk to speed up access to its
  669.  
  670.  
  671.  
  672.  
  673.  
  674.                                        Page 6
  675.  
  676.  
  677.  
  678.           GAP Communications                                          Setup
  679.  
  680.  
  681.  
  682.  
  683.           files. In  this directory you will find the Menus, Bulletins, and
  684.           other informational files.
  685.  
  686.           It is not necessary to place your Download and Upload Directories
  687.           as subdirectories  under the GAP Default Directory. In fact, many
  688.           Sysops use a separate disk for these directories. Since the files
  689.           in the download directories do not grow or change position on the
  690.           hard disk,  your disk  optimizing chores  will be easier if these
  691.           files are placed on their own hard disk.
  692.  
  693.           The Forum  DEFAULT directory  is equivalent to the MAIN directory
  694.           and the  Forum GEN  directory is equivalent to the GEN directory.
  695.           Forums need not have a GEN directory unless you want the Forum to
  696.           have its  own specific  menus or informational files; nor do they
  697.           need an UP directory unless you choose to keep uploads inside the
  698.           Forum.
  699.  
  700.           The Forum  Download Directories  are necessary  only if  you have
  701.           additional file directories available in the Forum.
  702.  
  703.  
  704.           File Locations
  705.  
  706.           The following  is a  list of  the actual  files which  should  be
  707.           placed in their respective directories:
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.                                        Page 7
  733.  
  734.  
  735.  
  736.           GAP Communications                                          Setup
  737.  
  738.  
  739.  
  740.  
  741.           +----------------------------------------------------------------+
  742.              DEFAULT           MAIN            GEN        HELP          |                                                                |
  743.           |----------------------------------------------------------------|
  744.              Door Batch Files  ANSWERxx        7E1        All Help Files          |                                                                |
  745.              DOOR.SYS          CALL.DAT        BIRTH(g)          |                                                                |
  746.              EVENTS.DAT        CALLERx         BLT(g)          |                                                                |
  747.              EVENTx.BAT        CHAT.1          BLTxx(g)          |                                                                |
  748.              EXTRx.BAT         DUMMYLOK.DAT    CLOSED(g)          |                                                                |
  749.              EXTSx.BAT         DWNLOAD.DAT     COMMENT(g)          |                                                                |
  750.              FILELST.DWN       DWNLOAD.IDX     DIR(g)          |                                                                |
  751.              GAP.BAT           FILEKEY.DAT     DIRS          |                                                                |
  752.              GAP.HLP           FILEKEY.IDX     DOORM(g)          |                                                                |
  753.              GAP.NDX           FILES.DAT       DOORS.DAT          |                                                                |
  754.              GAPBBS.CNF        FILES.IDX       ENEWS(g)          |                                                                |
  755.              GAPBBS.EXE        FORUM.DAT       EVENT(g)          |                                                                |
  756.              GAPCALL.CNF       MEMBER.DAT      EXPIRE(g)          |                                                                |
  757.              GAPCALL.EXE       MEMBER.IDX      FILEM(g)          |                                                                |
  758.              GAPCALL.HLP       MESSNO.DAT      FILES.DIR          |                                                                |
  759.              GAPDOOR.EXE       MSGS.DAT        FORUMM(g)          |                                                                |
  760.              GAPFILE.CNF       MSGS.IDX        KEEPUP(g)          |                                                                |
  761.              GAPFILE.EXE       NETWORK.DAT     LOCKOUT(g)          |                                                                |
  762.              GAPMAINT.CNF      NEWQUEST        LOGON          |                                                                |
  763.              GAPMAINT.EXE      QUESTxx         MAINM(g)          |                                                                |
  764.              GAPMAINT.HLP      REGIS           NEWS(g)          |                                                                |
  765.              GAPMENU.CNF       SECLEV.xxx      NEWSx(g)          |                                                                |
  766.              GAPMENU.EXE       TCAN            NEWUSER(g)          |                                                                |
  767.              GAPMENU.MNU       USERINFO        NOPAGE(g)          |                                                                |
  768.              GAPMENUx.SCR      USERS.DAT       NOTIME(g)          |                                                                |
  769.              GAPPACK.EXE       USERS.IDX       NOUP          |                                                                |
  770.              GAPREBLD.EXE                      PAGE(g)          |                                                                |
  771.              GAPREPRT.EXE                      PROTO(g)          |                                                                |
  772.              GAPSETUP.EXE                      QMENU(g)          |                                                                |
  773.              GAPSYS.DAT                        RATIO(g)          |                                                                |
  774.              GAPUSER.EXE                       REGINFO(g)          |                                                                |
  775.              GAPUSER.HLP                       RESBAUD          |                                                                |
  776.              GAPUSER.NDX                       SMAINM(g)          |                                                                |
  777.              GMFORUM.CNF                       TWIT(g)          |                                                                |
  778.              READBTCH.EXE                      UPHELP(g)          |                                                                |
  779.              REMOTE.BAT                        UPLOAD(g)          |                                                                |
  780.                                                WELC(g)          |                                                                |
  781.                                                WELCx(g)          |                                                                |
  782.           +----------------------------------------------------------------+
  783.  
  784.           Note that  some of  those files  will be  created  by  the  setup
  785.           program and  are not included on the distribution diskettes. Also
  786.  
  787.  
  788.  
  789.  
  790.                                        Page 8
  791.  
  792.  
  793.  
  794.           GAP Communications                                          Setup
  795.  
  796.  
  797.  
  798.  
  799.           many of  them are  optional (they  must be created if you wish to
  800.           utilize them).
  801.  
  802.           Forum File Locations
  803.  
  804.           The following  is a  list of  files which  can be  unique to each
  805.           Forum:
  806.  
  807.           +----------------------------------------------------------------+
  808.              DEFAULT           GEN             UP         DOWN          |                                                                |
  809.           |----------------------------------------------------------------|
  810.              ANSWERxx          BLT(g)          Forum Up   Forum Down          |                                                                |
  811.              MSGS.DAT          BLTxx(g)          |                                                                |
  812.              MSGS.IDX          DIR(g)          |                                                                |
  813.              QUESTxx           DIRS          |                                                                |
  814.                                DOORM(g)          |                                                                |
  815.                                DOORS.DAT          |                                                                |
  816.                                FILEM(g)          |                                                                |
  817.                                FILES.DIR          |                                                                |
  818.                                MAINM(g)          |                                                                |
  819.                                NEWS(g)          |                                                                |
  820.                                QMENU(g)          |                                                                |
  821.                                SMAINM(g)          |                                                                |
  822.           +----------------------------------------------------------------+
  823.  
  824.           A Forum  does not  have to have any GEN files as it can share the
  825.           equivalent main  board files. If you wish for a Forum to not have
  826.           any specific  file directories,  you will  not need the Upload or
  827.           Download directories.  At the  very minimum,  a Forum  can have 2
  828.           files (MSGS.DAT and MSGS.IDX).
  829.  
  830.           Installation
  831.  
  832.           To install  the GAP  files, insert  the GAP  Distribution Disk #1
  833.           into your floppy drive and type:
  834.  
  835.                A:INSTALL
  836.  
  837.           The  installation   program  will   create  the   necessary  file
  838.           directories and copy the GAP files to your hard disk.
  839.  
  840.           The initial  configuration of GAP will assume a default hard disk
  841.           of Drive  C:. If  this is  the drive  that you installed to, then
  842.           your GAP  system will  be ready  to run  after  the  installation
  843.           process is  finished. After the installation program has finished
  844.  
  845.  
  846.  
  847.  
  848.                                        Page 9
  849.  
  850.  
  851.  
  852.           GAP Communications                                          Setup
  853.  
  854.  
  855.  
  856.  
  857.           installing the  GAP files,  you will  automatically be taken into
  858.           the Configuration  Editor. If you are satisfied with the defaults
  859.           provided, exit  out of  the program  (Select the  Quit  Menu  and
  860.           choose the  Save option).  Next you  will be  taken into the User
  861.           Editor. The record you will see is your sysop record. You need to
  862.           change the  First, Last, and Password fields to names of your own
  863.           choosing. Do  not use  your real  name and  do not use a password                        
  864.           that you use to call other systems.
  865.  
  866.           After making the changes to your sysop record in the User Editor,
  867.           press Esc  (press Y  to save  changes when asked) and then select
  868.           Quit from the Menu.
  869.  
  870.           Using the  defaults provided,  your GAP  Communications system is
  871.           ready to go. If you like, you may now log on as the sysop.
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.                                        Page 10
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.           Chapter 3
  917.  
  918.  
  919.  
  920.                                                               Configuration
  921.  
  922.  
  923.  
  924.  
  925.  
  926.           Before you can run any of the GAP programs you must create and/or
  927.           verify that  the start-up  batch file  is correct. A sample batch
  928.           file was provided (GAP.BAT). The file should appear as follows:
  929.  
  930.                          GAP.BAT
  931.                          +----------------------------------+
  932.                            echo off                         |                                  |
  933.                            gapmenu                         |                                  |
  934.                            if errorlevel 99 gap                         |                                  |
  935.                          +----------------------------------+
  936.  
  937.  
  938.           To insure  proper operation  of the  BBS, GAP  must be run from a
  939.           batch file. If you are running multiple nodes, you may rename the
  940.           file but its contents should remain the same. Each node must have
  941.           its own copy of the batch file and the last line of the file must
  942.           reflect the name of the individual file. For instance:
  943.  
  944.                          +----------------------------------+
  945.                            Node 1          GAP.BAT                         |                                  |
  946.                            Node 2          NODE2.BAT                         |                                  |
  947.                            Node 3          NODE3.BAT                         |                                  |
  948.                          +----------------------------------+
  949.  
  950.  
  951.           The only  difference between  the files  should be  the last line
  952.           where the batch file invokes itself.
  953.  
  954.           This manual  will describe  the configuration  of a  single  node
  955.           system only.  If you  are running  a multi  user system, you will
  956.           need to  perform the  configuration  from  each  of  your  node's
  957.           DEFAULT directories.  This is most easily accomplished by copying
  958.           the GAPBBS.CNF  file from the DEFAULT directory of your main node
  959.           (after you  have fully configured it) to the DEFAULT directory of
  960.  
  961.  
  962.  
  963.  
  964.                                        Page 11
  965.  
  966.  
  967.  
  968.           GAP Communications                                  Configuration
  969.  
  970.  
  971.  
  972.  
  973.           the secondary node, then invoke the Configuration Editor from the
  974.           secondary node's  Call Waiting screen, change the node number and
  975.           any other  configuration parameters  specific to  that node,  and
  976.           save.
  977.  
  978.           It is  not necessary  to have  multiple  copies  of  any  of  the
  979.           programs if  you have  a DOS path set to your main node's default
  980.           directory.
  981.  
  982.  
  983.                +------------------------------------------------------+
  984.                 If you  are using  the Multi-User version of GAP, you               |                                                      |
  985.                 must be  sure to  run SHARE.EXE  prior to running any               |                                                      |
  986.                 GAP program.  This is best accomplished by installing               |                                                      |
  987.                 the program from your AUTOEXEC.BAT file.               |                                                      |
  988.                +------------------------------------------------------+
  989.  
  990.  
  991.           To configure  GAP for your particular installation, from your GAP
  992.           DEFAULT  directory,  type  GAP.  If  you  used  the  installation
  993.           program, you  will automatically  be taken into the configuration
  994.           program.
  995.  
  996.           If this  is a  first time  installation, you  will see  the  Call
  997.           Waiting Screen  and will  be taken  immediately to GAPSETUP where
  998.           you may configure your individual options.
  999.  
  1000.           Most of  the configuration  options are self explanatory and they
  1001.           all have  help available by pressing the F1-Help key. However any
  1002.           option which  requires more explanation will be described here in
  1003.           more detail.
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.                                        Page 12
  1023.  
  1024.  
  1025.  
  1026.           GAP Communications                                  Configuration
  1027.  
  1028.  
  1029.  
  1030.  
  1031.           Sysop Security Levels
  1032.  
  1033.           ARTWORK
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.           The Sysop's  Name is  the name  that GAP  uses at  various points
  1050.           during the program's operation when referring to you.
  1051.  
  1052.           The Logon  Password is  the password  required to  log  onto  the
  1053.           system from  the local console. Remember this password as it will
  1054.           be needed  to log  on locally  as the  sysop or to use one of the
  1055.           external editor programs.
  1056.  
  1057.           In the  Sysop's Country  field, you  should enter the name of the
  1058.           country in  which your  BBS operates. For instance, in the United
  1059.           States you  would enter  USA. In  Canada, you would enter CANADA.
  1060.           This field is used as the default country for new users.
  1061.  
  1062.           Read Private  Mail is the level that a user must have in order to
  1063.           read any  private messages  that were  left via  the  Enter  Mail
  1064.           command or the Reply to Message command.
  1065.  
  1066.           Read Comments is the level that a user must have in order to read
  1067.           any comments that were left to the sysop.
  1068.  
  1069.           Note that  the sysop  will not  be able  to read  private mail or
  1070.           comments if  he/she does  not have  at least  the security  level
  1071.           assigned to these commands.
  1072.  
  1073.           Protect/UnProtect Messages  is the level that a user must have in                            
  1074.           order to  make a  private message  public  or  a  public  message
  1075.           private.
  1076.  
  1077.  
  1078.  
  1079.  
  1080.                                        Page 13
  1081.  
  1082.  
  1083.  
  1084.           GAP Communications                                  Configuration
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.           Read Without  Updating Read  Flag is  the level  that a user must
  1091.           have in  order to  read messages without GAP flagging any message
  1092.           that is to the user as having been read.
  1093.  
  1094.           Edit Message  Headers is the level that a user must have in order
  1095.           to edit the header portion of a message.
  1096.  
  1097.           Attach Files  To Messages  is the  level that a user must have in
  1098.           order to attach an uploaded file to a message.
  1099.  
  1100.           Note that  all of  the above  Message  System  commands  will  be
  1101.           explained in detail in the chapter System Operation. The security
  1102.           level for  these  commands  are  configured  here  because  these
  1103.           commands are  generally regarded as sysop level commands, and not
  1104.           commands that  you would  normally want  your users to be able to
  1105.           utilize.
  1106.  
  1107.           Overwrite Files  is the  level a  user  must  have  in  order  to
  1108.           overwrite  a  file  that  already  exists  in  one  of  the  file
  1109.           directories. Note  that if  a user  uploads a  file with the same
  1110.           name as  a file  that the  user has previously uploaded, the user
  1111.           will be  able to  overwrite that  file if  he/she so chooses. The
  1112.           Overwrite Files  security level  is the  level that  is needed to
  1113.           overwrite a file that the user did not upload.
  1114.  
  1115.           The security levels associated with the sysop functions 1 - 7 are
  1116.           the levels  that are  needed in  order  to  perform  one  of  the
  1117.           associated sysop  functions. These  functions are  available from
  1118.           the Main  Sysop Menu  (the Menu  that is  shown to  anyone with a
  1119.           security level of 100 or greater).
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.                                        Page 14
  1139.  
  1140.  
  1141.  
  1142.           GAP Communications                                  Configuration
  1143.  
  1144.  
  1145.  
  1146.  
  1147.           File Names
  1148.  
  1149.           ARTWORK
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.           These are the names of various system files. It is suggested that
  1166.           you leave  these names  as they  are.  All  of  these  files  are
  1167.           shareable  across  a  network.  The  reason  you  are  given  the                                
  1168.           opportunity to  change their  names is  because you  may not want
  1169.           some of  the files shared and instead would like for each node to
  1170.           use a  different version  of a  particular file (DOORS.DAT is one
  1171.           such file that you may not want to share between nodes).
  1172.  
  1173.           Any text  file which  is shown  to the  user can  be either plain
  1174.           ASCII or  ANSI color  graphics. Color files have the same name as
  1175.           the plain  version but  with a "G" appended. Refer to the chapter
  1176.           Text Files  for more  information on creating the text files your
  1177.           callers see.
  1178.  
  1179.           Please see  the chapter  System Files  for further explanation of
  1180.           many of these files.
  1181.  
  1182.           The Main  Message File  will be  created the  first time you save
  1183.           your configuration in GAPSETUP. This is the base name of the file
  1184.           that contains  your Main  Board messages.  It will  always have a                                          
  1185.           .DAT extension  and will be accompanied by an index file with the
  1186.           same base name, but with a .IDX extension.
  1187.  
  1188.           The User  File will  be created the first time you enter into the
  1189.           User Editor.  This is  the base  name of the file that contains a
  1190.           record for  each of  your users.  It  will  always  have  a  .DAT
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.                                        Page 15
  1197.  
  1198.  
  1199.  
  1200.           GAP Communications                                  Configuration
  1201.  
  1202.  
  1203.  
  1204.  
  1205.           extension and  will be accompanied by an index file with the same
  1206.           base name, but with a .IDX extension.
  1207.  
  1208.           The Caller File will be created by GAP when the first caller logs
  1209.           on. This  file can grow quite rapidly so it is suggested that you
  1210.           use the  Caller Analyzer  to  read  the  file  into  the  GAPCALL
  1211.           database on a daily basis and delete the old copy.
  1212.  
  1213.           The Welcome  File is displayed to callers when they first log on.
  1214.           You may have up to 10 of these files.
  1215.  
  1216.           The New User Welcome File is similar to the main welcome file. It                       
  1217.           is shown  to all  new users.  Normally its purpose is to describe
  1218.           your board  to new  users and  perhaps set  forth  a  few  "house
  1219.           rules". After  reading this  file, the  new user will be asked if
  1220.           he/she wishes to register.
  1221.  
  1222.           The Time/Bytes  File is  a file  which contains  security levels,
  1223.           time  allotments,   maximum  allowable  download  bytes,  maximum
  1224.           allowable files  per day,  file ratios,  and whether  or not  GAP
  1225.           should randomly verify certain callers' registration information.                                                  
  1226.           You may  have 24  of these files for each hour of the day grouped
  1227.           according to  baud rates.  These time/baud  specific SECLEV files
  1228.           allow you  to restrict  callers based upon the time of day and/or
  1229.           their baud rate.
  1230.  
  1231.           The  Trashcan  File  contains  names  that  you  consider  to  be
  1232.           distasteful. Any  user who  tries to  log on  with a name that is
  1233.           found in  the trash  will be  denied access. When you press F2 to                        
  1234.           lock a  user out,  the user's name will automatically be added to
  1235.           the TCAN file.
  1236.  
  1237.           You may  specify the names of the main Questionnaire Answers File
  1238.           as well  as the  names of  the New  User Questionnaire and Answer
  1239.           Files. The  Questionnaire Files  are described  in more detail in
  1240.           the chapter Questionnaires. If the New User Questionnaire exists,                      
  1241.           all new  users will be forced to fill it out before being allowed
  1242.           onto the system.
  1243.  
  1244.           The Doors  Data File  is a file which list the available doors on
  1245.           your BBS  along with the security levels necessary to access them
  1246.           and the full path and name of the door file to run.
  1247.  
  1248.           The Entry News File will be shown to callers when they log on. It                    
  1249.           is displayed after GAP has logged the caller onto the system.
  1250.  
  1251.  
  1252.  
  1253.  
  1254.                                        Page 16
  1255.  
  1256.  
  1257.  
  1258.           GAP Communications                                  Configuration
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.           The Exit News File will be shown to callers when they log off.                   
  1265.  
  1266.           The Remote Batch File is a batch file which GAP will run when the
  1267.           sysop exits to DOS from remote.
  1268.  
  1269.           The Forum Data File holds the Forum configurations.
  1270.  
  1271.           Drive/Path Specifications
  1272.  
  1273.           ARTWORK
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.           Each entry  must begin  with a  drive designator  and the entries
  1290.           must conform to valid DOS path specifications.
  1291.  
  1292.           The Upload  Directory Path  is the  disk directory where the main
  1293.           board uploads will be placed.
  1294.  
  1295.           The General  Directory Path  is the  disk directory where most of
  1296.           the text files are placed. This may be a RAM Disk.
  1297.  
  1298.           The Main  Directory Path  is the  disk directory  where important
  1299.           data files are placed.
  1300.  
  1301.           The Help  Directory Path is the disk directory where all the help
  1302.           files are located.
  1303.  
  1304.           The Loose  Files Directory  Path is  the disk directory where any
  1305.           files not  classified in  the FileBase  are stored. If GAP cannot
  1306.           locate a  requested file  in the  FileBase, it  will look in this
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.                                        Page 17
  1313.  
  1314.  
  1315.  
  1316.           GAP Communications                                  Configuration
  1317.  
  1318.  
  1319.  
  1320.  
  1321.           directory for  the file.  Note that  wild cards cannot be used on
  1322.           loose files. You may designate two such directories.
  1323.  
  1324.           The Indirection  Files Directory Path is the disk directory where
  1325.           you place text files that GAP will read if a file in the FileBase
  1326.           contains an  '@' as the first character in the Password field for
  1327.           the file.  The Indirection file provides GAP with a list of users
  1328.           who are  authorized to  download the file. Please see the chapter
  1329.           FileBase Editor for further information on indirection files.
  1330.  
  1331.           The Attached Files Directory Path is the disk directory where GAP
  1332.           will place all files that are attached to messages.
  1333.  
  1334.           Modem Configuration
  1335.  
  1336.           ARTWORK
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.           Please see the chapter Modem Configuration for further details on                                 
  1353.           setting up your modem.
  1354.  
  1355.           The Modem Reset String is the string to reset the modem.
  1356.  
  1357.           The Modem Init String is the string to initialize the modem.
  1358.  
  1359.           The Modem Off-Hook String is the string to take the modem off the
  1360.           hook.
  1361.  
  1362.           The Seconds  To Wait  For Carrier is the number of seconds GAP is
  1363.           to wait  while trying  to establish  a connection  with a  remote
  1364.           modem. This  should match  the "S7="  parameter in the Modem Init
  1365.           String.
  1366.  
  1367.  
  1368.  
  1369.  
  1370.                                        Page 18
  1371.  
  1372.  
  1373.  
  1374.           GAP Communications                                  Configuration
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.           Seconds To  Wait For Connect is a special field to deal with slow
  1381.           modems. If you find that your modem establishes a carrier and yet
  1382.           GAPMENU simply  recycles or  if a  connection is  made but at the
  1383.           wrong bps  rate, try setting this field to some number of seconds
  1384.           (typically 2 seconds).
  1385.  
  1386.           You may  configure up to 4 Communications Ports. A port number of
  1387.           0 tells GAP to not initialize or use a communications port. Ports
  1388.           1 and  2 are  pre-configured and  will use the default values for
  1389.           IRQ and Base Address. GAP will ignore anything you enter in these
  1390.           two fields. If you set up ports other than 1 or 2, you must enter
  1391.           the appropriate  IRQ and  Base Address  for that port. If you are
  1392.           unsure of  what an IRQ or Base Address is, do not configure other
  1393.           than COM 1 or COM 2!
  1394.  
  1395.           The Initial  BPS Rate  is the  bps rate to use in opening the COM
  1396.           Port. This should be set to the highest speed at which your modem
  1397.           can operate.
  1398.  
  1399.           Lock BPS  Rate is  typically used with modems that are capable of
  1400.           operating at  speeds greater  than 2400  bps. It is used when you
  1401.           want the  computer to  modem (DTE)  rate  to  remain  fixed.  For
  1402.           instance with  a 9600  baud modem,  you normally  would want  the
  1403.           computer to  modem link  locked in  at 19,200  bps or 38,400 bps.
  1404.           Setting this  flag will  keep GAPMENU from changing the baud rate
  1405.           of the serial port to match that of the caller. Note that if your
  1406.           modem automatically changes its baud rate to match the rate of an
  1407.           incoming call  you must  not set  this field  to Yes.  Otherwise,                                   
  1408.           GAPBBS will  communicate with  your modem at the Initial BBS Rate                                                           
  1409.           instead of the rate of the call. The end result will be that your
  1410.           callers will  see garbage  on their  screen and will be unable to
  1411.           type anything  intelligible. Most  9600 baud modems which utilize
  1412.           the MNP  protocol, if  they do automatically change the baud rate
  1413.           to match  that of the caller, will also provide a software switch
  1414.           which you  can use  in your Init String to prevent the modem from
  1415.           doing this.
  1416.  
  1417.           Answer On True Ring Detect tells GAP to answer the phone when the
  1418.           modem asserts the ring detect line. This should be set to Yes. If
  1419.           your modem  is incapable  of asserting ring detect you should set
  1420.           this to  No. This  field should  also be  set to No if your modem
  1421.           cannot accept commands while it is sending them.
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.                                        Page 19
  1429.  
  1430.  
  1431.  
  1432.           GAP Communications                                  Configuration
  1433.  
  1434.  
  1435.  
  1436.  
  1437.           Answer On  Ring #  tells GAP to answer the phone on the specified
  1438.           number of  rings. Normally  this field should be set to 1. If you
  1439.           have a  specific need  for GAP  to answer on other than the first
  1440.           ring, you can set this field to any number from 1 to 9.
  1441.  
  1442.           Full  Flow  Zmodem  Uploads  is  a  flag  just  for  Zmodem  file
  1443.           transfers. If  set, GAP  will not tell the sending Zmodem program
  1444.           to honor  a restricted  buffer size. If you have a fast hard disk
  1445.           you should set this flag to Yes.
  1446.  
  1447.           Send BREAK  to Clear  Buffer tells  GAP whether  or not to send a
  1448.           BREAK signal  to the  modem to  clear the  modem buffer.  A break
  1449.           signal normally tells a modem to empty its internal buffer.
  1450.  
  1451.           If a  caller presses  CTRL-K, CTRL-X,  or <space>  while  viewing
  1452.           files (or  at anytime  when in  Non-Stop mode),  GAP will  send a
  1453.           "break" to  the modem. What affect this has on the caller depends
  1454.           on your modem. If sending this "break" signal to the modem causes
  1455.           problems, then you should set this field to No.
  1456.  
  1457.           If you  use a USR modem and have the break setting (&Y) set to 1,
  1458.           the modem  will empty  its buffer  when it  receives the  "break"
  1459.           signal. If  a caller  is at  less than  your maximum  speed, this
  1460.           means the  abort takes  effect almost immediately. If GAP did not
  1461.           send the  "break" to  the modem,  the abort would take place only
  1462.           after your modem emptied its buffer.
  1463.  
  1464.           Use Inter  Character Delay  allows you to tell GAPMENU, if set to
  1465.           Yes, to  pause 1/18th  of a second between each character of your
  1466.           RESET and  INIT strings  when sending these strings to the modem.
  1467.           Unless you  use an off brand 2400 baud modem, you should set this
  1468.           field to No.
  1469.  
  1470.           RTS Off  During Disk  Write allows  you to  tell GAP  to turn the
  1471.           Request To Send signal off when GAP writes a block of data to the
  1472.           disk drive (during an upload). If you have a slow hard drive or a
  1473.           slow network  and you see CRC errors every time GAP writes to the
  1474.           hard drive  during an  upload (which  is at  1k  intervals),  you
  1475.           probably need to set this option to Yes. Note that this flag will
  1476.           have  no   effect  if   your  modem  does  not  support  hardware
  1477.           handshaking (CTS/RTS Flow Control).
  1478.  
  1479.           The Caller  Connect BPS  Rate is  a special field for some modems
  1480.           that absolutely  refuse to return the caller's CONNECT rate. Some                                                         
  1481.           of the  newer high  speed modems insist on returning the DTE rate
  1482.  
  1483.  
  1484.  
  1485.  
  1486.                                        Page 20
  1487.  
  1488.  
  1489.  
  1490.           GAP Communications                                  Configuration
  1491.  
  1492.  
  1493.  
  1494.  
  1495.           in the CONNECT string instead of the caller's speed. GAP uses the
  1496.           caller's actual  connect speed  (modem to modem) to determine how
  1497.           many files  the caller  can  download,  calculate  file  transfer
  1498.           efficiency times,  etc. This  field takes  one of  two responses.
  1499.           Either the  word CONNECT  or the actual BPS Rate you want GAPMENU
  1500.           to  pass   along  to  GAPBBS.  Most  sysops  will  use  the  word
  1501.           CONNECT, since this means that GAPMENU will determine the Connect
  1502.           speed from  the string  returned by the modem. If you have one of
  1503.           these modems  that insists  on returning  the DTE rate instead of
  1504.           the Connect  rate, you  should enter a bps rate that you want GAP
  1505.           to use  whenever it  needs to know the caller's connect rate. For
  1506.           instance, if you lock your port at 38400, you would probably want
  1507.           to enter  9600 or 4800 in this field (depending upon how fair you
  1508.           want to be to your high speed callers or how generous you want to
  1509.           be to your 2400 baud and less callers).
  1510.  
  1511.           BPS Rate Restriction
  1512.  
  1513.           ARTWORK
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.           GAP allows you to restrict callers based on certain bps rates.
  1530.  
  1531.           The Highest  BPS Rate  Not Allowed  allows you  to  prohibit  any
  1532.           caller that  attempts to log on to your system using the rate you
  1533.           specify from  gaining access to your system. For instance, if you
  1534.           wish to  prohibit 300 baud callers from gaining access, you would
  1535.           enter 300  in this  field. If you do not wish to prohibit callers
  1536.           based upon their baud rate, then leave this field blank.
  1537.  
  1538.           Note that  you may  use this  option, along  with the Highest BPS
  1539.           Rate To Restrict option to prohibit some baud rates and yet allow
  1540.  
  1541.  
  1542.  
  1543.  
  1544.                                        Page 21
  1545.  
  1546.  
  1547.  
  1548.           GAP Communications                                  Configuration
  1549.  
  1550.  
  1551.  
  1552.  
  1553.           other baud  rates during  certain times  of the  day. This option
  1554.           takes precedence over the other, meaning that if you prohibit 300
  1555.           baud callers  and yet  enter 300  as  the  Highest  BPS  Rate  to
  1556.           Restrict and a 300 baud caller calls during a time when you would
  1557.           like to allow them on, the 300 baud caller will not be allowed on
  1558.           at all.  If you  would rather  restrict  certain  baud  rates  to
  1559.           certain hours of the day then leave this field blank.
  1560.  
  1561.           If you  wish to  restrict certain baud rates during certain times
  1562.           of the  day, set  the Allow Restricted Callers field to Yes, give
  1563.           the rate  to restrict,  and enter  the start and end times. These
  1564.           times are  the times  that the  bps rate is not restricted (i.e.,                                                      
  1565.           the times  they are  allowed on).  If you  create a  file  called
  1566.           RESBAUD (GEN  directory), it  will be  shown  to  any  restricted
  1567.           caller. This  allows the  sysop to  customize the message that is
  1568.           displayed to  callers who  call at  an undesirable baud rate. The
  1569.           message should  be kept  as short  as possible. There is no color
  1570.           version of  this file  since  GAPMENU  does  not  know  what  the
  1571.           caller's color preference is.
  1572.  
  1573.           Main Menu Commands
  1574.  
  1575.           ARTWORK
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.           These are the security levels a user must have in order to access
  1592.           a particular function from the Main Menu.
  1593.  
  1594.           All of  these functions  are described  in detail  in the chapter
  1595.           System Operation.
  1596.  
  1597.           Note that CHAT and WHO are available only on multi user systems.
  1598.  
  1599.  
  1600.  
  1601.  
  1602.                                        Page 22
  1603.  
  1604.  
  1605.  
  1606.           GAP Communications                                  Configuration
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.           The levels  for REP  and QWK  are the  security levels  needed to
  1613.           invoke the QWK/REP modules.
  1614.  
  1615.           A new user is given the New User Level.
  1616.  
  1617.           If your  SECLEV file  tells GAP  to verify  users with a specific
  1618.           security level,  GAP will randomly ask a caller to verify his/her
  1619.           Home Phone  Number or Birth Date. If the user can not provide GAP
  1620.           with his/her  phone number or birth date, GAP will display a file
  1621.           called FAILED  and will  then set  the user  to the  Failed Check
  1622.           Level. This level should be less than your New User Level and you                                                     
  1623.           should have  Security Menus  set up for this level that allow the
  1624.           user to  do nothing  but enter  a Comment  and Goodbye. If a user
  1625.           fails the  registration verification check, you basically want to
  1626.           cut off  all privileges  to the  user and  force the  user into a
  1627.           Comment so  the user  can either  tell you  why he/she  does  not
  1628.           remember his/her phone number or birthday.
  1629.  
  1630.           The Failed Check Level is described in full detail in the chapter
  1631.           System Files.
  1632.  
  1633.           The two  Sysop Defined  menu items  allow you  to  configure  two
  1634.           custom menu  choices. To  define a  Custom Menu  Item, you  first
  1635.           enter the  name for  the Menu  Item (2 to 5 characters), then the
  1636.           security level  required to utilize that Menu Item. You will then
  1637.           need to  create a  batch file  (which goes  in your  GAP  DEFAULT                                                                    
  1638.           directory) to  carry out  the commands  associated with that Menu
  1639.           Item. The  batch file  has the same name as the name you give the
  1640.           Menu Item (with a .BAT extension). In GAPBBS, when a caller types
  1641.           one of  your Custom Menu Items, GAP will shell to the batch file,
  1642.           execute the file, then return.
  1643.  
  1644.           An example  of a Custom Menu Item which you could add would be to
  1645.           add a Mail Door (which you may have previously utilized as a door
  1646.           program). You would use the same batch file that was used for the
  1647.           door (except  that its  name must be changed to match the name of
  1648.           the Menu Item).
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.                                        Page 23
  1661.  
  1662.  
  1663.  
  1664.           GAP Communications                                  Configuration
  1665.  
  1666.  
  1667.  
  1668.  
  1669.           File Menu Commands
  1670.  
  1671.           ARTWORK
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.           File Commands - These are the security levels necessary to access
  1688.           a particular command in the Files System.
  1689.  
  1690.           Archive Commands  - These  are the  security levels  necessary to
  1691.           access a  particular  archive  function  from  within  the  Files
  1692.           System. GAP  handles both  ARC and ZIP files internally, with the
  1693.           exception of Transfer A File.
  1694.  
  1695.           Because  of   the  complications   involved  in   transferring  a
  1696.           particular file from within an archive, GAP handles this function
  1697.           externally via  a batch  file. When  a caller requests Transfer A
  1698.           File from  an archive,  GAP will  shell to  a batch  file  called
  1699.           ARCTRANS.BAT.
  1700.  
  1701.           The following parameters will be passed to the batch file:
  1702.  
  1703.           +----------------------------------------------------------------+
  1704.            %1 -  Where to put the Extracted File (loose directory #1)          |                                                                |
  1705.            %2 -  Full Path/Name of the Archive File to process          |                                                                |
  1706.            %3 -  What kind of Archive it is: ARC, ZIP, LZH, ICE, etc          |                                                                |
  1707.            %4 -  Name of the file to extract from the compressed file          |                                                                |
  1708.            %5 -  Name to use for the file, once extracted and recompressed          |                                                                |
  1709.           +----------------------------------------------------------------+
  1710.  
  1711.           A sample ARCTRANS.BAT file is included with GAP.
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                                        Page 24
  1719.  
  1720.  
  1721.  
  1722.           GAP Communications                                  Configuration
  1723.  
  1724.  
  1725.  
  1726.  
  1727.           GAP expects  your batch  file shell  to unpack  the file from the
  1728.           archive, re-pack  it using  the  supplied  name,  and  place  the
  1729.           resultant file in your first loose directory.
  1730.  
  1731.           Note that there are also two Sysop Defined menu choices available
  1732.           in the Files System.
  1733.  
  1734.           View/Change Stats Menu
  1735.  
  1736.           ARTWORK
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.           These are  the security  levels necessary  to access a particular
  1753.           command at the View/Change Stats Menu.
  1754.  
  1755.           The Stats  command allows  callers to edit portions of their user
  1756.           record. Other  configuration options  allow you  to control  what
  1757.           fields the callers may edit.
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.                                        Page 25
  1777.  
  1778.  
  1779.  
  1780.           GAP Communications                                  Configuration
  1781.  
  1782.  
  1783.  
  1784.  
  1785.           Miscellaneous Information - One
  1786.  
  1787.           ARTWORK
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.           Number Of Bulletins is the maximum number of main board bulletins
  1804.           you intend to post.
  1805.  
  1806.           Force BLT  Menu At  Logon allows you to force new callers to view
  1807.           the Bulletin Menu when they first log on.
  1808.  
  1809.           If the  Force New Bulletins is set to Yes then your users will be
  1810.           forced to  view the Bulletin Menu when they log on if any of your
  1811.           bulletins are  newer than  the user's last date on. If this field
  1812.           is set to No, callers will still be told there are new bulletins,
  1813.           but they will not be forced to view the Bulletin Menu.
  1814.  
  1815.           GAP maintains  mini statistics  on the  activity of  your system.
  1816.           These statistics  are reset  each day when the first caller after
  1817.           midnight  logs  off.  These  are  the  same  statistics  you  see
  1818.           displayed in  a window  on the  Call Waiting Screen. If you would
  1819.           like for  GAP to  create a  Bulletin containing these statistics,
  1820.           enter the  bulletin number  to use in the Yesterday's Stats Blt #
  1821.           and Monthly  Stats Blt # fields. If you do not want GAP to create
  1822.           these bulletins, enter a 0 in these fields. If you would like for
  1823.           both sets  of statistics  to appear  in the  same file, enter the
  1824.           same number in both fields.
  1825.  
  1826.           If you  would like  to have the bulletins created but do not want
  1827.           them to appear as a regular bulletin (where your callers can view
  1828.           them), simply give them numbers greater than the highest bulletin
  1829.           you have  configured. For  instance, if  you  normally  carry  14
  1830.  
  1831.  
  1832.  
  1833.  
  1834.                                        Page 26
  1835.  
  1836.  
  1837.  
  1838.           GAP Communications                                  Configuration
  1839.  
  1840.  
  1841.  
  1842.  
  1843.           bulletins, you  can give  these bulletins the numbers 15 & 16. Or
  1844.           just simply 15 for a combined bulletin.
  1845.  
  1846.           Note that  the bulletins  are created  using XCodes. You may view                                                       
  1847.           them inside  of GAPBBS  either as  a bulletin  or by  using Sysop
  1848.           Function 3 (Type File).
  1849.  
  1850.           Also note  that if  you run  multi nodes, GAP will write only the
  1851.           Network wide  portion of the stats. In other words, the  bulletin
  1852.           will not  contain the  statistics for  any  particular  node.  In
  1853.           addition, if you maintain separate GEN directories, the bulletins
  1854.           will be  written to the GEN directory of which ever node logs the
  1855.           first caller  off after  midnight (the  first node  that does the
  1856.           actual re-setting  of the  stats). You  will need  to devise some
  1857.           means of making sure the bulletins are consistent between nodes.
  1858.  
  1859.           Printer Port is the Line Printer port you wish to have the caller                                   
  1860.           log written to.
  1861.  
  1862.           If the  Enforce Time  Limit is  set to  Yes, users  will  not  be                          
  1863.           allowed access  if their time limit for the day has expired. They                                                              
  1864.           must wait until the following day before GAP will allow them back
  1865.           on. If set to No, GAP will allow any user to log on as many times
  1866.           as they wish in any given day.
  1867.  
  1868.           If you  want GAP  to ask  new users for their birth date, set the                                                        
  1869.           Prompt For  Birthday field to Yes. Note that if you intend to use
  1870.           the Registration  Verification feature  (which  randomly  prompts              
  1871.           certain users  to verify  their home  phone number  and/or  birth
  1872.           date), you must set this field to Yes.
  1873.  
  1874.           Forums may  be set  up to  allow users to use a handle instead of
  1875.           their real name while they are in the Forum. If you wish to allow
  1876.           this handle  feature, set  the Allow  Handles field to Yes. Users                                                
  1877.           may then  give themselves  a handle at the View/Change Stats Menu                                                     
  1878.           or when they join a Forum that allows handles.
  1879.  
  1880.           Normally when  a caller  exists through  a door,  GAP writes  the
  1881.           caller's real name to the DOOR.SYS file. If you want GAP to write
  1882.           the caller's handle (if the caller is using a handle at the time)
  1883.           to the file, enter a Yes in the Use Handle In DOOR.SYS field.
  1884.  
  1885.           If you wish to allow users to change their address, phone numbers
  1886.           and birth  date, while  on line,  set the  Allow Address  Changes
  1887.           field to Yes.
  1888.  
  1889.  
  1890.  
  1891.  
  1892.                                        Page 27
  1893.  
  1894.  
  1895.  
  1896.           GAP Communications                                  Configuration
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.           Force Registration  will insure that new users enter the required
  1903.           information at  registration. Phone  numbers will be validated as                                        
  1904.           to their content. If a user enters a number such as (555)555-5555
  1905.           they will  be allowed  on but  as soon as they arrive at the main
  1906.           command prompt,  they will be locked out and disconnected. If you
  1907.           set this  field to Yes and find that you have a lot of locked out
  1908.           users in  your user  file, chances  are very  good that the users
  1909.           entered a  fake phone  number. New  sysops tend  to not like this                          
  1910.           feature and  we suggest  that you set Force Registration to No if
  1911.           having GAP automatically lock out users who give fake information
  1912.           bothers you.  Old time  sysops appreciate GAP watching over their
  1913.           board in  the sense that they feel that if a new user cannot give                                                       
  1914.           correct information  at registration, they don't want the user on
  1915.           their system.
  1916.  
  1917.           Force 2nd Phone Number allows you to set your system up such that                    
  1918.           GAP will enforce registration by validating the Home Phone Number
  1919.           field, and  if you  answer No in this field, will allow new users
  1920.           to skip  the Business/Data Phone Number prompt or enter erroneous
  1921.           information.
  1922.  
  1923.           Experienced users will type Y Q NS or N Q NS at Logon in order to
  1924.           avoid having  to read  the welcome and news files. If you wish to                                     
  1925.           force users  to view  the news  and welcome  files, set the Allow
  1926.           Quick Logon to No.
  1927.  
  1928.           The Level  To Override  Logon is the security level a caller must
  1929.           have in  order to bypass forced bulletin viewing and the new mail                                          
  1930.           check. The Override command is an 'O' typed after the Quick Logon
  1931.           command.
  1932.  
  1933.           GAP shows  the name of the last caller on the Call Waiting Screen
  1934.           as well as on the User Stats Display. If you do not wish the last
  1935.           caller to  be shown  in either  of these two places, set the Show
  1936.           Last Caller field to No.
  1937.  
  1938.           If you  do not wish for the User Statistics screen to be shown to
  1939.           callers when  they first log on, set the Show User Stats field to
  1940.           No. The  User Statistics  screen is  the screen that displays the
  1941.           number of  files downloaded and uploaded, number of messages left                                                              
  1942.           and read, protocol preference, etc.
  1943.  
  1944.           You may  define the  Phone Number Template that GAP will use when
  1945.           gathering phone number data. The default template is the one used                    
  1946.  
  1947.  
  1948.  
  1949.  
  1950.                                        Page 28
  1951.  
  1952.  
  1953.  
  1954.           GAP Communications                                  Configuration
  1955.  
  1956.  
  1957.  
  1958.  
  1959.           in the  U.S. and Canada. If you live in Europe or another country
  1960.           that uses  different delimiters, you may change the appearance of
  1961.           the template.
  1962.  
  1963.           What you  enter into this field are "special" characters that the
  1964.           cursor will  "skip over"  when data  is being  input. The special
  1965.           characters are  "( )  -". Actual  data entry takes place wherever
  1966.           there is  a '9'  in the  template. As an example, in Switzerland,
  1967.           you could use the following template:
  1968.  
  1969.                999-99-99-9-99
  1970.  
  1971.           If you will never accept international calls, you could eliminate
  1972.           the country code and use the following template:
  1973.  
  1974.                99-99-9-99
  1975.  
  1976.  
  1977.           Miscellaneous Information - Two
  1978.  
  1979.           ARTWORK
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.           The Network  Node Number  must be set to the node number to which              
  1996.           this particular  configuration applies. Each node must be given a
  1997.           unique number.  In a  single user system, this number will remain
  1998.           at 0.
  1999.  
  2000.           If your  system is multi user, GAP has the ability to use NetBIOS                                                                    
  2001.           for all  chat functions. If your LAN supports NetBIOS and you set
  2002.           the NetBIOS  Chat field  to Yes,  GAP will  create a  direct link
  2003.           between two  nodes and instead of writing to chat files (which is
  2004.  
  2005.  
  2006.  
  2007.  
  2008.                                        Page 29
  2009.  
  2010.  
  2011.  
  2012.           GAP Communications                                  Configuration
  2013.  
  2014.  
  2015.  
  2016.  
  2017.           slow and  cumbersome), any characters typed by your callers while
  2018.           chatting will  appear instantly  on the  opposite node screen. In
  2019.           contrast, regular  chat must  constantly read  and write  to chat
  2020.           files and  characters are  not  sent  until  the  caller  presses
  2021.           [Enter].
  2022.  
  2023.           The Default  Color is  the color  that is  displayed  at  various                                     
  2024.           points while a user is on-line:
  2025.  
  2026.                +------------------------------------------------------+
  2027.                   1   -  Blue                9   -  Light Blue               |                                                      |
  2028.                   2   -  Green              10   -  Light Green               |                                                      |
  2029.                   3   -  Cyan               11   -  Light Cyan               |                                                      |
  2030.                   4   -  Red                12   -  Light Red               |                                                      |
  2031.                   5   -  Magenta            13   -  Light Magenta               |                                                      |
  2032.                   6   -  Brown              14   -  Yellow               |                                                      |
  2033.                   7   -  Light Grey         15   -  White               |                                                      |
  2034.                +------------------------------------------------------+
  2035.  
  2036.           Note that  8 will  result in  a non  display  condition  on  some
  2037.           monitors.
  2038.  
  2039.           Blank Monitor  After allows  you to specify the number of minutes
  2040.           to wait before blanking the Call Waiting Screen.
  2041.  
  2042.           If you would like for the Main Board messages to be echoable, set
  2043.           the Echo  Main Board  Msgs field  to Yes.  Note that  it  is  not
  2044.           recommended that  you echo  the Main  Board messages  since their
  2045.           topic is  generally of  a local  nature. This feature is provided
  2046.           for those boards that have remote nodes attached to them.
  2047.  
  2048.           The Maximum  Number Of  Messages is  the total number of messages                                  
  2049.           that will  be allowed in any one message file. If a user tries to
  2050.           enter a  message when  the  message  file  already  contains  the
  2051.           maximum number  of messages, the user will be displayed a message
  2052.           saying that the Message File Is Full, and the message will not be
  2053.           allowed.
  2054.  
  2055.           The Maximum  Number Of Message Lines is the total number of lines
  2056.           that will  be allowed  per message. Note that GAP may adjust this
  2057.           limit depending  on how much free memory is available at the time
  2058.           of entering a message.
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.                                        Page 30
  2067.  
  2068.  
  2069.  
  2070.           GAP Communications                                  Configuration
  2071.  
  2072.  
  2073.  
  2074.  
  2075.           Users may  address a  single message to up to 99 different people
  2076.           providing the  message is  private  and  the  Allow  Carbon  Copy
  2077.           Messages flag is set to Yes.
  2078.  
  2079.           If the  Validate Messages  field is set to Yes a user will not be                  
  2080.           allowed to  leave a  message to anyone who is not a member of the
  2081.           BBS.
  2082.  
  2083.           If you do not wish to allow ANSI color graphics in a message, set                                           
  2084.           the  Allow   Non  ASCII   Characters  field  to  No.  If  a  user
  2085.           subsequently tries  to enter  an ANSI message, GAP will strip all
  2086.           the ANSI codes from the message and the resultant message will be
  2087.           quite unsightly.
  2088.  
  2089.           If you  do not  wish to  allow users  to delete messages, set the
  2090.           Allow Deleting Of Messages field to No.
  2091.  
  2092.           You have  the option  to force all main board mail to be private.
  2093.           To do so, set the Make All Mail Private field to Yes.
  2094.  
  2095.           While replying  to a message, it is possible to quote all or part
  2096.           of the  message being  replied to.  The Message Quote Char allows                                                          
  2097.           you to specify the quote characters that will appear at the start
  2098.           of each  line that contains the quoted text. GAP will add a space
  2099.           after the  quote characters.  If you  enter an  I  as  the  first
  2100.           character in  the quote  field, GAP  will use the initials of the
  2101.           person you  are quoting as the quote characters. If you enter a G
  2102.           as the  first character in the quote field, GAP will surround the
  2103.           quoted text  with a  graphic box.  The top border of the box will
  2104.           contain the  name of  the person that is being quoted. Leave this
  2105.           field blank if you wish to disable quoting altogether.
  2106.  
  2107.           You may give time credits for Entering Messages. If you enter a 0
  2108.           in the  Extend Time  By Factor  field, your callers will actually
  2109.           loose time  while entering  messages.  If  you  enter  any  other                                      
  2110.           number, then  GAP will  multiply the time used to enter a message
  2111.           by the  factor you  enter here,  and credit  the caller with that
  2112.           time.
  2113.  
  2114.           If you  wish for the news file to be displayed to callers only if
  2115.           it is  new, set  the Show News Only If New field to Yes. The news
  2116.           file will always be shown to new users.
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.                                        Page 31
  2125.  
  2126.  
  2127.  
  2128.           GAP Communications                                  Configuration
  2129.  
  2130.  
  2131.  
  2132.  
  2133.           You can  set the maximum amount of time a user may be idle at the
  2134.           keyboard. Enter  the number  of  minutes  of  idle  time  in  the
  2135.           Keyboard Time-out field.
  2136.  
  2137.           The AnsiCmd  Character is  the single  character that  is used to              
  2138.           precede the special commands that GAP processes in text files. We
  2139.           suggest that  you use  the AT  character  '@'.  If  you  need  to
  2140.           actually use the AnsiCmd character in your files, then use two of
  2141.           them. For  instance, if  your Ansicmd is '@', and you wish to use
  2142.           an '@' in your text, then you would use @@.
  2143.  
  2144.           Miscellaneous Information - Three
  2145.  
  2146.           ARTWORK
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.           Number Of  Forums Available  is where you specify how many Forums
  2163.           you would like to have. Enter the total number of Forums you wish
  2164.           to configure.  This number  should represent the number of Forums
  2165.           you intend  to set  up at this time. Do not enter a number higher
  2166.           than the number you plan to run since all Forums must be properly
  2167.           configured and  you will not be allowed to exit the configuration
  2168.           program until are Forums are configured.
  2169.  
  2170.           You may configure GAP to run in a Local Area Network Environment.                                                       
  2171.           As such,  you will  not want  your "local" users to perform Sysop
  2172.           Functions by  using the  Sysop Keys  that are available only from
  2173.           the local  keyboard. If  you set  Disable Local Sysop Keys to Yes
  2174.           then your  local users  will not  be able  to perform  any  Sysop
  2175.           Functions that are activated from the local keyboard.
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.                                        Page 32
  2183.  
  2184.  
  2185.  
  2186.           GAP Communications                                  Configuration
  2187.  
  2188.  
  2189.  
  2190.  
  2191.           GAP any  many of  its external programs have the ability to shell
  2192.           to DOS or run other programs while at the same time "remembering"
  2193.           the exact point in the program where it was prior to the shell.
  2194.  
  2195.           When you  return from  DOS or another program, the screen will be
  2196.           restored exactly like it was and you will be returned to the same
  2197.           place in the program.
  2198.  
  2199.           In order  to accomplish  this, GAP will "move" itself from active
  2200.           memory to  either EMS  or a  disk file. At the same time, all the                            
  2201.           memory GAP  occupied (with  the exception  of about  8k) will  be
  2202.           freed, leaving  you with just about the same amount of memory you
  2203.           had prior to running GAP.
  2204.  
  2205.           The Use  EMS For  Swap field is provided so that you may prohibit
  2206.           GAP and its other programs from using EMS. If you do not have EMS                                                               
  2207.           memory, you  do not  need to  set this  flag as it cannot be used
  2208.           anyway. If  you have  EMS memory,  the only reason you would ever
  2209.           want to set this flag to No is if, during a DOS shell, you intend
  2210.           to run  a program  which is  not well behaved and which allocates
  2211.           EMS for itself in non-standard ways.
  2212.  
  2213.           In general, you should set this flag to Yes. You should set aside
  2214.           (that is,  not use)  at least  400k of EMS for use by GAP and its
  2215.           utility programs.
  2216.  
  2217.           The Swap Drive If EMS Unavailable field allows you to specify the
  2218.           drive GAP  should use  to  swap  to  should  EMS  memory  not  be
  2219.           available. This  field should  be left  blank  unless,  for  some
  2220.           reason, swapping to the default drive is not acceptable.
  2221.  
  2222.           If you  enter Yes  in the  Use COMMAND.COM for F5 Shell, GAP will
  2223.           remain in  memory while  you are  in a  DOS shell. Otherwise, GAP
  2224.           will use  EMS to  swap itself  out, thereby  freeing up  as  much
  2225.           memory as possible.
  2226.  
  2227.           While in  an F5  shell that  uses COMMAND.COM,  some programs may
  2228.           lock up the computer if GAP protects the status line. If you wish
  2229.           to prevent  GAP from  protecting the  status line while in such a
  2230.           shell, set the Disable Status During Shell to Yes. Note that this
  2231.           has no  effect if EMS memory is being used instead of COMMAND.COM
  2232.           since the status line will be removed anyway.
  2233.  
  2234.           When a  caller logs  on, GAP tries to determine if the caller has
  2235.           ANSI terminal  emulation turned  on. This  can be  either a quick
  2236.  
  2237.  
  2238.  
  2239.  
  2240.                                        Page 33
  2241.  
  2242.  
  2243.  
  2244.           GAP Communications                                  Configuration
  2245.  
  2246.  
  2247.  
  2248.  
  2249.           process or  a slow one, depending upon your modem or the caller's
  2250.           communications program.  Seconds To Wait For Auto ANSI allows you
  2251.           to set  the number of seconds GAP waits after it sends the proper
  2252.           ANSI sequences  and then  interrogates the  modem for  a reply. 4
  2253.           seconds should  be the  minimum number  of seconds  to  wait.  To
  2254.           disable this feature, set this field to 0.
  2255.  
  2256.           If an  event is scheduled, GAP will set a timer that expires when
  2257.           the event  time occurs. There are times, such as when there are a
  2258.           lot of  errors during  downloading  or  uploading,  that  a  file
  2259.           transfer could  overrun an  Event Time. You can tell GAP to abort
  2260.           the transfer  if this  situation occurs  by answering  Yes in the
  2261.           Stop Xfers If Event Timer Expires field.
  2262.  
  2263.           You may  set the  Upload Guard  Time and  the Door  Guard Time in                            
  2264.           which GAP  will prevent  any uploads or door openings prior to an
  2265.           event. 30  minutes for  the Upload  Guard Time and 15 minutes for
  2266.           the Door  Guard Time  have proven  to be  successful  in  keeping
  2267.           events from being missed.
  2268.  
  2269.           GAP can  display a unique file intended for a specific user only.
  2270.           Its name  is derived  from the name of the User you want the file
  2271.           shown to.  Because the  file names  are based upon User Names and
  2272.           there is  a possibility  that some  of these  files may duplicate
  2273.           some of  your MAIN  files, these  files need  to be  placed in  a
  2274.           directory called  USERINFO which  should be  created off the MAIN                            
  2275.           directory:
  2276.  
  2277.                               +------------------------+
  2278.                                  C:\GAP\MAIN\USERINFO                              |                        |
  2279.                               +------------------------+
  2280.  
  2281.           The names  of these  files are  derived  by  using  the  first  5
  2282.           characters of  the User's  Last Name,  and the first character of
  2283.           the User's  First Name.  If the User doesn't have 5 characters in
  2284.           his/her last name, then you would use the entire Last Name:
  2285.  
  2286.                     +--------------------------------------------+
  2287.                                              File to Create                    |                                            |
  2288.                     |--------------------------------------------|
  2289.                        User Name            Mono        ANSI                    |                                            |
  2290.                     |--------------------------------------------|
  2291.                        DARIN MAY            MAYD        MAYDG                    |                                            |
  2292.                        KENNY GARDNER        GARDNK      GARDNKG                    |                                            |
  2293.                     +--------------------------------------------+
  2294.  
  2295.  
  2296.  
  2297.  
  2298.                                        Page 34
  2299.  
  2300.  
  2301.  
  2302.           GAP Communications                                  Configuration
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.           GAP will  show the User Specific File after the Security News and
  2309.           Birthday file.
  2310.  
  2311.           If you would like to have these user specific files deleted after
  2312.           they are  shown to  the user, set the Delete User Info File After
  2313.           Shown field to Yes.
  2314.  
  2315.           A special  User Info  file called  ALL will  be displayed  to all
  2316.           users (if  it exists) and will not be deleted even if you set the
  2317.           above field  to Yes.  This file  will be shown (to all except the
  2318.           sysop) even  if a  caller uses the Override Command at logon (the
  2319.           regular User  Info files  are not  displayed if a caller uses the
  2320.           Override Command).
  2321.  
  2322.           If you  set Show  Loose Downloads  In GAPCALL BLT to No, then any
  2323.           files downloaded  from one  of your  Loose Directories  will  not
  2324.           appear in the Download Bulletin created by GAPCALL.                                 
  2325.  
  2326.  
  2327.           Subscription Configuration
  2328.  
  2329.           ARTWORK
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.           If you are running a closed board, set the Closed Board option to
  2346.           Yes. A  closed board  is a  board in  which users will be allowed
  2347.           access only  if the Private User Flag (in the user record) is set                 
  2348.           to Yes.  If the  file NEWQUEST  is present in the MAIN directory,
  2349.           new users will be asked to fill it out before being disconnected.
  2350.           If you  run multi-nodes  where some  users may  be members  of  a
  2351.           closed node  and some  may not,  you should  create a file called
  2352.  
  2353.  
  2354.  
  2355.  
  2356.                                        Page 35
  2357.  
  2358.  
  2359.  
  2360.           GAP Communications                                  Configuration
  2361.  
  2362.  
  2363.  
  2364.  
  2365.           CLOSED and place the file in your GEN directory. Registered users
  2366.           who are  not members  of the  closed node will be shown this file
  2367.           prior to being disconnected.
  2368.  
  2369.           Even if your board is closed, GAP will still enter new users into
  2370.           the User  File. This makes it easy for you make the user a member
  2371.           of your  closed board since all you have to do is set the Private
  2372.           User Flag for that user.
  2373.  
  2374.           Enforce Subscription,  if set  to Yes, will cause all users whose
  2375.           subscription date  has expired to assume the Expired Subscription                                                       
  2376.           Level as  set up  in their  user record.  In addition,  GAP  will
  2377.           remove the  user from any private Forums, if the user's record is
  2378.           so flagged.
  2379.  
  2380.           Days In  Subscrip Period is the length of the subscription period
  2381.           (7 to  365 days).  You need to set this field even if you are not
  2382.           using the subscription feature since GAP uses it when registering
  2383.           new users.
  2384.  
  2385.           If the  subscription period  is less  than  14  days,  then  your
  2386.           callers will  receive no warning that their subscription is about
  2387.           to expire. If the subscription period is greater than 14 days but
  2388.           less than  30, then  GAP will begin issuing warnings to callers 5
  2389.           days prior  to  the  date  their  subscription  expires.  If  the
  2390.           subscription period  is greater  than 30  days but  less than 60,
  2391.           then GAP  will begin issuing warnings to callers 10 days prior to
  2392.           the date  their subscription  expires. The  warn time for periods
  2393.           greater than  60 days  is 30  days. When  the user's subscription
  2394.           date approaches  within the  warn time, a file called EXPIRE will
  2395.           be shown  to the user each time he/she logs on. This file goes in
  2396.           the GEN  directory and  it should  inform the  users  that  their
  2397.           subscription is about to expire and tell them what they should do
  2398.           to extend their subscription.
  2399.  
  2400.           When a  user logs  on and  his/her subscription  date is past the
  2401.           current date,  the user  will be  given the  Expired Subscription
  2402.           Level as  set up in the user's record. In addition, if the user's
  2403.           record so  specifies, GAP  will remove  the user from any private
  2404.           Forums. At this point, the EXPIRE file will no longer be shown to
  2405.           the user.  It  is  advisable  to  create  a  security  news  file                                                       
  2406.           representing your expired security level to inform the users that
  2407.           they are  at the  expired level  and will remain there until they
  2408.           rectify the subscription issue.
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.                                        Page 36
  2415.  
  2416.  
  2417.  
  2418.           GAP Communications                                  Configuration
  2419.  
  2420.  
  2421.  
  2422.  
  2423.           The Expired  Subscription Level is the default level that will be
  2424.           given to  new users  when they register. Each user may be given a
  2425.           different Expired Level.
  2426.  
  2427.           You may  also specify  an  Exempt  Security  Level  From  Expired
  2428.           Subscription. If  a user  is at  or above  this level and his/her
  2429.           subscription date  expires, the  user will not be set back to the
  2430.           Expired Security Level and public Forums.
  2431.  
  2432.           If you  do not want an expired user to gain access to any private
  2433.           nodes you  may have  set up,  you should  enter Yes  in  the  Set
  2434.           Private User Flag Back To No field.
  2435.  
  2436.  
  2437.           File System Options
  2438.  
  2439.           ARTWORK
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.           Number  of   Directories  is   the  number  of  Main  Board  File
  2456.           Directories you would like to have.
  2457.  
  2458.           If Enforce Download Count is set to Yes, users will be limited to
  2459.           the maximum  number of  files you  specified in  SECLEV for their
  2460.           security level per day.
  2461.  
  2462.           If the  Enforce Byte  Count is  set to  Yes, users  will  not  be
  2463.           allowed to  download any files on any particular day if they have
  2464.           already used  up their  allotted count.  They must wait until the
  2465.           following day  before they will be allowed to download any files.
  2466.           The number  of bytes  they are  allowed to  download  during  any
  2467.           single day is set up in the SECLEV file.
  2468.  
  2469.  
  2470.  
  2471.  
  2472.                                        Page 37
  2473.  
  2474.  
  2475.  
  2476.           GAP Communications                                  Configuration
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.           If Extend  Download Count  is set  to Yes,  then for  every  file
  2483.           callers  upload,  their  maximum  number  of  download  files  is
  2484.           increased by  1. However,  the callers  will  never  be  able  to
  2485.           download more  files than  the maximum  number of files set up in
  2486.           SECLEV for  their security level. Basically this is a one for one
  2487.           upload/download credit.  A caveat  is that  the uploads must come
  2488.           first!
  2489.  
  2490.           Extend Upload  Time By  Factor allows you to specify a multiplier                 
  2491.           that will be used to give back the time spent uploading. GAP will
  2492.           multiply the  time it  took to  upload a  file by this factor and
  2493.           credit the  caller with  that time.  Note that  if you enter 0 in
  2494.           this field, the caller will actually loose time.
  2495.  
  2496.           Enforce Up/Down  Ratio and  Ratio By  Bytes Or Files allow you to
  2497.           enforce upload/download  ratios. By  Files means the callers must
  2498.           maintain the ratio specified in SECLEV or GAP will not allow them
  2499.           to download  any files. If you specify by Bytes, the callers must
  2500.           maintain the  ratio specified,  however, the  number entered into
  2501.           SECLEV is  the number  of k-bytes  that must  be maintained. If a
  2502.           caller attempts  to download  a file and his/her ratio is greater
  2503.           than the  ratio set  up for the specific security level, GAP will
  2504.           display a  file called RATIO and will not allow the download. The
  2505.           RATIO file  should explain  to the callers why they are unable to
  2506.           download and  what they  must do  to regain  download privileges.
  2507.           There may  be a  color version  of the  file, and of course, this                           
  2508.           would be a perfect place to use the Ansicmds.
  2509.  
  2510.           The format  of the  SECLEV file  is explained  in detail  in  the
  2511.           chapter System Files.
  2512.  
  2513.           If Make  All Uploads  Private is  set to Yes, all uploads will be
  2514.           given the  Level For  Private Uploads.  This allows  the sysop to                     
  2515.           review  any   uploads  prior   to  making   them  available   for
  2516.           downloading.
  2517.  
  2518.           Future versions  of GAP  will allow  users to specify the subject
  2519.           they wish  to have  their uploads  placed.  The  Allow  Directory
  2520.           Uploads is currently ignored.
  2521.  
  2522.           The Minimum  Free Upload  Space is  the amount of free space that
  2523.           must be  left on the hard drive before GAP will accept an upload.
  2524.           You enter the number of k-bytes in this field.
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.                                        Page 38
  2531.  
  2532.  
  2533.  
  2534.           GAP Communications                                  Configuration
  2535.  
  2536.  
  2537.  
  2538.  
  2539.           If the Show Free Upload Space is set to Yes, GAP will display the
  2540.           free upload space to the caller on the file transfer screen.
  2541.  
  2542.           The Default  Filename Extension  is the  extension GAP  will  use
  2543.           whenever a  caller is  prompted for a filename and does not enter
  2544.           an extension to the name.
  2545.  
  2546.           You may  install up  to 20  External Protocols. To activate them,
  2547.           enter Yes  in the  Use External  Protocols field  and in  the Ext
  2548.           Protocol File  Name field,  type in  the name  of the file (which
  2549.           will reside  in your  GEN  directory)  that  holds  the  external
  2550.           protocol information.  You may  edit this  file by  selecting Ext                                                                        
  2551.           Protocols from the Files Menu.
  2552.  
  2553.           Please see the chapter External Protocols for more information on
  2554.           how to configure external protocols.
  2555.  
  2556.           Check For  Dupes Across Areas tells GAP to search all areas for a                                                            
  2557.           duplicate file  during an  upload. Using  this option,  if a file
  2558.           about to  be uploaded  exists anywhere  in the FileBase, then GAP
  2559.           will not allow the upload.
  2560.  
  2561.           The Security Level For Uploads is the level GAP gives to uploaded
  2562.           files. It  is also  the default level used in the FileBase editor
  2563.           when new files are added.
  2564.  
  2565.           The Level  For Private Uploads is the level GAP gives to uploaded
  2566.           files that the user has elected to make private.
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.                                        Page 39
  2589.  
  2590.  
  2591.  
  2592.           GAP Communications                                  Configuration
  2593.  
  2594.  
  2595.  
  2596.  
  2597.           Events
  2598.  
  2599.           ARTWORK
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.           GAP allows  for 24  timed events.  Events are  external  programs
  2616.           and/or batch  files that  you may  run at pre-determined days and
  2617.           times.
  2618.  
  2619.           Please see the chapter Events for further information.                                 
  2620.  
  2621.  
  2622.           Strings and Prompts
  2623.  
  2624.           ARTWORK
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.           The Additional  Board Name  is any  text that  you wish  to  have
  2641.           displayed after your BBS name.
  2642.  
  2643.  
  2644.  
  2645.  
  2646.                                        Page 40
  2647.  
  2648.  
  2649.  
  2650.           GAP Communications                                  Configuration
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.           The Comment  Prompt is displayed to the user when he/she attempts              
  2657.           to leave a comment.
  2658.  
  2659.           The Twit  String is  displayed to the user when the sysop presses
  2660.           the F8 (TWIT) key to log a user off.
  2661.  
  2662.           The Lockout  String is  displayed to  the  user  when  the  sysop
  2663.           presses the  F2 (LOCKOUT)  key to  lock a  user out  and  to  log
  2664.           him/her off.  Note that  when pressing  the LOCKOUT  key, if  you
  2665.           actually intend  to lock  the user  out, you  will be prompted to
  2666.           press the key again.
  2667.  
  2668.           There are  3 combinations  for the  COMMENT,  TWIT,  and  LOCKOUT
  2669.           strings. If  TWIT and  COMMENT are  empty, then  nothing will  be
  2670.           displayed to  the user.  If the LOCKOUT string is empty, then the
  2671.           user will be displayed a standard prompt generated by GAP. If the
  2672.           strings do  contain information,  then whatever they contain will
  2673.           be displayed.
  2674.  
  2675.           If any  of these  3 strings starts with a '?' then a file will be
  2676.           displayed to  the user.  The file names are called, respectively,
  2677.           COMMENT, TWIT,  and LOCKOUT  and they  are  located  in  the  GEN
  2678.           directory. Of  course, as  with any GAP file, they may have a 'G'
  2679.           appended to them for color displays.
  2680.  
  2681.           Any user  locked out  by the  LOCKOUT key  will be  placed in the
  2682.           Trash Can.
  2683.  
  2684.           If a  ? is  used in  the COMMENT  field, you  must still  enter a
  2685.           comment prompt  after the ?. The reason for this is that GAP will
  2686.           show the  file, but  it will  also need a prompt to display after
  2687.           showing it.
  2688.  
  2689.           The lockout text file will also be displayed to a locked out user
  2690.           trying to log on (if it exists).
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.                                        Page 41
  2705.  
  2706.  
  2707.  
  2708.           GAP Communications                                  Configuration
  2709.  
  2710.  
  2711.  
  2712.  
  2713.           Function Key Macros
  2714.  
  2715.           ARTWORK
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.           The  Shift  Function  Keys  may  be  programmed  to  display  any
  2732.           information you like.
  2733.  
  2734.           They are  active only  during certain times (i.e., during message
  2735.           entry or while chatting with a user.
  2736.  
  2737.           You may  use the  '{' character  as much as you like for a single
  2738.           function key.  For instance,  you can program one function key to
  2739.           display as many separate lines of information as you can fit into
  2740.           the space allocated.
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.                                        Page 42
  2763.  
  2764.  
  2765.  
  2766.           GAP Communications                                  Configuration
  2767.  
  2768.  
  2769.  
  2770.  
  2771.           Forum Configuration
  2772.  
  2773.           ARTWORK
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.           For each  of your  Forums, there  will be  a Forum  configuration
  2790.           screen.
  2791.  
  2792.           Forum Name  - This is the name that GAP will display to the users
  2793.           at various points while they are in the Forum.
  2794.  
  2795.           Forum Directory  Path -  This is  the drive and path to the Forum
  2796.           DEFAULT directory. The MSGS.DAT and MSGS.IDX will be placed here.
  2797.  
  2798.           Gen Directory  Path - This is the drive and path to the Forum GEN                                                                  
  2799.           directory. If the Forum uses its own specific menus, they must be
  2800.           placed here.  This path can be set equal to the DEFAULT directory
  2801.           path. See  the file layout chart for more information as to which
  2802.           files go in this directory.
  2803.  
  2804.           Upload Directory  Path -  This is the drive and path to the Forum
  2805.           UPLOAD directory.  If the  Keep Uploads Inside flag is set to Yes                                     
  2806.           and a  user uploads  a file while inside the Forum, the file will
  2807.           be placed in this directory.
  2808.  
  2809.           Name of  Messages File  -This is  the base  name of the file that                   
  2810.           contains  your  Forum  messages.  It  will  always  have  a  .DAT
  2811.           extension and  will be accompanied by an index file with the same
  2812.           base name, but with a .IDX extension.
  2813.  
  2814.           Subscription Date - It is possible for you to rent out a Forum to
  2815.           outside parties  to run  as they see fit. You may set a date that
  2816.  
  2817.  
  2818.  
  2819.  
  2820.                                        Page 43
  2821.  
  2822.  
  2823.  
  2824.           GAP Communications                                  Configuration
  2825.  
  2826.  
  2827.  
  2828.  
  2829.           the Forum will expire. When that date arrives, no user except the
  2830.           sysop will  be allowed  to enter the Forum. If you do not wish to
  2831.           use this  feature, be  sure  to  set  the  Subscription  Date  to
  2832.           01/01/01.
  2833.  
  2834.           Public Forum  - and  Level To  Join -  If this  Forum is a Public
  2835.           Forum, then set the Public Forum field to Yes and in the Level To                                                                   
  2836.           Join field,  enter the  security level  that a  user will need in
  2837.           order for the user to join the Forum.
  2838.  
  2839.           If the  Forum is Private, enter No in the Public Forum field. The
  2840.           only way  for a  user to  join a  Private Forum  is if  the Sysop
  2841.           manually adds the user to the Forum Membership record.
  2842.  
  2843.           Forum Sysop Level and Forum Assistant Level - Each Forum may have
  2844.           its own set of sysops and assistant sysops. You declare a user to
  2845.           be a  sysop or assistant sysop of a Forum in the User Editor. The
  2846.           security level  that is defined here is the actual level you want
  2847.           the user  to have  when he/she  joins the  Forum. It  is  not  an
  2848.           additional level,  but the exact level. If the Forum is set up to
  2849.           give additional  security, the Forum sysops will not be given the
  2850.           additional security.
  2851.  
  2852.           Additional Security  - If  you wish to increase a user's security
  2853.           level while he/she is in the Forum, enter the additional level to
  2854.           add to  the user's  normal level  here. You  may enter a negative
  2855.           number if you wish.
  2856.  
  2857.           Additional Time  - If you wish to grant your users any additional
  2858.           time while  they are in the Forum, enter the number of minutes to
  2859.           add to  their time  here. If  you wish to decrease the time left,
  2860.           enter a  negative number.  Note  that  a  user  will  be  granted
  2861.           additional  time  once  only.  Also,  they  will  not  loose  the
  2862.           additional time when they abandon the Forum.
  2863.  
  2864.           Level For  Pub Uploads  - This is the security level that will be
  2865.           given to public uploads that are kept in the Forum.
  2866.  
  2867.           Level For  Priv Uploads - This is the security level that will be
  2868.           given to private uploads that are kept in the Forum.
  2869.  
  2870.           Level To  Read Priv  Mail -  This is the security level needed to
  2871.           read the Forum's Private Messages.                                   
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.                                        Page 44
  2879.  
  2880.  
  2881.  
  2882.           GAP Communications                                  Configuration
  2883.  
  2884.  
  2885.  
  2886.  
  2887.           Level To  Read Comments - This is the security level need to read
  2888.           any Comments that are left in the Forum.
  2889.  
  2890.           Number Of  Directories -  If the  Forum is to have any additional                     
  2891.           file directories,  enter the  number  of  additional  directories
  2892.           here. Note  that the  Forum upload  directory will be the highest
  2893.           directory number.
  2894.  
  2895.           Example: If the main board has 10 directories and the Forum has 2
  2896.           additional directories, while a user is in this Forum, there will
  2897.           be a  total of  12 directories. Subject 11 will be the main board
  2898.           upload directory  and subject  12  will  be  the  Forum's  upload
  2899.           directory.
  2900.  
  2901.           Include Main  Board Dirs  - If  set to  No, the Forum directories
  2902.           will be completely isolated from the main board directories. This
  2903.           means the  main board  directories will  not be  available  while
  2904.           inside the Forum. Instead of starting with the highest main board
  2905.           directory plus one, the Forum directories will start at 1.
  2906.  
  2907.           Private Uploads - If you want all the Forum uploads to be private
  2908.           (as in the main board) set this flag to Yes.
  2909.  
  2910.           Keep Uploads  Inside -  If you  want all  the Forum uploads to be
  2911.           kept in  the Forum  upload  directory,  set  this  flag  to  Yes.
  2912.           Otherwise, the  user will be asked if he/she wishes the upload to
  2913.           stay in  the Forum.  If the  user answers Yes, the upload will be
  2914.           kept in  the Forum  upload directory. If the user answers No, the
  2915.           upload will be placed in the main board upload directory.
  2916.  
  2917.           Number Of  Bulletins -  If the  Forum is  to have  its own set of
  2918.           bulletins, enter  the total number here. Don't forget to create a
  2919.           BLT Menu  file to  list the  bulletins and  place it  in the  GEN
  2920.           directory.
  2921.  
  2922.           Message  Quote  Chars  -  Each  Forum  may  have  its  own  Quote
  2923.           Characters or disable quoting altogether.
  2924.  
  2925.           Maximum Lines  Per Message  - is  the total  number of lines that
  2926.           will be  allowed per message. Note that GAP may adjust this limit
  2927.           depending on  how much  free memory  is available  at the time of
  2928.           entering a message.
  2929.  
  2930.           Extend Msg Time By Factor - You may give time credits for leaving
  2931.           messages (not  comments). To  do so,  set this  field to a number
  2932.  
  2933.  
  2934.  
  2935.  
  2936.                                        Page 45
  2937.  
  2938.  
  2939.  
  2940.           GAP Communications                                  Configuration
  2941.  
  2942.  
  2943.  
  2944.  
  2945.           from 1  to 9.  After entering  a message  and saving it, GAP will
  2946.           multiply the  amount of  time it took to enter the message by the
  2947.           factor you  enter here.  A factor  of 1 means the caller will not
  2948.           loose any  time. Note  that if  you enter a 0 here, a caller will
  2949.           not be  given any time credits and will actually loose time while
  2950.           entering the message.
  2951.  
  2952.           Allow Carbon Copy Msgs - Private messages may be sent to up to 99
  2953.           users if this field is set to Yes.
  2954.  
  2955.           Validate Messages  To - If you want GAP to check the user file to                   
  2956.           see if  the person  to whom  a message is being left is an actual
  2957.           user of  the BBS,  set this  field to  Yes. Note  that Echo  Mail                                                                 
  2958.           Forums and  Forums that  allow Handles  can not take advantage of
  2959.           this feature  and it  will automatically  be  disabled  in  those
  2960.           Forums.
  2961.  
  2962.           Allow Esc  Codes In Msgs - Callers will often times "upload" ANSI
  2963.           text files  into their  messages. This  is  fine  if  the  person                                  
  2964.           reading the  message has ANSI color enabled, but callers with B&W
  2965.           monitors will  see nothing  but garbage.  If you  wish to prevent
  2966.           callers from  entering ANSI  escape sequences  in their messages,
  2967.           set this field to No.
  2968.  
  2969.           Allow Deleting  Of Msgs  - You  can prevent callers from deleting
  2970.           their messages  by setting  this field to No. Veteran sysops will
  2971.           tell you the tale of the caller who logged on one day and deleted
  2972.           all the  messages to and from him, simply because of a bad day at
  2973.           the office or school. If this occurs in a Forum that depends upon
  2974.           the  exchange  of  ideas  between  callers,  this  could  have  a
  2975.           devastating effect  on the  Forum atmosphere,  not to mention the
  2976.           time and  energy taken  from the sysop in trying to restore those
  2977.           messages.
  2978.  
  2979.           Make All  Mail Private  - If  you want  all the  messages  to  be
  2980.           private, set this flag to Yes.
  2981.  
  2982.           Make All  Mail Public - If you want all the messages to be public
  2983.           (with the exception of comments), set this flag to Yes. Note that
  2984.           the sysop can override this setting and leave private mail.
  2985.  
  2986.           The above  two flags  are mutually exclusive. You cannot set them
  2987.           both to Yes.
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.                                        Page 46
  2995.  
  2996.  
  2997.  
  2998.           GAP Communications                                  Configuration
  2999.  
  3000.  
  3001.  
  3002.  
  3003.           Comments To  Main Board  - If  you want  all  Comments  that  are
  3004.           entered while  a user  is inside  of this Forum to be sent to the
  3005.           Main Board, set this field to Yes.
  3006.  
  3007.           Show News  Only If  New - If you want the News to be displayed to
  3008.           callers only  if it  is new, set this field to Yes. The News will
  3009.           always be shown to new users.
  3010.  
  3011.           Auto Rejoin  Forum -  If this field is set to Yes and a user logs
  3012.           off from  inside the  Forum, he/she  will automatically  join the
  3013.           Forum on the next call.
  3014.  
  3015.           Days In  Subscrip Period  - If this Forum is Private and you wish
  3016.           to make  it a Subscription Forum, enter the number of days in the                        
  3017.           Subscription Period.  Your subscription  period can be any number
  3018.           of days  from 7  to 365.  If you  do not wish to make the Forum a
  3019.           subscription Forum, leave this field set to 0.
  3020.  
  3021.           Del Member  When Expired  - If this Forum is a Subscription Forum                           
  3022.           and a  user's subscription  has expired, GAP will remove the user
  3023.           from the  Forum by  deleting his/her Member Record (the user will
  3024.           then not  be allowed to join until the Sysop adds the user to the
  3025.           Forum's Membership).  If you  do not  want GAP  to  automatically
  3026.           remove the user from the Forum, answer No in this field.
  3027.  
  3028.           Allow Handles - If this Forum utilizes handles, enter Yes in this                
  3029.           field. While  in a  Forum that allows handles, a user's name will
  3030.           change to their handle.
  3031.  
  3032.           Net Mail  Forum -  If you  want the  messages in  a Forum  to  be                                               
  3033.           utilized in  an Echo  Mail system, set this flag to Yes. GAP will
  3034.           ask a caller if a particular message should be echoed or not.
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.                                        Page 47
  3053.  
  3054.  
  3055.  
  3056.           GAP Communications                                  Configuration
  3057.  
  3058.  
  3059.  
  3060.  
  3061.           +----------------------------------------------------------------+
  3062.            In order  to activate  file directories  inside of a Forum, you          |                                                                |
  3063.            will need  a DIR  file in the Forum GEN directory. The presence          |                                                                |
  3064.            of this file tells GAP that the files system is available while          |                                                                |
  3065.            a caller  is inside  the Forum.  If the  file is  missing,  the          |                                                                |
  3066.            caller will  be told  that the  Forum has  no file directories.          |                                                                |
  3067.           |                                                                |
  3068.            Any time  you wish to add new Forums, it is imperative that you          |                                                                |
  3069.            add the  new Forums  to the end of the list. In other words, if          |                                                                |
  3070.            you have  5 Forums  and you wish to add a 6th, you must add the          |                                                                |
  3071.            6th Forum in the 6th slot! You must not attempt to insert a new          |                                                                |
  3072.            Forum in  the middle  of a  set of existing ones. Doing so will          |                                                                |
  3073.            render your Forum message bases useless.          |                                                                |
  3074.           +----------------------------------------------------------------+
  3075.  
  3076.           There are a lot of configuration possibilities with the Forums. A
  3077.           Forum can  be set up to have no Files System whatsoever or it can
  3078.           be set  up to  simply use the main board file directories with no
  3079.           additional file  directories of  its own;  or it can be set up to
  3080.           use  the   main  board   file  directories  along  with  its  own
  3081.           directories which  can be  seen  only  while  in  the  Forum.  In
  3082.           addition, there  are combinations  of private/public  uploads  as
  3083.           well as the ability to keep all uploads in the Forum.
  3084.  
  3085.           Note that  it is not necessary to have a Forum GEN directory. All
  3086.           files can be placed in the Forum DEFAULT directory if you prefer.
  3087.           The GEN  directory field  was provided  so that you may use a ram
  3088.           disk for the static files.
  3089.  
  3090.  
  3091.           Files Menu Options
  3092.  
  3093.           The Configuration Editor contains a Files Menu that allows you to
  3094.           edit certain system files:
  3095.  
  3096.                                   Files
  3097.                                   +----------------+
  3098.                                     Seclev                                  |                |
  3099.                                     Doors                                  |                |
  3100.                                     Ext Protocols                                  |                |
  3101.                                   +----------------+
  3102.  
  3103.           Seclev allows you to edit your SECLEV file(s). The SECLEV file is
  3104.           the file that assigns Time, Bytes, Files, and other parameters to
  3105.           users with a specific Security Level.
  3106.  
  3107.  
  3108.  
  3109.  
  3110.                                        Page 48
  3111.  
  3112.  
  3113.  
  3114.           GAP Communications                                  Configuration
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.           Doors  allows   you  to  edit  the  data  file(s)  that  contains
  3121.           information about  the external  programs you  have available  on
  3122.           your system.
  3123.  
  3124.           Ext  Protocols   allows  you  to  edit  the  file  that  contains
  3125.           information about the external protocols you have available.
  3126.  
  3127.           These files  are described  in full  detail in the chapter System
  3128.           Files.
  3129.  
  3130.  
  3131.           Sysop Configuration
  3132.  
  3133.           ARTWORK
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.           If you  are configuring  GAP  for  the  first  time,  then  after
  3150.           Quitting (and  saving changes)  you will  be taken  into the User
  3151.           Editor.
  3152.  
  3153.           The sysop is automatically placed as the first record in the user
  3154.           file. You  must   edit that  record and change any fields to suit
  3155.           your own  preference. The first name, last name, and password are
  3156.           the names  you must  enter if you call from remote and wish to be
  3157.           recognized as the sysop. For security reasons, the first and last
  3158.           names should  not be  your real name. GAP will never refer to you
  3159.           by these names, their sole purpose is to get you into the system,
  3160.           as the sysop, from remote.
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.                                        Page 49
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.           Chapter 4
  3179.  
  3180.  
  3181.  
  3182.                                                                System Files
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.           The system  files are  the  files  GAP  needs  in  order  to  run
  3189.           properly. Some  of them  are created  automatically by  the setup
  3190.           program while  others must  be created by the sysop. Most of them
  3191.           are provided as sample files on the distribution diskettes.
  3192.  
  3193.           Any file  which is  displayed to the user, from the time the user
  3194.           logs on  to the  time he/she  logs off,  can have  an ANSI  color
  3195.           equivalent. If  the user  chooses color  at  log  on,  the  color
  3196.           equivalent of  any file  listed here  will be displayed (if it is
  3197.           available) rather  than the  normal ASCII version. Text files are
  3198.           described in detail in the chapter Text Files.
  3199.  
  3200.           Default Directory
  3201.  
  3202.           GAP.BAT -  This file  is the  workhorse  of  the  system.  It  is
  3203.           responsible for  running GAP  as well as making sure that all the
  3204.           individual GAP files function together as one unit.
  3205.  
  3206.                               GAP.BAT
  3207.                               +------------------------+
  3208.                                 @echo off                              |                        |
  3209.                                 c:                              |                        |
  3210.                                 cd \GAP                              |                        |
  3211.                                 gapmenu                              |                        |
  3212.                                 if errorlevel 99 gap                              |                        |
  3213.                               +------------------------+
  3214.  
  3215.           It is  suggested that you leave this file as is. Since GAP always
  3216.           exits to  DOS when it terminates, the last line in the batch file
  3217.           is an  absolute necessity.  When GAP  wants to  recycle, it  will
  3218.           issue an  error level  of 99  to DOS.  The last line insures that
  3219.           GAPMENU will be run.
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.                                        Page 51
  3227.  
  3228.  
  3229.  
  3230.           GAP Communications                                   System Files
  3231.  
  3232.  
  3233.  
  3234.  
  3235.           If you  are running  multiple nodes, you will need a copy of this
  3236.           file in  each of your nodes' DEFAULT directories. The name of the
  3237.           file should be unique for each node and the last line in the file
  3238.           should reflect the changed name.
  3239.  
  3240.           DOOR.BAT -  When a  user selects  OPEN from  the main GAP Command
  3241.           prompt and  opens a valid door, GAP will run the associated batch
  3242.           file. Door  setup and  files are  explained in  more detail  in a
  3243.           later chapter.  The batch file that invokes the door program is a
  3244.           regular DOS batch file:
  3245.  
  3246.                               DOOR.BAT
  3247.                               +------------------------+
  3248.                                 @echo off                              |                        |
  3249.                                 cd\doors                              |                        |
  3250.                                 door                              |                        |
  3251.                                 c:                              |                        |
  3252.                                 cd\gap                              |                        |
  3253.                               +------------------------+
  3254.  
  3255.           DOOR.SYS -  This file  is created  when a  user  enters  a  Door.
  3256.           DOOR.SYS is  a standard door interface which is used by many door
  3257.           authors and other BBS Systems.
  3258.  
  3259.           EVENTx.BAT -  This is  the event batch file which you must create
  3260.           if you wish to run events.
  3261.  
  3262.           EVENTS.DAT -  This file  holds your  event configuration.  It  is
  3263.           maintained by  GAPSETUP. Events  are described  in more detail in
  3264.           the chapter Events.                      
  3265.  
  3266.           EXTRx.BAT
  3267.           EXTSx.BAT
  3268.           These are  the batch  files that  are used  to invoke an external
  3269.           protocol. The  first is for receiving files and the second is for
  3270.           sending files.  The chapter  External Protocols  describes  these                                       
  3271.           files in full detail.
  3272.  
  3273.           FILELST.DWN -  GAP creates  this file  during batch downloads. It                                                        
  3274.           stores vital  information necessary to allow a caller to download
  3275.           as many  files as  the sysop allows. It is used internally by the
  3276.           system although a utility program is provided which allows you to
  3277.           utilize  the   information  contained  within  so  that  external
  3278.           protocol programs  can be  set up  to  provide  batch  transfers.
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.                                        Page 52
  3285.  
  3286.  
  3287.  
  3288.           GAP Communications                                   System Files
  3289.  
  3290.  
  3291.  
  3292.  
  3293.           Please  see   the  chapter   External   Protocols   for   further
  3294.           information.
  3295.  
  3296.           GAP.HLP
  3297.           GAP.NDX
  3298.           These are the Help files used by many of the Utility programs.
  3299.  
  3300.           GAPBBS.CNF -  This is  the configuration  file  for  GAP.  It  is
  3301.           created automatically by the setup program.
  3302.  
  3303.           GAPBBS.EXE -  This is  the main  GAP Communications  program.  It
  3304.           consists of several overlays and as such, if used in a multi-user
  3305.           environment, it  should be  set to  read-only if  your networking
  3306.           system does  not properly  support shared  reading of  files.  An
  3307.           alternative is  to keep  a copy  of  this  file  in  the  DEFAULT
  3308.           directory of each of your nodes.
  3309.  
  3310.           GAPCALL.EXE -  GAP's own Caller Analyzer! It is explained in more
  3311.           detail in the supplementary documentation.
  3312.  
  3313.           GAPFILE.EXE - This is the external FileBase Editor. It is used to
  3314.           maintain your  database of files. Please see the chapter FileBase                                                                   
  3315.           Editor for further information.
  3316.  
  3317.           GAPMENU.EXE - This is the program that directs various functions.
  3318.           It is  responsible  for  answering  the  phone,  running  events,
  3319.           allowing you to configure your system, etc.
  3320.  
  3321.           GAPSETUP.EXE -  This is  the program that allows you to configure
  3322.           your system.
  3323.  
  3324.           GAPUSER.HLP
  3325.           GAPUSER.NDX
  3326.           These are help files for the User Editor.
  3327.  
  3328.           GAPUSER.EXE - This program is the off-line User Editor.
  3329.  
  3330.           GAPREBLD.EXE -  This program rebuilds your Message, User, Member,
  3331.           and Filebase  indexes. It  should be used whenever you receive an
  3332.           Error message  that tells  you to  rebuild your  index files.  In
  3333.           addition, should  you ever encounter a problem with GAP not being
  3334.           able to  find a  user or a message when you know that the user or
  3335.           message exists, this program should be run.
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.                                        Page 53
  3343.  
  3344.  
  3345.  
  3346.           GAP Communications                                   System Files
  3347.  
  3348.  
  3349.  
  3350.  
  3351.           +----------------------------------------------------------------+
  3352.            Indexed Sequential Access Method (ISAM) is a method to retrieve          |                                                                |
  3353.            data records  based on  key  information  stored  inside  index          |                                                                |
  3354.            files.  Compared   to  sequential   searches  it  is  fast  and          |                                                                |
  3355.            efficient. However,  indexes can be touchy and because of their          |                                                                |
  3356.            nature you  are urged  to back up your ISAM data files at least          |                                                                |
  3357.            twice a  week. Using  one of your events would be a perfect way          |                                                                |
  3358.            to insure the integrity of your files.          |                                                                |
  3359.           +----------------------------------------------------------------+
  3360.  
  3361.           You can  invoke GAPREBLD  in a  manner such that it will forcibly
  3362.           rebuild all of your data and index files. To do so, type GAPREBLD
  3363.           F. In addition, if a particular message base is causing problems,
  3364.           you can  delete the  .IDX file for that base and run GAPREBLD. It
  3365.           will rebuild just that index file.
  3366.  
  3367.           GAPPACK.EXE -  Message and  user  files  fill  up  with  outdated
  3368.           information. This  program will  purge those  files  of  unneeded
  3369.           data. It  features a  single pass purge routine for message files
  3370.           wherein messages  can be  stripped of refer to message numbers at                                                
  3371.           the same  time they  are being  purged. It  is also used to purge
  3372.           corrupted records from the ISAM data files.
  3373.  
  3374.           The program may be run from the command line or interactively. To
  3375.           invoke the program, you must supply certain parameters to tell it
  3376.           which file to work with:
  3377.  
  3378.           +-----------------------------------------------------------------+
  3379.            GAPPACK M Area Options                  - Packs a Message file.          |                                                                 |
  3380.            GAPPACK C:\GAP\MAIN\USERS.DAT U Options - Packs the User file.          |                                                                 |
  3381.            GAPPACK C:\GAP\MAIN\FILES.DAT F         - Packs the FileBase.          |                                                                 |
  3382.            GAPPACK C:\GAP\MAIN\MEMBER.DAT R        - Packs the Member file.          |                                                                 |
  3383.           +-----------------------------------------------------------------+
  3384.  
  3385.           To pack a Message file, you pass an 'M' as the first parameter to
  3386.           GAPPACK. The  second parameter is the Message base to pack. It is
  3387.           a number  that tells GAPPACK what Area the message is in, where a
  3388.           0 is  the Main  Board, a  1 is Forum 1, etc. The third and fourth
  3389.           optional parameters are:
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.                                        Page 54
  3401.  
  3402.  
  3403.  
  3404.           GAP Communications                                   System Files
  3405.  
  3406.  
  3407.  
  3408.  
  3409.                Message Base Parameters
  3410.                +------------------------------------------------------+
  3411.                  xxx        Purge any message older than xxx number               |                                                      |
  3412.                             of days.               |                                                      |
  3413.                |                                                      |
  3414.                  Y or N     where Y means to delete private/received               |                                                      |
  3415.                             messages and N means to keep those               |                                                      |
  3416.                             messages.               |                                                      |
  3417.                +------------------------------------------------------+
  3418.  
  3419.           The following  example will  pack the  main board  message  file,
  3420.           deleting any  message older than 120 days and any private message
  3421.           that has been received:
  3422.  
  3423.                GAPPACK M 0 120 Y
  3424.  
  3425.           It is  good practice  to pack  all of your message files at least
  3426.           once a  week. This  keeps the message files clean and removes any
  3427.           deleted messages.
  3428.  
  3429.           To pack  the User  file, you  pass the  full path and name of the
  3430.           User file  as the first parameter. The second parameter is a 'U',
  3431.           which tells  GAPPACK you  are packing  the User  file. The third,
  3432.           fourth, and fifth optional parameters are:
  3433.  
  3434.                User File Parameters
  3435.                +------------------------------------------------------+
  3436.                  Y or N     where Y means to delete locked out users               |                                                      |
  3437.                             and N means to keep locked out users.               |                                                      |
  3438.                |                                                      |
  3439.                  xxx        represents a time frame (number of days)               |                                                      |
  3440.                             a user must have called within in order               |                                                      |
  3441.                             to be exempt from purging.               |                                                      |
  3442.                |                                                      |
  3443.                  xxx        represents the security level that is               |                                                      |
  3444.                             exempt from purging.               |                                                      |
  3445.                +------------------------------------------------------+
  3446.  
  3447.           The following  example would  purge the  user file,  deleting all
  3448.           locked out users and any user that has not called within the past
  3449.           120 days.  Any user with a level of 90 or greater will be kept in
  3450.           the file even if they have not called within the past 120 days:
  3451.  
  3452.                GAPPACK C:\GAP\MAIN\USERS.DAT U Y 120 90
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.                                        Page 55
  3459.  
  3460.  
  3461.  
  3462.           GAP Communications                                   System Files
  3463.  
  3464.  
  3465.  
  3466.  
  3467.           To pack the FileBase, you pass the full path and name of the data
  3468.           file as  the first  parameter. There  are two FileBase data files
  3469.           called FILES.DAT and FILEKEY.DAT. The second parameter is an 'F',
  3470.           which tells  GAPPACK you  are packing the FileBase. The following
  3471.           example will pack the main FileBase data file:
  3472.  
  3473.                GAPPACK C:\GAP\MAIN\FILES.DAT F
  3474.  
  3475.           To pack  the Member  file, you pass the full path and name of the
  3476.           data file as the first parameter. The second parameter is an 'R',
  3477.           which tells GAPPACK you are packing the Member file:
  3478.  
  3479.                GAPPACK C:\GAP\MAIN\MEMBER.DAT R
  3480.  
  3481.           GAPMAINT is  a GAPPACK  shell program  that automates the packing
  3482.           and rebuilding  of your  ISAM data  files. It relieves you of the
  3483.           burden of  having  to  remember  all  the  various  command  line
  3484.           parameters.
  3485.  
  3486.           REMOTE.BAT -  When a sysop exits to DOS from remote, GAP will run
  3487.           this file.  It may contain any commands you wish, however it must
  3488.           load a  secondary copy  of COMMAND.COM if you wish to perform any
  3489.           dos functions and return to the file when you are finished.
  3490.  
  3491.                REMOTE.BAT
  3492.                +------------------------------------------------------+
  3493.                  @echo off               |                                                      |
  3494.                  watchdg1 on               |                                                      |
  3495.                  ctty com1:               |                                                      |
  3496.                  echo    ********************************************               |                                                      |
  3497.                  echo    ***     Sysop In Dos From Remote         ***               |                                                      |
  3498.                  echo    ***                                      ***               |                                                      |
  3499.                  echo    ***     Type 'Exit' To Return To GAP     ***               |                                                      |
  3500.                  echo    ********************************************               |                                                      |
  3501.                  command               |                                                      |
  3502.                  c:               |                                                      |
  3503.                  cd\gap               |                                                      |
  3504.                  ctty con:               |                                                      |
  3505.                  watchdg1 off               |                                                      |
  3506.                +------------------------------------------------------+
  3507.  
  3508.           Watchdog is  a public  domain program  which will monitor the COM
  3509.           ports for  a carrier.  If it  fails to  find one, it will re-boot
  3510.           your computer. Such a program is necessary. If the person who has
  3511.           exited to  DOS from  remote drops  carrier, your computer will be
  3512.  
  3513.  
  3514.  
  3515.  
  3516.                                        Page 56
  3517.  
  3518.  
  3519.  
  3520.           GAP Communications                                   System Files
  3521.  
  3522.  
  3523.  
  3524.  
  3525.           sitting idle  waiting for input from the COM port, and of course,
  3526.           there will  be nobody there! The documentation for Watchdog gives
  3527.           further instructions  on its  use. Watchdog  is not provided with
  3528.           the GAP distribution diskettes.
  3529.  
  3530.           The CTTY  COM1: command  redirects all  input/output to  the  COM
  3531.           port. Please  refer to  your DOS manual for explanation as to its
  3532.           use.
  3533.  
  3534.           The ECHO  commands simply remind the sysop to type EXIT to return
  3535.           to the BBS.
  3536.  
  3537.           Don't forget  the CTTY CON: command or all keyboard activity will
  3538.           be ignored and all output will be sent to the COM port.
  3539.  
  3540.           There are  other, more  powerful, programs  available  that  will
  3541.           allow you  to run  programs remotely.  They also  provide  better
  3542.           carrier detect  monitoring. One  such program is shareware and is
  3543.           used by many GAP sysops to run GAPFILE from a remote location.
  3544.  
  3545.  
  3546.           Help Directory
  3547.  
  3548.           All help files are placed here. Sample files are provided.
  3549.  
  3550.  
  3551.           Main Directory
  3552.  
  3553.           The MAIN  directory should  be backed up periodically. We suggest
  3554.           every other day as a minimum.
  3555.  
  3556.           QUESTxx
  3557.           NEWQUEST
  3558.           ANSWERxx
  3559.           REGIS
  3560.           These are the Questionnaire files. ANSWERxx and REGIS are created
  3561.           automatically  when   a   user   fills   out   a   questionnaire.
  3562.           Questionnaires are described in more detail in a later chapter.
  3563.  
  3564.           CALLER -  This file  is created automatically, the first time you
  3565.           run GAP.  It contains  detailed information  about  the  caller's
  3566.           activities. Its structure is described in a later chapter.
  3567.  
  3568.           DUMMYLOK.DAT -  This file will appear only if the system is multi
  3569.           user. It is created automatically by the setup program. This file
  3570.  
  3571.  
  3572.  
  3573.  
  3574.                                        Page 57
  3575.  
  3576.  
  3577.  
  3578.           GAP Communications                                   System Files
  3579.  
  3580.  
  3581.  
  3582.  
  3583.           allows us  to overcome the DOS limitation of not being allowed to
  3584.           read a record in a file while it is locked by another process.
  3585.  
  3586.           FILEKEY.DAT
  3587.           FILEKEY.IDX
  3588.           FILES.DAT
  3589.           FILES.IDX
  3590.           These  are   the  FileBase  ISAM  files.  They  are  created  and
  3591.           maintained by the FileBase editor.
  3592.  
  3593.           FORUM.DAT -  Contains configuration  information for  each of the
  3594.           Forums.
  3595.  
  3596.           MEMBER.DAT
  3597.           MEMBER.IDX
  3598.           These files  hold the  Forum membership  information. The  Member
  3599.           file contains one record for each User for each Forum the user is
  3600.           a member of.
  3601.  
  3602.           MESSNO.DAT - This file is used internally by GAP. It contains the
  3603.           high message numbers for each of your message files.
  3604.  
  3605.           MSGS.DAT
  3606.           MSGS.IDX
  3607.           These  are  the  main  board  message  files.  They  are  created
  3608.           automatically and are maintained by the program.
  3609.  
  3610.           NETWORK.DAT  -  In  a  multi  user  system,  this  file  contains
  3611.           information that  is shared  across the  network. It  is  created
  3612.           automatically by the setup program.
  3613.  
  3614.           SECLEV -  This is  the times/download byte file. When a user logs
  3615.           on, this  file is scanned to determine the user's allowed time in
  3616.           minutes and  the total bytes and files that are available for any
  3617.           single day.  This file must exist or you and your users will have
  3618.           just 12  minutes per day and no download privileges! This file is
  3619.           created and maintained in the Configuration Editor.
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.                                        Page 58
  3633.  
  3634.  
  3635.  
  3636.           GAP Communications                                   System Files
  3637.  
  3638.  
  3639.  
  3640.  
  3641.           In GAPSETUP, select Seclev from the Files Menu:                              
  3642.  
  3643.                                   Files
  3644.                                   +----------------+
  3645.                                     Seclev                                  |                |
  3646.                                     Doors                                  |                |
  3647.                                     Ext Protocols                                  |                |
  3648.                                   +----------------+
  3649.  
  3650.           A pick  list will  appear asking  you to  select a SECLEV file to
  3651.           edit. SECLEV  files with  an extension are special files that are
  3652.           applicable to callers with a certain baud rate or who call during
  3653.           a certain  time of day. The first two characters of the extension
  3654.           represent the  time of  day, and  the last  character is the baud
  3655.           code where:
  3656.  
  3657.                           +--------------------------------+
  3658.                             1   -   300 baud                          |                                |
  3659.                             2   -   1200 baud                          |                                |
  3660.                             3   -   2400 baud                          |                                |
  3661.                             4   -   9600 and greater baud                          |                                |
  3662.                           +--------------------------------+
  3663.  
  3664.           The time  is in  24 hour  format, and a time of '00' means ignore
  3665.           the time checking.
  3666.  
  3667.                   SECLEV Examples
  3668.                   +------------------------------------------------+
  3669.                     SECLEV        -   Regular                  |                                                |
  3670.                     SECLEV.170    -   Use at 5:00 pm, any baud                  |                                                |
  3671.                     SECLEV.181    -   Use at 6:00 pm, 300 baud                  |                                                |
  3672.                     SECLEV.193    -   Use at 7:00 pm, 2400 baud                  |                                                |
  3673.                     SECLEV.001    -   Use at any time, 300 baud                  |                                                |
  3674.                     SECLEV.002    -   Use at any time, 1200 baud                  |                                                |
  3675.                     SECLEV.003    -   Use at any time, 2400 baud                  |                                                |
  3676.                     SECLEV.004    -   Use at any time, 9600 baud                  |                                                |
  3677.                   +------------------------------------------------+
  3678.  
  3679.           If you  wanted to  severely restrict 300 baud callers at 6:00 pm,
  3680.           but only  mildly restrict  all other baud rates at the same time,
  3681.           you could have two SECLEV files such as:
  3682.  
  3683.                          +----------------------------------+
  3684.                            SECLEV.181    and    SECLEV.180                         |                                  |
  3685.                          +----------------------------------+
  3686.  
  3687.  
  3688.  
  3689.  
  3690.                                        Page 59
  3691.  
  3692.  
  3693.  
  3694.           GAP Communications                                   System Files
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.           This works  because GAP  looks for  the files  in  the  following
  3701.           order:
  3702.  
  3703.                               +------------------------+
  3704.                                  Time / Baud file                              |                        |
  3705.                                  Time / No Baud file                              |                        |
  3706.                                  No Time / Baud file                              |                        |
  3707.                                  SECLEV                              |                        |
  3708.                               +------------------------+
  3709.  
  3710.           After selecting  a SECLEV  file to  work with,  the  Editor  will
  3711.           appear and you will then be able to configure your SECLEV file.
  3712.  
  3713.  
  3714.           SECLEV Editor
  3715.  
  3716.           ARTWORK
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.           Level is  the security  level that  a user  must have in order to
  3733.           receive the allotments specified in the other fields. When a user
  3734.           logs on,  GAP will  scan the  SECLEV file  and look up the user's
  3735.           security level. The Minutes, Bytes, Files, Ratio and other fields
  3736.           in this  file will  be assigned  to this  user. If a user's level
  3737.           cannot  be  found  in  this  file,  the  user  will  receive  the
  3738.           allotments associated with the next highest level.
  3739.  
  3740.           Minutes is  the number of minutes that a user with the associated
  3741.           security level  is given  for on-line  time  during  the  current
  3742.           session.
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.                                        Page 60
  3749.  
  3750.  
  3751.  
  3752.           GAP Communications                                   System Files
  3753.  
  3754.  
  3755.  
  3756.  
  3757.           Bytes is  the number  of bytes  that a  user with  the associated
  3758.           security level is allowed to download during the current session.
  3759.           This number  is the  number of  "K" Bytes. GAP will multiply this
  3760.           number by 1000 to determine the user's allowable download bytes.
  3761.  
  3762.           Files is  the number  of files  that a  user with  the associated
  3763.           security level is allowed to download during the current session.
  3764.  
  3765.           Ratio  is   the  Upload/Download  Ratio  that  a  user  with  the
  3766.           associated security  level must  maintain. If  you do not wish to
  3767.           enforce Ratios,  enter 0  in this  field. If a caller attempts to
  3768.           download a  file and  his/her ratio  is greater  than  the  ratio
  3769.           allowed, a  file called  RATIO will be displayed. This file would
  3770.           explain why  the caller  is unable  to download  and what must be
  3771.           done to rectify the problem.
  3772.  
  3773.           If you  enforce ratios  by Bytes, then the number entered in this
  3774.           field is  the number of "K" bytes that must be maintained. If you
  3775.           enforce ratios  by Files, then this number is the number of files
  3776.           that can  be downloaded  per each  file  uploaded.  Note  that  0
  3777.           uploads is the same as 1 upload.
  3778.  
  3779.           Ask is a Yes/No field where you specify whether or not GAP should
  3780.           do random  checking to  determine if  a user  with the associated
  3781.           security level  entered a valid Birth Date and Home Phone Number.
  3782.           In order  to use  this feature  of GAP,  you must have Prompt for
  3783.           Birthday set to Yes.
  3784.  
  3785.           Normally, you  would answer  Yes in  this field  only  for  those
  3786.           security levels  that are  at or  below your  New User level. You
  3787.           would not want to burden your registered callers with this random
  3788.           checking of Dates and Phone Numbers.
  3789.  
  3790.           The bottom  status line  shows the Editor Keys. Context sensitive
  3791.           help is available for each field by pressing the F1 Help key.
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.                                        Page 61
  3807.  
  3808.  
  3809.  
  3810.           GAP Communications                                   System Files
  3811.  
  3812.  
  3813.  
  3814.  
  3815.                     Editor Keys
  3816.                     +--------------------------------------------+
  3817.                         Alt-D       -    Delete Line                    |                                            |
  3818.                         Alt-I       -    Insert Line                    |                                            |
  3819.                         F9          -    Save File                    |                                            |
  3820.                         F10         -    Save File As                    |                                            |
  3821.                         Esc         -    Quit                    |                                            |
  3822.                         UpArrow     -    Up Column                    |                                            |
  3823.                         DnArrow     -    Down Column                    |                                            |
  3824.                         Home        -    Beginning of File                    |                                            |
  3825.                         End         -    End of File                    |                                            |
  3826.                         Ctrl-Home   -    Previous Field                    |                                            |
  3827.                     +--------------------------------------------+
  3828.  
  3829.           TCAN - This file contains the undesirable names which you wish to
  3830.           prohibit your  users from using. If a user tries to log on with a
  3831.           name that  is found in this file, he/she will be denied access to
  3832.           the system:
  3833.  
  3834.                               TCAN
  3835.                               +------------------------+
  3836.                                 MARY POPPINS                              |                        |
  3837.                                 DOCTOR                              |                        |
  3838.                                 HELL                              |                        |
  3839.                                 MR.                              |                        |
  3840.                                 DEVIL                              |                        |
  3841.                                 EVIL                              |                        |
  3842.                               +------------------------+
  3843.  
  3844.  
  3845.           USERS.DAT
  3846.           USERS.IDX
  3847.           These files contain the statistics on all of your users.
  3848.  
  3849.  
  3850.           Gen Directory
  3851.  
  3852.           The GEN  directory can  be a  directory on  a RAM  disk or a hard
  3853.           disk. Most  of these  files can  have an  ANSI color  version  by
  3854.           colorizing the file in an Ansi Editor and saving it with the same
  3855.           base name but with a 'G' appended.
  3856.  
  3857.           7E1 -  This file  will be  displayed to  callers who  use 7  E  1
  3858.           communications parameters.  It should  be a  text file written in
  3859.           upper case  and perhaps  40 columns.  Its use  is to  inform  the
  3860.  
  3861.  
  3862.  
  3863.  
  3864.                                        Page 62
  3865.  
  3866.  
  3867.  
  3868.           GAP Communications                                   System Files
  3869.  
  3870.  
  3871.  
  3872.  
  3873.           caller that  some of  the screens  may appear  garbled, that they
  3874.           will be  limited to ASCII downloads, and that on subsequent calls
  3875.           they should use 8 N 1 parameters.
  3876.  
  3877.           BIRTH -  This file  is displayed  if the  day a user calls is the
  3878.           user's birthday.
  3879.  
  3880.           BLT
  3881.           BLTxx
  3882.           These are  your main  board bulletin files. BLT is the menu which
  3883.           lists the  bulletins and  their numbers.  There can  be up to 999
  3884.           bulletins.
  3885.  
  3886.           COMMENT -  This is  the file  that is displayed (if it exists) to
  3887.           your users  whenever they attempt to enter a comment. Many sysops
  3888.           feel that  a comment  is just  that and deserves no reply. Such a
  3889.           text file will allow you to express your thoughts to your users.
  3890.  
  3891.           CLOSED - If you run a closed board, GAP will display this file to
  3892.           any caller who attempts to log on and that caller is not a member
  3893.           of the  board. Whether  or not a caller is a member is determined
  3894.           by the  Private User  flag in  the user  record. If  you wish  to                  
  3895.           prevent new  users from gaining access to your system you can use
  3896.           the @DISCON  AnsiCmd in your NEWUSER file. This will cause GAP to                                       
  3897.           disconnect the  line after  the potential  new user  has read the
  3898.           file, and will prevent GAP from adding the user to the user file.
  3899.  
  3900.           DIR -  This is  the menu  that lists the available subjects (file
  3901.           categories) on your system.
  3902.  
  3903.           DIRS -  This file  lists  the  file  subject  numbers  and  their
  3904.           descriptions. It is not shown to callers at any time. Its purpose
  3905.           is to  tell GAP  the name  of your  subjects. It  is used by both
  3906.           GAPBBS and  GAPFILE. When  the name of a particular subject needs
  3907.           to be  known, this  file will  be scanned  so  that  the  subject
  3908.           description  can   be  displayed.  The  chapter  FileBase  Editor                                                           
  3909.           contains details on the actual format of this file.
  3910.  
  3911.           DOORM - This is the Menu that lists the available doors.
  3912.  
  3913.           DOORS.DAT  -  is  the  data  file  that  holds  the  actual  door
  3914.           information GAP needs in order to run the batch files that invoke
  3915.           the  doors.   This  file   is  created   and  maintained  in  the
  3916.           Configuration Editor  and is  described in  detail in the chapter
  3917.           Doors.
  3918.  
  3919.  
  3920.  
  3921.  
  3922.                                        Page 63
  3923.  
  3924.  
  3925.  
  3926.           GAP Communications                                   System Files
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.           ENEWS -  This is the exit news file that is displayed when a user
  3933.           logs off.
  3934.  
  3935.           EVENT -  This file is displayed to callers if their time has been
  3936.           adjusted due to an upcoming Event.
  3937.  
  3938.           EXPIRE  -   If  you   run  a  subscription  board  and  a  user's
  3939.           subscription is  about to  expire, GAP will display this file. It
  3940.           basically tells  the user that his/her subscription is coming due
  3941.           and what  can be  done to  renew the subscription. Note that this
  3942.           file is  displayed only  if the subscription is still current. It                             
  3943.           is suggested that you set up a Security Menu and/or News file for
  3944.           the Expired  Subscription Level  so that  your expired users will
  3945.           always be reminded that their subscription has expired.
  3946.  
  3947.           FILEM -  This is  the Files  System Menu.  It lists the available
  3948.           file commands.
  3949.  
  3950.           FILES.DIR -  This file is used by GAPFILE when moving or locating
  3951.           stray files.  Its format  is described  in the  chapter  FileBase                                                                   
  3952.           Editor.
  3953.  
  3954.           FORUMM - This is the Forum Menu that lists the available Forums.
  3955.  
  3956.           KEEPUP - This file is displayed to users after they have uploaded
  3957.           a file  in a  Forum and the sysop has the Forum configured to not
  3958.           keep uploads inside.
  3959.  
  3960.           LOCKOUT -  This file  will be  displayed to a user when you press
  3961.           the F2 (LOCKOUT) Key. It will also be displayed to any locked out
  3962.           user attempting to log on.
  3963.  
  3964.           LOGON -  This file is displayed to callers when they request Help
  3965.           at the  Log On  prompt. Since  GAP does not yet know the caller's
  3966.           color preference, there cannot be a color version of this file.
  3967.  
  3968.           MAINM -This is the Main Menu that lists the available commands in
  3969.           the main section of the board.
  3970.  
  3971.           NEWS -  This is  your news  file. It will be displayed to callers
  3972.           after log  on. The  news file  is  displayed  once  per  day.  In
  3973.           addition, callers  may review  the news by using the Initial News
  3974.           And Welcome  command.   You can  have up to 10 news files. If you
  3975.           wish to  add additional files, append a number after the name. It
  3976.  
  3977.  
  3978.  
  3979.  
  3980.                                        Page 64
  3981.  
  3982.  
  3983.  
  3984.           GAP Communications                                   System Files
  3985.  
  3986.  
  3987.  
  3988.  
  3989.           is not  necessary that the files be sequential. For instance, you
  3990.           may have  a NEWS, NEWS1 and NEWS5. The only requirement for using
  3991.           supplemental news files is that the basic NEWS file exists.
  3992.  
  3993.           NEWUSER -  This is  the new user welcome file. It is displayed to
  3994.           all new users.
  3995.  
  3996.           NOPAGE - The presence of this file tells GAP that you do not want
  3997.           to be  paged for chat. If it exists, GAP will display it and will
  3998.           then set  the Page  flag on the status line to let the sysop know
  3999.           that the caller issued the Page Sysop command. If you prefer that
  4000.           GAP go  through the 30 second Page Sysop routine then remove this
  4001.           file from your GEN directory.
  4002.  
  4003.           NOTIME -  If you use time/baud specific SECLEV files and a caller
  4004.           receives zero  minutes at  log on  because the time allotment for
  4005.           his/her security level is 0, GAP will display this file to inform
  4006.           the user  why he/she does not have any time. After displaying the
  4007.           file, GAP  will then  disconnect the  user. If this file does not
  4008.           exist, the  user will simply be logged off with an "Expired Time"
  4009.           message.
  4010.  
  4011.           NOUP -  Many sysops  like to prevent callers from uploading files
  4012.           with certain  extensions. The  NOUP file  allows you  to do  just
  4013.           that. The format is as follows:
  4014.  
  4015.                               NOUP
  4016.                               +------------------------+
  4017.                                .TXT                              |                        |
  4018.                                .DOC                              |                        |
  4019.                                .COM                              |                        |
  4020.                                .EXE                              |                        |
  4021.                               +------------------------+
  4022.  
  4023.  
  4024.           PAGE - This file will be shown to a user if you do not answer the
  4025.           Sysop Page  bell. You  may use  it to  give your  office hours or
  4026.           other information.
  4027.  
  4028.           PROTO -  This file  lists the  available transfer  protocols.  It
  4029.           should be kept as short and simple as possible.
  4030.  
  4031.           PROTO.DAT -  This is  a binary file that lists and describes your
  4032.           External  Protocols.   It  is   created  and  maintained  by  the
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.                                        Page 65
  4039.  
  4040.  
  4041.  
  4042.           GAP Communications                                   System Files
  4043.  
  4044.  
  4045.  
  4046.  
  4047.           Configuration Editor  and is  explained in  detail in the chapter
  4048.           External Protocols.
  4049.  
  4050.           QMENU - This is the Menu that lists the available Questionnaires.
  4051.  
  4052.           RATIO -  If you  enforce Upload/Download ratios, GAP will display
  4053.           this file if a user attempts to download a file and his/her ratio
  4054.           is above the allowed ratio as defined in the SECLEV file for that
  4055.           user's security level.
  4056.  
  4057.           REGINFO -  This file  is displayed after the NEWUSER file and the                                                       
  4058.           new user  has answered  Yes to  join the  BBS. Its  purpose is to
  4059.           inform the  user that  they will  be asked a series of questions,
  4060.           that they  must answer  truthfully, and  perhaps explain  how  to
  4061.           answer the questions correctly.
  4062.  
  4063.           RESBAUD -  If you  have configured  restricted baud  rates and  a
  4064.           caller attempts  to log  on using  the restricted rate, this file
  4065.           will be  displayed to inform the caller that you do not allow the
  4066.           baud rate  or that  the caller  is calling  during  a  restricted
  4067.           access time.
  4068.  
  4069.           SMAINM -  This file  is similar  to the Main Menus except that it
  4070.           lists the  available sysop  commands in  addition to  the regular
  4071.           commands.
  4072.  
  4073.           TWIT -  This file  will be displayed to a user when you press the
  4074.           F8 (TWIT) Key to log the user off.
  4075.  
  4076.           UPHELP -  This file  is shown  to callers prior to prompting them
  4077.           for an  upload description.  It explains how to enter keywords as
  4078.           well as leave private files.
  4079.  
  4080.           UPLOAD -  This file is displayed immediately after a user presses
  4081.           the 'U'  key to  upload a file. Its purpose it to tell users what
  4082.           your Upload  rules are,  types of  files you  accept or  will not
  4083.           accept, etc.
  4084.  
  4085.           WELC -  This is  your Welcome  file that  is displayed to callers
  4086.           when they  first log  on. You can have up to 10 Welcome files. If
  4087.           you wish to add additional files, append a number after the name.
  4088.           It is  not necessary  that the files be sequential. For instance,
  4089.           you may  have a  WELC, WELC1  and WELC5. The only requirement for
  4090.           using supplemental  Welcome files  is that  the basic  WELC  file
  4091.           exists.
  4092.  
  4093.  
  4094.  
  4095.  
  4096.                                        Page 66
  4097.  
  4098.  
  4099.  
  4100.           GAP Communications                                   System Files
  4101.  
  4102.  
  4103.  
  4104.  
  4105.           Forum Files
  4106.  
  4107.           Forums are  separate areas  of the  board. They contain their own
  4108.           message bases  and may,  optionally, have their own files. Forums
  4109.           can be likened to a business where there is a main administrative
  4110.           area (the Main Board) and separate departments such as Accounting
  4111.           (Forum 1), Sales (Forum 2), and Board of Directors (Forum 3).
  4112.  
  4113.  
  4114.           Default Directory
  4115.  
  4116.  
  4117.           The default  directory is the only directory that is required for
  4118.           a Forum.  In addition,  only two files are required (MSGS.DAT and
  4119.           MSGS.IDX).
  4120.  
  4121.           If  you  have  a  Forum  called  Ads,  you  could  create  a  DOS
  4122.           subdirectory called \GAP\ADS.
  4123.  
  4124.           This directory  would then become the Forum DEFAULT directory. In
  4125.           this directory,  the configuration  program will create two files
  4126.           called  MSGS.DAT  and  MSGS.IDX  (You  may  give  these  files  a
  4127.           different name).
  4128.  
  4129.           You do  not need  to create the DEFAULT, GEN, or UPLOAD directory
  4130.           as  they   will  be   created  automatically   for   you   during
  4131.           configuration.
  4132.  
  4133.           Please see the file location chart (Chapter Two) for the names of
  4134.           the files you can create to cause a Forum to run as a mini BBS.
  4135.  
  4136.           In order to activate file directories inside of a Forum, you will
  4137.           need a  DIR file in the Forum GEN directory. The presence of this
  4138.           file tells  GAP that the files system is available while a caller
  4139.           is inside  the Forum.  If the file is missing, the caller will be
  4140.           told the Forum has no file directories.
  4141.  
  4142.           Except for  the DIR  menu, if  GAP fails  to find  a unique Forum
  4143.           file, it will use the equivalent file from the main board.
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.                                        Page 67
  4155.  
  4156.  
  4157.  
  4158.           GAP Communications                                   System Files
  4159.  
  4160.  
  4161.  
  4162.  
  4163.           Gen Directory
  4164.  
  4165.  
  4166.           As with  the main  board GEN  directory, the  Forum GEN files may
  4167.           reside on  a RAM disk. You may also use a hard disk GEN directory
  4168.           if you wish to keep the Forum GEN files separate from the DEFAULT
  4169.           files.
  4170.  
  4171.  
  4172.           Upload Directory
  4173.  
  4174.  
  4175.           If you  wish to keep Forum uploads inside the Forum, they will be
  4176.           placed in this directory.
  4177.  
  4178.           As explained  previously, when  a user  attempts to upload a file
  4179.           while inside  a Forum,  and if  that Forum  has  additional  file
  4180.           directories, and  if the sysop has specified that all uploads are
  4181.           not to  be kept  in the  Forum, GAP will asked the user if he/she
  4182.           wishes to  keep the  file inside the Forum. The KEEPUP file (that
  4183.           is placed  in the Main Board GEN directory so that all the Forums
  4184.           may share it) will help explain the reasoning prior to asking the
  4185.           question.
  4186.  
  4187.           One reason  for keeping  uploads inside  the Forum is to prohibit
  4188.           the user  from uploading  Forum specific files to the main board.
  4189.           The sysop  has the  option to force all uploads inside of a Forum
  4190.           to remain in the Forum. If the sysop sets the Keep Uploads Inside
  4191.           flag to  No and  if the  Forum has  an upload directory, the user
  4192.           will be asked where to send the file.
  4193.  
  4194.  
  4195.           Special Batch Files
  4196.  
  4197.  
  4198.           GAP uses  external batch  files to  perform some  of its internal
  4199.           functions. These  files are  required for proper system operation
  4200.           and they are placed in your DEFAULT directory.
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.                                        Page 68
  4213.  
  4214.  
  4215.  
  4216.           GAP Communications                                   System Files
  4217.  
  4218.  
  4219.  
  4220.  
  4221.           ARCTRANS.BAT
  4222.  
  4223.  
  4224.           When a caller requests a Transfer from an archive, GAP will shell
  4225.           to a  batch file called ARCTRANS.BAT. GAP will pass the following
  4226.           parameters to the batch file:
  4227.  
  4228.           +----------------------------------------------------------------+
  4229.             %1  -   Where to put the Extracted File (loose directory #1)          |                                                                |
  4230.             %2  -   Full Path/Name of the Archive File to process          |                                                                |
  4231.             %3  -   What kind of Archive it is, ARC, ZIP, LZH, ICE, etc          |                                                                |
  4232.             %4  -   Name of file to extract from the compressed file          |                                                                |
  4233.             %5  -   Name to use for the file, once it is extracted and          |                                                                |
  4234.                     recompressed.          |                                                                |
  4235.           +----------------------------------------------------------------+
  4236.  
  4237.           A sample ARCTRANS.BAT is included on the distribution disks.
  4238.  
  4239.           GAP expects  your batch  file shell  to unarc  the file  from the
  4240.           archive, re-arc  it  using  the  supplied  name,  and  place  the
  4241.           resultant file in your first Loose Directory.
  4242.  
  4243.           Upon return  from the  shell, GAP will then display the resultant
  4244.           archive and  allow the  user to download it. When the download is
  4245.           complete, GAP will delete the file from your Loose Directory.
  4246.  
  4247.  
  4248.           UPCHECK.BAT
  4249.  
  4250.  
  4251.           For each  file that GAP processes after an upload, GAP will shell
  4252.           to a  batch file  called UPCHECK.BAT.  If the UPCHECK.BAT file is
  4253.           not present,  then GAP  will not  shell and the upload processing
  4254.           will continue as usual.
  4255.  
  4256.           After receiving  an upload  GAP will shell to this batch file. In
  4257.           batch mode,  GAP will  shell to the UPCHECK batch file after each
  4258.           file that  it processes.  In this  batch file,  you may add a ZIP
  4259.           Comment, check  for a  Virus, or do whatever it is you need to do
  4260.           with an upload.
  4261.  
  4262.           Upon return  from the UPCHECK shell, GAP will check to see if the
  4263.           file is  still in  the directory.  If, your  batch  file  or  the
  4264.           program that  your batch  file ran,  deleted the  file,  and  GAP
  4265.           cannot find  the file  in the  Upload or Work directory, then GAP
  4266.  
  4267.  
  4268.  
  4269.  
  4270.                                        Page 69
  4271.  
  4272.  
  4273.  
  4274.           GAP Communications                                   System Files
  4275.  
  4276.  
  4277.  
  4278.  
  4279.           will check  to see  if the filename extension is the same as your
  4280.           default extension  you configured  in GAPSETUP.  If not, then GAP
  4281.           will substitute your extension for the one in the Upload file and
  4282.           try to  find the  file using the new extension. If at this point,
  4283.           GAP still  cannot find  the file,  it will  skip that file (batch
  4284.           mode) and go on to the next.
  4285.  
  4286.             If, on  the other  hand, GAP  now finds the file with the new
  4287.             extension, it  will tell the caller that the file was renamed
  4288.             per sysop  conventions and  proceed as  usual, using  the new
  4289.             filename.
  4290.  
  4291.           Basically, this  means that  if you  run a virus check program on
  4292.           the uploaded file and your check finds that the uploaded file has
  4293.           a virus,  if either  your batch  file or  the program  you use to
  4294.           check for  viruses deletes the file, GAP will not add the file to                                                            
  4295.           the FileBase.  Also, if  a caller  uploads an  .ARC file  and you
  4296.           prefer to keep .ZIP files, you can UnArc the file and ZIP it back
  4297.           up, giving  it a  .ZIP extension  in the  process  and  GAP  will
  4298.           accommodate your  change and  process  the  file  with  the  .ZIP
  4299.           extension instead of the .ARC extension.
  4300.  
  4301.           When processing  an Uploaded File, GAP will shell to UPCHECK.BAT,
  4302.           passing the following parameters:
  4303.  
  4304.           +----------------------------------------------------------------+
  4305.             %1  -   Full path and name of file          |                                                                |
  4306.             %2  -   Upload Directory path          |                                                                |
  4307.             %3  -   Filename          |                                                                |
  4308.             %4  -   Filename without the extension          |                                                                |
  4309.             %5  -   Extension without the filename          |                                                                |
  4310.             %6  -   0 = Remote Caller On, 1 = Sysop On Locally,          |                                                                |
  4311.                     2 = Local User          |                                                                |
  4312.           +----------------------------------------------------------------+
  4313.  
  4314.           The first  parameter is  the full  path and  name of  the file to
  4315.           check. This  parameter is  the fully  qualified path  name to the
  4316.           file that  is being  processed by GAP. You may then pass %1 on to
  4317.           the program(s) you use to check/verify or add comments.
  4318.  
  4319.           As an example:
  4320.  
  4321.             After  receiving   an  upload   in  non-batch  mode  or  when
  4322.             processing a  batch of  uploads in  batch mode,  GAP will run
  4323.             UPCHECK.BAT as follows:
  4324.  
  4325.  
  4326.  
  4327.  
  4328.                                        Page 70
  4329.  
  4330.  
  4331.  
  4332.           GAP Communications                                   System Files
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.                UPCHECK path\filename
  4339.  
  4340.                where path\filename is the full path to the file.
  4341.  
  4342.             All your  UPCHECK.BAT need do is pass %1 to the program it is
  4343.             running (a virus checker, PKZIP to add a ZIP Comment, etc).
  4344.  
  4345.           If you  run a  Virus Checker  and the Virus program or your batch
  4346.           file deletes  the file, then upon return from the shell, GAP will
  4347.           simply skip that file and move on to the next (after displaying a
  4348.           message that  the upload  file  being  processed  "...failed  the
  4349.           integrity check").
  4350.  
  4351.           You should  use the  sixth parameter to test whether or not it is
  4352.           "OK" to  echo text  to the COM port. You should only echo text to
  4353.           the COM  port if  the sixth  parameter is  0. In  addition,  this
  4354.           parameter will let you know whether or not GAPFILE is the program
  4355.           invoking your UPCHECK.
  4356.  
  4357.           Even if you do not wish to check the integrity of uploaded files,
  4358.           the UPCHECK  file serves another purpose. That is to extract file
  4359.           description files  out of an archive so that GAP can use the file
  4360.           as automatic  input for  the file description. A description file
  4361.           is a  text file (usually formatted to 10 or less lines with 45 or
  4362.           less characters per line), that describes the uploaded file. This
  4363.           description file  is called either DESC.SDI or FILE_ID.DIZ and is
  4364.           included inside  of the archive. Including such a file allows the
  4365.           author of the program (rather than the uploader) to describe what
  4366.           the archive is all about.
  4367.  
  4368.           GAP will process these description files only when a user uploads
  4369.           more than 1 file at a time (or at least tells GAP that he will be
  4370.           uploading more  than one  file). They  are  not  utilized  during
  4371.           single file  uploads for  the simple  reason  that  when  a  user
  4372.           uploads  a  single  file,  he/she  has  already  entered  a  file
  4373.           description and  GAP cannot check for the description files until
  4374.           after the  upload. Even  if GAP  found a  description file in the
  4375.           archive, it  would be  rather rude  for GAP to simply replace the
  4376.           description the  user gave  with the  one found  in the  archive,
  4377.           especially if  the user spent lot of time and effort entering the
  4378.           description.
  4379.  
  4380.  
  4381.  
  4382.  
  4383.  
  4384.  
  4385.  
  4386.                                        Page 71
  4387.  
  4388.  
  4389.  
  4390.           GAP Communications                                   System Files
  4391.  
  4392.  
  4393.  
  4394.  
  4395.           GAP will  accept 10  lines of  description, however the length of
  4396.           the lines  can be  72 characters  long (with the first line being
  4397.           only 45 characters since it will be used as the keywords).
  4398.  
  4399.           These files  are growing  in popularity  and are  being used more
  4400.           often than  not. The DESC.SDI was the first such description file
  4401.           and  it   tends  to  be  just  a  single  line  description.  The
  4402.           FILE_ID.DIZ is  a newer  description file  and it  tends to be 10
  4403.           lines or  less. If  you would  like to  include description files
  4404.           with archives  you upload  (providing the archive doesn't already
  4405.           have one),  we suggest  that you name the file FILE_ID.DIZ (since
  4406.           it is  not clear  as to  whether or  not  programs  that  support
  4407.           DESC.SDI can  handle more than one line of description). We would
  4408.           also suggest a format as follows:
  4409.  
  4410.           +----------------------------------------------------------------+
  4411.             Line 1     -  45 or less characters of KEYWORD information          |                                                                |
  4412.             Lines 2-10 -  45 or less characters of descriptive information          |                                                                |
  4413.           +----------------------------------------------------------------+
  4414.  
  4415.           If you  will only  be uploading these files to a GAP system, then
  4416.           lines 2-10  can be  up to  72 characters.  Line 1  will  also  be
  4417.           included in GAP's enhanced description (in addition to being used
  4418.           in the keyword field). Line 1 can be 72 characters in length, but
  4419.           only the first 45 characters will be used in the keywords.
  4420.  
  4421.           To maintain compatibility with other BBS systems, it is suggested
  4422.           that you keep the lengths of the lines to 45 characters or less.
  4423.  
  4424.           Your  UPCHECK.BAT   file  is   responsible  for   extracting  the
  4425.           description file  out of  the archive  and placing it in the work
  4426.           directory. Basically,  after your UPCHECK has determined that the
  4427.           file is sound (no viruses, passes integrity, etc), it should then
  4428.           try and  extract a DESC.SDI or FILE_ID.DIZ (but NOT both, if both
  4429.           formats are  included in  the archive).  The  extracted  file  is
  4430.           placed in the work directory.
  4431.  
  4432.           Upon return  from the  UPCHECK shell,  GAP will  check to  see if
  4433.           either DESC.SDI  or FILE_ID.DIZ is present in the work directory.
  4434.           If not,  then everything  goes along  as usual.  If one  of those
  4435.           files is in the work directory, then GAP will read the first line
  4436.           of the  file and  place it  in the  keyword field.  GAP will then
  4437.           prompt the  uploader for the keywords. In this case, however, the
  4438.           keywords will already be filled in, and the cursor will be at the
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.                                        Page 72
  4445.  
  4446.  
  4447.  
  4448.           GAP Communications                                   System Files
  4449.  
  4450.  
  4451.  
  4452.  
  4453.           end of  the line.  The Uploader can either accept the keywords as
  4454.           is, or backspace over them and enter his own keyword list.
  4455.  
  4456.           GAP will  then go  into the Message Editor to gather the enhanced
  4457.           file description.  However, in  the case  of a  description  file
  4458.           being present, the Message Editor will automatically go into File
  4459.           Import mode  and will import the entire description file into the
  4460.           message buffer.  The uploader  will  see  the  description  being
  4461.           imported and  will then be presented with the disposition prompt.
  4462.           He/she may  then either edit the description or press 'S' to save
  4463.           it.
  4464.  
  4465.           Basically what  you have with a file that uses a description file
  4466.           is that all the user need do is press 'S' to save the description
  4467.           after GAP comes back from an UPCHECK shell.
  4468.  
  4469.           GAP will  delete any  DESC.SDI or FILE_ID.DIZ files that it finds
  4470.           in the  work directory  after it  has processed the current file.                                  
  4471.           Your UPCHECK.BAT  file  is  only  responsible  for  getting  that
  4472.           description file  out of  the archive  (if it  exists). GAP  will
  4473.           handle all the details of utilizing the file if it finds it.
  4474.  
  4475.           Note that  your UPCHECK  should be  designed so  that it extracts
  4476.           only ONE  of the  description files,  not both  of  them,  should
  4477.           someone include a DESC.SDI and a FILE_ID.DIZ in the same archive.
  4478.  
  4479.           GAP always looks for DESC.SDI first. If it finds that file in the
  4480.           work directory and yet your UPCHECK extracted both a DESC.SDI and
  4481.           a FILE_ID.DIZ,  only the DESC.SDI will be deleted and if the next
  4482.           file in  the batch doesn't contain a description file, there will
  4483.           be a  left over  FILE_ID.DIZ that  will get  attached to the next
  4484.           file! Or worse yet, if there are no more files in the batch, your
  4485.           user could get prompted to enter a description for FILE_ID.DIZ!
  4486.  
  4487.  
  4488.           LOGON.BAT
  4489.  
  4490.  
  4491.           When logging  on, if  this  batch  file  exists  in  the  Default
  4492.           directory, GAP  will shell  out and run the file. This will occur
  4493.           after the  Welcome and  News files  are displayed,  after pending
  4494.           events are  checked, and  just  before  any  UserInfo  files  are                                                       
  4495.           displayed. GAP  will go  through the  doors system  so a DOOR.SYS
  4496.           file will  be written  (which allows  you to  return the  special
  4497.           codes that GAP recognizes if you wish).
  4498.  
  4499.  
  4500.  
  4501.  
  4502.                                        Page 73
  4503.  
  4504.  
  4505.  
  4506.           GAP Communications                                   System Files
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.           Note that  if  an  event  is  scheduled  and  the  caller's  time
  4513.           remaining is  less than  the Door  Guard Time, the LOGON.BAT file
  4514.           will not be run.  If the caller is out of time, GAP will also not
  4515.           run the  file, but  will instead  disconnect the  caller at  that
  4516.           point with a "Time Expired" message.
  4517.  
  4518.  
  4519.           QWK/REP Sub-System
  4520.  
  4521.  
  4522.  
  4523.           Description
  4524.  
  4525.  
  4526.           The QWK/REP  sub-system is  a method  that allows your callers to
  4527.           download QWK  packets containing  all new  messages in Forums the
  4528.           callers have  selected. It also allows callers to upload messages
  4529.           that were created with an off-line mail reader.
  4530.  
  4531.           Setting Up
  4532.  
  4533.  
  4534.           Setting up the QWK/REP sub-system is very similar to setting up a
  4535.           Door for  use with GAP. The only basic difference is that this is                                      
  4536.           not a  door and  must not  be configured  as part  of your  doors
  4537.           system since  the commands  to activate  the modules are built in
  4538.           commands and the initial prompts are a part of GAPBBS.
  4539.  
  4540.           Create a directory off of your DEFAULT directory called QWKREP:
  4541.  
  4542.                C:\GAP\QWKREP
  4543.  
  4544.           This directory will contain the following files:
  4545.  
  4546.                                   +----------------+
  4547.                                     REPIMPRT.EXE                                  |                |
  4548.                                     QWKEXPRT.EXE                                  |                |
  4549.                                     QWKREPx.CNF                                  |                |
  4550.                                     QWKH                                  |                |
  4551.                                     QWKMENU                                  |                |
  4552.                                     QWKMENUG                                  |                |
  4553.                                     SEND.BAT                                  |                |
  4554.                                     RECV.BAT                                  |                |
  4555.                                   +----------------+
  4556.  
  4557.  
  4558.  
  4559.  
  4560.                                        Page 74
  4561.  
  4562.  
  4563.  
  4564.           GAP Communications                                   System Files
  4565.  
  4566.  
  4567.  
  4568.  
  4569.           The QWKREPx.CNF is a configuration file that supplies the modules
  4570.           with the necessary information they need in order to run. The 'x'
  4571.           is the  Node Number that the configuration applies to. If you run
  4572.           single node  GAP software,  you may leave the node number off and
  4573.           simply name the file QWKREP.CNF.
  4574.  
  4575.           QWKH is a help file that is utilized by the QWK Module.
  4576.  
  4577.           QWKMENU and  QWKMENUG are  Menus that  are utilized  by  the  QWK
  4578.           Module.
  4579.  
  4580.           SEND.BAT and  RECV.BAT are  batch files that the QWK modules will
  4581.           invoke to send a QWK packet and receive a REP packet.
  4582.  
  4583.           The configuration file consists of the following lines:
  4584.  
  4585.                               QWKREP.CNF
  4586.                               +------------------------+
  4587.                                 Default Directory                              |                        |
  4588.                                 Name of BBS                              |                        |
  4589.                                 IRQ                              |                        |
  4590.                                 Base Address                              |                        |
  4591.                                 QWK/REP ID                              |                        |
  4592.                                 SEND.BAT                              |                        |
  4593.                                 RECV.BAT                              |                        |
  4594.                                 NODOSWIN (or blank)                              |                        |
  4595.                                 SYSOP NAME                              |                        |
  4596.                               +------------------------+
  4597.  
  4598.           The Default  Directory is the directory where your GAPBBS.CNF and
  4599.           DOOR.SYS files reside.
  4600.  
  4601.           The Name of BBS is your BBS Name.
  4602.  
  4603.           The IRQ  is the  Interrupt Request  Number  for  the  port.  This
  4604.           applies only  if you  are using ports other than COM 1 and COM 2.
  4605.           If you are using standard COM ports, enter a 0 on this line.
  4606.  
  4607.           The Base  Address is the Port address (in hexadecimal). This line
  4608.           also only applies if you are using non-standard COM ports. If you
  4609.           are using standard COM ports, enter a 0 on this line.
  4610.  
  4611.           The QWK/REP  ID is a unique Identifier for your BBS. It must be 8
  4612.           characters or less in length and entered in all upper case.
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.                                        Page 75
  4619.  
  4620.  
  4621.  
  4622.           GAP Communications                                   System Files
  4623.  
  4624.  
  4625.  
  4626.  
  4627.           The SEND.BAT  file line  can be  given any DOS batch file name of
  4628.           your choice.  When a caller requests a QWK packet, the QWK module
  4629.           will shell  to this  batch file to invoke DSZ or any other Zmodem
  4630.           protocol program.
  4631.  
  4632.           The following parameters will be passed to this batch file:
  4633.  
  4634.                SEND.BAT
  4635.                +------------------------------------------------------+
  4636.                  %1    -    COM Port Number               |                                                      |
  4637.                  %2    -    COM Port Speed (DTE bps rate)               |                                                      |
  4638.                  %3    -    Caller's bps rate               |                                                      |
  4639.                  %4    -    Directory where QWK packet is located.               |                                                      |
  4640.                +------------------------------------------------------+
  4641.  
  4642.           The RECV.BAT  file line  can be  given any DOS batch file name of
  4643.           your choice.  When a caller requests a REP packet, the REP or QWK
  4644.           module will  shell to  this batch file to invoke DSZ or any other
  4645.           Zmodem protocol program.
  4646.  
  4647.           The following parameters will be passed to this batch file:
  4648.  
  4649.                RECV.BAT
  4650.                +------------------------------------------------------+
  4651.                  %1    -    COM Port Number               |                                                      |
  4652.                  %2    -    COM Port Speed (DTE bps rate)               |                                                      |
  4653.                  %3    -    Caller's bps rate               |                                                      |
  4654.                  %4    -    Directory where the Protocol should place               |                                                      |
  4655.                             the REP packet.               |                                                      |
  4656.                +------------------------------------------------------+
  4657.  
  4658.           Line 8  of the  configuration file  can either be NODOSWIN or the
  4659.           end of the configuration file. When shelling to PKZIP or DSZ, the
  4660.           QWK/REP modules  create a "DOS Window" into which all output will
  4661.           be re-directed.  If you  use a full screen version of DSZ or have
  4662.           other reasons  for not  using  the  DOS  Window,  you  may  enter
  4663.           NODOSWIN on  this line  and  the  modules  will  not  attempt  to
  4664.           redirect all DOS output to a window.
  4665.  
  4666.           Line 9  of the  configuration file is the Sysop's Real Name. When
  4667.           importing messages,  any message that is to the Sysop's real name                                                   
  4668.           will be changed to SYSOP.
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.                                        Page 76
  4677.  
  4678.  
  4679.  
  4680.           GAP Communications                                   System Files
  4681.  
  4682.  
  4683.  
  4684.  
  4685.           A sample configuration file would look like this:
  4686.  
  4687.                               QWKREP.CNF
  4688.                               +------------------------+
  4689.                                 C:\GAP                              |                        |
  4690.                                 The Crow's Nest BBS                              |                        |
  4691.                                 0                              |                        |
  4692.                                 0                              |                        |
  4693.                                 CROWNEST                              |                        |
  4694.                                 SEND.BAT                              |                        |
  4695.                                 RECV.BAT                              |                        |
  4696.                                 USE DOS WINDOW                              |                        |
  4697.                                 GARY ARAKI                              |                        |
  4698.                               +------------------------+
  4699.  
  4700.           If you  run multi  nodes, you  will need a separate configuration
  4701.           file for each node.
  4702.  
  4703.           Next you will need to create two batch files that GAP will invoke
  4704.           when a caller types the appropriate QWK/REP command from the Main
  4705.           Menu (the commands are also available from the Files Menu). These
  4706.           batch files are placed in your DEFAULT directory.
  4707.  
  4708.           The first  is called  QWK.BAT. It  is  associated  with  the  QWK
  4709.           command. This  file will  invoke the QWKEXPRT.EXE module, passing
  4710.           to it  the name  of the  configuration file  for the  appropriate
  4711.           node. Such a file would look like this:
  4712.  
  4713.                               QWK.BAT
  4714.                               +------------------------+
  4715.                                 @echo off                              |                        |
  4716.                                 c:                              |                        |
  4717.                                 cd \gap\qwkrep                              |                        |
  4718.                                 qwkexprt qwkrep1.cnf                              |                        |
  4719.                                 c:                              |                        |
  4720.                                 cd \gap                              |                        |
  4721.                               +------------------------+
  4722.  
  4723.           Notice that  the file  changes  into  the  QWKREP  directory  and
  4724.           invokes  the   QWKEXPRT  module,  passing  it  the  name  of  the
  4725.           configuration file  for Node  1. If  you run  multiple nodes, you
  4726.           will need  a QWK.BAT  file for  each node.  The  only  difference
  4727.           between the  files would  be the drive and directory designators,
  4728.           and the  line that  calls up  the QWKEXPRT module. Each node must
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.                                        Page 77
  4735.  
  4736.  
  4737.  
  4738.           GAP Communications                                   System Files
  4739.  
  4740.  
  4741.  
  4742.  
  4743.           use a different configuration file and pass the name of this file
  4744.           to the QWKEXPRT module.
  4745.  
  4746.           The second  batch file  is called  REP.BAT. It is associated with
  4747.           the REP  command. This  file will invoke the REPIMPRT.EXE module,
  4748.           passing to  it  the  name  of  the  configuration  file  for  the
  4749.           appropriate node. Such a file would look like this:
  4750.  
  4751.                               REP.BAT
  4752.                               +------------------------+
  4753.                                 @echo off                              |                        |
  4754.                                 c:                              |                        |
  4755.                                 cd \gap\qwkrep                              |                        |
  4756.                                 repimprt qwkrep1.cnf                              |                        |
  4757.                                 c:                              |                        |
  4758.                                 cd \gap                              |                        |
  4759.                               +------------------------+
  4760.  
  4761.           Notice that  the file  changes  into  the  QWKREP  directory  and
  4762.           invokes  the   REPIMPRT  module,  passing  it  the  name  of  the
  4763.           configuration file  for Node  1. If  you run  multiple nodes, you
  4764.           will need  a REP.BAT  file for  each node.  The  only  difference
  4765.           between the  files would  be the drive and directory designators,
  4766.           and the  line that  calls up  the REPIMPRT module. Each node must
  4767.           use a different configuration file and pass the name of this file
  4768.           to the REPIMPRT module.
  4769.  
  4770.           Both QWK/REP modules can share the same configuration file.
  4771.  
  4772.           In Configuration, on the Main Menu Commands screen, you enter the
  4773.           security level  a user  must have in order to use the QWK and REP
  4774.           commands.
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.                                        Page 78
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.           Chapter 5
  4803.  
  4804.  
  4805.  
  4806.                                                         Modem Configuration
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.           The modem  used with GAP must be of the smart modem variety where
  4813.           it is  capable of  sending  verbose  result  codes  (i.e.,  RING,
  4814.           CONNECT,  CONNECT  2400).  In  addition,  you  must  be  able  to
  4815.           configure the  DTR and  CD lines. If your modem does not meet any
  4816.           of  these   requirements,  GAP   will  not   run  as   a   remote
  4817.           communications system.
  4818.  
  4819.           The modem  cable must  have pin  22  (the  Ring  Indicator  line)
  4820.           connected. If  it does  not you will have to configure GAP to not
  4821.           answer on True Ring Detect.
  4822.  
  4823.           The following modem conditions must be set:
  4824.  
  4825.                +  DTR is off
  4826.                +  Send result codes
  4827.                +  Full result words sent
  4828.                +  Commands are not echoed back to computer
  4829.                +  Auto answer is off
  4830.                +  Carrier detect is off
  4831.                +  Normal phone jack configuration
  4832.                +  Enable modem to recognize commands
  4833.                +  Use normal AT command set
  4834.  
  4835.           You may  have to  do some  experimenting with  the modem INIT and
  4836.           RESET strings in order to "fine tune" it to gap. If your modem is
  4837.           incapable of  asserting the  Ring Indicator  line or  if for some
  4838.           reason your  modem cable  does not have pin 22 hooked up, be sure
  4839.           to set the flag for answering on true ring detect to N.
  4840.  
  4841.  
  4842.           General Information
  4843.  
  4844.           It is  important that  your modem  be set  to  not  automatically
  4845.           answer the  phone. If  a user  disconnects while inside of a door
  4846.  
  4847.  
  4848.  
  4849.  
  4850.                                        Page 79
  4851.  
  4852.  
  4853.  
  4854.           GAP Communications                            Modem Configuration
  4855.  
  4856.  
  4857.  
  4858.  
  4859.           and the modem subsequently answers a call while GAP is recycling,
  4860.           it is  possible for a different user to gain access to the system
  4861.           as the  person who disconnected. The disconnected user could have
  4862.           been YOU!
  4863.  
  4864.           A very  common error  in configuring  the modem  is  leaving  the
  4865.           factory default  of carrier  detect  always  on.  GAP  must  have
  4866.           control over  this signal. You will know if your modem is set for
  4867.           CD always  true if  you find  that GAP  is unable  to hang  up  a
  4868.           caller.  You  may  also  see  the  modem  off-hook  string  being
  4869.           displayed on  the screen.  On  non-NRAM  modems,  CD  is  usually
  4870.           controlled by  an external  switch. For  most NRAM  modems, CD is
  4871.           controlled by the "&D2" command.
  4872.  
  4873.           Another common  problem is  that GAPMENU establishes a connection
  4874.           at the wrong bps rate or the program immediately recycles as soon
  4875.           as a connection is established. This occurs with modems which are
  4876.           slow in  returning the  CONNECT message.  If you  experience this
  4877.           problem, set  the Seconds  To Wait For Connect to 1 or 2 seconds.
  4878.           This will  force GAPMENU  to wait  the specified  amount of  time
  4879.           before looking for the CONNECT message from the modem.
  4880.  
  4881.           If you  find that GAPMENU simply does not recognize the fact that
  4882.           the phone is ringing, set Answer On True Ring Detect to No.
  4883.  
  4884.           When using  high  speed  modems,  certain  guide  lines  must  be
  4885.           followed in  order to  achieve the  highest throughput  possible.
  4886.           With these  modems, it  is necessary  to configure both the modem
  4887.           and the software driving the modem to not autobaud.  That is, you
  4888.           do not want the modem to change the computer to modem bps rate to
  4889.           match that of the caller. You want the DTE rate to stay locked in
  4890.           at the  higher bps  rate. By setting the Opening Baud rate to the
  4891.           highest speed  at which your modem is capable and locking in that
  4892.           rate, you  will achieve the highest throughput possible with your
  4893.           modem.
  4894.  
  4895.           If your high speed modem does not return the true CONNECT rate of
  4896.           the caller  but instead returns the Computer to Modem (DTE) rate,
  4897.           you will  need to  set the  Caller Connect  BPS Rate to a rate of                                      
  4898.           your choosing. GAP will then use this sysop supplied CONNECT rate
  4899.           when calculating  file transfer efficiency ratings and the amount
  4900.           of files a user can download.
  4901.  
  4902.           If during  uploads you  see that  GAP is  displaying a  CRC error
  4903.           every time  it writes  a block  of data  to the  hard drive,  you
  4904.  
  4905.  
  4906.  
  4907.  
  4908.                                        Page 80
  4909.  
  4910.  
  4911.  
  4912.           GAP Communications                            Modem Configuration
  4913.  
  4914.  
  4915.  
  4916.  
  4917.           probably need  to turn  the RTS  Off During Disk Write option On.
  4918.           Note that this is only applicable to modems that support hardware
  4919.           handshaking.
  4920.  
  4921.           Probably  the   most  common   mistake  that   sysops  make  when
  4922.           configuring their  modems is  that they  fail to  use a  carriage
  4923.           return and  a delay  after their Reset and Init strings. You need
  4924.           one carriage return and at least a one second pause after both of
  4925.           these strings.
  4926.  
  4927.           Many modems absolutely require that an H0 (go On Hook command) be
  4928.           issued in the Init string.
  4929.  
  4930.           Sample Configurations
  4931.  
  4932.           Note that  you must  provide your  own C/R  (carriage return) and
  4933.           delays in your strings. A { represents a C/R and a ~ represents a
  4934.           1/2 second pause.
  4935.  
  4936.           USRobotics VARModem 2400
  4937.           USRobotics Courier 2400
  4938.           USRobotics Sportster 2400
  4939.  
  4940.           RESET String                  : ATZ{~~ATZ{~~
  4941.           INIT String                   : ATM0Q0E0H0V1X4S0=0S7=60{~~
  4942.           Answer On True Ring Detect    : YES
  4943.           Additional Information        : These modems require two ATZ's in
  4944.                                           the reset string.
  4945.  
  4946.  
  4947.           USRobotics Courier HST - External
  4948.  
  4949.           RESET String                  : ATZ{~~
  4950.           INIT String                   : ATH0{~~
  4951.           Answer On True Ring Detect    : YES
  4952.           Additional Information        : To set up the NRAM for GAP, go in
  4953.                                           to your communications program,
  4954.                                           set the baud rate to the opening
  4955.                                           rate you set in GAPSETUP, then
  4956.                                           type the following:
  4957.                                           ATC1E0F1M0Q0V1X4B1S2=255
  4958.                                           AT&A1&G0&H1&I0&M4&N0&P0&R2&
  4959.                                           AT&S1&Y1&B1&K1&W
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.                                        Page 81
  4967.  
  4968.  
  4969.  
  4970.           GAP Communications                            Modem Configuration
  4971.  
  4972.  
  4973.  
  4974.  
  4975.           USRobotics Courier HST Dual Standard- External
  4976.  
  4977.           RESET String                  : ATZ{~~
  4978.           INIT String                   : ATH0{~~
  4979.           Answer On True Ring Detect    : YES
  4980.           Additional Information        : To set up the NRAM for GAP, go in
  4981.                                           to your communications program,
  4982.                                           set the baud rate to the opening
  4983.                                           rate you set in GAPSETUP, then
  4984.                                           type the following:
  4985.                                           ATB0F1M0X7&A3&B1&G0&H1&I0&J0
  4986.                                           AT&K3&L0&M4&N0&P0&R2&S1&X0
  4987.                                           AT&Y1S2=255&W
  4988.  
  4989.  
  4990.           VenTel halfcard internal 2400 bps
  4991.  
  4992.           RESET String                  : NONE
  4993.           INIT String                   : ATV1Q0E0X4S0=0S2=43{~~
  4994.           Answer On True Ring Detect    : NO
  4995.           Additional Information        : Uses factory default settings
  4996.                                           other than those changed by the
  4997.                                           INIT string.
  4998.  
  4999.  
  5000.           Packard Bell 2400 Internal
  5001.  
  5002.           RESET String                  : AT&F{~~
  5003.           INIT String                   : AT&D2E0S7=45S10=50{~~
  5004.           Answer On True Ring Detect    : NO
  5005.  
  5006.  
  5007.           Everex EV940 2400
  5008.  
  5009.           RESET String                  : ATZ{~~ATZ{~~
  5010.           INIT String                   : ATE1V1X1&D2S7=60S11=70S0=0{~~
  5011.           Answer On True Ring Detect    : YES
  5012.  
  5013.  
  5014.           Quick Comm Internal
  5015.  
  5016.           RESET String                  : ATZ{~~
  5017.           INIT String                   : ATE1S7=255S11=50V1X1S0=1{~~
  5018.           Answer On True Ring Detect    : NO
  5019.  
  5020.  
  5021.  
  5022.  
  5023.  
  5024.                                        Page 82
  5025.  
  5026.  
  5027.  
  5028.           GAP Communications                            Modem Configuration
  5029.  
  5030.  
  5031.  
  5032.  
  5033.           CTS Datacomm 2424ADH
  5034.  
  5035.           RESET String                  : ATZ{~~
  5036.           INIT String                   : ATM0V1&C1&D2X4S7=30S10=50&W{~~
  5037.           Answer On True Ring Detect    : YES
  5038.           Additional Information        : Configure to disconnect and
  5039.                                           return to command mode after loss
  5040.                                           of DTR and disable auto answer
  5041.                                           until DTR is reasserted.
  5042.  
  5043.  
  5044.           Anchor Lighting Internal F/1 2400
  5045.  
  5046.           RESET String                  : ATZ{~~
  5047.           INIT String                   : {AT&FX1V1Q0M0E0S7=60{~~
  5048.           Answer on True Ring Detect    : NO
  5049.           Additional Information        : To configure use the above init
  5050.                                           string with an &W.
  5051.  
  5052.  
  5053.           Incomm Turbo 2400 External
  5054.  
  5055.           RESET String                  : ATZ{~~
  5056.           INIT String                   : AT&C1&D2S0=0E0M0Q0V1X4{~~
  5057.           Answer On True Ring Detect    : NO
  5058.           Additional Information        : Set all external switches down.
  5059.                                           Set the delay for Connect to 2
  5060.                                           seconds.
  5061.  
  5062.  
  5063.           Avatex 2400
  5064.  
  5065.           RESET String                  : ATZ{~~
  5066.           INIT String                   : ATH0E0Q0M0X1V1S7=60S11=60{~~
  5067.           Answer On True Ring Detect    : NO
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.  
  5074.  
  5075.  
  5076.  
  5077.  
  5078.  
  5079.  
  5080.  
  5081.  
  5082.                                        Page 83
  5083.  
  5084.  
  5085.  
  5086.           GAP Communications                            Modem Configuration
  5087.  
  5088.  
  5089.  
  5090.  
  5091.           Multitech 224EH
  5092.  
  5093.           RESET String                  : ATZ{~~
  5094.           INIT String                   : ATS2=255C1E0X1M0H0{~~
  5095.           Answer On True Ring Detect    : No
  5096.           Additional Information        : Open Com Port at 9600 and lock
  5097.                                           baud rate. Go into Communications
  5098.                                           program and type the following:
  5099.                                           ATB1E0M0Q0V1X1&E1&E4&E7&E8
  5100.                                           AT&E15&Q0$MB2400$SB9600$BA0
  5101.                                           AT&A0$A1&B0&BS1&C1$D0$F1&G0
  5102.                                           AT&I0&MI0$R1&S1&T5&V1&W0
  5103.  
  5104.  
  5105.           Zoom
  5106.  
  5107.           RESET String                  : ATZ{~~ATZ{~~
  5108.           INIT String                   : ATE0F1Q0V1X4S0=1H0{~~
  5109.           Answer On True Ring Detect    : NO
  5110.  
  5111.  
  5112.           Hayes 9600 V-Series
  5113.  
  5114.           RESET String                  : ATZ{~~
  5115.           INIT String                   : ATH0{~~
  5116.           Answer On True Ring Detect    : NO
  5117.           Additional Information        : Lock Com port at 19200. Go into
  5118.                                           Communications program, set baud
  5119.                                           rate to 19200 and type the
  5120.                                           following:
  5121.                                           ATM0L2Q0V1X4W1&C1&D2&S0&K3
  5122.                                           AT&T5&L0&G0&J0&P0E0N1B1Y0
  5123.                                           ATS0=0S36=1S37=0S38=2&W
  5124.                                           Set delay for Connect to 4 or
  5125.                                           more seconds.
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.  
  5136.  
  5137.  
  5138.  
  5139.  
  5140.                                        Page 84
  5141.  
  5142.  
  5143.  
  5144.           GAP Communications                            Modem Configuration
  5145.  
  5146.  
  5147.  
  5148.  
  5149.           Microcom AX9624C
  5150.  
  5151.           RESET String                  : ATZ{~~
  5152.           INIT String                   : ATH0{~~
  5153.           Answer On True Ring Detect    : YES
  5154.           Additional Information        : Go into Communications program,
  5155.                                           set the baud rate, and type the
  5156.                                           following:
  5157.                                           AT\G0\N3S0=0Q3X0K5E0Q0V1\V1\J1
  5158.                                           AT\E0\T0%E1%C1%P2%M0\A3\C2%A13
  5159.                                           AT\H0S8=2S2=255&D2&C1\D0\R1M0
  5160.                                           AT&L0&M0&T5X1&P0&G0B1&W
  5161.  
  5162.  
  5163.           LightCom 96/V.32/V.42bis
  5164.           LightCom 14.4/V.32/V.42bis
  5165.  
  5166.           RESET String                  : ~ATZ{~~
  5167.           INIT String                   : AT&F&C1&D2&Q5Q0E0V1X4S0=0S7=60
  5168.                                           S95=47{~~
  5169.           Answer On True Ring Detect    : YES
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.  
  5193.  
  5194.  
  5195.  
  5196.  
  5197.  
  5198.                                        Page 85
  5199.  
  5200.  
  5201.  
  5202.  
  5203.  
  5204.  
  5205.  
  5206.  
  5207.  
  5208.           Chapter 6
  5209.  
  5210.  
  5211.  
  5212.                                                                       Doors
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.           GAP allows  you to  set up  external programs  to be  run by your
  5219.           users. Such programs are called Doors.
  5220.  
  5221.           Door programs  generally provide  for  their  own  communications
  5222.           routines. As  such, you  need not  worry about  a loss of carrier
  5223.           while a user is in the door. It is suggested that you not use any
  5224.           door program  which depends  upon  CTTY  or  any  other  form  of
  5225.           redirection and  that you  not use any program which requires the
  5226.           use of an external carrier detect monitor (WATCHDOG).
  5227.  
  5228.           To run doors, you will need to create a Door Menu. This menu will
  5229.           list the  available doors  on your system. The user will choose a
  5230.           door by  typing its  corresponding number  at the Door Menu or by
  5231.           typing its name at the Main Command prompt.
  5232.  
  5233.                     DOORM
  5234.                     +--------------------------------------------+
  5235.                     |                                            |
  5236.                                 The Crow's Nest Doors                    |                                            |
  5237.                     |                                            |
  5238.                                 1   -  Power Struggle                    |                                            |
  5239.                                 2   -  Tourist                    |                                            |
  5240.                                 3   -  Trade Wars                    |                                            |
  5241.                     |                                            |
  5242.                     +--------------------------------------------+
  5243.  
  5244.           To tell  GAP how  many doors you have and what their names are, a
  5245.           DOORS data file is used. This file contains the name of the batch
  5246.           files that run the doors and the security levels a user must have
  5247.           in order to invoke a door.
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.                                        Page 87
  5257.  
  5258.  
  5259.  
  5260.           GAP Communications                                          Doors
  5261.  
  5262.  
  5263.  
  5264.  
  5265.           In GAPSETUP, select Doors from the Files Menu:
  5266.  
  5267.                                   Files
  5268.                                   +----------------+
  5269.                                     Seclev                                  |                |
  5270.                                     Doors                                  |                |
  5271.                                     Ext Protocols                                  |                |
  5272.                                   +----------------+
  5273.  
  5274.           A pick  list will appear asking you to select a DOORS.DAT file to
  5275.           edit. Normally  there will  be only  one  file  to  choose  from,
  5276.           however some  multi node systems may have separate door files for
  5277.           each of  their nodes.  After selecting  a file  to work with, the
  5278.           Editor will  appear and  you will  then be able to configure your
  5279.           Doors Data file.
  5280.  
  5281.  
  5282.           Doors Data File Editor
  5283.  
  5284.           ARTWORK
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.           Name is the name you wish to give this particular Door. Names may
  5301.           be up  to 15  characters in  length, contain  any combination  of
  5302.           upper and lower case letters but may not contain any spaces.
  5303.  
  5304.           If a  user attempts  to open  a door by simply typing its name at
  5305.           the Command  Prompt, the name you enter here is the name GAP will
  5306.           look for to see if there is a match with the name the user typed.
  5307.  
  5308.           Level is  the Security  Level a  user must  have in order to Open
  5309.           this particular Door.
  5310.  
  5311.  
  5312.  
  5313.  
  5314.                                        Page 88
  5315.  
  5316.  
  5317.  
  5318.           GAP Communications                                          Doors
  5319.  
  5320.  
  5321.  
  5322.  
  5323.  
  5324.           Path is the full Path and Name to this particular Door Batch file
  5325.           (or  program).  When  GAP  opens  this  door,  it  will  use  the
  5326.           information you  type in this field to find and run the door. The
  5327.           batch file  is placed  in the directory you specify. Such a batch
  5328.           file might look like this:
  5329.  
  5330.                               DOOR.BAT
  5331.                               +------------------------+
  5332.                                 echo off                              |                        |
  5333.                                 cd\gap\doors                              |                        |
  5334.                                 tourist tourist.cnf                              |                        |
  5335.                                 c:                              |                        |
  5336.                                 cd\gap                              |                        |
  5337.                               +------------------------+
  5338.  
  5339.           When a  caller selects  a  door  to  open,  GAP  will  check  the
  5340.           DOORS.DAT file to see if the caller has a high enough security to
  5341.           open the  requested door.  If so,  GAP will  swap itself  out  of
  5342.           memory and  run the  batch file  specified. When the door program
  5343.           has completed  GAP will  regain control  and return the caller to
  5344.           the Main Command prompt.
  5345.  
  5346.           The bottom  status line  shows the Editor Keys. Context sensitive
  5347.           help is available for each field by pressing the F1 Help key.
  5348.  
  5349.                     Editor Keys
  5350.                     +--------------------------------------------+
  5351.                         Alt-D       -    Delete Line                    |                                            |
  5352.                         Alt-I       -    Insert Line                    |                                            |
  5353.                         F9          -    Save File                    |                                            |
  5354.                         F10         -    Save File As                    |                                            |
  5355.                         Esc         -    Quit                    |                                            |
  5356.                         UpArrow     -    Up Column                    |                                            |
  5357.                         DnArrow     -    Down Column                    |                                            |
  5358.                         Home        -    Beginning of File                    |                                            |
  5359.                         End         -    End of File                    |                                            |
  5360.                         Ctrl-Home   -    Previous Field                    |                                            |
  5361.                     +--------------------------------------------+
  5362.  
  5363.           When a  caller exits  through a  door, GAP  writes a  file called
  5364.           DOOR.SYS. This  is a standard door interface file, developed by a
  5365.           door programmer,  which makes  interfacing door programs with BBS
  5366.           programs a  simple task.  The file  is ASCII  and is  left on the
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.                                        Page 89
  5373.  
  5374.  
  5375.  
  5376.           GAP Communications                                          Doors
  5377.  
  5378.  
  5379.  
  5380.  
  5381.           disk. This  file allows  us to  modify GAP  and not have to worry
  5382.           about obsoleting a door program.
  5383.  
  5384.           Upon return  from a door, GAP will read the following fields from
  5385.           DOOR.SYS:
  5386.  
  5387.                          +----------------------------------+
  5388.                               Security Level                         |                                  |
  5389.                               Total Uploads                         |                                  |
  5390.                               Total Downloads                         |                                  |
  5391.                               Current Download K total                         |                                  |
  5392.                               Time Credits                         |                                  |
  5393.                               Current Download Files                         |                                  |
  5394.                               Total K bytes uploaded                         |                                  |
  5395.                               Total K bytes downloaded                         |                                  |
  5396.                          +----------------------------------+
  5397.  
  5398.           With regards  to time  credits, GAP will give the caller the time
  5399.           credits specified  in DOOR.SYS.  GAP doesn't  care if the credits
  5400.           are the same as when DOOR.SYS was written. This means that a door
  5401.           program is free to give or take away time from a caller (negative
  5402.           time credits  means the  caller looses  time). Of  course, if the
  5403.           caller's time was adjusted because of an upcoming event, GAP will
  5404.           ignore the  time  credit  field  in  DOOR.SYS.  Time  credits  in
  5405.           DOOR.SYS are on line 42 of that file.
  5406.  
  5407.           A door program is also free to change the caller's security level
  5408.           by modifying  line 15 of DOOR.SYS with the following restrictions
  5409.           (GAP will ignore the change if):
  5410.  
  5411.                + the caller is the sysop
  5412.                + the caller's level is at or above 100
  5413.                + the new level found in door.sys is at or above 105
  5414.                + This means  the  sysop  will  be  unaffected  by  any
  5415.                  security level changes a door may do.
  5416.  
  5417.           A "Trojan" door will be unable to give anyone (including the door
  5418.           author) a  high enough level such that the caller will be able to
  5419.           perform true  sysop functions.  This of  course depends  upon how
  5420.           your sysop levels are configured but as a good guideline, Sysop 4
  5421.           and Sysop  5 should  have levels  greater than  105. Basically, a
  5422.           door can  give security  levels only  up to 104 and cannot modify
  5423.           any caller's level if the caller is at 100 or greater.
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.                                        Page 90
  5431.  
  5432.  
  5433.  
  5434.           GAP Communications                                          Doors
  5435.  
  5436.  
  5437.  
  5438.  
  5439.           An assistant sysop (between 100 and up) will be unaffected by any
  5440.           security level changes.
  5441.  
  5442.           A door program may bypass the reading of DOOR.SYS by returning an
  5443.           error level  of 60 to GAPBBS. This is useful for those doors that
  5444.           do their  own updating  in the GAP USERS file and do not want GAP
  5445.           to "undo" the changes by reading DOOR.SYS.
  5446.  
  5447.           The Door Return Codes that GAP recognizes are:
  5448.  
  5449.                +------------------------------------------------------+
  5450.                  60     -     Do NOT read DOOR.SYS               |                                                      |
  5451.                  61     -     Force caller into a Comment               |                                                      |
  5452.                  62     -     Immediately Log the caller off the BBS               |                                                      |
  5453.                +------------------------------------------------------+
  5454.  
  5455.           If you  write door  programs to interface with GAP, and you would
  5456.           like to  have GAP  implement one  of the  above functions, simply
  5457.           make sure  that your program is the last program to be run in the
  5458.           door batch  file and  that your program returns one of the 'exit'
  5459.           codes that GAP recognizes.
  5460.  
  5461.           There are  a number  of door  programs available. They range from
  5462.           simple to  complex in  terms of configuration. When first setting
  5463.           up your  doors system, it is best to start with the simplest door
  5464.           program first,  and after  getting a  feel for  how to  configure
  5465.           these external  programs, move  on to the more complex. A program
  5466.           called Tourist  is available on the Support board. It is probably
  5467.           the easiest of all doors to configure. It is also one of the most
  5468.           amusing doors available.
  5469.  
  5470.           Each door program will offer suggestions and examples on how they
  5471.           are set up.
  5472.  
  5473.           Note that  a great  many Door programs can not support high speed
  5474.           communications. If  you have a high speed modem and you lock your
  5475.           COM port at 19,200, 38,400 or a higher bps setting, you will find
  5476.           that many  external programs will display garbage on the caller's
  5477.           screen because  the program can not open the COM port at the rate
  5478.           you use  for GAP.  In cases  such as this, you can either not use
  5479.           the program,  not lock your COM port at a speed greater than 9600
  5480.           bps, or  use an "UnLocker" program that will modify your DOOR.SYS
  5481.           file so  that the Door program "thinks" the COM port is locked at
  5482.           9600 bps.
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.                                        Page 91
  5489.  
  5490.  
  5491.  
  5492.  
  5493.  
  5494.  
  5495.  
  5496.  
  5497.  
  5498.           Chapter 7
  5499.  
  5500.  
  5501.  
  5502.                                                              Questionnaires
  5503.  
  5504.  
  5505.  
  5506.  
  5507.  
  5508.  
  5509.           Description
  5510.  
  5511.           The GAP questionnaire system utilizes a powerful script processor                                                  
  5512.           which allows  it to  "think" the  way a  sysop thinks  while  GAP
  5513.           processes a questionnaire.
  5514.  
  5515.           The sysop  is not limited to a simple set of "display prompt, get
  5516.           answer" scenarios.  With  a  limited  but  very  powerful  script
  5517.           language, the  sysop can  set up his questionnaires and determine
  5518.           what to  do with the answers. The sysop is no longer dependent on
  5519.           an external  "event" program  to  analyze  his/her  questionnaire
  5520.           answers.
  5521.  
  5522.           The sysop  is now completely in control of the questionnaires and
  5523.           their answers.  Nothing is  "hard coded"  except for  the  actual
  5524.           script language.
  5525.  
  5526.           Yes/No answers,  "anything" answers,  required answers,  multiple
  5527.           choice answers  are among  the few  features. GAP even allows the
  5528.           sysop to  direct the  "flow" of  a questionnaire  to another area
  5529.           depending on the answer the user gave.
  5530.  
  5531.           Not only  can the  sysop upgrade  a user's  level  based  on  the
  5532.           answers given,  but the sysop can also register users in specific
  5533.           forums!
  5534.  
  5535.           There can  be 99 main board questionnaires plus one questionnaire
  5536.           for new  users. In  addition, each  Forum can have its own set of
  5537.           files (questionnaires, menus, and answer files).
  5538.  
  5539.           The sysop  no longer  need tell  a new user that registration may
  5540.           take 2  or 3  days. GAP's  questionnaire processor  can take  the
  5541.           drudgery  out  of  new  user  registrations!  New  users  can  be
  5542.  
  5543.  
  5544.  
  5545.  
  5546.                                        Page 93
  5547.  
  5548.  
  5549.  
  5550.           GAP Communications                                 Questionnaires
  5551.  
  5552.  
  5553.  
  5554.  
  5555.           registered immediately  and automatically with no extra effort on
  5556.           the sysop's  part other  than to  create a powerful questionnaire
  5557.           script!
  5558.  
  5559.  
  5560.           Setup
  5561.  
  5562.             +  Menus      =  QMENU and QMENUG       -  Located in GEN
  5563.             +  Questions  =  QUESTxx and NEWQUEST   -  Located in MAIN
  5564.             +  Answers    =  Sysop specified        -  Located in MAIN
  5565.  
  5566.           In GAPSETUP,  the sysop  specifies the  first 6 characters of the
  5567.           answer  files.   There  are  two  files.  One  is  for  new  user
  5568.           registration that  the new user will be forced to complete if the
  5569.           file  NEWQUEST   exists,  and   the  other  is  for  the  general
  5570.           questionnaires. There  is one  answer file for each questionnaire
  5571.           file.
  5572.  
  5573.           Each Forum  can have  its own  set  of  questionnaires.  The  GEN
  5574.           directory is  equivalent to  the Forum GEN directory and the MAIN
  5575.           directory is equivalent to the Forum DEFAULT directory.
  5576.  
  5577.           Two menu  files must  be created.  Their format is similar to the
  5578.           doors menu  files. One  file, QMENU,  is a  plain ASCII file. The
  5579.           other, QMENUG, is an ANSI color version of the same file.
  5580.  
  5581.           Examples of  the actual  questionnaires are  given later  in this
  5582.           chapter. The answer files will be created by GAP as needed.
  5583.  
  5584.  
  5585.           Overview
  5586.  
  5587.           GAP will not ask the user if he/she wishes to fill out the chosen                   
  5588.           questionnaire. It  is up to each questionnaire to ask the user if
  5589.           he/she wishes  to continue  if the sysop wants to verify that the
  5590.           user has chosen the correct questionnaire.
  5591.  
  5592.           There is  no predetermined  header to  a questionnaire  file. The
  5593.           sysop is  free to  format the  headers anyway  he chooses. He may
  5594.           also choose to not have a header and simply begin right away with
  5595.           the questions.
  5596.  
  5597.           Anything the  user is  to see  must  be  preceded  with  an  '*'.
  5598.           Everything appearing  after the asterisk will be displayed to the
  5599.           user and written to the answer file. If you would rather have the
  5600.  
  5601.  
  5602.  
  5603.  
  5604.                                        Page 94
  5605.  
  5606.  
  5607.  
  5608.           GAP Communications                                 Questionnaires
  5609.  
  5610.  
  5611.  
  5612.  
  5613.           text displayed  to the  user and  not written to the answer file,
  5614.           use an ampersand '&' character instead.
  5615.  
  5616.           All user input takes place on a separate line.
  5617.  
  5618.           Labels are  8 character  (or less) names. They may not begin with
  5619.           one of  the processor commands. There is no case distinction with
  5620.           labels. Lower  case characters  are converted to uppercase before
  5621.           any comparison takes place.
  5622.  
  5623.           Gotos must  reference a  label. If  a label  is  not  found,  the
  5624.           questionnaire is  aborted and  the user is told the questionnaire
  5625.           is not valid.
  5626.  
  5627.           A regular goto directs the flow forward in the questionnaire.
  5628.  
  5629.           A reverse goto directs the flow backwards toward the start of the
  5630.           questionnaire. In  fact,  the  processor  starts  over  from  the
  5631.           beginning  of   the  questionnaire  looking  for  the  label  you
  5632.           specified.
  5633.  
  5634.           Caution must  be used  with gotos. It is very easy to become lost
  5635.           in your  own questionnaire  if there  is an  excessive number  of
  5636.           gotos. The  basic use  for a goto is to redirect the flow back up
  5637.           to a  prompt and  question in  case an incorrect answer was given
  5638.           (i.e., didn't answer Y or N, or didn't give one of the choices in
  5639.           a multiple  choice). Another  use might be for directing the flow
  5640.           to a label that will raise or lower the users security level.
  5641.  
  5642.           Raising security  levels will not affect a user if he/she already
  5643.           has a level that is higher than the level specified.
  5644.  
  5645.           Lowering security  levels should  be used  with caution. GAP will
  5646.           make sure  that a  person with a level of 100 or greater will not
  5647.           be affected  by this  command. Keep  in mind  that some  of  your
  5648.           better callers  with higher  levels than  most may find that they
  5649.           are suddenly at a lower level!
  5650.  
  5651.           Y (yes/no)  answers must  be followed  by 3  commands  which  can
  5652.           either be  labels to  do nothing,  or gotos to other areas of the
  5653.           questionnaire.  They  can  also  be  either  the  Abort  or  Exit
  5654.           commands. The  third line  is for a response that was neither a Y
  5655.           or an N.
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.                                        Page 95
  5663.  
  5664.  
  5665.  
  5666.           GAP Communications                                 Questionnaires
  5667.  
  5668.  
  5669.  
  5670.  
  5671.           The basic format for the Y command is as follows :
  5672.  
  5673.                +------------------------------------------------------+
  5674.                  Y   -   tells processor to accept a yes/no input               |                                                      |
  5675.                  x   -   processor does this if answer is Yes               |                                                      |
  5676.                  x   -   processor does this if answer is No               |                                                      |
  5677.                  x   -   processor does this if answer is not Y or N               |                                                      |
  5678.                +------------------------------------------------------+
  5679.  
  5680.           Notice that  there are 3 possible responses to the Y command. The
  5681.           x can be a Goto, a Label, Abort or Exit. If it is simply a label,                     
  5682.           then the  flow will  "fall through" to the next valid command. If
  5683.           the answer  were a  Yes, and  the following  line is a label, the
  5684.           next three lines would be skipped. For Yes/No responses, the user
  5685.           is allowed to type in the words as well as Y or N.
  5686.  
  5687.           M (multiple  choice) answers  must be followed by an equal number
  5688.           of commands as there are choices plus 1 extra line for a response
  5689.           that was  not one of the choices. Similar to the Y command, these
  5690.           lines can  be either  labels, or  gotos to  other areas. They may
  5691.           also be either the Abort or Exit commands.                             
  5692.  
  5693.           The M  command must  be followed  by the number of choices (up to
  5694.           99). For  instance M10  means there are 10 choices. Following the
  5695.           Mx command,  you would  then have  11 lines to tell the processor
  5696.           what to do with the responses.
  5697.  
  5698.           The choices for multiple choice must be numeric.
  5699.  
  5700.           It is  extremely important  to adhere  to the required format for
  5701.           the Y  and M  commands. For  the  Y  command,  there  must  be  3
  5702.           additional commands  following the  Y.  The  M  command  must  be
  5703.           followed by  an equal number of commands after the M as there are
  5704.           choices (plus  one extra  command for a response that was not one
  5705.           of the  choices). Failure  to follow these guidelines will result
  5706.           in the  processor becoming  confused and  not knowing how to deal
  5707.           with your questionnaire.
  5708.  
  5709.           If an  Abort or an Exit command is found as one of the additional                 
  5710.           commands to  the Y  and M commands, the user will be displayed an
  5711.           appropriate message.  For instance,  if in  a Yes/No  command the
  5712.           user types  NO, and the command you entered for a NO response was
  5713.           the Abort  command, the  user will  be displayed  a message  that              
  5714.           his/her answers  are being discarded. It is not necessary for you
  5715.           to direct  the flow  to a  different area with a goto so that you
  5716.  
  5717.  
  5718.  
  5719.  
  5720.                                        Page 96
  5721.  
  5722.  
  5723.  
  5724.           GAP Communications                                 Questionnaires
  5725.  
  5726.  
  5727.  
  5728.  
  5729.           can tell  the user  his/her answers  are unacceptable  unless you
  5730.           want to do so!
  5731.  
  5732.           ? and  R responses are limited to 60 characters. In addition, the
  5733.           text following an '*' is limited to 80 characters.
  5734.  
  5735.           The ??xx  command is  similar to  the ?  command except  that you
  5736.           specify the maximum number of lines the user is allowed to enter.
  5737.           A C/R on a blank line will end the input. Your text should inform
  5738.           the user  of the  maximum number  of lines  and what to do to end
  5739.           their input:
  5740.  
  5741.             You will  have up  to xx lines. Press [Enter] on a blank line
  5742.             to end.
  5743.  
  5744.           For the  Required command, you must specify the minimum number of                   
  5745.           characters that  the user  must enter.  The user  must enter  the
  5746.           required number of characters. The only way for the user to leave
  5747.           this field  is to either enter the required number of characters,
  5748.           or hang up.
  5749.  
  5750.           For Date fields, the user will not be allowed to enter an invalid
  5751.           date. The caller must either enter a valid date or hang up.
  5752.  
  5753.           If the  user returns out of a Phone field without entering all of
  5754.           the digits of the phone number, the processor will abort.
  5755.  
  5756.           If you  would like  to enter  comments  into  the  questionnaire,
  5757.           precede the  comment with  a '.'  (i.e.,   .This is  a  comment).
  5758.           Comments are not written to the answer file.
  5759.  
  5760.           If you  would like  to enter a heading and have it written to the
  5761.           answer file, precede the text with a ':' (i.e.,  : AGE GROUP).
  5762.  
  5763.           The X  command allows  you  to  call  GAP  functions.  There  are
  5764.           currently four  functions hooked  up: show_file,  pause, comment,                                                
  5765.           and door. The X command takes various parameters depending on how
  5766.           you wish  to utilize it. Note that the X is in upper case and the
  5767.           parameters are in lower case.
  5768.  
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.  
  5777.  
  5778.                                        Page 97
  5779.  
  5780.  
  5781.  
  5782.           GAP Communications                                 Questionnaires
  5783.  
  5784.  
  5785.  
  5786.  
  5787.           The pause function gives the user the pause prompt. The show_file              
  5788.           function is  the routine  that displays  all of the text files on
  5789.           the system:
  5790.  
  5791.           +----------------------------------------------------------------+
  5792.             Xpause                      -   will issue the pause prompt.          |                                                                |
  5793.             Xshow_file C:\GAP\GEN\BLT1  -   will display the main board          |                                                                |
  5794.                                             bulletin #1.          |                                                                |
  5795.           +----------------------------------------------------------------+
  5796.  
  5797.           Since you  have no  way of telling if the user is in expert mode,
  5798.           if you  use the Xshow_file command you should also use the Xpause
  5799.           command to  force a  pause prompt  (before and  after  showing  a
  5800.           file).
  5801.  
  5802.           Xcomment allows  you to  force a user into the message system and
  5803.           automatically be  lead into  comment  entry.  When  the  user  is
  5804.           finished entering  the comment,  he/she will  be returned  to the
  5805.           exact place  in the  questionnaire where they left off. Remember,
  5806.           although you  may force  the user  to leave  you a  comment,  you
  5807.           cannot force them to save it!
  5808.  
  5809.           Xdoor #  (where #  is the  number of a door to run) allows you to
  5810.           force a  user out  through a  door. The  primary purpose  of this
  5811.           command is  to force  a user  into a call back verify door in the
  5812.           NEWQUEST. Note  that using  this command  is the same as the user
  5813.           opening a  door by  him/her self.  GAP will shut down and run the
  5814.           door, so  it is  not possible to return to the questionnaire. The
  5815.           user will return to GAP and be placed at the main command prompt.
  5816.           This command  takes affect  immediately so  if  there  are  other
  5817.           questions in the questionnaire, they will not be asked. Note that
  5818.           in using  this command  in a NEWQUEST, the security level to open
  5819.           doors as  well as the level to open this specific door must be at
  5820.           least as  low as  the new user's level. For instance, if you give
  5821.           new users  a level  of 10,  the level for OPEN must be 10 and the
  5822.           level for  the door you intend to open (in DOORS.DAT) must be 10.
  5823.           In addition,  the door  must  be  working  properly.  Failure  to
  5824.           observe these  simple rules  will lead  to a bit of embarrassment
  5825.           for you with your new users!
  5826.  
  5827.           The Fx command can be used with a range of numbers. For instance,
  5828.           if you would like to allow your callers to register themselves in
  5829.           Forums 5-9,  you may  use F5-9.  Note that there can be no spaces
  5830.           between the '-'.
  5831.  
  5832.  
  5833.  
  5834.  
  5835.  
  5836.                                        Page 98
  5837.  
  5838.  
  5839.  
  5840.           GAP Communications                                 Questionnaires
  5841.  
  5842.  
  5843.  
  5844.  
  5845.           The CheckLevel  command (case  is not  important) allows  you  to
  5846.           check a  user's security  level and make a decision as to what to
  5847.           do next  based upon  the result.  The format  of CheckLevel is as
  5848.           follows:
  5849.  
  5850.           +----------------------------------------------------------------+
  5851.             CheckLevel Level - Check user's security level          |                                                                |
  5852.           |                                                                |
  5853.             x  -   processor does this if user's level is same as level          |                                                                |
  5854.             x  -   processor does this if user's level is less than level          |                                                                |
  5855.             x  -   processor does this if user's level is greater than          |                                                                |
  5856.                    level          |                                                                |
  5857.           +----------------------------------------------------------------+
  5858.  
  5859.           The x  can be  a Goto, a Label, Abort or Exit. You must provide 3                           
  5860.           additional commands  after the  CheckLevel command.  The form and
  5861.           function of CheckLevel is identical to the Y command.
  5862.  
  5863.           The  DEL_USER   command  deletes   the  user   filling  out   the
  5864.           questionnaire from  the User  File.  The  user  is  not  actually
  5865.           deleted until  after the  questionnaire is  completed. After  GAP
  5866.           deletes the user it will recycle back to GAPMENU.
  5867.  
  5868.           The STOPCLOCK  command turns  off the clock so that the user does
  5869.           not loose any time while filling out the questionnaire.
  5870.  
  5871.           The CCARD  command allows  the questionnaire  script  to  process
  5872.           credit cards. The syntax of the command is:
  5873.  
  5874.                CCARD XXXX
  5875.  
  5876.           where "XXXX"  is 'A',  'D', 'M',  or 'V'  for  American  Express,
  5877.           Discover, MasterCard, or VISA
  5878.  
  5879.  
  5880.  
  5881.  
  5882.  
  5883.  
  5884.  
  5885.  
  5886.  
  5887.  
  5888.  
  5889.  
  5890.  
  5891.  
  5892.  
  5893.  
  5894.                                        Page 99
  5895.  
  5896.  
  5897.  
  5898.           GAP Communications                                 Questionnaires
  5899.  
  5900.  
  5901.  
  5902.  
  5903.           The command  is similar  to the Yes/No command in that it must be
  5904.           followed by  3 commands  which will  take action  based upon  the
  5905.           return value from the Credit Card processor:
  5906.  
  5907.           +----------------------------------------------------------------+
  5908.             CCARD VM          |                                                                |
  5909.           |                                                                |
  5910.             x  -   do this if  the Credit Card processing was successful          |                                                                |
  5911.             x  -   do this if the user aborted the Credit Card processing          |                                                                |
  5912.             x  -   do this if there is a problem with the Questionnaire          |                                                                |
  5913.                    processing          |                                                                |
  5914.           +----------------------------------------------------------------+
  5915.  
  5916.           An example of the command would be:
  5917.  
  5918.                CCARD VM
  5919.                >thankyou
  5920.                <getord
  5921.                >problem
  5922.  
  5923.                The above  example tells the Credit Card processor that
  5924.                only VISA  and MasterCard  are accepted.  If you accept
  5925.                all 4 card types you can use: CCARD ADVM.
  5926.  
  5927.                The 1st  line after  the command sends the processor to
  5928.                the label  'thankyou', where  the script will thank the
  5929.                caller for the order.
  5930.  
  5931.                The 2nd line after the command sends the processor back
  5932.                to the  order menu, since the caller failed to complete
  5933.                all the questions asked of him/her.
  5934.  
  5935.                The 3rd  line after  the command sends the processor to
  5936.                problem section  of the  script so it can tell the user
  5937.                that there  was a problem with the questionnaire and to
  5938.                "try again later".
  5939.  
  5940.           Most  of   the  ordering   process  is  performed  using  regular
  5941.           questionnaire commands.  The Credit  Card processor  insures that
  5942.           the user  enters a  valid Credit Card Number, that the Expiration
  5943.           Date on  the card is current, and that the user's address info is
  5944.           correct. The  user will  be given  a chance  to enter a different
  5945.           Name/Address, however  these changes  will not be written back to
  5946.           the user file.
  5947.  
  5948.  
  5949.  
  5950.  
  5951.  
  5952.                                       Page 100
  5953.  
  5954.  
  5955.  
  5956.           GAP Communications                                 Questionnaires
  5957.  
  5958.  
  5959.  
  5960.  
  5961.           A sample  Questionnaire Script  is included  on the  distribution
  5962.           disks and   you  may use it as a guideline if you wish to use the
  5963.           Credit Card  processor. The  best way  to get  a feel  for how it
  5964.           works is  to set  it up  as a  questionnaire, fill it out several
  5965.           times and study the resultant answer file.
  5966.  
  5967.           Since the  processor validates  Credit Cards,  you  must  have  a
  5968.           legitimate credit card number or you will not be able to complete
  5969.           the script.
  5970.  
  5971.           The PRIVUSER  command allows you to set the Private User flag for
  5972.           the user  to Yes.  This command  would  normally  be  used  in  a
  5973.           NEWQUEST after  you have  determined that  the user qualifies for
  5974.           membership to your private board.
  5975.  
  5976.           The JOIN  command allows  you to  register a  user in a Forum and
  5977.           automatically  "put"   that  user   in  the   Forum   after   the
  5978.           Questionnaire  is   completed.  In   the  case   of  a  New  User
  5979.           Questionnaire (NEWQUEST)  the command  will not  take place until
  5980.           after the user arrives at the Main Board.
  5981.  
  5982.           The syntax for the command is:
  5983.  
  5984.                JOIN X
  5985.  
  5986.                where 'X' is the Forum number to join.
  5987.  
  5988.           Note that  if this  command is  used in  the NEWQUEST  file,  the
  5989.           security news, BIRTH, and USERINFO files will not be shown.
  5990.  
  5991.           After filling  out a  NEWQUEST that  utilizes the JOIN X command,
  5992.           GAP will  continue to  process the questionnaire and not actually
  5993.           put the  user in  the Forum until after the user reaches the Main
  5994.           Board (after  log in).  The user will be placed in the Forum even
  5995.           if he  or she  doesn't have  the security  level that  the  Forum
  5996.           requires to join.
  5997.  
  5998.           When used  in a  regular questionnaire,  the JOIN  command  takes
  5999.           effect as soon as the questionnaire is completed, however in this
  6000.           case, the user must have the security level necessary to join the
  6001.           Forum or he/she will remain at in the Main Area.
  6002.  
  6003.           The reason for the difference between a regular questionnaire and
  6004.           a NEWQUEST is that you may have some users who you do not want to
  6005.           be a part of your regular BBS operation. You may set up different
  6006.  
  6007.  
  6008.  
  6009.  
  6010.                                       Page 101
  6011.  
  6012.  
  6013.  
  6014.           GAP Communications                                 Questionnaires
  6015.  
  6016.  
  6017.  
  6018.  
  6019.           Forums to segregate different groups of people. Your NEWQUEST can
  6020.           force certain  groups into  a specific  Forum, and by setting the
  6021.           level to  Abandon and  Join higher  than the users' level, once a
  6022.           user is  forced into this Forum, he/she will not be able to leave
  6023.           it. If  the Forum  is set  for AutoJoin,  the user will be forced
  6024.           into the Forum on subsequent calls.
  6025.  
  6026.           The NEWQUEST  use of  the JOIN command is a bit specialized. Most
  6027.           of us  would probably  use the command in a regular questionnaire
  6028.           such as  a Sysop  or Adult  Forum admittance questionnaire, where
  6029.           after determining  if the  user is fit for the Forum, you can ask
  6030.           if they  want to  Join now,  and then  use the  JOIN  command  to
  6031.           accomplish that.
  6032.  
  6033.           All processor  commands with  the exception of labels, must be in
  6034.           upper case. All commands must begin flush left!
  6035.  
  6036.           The entire  script of  the questionnaire  will be  written to the
  6037.           answer file.  This is  done because  if the  answers were  simply
  6038.           written to  the file,  and there  were numerous flow changes, you
  6039.           would not  know what  answers went with what questions. Also, the
  6040.           use  of   the  End   command  can  cause  a  termination  of  the
  6041.           questionnaire without all questions having been answered.
  6042.  
  6043.           The questionnaire should end with the End command.
  6044.  
  6045.  
  6046.  
  6047.  
  6048.  
  6049.  
  6050.  
  6051.  
  6052.  
  6053.  
  6054.  
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.  
  6061.  
  6062.  
  6063.  
  6064.  
  6065.  
  6066.  
  6067.  
  6068.                                       Page 102
  6069.  
  6070.  
  6071.  
  6072.           GAP Communications                                 Questionnaires
  6073.  
  6074.  
  6075.  
  6076.  
  6077.           +----------------------------------------------------------------+
  6078.                                  Processor Commands          |                                                                |
  6079.           |----------------------------------------------------------------|
  6080.                  *        -  Print anything following.          |                                                                |
  6081.                  &        -  Print anything following, do not write text          |                                                                |
  6082.                              to answer file.          |                                                                |
  6083.                  ?        -  Get an answer. Anything allowed. Answer not          |                                                                |
  6084.                              required.          |                                                                |
  6085.                 ??xx      -  Get an answer. Anything allowed. Get up to xx          |                                                                |
  6086.                              number of lines.          |                                                                |
  6087.                 Rxx       -  Get an answer. Required. Minimum of xx          |                                                                |
  6088.                              characters must be entered.          |                                                                |
  6089.                  Y        -  Yes / No Answer.          |                                                                |
  6090.                  Mx       -  Multiple choice. Up to 99 choices.          |                                                                |
  6091.                  D        -  Gets a formatted date.  (99/99/99)          |                                                                |
  6092.                  P        -  Gets a formatted phone number in the form of          |                                                                |
  6093.                              ((999)999-9999)          |                                                                |
  6094.                  A        -  Abort questionnaire. Do not save answers.          |                                                                |
  6095.                  E        -  End questionnaire. Save answers.          |                                                                |
  6096.              >aaaaaaaa    -  Goto Label. Label must exist.          |                                                                |
  6097.              <aaaaaaaa    -  Reverse Goto. Label must exist.          |                                                                |
  6098.               aaaaaaaa    -  Label. 8 chars maximum          |                                                                |
  6099.                 Fxx       -  Register in Forum xx.          |                                                                |
  6100.                 +xxx      -  Raise security level to xxx level. If user is          |                                                                |
  6101.                              already above this level does nothing.          |                                                                |
  6102.                 -xxx      -  Lower security level to xxx level. Does not          |                                                                |
  6103.                              affect users who have a level of 100 or          |                                                                |
  6104.                              greater.          |                                                                |
  6105.              Xfunction    -  Execute an internal GAP function.          |                                                                |
  6106.              CheckLevel   -  Check user's security level.          |                                                                |
  6107.               Del_User    -  Delete user from user file.          |                                                                |
  6108.              StopClock    -  Give time credit for answering questionnaire.          |                                                                |
  6109.                CCARD      -  Process Credit Card orders.          |                                                                |
  6110.               PrivUser    -  Set Private user flag to Yes.          |                                                                |
  6111.                JOIN X     -  Force User into a Forum.          |                                                                |
  6112.                  .        -  Comment prefix. Line not written.          |                                                                |
  6113.                  :        -  Comment prefix. Line written.          |                                                                |
  6114.           +----------------------------------------------------------------+
  6115.  
  6116.  
  6117.           Examples
  6118.  
  6119.           The actual questionnaire will appear as follows. Please note that
  6120.           the comments  (beginning with  '//') are for explanation purposes
  6121.           and should not appear in the actual file.
  6122.  
  6123.  
  6124.  
  6125.  
  6126.                                       Page 103
  6127.  
  6128.  
  6129.  
  6130.           GAP Communications                                 Questionnaires
  6131.  
  6132.  
  6133.  
  6134.  
  6135.           +----------------------------------------------------------------+
  6136.              *                             // equivalent to a blank line          |                                                                |
  6137.              ************************************************************          |                                                                |
  6138.              **        Love Forum Registration Questionnaire          |                                                                |
  6139.              ************************************************************          |                                                                |
  6140.              *Do you wish to be registered in the Love Forum (Y/N)?          |                                                                |
  6141.              Y                             // get a Yes/No response          |                                                                |
  6142.              >quest2                       // yes answer, goto 'quest2'          |                                                                |
  6143.              A                             // no answer. Abort ?aire          |                                                                |
  6144.              A                             // not Y or N. Abort          |                                                                |
  6145.              quest2                        // this is a label          |                                                                |
  6146.              *          |                                                                |
  6147.              *The Love Forum is an adult Forum and requires that you be          |                                                                |
  6148.              *over the age of 18. Are you 18 years of age or older (Y/N)?          |                                                                |
  6149.              Y          |                                                                |
  6150.              >quest3          |                                                                |
  6151.              A          |                                                                |
  6152.              A          |                                                                |
  6153.              quest3          |                                                                |
  6154.              *          |                                                                |
  6155.              *Now that we know you are old enough, please leave your voice          |                                                                |
  6156.              *phone number. You will not be called but it is required for          |                                                                |
  6157.              *registration.          |                                                                |
  6158.              P                             // Get a formatted phone #          |                                                                |
  6159.              *          |                                                                |
  6160.              *Since you stated that you are over the age of 18 and left          |                                                                |
  6161.              *your phone number, you may now have access to the Love          |                                                                |
  6162.              *Forum. Your responses to this questionnaire will be kept on          |                                                                |
  6163.              *file.          |                                                                |
  6164.              *          |                                                                |
  6165.              *Did you lie about your age (Y/N)?          |                                                                |
  6166.              Y                             // get a yes/no response          |                                                                |
  6167.              A                             // Yes is not acceptable, abort          |                                                                |
  6168.              >end                          // yep, this is the one we want          |                                                                |
  6169.              A                             // sorry charlie, Y or N only          |                                                                |
  6170.              end                           // notice this begins with 'E'          |                                                                |
  6171.              *          |                                                                |
  6172.              *You may now join the Love Forum. Thank you for completing          |                                                                |
  6173.              *this questionnaire.          |                                                                |
  6174.              F3                            // register user in Forum 3          |                                                                |
  6175.              E                             // end and save answers          |                                                                |
  6176.           +----------------------------------------------------------------+
  6177.  
  6178.  
  6179.  
  6180.  
  6181.  
  6182.  
  6183.  
  6184.                                       Page 104
  6185.  
  6186.  
  6187.  
  6188.           GAP Communications                                 Questionnaires
  6189.  
  6190.  
  6191.  
  6192.  
  6193.           If the sysop chooses to not use the default abort message that is
  6194.           shown with  the Y  or M  commands, a goto could be used for a non                                               
  6195.           acceptable command instead of the A to direct the flow to the end
  6196.           of the questionnaire where a message can be displayed telling the
  6197.           user why the questionnaire was aborted. The A command can then be
  6198.           used to abort the message.
  6199.  
  6200.           Remember, the  default abort message is displayed only when the A
  6201.           command is  found as  one of  the  subcommands  to  the  Y  or  M
  6202.           commands. If  you use a goto, display a message, and then use the                                  
  6203.           A command,  the user  will see only what you show him and not the
  6204.           processor's default.
  6205.  
  6206.           The resultant answer file looks like this:
  6207.  
  6208.           +----------------------------------------------------------------+
  6209.            06/26/92 16:37:37 MICHAEL PART          |                                                                |
  6210.           |                                                                |
  6211.            ***************************************************************          |                                                                |
  6212.            *           Love Forum Registration Questionnaire          |                                                                |
  6213.            ***************************************************************          |                                                                |
  6214.            Do you wish to be registered in the Love Forum (Y/N)?          |                                                                |
  6215.              A: YES          |                                                                |
  6216.           |                                                                |
  6217.            The Love Forum is an adult Forum and requires that you be over          |                                                                |
  6218.            the age of 18. Are you 18 years of age or older (Y/N)?          |                                                                |
  6219.              A: YES          |                                                                |
  6220.           |                                                                |
  6221.            Now that we know you are old enough, please leave your voice          |                                                                |
  6222.            phone number. You will not be called but it is required for          |                                                                |
  6223.            registration.          |                                                                |
  6224.              A: (714)493-3819          |                                                                |
  6225.           |                                                                |
  6226.            Since you stated that you are over the age of 18 and left your          |                                                                |
  6227.            phone number, you may now have access to the Love Forum. Your          |                                                                |
  6228.            responses to this questionnaire will be kept on file.          |                                                                |
  6229.           |                                                                |
  6230.            Did you lie about your age (Y/N)?          |                                                                |
  6231.              A: NO          |                                                                |
  6232.           |                                                                |
  6233.            You may now join the Love Forum. Thank you for completing this          |                                                                |
  6234.            questionnaire.          |                                                                |
  6235.           +----------------------------------------------------------------+
  6236.  
  6237.  
  6238.  
  6239.  
  6240.  
  6241.  
  6242.                                       Page 105
  6243.  
  6244.  
  6245.  
  6246.           GAP Communications                                 Questionnaires
  6247.  
  6248.  
  6249.  
  6250.  
  6251.           Miscellaneous Information
  6252.  
  6253.           If the  file NEWQUEST  is present in the MAIN directory, then all
  6254.           new users will be forced to fill out that questionnaire.
  6255.  
  6256.           NEWQUEST is  displayed after the welcome and the new user welcome
  6257.           and before the news.
  6258.  
  6259.           If the board is closed and the file NEWQUEST is present, the user
  6260.           will be  forced to  fill out  the questionnaire and then GAP will
  6261.           hang up. It is the sysop's responsibility to inform the users why
  6262.           the BBS is hanging up on them. GAP gives no warning messages. The
  6263.           new user  welcome can  be used  for this as can the questionnaire
  6264.           itself.
  6265.  
  6266.           The power of the questionnaire processor can also allow the sysop
  6267.           of an  open board  the ability  to raise  the level of a user and
  6268.           register the  user in  a particular  Forum if  he/she answers the
  6269.           NEWQUEST questions according to the sysop requirements.
  6270.  
  6271.           Since NEWQUEST  is presented  to the  users before  GAP looks  up
  6272.           their level  in the  SECLEV file, they will receive the full time
  6273.           allotment  associated  with  the  level  you  give  them  in  the
  6274.           questionnaire.
  6275.  
  6276.           In all  questionnaires, if the command -0 is given, GAP will hang
  6277.           up on the user after the questionnaire is finished. GAP will give
  6278.           no warning  messages so your questionnaire should inform the user
  6279.           why they  are being  locked out.  Note that  if you  issue the -0
  6280.           command and  then use  the A  command to abort the questionnaire,
  6281.           the user  will be  unaffected. A good idea would be to direct the
  6282.           flow to a part of the questionnaire that displays messages to the
  6283.           user as  to why  his/her security  is being lowered to 0 and then
  6284.           use the  E command  to exit  the questionnaire. At that point GAP
  6285.           will notice that their level is 0 and hang up.
  6286.  
  6287.  
  6288.  
  6289.  
  6290.  
  6291.  
  6292.  
  6293.  
  6294.  
  6295.  
  6296.  
  6297.  
  6298.  
  6299.  
  6300.                                       Page 106
  6301.  
  6302.  
  6303.  
  6304.  
  6305.  
  6306.  
  6307.  
  6308.  
  6309.  
  6310.           Chapter 8
  6311.  
  6312.  
  6313.  
  6314.                                                                      Events
  6315.  
  6316.  
  6317.  
  6318.  
  6319.  
  6320.  
  6321.           Description
  6322.  
  6323.           The GAP Events allow a sysop to set up 24 times in which GAP will
  6324.           exit to  DOS to  run external  programs.  GAP  will  continuously
  6325.           monitor the time to be sure that the scheduled events take place.
  6326.  
  6327.           Events can  be configured to run every day or on a particular day
  6328.           of the  week. They  can be run at any hour you choose. Individual
  6329.           events can be toggled on or off, as necessary.
  6330.  
  6331.  
  6332.           Setup
  6333.  
  6334.           To  activate   events,  select  Configuration  from  the  GAPMENU                                          
  6335.           Commands Main  Menu. Once in GAPSETUP, select Event Configuration
  6336.           from the  Go To  Main Menu.  You  will  be  taken  to  the  Event
  6337.           Configuration screen  where you may globally activate the events,
  6338.           toggle an  individual event on or off, and specify the program or
  6339.           batch file to be run for each event.
  6340.  
  6341.  
  6342.  
  6343.  
  6344.  
  6345.  
  6346.  
  6347.  
  6348.  
  6349.  
  6350.  
  6351.  
  6352.  
  6353.  
  6354.  
  6355.  
  6356.  
  6357.  
  6358.                                       Page 107
  6359.  
  6360.  
  6361.  
  6362.           GAP Communications                                         Events
  6363.  
  6364.  
  6365.  
  6366.  
  6367.           GAPSETUP will  provide two  configuration screens for the Events,
  6368.           depending upon how many you activate.
  6369.  
  6370.           ARTWORK
  6371.  
  6372.  
  6373.  
  6374.  
  6375.  
  6376.  
  6377.  
  6378.  
  6379.  
  6380.  
  6381.  
  6382.  
  6383.  
  6384.  
  6385.  
  6386.           Answer Yes to the Timed Events prompt.
  6387.  
  6388.           You may flag an individual event as Active or Not Active.
  6389.  
  6390.           The event times must be entered in 24 hour format.
  6391.  
  6392.           An event  may be  scheduled to  run every  day  (ALL),  or  on  a
  6393.           particular day of the week.
  6394.  
  6395.           You must  specify the  batch file  to run in order to execute the
  6396.           event. The  file  can  be  any  valid  program  so  you  are  not
  6397.           restricted to  running just  batch files.  You  may  execute  any
  6398.           program directly  if you  wish. You  also need  to enter the full
  6399.           path to the file.
  6400.  
  6401.           GAPMENU determines  which event  to run  by reading  the list  of
  6402.           events from first to last and comparing the event times. If event
  6403.           #1 is  scheduled to  run on  Sundays at  07:00 and  event  #2  is
  6404.           scheduled to  run every  day at 07:00, and today is Sunday, event
  6405.           #1 will  be the  event that is executed. Event #2 will not run on
  6406.           this day.
  6407.  
  6408.           For this  reason and many others, we strongly suggest that no two
  6409.           events share  the same  event time.  In addition, it is suggested
  6410.           that successive  events not  be  scheduled  within  less  than  5
  6411.  
  6412.  
  6413.  
  6414.  
  6415.  
  6416.                                       Page 108
  6417.  
  6418.  
  6419.  
  6420.           GAP Communications                                         Events
  6421.  
  6422.  
  6423.  
  6424.  
  6425.           minutes of  each other  (i.e., event  #1 at 00:01 and event #2 at
  6426.           00:02).
  6427.  
  6428.           GAPBBS will  set an event timer that will expire when an event is
  6429.           scheduled to run. This timer should never expire (it should never
  6430.           reach 0).  If it  does, this  means that an upload, door, or some
  6431.           other occurrence  has caused  the caller  to stay  on longer than
  6432.           he/she should  and the event will be missed by GAPMENU. The event
  6433.           timer should never go below 5 minutes (the event guard time).
  6434.  
  6435.           When a  caller logs  off or  GAP logs  a caller  of for  whatever
  6436.           reason, GAP  will check  the event  timer. If  it is  0, then GAP
  6437.           knows the  caller was  on past  the event  time and GAP will tell
  6438.           GAPMENU to  run the  event, irregardless  if  GAPMENU  thinks  it
  6439.           should be run or not.
  6440.  
  6441.           This method  of watching  for missed events is not foolproof. The
  6442.           event that GAPMENU had scheduled to run prior to logging a caller
  6443.           into GAPBBS  is the  event that will automatically run should the
  6444.           caller overstay  his or  her time.  If you  have events scheduled
  6445.           back to  back, depending  upon how long the caller overstayed and
  6446.           how closely  your events  are scheduled  to one  another, some of
  6447.           your events may not run.
  6448.  
  6449.           For instance,  if the  scheduled event  is at  00:01 and the next
  6450.           event to  run is at 00:02, if a caller logs into GAP and stays on
  6451.           until 00:03,  GAPMENU will  run the  scheduled event  (the one at
  6452.           00:01), but the next event at 00:02 will be missed completely. If
  6453.           the next event were scheduled at 00:06 instead of 00:02, it would
  6454.           run normally.
  6455.  
  6456.           To help  you deal  with the  problem of  missed events  there are
  6457.           several steps you can take.
  6458.  
  6459.             First, it  is possible  to schedule  a successive  event that
  6460.             simply checks to see if the prior event ran successfully. The
  6461.             prior  event,   could,  perhaps  create  a  dummy  file  that
  6462.             indicates that  it went off. The second event could then look
  6463.             for this  file and if found, delete it. If not found, run the
  6464.             intended event.
  6465.  
  6466.  
  6467.  
  6468.  
  6469.  
  6470.  
  6471.  
  6472.  
  6473.  
  6474.                                       Page 109
  6475.  
  6476.  
  6477.  
  6478.           GAP Communications                                         Events
  6479.  
  6480.  
  6481.  
  6482.  
  6483.             Second, the  following  configuration  options  are  at  your
  6484.             disposal:
  6485.  
  6486.                         +------------------------------------+
  6487.                           Stop Xfers If Event Timer Expires                        |                                    |
  6488.                           Upload Guard Time Prior To Event                        |                                    |
  6489.                           Door Guard Time Prior To Event                        |                                    |
  6490.                         +------------------------------------+
  6491.  
  6492.             The first  option allows  you to  stop any Upload or Download
  6493.             that is  in progress  if the  Event Timer expires (indicating
  6494.             the transfer is taking longer than expected and the caller is
  6495.             about to overrun the Event Time). If your events are critical
  6496.             and MUST  run, it  is suggested  that you  set this option to
  6497.             yes.
  6498.  
  6499.             The second  option allows  you to    specify  the  number  of
  6500.             minutes prior to an event to stop any Uploads.
  6501.  
  6502.             The third  option allows  you to  prevent your  callers  from
  6503.             entering a  door within  the number  of minutes  you  specify
  6504.             prior to an event.
  6505.  
  6506.           If GAPBBS  determines that  an Event  is pending  and adjusts the
  6507.           caller's time  available, you may have GAP display a file instead
  6508.           of the  standard message of "Your time has been adjusted...". The
  6509.           name of the file is EVENT and goes in your GEN directory.
  6510.  
  6511.  
  6512.           Running the Events
  6513.  
  6514.           Within 5  minutes of  the event  time, GAPMENU  will enter into a
  6515.           holding period.  At 5 minutes before the event, GAPMENU will take
  6516.           the phone  off the  hook and  wait for  the event to occur. The 5
  6517.           minute guard time was chosen so that NO event will be missed.
  6518.  
  6519.           If a  user logs  onto GAP before the 5 minute holding period, his
  6520.           or her  time will  be adjusted  accordingly and  the user will be
  6521.           given a  message as  to why their time during the current session
  6522.           was decreased.
  6523.  
  6524.           If a  user has  had his/her  time adjusted  because an  event  is
  6525.           scheduled to occur, then the user will not receive any extra time                                            
  6526.           when joining a Forum that gives more time.
  6527.  
  6528.  
  6529.  
  6530.  
  6531.  
  6532.                                       Page 110
  6533.  
  6534.  
  6535.  
  6536.           GAP Communications                                         Events
  6537.  
  6538.  
  6539.  
  6540.  
  6541.           When a  user first logs on, GAP will check to see if the time the
  6542.           user has is more than the time remaining until the next event. If
  6543.           it is,  then GAP  will give the user the time remaining until the
  6544.           event, less  five minutes.  The "decrease" in time is not counted
  6545.           against the  user and  after the event has run, the user may call
  6546.           back and reclaim the lost time.
  6547.  
  6548.  
  6549.           Batch Files
  6550.  
  6551.           An event  is basically  a batch  file that  is executed  when GAP
  6552.           exits to  DOS at  the specified  time. If the batch file does not
  6553.           exist, GAP will simply recycle and bring up GAPMENU and await the
  6554.           next caller.
  6555.  
  6556.           To set  up the  batch  files,  you  must  create  the  files  you
  6557.           specified in the Event Configuration.
  6558.  
  6559.           The event batch files are free to perform any DOS task within the
  6560.           limitations of DOS batch files.
  6561.  
  6562.  
  6563.           Examples
  6564.  
  6565.           If the  sysop wishes to archive his caller log once a day, he/she
  6566.           could set  up an  event to perform the archiving and the deletion
  6567.           of the old caller log. Let us assume that this event is scheduled
  6568.           as event 1. The EVENT1.BAT file could look like this:
  6569.  
  6570.                             +----------------------------+
  6571.                               echo off                            |                            |
  6572.                               cd \gap\main                            |                            |
  6573.                               pkzip caller.zip caller                            |                            |
  6574.                               del caller                            |                            |
  6575.                               cd \gap                            |                            |
  6576.                             +----------------------------+
  6577.  
  6578.           Of course,  this event  is very  basic and  if the sysop does not
  6579.           copy the CALLER.ZIP file off to another directory or floppy disk,
  6580.           each event  will cause  the CALLER.ZIP to be updated with the new
  6581.           caller log and all previous information will be lost.
  6582.  
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.  
  6589.  
  6590.                                       Page 111
  6591.  
  6592.  
  6593.  
  6594.  
  6595.  
  6596.  
  6597.  
  6598.  
  6599.  
  6600.           Chapter 9
  6601.  
  6602.  
  6603.  
  6604.                                                                  Text Files
  6605.  
  6606.  
  6607.  
  6608.  
  6609.  
  6610.  
  6611.           General Information
  6612.  
  6613.           To create  text files  for GAP,  simply use  your  favorite  text
  6614.           editor. If  you use a word processor, be sure to save the file in
  6615.           ASCII format.
  6616.  
  6617.           GAP allows  for two  types of  regular text files, color and non-
  6618.           color (or  plain ASCII).  In general,  the non-color files should
  6619.           only contain  ASCII characters below 127 so that those using non-
  6620.           IBM computers can view them.
  6621.  
  6622.           In order  to provide color equivalents, you will need to create a
  6623.           file of  the same  name but  with a "G" appended. The file can be
  6624.           created using  any of  the shareware  ANSI editors. If you change
  6625.           the ASCII  version of  a file,  you must  also  change  the  ANSI
  6626.           version if  you wish  for callers  who enable  color to  see  the
  6627.           changes.
  6628.  
  6629.           As a  general guideline, try to keep text files under 23 lines or
  6630.           provide for  natural page breaks at 23 line intervals. The reason
  6631.           for this  is that  most callers  have their page length set to 23
  6632.           and will receive a More Prompt every 23 lines of text output.
  6633.  
  6634.  
  6635.  
  6636.  
  6637.  
  6638.  
  6639.  
  6640.  
  6641.  
  6642.  
  6643.  
  6644.  
  6645.  
  6646.  
  6647.  
  6648.                                       Page 113
  6649.  
  6650.  
  6651.  
  6652.           GAP Communications                                     Text Files
  6653.  
  6654.  
  6655.  
  6656.  
  6657.           Here is  a list  of Menu  and Informational  Files which  GAP can
  6658.           display:
  6659.  
  6660.           +----------------------------------------------------------------+
  6661.                Menu Files                    Informational Files          |                                                                |
  6662.           |----------------------------------------------------------------|
  6663.                BLT(g)      DIR(g)            7E1            BIRTH(g)*          |                                                                |
  6664.                DOORM(g)    FILEM(g)          BLTxx(g)       CLOSED(g)*          |                                                                |
  6665.                FORUMM(g)   MAINM(g)          COMMENT(g)*    ENEWS(g)          |                                                                |
  6666.                PROTO(g)    QMENU(g)          EVENT(g)*      EXPIRE(g)*          |                                                                |
  6667.                SMAINM(g)                     KEEPUP(g)*     LOCKOUT(g)*          |                                                                |
  6668.                                              LOGON          NEWS(g)          |                                                                |
  6669.                                              NEWSx(g)*      NEWUSER(g)          |                                                                |
  6670.                                              NOPAGE(g)*     NOTIME(g)*          |                                                                |
  6671.                                              PAGE(g)*       RATIO(g)          |                                                                |
  6672.                                              RESBAUD        TWIT(g)*          |                                                                |
  6673.                                              UPHELP(g)      UPLOAD(g)          |                                                                |
  6674.                                              USERINFO*      WELC(g)          |                                                                |
  6675.                                              WELCx(g)*          |                                                                |
  6676.           +----------------------------------------------------------------+
  6677.  
  6678.              (g)  indicates that  there may be a color version of the file.
  6679.               *   indicates that  the file  is optional  (not required  for
  6680.                   proper system operation.
  6681.  
  6682.  
  6683.           Each of  these files  are fully  described in  the chapter System
  6684.           Files.
  6685.  
  6686.           All text  files may  be aborted  by typing  CTRL-K, CTRL-X,  or a
  6687.           space. Files  with an  @USEPAUSE at  the  beginning  may  not  be
  6688.           aborted.
  6689.  
  6690.  
  6691.           Security Files
  6692.  
  6693.           All text files which GAP displays can be security level specific.
  6694.           That is,  a security  specific file  will be shown (if it exists)
  6695.           instead of  the regular file. To create such files, simply add an
  6696.           extension with  the desired  security level. For instance, if you
  6697.           would prefer  to display  a special  File Directory  Menu to your
  6698.           level 100  callers, you  can create  a DIR.100  and  DIRG.100  in
  6699.           addition to the regular DIR and DIRG files.
  6700.  
  6701.           You can have as many security files as you have user levels.
  6702.  
  6703.  
  6704.  
  6705.  
  6706.                                       Page 114
  6707.  
  6708.  
  6709.  
  6710.           GAP Communications                                     Text Files
  6711.  
  6712.  
  6713.  
  6714.  
  6715.           Security Menus
  6716.  
  6717.           When designing  Security Menus  for the  Main Board (MAINM(g) and
  6718.           SMAINM(g)), keep in mind that Sysop levels range from 100 to 255.
  6719.           Therefore your  MAINM menus  can have  levels 1  - 99 attached to
  6720.           them, and your SMAINM menus can have levels 100 - 255 attached to
  6721.           them.
  6722.  
  6723.           The security  menus  are  basically  identical  to  their  normal
  6724.           equivalents except  that they  may not  include certain commands.
  6725.           For instance, if you do not wish to allow new users to access the
  6726.           files system,  you can  create a security menu that does not have
  6727.           the Files System command on it. The new user will never know that
  6728.           you have a files system until you update his/her security level.
  6729.  
  6730.           The following is an example of some of the various Security Files
  6731.           you may configure:
  6732.  
  6733.           +----------------------------------------------------------------+
  6734.               Menu Files                       Informational Files          |                                                                |
  6735.           |----------------------------------------------------------------|
  6736.              BLT(g).10      BLT(g).100         BLT1(g).50    ENEWS(g).50          |                                                                |
  6737.              DOORM(g).10    DOORM(g).100       EXPIRE(g).50  KEEPUP(g).50          |                                                                |
  6738.              FILEM(g).10    FILEM(g).100       NEWS(G).50    NEWS1(g).50          |                                                                |
  6739.              FORUMM(g).10   FORUMM(g).100      PAGE(g).50    RATIO(g).50          |                                                                |
  6740.              MAINM(g).10    MAINM(g).99        UPHELP(g).50  UPLOAD(g).50          |                                                                |
  6741.              SMAINM(g).100  SMAINM(g).110          |                                                                |
  6742.           +----------------------------------------------------------------+
  6743.  
  6744.           Examples of  some security menus are included on the distribution
  6745.           diskettes.
  6746.  
  6747.           Notice  that   it  is   possible  to   create  Security  Specific
  6748.           Informational files  such that  the file  will only  be shown  to
  6749.           callers with  the specific  level. For instance, you can create a
  6750.           NEWS1(g).50 file such that if the caller does not have a security
  6751.           level of  50, then  the NEWS1  file will  not be  displayed; only
  6752.           level 50 callers will see the file.
  6753.  
  6754.  
  6755.           Security News
  6756.  
  6757.           Security News  Files are  special files  that are used to display
  6758.           specific information to callers with a specific security level.
  6759.  
  6760.  
  6761.  
  6762.  
  6763.  
  6764.                                       Page 115
  6765.  
  6766.  
  6767.  
  6768.           GAP Communications                                     Text Files
  6769.  
  6770.  
  6771.  
  6772.  
  6773.           These files  are similar  to the  regular News  Files except that
  6774.           they are  displayed only  to a  user if his/her security level is
  6775.           the same  as the  name of  the file.  For instance, if you have a
  6776.           file that  you wish  to make available only to those users with a
  6777.           security level  of 90,  you can  create a Security News File that
  6778.           might tell  your special  users what  the name of the file is, or
  6779.           what the  password is  to download  it. The  name of the Security
  6780.           News File would be 90 (no extension).
  6781.  
  6782.           These files are displayed all the time and are not subject to the
  6783.           "Display News  Only If New" Configuration option. They are placed
  6784.           in  the  MAIN  directory  to  keep  them  confidential,  and  are
  6785.           displayed after the regular news file.
  6786.  
  6787.  
  6788.           UserInfo Files
  6789.  
  6790.           A special  form of  Security Specific  files are  those which are
  6791.           displayed to a single User only. We call these UserInfo files.
  6792.  
  6793.           Its name  is derived  from the name of the User you want the file
  6794.           shown to.  Because the  file names  are based upon User Names and
  6795.           there is  a possibility  that some  of these  files may duplicate
  6796.           some of  your MAIN  files, these  files need  to be  placed in  a
  6797.           directory called  USERINFO which  should be  created off the MAIN
  6798.           directory:
  6799.  
  6800.                C:\GAP\MAIN\USERINFO
  6801.  
  6802.           GAPSETUP will  create this directory for you or you may create it
  6803.           yourself.
  6804.  
  6805.           The names  of  these  files  are  derived  by  using  the  1st  5
  6806.           characters of  the User's  Last Name,  and the first character of
  6807.           the User's  First Name.  If the User doesn't have 5 characters in
  6808.           his/her last name, then you would use the entire Last Name:
  6809.  
  6810.                     +--------------------------------------------+
  6811.                                              File to Create                    |                                            |
  6812.                     |--------------------------------------------|
  6813.                        User Name            Mono        ANSI                    |                                            |
  6814.                     |--------------------------------------------|
  6815.                        DARIN MAY            MAYD        MAYDG                    |                                            |
  6816.                        KENNY GARDNER        GARDNK      GARDNKG                    |                                            |
  6817.                     +--------------------------------------------+
  6818.  
  6819.  
  6820.  
  6821.  
  6822.                                       Page 116
  6823.  
  6824.  
  6825.  
  6826.           GAP Communications                                     Text Files
  6827.  
  6828.  
  6829.  
  6830.  
  6831.  
  6832.           GAP will  show the User Specific File after the Security News and
  6833.           Birthday file.
  6834.  
  6835.           On the  Third Miscellaneous  Screen in Configuration, there is an
  6836.           option that you may set to have GAP delete the User Specific File
  6837.           after it  is shown  to the user. GAP will delete both the regular
  6838.           and ANSI files if you so choose.
  6839.  
  6840.           Some possible uses for these files are :
  6841.  
  6842.              + If you know a certain person will be logging on to your
  6843.                board as  a new  user, you  can  leave  him  a  special
  6844.                greeting.
  6845.  
  6846.              + If you  have an  incorrigible user  who refuses to read
  6847.                the message  you left  for him,  you can  create a file
  6848.                just for this user and GAP will insure that he sees it.
  6849.                If its  a long file, you can disable the More Prompt so
  6850.                he cannot answer No and stop the file display.
  6851.  
  6852.              + You can create a file for each of your new callers that
  6853.                will be  shown to  them on their next call. Such a file
  6854.                could thank them for joining your system.
  6855.  
  6856.           A special UserInfo file called ALL can be created. This file will
  6857.           be shown  to all  of your  users when they call. In addition, GAP
  6858.           will not  automatically delete  this file.  The ALL UserInfo file
  6859.           will be  displayed even  if the  caller uses  the Override Log On
  6860.           command. This is not so for the other UserInfo files.
  6861.  
  6862.  
  6863.           AnsiCmds
  6864.  
  6865.           It is  possible to use replaceable parameters in all of your text
  6866.           files. These  parameters, or  AnsiCmds, allow  you to personalize
  6867.           your text  files  so  that  they  appear  to  have  been  written
  6868.           exclusively for  the caller  viewing them. We call these AnsiCmds
  6869.           because they  are more  suited for  ANSI files  than  plain  text
  6870.           files, although they can be used equally well in non-ANSI files.
  6871.  
  6872.           To use  a command, it must be prefixed with the AnsiCmd character
  6873.           that you  set up  on Miscellaneous  Information Screen  2 in  the
  6874.           Configuration Editor. The default is an AT sign (@).
  6875.  
  6876.  
  6877.  
  6878.  
  6879.  
  6880.                                       Page 117
  6881.  
  6882.  
  6883.  
  6884.           GAP Communications                                     Text Files
  6885.  
  6886.  
  6887.  
  6888.  
  6889.                     For instance:
  6890.                     +--------------------------------------------+
  6891.                       @UNAME  -   Display User's Name                    |                                            |
  6892.                       @LEVEL  -   Display User's Security Level                    |                                            |
  6893.                     +--------------------------------------------+
  6894.  
  6895.           When GAP  encounters one  of the  Ansicmds, it  will  remove  the
  6896.           command and substitute the appropriate parameter. GAP will eat or
  6897.           pad the file as necessary so that the replacement text will "fill
  6898.           in" the  space taken  by the  AnsiCmd. For  instance, if  you use
  6899.           ANAME and  are in  the Main  Board, GAP will display "Main Board"
  6900.           and will  then "eat"  4 characters  from the  file. In most cases
  6901.           (providing you  leave enough  room for the replacement text) this
  6902.           will allow  you to have borders and other fancy graphics (even in
  6903.           non-color files).  Note that  GAP will stop eating the file if it
  6904.           encounters an  Esc (if  it is a 'g' file) or a Carriage Return or
  6905.           Line Feed;  or you  may force  a  stop  by  placing  the  AnsiCmd
  6906.           Character where you want GAP to stop eating the file.
  6907.  
  6908.           To create  an ANSI screen with replaceable parameters, you design
  6909.           your screen  in the  normal fashion. Wherever you want an AnsiCmd
  6910.           to appear, type the AnsiCmd character you configured and then the
  6911.           command itself.  Be sure to leave enough room for the replacement
  6912.           text. For  instance, if  you wish to show the caller's first name
  6913.           on a  screen that has a border, you need to leave enough room for
  6914.           GAP to insert the name so that the border remains intact:
  6915.  
  6916.  
  6917.                     +--------------------------------------------+
  6918.                              Welcome to the BBS, @FNAME                    |                                            |
  6919.                     +--------------------------------------------+
  6920.                     This will work just fine.
  6921.  
  6922.  
  6923.                             +----------------------------+
  6924.                              Welcome to the BBS, @FNAME                            |                            |
  6925.                             +----------------------------+
  6926.                             This will  not  work  if  the
  6927.                             caller's first name is longer
  6928.                             than  8  characters,  as  the
  6929.                             border will be 'eaten'.
  6930.  
  6931.  
  6932.  
  6933.  
  6934.  
  6935.  
  6936.  
  6937.  
  6938.                                       Page 118
  6939.  
  6940.  
  6941.  
  6942.           GAP Communications                                     Text Files
  6943.  
  6944.  
  6945.  
  6946.  
  6947.           Special AnsiCmds
  6948.  
  6949.           @CLS, @NOMORE,  and @USEPAUSE  are considered special commands as
  6950.           they are  normally placed  at the  beginning of  a file.  @NOMORE
  6951.           tells GAP  to disable  the More  Prompt such that the screen will
  6952.           display uninterrupted.  This command  is  useful  for  very  long
  6953.           screens which  use ANSI  Animation where you do not want the More
  6954.           Prompt to  appear. @USEPAUSE  tells GAP  to substitute  the Pause
  6955.           Prompt ("Press  Any Key  To Continue"),  in  place  of  the  More
  6956.           Prompt. This  keeps callers from interrupting the file; they must
  6957.           view the file in its entirety.
  6958.  
  6959.  
  6960.           XCodes
  6961.  
  6962.           To maintain  compatibility with  other programs,  GAP can process
  6963.           XCodes. To use text files from other programs that contain XCodes
  6964.           your AnsiCmd character must be defined as the AT (@) symbol.
  6965.  
  6966.           XCodes are  a way  to change  the color  attribute of a character
  6967.           that is sent to the screen. Instead of using the ANSI sequence of
  6968.           <Esc>[1;33;40m to  turn on  Bright Yellow  on a Black Background,
  6969.           you could  use an  XCode of  @X0E to  accomplish the  same thing.
  6970.           (note  that  the  @  is  your  AnsiCmd  character  and  is  Sysop
  6971.           definable).
  6972.  
  6973.           When IBM  designed the  IBM PC,  they  devised  a  set  of  color
  6974.           attributes. There  are 256  different combinations  of attributes
  6975.           that you can set.
  6976.  
  6977.           There are  8 background and 16 foreground colors. This results in
  6978.           128 different  color combinations.  In addition,  each foreground
  6979.           color can  'blink'. This  gives 256  different color combinations
  6980.           that can be displayed in text mode on a Color Monitor.
  6981.  
  6982.           When GAP  displays one  of your  ANSI screens,  it interprets the
  6983.           ANSI codes  in the  file (when  it encounters an SGR ('m') code),
  6984.           such that 1 of the 256 possible color combinations is utilized.
  6985.  
  6986.           The  XCodes  are  basically  a  quicker  way  to  set  the  color
  6987.           attributes. The  ANSI Driver  is not  utilized when  an XCode  is
  6988.           encountered.
  6989.  
  6990.           Sample files  containing ANSI color codes and XCodes are provided
  6991.           so that you may see the difference.
  6992.  
  6993.  
  6994.  
  6995.  
  6996.                                       Page 119
  6997.  
  6998.  
  6999.  
  7000.           GAP Communications                                     Text Files
  7001.  
  7002.  
  7003.  
  7004.  
  7005.           It should  be noted that if you are in Local Mode, the XCodes are
  7006.           faster than  the equivalent  ANSI strings.  The reason being, GAP
  7007.           need only read 2 characters from the file and set the color. With
  7008.           ANSI files,  GAP needs  to send each character read from the file
  7009.           through the internal ANSI driver to determine the color code.
  7010.  
  7011.           If a  remote caller  is on, then GAP needs to take the color code
  7012.           that it  received from  the file,  translate it to an ANSI string
  7013.           and send the string to the modem. This is still faster than going
  7014.           through the ANSI driver, but not much.
  7015.  
  7016.  
  7017.           Creating XCodes
  7018.  
  7019.           XCodes are a two character Hexadecimal number. They correspond to
  7020.           the 256 possible Video Attributes of the IBM PC.
  7021.  
  7022.           The first  digit represents  the Background  Color (and/or Blink)
  7023.           and the second digit represents the Foreground Color.
  7024.  
  7025.           The following  Table shows  how to create an XCode to produce the
  7026.           desired color:
  7027.  
  7028.           +----------------------------------------------------------------+
  7029.                              Background             Foreground          |                                                                |
  7030.           |----------------------------------------------------------------|
  7031.                Color         Normal   Blink         Normal   Bold          |                                                                |
  7032.           |----------------------------------------------------------------|
  7033.                Black            0       8              0       8          |                                                                |
  7034.                Blue             1       9              1       9          |                                                                |
  7035.                Green            2       A              2       A          |                                                                |
  7036.                Cyan             3       B              3       B          |                                                                |
  7037.                Red              4       C              4       C          |                                                                |
  7038.                Magenta          5       D              5       D          |                                                                |
  7039.                Yellow           6       E              6       E          |                                                                |
  7040.                White            7       F              7       F          |                                                                |
  7041.           +----------------------------------------------------------------+
  7042.  
  7043.           The 1st  digit of  the Color  Code is the Background. If you want
  7044.           the character to blink, you add 8 to the Background Color.
  7045.  
  7046.           The 2nd  digit of  the Color  code is the Foreground. If you want
  7047.           the character to be bold, you add 8 to the Foreground Color.
  7048.  
  7049.  
  7050.  
  7051.  
  7052.  
  7053.  
  7054.                                       Page 120
  7055.  
  7056.  
  7057.  
  7058.           GAP Communications                                     Text Files
  7059.  
  7060.  
  7061.  
  7062.  
  7063.                Examples:
  7064.                +------------------------------------------------------+
  7065.                  White On Black                   -    <AnsiCmd>X07               |                                                      |
  7066.                  Blinking White On Black          -    <AnsiCmd>X87               |                                                      |
  7067.                  Bright White On Black            -    <AnsiCmd>X0F               |                                                      |
  7068.                  Blinking Bright White On Black   -    <AnsiCmd>X8F               |                                                      |
  7069.                +------------------------------------------------------+
  7070.  
  7071.  
  7072.           +----------------------------------------------------------------+
  7073.              AnsiCmd             Description          |                                                                |
  7074.           |----------------------------------------------------------------|
  7075.              ADD1                User's Address 1          |                                                                |
  7076.              ADD2                User's Address 2          |                                                                |
  7077.              AGE                 User's Age          |                                                                |
  7078.              ANAME               Area Name          |                                                                |
  7079.              BAVAIL              Current Bytes Available for Download          |                                                                |
  7080.              BDOWN               Total Bytes Downloaded          |                                                                |
  7081.              BIRTH               User's Birthday          |                                                                |
  7082.              BLTS                Bulletins Read          |                                                                |
  7083.              BPHONE              User's Business/Data Phone Number          |                                                                |
  7084.              BUP                 Total Bytes Uploaded          |                                                                |
  7085.              CITY                User's City          |                                                                |
  7086.              CLS                 Clear the Screen          |                                                                |
  7087.              CNUMB               Caller Number          |                                                                |
  7088.              COMMENT             Force into a Comment          |                                                                |
  7089.              COUNTRY             User's Country          |                                                                |
  7090.              DATE                Today's Date          |                                                                |
  7091.              DISCON              Drop Caller          |                                                                |
  7092.              DOPEN               Total Doors Opened          |                                                                |
  7093.              DOWN                Total Downloads          |                                                                |
  7094.              DROPC               Total number of dropped Carriers          |                                                                |
  7095.              EVTIME              Event Time          |                                                                |
  7096.              FAVAIL              Current Files Available for Download          |                                                                |
  7097.              FJOIN               Total Forums Joined          |                                                                |
  7098.              FNAME               User's First Name          |                                                                |
  7099.              HPHONE              User's Home Phone Number          |                                                                |
  7100.           +----------------------------------------------------------------+
  7101.  
  7102.  
  7103.  
  7104.  
  7105.  
  7106.  
  7107.  
  7108.  
  7109.  
  7110.  
  7111.  
  7112.                                       Page 121
  7113.  
  7114.  
  7115.  
  7116.           GAP Communications                                     Text Files
  7117.  
  7118.  
  7119.  
  7120.  
  7121.           +----------------------------------------------------------------+
  7122.              AnsiCmd             Description          |                                                                |
  7123.           |----------------------------------------------------------------|
  7124.              LCALL               Date of Last CAll          |                                                                |
  7125.              LEVEL               User's Security Level          |                                                                |
  7126.              LNAME               User's Last Name          |                                                                |
  7127.              LNEW                Last New File's Scan          |                                                                |
  7128.              MLEFT               Total Messages Left          |                                                                |
  7129.              MORE                More Prompt          |                                                                |
  7130.              MREAD               Total Messages Read          |                                                                |
  7131.              NDNUMB              Node Number          |                                                                |
  7132.              NOMORE              Disable the More prompt          |                                                                |
  7133.              PAUSE               Show "Press [Any Key] To Continue" prompt          |                                                                |
  7134.              RATIO               Up/Down File Ratio          |                                                                |
  7135.              READMAIL            Force a R T S          |                                                                |
  7136.              SDATE               User's Subscription Date          |                                                                |
  7137.              SLOWxx              Delay xx clock tics between characters          |                                                                |
  7138.              STATE               User's State          |                                                                |
  7139.              TIME                Time of Day          |                                                                |
  7140.              TON                 Total Times On          |                                                                |
  7141.              UBAUD               Caller's baud rate          |                                                                |
  7142.              UNAME               User's Name (first & last)          |                                                                |
  7143.              UP                  Total Uploads          |                                                                |
  7144.              USEPAUSE            Use Pause Prompt instead of More Prompt          |                                                                |
  7145.              VER                 Version number of program          |                                                                |
  7146.              XCode               Color Codes          |                                                                |
  7147.              YESNO               Get a Yes/No Answer          |                                                                |
  7148.              ZIP                 User's Zip Code          |                                                                |
  7149.           +----------------------------------------------------------------+
  7150.  
  7151.  
  7152.  
  7153.  
  7154.  
  7155.  
  7156.  
  7157.  
  7158.  
  7159.  
  7160.  
  7161.  
  7162.  
  7163.  
  7164.  
  7165.  
  7166.  
  7167.  
  7168.  
  7169.  
  7170.                                       Page 122
  7171.  
  7172.  
  7173.  
  7174.  
  7175.  
  7176.  
  7177.  
  7178.  
  7179.  
  7180.           Chapter 10
  7181.  
  7182.  
  7183.  
  7184.                                                                  Caller Log
  7185.  
  7186.  
  7187.  
  7188.  
  7189.  
  7190.           The caller  file is  maintained by  GAP and  details  the  caller
  7191.           activity. Note  that this  file is Binary and must not, under any
  7192.           circumstance, be edited with a text editor or word processor.
  7193.  
  7194.           The caller   file can grow in size quite rapidly. It is suggested
  7195.           that you  use GAPCALL  on a  daily basis  and make  sure  GAPCALL
  7196.           deletes the caller logs after it has finished reading them.
  7197.  
  7198.           The following is a list of the error and system codes:
  7199.  
  7200.                2 - 200             ISAM Errors
  7201.  
  7202.                202                 File Not Found
  7203.                212                 Can't Allocate Memory
  7204.                213                 File Access Denied
  7205.                224                 Too Many Open Files
  7206.                236                 Locking Violation
  7207.                299                 Cant Open Text File
  7208.  
  7209.                400                 User Log In
  7210.  
  7211.                508                 Can't Allocate Memory
  7212.                512                 Can't Save Message
  7213.                513                 Can't Lock Record
  7214.                514                 Cant Update User Record
  7215.  
  7216.                600                 Log Off (normal)
  7217.                601                 Help
  7218.                602                 Page Sysop
  7219.                603                 View / Change Stats
  7220.                607                 F1 DOS Exit after call
  7221.                608                 F2 Lock Out
  7222.                609                 F3 On-line Update
  7223.                610                 F4 Printer Toggle
  7224.  
  7225.  
  7226.  
  7227.  
  7228.                                       Page 123
  7229.  
  7230.  
  7231.  
  7232.           GAP Communications                                     Caller Log
  7233.  
  7234.  
  7235.  
  7236.  
  7237.                611                 F5 Shell To Dos
  7238.                612                 F6 Sysop Page Toggle
  7239.                613                 F7 Caller Alarm Toggle
  7240.                614                 F8 Twit
  7241.                615                 F9 Sysop Privilege
  7242.                628                 Lost Carrier
  7243.                629                 Keyboard Time-out
  7244.                630                 Expired Time
  7245.                631                 Saved Message (message #)
  7246.                632                 Sysop function 1 View Caller Log
  7247.                633                 Sysop function 2 View Users
  7248.                634                 Sysop function 3 View File
  7249.                635                 Sysop function 4 Maintain User File
  7250.                636                 Sysop function 5 Dos Functions
  7251.                637                 Sysop function 6 Other Nodes
  7252.                638                 Sysop function 7 Restore Message
  7253.                640                 Abandon Forum
  7254.                642                 Comment
  7255.                643                 Chat With Sysop
  7256.                650                 Join Forum (Forum #)
  7257.                651                 Not A Member Of Forum (Forum #)
  7258.                652                 Download (filename)
  7259.                653                 Upload (filename)
  7260.                654                 Door (doorname)
  7261.                655                 Back From Door
  7262.                656                 Sysop Remote Exit To Dos
  7263.                657                 New User Log On
  7264.                658                 Trash Can Match
  7265.                659                 Wrong Password (auto disconnect)
  7266.                660                 Bulletins
  7267.                661                 Security Violation
  7268.                662                 Download Violation
  7269.                663                 Questionnaire
  7270.                664                 Locked Out User Log On Attempt
  7271.                665                 Attempt To Log On Closed Board
  7272.                666                 Entered Into Node Chat
  7273.                667                 Viewed Other Members
  7274.                670                 Entered Files System
  7275.                671                 Entered Message System
  7276.                672                 Entered Bulletins Area
  7277.                673                 Entered Doors Area
  7278.                674                 Entered Questionnaire Area
  7279.                675                 Entered/Returned Main Area
  7280.                676                 Entered Scan Mail Area
  7281.  
  7282.  
  7283.  
  7284.  
  7285.  
  7286.                                       Page 124
  7287.  
  7288.  
  7289.  
  7290.           GAP Communications                                     Caller Log
  7291.  
  7292.  
  7293.  
  7294.  
  7295.           Errors
  7296.  
  7297.           If the  caller log  shows an  error 224,  it means  you have  not
  7298.           properly configured  enough file  handles. This  is done  in your
  7299.           CONFIG.SYS file with the statement FILES=25.
  7300.  
  7301.           If you  receive an  error 212  or 508,  it means  you do not have
  7302.           sufficient  memory   to  perform   a  requested   function.   Try
  7303.           eliminating any  TSR programs. If you are running a multi-tasking
  7304.           system, try increasing the size of the partition.
  7305.  
  7306.           Error 202  simply means  that a  file could not be found. In most
  7307.           cases, this  is just  an informative error. For instance, it will
  7308.           be logged  whenever a  caller joins a Forum and that Forum has no
  7309.           news file.  If you  encounter this  error in situations where you
  7310.           know the  file exists,  the caller  log will  tell you  the exact
  7311.           location and  name of  the file.  This is the exact name and disk
  7312.           directory where  the file  should be. You may have placed it in a
  7313.           different directory or given it a different name.
  7314.  
  7315.           An error  299 normally  appears only  in  the  files  system  and
  7316.           usually when  a caller tries to download a file. If you find this
  7317.           error in  the caller  log, chances are good that the caller tried
  7318.           to download  a file that was not where you configured it to be in
  7319.           GAPFILE. In  this case, you should update the Where field for the                                                        
  7320.           file or run the Update function.
  7321.  
  7322.           In nearly all cases, an error 512 means that GAP had attempted to
  7323.           save a  message with  a message number that already exists in the
  7324.           message file.  On the Tools Menu of GAPMAINT you will find a Menu
  7325.           Item called  MSG Numbers. this utility function will allow you to
  7326.           fix  your   message  numbers.   However,  to  prevent  this  from
  7327.           occurring,  you  should  never  touch  the  MESSNO.DAT  file.  In
  7328.           addition, if  you are  using an  echo  mail  system,  you  should
  7329.           contact its authors and inform them of the problem.
  7330.  
  7331.           There are  over 200  errors that  can be  generated by  the  ISAM
  7332.           system. Most  of them  you will  never see.  Some of them are not
  7333.           written to the caller log because they are benign.
  7334.  
  7335.           Error 12 is the most common ISAM error. It means a file could not
  7336.           be found  so that it can be opened. In nearly all cases, you will
  7337.           be given the name of the file. You need to determine why the file
  7338.           is missing.  Either it  was deleted,  not initially  created,  or
  7339.           somehow moved  to a  location other  than where it is supposed to
  7340.  
  7341.  
  7342.  
  7343.  
  7344.                                       Page 125
  7345.  
  7346.  
  7347.  
  7348.           GAP Communications                                     Caller Log
  7349.  
  7350.  
  7351.  
  7352.  
  7353.           be. The  number one  problem we  have found  with this  error  is
  7354.           during initial  configuration, the  sysop did  not Quit  GAPSETUP
  7355.           properly (by answering Yes to save changes).
  7356.  
  7357.           Errors 35,  36, and  37 indicate  either a corrupted data file or
  7358.           the disk  is full.  If there  is free  space on  the disk,  it is
  7359.           suggested you pack the data file using GAPPACK.
  7360.  
  7361.           Error 101 means that a search request could not be fulfilled. You
  7362.           will see  this error  when you  first configure  a Forum  and the
  7363.           Forum has  no messages.  It occurs  when GAP displays the message
  7364.           stats upon  joining the Forum. It will go away when you enter the
  7365.           first message.
  7366.  
  7367.           Fatal  ISAM   errors  are   always  apparent   because  they  are
  7368.           accompanied by a series of beeps and the program will either exit
  7369.           to DOS,  or in the case of GAPBBS, recycle back to GAPMENU. Fatal
  7370.           errors means an index file is corrupted.
  7371.  
  7372.           When a  data file  is suspected  to be corrupt, you should delete
  7373.           the associated  index file  (.IDX) and run GAPREBLD. If that does
  7374.           not clear  up the problem, you should try packing the file. Often
  7375.           times, with  badly corrupted  files, you  will find  that GAPPACK
  7376.           quits with  an error  message at  the end  of the  file. In these
  7377.           cases, if  you look  in the directory that contains the file, you
  7378.           will find  a file with a .TMP extension.  If you rename this file
  7379.           to FILENAME.DAT  (where FILENAME is the base name of the file you
  7380.           were trying to pack), make sure the .IDX file is deleted, and run
  7381.           GAPREBLD, your data file will be intact and repaired.
  7382.  
  7383.  
  7384.  
  7385.  
  7386.  
  7387.  
  7388.  
  7389.  
  7390.  
  7391.  
  7392.  
  7393.  
  7394.  
  7395.  
  7396.  
  7397.  
  7398.  
  7399.  
  7400.  
  7401.  
  7402.                                       Page 126
  7403.  
  7404.  
  7405.  
  7406.  
  7407.  
  7408.  
  7409.  
  7410.  
  7411.  
  7412.           Chapter 11
  7413.  
  7414.  
  7415.  
  7416.                                                                Call Waiting
  7417.  
  7418.  
  7419.  
  7420.  
  7421.  
  7422.           ARTWORK
  7423.  
  7424.  
  7425.  
  7426.  
  7427.  
  7428.  
  7429.  
  7430.  
  7431.  
  7432.  
  7433.  
  7434.  
  7435.  
  7436.  
  7437.  
  7438.           The Call Waiting screen is the director of the GAP activities. It
  7439.           allows you  to configure your system, edit your users, run GAP as
  7440.           the sysop  or as  a local  user, set  quick options, run external
  7441.           programs and, of course, Answer The Phone.
  7442.  
  7443.           Use the  Left and Right Arrow Keys to select any of the Main Menu
  7444.           items. Press  [Enter]  to  display  the  Pulldown  Menu  for  the
  7445.           selected item.  Use the  Up and  Down Arrow Keys to select any of
  7446.           the Menu  Items on  the Pulldown Menu. Press [Enter] to carry out
  7447.           the highlighted selection.
  7448.  
  7449.           You may  also type  the first character of the Menu Item and that
  7450.           Item will  become highlighted  and selected. For instance, to log
  7451.           in to the BBS as Sysop, you may press C and S.
  7452.  
  7453.           The About Menu displays Copyright and Version information.              
  7454.  
  7455.  
  7456.  
  7457.  
  7458.  
  7459.  
  7460.                                       Page 127
  7461.  
  7462.  
  7463.  
  7464.           GAP Communications                                   Call Waiting
  7465.  
  7466.  
  7467.  
  7468.  
  7469.           The Toggles Menu allows you to turn the Printer, Page, and Caller
  7470.           Alarm toggles on or off.
  7471.  
  7472.                                    Toggles
  7473.                                    +--------------+
  7474.                                      Printer                                   |              |
  7475.                                      Page                                   |              |
  7476.                                      Alarm                                   |              |
  7477.                                    |--------------|
  7478.                                      Save                                   |              |
  7479.                                    +--------------+
  7480.  
  7481.           The Toggles  Menu allows  you to  quickly  turn  printer  logging
  7482.           on/off, turn  the Alarm  bell on/off,  and  turn  the  Page  bell
  7483.           on/off. The  alarm bell  announces each caller as they log on. It
  7484.           also turns  your bell  on and alerts you anytime a caller makes a
  7485.           mistake. The  Page bell  alerts you  anytime the  caller tries to
  7486.           page you for a one on one chat.
  7487.  
  7488.           The Commands Menu allows you to run the GAP Utility programs.
  7489.  
  7490.                                 Commands
  7491.                                 +--------------------+
  7492.                                   Sysop In                                |                    |
  7493.                                   Sysop In Quick                                |                    |
  7494.                                   Local In                                |                    |
  7495.                                   Configuration                                |                    |
  7496.                                   User Editor                                |                    |
  7497.                                   Filebase                                |                    |
  7498.                                 |--------------------|
  7499.                                   GAPComm                                |                    |
  7500.                                 +--------------------+
  7501.  
  7502.           Sysop In  - This  function allows  you to enter the system as the
  7503.           sysop. It  first takes  the phone  off the  hook  and  then  runs
  7504.           GAPBBS. If  you set  up a  local password,  you will be asked for
  7505.           that password before being permitted to logon as the Sysop.
  7506.  
  7507.           Sysop In  Quick -  This is the same as Sysop In except that there
  7508.           will be no New Mail check.
  7509.  
  7510.           Local In  - This  function allows  you to  enter the  system as a
  7511.           local user.
  7512.  
  7513.  
  7514.  
  7515.  
  7516.  
  7517.  
  7518.                                       Page 128
  7519.  
  7520.  
  7521.  
  7522.           GAP Communications                                   Call Waiting
  7523.  
  7524.  
  7525.  
  7526.  
  7527.           Configuration -  Use this  function to  configure your  system. A
  7528.           password will be required if you installed it.
  7529.  
  7530.           User Editor  - To  access the  off-line user  editor, this is the
  7531.           function you  would use. If you installed a password, you will be
  7532.           asked to enter it before being allowed to access the editor.
  7533.  
  7534.           Filebase -  This function  allows  you  to  access  the  FileBase
  7535.           Editor.
  7536.  
  7537.           Gapcomm - This is GAP's own Communications Program. Until GAPCOMM
  7538.           is completed, we have provided a function which will allow you to
  7539.           use  this   menu  choice   as  a  shell.  You  may  hook  up  any
  7540.           communications program  of your  choice or  any program  for that
  7541.           matter.
  7542.  
  7543.           To install the shell, create a batch file called GAPCOMM.BAT. The
  7544.           file is basically the same as the event files. It can perform any
  7545.           DOS command or run any program. For instance, if you wish to hook
  7546.           QCom up  to the  GAPCOMM shell,  a GAPCOMM  batch file would look
  7547.           like this:
  7548.  
  7549.                               GAPCOMM.BAT
  7550.                               +------------------------+
  7551.                                 @echo off                              |                        |
  7552.                                 cd \qmod                              |                        |
  7553.                                 qcom                              |                        |
  7554.                                 cd \gap                              |                        |
  7555.                               +------------------------+
  7556.  
  7557.  
  7558.           The Files  Menu allows  you to  view the  Caller Log, the Offline
  7559.           Files Log or any Text file of your choosing.
  7560.  
  7561.                             Files
  7562.                             +----------------------------+
  7563.                               View Caller Log                            |                            |
  7564.                               View Offline Files Log                            |                            |
  7565.                               View Any Text File                            |                            |
  7566.                             +----------------------------+
  7567.  
  7568.           In  a  multi  user  system,  the  Files  Menu  will  contain  one
  7569.           additional Menu  Item called  View Network  Activity. This option
  7570.           will display  a Network  Monitor window  which will  show each of
  7571.           your nodes  and what  activity the caller on that node is engaged
  7572.  
  7573.  
  7574.  
  7575.  
  7576.                                       Page 129
  7577.  
  7578.  
  7579.  
  7580.           GAP Communications                                   Call Waiting
  7581.  
  7582.  
  7583.  
  7584.  
  7585.           in. This  window reads  the NETWORK.DAT  file once per second and
  7586.           updates the window with any changes in network activity.
  7587.  
  7588.           The Windows Menu allows you to move and color the various windows
  7589.           you see  on the desktop. You may also prevent the Free Disk Space
  7590.           and Statistics windows from displaying, and toggle whether or not
  7591.           to show  Network wide  or  local  statistics  in  the  Statistics
  7592.           window.
  7593.  
  7594.                         Windows
  7595.                         +------------------------------------+
  7596.                           Move Registration Window                        |                                    |
  7597.                           Move Last Caller Window                        |                                    |
  7598.                           Move Free Disk Space Window                        |                                    |
  7599.                           Move Statistics Window                        |                                    |
  7600.                         |------------------------------------|
  7601.                           Registration Window Colors                        |                                    |
  7602.                           Last Caller Window Colors                        |                                    |
  7603.                           Free Space Window Colors                        |                                    |
  7604.                           Statistics Window colors                        |                                    |
  7605.                         |------------------------------------|
  7606.                           Show Free Disk Space Window                        |                                    |
  7607.                           Show Statistics Window                        |                                    |
  7608.                           Show Network Stats In Window                        |                                    |
  7609.                         |------------------------------------|
  7610.                           Save                        |                                    |
  7611.                         +------------------------------------+
  7612.  
  7613.           You may  move the  various windows to any location on the screen,
  7614.           and color them to your own preference.
  7615.  
  7616.           The Statistics  Window displays caller statistics since midnight.
  7617.           If you  run multi nodes, you can set this window so that it shows
  7618.           Network statistics  instead of  Node statistics.  For instance on
  7619.           the Server  you can  set this  window to  show Network statistics
  7620.           (all nodes  included) and  on each  of your nodes you can set the
  7621.           window to show  only the local stats.
  7622.  
  7623.           At midnight,  when the  first caller after midnight logs off, GAP
  7624.           will reset  the Caller  Stats. The  default window will show only                                                                       
  7625.           the current  day's statistics,  however, if you press the F9 key,
  7626.           your Caller  Stats window will toggle between three sets of stats
  7627.           (Today, Yesterday,  and Monthly).  If you  have the  Show Network
  7628.           Stats In  Window toggled on, the three sets of stats that will be
  7629.           displayed will be network wide instead of local.
  7630.  
  7631.  
  7632.  
  7633.  
  7634.                                       Page 130
  7635.  
  7636.  
  7637.  
  7638.           GAP Communications                                   Call Waiting
  7639.  
  7640.  
  7641.  
  7642.  
  7643.  
  7644.           GAPMENU will  remember which  set of the three sets of statistics
  7645.           you have displayed and will continue to display that set.
  7646.  
  7647.           If you  press the  F10 key, the stats window will be updated with
  7648.           the current stats (multi user only).
  7649.  
  7650.           The Other  Menu allows  you to Shell to DOS or run any program of
  7651.           your choosing. This Menu is user definable.
  7652.  
  7653.                                   Other
  7654.                                   +----------------+
  7655.                                     DOS Shell                                  |                |
  7656.                                     GAPMaint                                  |                |
  7657.                                     GAPCALL                                  |                |
  7658.                                   +----------------+
  7659.  
  7660.           To  activate  this  Menu,  you  need  to  create  a  file  called
  7661.           GAPMENU.MNU (a  sample  file  is  included  on  the  distribution
  7662.           disks). If  this file  is not  found, then nothing will happen if
  7663.           you try to select the Other Menu.                                
  7664.  
  7665.           The GAPMENU.MNU file is a Menu Definition file that tells GAPMENU
  7666.           what program you wish to execute. Its format is as follows:
  7667.  
  7668.                GAPMENU.DEF
  7669.                +------------------------------------------------------+
  7670.                   DOS Shell               |                                                      |
  7671.                  D               |                                                      |
  7672.                  Shell To DOS               |                                                      |
  7673.                  PASSWORD               |                                                      |
  7674.                |                                                      |
  7675.                   GAPMaint               |                                                      |
  7676.                  M               |                                                      |
  7677.                  Run GAPMaint Program               |                                                      |
  7678.                  PASSWORD               |                                                      |
  7679.                  GAPMAINT.EXE               |                                                      |
  7680.                   GAPCALL               |                                                      |
  7681.                  C Run GAP's Caller Analyzer               |                                                      |
  7682.                  NOPASS               |                                                      |
  7683.                  GAPCALL.EXE               |                                                      |
  7684.                +------------------------------------------------------+
  7685.  
  7686.  
  7687.  
  7688.  
  7689.  
  7690.  
  7691.  
  7692.                                       Page 131
  7693.  
  7694.  
  7695.  
  7696.           GAP Communications                                   Call Waiting
  7697.  
  7698.  
  7699.  
  7700.  
  7701.           The same file, with line numbers and comments added:
  7702.  
  7703.           GAPMENU.DEF
  7704.           +----------------------------------------------------------------+
  7705.               1     DOS Shell                     <- Menu Item          |                                                                |
  7706.               2    D                              <- keyboard command          |                                                                |
  7707.               3    Shell To DOS                   <- display prompt          |                                                                |
  7708.               4    PASSWORD                       <- password IS required          |                                                                |
  7709.               5                                   <- program to execute          |                                                                |
  7710.               6     GAPMaint                      <- Menu Item          |                                                                |
  7711.               7    M                              <- keyboard command          |                                                                |
  7712.               8    Run GAPMaint Program           <- display prompt          |                                                                |
  7713.               9    PASSWORD                       <- password IS required          |                                                                |
  7714.              10    GAPMAINT.EXE                   <- program to execute          |                                                                |
  7715.              11     GAPCALL                       <- Menu Item          |                                                                |
  7716.              12    C                              <- keyboard command          |                                                                |
  7717.              13    Run GAP's Caller Analyzer      <- display prompt          |                                                                |
  7718.              14    NOPASS                         <- password NOT required          |                                                                |
  7719.              15    GAPCALL.EXE                    <- program to execute          |                                                                |
  7720.           +----------------------------------------------------------------+
  7721.  
  7722.           There are five records to each Menu Definition in the GAPMENU.DEF
  7723.           file. Each record is on a line all by itself.
  7724.  
  7725.           The first  record (Line  1) is  the text  that will appear in the
  7726.           menu box. Note that there is a space in front of the text on line
  7727.           1. There is also a space following this text. The reason for this
  7728.           is that your Menu Item string will appear in the Menu Box exactly
  7729.           as you  specify it.  If there  is no  space before  and after the
  7730.           text, your Menu Item Choice will bunt up next to the Menu Box.
  7731.  
  7732.           The second record (Line 2) is the keyboard character that must be
  7733.           typed to  execute this menu selection. The first character of the
  7734.           Menu Item  Choice also  activates the  Menu Selection, so you may
  7735.           have two keyboard characters activate the single Menu Choice. You
  7736.           must type a character on this line, even if it is the same as the
  7737.           first character in the Menu Item Choice text.
  7738.  
  7739.           The third  record (Line  3) is  the text that is displayed on the
  7740.           Status Line  of GAPMENU.  It tells  you what  this Menu selection
  7741.           does.
  7742.  
  7743.           The fourth  record (Line  4) is  either PASSWORD  or NOPASS. This
  7744.           tells GAPMENU that when a user selects this Menu Item, a password
  7745.           is either  required or  not. You  should always put PASSWORD here
  7746.  
  7747.  
  7748.  
  7749.  
  7750.                                       Page 132
  7751.  
  7752.  
  7753.  
  7754.           GAP Communications                                   Call Waiting
  7755.  
  7756.  
  7757.  
  7758.  
  7759.           unless you  use Passwords  and you  do not  want this  Menu  Item
  7760.           protected. In  such a case, you would place NOPASS in this field.
  7761.           Your system  is protected  by a  password if  you have the second
  7762.           field in  the Sysop  Configuration Screen  set to  anything other
  7763.           than spaces.  If you  password protect  your system, and you have
  7764.           PASSWORD in  this field,  GAP will  ask the  user for  the system
  7765.           password. If you have NOPASS in this field, then GAP will not ask
  7766.           for a  password.  Note  that  if  your  system  is  not  password
  7767.           protected, then  GAP won't  ask no  matter what  you type in this
  7768.           field!
  7769.  
  7770.           The fifth  record (Line 5) is the actual program that is executed
  7771.           when this Menu item is selected.
  7772.  
  7773.           Please note  in the  example above that Line 5 is blank. That is,
  7774.           it consists  of a solitary CR/LF combination. If Line 5 is blank,
  7775.           GAPMENU will  execute a  DOS shell.  This is  the same  thing  as
  7776.           pressing F5  in GAP.  You will  shell to  DOS where you must type
  7777.           'EXIT' to return.
  7778.  
  7779.           Continuing with  the second  Menu Item  in the  above GAPMENU.MNU
  7780.           file:
  7781.  
  7782.           +----------------------------------------------------------------+
  7783.               6     GAPMaint                      <- Menu Item          |                                                                |
  7784.               7    M                              <- keyboard command          |                                                                |
  7785.               8    Run GAPMaint Program           <- display prompt          |                                                                |
  7786.               9    PASSWORD                       <- password required          |                                                                |
  7787.              10    GAPMAINT.EXE                   <- program to execute          |                                                                |
  7788.           +----------------------------------------------------------------+
  7789.  
  7790.           The first record of the Menu Definition (Line 6) is the Menu Item
  7791.           that will  appear in the Menu Box. Note that it has spaces on the
  7792.           left and the right.
  7793.  
  7794.           The second  record (Line  7) is the keyboard character that is to
  7795.           be typed  to execute  this Menu  Choice. In this example, you may
  7796.           type either 'G' or 'M' to execute this Menu Choice.
  7797.  
  7798.           The third  record (Line 8) is the text that appears at the bottom
  7799.           of the screen telling you what this Menu Item does.
  7800.  
  7801.           The fourth  record (Line  9) means that a password is required to
  7802.           execute this  Menu Item Choice. If this instead said NOPASS, then
  7803.  
  7804.  
  7805.  
  7806.  
  7807.  
  7808.                                       Page 133
  7809.  
  7810.  
  7811.  
  7812.           GAP Communications                                   Call Waiting
  7813.  
  7814.  
  7815.  
  7816.  
  7817.           a user  could execute  this Menu  Item without  having to enter a
  7818.           password.
  7819.  
  7820.           The fifth record (Line 10) is the actual program to execute.
  7821.  
  7822.           If the  Menu Item  String contains  a '-'  in the first character
  7823.           position then it tells GAPMENU that there should be a "separator"
  7824.           between the last line read and the next line:
  7825.  
  7826.           +----------------------------------------------------------------+
  7827.              DOS Shell          |                                                                |
  7828.             D          |                                                                |
  7829.             Shell To DOS          |                                                                |
  7830.             PASSWORD          |                                                                |
  7831.                       |                                                                |
  7832.             - - - - - - - - - -                   This is a Menu Separator          |                                                                |
  7833.              GAPMaint          |                                                                |
  7834.             M          |                                                                |
  7835.             Run GAPMaint Program          |                                                                |
  7836.             PASSWORD          |                                                                |
  7837.             GAPMAINT.EXE          |                                                                |
  7838.              GAPCALL          |                                                                |
  7839.             C          |                                                                |
  7840.             Run GAP's Caller Analyzer          |                                                                |
  7841.             NOPASS          |                                                                |
  7842.             GAPCALL.EXE          |                                                                |
  7843.           +----------------------------------------------------------------+
  7844.  
  7845.           The separator  allows you  to separate  various Menu Choices from
  7846.           one another.
  7847.  
  7848.           Note that if you use the separator, then you must not provide the
  7849.           other four lines for this Menu Definition record. In other words,
  7850.           if you  want a separator in your Menu, then you simply use a dash
  7851.           (-) for  the Menu  Item Choice  line. Your  next Menu Item Choice
  7852.           will come after the separator line.
  7853.  
  7854.  
  7855.  
  7856.  
  7857.  
  7858.  
  7859.  
  7860.  
  7861.  
  7862.  
  7863.  
  7864.  
  7865.  
  7866.                                       Page 134
  7867.  
  7868.  
  7869.  
  7870.           GAP Communications                                   Call Waiting
  7871.  
  7872.  
  7873.  
  7874.  
  7875.           The Quit  Menu allows  you to  Exit to DOS. You may exit with the
  7876.           Phone either busy or not busy.
  7877.  
  7878.                                    Quit
  7879.                                    +--------------+
  7880.                                      Busy                                   |              |
  7881.                                      Not Busy                                   |              |
  7882.                                    +--------------+
  7883.  
  7884.           Busy -  This selection Quits GAPMENU and leaves the phone off the
  7885.           hook. The phone will be busy.
  7886.  
  7887.           Not Busy  - This  selection Quits GAPMENU and leaves the phone on
  7888.           the hook. The phone will ring.
  7889.  
  7890.  
  7891.           Sysop Defined Screens
  7892.  
  7893.           GAPMENU has  the capability  to display  Sysop  defined  screens.
  7894.           These screens  take the  place of  the built  in windows that are
  7895.           normally displayed.
  7896.  
  7897.           These screens are named GAPMENU.SCR and GAPMENUx.SCR (where the x
  7898.           is a  number from  1 to  9). The  basic screen, GAPMENU.SCR, must
  7899.           exist in order for the other screens to display. In addition, the
  7900.           numbered screens  must be  sequential (i.e.,  you can  not have a
  7901.           GAPMENU1.SCR and a GAPMENU3.SCR, since only the screen numbered 1
  7902.           (in addition to the basic screen) will display).
  7903.  
  7904.  
  7905.  
  7906.  
  7907.  
  7908.  
  7909.  
  7910.  
  7911.  
  7912.  
  7913.  
  7914.  
  7915.  
  7916.  
  7917.  
  7918.  
  7919.  
  7920.  
  7921.  
  7922.  
  7923.  
  7924.                                       Page 135
  7925.  
  7926.  
  7927.  
  7928.           GAP Communications                                   Call Waiting
  7929.  
  7930.  
  7931.  
  7932.  
  7933.           GAPMENU contains  an AnsiCmd  parser. The  AnsiCmds that  GAPMENU
  7934.           will recognize are as follows:
  7935.  
  7936.           +----------------------------------------------------------------+
  7937.             BNAME        -     Board Name          |                                                                |
  7938.             CLS          -     Clear window          |                                                                |
  7939.             DISKx        -     Free space on Drive x (x = C, D, E, etc)          |                                                                |
  7940.             LCALLER      -     Name of Last Caller          |                                                                |
  7941.             LICENSE      -     Licensee Name          |                                                                |
  7942.             LOFF         -     Last Caller Off Time          |                                                                |
  7943.             LON          -     Last Caller On Time          |                                                                |
  7944.             LBAUD        -     Last Caller Baud Rate          |                                                                |
  7945.             SBLT         -     Total Bulletins read in period          |                                                                |
  7946.             SCALLS       -     Total Calls in period          |                                                                |
  7947.             SCLEFT       -     Total Comments left in period          |                                                                |
  7948.             SDOOR        -     Total Doors opened in period          |                                                                |
  7949.             SDOWN        -     Total Downloads in period          |                                                                |
  7950.             SMINS        -     Total Minutes used in period          |                                                                |
  7951.             SMLEFT       -     Total Messages left in period          |                                                                |
  7952.             SQUEST       -     Total Questionnaires answered in period          |                                                                |
  7953.             SUP          -     Total Uploads in period          |                                                                |
  7954.             XCode        -     Change color attribute          |                                                                |
  7955.             TODAY        -     Use Today's Statistics          |                                                                |
  7956.             YESTERDAY    -     Use Yesterday's Statistics          |                                                                |
  7957.             MONTHLY      -     Use Monthly Statistics          |                                                                |
  7958.             NETWORK      -     If multi-node, use Network Wide Statistics          |                                                                |
  7959.           +----------------------------------------------------------------+
  7960.  
  7961.           Each of  these commands  are preceded  by  your  defined  AnsiCmd
  7962.           character:
  7963.  
  7964.                @BNAME, @X0F, @LCALLER, etc
  7965.  
  7966.           Your screens  may be  80 columns wide and 22 lines in length. The
  7967.           window that  your file  will be  displayed in  occupies the  area
  7968.           between the  Menu Bar  and the  Status line.  The window contains
  7969.           extra lines  and  1  extra  column  (which  you  cannot  see)  to
  7970.           accommodate the  CR/LF at  the end of each line, and any spurious
  7971.           lines which may inadvertently be left at the end of the file.
  7972.  
  7973.           If you  elect to  design your  own screens, keep in mind that the
  7974.           Windows Menu  will be unavailable (you will not be able to select
  7975.           it). Since  GAPMENU will be displaying your screen instead of its
  7976.           own Windows, the commands on the Window Menu are irrelevant.
  7977.  
  7978.  
  7979.  
  7980.  
  7981.  
  7982.                                       Page 136
  7983.  
  7984.  
  7985.  
  7986.           GAP Communications                                   Call Waiting
  7987.  
  7988.  
  7989.  
  7990.  
  7991.           In addition,  the F9 (toggle stats display) and F10 (update stats
  7992.           display) keys will behave differently.
  7993.  
  7994.                F9 will  cycle through each of your screens, displaying
  7995.                them sequentially.
  7996.  
  7997.                F10 will  update the  New Mail flag as well as save the
  7998.                number of  the screen  that is  currently displayed  so
  7999.                that  the   next  time   GAPMENU  runs,  the  currently
  8000.                displayed screen  will be  the default  screen that  is
  8001.                initially displayed.
  8002.  
  8003.           When using the following commands:
  8004.  
  8005.                               +------------------------+
  8006.                                 TODAY                              |                        |
  8007.                                 YESTERDAY                              |                        |
  8008.                                 MONTHLY                              |                        |
  8009.                                 NETWORK                              |                        |
  8010.                               +------------------------+
  8011.  
  8012.           you will  probably have  to add them at the top of the file after
  8013.           you save  your screen (assuming you use an editor that produces X
  8014.           Codes). The  reason for  this is if you place these commands on a
  8015.           line by  themselves, GAPMENU will correctly interpret the command
  8016.           but there  will be  a CR/LF  after the command which GAPMENU will
  8017.           read and  display. The  end result  will be  a  blank  line  with
  8018.           nothing on it.
  8019.  
  8020.           If you  do not use any of the above four commands, the statistics
  8021.           will default to Today's Stats for the current node.
  8022.  
  8023.           If you would like for a particular screen to display Network Wide
  8024.           Statistics for Today, you would use the following commands:
  8025.  
  8026.                @TODAY@NETWORK
  8027.  
  8028.           And of course, the commands would have to appear before any stats
  8029.           are displayed.  The best  place for  them is on the first line of
  8030.           the file.
  8031.  
  8032.           Keep in  mind that  GAPMENU is a Window oriented program. It does
  8033.           not utilize  nor have  need for  an Ansi Driver. For this reason,
  8034.           your screens  may not  contain any  ANSI sequences.  Use  a  text
  8035.  
  8036.  
  8037.  
  8038.  
  8039.  
  8040.                                       Page 137
  8041.  
  8042.  
  8043.  
  8044.           GAP Communications                                   Call Waiting
  8045.  
  8046.  
  8047.  
  8048.  
  8049.           editor or  an X Code Editor to create your screens. Do not use an
  8050.           Ansi Editor!
  8051.  
  8052.  
  8053.           Sysop Mail
  8054.  
  8055.           Whenever a  user leaves  a message  to the  Sysop,  either  while
  8056.           logged onto  the BBS,  via the  QWK/REP system,  or via Echo Mail
  8057.           using the  UTI drivers,  GAPMENU will  display the  number of new
  8058.           messages for  the Sysop  in the  right hand  corner of the status
  8059.           line.
  8060.  
  8061.  
  8062.  
  8063.  
  8064.  
  8065.  
  8066.  
  8067.  
  8068.  
  8069.  
  8070.  
  8071.  
  8072.  
  8073.  
  8074.  
  8075.  
  8076.  
  8077.  
  8078.  
  8079.  
  8080.  
  8081.  
  8082.  
  8083.  
  8084.  
  8085.  
  8086.  
  8087.  
  8088.  
  8089.  
  8090.  
  8091.  
  8092.  
  8093.  
  8094.  
  8095.  
  8096.  
  8097.  
  8098.                                       Page 138
  8099.  
  8100.  
  8101.  
  8102.  
  8103.  
  8104.  
  8105.  
  8106.  
  8107.  
  8108.           Chapter 12
  8109.  
  8110.  
  8111.  
  8112.                                                                 User Editor
  8113.  
  8114.  
  8115.  
  8116.  
  8117.  
  8118.           ARTWORK
  8119.  
  8120.  
  8121.  
  8122.  
  8123.  
  8124.  
  8125.  
  8126.  
  8127.  
  8128.  
  8129.  
  8130.  
  8131.  
  8132.  
  8133.  
  8134.           The User  Editor is  where you  perform off-line  editing of your
  8135.           user file.
  8136.  
  8137.           The About Menu displays Copyright and Version information.
  8138.  
  8139.           The Edit  Menu allows  you to  Edit the  currently displayed user
  8140.           record, Add  a new  user, Delete  the  currently  displayed  user
  8141.           record, Toggle  the active  Index, Lock  the currently  displayed
  8142.           user out of a Forum and make the currently displayed user a Sysop
  8143.           of a Forum.
  8144.  
  8145.  
  8146.  
  8147.  
  8148.  
  8149.  
  8150.  
  8151.  
  8152.  
  8153.  
  8154.  
  8155.  
  8156.                                       Page 139
  8157.  
  8158.  
  8159.  
  8160.           GAP Communications                                    User Editor
  8161.  
  8162.  
  8163.  
  8164.  
  8165.                               Edit
  8166.                               +------------------------+
  8167.                                 Edit User                              |                        |
  8168.                                 Add User                              |                        |
  8169.                                 Del User           Del                              |                        |
  8170.                                 Toggle Index        I                              |                        |
  8171.                               |------------------------|
  8172.                                 Forum Lock Out                              |                        |
  8173.                                 Forum Sysop                              |                        |
  8174.                               +------------------------+
  8175.  
  8176.           Edit allows  you  to  edit  the  record  of  the  user  currently
  8177.           displayed on the screen.
  8178.  
  8179.           Add will allow you to add a new user to the data base.
  8180.  
  8181.           Del User  allows you  to delete  the currently displayed user. To
  8182.           delete a  user, first  bring their  record to the screen by using
  8183.           the Find  function. Press  the Del key to delete the record. Note
  8184.           that this  function is  permanent! You  will not  be  allowed  to                                                       
  8185.           delete the sysop record.
  8186.  
  8187.           Toggle Index  changes the  active index.  The  user  records  are
  8188.           normally displayed  in Name  order. By selecting Toggle Index you
  8189.           can change the index that is used such that records are displayed
  8190.           by Security  Level/Name order.  This means  that users  with  the
  8191.           highest security level will be shown first.
  8192.  
  8193.           Forum Lockout  will lock  the currently  displayed user  out of a
  8194.           Forum or  a range of Forums. You may need to do this if a certain
  8195.           user needs to be prevented from joining a Public Forum.
  8196.  
  8197.           Forum Sysop  makes the  currently displayed  user  the  Sysop  or
  8198.           Assistant Sysop of a Forum or a range of Forums.
  8199.  
  8200.           The Find  Menu allows  you to  locate a  specific user by Name or
  8201.           Handle.
  8202.  
  8203.                                 Find
  8204.                                 +--------------------+
  8205.                                   Search For User                                |                    |
  8206.                                   Locate User                                |                    |
  8207.                                   Find Handle                                |                    |
  8208.                                 +--------------------+
  8209.  
  8210.  
  8211.  
  8212.  
  8213.  
  8214.                                       Page 140
  8215.  
  8216.  
  8217.  
  8218.           GAP Communications                                    User Editor
  8219.  
  8220.  
  8221.  
  8222.  
  8223.           Search For  User allows  you to  search for  a user  by Last Name
  8224.           using a full or partial search string.
  8225.  
  8226.           Locate User  allows you to find a user by exact name. You will be
  8227.           asked for the First and Last Names to locate.
  8228.  
  8229.           Find Handle  will find a user who is using a specific Handle. You
  8230.           will be asked to supply the text string to locate.
  8231.  
  8232.           The Utilities  Menu allows  you to  perform various Subscription,
  8233.           Forum Registration, and Security level updating functions.
  8234.  
  8235.                             Utilities
  8236.                             +----------------------------+
  8237.                               Register Users                            |                            |
  8238.                               UnRegister Users                            |                            |
  8239.                               Registers Users By Level                            |                            |
  8240.                             |----------------------------|
  8241.                               Update All Users                            |                            |
  8242.                               Update Users In Forum                            |                            |
  8243.                               Update Users By Level                            |                            |
  8244.                               Change Expired Level                            |                            |
  8245.                             |----------------------------|
  8246.                               Reset Pointers                            |                            |
  8247.                               Security level                            |                            |
  8248.                               Level By Uploads                            |                            |
  8249.                               Level by Messages                            |                            |
  8250.                             |----------------------------|
  8251.                               Remove Dupes                            |                            |
  8252.                               Sort                            |                            |
  8253.                             +----------------------------+
  8254.  
  8255.           Register Users  allows you  to register  all of  your users  in a
  8256.           specific Forum or a group of Forums.
  8257.  
  8258.           UnRegister Users  allows you to Unregister all of your Users in a
  8259.           specific Forum or a group of forums.
  8260.  
  8261.           Register Users  By Level allows you to Register users that have a
  8262.           specific security  level in  a Forum  or a group of Forums. It is
  8263.           used mostly to register certain users in a Private Forum.
  8264.  
  8265.           Update All  Users changes  the Subscription  Date for all of your
  8266.           users. If  you just set up a Subscription Board and would like to
  8267.  
  8268.  
  8269.  
  8270.  
  8271.  
  8272.                                       Page 141
  8273.  
  8274.  
  8275.  
  8276.           GAP Communications                                    User Editor
  8277.  
  8278.  
  8279.  
  8280.  
  8281.           set all  of your  users to the same Subscription Expiration Date,
  8282.           you would use this utility.
  8283.  
  8284.           Update Users  In Forum is similar to Update All Users except that
  8285.           it works with users who are a member of a specific Forum.
  8286.  
  8287.           Update Users  By Level  is similar  to the previous two functions
  8288.           except that  it works  with users  who have  a specific  Security
  8289.           Level.
  8290.  
  8291.           Change  Expired   Level  allows   you  to   change  the   Expired
  8292.           Subscription Level  for all  Users who have the Expired Level you
  8293.           provide. If you change your default Expired Subscription Level in
  8294.           the Configuration  Editor, you  may need  to use  this utility to
  8295.           change the Expired Level of your current Userbase.
  8296.  
  8297.           Reset Pointers  will set  the Last  Read Message  numbers for all
  8298.           Users in  all Areas to 0. If you need to reset Last Read pointers
  8299.           for all  users in a specific Forum, simply unregister all of your
  8300.           users from  that specific  Forum. If the Forum is public, that is
  8301.           all you  need do.  If the Forum is private, you will then need to
  8302.           re-register the users in that Forum.
  8303.  
  8304.           Security Level will change the Security Level for users that have
  8305.           the specified  Level that  you provide.  You may need to use this
  8306.           utility  if   you  change   the  Level   For  New  Users  in  the
  8307.           Configuration Editor.
  8308.  
  8309.           Level By  Uploads will change the Security Level of any user that
  8310.           has uploaded a specified number of files.
  8311.  
  8312.           Level By Messages will change the Security Level of any user that
  8313.           has left a specified number of messages.
  8314.  
  8315.           Remove Dupes  allows you  to remove  duplicate records  from  the
  8316.           MEMBER data  file. If you receive a message while rebuilding your
  8317.           MEMBER file  that says  "Duplicate Key  rejected  for  record  at
  8318.           offset xxxx",  where 'xxxx'  is a  numeric value,  then there are
  8319.           duplicate records  in your MEMBER file and only one of them could
  8320.           be indexed.  With this  utility, you  may  remove  the  duplicate
  8321.           records.
  8322.  
  8323.           Sort will  perform a  physical sort  of the  user file, arranging
  8324.           users by  Security Level  and Name.  This function is rarely need
  8325.           but is provided for those that like to have things "in order".
  8326.  
  8327.  
  8328.  
  8329.  
  8330.                                       Page 142
  8331.  
  8332.  
  8333.  
  8334.           GAP Communications                                    User Editor
  8335.  
  8336.  
  8337.  
  8338.  
  8339.  
  8340.           The Reports  Menu allows you to create various reports about your
  8341.           users.
  8342.  
  8343.                               Reports
  8344.                               +------------------------+
  8345.                                 User Listing                              |                        |
  8346.                                 Expired Subscription                              |                        |
  8347.                                 Subscription By Days                              |                        |
  8348.                               +------------------------+
  8349.  
  8350.           User Listing will produce a report on all of your users.
  8351.  
  8352.           Expired Subscription will produce a report listing any user who's
  8353.           subscription has expired or is about to expire.
  8354.  
  8355.           Subscription By Days will produce a report listing any user who's
  8356.           subscription will expire in a specified number of days.
  8357.  
  8358.           Note that  the two  Subscription Reports  will be  available  for
  8359.           selection only  if  you  have  Enforce  Subscription  enabled  in
  8360.           Configuration.
  8361.  
  8362.           The Quit Menu returns you back to the Call Waiting screen.
  8363.  
  8364.  
  8365.  
  8366.  
  8367.  
  8368.  
  8369.  
  8370.  
  8371.  
  8372.  
  8373.  
  8374.  
  8375.  
  8376.  
  8377.  
  8378.  
  8379.  
  8380.  
  8381.  
  8382.  
  8383.  
  8384.  
  8385.  
  8386.  
  8387.  
  8388.                                       Page 143
  8389.  
  8390.  
  8391.  
  8392.           GAP Communications                                    User Editor
  8393.  
  8394.  
  8395.  
  8396.  
  8397.           Command Keys
  8398.  
  8399.           In addition  to the  items available  on the  menus, certain keys
  8400.           will perform  various other  functions. Pressing  F2 will display
  8401.           the Command Keys available:
  8402.  
  8403.                     +--------------------------------------------+
  8404.                          F1           -    Help                    |                                            |
  8405.                          F2           -    This Window                    |                                            |
  8406.                          F3           -    Register User                    |                                            |
  8407.                          F4           -    UnRegister User                    |                                            |
  8408.                          F5           -    DOS Shell                    |                                            |
  8409.                          F6           -    View Membership                    |                                            |
  8410.                          F7           -    Reset Last Read #                    |                                            |
  8411.                          Home         -    Beginning Of File                    |                                            |
  8412.                          End          -    End of File                    |                                            |
  8413.                          UpArrow      -    Previous Record                    |                                            |
  8414.                          DnArrow      -    Next Record                    |                                            |
  8415.                          Del          -    Delete User                    |                                            |
  8416.                          I            -    Change Index                    |                                            |
  8417.                          S            -    Scroll Window                    |                                            |
  8418.                     +--------------------------------------------+
  8419.  
  8420.           Register User (F3) allows you to register the currently displayed
  8421.           user in a Forum or a group of Forums.
  8422.  
  8423.           UnRegister User  (F4) allows  you  to  Unregister  the  currently
  8424.           displayed user in a Forum or a group of Forums.
  8425.  
  8426.           DOS Shell  (F5) will  exit to  DOS, leaving GAPUSER in memory. To
  8427.           return to the program, type "EXIT" at the DOS Command prompt.
  8428.  
  8429.           View Membership  (F6) displays  the Forum Registration screen for
  8430.           the currently  displayed user.  This screen tells you if the user
  8431.           is a member of a specific Forum, the Last Read Message number for
  8432.           each Forum  the user  is a member of, and whether or not the user
  8433.           is Locked Out of the Forum or is a Sysop of a Forum.
  8434.  
  8435.           Reset Last  Read #  (F7) will change the Last Read Message number
  8436.           in a  specific Forum for the currently displayed user to a number
  8437.           of your  choosing. After  entering the  Forum number, the highest
  8438.           message number  in that  Forum will  be displayed  along with the
  8439.           highest message number that the user has read. You may then enter
  8440.           a new Last Read Message number.
  8441.  
  8442.  
  8443.  
  8444.  
  8445.  
  8446.                                       Page 144
  8447.  
  8448.  
  8449.  
  8450.           GAP Communications                                    User Editor
  8451.  
  8452.  
  8453.  
  8454.  
  8455.           Because the  user record contains more fields than can be seen in
  8456.           the window  at one  time, the Scroll Window key (S) allows you to                                        
  8457.           view all of the user fields without having to edit the record and
  8458.           moving the cursor manually.
  8459.  
  8460.  
  8461.           Special Fields
  8462.  
  8463.           Most of  the user  record fields  such as  Name,  Address,  Phone
  8464.           Number, etc,  are self  explanatory. Some  of them however need a
  8465.           bit of explanation to fully understand them.
  8466.  
  8467.           The Regis  Date is  the date  the user  first  logged  onto  your              
  8468.           system.
  8469.  
  8470.           The Sub  Date is the date the user's registration expires. If you
  8471.           do not run a subscription board, this date is meaningless.
  8472.  
  8473.           When adding  a New  User or when a new user logs onto your board,
  8474.           the Country  field defaults  to what  you defined  on  the  Sysop
  8475.           screen in the Configuration Editor.
  8476.  
  8477.           The Private  User flag  specifies if the user is a member of your
  8478.           private board  or not. If you run a private board, the only users
  8479.           that will  be allowed access are those that have this flag set to
  8480.           Yes.
  8481.  
  8482.           Enf Time  Limit overrides  the default  flag in Configuration for
  8483.           this particular  user. Time  limits per  session and/or  day  are
  8484.           configured in your SECLEV file. Whether or not you allow users to
  8485.           call back  an unlimited  number of times per day is set by a flag
  8486.           in Configuration.  If you  generally do  not allow  users to call
  8487.           back after their time has expired, you may override that function
  8488.           for any  particular user  by setting  this field to No. Note that
  8489.           time limits  per session  are still  enforced. In other words, if
  8490.           you give  a user  50 minutes  per session, the user will still be
  8491.           limited to 50 minutes but you may allow a particular user to call
  8492.           back an  unlimited number of times and receive the full 50 minute
  8493.           time allotment by setting this field to No.
  8494.  
  8495.           Default Editor determines which Message Editor the user uses. For
  8496.           new users this field defaults to Ask. Your users may change their
  8497.           default editor  to either Visual or Line at the View/Change Stats                                    
  8498.           Menu.
  8499.  
  8500.  
  8501.  
  8502.  
  8503.  
  8504.                                       Page 145
  8505.  
  8506.  
  8507.  
  8508.           GAP Communications                                    User Editor
  8509.  
  8510.  
  8511.  
  8512.  
  8513.           Chat Avail  determines whether  or not  the user is available for
  8514.           Chat with another user. This flag is only effective in multi user
  8515.           systems.
  8516.  
  8517.           Clear Screen allows the user to have GAP clear the screen between
  8518.           each message that is read.
  8519.  
  8520.           If you  run a  Subscription board  and a  user's subscription has
  8521.           expired, the  user is  set back  to the Expired Level. This level
  8522.           defaults to  the level  you have  set up in Configuration but you
  8523.           may override the default on an individual user basis.
  8524.  
  8525.           If you  run a  subscription board  and a  user's subscription has
  8526.           expired, the  user is  normally removed  from all the Forums such
  8527.           that the user will only be able to join the Public Forums. If you
  8528.           do not  want this  to happen to this particular user, you may set
  8529.           the Public Forums field to No.
  8530.  
  8531.           Disconnects is  the number of times the user has dropped carrier.
  8532.           Many users simply tell their modem to hang up the line instead of
  8533.           being considerate  and using  the normal Goodbye to log off. This
  8534.           field tells you how many times a user has dropped carrier on your
  8535.           system.
  8536.  
  8537.  
  8538.  
  8539.  
  8540.  
  8541.  
  8542.  
  8543.  
  8544.  
  8545.  
  8546.  
  8547.  
  8548.  
  8549.  
  8550.  
  8551.  
  8552.  
  8553.  
  8554.  
  8555.  
  8556.  
  8557.  
  8558.  
  8559.  
  8560.  
  8561.  
  8562.                                       Page 146
  8563.  
  8564.  
  8565.  
  8566.  
  8567.  
  8568.  
  8569.  
  8570.  
  8571.  
  8572.           Chapter 13
  8573.  
  8574.  
  8575.  
  8576.                                                            System Operation
  8577.  
  8578.  
  8579.  
  8580.  
  8581.  
  8582.           This chapter  will describe  all of  the GAP  commands a user (or
  8583.           sysop) will see while logged onto the system.
  8584.  
  8585.  
  8586.           Main Menu Commands
  8587.  
  8588.  
  8589.           +----------------------------------------------------------------+
  8590.             Abandon Forum        Initial News & Wel  Scan Messages          |                                                                |
  8591.             Bulletins            Join A Forum        Text Search Messages          |                                                                |
  8592.             Comment To Sysop     Membership List     View/Change Stats          |                                                                |
  8593.             Enter A Message      New Mail            Xpert Mode          |                                                                |
  8594.             Files System         Page Sysop          Your Personal Mail          |                                                                |
  8595.             GoodBye              Questionnaires      QWK - Dwnld QWK Mail          |                                                                |
  8596.             Help                 Read Messages       REP - Upload REP Mail          |                                                                |
  8597.             CHAT Between Nodes   OPEN A Door         WHO Else is On          |                                                                |
  8598.           +----------------------------------------------------------------+
  8599.  
  8600.           Abandon Forum  - Allows  a user to exit a Forum and return to the
  8601.           Main Board.
  8602.  
  8603.           Bulletins -  Allows a  user to  view the  Main Board bulletins or
  8604.           those bulletins that are specific to a Forum.
  8605.  
  8606.           Comment To Sysop - A user can use this command to quickly enter a
  8607.           comment to the sysop instead of going through the message system.
  8608.           Comments carry the subject COMMENT and are basically  messages to
  8609.           the sysop.
  8610.  
  8611.           Enter A  Message -  This command allows a user to enter a message
  8612.           into whatever message base is active at the moment.
  8613.  
  8614.  
  8615.  
  8616.  
  8617.  
  8618.  
  8619.  
  8620.                                       Page 147
  8621.  
  8622.  
  8623.  
  8624.           GAP Communications                               System Operation
  8625.  
  8626.  
  8627.  
  8628.  
  8629.           Files System  - The  Files System  is a  separate area on GAP. By
  8630.           using this command, the user will enter into a separate area that
  8631.           will cater to any file specific functions.
  8632.  
  8633.           GoodBye -  This is  the command  that will  log a  user  off  the
  8634.           system.
  8635.  
  8636.           Help -  All of the menu commands have associated help files. This
  8637.           command will display any help the user needs.
  8638.  
  8639.           Initial News  & Welcome - This command will allow your callers to
  8640.           review the News and Welcome files.
  8641.  
  8642.           Join A  Forum - Users may join any one of the available Forums by
  8643.           using this command.
  8644.  
  8645.           Membership List  - This command was designed specifically for the
  8646.           Forums but  works in  the Main  Board as  well. It  will show the
  8647.           name, city,  last date on and number of times on of any user that
  8648.           is a  member of the current forum. In the case of the Main Board,
  8649.           it will  display all  of your  users. Note that if a user is in a
  8650.           Forum that  allows  Handles,  GAP  will  display  user's  Handles
  8651.           instead of their name, and the city will not be shown.
  8652.  
  8653.           New Mail  - This  command will  check the  Main Board messages as
  8654.           well as  all of the Forum messages for any new mail the user has.
  8655.           It is identical to the New Mail check when callers first log on.
  8656.  
  8657.           Page Sysop - If a user needs to speak with you now, this function
  8658.           is available. If your Page Bell is turned on, you will be alerted
  8659.           to the  fact. To  answer the  page, press  Ctrl F10  and you will
  8660.           enter into  a chat with the user. To exit the chat, press Esc. If
  8661.           you do  not answer  the page,  the user will be told that you are
  8662.           not in  and will  be asked  to leave  a comment. If a file called
  8663.           PAGE exists  in your  GEN directory,  GAP will  display this file
  8664.           instead of  telling the  user that  you are not available. If you
  8665.           wish to  never be  paged at  all, create a file called NOPAGE and                   
  8666.           place it in the GEN directory. Whenever a caller attempts to page
  8667.           you, GAP  will display  this file  (which should give your office
  8668.           hours, etc.)  and set  a flag  on the status line so that you can
  8669.           see that you have been paged.
  8670.  
  8671.           Questionnaires - You may have up to 99 questionnaires in the Main
  8672.           board plus 99 questionnaires in each of your Forums. This command
  8673.           will allow your users to fill out one of those questionnaires.
  8674.  
  8675.  
  8676.  
  8677.  
  8678.                                       Page 148
  8679.  
  8680.  
  8681.  
  8682.           GAP Communications                               System Operation
  8683.  
  8684.  
  8685.  
  8686.  
  8687.  
  8688.           Read Messages  - This  command places  the user  into the message
  8689.           subsystem. There  are a  great many  additional commands while in
  8690.           that system.
  8691.  
  8692.           Scan Messages  - This  function will allow a user to view message
  8693.           subjects very  quickly. The  TO, FROM,  and SUBJECT fields of the
  8694.           messages will be displayed.
  8695.  
  8696.           Text Search  Messages -  It is  possible with GAP to mark certain
  8697.           messages for  reading. This is the function that allows you to do
  8698.           just that.  Text Search has two options: Full and Quick. The user
  8699.           specifies the  text string  to be  used as  the criteria. A quick
  8700.           search will  scan just  the message  header for  a match.  A full
  8701.           search scans  each message  in its entirety for a match. Needless
  8702.           to say,  the quick search is much faster but the full search will
  8703.           always find a great many more matches than the quick search.
  8704.  
  8705.           If any  match is  found, GAP  will mark  the matched messages. To
  8706.           read those  marked messages, the user must use the Marked command
  8707.           from the Read Messages subcommand.
  8708.  
  8709.           Marked messages are lost when a user joins a Forum or enters into
  8710.           the files system.
  8711.  
  8712.           View/Change Stats  - The  commands associated  with this function
  8713.           allow the user to set preferences.
  8714.  
  8715.           Your Personal  Mail -  This command will show the message numbers
  8716.           corresponding to  any mail  a user  has in  the current area. Any
  8717.           unread messages will be marked with an asterisk after the message
  8718.           number.
  8719.  
  8720.           Chat Between  Nodes -  In a  multi user system, this command will
  8721.           allow users to chat with one another. If you have enabled NetBIOS
  8722.           Chat, characters  are sent  to the other node as soon as they are
  8723.           typed.
  8724.  
  8725.           Open A  Door - This command allows a user to enter through one of
  8726.           your Doors.
  8727.  
  8728.           Who Else  Is On  - In  a multi user system, this command displays
  8729.           the name  and city  for all  the users  that are  on-line in  the
  8730.           system.
  8731.  
  8732.  
  8733.  
  8734.  
  8735.  
  8736.                                       Page 149
  8737.  
  8738.  
  8739.  
  8740.           GAP Communications                               System Operation
  8741.  
  8742.  
  8743.  
  8744.  
  8745.           REP - This command invokes the REPIMPRT module so that a user may
  8746.           upload messages created with an off-line QWK/REP Mail Reader.
  8747.  
  8748.           QWK - This command invokes the QWKEXPRT module so that a user may
  8749.           download messages for off-line reading.
  8750.  
  8751.                The QWK/REP  modules are  described in  detail  in  the
  8752.                chapter System Files.
  8753.  
  8754.  
  8755.           Enter Mail Sub-Commands
  8756.  
  8757.           Depending upon  your configuration options, users may save carbon
  8758.           copy messages. To do so, the original message must be private. By
  8759.           typing SC  instead of S at the message disposition prompt, a user
  8760.           may save carbon copies of a private message. They will be allowed
  8761.           to save up to 99 carbons.
  8762.  
  8763.           If the  message is  to an  individual person, a user may attach a
  8764.           file to  the message.  Only the  recipient of the message will be
  8765.           able to  download the  file. GAP  stores attached  files in  your
  8766.           Attached Files Directory. The files are given a unique name while
  8767.           being stored.  When the  recipient of  the message  downloads the
  8768.           file,  GAP  will  remove  the  attached  file  from  its  holding
  8769.           directory.
  8770.  
  8771.           If a  user replies  to a  message, the message disposition prompt
  8772.           differs slightly  from the  regular message save prompt. The user
  8773.           will be allowed to review the original message while replying. In
  8774.           addition, if  you have  enabled the  quoting feature,  users  may
  8775.           quote all  or part  of the  message they  are replying to. In the
  8776.           visual editor  the commands to quote or view the original message
  8777.           are part of the editor's internal commands.
  8778.  
  8779.  
  8780.           Read Mail Sub-Commands
  8781.  
  8782.           The following commands are available at the Read Mail prompt:
  8783.  
  8784.             Read Mail : [2090-3295] From, To, Since, +-, Marked, Update :
  8785.  
  8786.           A user  may type  a message  number to  read. If  the message  is
  8787.           private and  it is  not To  or From the user, GAP will display an
  8788.           appropriate message.  If a  '+' or  '-'  is  appended  after  the
  8789.  
  8790.  
  8791.  
  8792.  
  8793.  
  8794.                                       Page 150
  8795.  
  8796.  
  8797.  
  8798.           GAP Communications                               System Operation
  8799.  
  8800.  
  8801.  
  8802.  
  8803.           message number,  GAP will skip any private messages that the user
  8804.           cannot read.
  8805.  
  8806.           From displays all messages From the user.
  8807.  
  8808.           To displays all messages To the user.
  8809.  
  8810.           Since displays  all new  messages starting  with the last message
  8811.           the user has read.
  8812.  
  8813.           Marked allows the user to read any messages that were marked with
  8814.           the Text Search command.
  8815.  
  8816.           Update is  basically a  sysop function  that allows  the sysop to
  8817.           read messages  without having  GAP mark any messages To the sysop
  8818.           as having  been read.  To read  all new messages without updating
  8819.           them, the  sysop can  issue the  following at  the  Main  Command
  8820.           prompt:
  8821.  
  8822.                R S U
  8823.  
  8824.           While reading  threads the  user's last message read pointer will
  8825.           not be  updated. This is to allow the user to explore the various
  8826.           threads, and then return to normal reading. A thread in this case
  8827.           is any message with the same subject.
  8828.  
  8829.           After displaying a message, GAP will issue the following prompt:
  8830.  
  8831.             More: Yes, No, Cont, Orig, Thread, #, +-, Reply, Del, Edit,
  8832.                   Protect, File, Move
  8833.  
  8834.           GAP builds  this prompt  dynamically, which  means that depending
  8835.           upon a  user's level and expert status, some of the commands will
  8836.           appear in the prompt and some of them will not.
  8837.  
  8838.           If the  message has  a Refer To number, Original will display the
  8839.           message the current message refers to.
  8840.  
  8841.           Thread allows  the user  to  read  messages  according  to  their
  8842.           subject.
  8843.  
  8844.           Reply allows the user to reply to the current message.
  8845.  
  8846.  
  8847.  
  8848.  
  8849.  
  8850.  
  8851.  
  8852.                                       Page 151
  8853.  
  8854.  
  8855.  
  8856.           GAP Communications                               System Operation
  8857.  
  8858.  
  8859.  
  8860.  
  8861.           Delete allows  the user to delete the current message. Whether or
  8862.           not users  can delete  messages depends  upon your  configuration
  8863.           options.
  8864.  
  8865.           Edit allows the user to edit a message after saving it. Users can
  8866.           edit only  their own  messages. If  the user has the Edit Message
  8867.           Headers security  level, the  user will  also be able to edit the
  8868.           message headers of all messages and will be able to edit the text
  8869.           of all messages.
  8870.  
  8871.           If the  message is  public, the  Protect command  will set  it to
  8872.           private. If  the message  is private,  the  word  UnProtect  will
  8873.           appear instead  and it  will allow  the user  to make the message
  8874.           public.
  8875.  
  8876.                +------------------------------------------------------+
  8877.                 It   may   be   a   violation   of   the   Electronic               |                                                      |
  8878.                 Communications Privacy  Act Of 1986 for you to make a               |                                                      |
  8879.                 private  message   public.  GAP  Development  Company               |                                                      |
  8880.                 provides this function for use at the sole discretion               |                                                      |
  8881.                 of the  system provider and accepts no responsibility               |                                                      |
  8882.                 for its misuse.               |                                                      |
  8883.                +------------------------------------------------------+
  8884.  
  8885.           File will  take  you  into  the  on-line  user  editor  and  will
  8886.           automatically bring  up the  record of  the person  who wrote the
  8887.           message you were currently reading.
  8888.  
  8889.           Move will  move the  current message  into a  Forum. If  you  are
  8890.           already in  a Forum,  you have  the option  of moving the message
  8891.           into the  Main Board message base or into another Forum. You will
  8892.           be asked  if you  wish to  delete the  original message.  If  you
  8893.           answer No, the Move command is equivalent to a Copy command.
  8894.  
  8895.  
  8896.           View/Change Stats Sub-Commands
  8897.  
  8898.           By entering  V from  the main command prompt, the user will enter
  8899.           into the  View/Change Stats  system. GAP  will display the user's
  8900.           statistics and issue the following prompt:
  8901.  
  8902.                View : Color, Forums, Stats, Transfer, Xpert, Help :
  8903.  
  8904.           Color -  This command will allow the user to toggle his/her color
  8905.           graphic displays.  Users can  toggle their  color mode and bypass
  8906.  
  8907.  
  8908.  
  8909.  
  8910.                                       Page 152
  8911.  
  8912.  
  8913.  
  8914.           GAP Communications                               System Operation
  8915.  
  8916.  
  8917.  
  8918.  
  8919.           the View/Change  Stats Menu  by typing  V C  at the  Main Command
  8920.           prompt.
  8921.  
  8922.           Forums -  Allows users  to Register  and Unregister themselves in
  8923.           public Forums.
  8924.  
  8925.           Stats -  This command  allows the user to change his/her Address,
  8926.           Phone numbers, Password, Handle, Birth date and other fields.
  8927.  
  8928.             If you  configured GAP to not allow Address changes, the user
  8929.             will not  be allowed  to change  his/her Address information,
  8930.             Phone numbers,  or Birth  date. If  you allow handles on your
  8931.             system, the  users will  be able to give themselves a handle,
  8932.             otherwise they will not be allowed to change this field.
  8933.  
  8934.           Transfer Protocol  - This  command  allows  users  to  set  their
  8935.           default transfer  protocol. The  file PROTO  must be  in the  GEN
  8936.           directory or the user will not know what protocols are available.
  8937.           Please see the chapter External Protocols for further information
  8938.           about the PROTO file. This command is also available at the Files
  8939.           Command prompt as Protocol Change.
  8940.  
  8941.           Xpert Mode  - Users  can  toggle  their  expert  mode  with  this
  8942.           command. Xpert Mode is also available at the Main Command prompt.
  8943.  
  8944.  
  8945.           File System Commands
  8946.  
  8947.  
  8948.           +----------------------------------------------------------------+
  8949.                 Archive Commands                  File Commands          |                                                                |
  8950.           |                                                                |
  8951.                                                   Enhanced Directories          |                                                                |
  8952.                 View An Archive File              File Directories          |                                                                |
  8953.                 Select An Archive File            Download A File          |                                                                |
  8954.                 Transfer A File From Archive      Locate A File          |                                                                |
  8955.                 Read File From Archive            New Files          |                                                                |
  8956.                                                   Upload A File          |                                                                |
  8957.           |                                                                |
  8958.                               Miscellaneous Commands          |                                                                |
  8959.           |                                                                |
  8960.                 Browse Text File                  GoodBye          |                                                                |
  8961.                 Help                              Protocol Change          |                                                                |
  8962.                 Quit To Main Menu                 Xpert Mode          |                                                                |
  8963.           +----------------------------------------------------------------+
  8964.  
  8965.  
  8966.  
  8967.  
  8968.                                       Page 153
  8969.  
  8970.  
  8971.  
  8972.           GAP Communications                               System Operation
  8973.  
  8974.  
  8975.  
  8976.  
  8977.  
  8978.  
  8979.           File Commands
  8980.  
  8981.           Enhanced Directories  - This  command is  similar to  the regular
  8982.           File Directories command except that files are listed in enhanced
  8983.           format.
  8984.  
  8985.           File Directories  - This command will display your file directory
  8986.           menu. It  includes an  expanded more  prompt where  the user  may
  8987.           download a  file directly  without having  to return to the Files
  8988.           System Menu.  This command  is the  gateway for listing the files
  8989.           that are available on your system.
  8990.  
  8991.           Download A  File - Users may download files with this command. If
  8992.           the user's  default protocol is set to one of the batch protocols
  8993.           or if  the user  overrides the  default by  stacking the protocol
  8994.           with the  filename (i.e.,  D FILE.ZIP Y), GAP will allow the user
  8995.           to queue up to the maximum files you specified for their security
  8996.           level (in  the SECLEV file) for batch downloading. Wile Cards are
  8997.           allowed. However,  the first  character in  a file  name may  not
  8998.           contain a Wild Card character. In addition, the ? is ignored.
  8999.  
  9000.           Locate A  File -  This command  allows users  to locate  any file
  9001.           listed in  your FileBase.  It consists  of two  subcommands  that
  9002.           allow for  finding a  file by wild card name, or by a text string
  9003.           (where a match is if the search string is contained within any of
  9004.           the keywords).
  9005.  
  9006.           New Files - Users may search for new files uploaded to the system
  9007.           by using this command.
  9008.  
  9009.           Upload A File - This command allows users to upload a file. After
  9010.           selecting the  Upload command,  GAP will  display a  file  called
  9011.           UPLOAD (if  it exists).  This file  should inform your users what
  9012.           your upload  policy is. If the user's Transfer Protocol is set to
  9013.           a Batch  protocol, GAP will ask the user if he/she wishes to send
  9014.           more than one file. If the user answers Yes, GAP will immediately
  9015.           begin receiving the files. The user will be prompted for the file
  9016.           descriptions after  all of  the files  have been received. If the
  9017.           user answers No, GAP will first prompt the user for a description
  9018.           of the  file and  after saving  the description,  will then begin
  9019.           receiving the file.
  9020.  
  9021.  
  9022.  
  9023.  
  9024.  
  9025.  
  9026.                                       Page 154
  9027.  
  9028.  
  9029.  
  9030.           GAP Communications                               System Operation
  9031.  
  9032.  
  9033.  
  9034.  
  9035.           For each  file uploaded, GAP will shell to your UPCHECK.BAT file.
  9036.           This file  is described  in detail  in the  chapter System Files.                                                              
  9037.           Processing a  file through  the UPCHECK.BAT  serves two purposes.
  9038.           The first is to check the integrity of the file and the second is
  9039.           to extract  a description  file out of the archive. A description
  9040.           file is  a text  file (usually formatted to 10 or less lines with
  9041.           45 or  less characters  per line),  that describes  the  uploaded
  9042.           file.  This   description  file  is  called  either  DESC.SDI  or
  9043.           FILE_ID.DIZ and  is included inside of an archive. Including such
  9044.           a file  allows  the  author  of  the  program  (rather  than  the
  9045.           uploader) to  describe what  the archive  is all  about. GAP will
  9046.           process a  description file  only if  the user  opted to upload a
  9047.           batch of  files. If  GAP finds  a description  file in  the  work
  9048.           directory, it  will import the file into the File Description and
  9049.           the user  will be  given the  opportunity to either keep the file
  9050.           description or change it. Description files are described in more
  9051.           detail in the Special Batch Files section of System Files.
  9052.  
  9053.  
  9054.           Archive Commands
  9055.  
  9056.           View An  Archive File  - This  command allows  users to  view the
  9057.           contents of any ARC or ZIP file.
  9058.  
  9059.           Select An  Archive File  - Users  may select  an archive  file to
  9060.           process with this command.
  9061.  
  9062.           Transfer A  File - This command allows users to download any file
  9063.           contained within the archive. It is not necessary to download the
  9064.           entire archive  file if  the user  simply  needs  a  single  file
  9065.           contained within the archive. The Archive submenu will also allow
  9066.           a user  to download  the complete archive without having to use a
  9067.           separate file  function. When  a callers requests a Transfer, GAP
  9068.           will shell  to your  ARCTRANS.BAT file  which is  responsible for
  9069.           extracting the  requested file out of the archive and placing the
  9070.           resultant file  in your  Loose File  Directory. The  ARCTRANS.BAT
  9071.           file is described in detail in the chapter System Files.
  9072.  
  9073.           Read A  File From  Archive -  Users may read any doc or text file
  9074.           contained within an ARC or ZIP file.
  9075.  
  9076.  
  9077.  
  9078.  
  9079.  
  9080.  
  9081.  
  9082.  
  9083.  
  9084.                                       Page 155
  9085.  
  9086.  
  9087.  
  9088.           GAP Communications                               System Operation
  9089.  
  9090.  
  9091.  
  9092.  
  9093.           Miscellaneous Commands
  9094.  
  9095.           Browse Text  File -  This command  allows  callers  to  view  the
  9096.           contents of  any text file on your system. The file must have the
  9097.           extension of .DOC or .TXT.
  9098.  
  9099.           GoodBye -  Caller's may  log off the system from within the Files
  9100.           Area.
  9101.  
  9102.           Help - Allows callers to obtain help for the File Menu commands.
  9103.  
  9104.           Protocol Change  - This  command allows  your callers  to  change
  9105.           their default  Protocol without  having to  Quit back to the Main
  9106.           Menu and issue the View/Change Stats command.
  9107.  
  9108.           Quit To Main Menu - Returns the caller to the Main Menu.
  9109.  
  9110.           Xpert Mode  - This  command allows  your callers  to change their
  9111.           Expert status.
  9112.  
  9113.           Users may  also Join  a Forum  from within the Files System. When
  9114.           issuing the  Join command from the Files System, the user will be
  9115.           placed at  the Main Board command prompt and not the Files System
  9116.           command prompt.
  9117.  
  9118.  
  9119.           Sysop Commands
  9120.  
  9121.  
  9122.           Function Keys
  9123.  
  9124.           The Sysop Keys can be disabled if you are running under a LAN. To
  9125.           disable  these   keys  set   the  Disable  Local  Sysop  Keys  in                                            
  9126.           Configuration to Yes.
  9127.  
  9128.           F1 -  This is the Exit to DOS toggle. If on, GAP will exit to DOS
  9129.           instead of  recycling. A  flashing D  will display  on the status
  9130.           line to remind you that it is on.
  9131.  
  9132.           F2 -  This is the LOCKOUT key. Pressing it while a user is logged
  9133.           on will  lock the user out and log him/her off the system. If the
  9134.           file LOCKOUT is available, it will be displayed to the user prior
  9135.           to logging  him/her off.  The name of any locked out user via the
  9136.           F2 key will be placed in the Trash Can.
  9137.  
  9138.  
  9139.  
  9140.  
  9141.  
  9142.                                       Page 156
  9143.  
  9144.  
  9145.  
  9146.           GAP Communications                               System Operation
  9147.  
  9148.  
  9149.  
  9150.  
  9151.           F3 -  This is  the On-line User Update Key. Pressing it will take
  9152.           you into  the On-line  User Editor  where you  may edit  the user
  9153.           record of the caller.
  9154.  
  9155.           F4 -  This is  the Printer  toggle. If on, the caller log will be
  9156.           routed to the printer.
  9157.  
  9158.           F5 -  This key  will allow you to locally shell to DOS. To return
  9159.           to the  system from DOS, type "EXIT". You will be returned to the
  9160.           exact place you were prior to the shell.
  9161.  
  9162.           F6 - This will toggle the sysop page bell on/off.
  9163.  
  9164.           F7 - The caller alarm may be toggled on or off with this key.
  9165.  
  9166.           F8 -  This is  the TWIT key. You may use it to log a user off the
  9167.           system. If  the file  TWIT is  available, it will be displayed to
  9168.           the user.
  9169.  
  9170.           F9 -  This is  the SYSOP  key. While a user is on-line, it allows
  9171.           you to take full control of the system. You, or the user, will be
  9172.           allowed to  perform any  command. The  users will remain at their
  9173.           level and  will not  see any  commands  other  than  those  which
  9174.           correspond to  their security  level. It  is important that while
  9175.           you use  this function,  you perform  any tasks at hand, and then
  9176.           toggle the function off by pressing the key a second time.
  9177.  
  9178.           F10 - To initiate a chat, press this key.
  9179.  
  9180.           Ctrl F10  - This  key allows you to answer the page bell and chat
  9181.           with a user. The entire contents of a sysop chat with a user will
  9182.           be written  to a  file called  SYSCHAT (located  in  the  DEFAULT
  9183.           directory). The  file will be appended with each chat so you will
  9184.           not loose what was previously written.
  9185.  
  9186.           Shft Fxx - To display your function key macros, you may press the
  9187.           Shift Function Keys.
  9188.  
  9189.           Alt F1 - Displays the main user information on the status line.
  9190.  
  9191.           Alt F2 - Displays the available status line keys.
  9192.  
  9193.           Alt F3 - Displays additional user information.
  9194.  
  9195.  
  9196.  
  9197.  
  9198.  
  9199.  
  9200.                                       Page 157
  9201.  
  9202.  
  9203.  
  9204.           GAP Communications                               System Operation
  9205.  
  9206.  
  9207.  
  9208.  
  9209.           Alt I  - While entering a message, allows you to import text into
  9210.           the message.  You will  be asked for a file name. It is important
  9211.           that the  text you  wish to import be formatted to 72 columns. It
  9212.           is not  necessary to  have hard  spaces for blank lines. Any line
  9213.           which is longer than 72 columns will be truncated.
  9214.  
  9215.           Alt F  - This  function will  allow you  to export  messages to a
  9216.           file. The  name of  the file  will be  the same base name as your
  9217.           Messages file  but with  a .TXT extension. While this function is
  9218.           toggled ON,  any message you read will be written to the file. It
  9219.           will automatically  be toggled  off when  you leave the Read Mail                                                                  
  9220.           function. If you are in color mode while using this function, you
  9221.           will be automatically placed in noncolor mode.
  9222.  
  9223.           Alt F7 - This key will decrease the user's time available by five
  9224.           minutes.
  9225.  
  9226.           Alt F8  - Pressing  this key  will give  the user  an extra  five
  9227.           minutes of time available.
  9228.  
  9229.           Alt F9 - This key will decrease the user's security level by one.
  9230.  
  9231.           Alt F10  - Pressing  this key  will increase  the user's security
  9232.           level by one.
  9233.  
  9234.           Note that changing a user's security level will update the status
  9235.           line as  you press the keys, however increasing or decreasing the
  9236.           user's time will give no indication as to what is occurring until
  9237.           the user  issues a  command at the Main or Files prompt. Use with
  9238.           caution since GAP does not care if you have a lead finger!
  9239.  
  9240.           Sysop Functions
  9241.  
  9242.           1    View Caller's  Log -  Allows you  to view the current node's
  9243.           caller file, backwards.
  9244.  
  9245.           2    View Users  - Displays statistics on each of your users. You
  9246.           may view the users either forwards or backwards.
  9247.  
  9248.           3    View A  File -  Allows you to view any text file. Unlike the
  9249.           Files System Browse command, this command accepts path names.
  9250.  
  9251.           4    Maintain Users  File - This function performs as a mini user
  9252.           editor. You  may add  users, delete  users, find  any  user,  and
  9253.  
  9254.  
  9255.  
  9256.  
  9257.  
  9258.                                       Page 158
  9259.  
  9260.  
  9261.  
  9262.           GAP Communications                               System Operation
  9263.  
  9264.  
  9265.  
  9266.  
  9267.           register/unregister users  in any  Forum. Some of the user fields
  9268.           will be unavailable with this function.
  9269.  
  9270.           You may  register or  unregister users  in as many Forums as will
  9271.           fit on  the command  line. Simply separate the Forums with commas
  9272.           (i.e., 1,2,3,4,5,6,7,8,9).  You may  also  type  in  a  range  of
  9273.           numbers such as 1-5.
  9274.  
  9275.           Remember that deleting a user is permanent.
  9276.  
  9277.           To scroll  through the user file, simply press [Enter]. To change
  9278.           the direction of the scroll, use the [+] [-] keys.
  9279.  
  9280.           Note that  when adding  or editing a user, GAP will not allow you
  9281.           to give  the user  a security level higher than your own. This is
  9282.           to prevent co-sysops from raising their own security level.
  9283.  
  9284.           5    Dos Functions - This function allows you to exit to DOS from
  9285.           remote, and  to perform  DOS commands.  There  are  two  security
  9286.           levels associated  with this  function. To  perform DOS commands,
  9287.           the user  will need  at least  the security level associated with
  9288.           exiting to DOS.
  9289.  
  9290.           In order  to exit to DOS, you must have the remote batch file set
  9291.           up as described in the chapter System Files.
  9292.  
  9293.           While performing DOS commands, it is important that you type your
  9294.           input  very  carefully.  You  will  not  see  the  command  being
  9295.           executed. In  addition, should  you type  a command that requires
  9296.           local keyboard  input, your  computer will seem to freeze because
  9297.           there will  be nobody  at the local keyboard to type the response
  9298.           that DOS is expecting. Use this command with caution.
  9299.  
  9300.           6    Other Node Users - In a multi user system, this command will
  9301.           allow you to view the caller logs of other nodes.
  9302.  
  9303.           7    Restore Messages  - This  command allows  you to  restore  a
  9304.           deleted message.  To see  which messages  are deleted,  perform a
  9305.           message Scan. Any deleted messages will be marked. Note than only
  9306.           users who  can restore  messages will  see these  marked messages
  9307.           while performing a Scan.
  9308.  
  9309.  
  9310.  
  9311.  
  9312.  
  9313.  
  9314.  
  9315.  
  9316.                                       Page 159
  9317.  
  9318.  
  9319.  
  9320.  
  9321.  
  9322.  
  9323.  
  9324.  
  9325.  
  9326.           Chapter 14
  9327.  
  9328.  
  9329.  
  9330.                                                             FileBase Editor
  9331.  
  9332.  
  9333.  
  9334.  
  9335.  
  9336.  
  9337.           Description
  9338.  
  9339.           GAPFILE is  an external editor to manage the ISAM files subsystem
  9340.           of  GAP.  It  provides  full  support  for  listing  directories,
  9341.           updating directories,  moving files,  viewing  archive  contents,
  9342.           adding/editing file descriptions, and much more.
  9343.  
  9344.           The GAP  files subsystem  consists of  a set  of ISAM files which
  9345.           allow the  sysop to manage his file directories in a more orderly
  9346.           fashion. Rather  than having  several text  files which contain a
  9347.           one line  description of  a file  residing  in  a  physical  disk
  9348.           directory, the  sysop has  access to  a powerful  database  which
  9349.           contains detailed  information about  a file  including a keyword
  9350.           field and up to 10 lines of descriptive information.
  9351.  
  9352.           The FileBase  also contains  a keyword  data  file  which  allows
  9353.           sysops and users alike to perform quick and powerful searches for
  9354.           specific files.
  9355.  
  9356.           Setup
  9357.  
  9358.           The following files are needed:
  9359.  
  9360.                          +----------------------------------+
  9361.                             Name                 Directory                         |                                  |
  9362.                          |----------------------------------|
  9363.                             GAPFILE.EXE          DEFAULT                         |                                  |
  9364.                             GAPFILE.CNF          DEFAULT                         |                                  |
  9365.                             DIRS                 GEN                         |                                  |
  9366.                             FILES.DIR            GEN                         |                                  |
  9367.                          +----------------------------------+
  9368.  
  9369.  
  9370.  
  9371.  
  9372.  
  9373.  
  9374.                                       Page 161
  9375.  
  9376.  
  9377.  
  9378.           GAP Communications                                FileBase Editor
  9379.  
  9380.  
  9381.  
  9382.  
  9383.           The following files will be created in your MAIN directory:
  9384.  
  9385.                               +------------------------+
  9386.                                  FILES.DAT                              |                        |
  9387.                                  FILES.IDX                              |                        |
  9388.                                  FILEKEY.DAT                              |                        |
  9389.                                  FILEKEY.IDX                              |                        |
  9390.                               +------------------------+
  9391.  
  9392.           GAPFILE resides  in the  DEFAULT directory  where  it  must  have
  9393.           access to the GAP configuration file, GAPBBS.CNF.
  9394.  
  9395.           The sysop must create three files. These are DIRS, FILES.DIR, and
  9396.           GAPFILE.CNF. Sample files are provided.
  9397.  
  9398.           The format of DIRS is as follows:
  9399.  
  9400.                          +----------------------------------+
  9401.                             1 Communication Programs                         |                                  |
  9402.                             2 Read MAC Pictures                         |                                  |
  9403.                             3 Programmers                         |                                  |
  9404.                             4 Utilities                         |                                  |
  9405.                             5 Uploads                         |                                  |
  9406.                          +----------------------------------+
  9407.  
  9408.           Each file contained within the FileBase must belong to a specific
  9409.           subject. The  DIRS file tells GAP and GAPFILE what those subjects
  9410.           are.
  9411.  
  9412.           This file  will become  a permanent part of your FileBase system.
  9413.           It is  used by both GAPFILE and GAP. Basically it contains a list
  9414.           that gives  a name  to each  of your directories. Directories are
  9415.           called Subjects  in GAPFILE. As you can see, this file is similar
  9416.           to your  DIR and  DIRG files  except this  is an  internal system
  9417.           file. GAP  uses this  file to  display the  name of  the  current
  9418.           subject a  caller is  viewing. For  instance, if  you ask  for  a
  9419.           listing of  directory 1, GAP will first read line 1 from the DIRS
  9420.           file, display the subject number and name that it finds, and will
  9421.           then list  the files in that directory. GAPFILE uses this file to
  9422.           build a  list of available subjects which you may view anytime by
  9423.           pressing F10.  GAPFILE also  uses the  DIRS file  when creating a
  9424.           Master File listing and when displaying subject categories during
  9425.           various operations.
  9426.  
  9427.  
  9428.  
  9429.  
  9430.  
  9431.  
  9432.                                       Page 162
  9433.  
  9434.  
  9435.  
  9436.           GAP Communications                                FileBase Editor
  9437.  
  9438.  
  9439.  
  9440.  
  9441.           The DIRS  file must be complete! By complete, we mean that if you
  9442.           have 10 directories set up in config, you must have 10 entries in
  9443.           the DIRS file (no more and no less).
  9444.  
  9445.           Note that  the format  for the  file is  the same  as the rest of
  9446.           GAP's system  files. Field 1 is the directory number, followed by
  9447.           a single space, followed by field 2 which is a description of the
  9448.           subject.
  9449.  
  9450.           The format of FILES.DIR is as follows:
  9451.  
  9452.                               +------------------------+
  9453.                                  C:\DL1                              |                        |
  9454.                                  C:\DL2                              |                        |
  9455.                                  D:\DL3                              |                        |
  9456.                                  D:\DL4                              |                        |
  9457.                                  D:\UP                              |                        |
  9458.                               +------------------------+
  9459.  
  9460.           FILES.DIR is  used by  many of  the Utility Functions of GAPFILE.
  9461.           The entries  tell the  program where  the files  for  a  specific
  9462.           subject belong  on the  disk drive.  Each entry  in the file must
  9463.           correspond to  its respective  entry  in  DIRS.  If  you  have  5
  9464.           subjects (directories) then there must be 5 entries in this file.
  9465.  
  9466.           If a  Forum also  has directories (directories in addition to the
  9467.           Main Board  directories), it  will need the following files which
  9468.           must be  placed in the Forum GEN directory. If the Forum does not
  9469.           have a  GEN directory, then the files must be placed in the Forum
  9470.           DEFAULT directory:
  9471.  
  9472.                          +----------------------------------+
  9473.                             Name                 Directory                         |                                  |
  9474.                          |----------------------------------|
  9475.                             DIRS                 FORUM GEN                         |                                  |
  9476.                             FILES.DIR            FORUM GEN                         |                                  |
  9477.                          +----------------------------------+
  9478.  
  9479.           The FILES.DIR for the Forum should list only the additional paths
  9480.           associated with  the additional directories (or the paths for the
  9481.           directories unique  to that  Forum). The DIRS file (which will be
  9482.           used by  GAP) should  list only  the additional  subjects for the
  9483.           Forum (or the subjects unique to that Forum).
  9484.  
  9485.  
  9486.  
  9487.  
  9488.  
  9489.  
  9490.                                       Page 163
  9491.  
  9492.  
  9493.  
  9494.           GAP Communications                                FileBase Editor
  9495.  
  9496.  
  9497.  
  9498.  
  9499.           The  following  are  sample  files  for  a  Forum  that  has  two
  9500.           additional  directories,   where  Use  Main  Dirs  in  the  Forum
  9501.           configuration is  set to  Yes, and  the main  board has  10  file
  9502.           directories:
  9503.  
  9504.                          FILES.DIR
  9505.                          +----------------------------------+
  9506.                             C:\GAP\SUP\DIR11                         |                                  |
  9507.                             C:\GAP\SUP\UP                         |                                  |
  9508.                          +----------------------------------+
  9509.  
  9510.                          DIRS
  9511.                          +----------------------------------+
  9512.                             11 Support Forum Files                         |                                  |
  9513.                             12 Support Forum Uploads                         |                                  |
  9514.                          +----------------------------------+
  9515.  
  9516.           If a  Forum is  set up to have unique directories, where Use Main
  9517.           Dirs in the Forum configuration is set to No, the following files
  9518.           might be used:
  9519.  
  9520.                          FILES.DIR
  9521.                          +----------------------------------+
  9522.                             C:\GAP\SUP\DIR1                         |                                  |
  9523.                             C:\GAP\SUP\UP                         |                                  |
  9524.                          +----------------------------------+
  9525.  
  9526.                          DIRS
  9527.                          +----------------------------------+
  9528.                             1 Support Forum Files                         |                                  |
  9529.                             2 Support Forum Uploads                         |                                  |
  9530.                          +----------------------------------+
  9531.  
  9532.  
  9533.           GAPFILE.CNF is  a configuration file for the FileBase Editor. You
  9534.           will need  to initially  create this file. After that, it will be
  9535.           maintained by GAPFILE. The format of the file is as follows:
  9536.  
  9537.                               +------------------------+
  9538.                                       G,H,I,F,C                              |                        |
  9539.                               +------------------------+
  9540.  
  9541.           The first  line represents  the drives  you wish to have searched
  9542.           when locating  a file.  Notice that there are no colons after the
  9543.           drive letter.
  9544.  
  9545.  
  9546.  
  9547.  
  9548.                                       Page 164
  9549.  
  9550.  
  9551.  
  9552.           GAP Communications                                FileBase Editor
  9553.  
  9554.  
  9555.  
  9556.  
  9557.  
  9558.           When a  new file  is entered  into the FileBase, an existing file
  9559.           updated, or  the global  Update function used, GAPFILE will check
  9560.           the system  drives for the existence of the file. It does this by
  9561.           starting with  drive C,  searches all  of the directories on that
  9562.           drive, and  if the  file is not found, moves on to the next drive
  9563.           in the system.
  9564.  
  9565.           The reason  for line  one in  GAPFILE.CNF is  twofold. If you are
  9566.           running a  network you  do not  want GAPFILE  to search your non-
  9567.           networked drives, or perhaps, search the non-networked drives but
  9568.           do so after searching the shared drives.
  9569.  
  9570.           For instance,  with  Lantastic,  if  drive  C  is  designated  as
  9571.           networked drive  G (so that workstations can share drive C), from
  9572.           the host  it is  possible to  use either  drive  G  or  drive  C.
  9573.           However, the workstations are permitted to use and have access to
  9574.           drive G.  If left alone when locating a file, GAPFILE will search
  9575.           drive C  first and  if the  file is found, will use that drive as
  9576.           part of  the location  of the  file. This  would be  fine for the
  9577.           host, but the workstations would be unable to access the file. By
  9578.           specifying which drives to search, this problem is eliminated.
  9579.  
  9580.           The second  reason for this configuration option is to be able to
  9581.           specify when, if ever, a CD-ROM drive is to be searched. Once the
  9582.           directories for  a CD-ROM  are configured,  they are normally not
  9583.           changed. Searching  a CD-ROM  for a  single file can take several
  9584.           minutes. Once  configured, the  CD-ROM drive  can be removed from
  9585.           the list of drives to search.
  9586.  
  9587.           It is  not necessary to have anything in line one of GAPFILE.CNF.
  9588.           A blank  entry will  cause GAPFILE  to search  all drives  in the
  9589.           system (with  the exception  of  the  floppy  drives).  For  non-
  9590.           networked, hard  disk only  systems, the  time spent searching is
  9591.           minimal.
  9592.  
  9593.           After you  run  GAPFILE  the  first  time,  you  will  find  that
  9594.           additional entries  were placed  in  the  file.  This  additional
  9595.           information is  for internal use and should be left as is. If you
  9596.           need to  change line 1 of the file, you may do so but remember to
  9597.           leave the other entries as they are.
  9598.  
  9599.  
  9600.  
  9601.  
  9602.  
  9603.  
  9604.  
  9605.  
  9606.                                       Page 165
  9607.  
  9608.  
  9609.  
  9610.           GAP Communications                                FileBase Editor
  9611.  
  9612.  
  9613.  
  9614.  
  9615.           Running Gapfile
  9616.  
  9617.           When first invoked, GAPFILE will display the first file in Area 0
  9618.           (main board),  Subject 1.  The screen  will look  similar to  the
  9619.           following:
  9620.  
  9621.           ARTWORK
  9622.  
  9623.  
  9624.  
  9625.  
  9626.  
  9627.  
  9628.  
  9629.  
  9630.  
  9631.  
  9632.  
  9633.  
  9634.  
  9635.  
  9636.  
  9637.           The following Command Keys are available:
  9638.  
  9639.                     +--------------------------------------------+
  9640.                          F1           -    Help                    |                                            |
  9641.                          F3           -    Change Area                    |                                            |
  9642.                          F4           -    Change Subject                    |                                            |
  9643.                          F5           -    List Files                    |                                            |
  9644.                          F6           -    Move File                    |                                            |
  9645.                          F7           -    List ARC/ZIP                    |                                            |
  9646.                          F8           -    Find Matching File                    |                                            |
  9647.                          F10          -    List Subjects                    |                                            |
  9648.                          Home         -    Beginning Of File                    |                                            |
  9649.                          End          -    End Of File                    |                                            |
  9650.                          UpArrow      -    Previous Record                    |                                            |
  9651.                          DnArrow      -    Next Record                    |                                            |
  9652.                          PgUp         -    Back 10 Records                    |                                            |
  9653.                          PgDn         -    Forward 10 Records                    |                                            |
  9654.                          Del          -    Delete File                    |                                            |
  9655.                     +--------------------------------------------+
  9656.  
  9657.           By pressing F2, these Command Keys will be displayed.
  9658.  
  9659.  
  9660.  
  9661.  
  9662.  
  9663.  
  9664.                                       Page 166
  9665.  
  9666.  
  9667.  
  9668.           GAP Communications                                FileBase Editor
  9669.  
  9670.  
  9671.  
  9672.  
  9673.           In addition  to these keys, you may shell to DOS by pressing Alt-
  9674.           F5.
  9675.  
  9676.           The help  is context  sensitive, which means it changes depending
  9677.           upon what operation is being performed.
  9678.  
  9679.           The available  keys are also context sensitive and their function
  9680.           will change  depending upon  which section  of the editor you are
  9681.           in.
  9682.  
  9683.           If you  wish to  change areas  (i.e., from  the Main  Board to  a
  9684.           Forum), pressing F3 will allow you to do so.
  9685.  
  9686.           F4 will allow you to quickly change subjects.
  9687.  
  9688.           If you  would like  a familiar  listing of the files contained in
  9689.           the current subject, or all files, use F5.
  9690.  
  9691.           F6 allows  you to  move the  current file  to any subject/area of
  9692.           your choice.
  9693.  
  9694.           The listing of ARC or ZIP files can be accomplished by using F7.
  9695.  
  9696.           To find a specific file, use F8.
  9697.  
  9698.           F10 allows you to view a list of subjects for the current area.
  9699.  
  9700.           Pressing Home will display the first file.
  9701.  
  9702.           Pressing End will display the last file.
  9703.  
  9704.           To scroll  backwards in  the file, you may use either PgUp or the
  9705.           UpArrow key.
  9706.  
  9707.           To scroll  forwards in  the file,  you may use either PgDn or the
  9708.           DnArrow key.
  9709.  
  9710.           To delete the currently displayed file (physically as well as its
  9711.           entry in  the FileBase)  use the  Del key.  Note that deletion is
  9712.           permanent and  it is  impossible to  recover the  file once it is
  9713.           deleted. You will be asked to confirm the delete operation.
  9714.  
  9715.  
  9716.  
  9717.  
  9718.  
  9719.  
  9720.  
  9721.  
  9722.                                       Page 167
  9723.  
  9724.  
  9725.  
  9726.           GAP Communications                                FileBase Editor
  9727.  
  9728.  
  9729.  
  9730.  
  9731.           Use the Edit Menu to Add, Edit, or Delete Files:                  
  9732.  
  9733.                               Edit
  9734.                               +------------------------+
  9735.                                 Edit File                              |                        |
  9736.                                 Add File                              |                        |
  9737.                                 Del File           Del                              |                        |
  9738.                               +------------------------+
  9739.  
  9740.           Edit  File  allows  you  to  edit  the  file  that  is  currently
  9741.           displayed.
  9742.  
  9743.           Add File  allows you  to add  a new  file to  the FileBase.  When
  9744.           adding a  file, GAPFILE  will initially display certain defaults.
  9745.           You  may   either  accept  the  defaults  or  type  in  your  own
  9746.           parameters.
  9747.  
  9748.           Del File  is the  same as  pressing the  Del Key.  The  currently
  9749.           displayed file will be deleted from the disk and removed from the
  9750.           FileBase.
  9751.  
  9752.           While in  Add or  Edit  mode,  the  available  keys  will  change
  9753.           depending upon  which part of the editor you are in. While in the
  9754.           top half of the screen, the following keys are available:
  9755.  
  9756.                     +--------------------------------------------+
  9757.                          F1           -   Help                    |                                            |
  9758.                          F2           -   This Screen                    |                                            |
  9759.                          F9           -   Quit Edit - Save                    |                                            |
  9760.                          Esc          -   Quit Edit - Don't Save                    |                                            |
  9761.                          Home         -   Beginning Of Field                    |                                            |
  9762.                          End          -   End Of Field                    |                                            |
  9763.                          UpArrow      -   Previous Field                    |                                            |
  9764.                          DnArrow      -   Next Field                    |                                            |
  9765.                          PgDn         -   Edit Description                    |                                            |
  9766.                     +--------------------------------------------+
  9767.  
  9768.           The purpose of the various fields are as follows:
  9769.  
  9770.           Name -  This is  the name  of the  file.  The  name  must  follow
  9771.           standard DOS conventions and are limited to 13 characters.
  9772.  
  9773.           Where -  This is  the location  of the  file (The  disk directory
  9774.           where the  file can be found). It must represent a valid DOS disk
  9775.  
  9776.  
  9777.  
  9778.  
  9779.  
  9780.                                       Page 168
  9781.  
  9782.  
  9783.  
  9784.           GAP Communications                                FileBase Editor
  9785.  
  9786.  
  9787.  
  9788.  
  9789.           directory.  If   the  file  cannot  be  found  in  the  directory
  9790.           specified, you will be asked if you wish to locate the file.
  9791.  
  9792.           Length -  This is  the size of the file in bytes. This field will
  9793.           be filled  in for  you automatically  so that  it represents  the
  9794.           actual size of the file.
  9795.  
  9796.           Date -  This is the last modification date of the file. Note that
  9797.           this field  is not  automatically updated  for you  because  many
  9798.           sysops need  the freedom  to manipulate the file date for various
  9799.           reasons.
  9800.  
  9801.           Last Access - This is the date the file was last downloaded.
  9802.  
  9803.           Ttl Accesses - The number of times the file was downloaded.
  9804.  
  9805.           Area -  This is  the Area  the file belongs in. The main board is
  9806.           Area 0. Note that you may not select an Area (Forum) if that area
  9807.           has no file directories as specified in configuration.
  9808.  
  9809.           Subject - This is the subject number of the file. It is here that
  9810.           you will see one use of the DIRS file you had to create. When the
  9811.           cursor moves  into this field, a selection list will pop up. This
  9812.           window will  list all  of the  subjects you  have available.  The
  9813.           cursor will  highlight the  current subject.  To select a subject
  9814.           you may  either type  in the  subject number, or use the Home and
  9815.           End keys  to move  from subject to subject in the list. To accept
  9816.           the subject  that is highlighted, press Enter. Note that you will
  9817.           not be  allowed to  enter a  subject that is not in the list. For
  9818.           instance, if  you have  10 subjects, your choices will be limited
  9819.           to subject numbers 1 - 10.
  9820.  
  9821.           Security - This is the security level needed in order to download
  9822.           this file.  The file  will never  be shown  to a  user if his/her
  9823.           security level  is not  at least  as high  as the  file  security
  9824.           level. Private  uploads to  sysop are  given a  security level of
  9825.           110. This  field defaults  to the  level given in the File System
  9826.           Options screen of GAPSETUP.
  9827.  
  9828.           Uploaded By  - This  is the  name of  the person who uploaded the
  9829.           file. This field is set to Sysop by default.
  9830.  
  9831.           Password -  If you  wish to  password protect  a file,  enter the
  9832.           password in  this field.  Even if  a user  has the security level
  9833.           necessary  to   download  the  file,  if  the  file  is  password
  9834.  
  9835.  
  9836.  
  9837.  
  9838.                                       Page 169
  9839.  
  9840.  
  9841.  
  9842.           GAP Communications                                FileBase Editor
  9843.  
  9844.  
  9845.  
  9846.  
  9847.           protected, the  user will  need to  give the  correct password in
  9848.           order to download the file.
  9849.  
  9850.           Free File - Set this field to Y if you wish to allow the users to
  9851.           download a  file and not have the download time or bytes credited
  9852.           against them.
  9853.  
  9854.           Normal Log - Most files are considered Normal for  the purpose of
  9855.           logging them  to the  caller log  when a  caller  downloads.  The
  9856.           Caller Analyzer  will store  the file  in its  own  database  for
  9857.           statistic purposes.  Once such  use is  in the  creation  of  the
  9858.           Download Bulletin  of the  most popular  files. Only  those files
  9859.           that have  actually been downloaded will appear in this bulletin.
  9860.           You may  have some files in your FileBase that you do not want to
  9861.           appear in this download bulletin. If so, set the Normal Log field
  9862.           for these  files to  No. The  file name  will still appear in the
  9863.           caller log,  however, the Caller Analyzer will not store the file                                                         
  9864.           in its internal database.
  9865.  
  9866.           Key Words  - The  words entered  into this field should be single
  9867.           entries  separated  by  a  single  space.  The  words  should  be
  9868.           descriptive of  the file's  function. (i.e.,  COMMUNICATIONS  GAP
  9869.           RBBS BBS  MODEM DOORS).  These words  will be  entered  into  the
  9870.           keyword index  file and  will be  used as  the basis  of the file
  9871.           search routines  in GAP.  Although you  may enter  any words  you
  9872.           please, common  words such  as THE, AN, OF, etc. will be filtered
  9873.           out and not placed in the keyword file.
  9874.  
  9875.  
  9876.  
  9877.  
  9878.  
  9879.  
  9880.  
  9881.  
  9882.  
  9883.  
  9884.  
  9885.  
  9886.  
  9887.  
  9888.  
  9889.  
  9890.  
  9891.  
  9892.  
  9893.  
  9894.  
  9895.  
  9896.                                       Page 170
  9897.  
  9898.  
  9899.  
  9900.           GAP Communications                                FileBase Editor
  9901.  
  9902.  
  9903.  
  9904.  
  9905.           When the cursor leaves the Keywords field, you will be in what is
  9906.           called the  File Description  Editor. You  may  also  enter  this                      
  9907.           Editor by  pressing PgDn  while the cursor is in any of the above
  9908.           fields. The following keys are available while in this Editor:
  9909.  
  9910.                     +--------------------------------------------+
  9911.                          F1           -   Help                    |                                            |
  9912.                          F9           -   Quit Edit - Save                    |                                            |
  9913.                          Esc          -   Quit Edit - Don't Save                    |                                            |
  9914.                          UpArrow      -   Up One Line                    |                                            |
  9915.                          DnArrow      -   Down One Line                    |                                            |
  9916.                          LfArrow      -   Left One Space                    |                                            |
  9917.                          RtArrow      -   Right One Space                    |                                            |
  9918.                          PgUp         -   Previous Page                    |                                            |
  9919.                          PgDn         -   Next Page                    |                                            |
  9920.                          Home         -   Beginning Of Line                    |                                            |
  9921.                          End          -   End Of Line                    |                                            |
  9922.                          ^Home        -   Top Of Screen                    |                                            |
  9923.                          ^End         -   End Of Screen                    |                                            |
  9924.                          ^Y           -   Delete Line                    |                                            |
  9925.                          ^K           -   Delete To End Of Line                    |                                            |
  9926.                     +--------------------------------------------+
  9927.  
  9928.           The File  Description Editor  is a  very basic, free form editor.
  9929.           You may  enter up  to 10  lines of descriptive text which will be
  9930.           shown to  users when they do an Enhanced file listing (E from the
  9931.           Files Menu in GAPBBS).
  9932.  
  9933.  
  9934.  
  9935.  
  9936.  
  9937.  
  9938.  
  9939.  
  9940.  
  9941.  
  9942.  
  9943.  
  9944.  
  9945.  
  9946.  
  9947.  
  9948.  
  9949.  
  9950.  
  9951.  
  9952.  
  9953.  
  9954.                                       Page 171
  9955.  
  9956.  
  9957.  
  9958.           GAP Communications                                FileBase Editor
  9959.  
  9960.  
  9961.  
  9962.  
  9963.           Utilities
  9964.  
  9965.           The following options are available on the Utilities Menu:                                                     
  9966.  
  9967.                                 Utilities
  9968.                                 +--------------------+
  9969.                                   Update                                |                    |
  9970.                                   Master List                                |                    |
  9971.                                   Stray Files                                |                    |
  9972.                                   Import                                |                    |
  9973.                                   Move Files                                |                    |
  9974.                                 |--------------------|
  9975.                                   Global Change                                |                    |
  9976.                                   Fix Keywords                                |                    |
  9977.                                   Remove Dupes                                |                    |
  9978.                                   Mass Delete                                |                    |
  9979.                                 +--------------------+
  9980.  
  9981.           Update is a means whereby GAPFILE will check the database against
  9982.           the files  on the disk to see if the location, size, and date are
  9983.           correct. You have the option of checking only the current subject
  9984.           or all  subjects. You  may specify  whether or  not the file date
  9985.           should be updated and whether or not to delete the ISAM record or
  9986.           mark it as OFFLINE if the file cannot be found on the disk.
  9987.  
  9988.           This utility  is also useful for those times when you add a batch
  9989.           of updated  files to  a directory.  Instead of manually adjusting
  9990.           the file  sizes and  dates, this function will do that for you in
  9991.           one operation.
  9992.  
  9993.           It should be noted that this function can take several minutes to
  9994.           several hours  to complete (you may press Esc at any time to stop
  9995.           the updating  process). The  slowness  is  not  inherent  in  the
  9996.           function itself,  but in  the DOS  process which  is used. If you
  9997.           have a  CD-ROM drive, the updating function can take well over 18
  9998.           hours to complete.
  9999.  
  10000.           If the  Update function cannot find a file in the directory where
  10001.           it is  supposed to  be located,  it will  search the drives in an
  10002.           attempt to  find the  file. If  it finds the file, it will modify
  10003.           the Where  field with  the correct  directory information.  If it
  10004.           cannot find  the file,  it will  either delete the FileBase entry
  10005.           for the  file or  mark the  file as  OFFLINE (depending  upon the
  10006.           options you  choose prior to running Update). The drives that are
  10007.           searched depend  upon what  you have  setup on  line one  in  the
  10008.  
  10009.  
  10010.  
  10011.  
  10012.                                       Page 172
  10013.  
  10014.  
  10015.  
  10016.           GAP Communications                                FileBase Editor
  10017.  
  10018.  
  10019.  
  10020.  
  10021.           configuration file,  GAPFILE.CNF. If  this line  is  blank,  then
  10022.           GAPFILE will  search all  drives in  the  system,  excluding  the
  10023.           floppy drives.
  10024.  
  10025.           Master List will generate a Master File Listing for you. You have
  10026.           the options  of  specifying  a  Condensed  or  Enhanced  listing,
  10027.           whether or  not to  list the  files in  the Current  area or  All
  10028.           areas, whether  to include  Transfer Times at various baud rates,
  10029.           and the file name for the listing.
  10030.  
  10031.           Stray Files  allows you  to update  your database  with any loose
  10032.           files. Loose  files are  considered to  be any files which are on
  10033.           the hard  drive but  which are not included in your database. You
  10034.           may specify  the directory  to check,  the destination  area  and
  10035.           subject for any loose files found, and whether or not you wish to
  10036.           update the  Keywords and  File Description as each file is found.
  10037.           If you elect not to be prompted for a description, the files will
  10038.           be saved  in the  database with a Keyword and File Description of
  10039.           "UNCLASSIFIED".
  10040.  
  10041.           For each  file found,  GAPFILE will  shell to  a batch  file (the
  10042.           default is  UPCHECK.BAT but you can change this to any batch file
  10043.           name you  wish). The  purpose of  the shell  is  to  extract  any
  10044.           description files  (FILE_ID.DIZ or  DESC.SDI) from the archive so
  10045.           that the  description file  can be  used as the keywords and file
  10046.           description. You  can use your UPCHECK.BAT file for this purpose,
  10047.           or you  can give the batch file a different name and include only
  10048.           the commands  you want  to have  executed while  importing  stray
  10049.           files. The  parameters that  are passed  to the  batch  file  are
  10050.           identical to  those passed  by  GAP  to  UPCHECK.BAT.  The  sixth
  10051.           parameter will be a '1'.
  10052.  
  10053.           Import allows you to import files that are listed in an RBBS type
  10054.           of directory  listing. The  format of this listing is the same as
  10055.           that produced  by the  Master File  Listing using  condensed mode
  10056.           (i.e., 1  entry per  line). Using  Import, you tell GAPFILE where
  10057.           the files  are located,  the name  of the text file that provides
  10058.           the descriptions  for each of the files, and the Area and Subject
  10059.           numbers to  classify the files in. Import will then read the text
  10060.           file and add the description, date, and file size that it obtains
  10061.           from the List File to the FileBase
  10062.  
  10063.           Import is  normally used when adding files from a CD-ROM. Most of
  10064.           the newer  CD-Discs for  BBS use  have List Files which contain a
  10065.           one line entry for each file on the disc.
  10066.  
  10067.  
  10068.  
  10069.  
  10070.                                       Page 173
  10071.  
  10072.  
  10073.  
  10074.           GAP Communications                                FileBase Editor
  10075.  
  10076.  
  10077.  
  10078.  
  10079.  
  10080.           GAPFILE  will   also  import   files  that   contain   multi-line
  10081.           descriptions. The  format of  the import  file is pretty much the
  10082.           same except  that a  description of a file may be up to 10 lines.
  10083.           The format would be something similar to the following:
  10084.  
  10085.           +----------------------------------------------------------------+
  10086.             FILENAME.ZIP  123456  07/01/92   This is line 1 of the descrip          |                                                                |
  10087.                                              This is line 2 of the descrip          |                                                                |
  10088.                                              This is line 3 of the descrip          |                                                                |
  10089.           +----------------------------------------------------------------+
  10090.  
  10091.           The first description entry will be saved in the keyword field as
  10092.           well as the first line of the Enhanced Description. The next nine
  10093.           lines will  be saved  as lines  two through  ten of  the Enhanced
  10094.           Description. The only requirement to importing more than one line
  10095.           of description  is  that  the  second  and  subsequent  lines  be
  10096.           preceded with at least one space.
  10097.  
  10098.           Move Files  is a global version of the regular Move File function
  10099.           (F6). It  will display  a list of files for the subject specified
  10100.           and will  allow you  to type  in a  new subject  for each  of the
  10101.           files. You  may also  specify a new area. If you wish to delete a
  10102.           file, type  0 for  its subject  number. If  you wish to leave the
  10103.           file where  it is,  leave its  subject and  area numbers the same
  10104.           (i.e., don't change them).
  10105.  
  10106.           Move Files  is useful  for moving  newly uploaded  files to their
  10107.           appropriate subject category.
  10108.  
  10109.           You may move up and down the two columns by using the Up and Down
  10110.           Arrow keys, or back and forth between the two fields by using the
  10111.           Enter key.
  10112.  
  10113.  
  10114.  
  10115.  
  10116.  
  10117.  
  10118.  
  10119.  
  10120.  
  10121.  
  10122.  
  10123.  
  10124.  
  10125.  
  10126.  
  10127.  
  10128.                                       Page 174
  10129.  
  10130.  
  10131.  
  10132.           GAP Communications                                FileBase Editor
  10133.  
  10134.  
  10135.  
  10136.  
  10137.           Global Change allows you to globally change many of the fields in
  10138.           the FileBase.  The changes  you make can be performed either on a
  10139.           specific Area,  a specific Subject, All Areas, All Subjects, or a
  10140.           combination of both.
  10141.  
  10142.           +----------------------------------------------------------------+
  10143.                                  Global Field Change          |                                                                |
  10144.           |----------------------------------------------------------------|
  10145.           |                                                                |
  10146.              Change                     Old Value      New Value          |                                                                |
  10147.           |----------------------------------------------------------------|
  10148.           |                                                                |
  10149.                N      File Exten    :   .              .          |                                                                |
  10150.                N      Where         :          |                                                                |
  10151.                N      Ttl Accesses  :        0              0          |                                                                |
  10152.                N      Area          :     0              0          |                                                                |
  10153.                N      Subject       :     0              0          |                                                                |
  10154.                N      Security      :     0              0          |                                                                |
  10155.                N      Uploaded By   :          |                                                                |
  10156.                N      Password      :          |                                                                |
  10157.                N      Free File     :   Y              Y          |                                                                |
  10158.                N      Normal Log    :   Y              Y          |                                                                |
  10159.           |                                                                |
  10160.                Area To Change       :   Area # or ALL for All Areas          |                                                                |
  10161.                Subject To Change    :   Subject # of ALL for ALL Subjects          |                                                                |
  10162.           +----------------------------------------------------------------+
  10163.  
  10164.           Enter a  Y or  N in  the Change  field to  change the data in the
  10165.           FileBase that corresponds to the particular topic.
  10166.  
  10167.           If you answer Yes in the Change field, press Enter to move to the
  10168.           next two fields to fill in the appropriate information.
  10169.  
  10170.           The Old Value is the data in the FileBase that you wish to change
  10171.           to the New Value.
  10172.  
  10173.           The Where  field contains some hidden uses that may be of benefit
  10174.           to you.  If you  have not  yet  moved  the  files  from  the  Old
  10175.           directory to  the New  directory, then GAPFILE will move them for
  10176.           you when the Global Change executes.
  10177.  
  10178.           For  instance,   if  you  have  a  private  upload  directory  in
  10179.           D:\PRIVATE and  an upload  directory in  D:\UP, where  you screen
  10180.           your uploads  prior to posting, you can use these Where fields to
  10181.           move your private uploads to the public upload directory.
  10182.  
  10183.  
  10184.  
  10185.  
  10186.                                       Page 175
  10187.  
  10188.  
  10189.  
  10190.           GAP Communications                                FileBase Editor
  10191.  
  10192.  
  10193.  
  10194.  
  10195.  
  10196.           If your  private uploads  are in  Area 0,  Subject 11,  and  your
  10197.           public uploads  are in  Area 0,  Subject 10,  you can  change the
  10198.           Where field from D:\PRIVATE to D:\UP and change the Subject field
  10199.           from 11 to 10.
  10200.  
  10201.           GAPFILE will  change the  subject field  for  each  file  in  the
  10202.           private upload directory and will change the where field as well.
  10203.           In  addition,   GAPFILE  will  physically  move  the  files  from
  10204.           D:\PRIVATE to D:\UP.
  10205.  
  10206.           If you  use a  scheme such  as suggested  above, be sure that you
  10207.           also enter  0 in  the Area To Change field, and 11 in the Subject
  10208.           To Change  field. Otherwise,  in addition  to changing  the Where
  10209.           field, GAPFILE will also change any file that has a Subject field
  10210.           of 11 to a new subject of 10, and this could include some of your
  10211.           Forums.
  10212.  
  10213.           Be specific when changing fields.
  10214.  
  10215.           If you  enter an  * as the only character in the Old Value field,
  10216.           and enter  just a  drive designation  in  the  New  Value  field,
  10217.           GAPFILE will  modify just  the  drive  designation,  leaving  the
  10218.           directory the same.
  10219.  
  10220.           For instance, if you enter * in the Old Value field and F: in the
  10221.           New Value  field, and  the Where  field for  a  file  is  D:\DL1,
  10222.           GAPFILE will change the Where field to F:\DL1.
  10223.  
  10224.           When using this feature, the file will not be physically moved.
  10225.  
  10226.           Fix Keywords  allows you  to rebuild  your Keyword Data and Index
  10227.           files. Normally  you would  fix your  Keyword files  only if they
  10228.           become damaged.  Depending upon  how many  files you  have in the
  10229.           FileBase, this  utility can  take  up  to  4  hours  or  more  to
  10230.           complete.
  10231.  
  10232.           Remove Dupes  allows you  to remove  duplicate records  from  the
  10233.           FileBase. If  you receive  a message  while rebuilding  your data
  10234.           files that  says "Duplicate  Key rejected  for record  at  offset
  10235.           xxxx", where  'xxxx' is a numeric value, then there are duplicate
  10236.           records in  your FileBase  that need  to be  removed. In order to
  10237.           delete the  duplicate record  you must  supply the numeric offset
  10238.           that GAPREBLD  displayed in  its warning message. You must supply
  10239.           the exact  number or  you  may  inadvertently  delete  the  wrong
  10240.  
  10241.  
  10242.  
  10243.  
  10244.                                       Page 176
  10245.  
  10246.  
  10247.  
  10248.           GAP Communications                                FileBase Editor
  10249.  
  10250.  
  10251.  
  10252.  
  10253.           record. If  you received  a duplicate record warning for the same
  10254.           offset value, you need only remove the duplicate record once.
  10255.  
  10256.           Mass Delete  allows you  to remove all of the files in a specific
  10257.           subject. It  can be used if you need to quickly remove a group of
  10258.           files.
  10259.  
  10260.  
  10261.           Selection List
  10262.  
  10263.           The Selection List for the Subject field works as follows:
  10264.  
  10265.           At start-up, GAPFILE reads your DIRS file in the GEN directory to
  10266.           build the  list that you select from. The windowing routines take
  10267.           the  information  in  this  list  and  build  what  is  called  a
  10268.           "selection set".  When the  cursor enters  the Subject Field, the                                                         
  10269.           selection set  "pops" up.  To make  a selection, use the Home and
  10270.           End keys  to move  through the  list. You may also simply type in
  10271.           the subject number directly.
  10272.  
  10273.           When an Area specifies a Forum, the building of the selection set
  10274.           for the  Forum is similar to the above, but the list is not built
  10275.           until the  cursor moves from the Area field to the Subject field.                                           
  10276.           This allows  us to  use two selection lists where the second list
  10277.           is  shared  between  each  of  the  Forums  (if  they  have  file
  10278.           directories). The  first time  you move from Area to Subject, you
  10279.           may notice a slight delay as GAPFILE reads your DIRS file for the
  10280.           specified Area (if an Area other than 0 is specified).
  10281.  
  10282.           Note that  GAPFILE will refuse to run if it encounters a bad DIRS
  10283.           file. For  the main  board, this  refusal will occur at start up.
  10284.           For a  Forum, you  will be  notified that  the Forum DIRS file is
  10285.           invalid when the cursor moves from the Area to the Subject field.
  10286.           If this  occurs, you  will need  to create a proper DIRS file for
  10287.           whatever Area is indicated.
  10288.  
  10289.           Remember that  GAP will  assume everything is set up correctly. A
  10290.           proper DIRS  file is one that has an entry for each directory you
  10291.           have set up. A one for one correlation (no more and no less).
  10292.  
  10293.  
  10294.           Saving
  10295.  
  10296.           While in the top or bottom half of the editor, pressing Esc means
  10297.           you wish  to abort the process and not save. In order to save any
  10298.  
  10299.  
  10300.  
  10301.  
  10302.                                       Page 177
  10303.  
  10304.  
  10305.  
  10306.           GAP Communications                                FileBase Editor
  10307.  
  10308.  
  10309.  
  10310.  
  10311.           changes made,  you must press F9. You may press F9 at any time to
  10312.           quit the  editing process  and save  your work. If you press Esc,
  10313.           and have  made changes,  GAPFILE will ask you to confirm that you
  10314.           indeed wish to abort the changes.
  10315.  
  10316.  
  10317.           CD-ROM Usage
  10318.  
  10319.           CD-Discs present  a special  problem to  BBS programs. Because of
  10320.           the massive  amount of  information they hold and their slow disk
  10321.           access times  (CD-ROMS are  typically much  slower than  a floppy
  10322.           drive), it is imperative that the system know where all the files
  10323.           are on the disc.
  10324.  
  10325.           GAPFILE plays  an important role in managing a CD-Disc in that it
  10326.           allows you  to create a database of the thousands of files on the
  10327.           disc. This database, by its very nature, holds the directory path
  10328.           to the  files. When  a caller attempts to download a file that is
  10329.           on a  CD-Disc, GAP  need only look the file up in the FileBase to
  10330.           determine which  directory the  file is  in. This "look-up" takes
  10331.           less than  1/2 second. Compare this to the minutes it can take to                                                     
  10332.           physically search the CD-Disc for the file.
  10333.  
  10334.           These benefits  do not come without a price. Depending upon which
  10335.           CD-Disc you  purchase, the  amount of  time that  you must  spend
  10336.           setting up the FileBase can range from 2 hours to over 24 hours!
  10337.  
  10338.           Here are some things to consider when purchasing a CD-Disc:
  10339.  
  10340.               +  Is it  well organized?  Are  its  files  in  separate
  10341.                  directories grouped according to subject matter?
  10342.               +  How many  duplicate files does it have? If over 1% of
  10343.                  the files  are  duplicates,  then  you  may  want  to
  10344.                  consider a different disc.
  10345.               +  How many  files and/or  bytes does  it contain? A CD-
  10346.                  Disc can hold well over 600 megs of files.
  10347.               +  How many  directories does it contain? If it contains
  10348.                  over 40  directories you will need to devise a way to
  10349.                  display  those  directory  names  to  your  users.  A
  10350.                  Directory Menu with 50 to 100 categories is difficult
  10351.                  to read and comprehend.
  10352.               +  Does it  have its  own FileBase  which you can simply
  10353.                  copy to your MAIN directory and use "as is"? There is
  10354.                  at  least   one  CD-Disc  which  comes  with  a  pre-
  10355.                  configured FileBase.
  10356.  
  10357.  
  10358.  
  10359.  
  10360.                                       Page 178
  10361.  
  10362.  
  10363.  
  10364.           GAP Communications                                FileBase Editor
  10365.  
  10366.  
  10367.  
  10368.  
  10369.               +  Does it have separate text files which you can Import
  10370.                  into your  existing Filebase? This is the most common
  10371.                  method  of   interfacing  a  new  CD-Disc  with  your
  10372.                  Filebase. If  the disc  does not have these directory
  10373.                  listings do  not even consider purchasing it. Even if
  10374.                  it does  have the  listings, be  sure they are of the
  10375.                  proper format.
  10376.  
  10377.           If you  purchase a CD-Disc that contains a GAPFILE FileBase which
  10378.           you can  simply copy over to your MAIN directory, you are already
  10379.           90% complete  in your set-up. The files that make up the FileBase
  10380.           are:  FILES.DAT,  FILES.IDX,  FILEKEY.DAT,  and  FILEKEY.IDX.  In
  10381.           addition, you will need the FILES.DIR and DIRS files.
  10382.  
  10383.           If you  already have  a pre-existing FileBase and you wish to use
  10384.           the one contained on the CD-Disc, you have two choices. Hope that
  10385.           all the files on your hard drive are contained on the CD-Disc and
  10386.           simply copy the new FileBase files on top of your existing files,
  10387.           or make  a Condensed  Master File Listing of your existing files,
  10388.           edit the  list and  remove any headers and footers, and break the
  10389.           list up  into separate  files where each file contains only those
  10390.           listings appropriate  for the  file. After  creating your  Master
  10391.           List, you  may then  copy the  FileBase files from the CD-Disc to
  10392.           your MAIN directory, thereby replacing your FileBase with the one
  10393.           on the CD-Disc.
  10394.  
  10395.           Lets assume that you've made a Master List of your existing files
  10396.           and have  just copied the FileBase files from the CD-Disc to your
  10397.           MAIN directory.
  10398.  
  10399.           The next  step is to inspect the DIRS and FILES.DIR files (if the
  10400.           CD-Disc included  these files)  and make  sure they  are correct.
  10401.           First determine  how many subject categories the disc has. If the
  10402.           disc is  properly organized,  it will have one physical directory
  10403.           for each  subject category.  Some discs  have  2  or  3  physical
  10404.           directories for  each category of files but this does not present
  10405.           that much  of a  problem. Normally,  the disc  will include a DIR
  10406.           type of menu file that visually shows the categories.
  10407.  
  10408.           Lets  assume   that  the   disc  is  configured  for  34  subject
  10409.           categories.  Create or edit your DIR and DIRG files to show these
  10410.           subjects. You  can then  use the  DIR file  as  a  reference  for
  10411.           creating the  DIRS file  that GAPFILE  needs. After creating your
  10412.           Menu Files  (DIR and  DIRG), create or edit the DIRS file so that
  10413.           it properly  shows  the  various  categories.  For  instance,  if
  10414.  
  10415.  
  10416.  
  10417.  
  10418.                                       Page 179
  10419.  
  10420.  
  10421.  
  10422.           GAP Communications                                FileBase Editor
  10423.  
  10424.  
  10425.  
  10426.  
  10427.           subject 1 is Communications and subject 2 is Games, the first two
  10428.           lines of your DIRS file would look like this:
  10429.  
  10430.                               +------------------------+
  10431.                                 1 Communications                              |                        |
  10432.                                 2 Games                              |                        |
  10433.                               +------------------------+
  10434.  
  10435.           You would  then add  the other  32 categories as well as the 35th
  10436.           which would be your Upload directory.
  10437.  
  10438.           You will  then need to create or edit your FILES.DIR file. If the
  10439.           files in  subject 1,  Communications, are  in directory F:\001 on
  10440.           the CD-Disc, line 1 of your FILES.DIR would be:
  10441.  
  10442.                               +------------------------+
  10443.                                 F:\001                              |                        |
  10444.                               +------------------------+
  10445.  
  10446.           Line 35 of this file would be the path to your Upload directory.
  10447.  
  10448.           If the  CD-Disc uses  multiple directories  for a  single subject
  10449.           category, simply enter the first directory path that applies. For
  10450.           instance, if the Communications files are in F:\001, F:\001A, and
  10451.           F:\001B, enter F:\001 on the appropriate line of FILES.DIR.
  10452.  
  10453.           Next you  need to  go into  GAPSETUP  and  enter  the  number  of
  10454.           directories you now have. In this case, that number would be 35.
  10455.  
  10456.           You are now ready to fire up GAPFILE and see what you've got! The
  10457.           first thing  you will  probably need  to do  is change  the Drive
  10458.           Designator and possibly the Security Level on each of the CD-Disc
  10459.           files. Lets assume the CD-Disc came configured as drive D and the
  10460.           files all  have a  security level  of 50, and that your CD-ROM is
  10461.           actually drive F and you have a download security level of 40.
  10462.  
  10463.           From the Utilities Menu select Global Change. Use the DnArrow key                   
  10464.           and move  the cursor  in front  of the Where field. Enter a Y and                                                 
  10465.           press Enter.  For the  Old Value,  enter an  *. For the New Value                                 
  10466.           field, enter  F:. Do not enter a slash, just the drive and colon.
  10467.           Now move the cursor in front of the Security field and enter a Y.                                              
  10468.           Enter 50  in the Old Value field and a 40 in the New Value field.                                                           
  10469.           Move the  cursor all the way down to Area To Change and type ALL.
  10470.           Also type ALL in the Subject To Change field.                               
  10471.  
  10472.  
  10473.  
  10474.  
  10475.  
  10476.                                       Page 180
  10477.  
  10478.  
  10479.  
  10480.           GAP Communications                                FileBase Editor
  10481.  
  10482.  
  10483.  
  10484.  
  10485.           GAPFILE will  now ask  you to  confirm that  you wish  to run the
  10486.           Global Change.  If you  answer Yes,  it will then proceed to make
  10487.           the changes  you specified.  The  process  should  take  about  5
  10488.           minutes.
  10489.  
  10490.           If you  had pre-existing  files that  you "saved"  by creating  a
  10491.           Master File listing, you may now import those files back into the
  10492.           FileBase. First,  determine how many additional subjects you need
  10493.           to add  to configuration,  DIRS and FILES.DIR. Tell GAPSETUP your
  10494.           new number  of subjects  and enter  the new  subjects  and  their
  10495.           directory paths  into DIRS and FILES.DIR respectfully. Be sure to
  10496.           make your Upload directory the highest numbered subject.
  10497.  
  10498.           Lets say  you previously  had 10  subjects including  the  Upload
  10499.           directory. The  CD-Disc gave  you 34 new subjects so that makes a
  10500.           total of  44  subject  categories.  The  44th    is  your  Upload
  10501.           directory. You  will need to edit the Master Listing you produced
  10502.           (hopefully you  created a  simple condensed  listing with no file
  10503.           times or  other frivolous  information), and remove the header at
  10504.           the top of the file and the statistics at the bottom.
  10505.           Each category  of files  will have  a heading describing what the
  10506.           files in  that category  are all  about. You need to take all the
  10507.           files in  that category and save that group to a file of its own.
  10508.           Call the  file LIST1.TXT  or perhaps LIST35.TXT since, if you are
  10509.           following the  example so  far, category 35 is the next available
  10510.           subject that has no files in it yet.
  10511.  
  10512.           Use an  editor that  allows you  to mark a block of text and save
  10513.           that block  to a file. Do not save the category description, just
  10514.           the  actual  listings  themselves.  Do  this  with  each  of  the
  10515.           categories in your Master Listing. Using our ongoing example, you
  10516.           should end up with 10 separate text files.
  10517.  
  10518.           Go into  GAPFILE and from the Utilities Menu, select Import. Type                                        
  10519.           in the  directory where  the files  from your  first listing  are
  10520.           physically located. Next type the name of the text file which you
  10521.           will be  importing. In  this  case,  the  first  file  is  called
  10522.           LIST35.TXT. Type  in the  destination area  that these files came
  10523.           from. And  finally, type  in the  destination subject  that these
  10524.           files are  to be  placed into.  In this  case, the Subject Number
  10525.           will be  35. Select  Start and  your old files will magically re-
  10526.           appear into  your FileBase. Repeat this procedure for each of the
  10527.           list files you created from your Master Listing.
  10528.  
  10529.  
  10530.  
  10531.  
  10532.  
  10533.  
  10534.                                       Page 181
  10535.  
  10536.  
  10537.  
  10538.           GAP Communications                                FileBase Editor
  10539.  
  10540.  
  10541.  
  10542.  
  10543.           Keep in  mind that  there is  a good  chance the CD-Disc contains
  10544.           many of  the same files that you previously had. While importing,
  10545.           if the  file currently  being imported  already exists,  the file
  10546.           will be  skipped. If  there were  any such  duplicate files, they
  10547.           will be  listed in  a file  called IMPORT.LOG. Its a good idea to
  10548.           examine this  file since  you should be able to safely delete the
  10549.           files contained  in it from your hard drive. If you would like to
  10550.           assure yourself  that the file actually does exist on the CD-ROM,
  10551.           you may  use F8  in GAPFILE  and locate  the file. Check the file
  10552.           sizes and dates since you could very well have a newer version of
  10553.           the file than the one on the CD-Disc. If such is the case, simple
  10554.           change the  Where field  for the  file to reflect your hard drive                      
  10555.           directory instead  of the directory on the CD-Disc. Press Enter a
  10556.           couple of times to automatically change the date and file size.
  10557.  
  10558.           Believe it or not, it takes longer to write about how to set up a
  10559.           CD-disc that  contains a  pre-configured FileBase than it does to
  10560.           actually do it!
  10561.  
  10562.           If your  CD-Disc does  not contain a pre-built FileBase your only
  10563.           choice is  to use the Import Utility and import the text listings
  10564.           that came  with the  disc. If the Disc did not come with any such
  10565.           listings, or  if the  listings are  of the wrong format, you will
  10566.           save yourself  many hours  of frustration by simply returning the
  10567.           disc for  a refund  and purchasing  one that  contains  correctly
  10568.           formatted listings.
  10569.  
  10570.           A correctly formatted listing appears as follows:
  10571.  
  10572.           +----------------------------------------------------------------+
  10573.             16550A.ZIP      5044  10/14/88   16550 UART FIFO BUFFER          |                                                                |
  10574.             BOYAN40A.ZIP  160561  02/05/89   Boyan Comm Program - Part 1          |                                                                |
  10575.             BOYAN40B.ZIP  131354  02/05/89   Boyan Comm Program - Part 2          |                                                                |
  10576.             GAP.SLT         2885  01/11/88   Telix script for a GAP BBS          |                                                                |
  10577.             GAPASP.ZIP       686  08/17/88   Procomm script for a GAP BBS          |                                                                |
  10578.           +----------------------------------------------------------------+
  10579.  
  10580.           There should  be one  such List File for each subject category of
  10581.           files. For  instance, if  the  CD-Disc  is  categorized  into  30
  10582.           different subjects,  there should be 30 of these List Files. Most
  10583.           of the  popular CD-Discs  designed for  BBS usage  provide  these
  10584.           files. Be  aware that there are some CD-Discs in sheep's clothing
  10585.           that will  cause you  to have  nightmares when trying to set them
  10586.           up. They  advertise and  actually do  come with these List Files,
  10587.           however the  listings may contain such oddities as showing a file
  10588.  
  10589.  
  10590.  
  10591.  
  10592.                                       Page 182
  10593.  
  10594.  
  10595.  
  10596.           GAP Communications                                FileBase Editor
  10597.  
  10598.  
  10599.  
  10600.  
  10601.           size of  1048 bytes as 1K or a date of 06/28/92 as 06/92, or have
  10602.           no file  description whatsoever.  All 4  fields as  shown in  the
  10603.           above listing  need to  be present and they all need to be of the
  10604.           proper format. The date field, however, can use either a slash or
  10605.           a dash as the delimiter.
  10606.  
  10607.           There is  nothing unusual  about the file listing. It is the same
  10608.           format that is currently used by many popular BBS programs. It is
  10609.           the same  format that  GAP uses  when it  displays files  on  the
  10610.           screen or  creates a  Master Listing, in Condensed mode. If a CD-
  10611.           Disc targeted  for BBS  Sysops does not provide such listings you
  10612.           should not purchase the disc.
  10613.  
  10614.           In order  to get these thousands of  files into your FileBase you
  10615.           will use  the Import  and Update functions in GAPFILE. The Import
  10616.           process itself  will take  about 4 hours. The Update process will
  10617.           take about  18 hours.  You need  to take  an active  part in  the
  10618.           Import process,  but the  Update process can be run while you are
  10619.           tucked in bed for the night.
  10620.  
  10621.           Before starting,  be sure  to have  your DIRS, FILES.DIR, DIR and
  10622.           DIRG files  already built. The guidelines that were presented for
  10623.           these files  for installing  a CD-Disc that provides a ready made
  10624.           FileBase apply here as well. If you print out the DIR or the DIRS
  10625.           file and  keep it next to you, it will serve as a handy reference
  10626.           when importing the files.
  10627.  
  10628.           Be sure  that you  have  already  told  GAPSETUP  how  many  File
  10629.           Directories you  will ultimately  have. You do this by going into
  10630.           the Configuration  Editor, select the Go To Menu, and select File
  10631.           System Options.
  10632.  
  10633.           From the Utilities Menu in GAPFILE, select Import. For the Source
  10634.           Directory, type  the drive  and directory  where the  files  that
  10635.           belong to  your first  List File  belong. If  you  are  Importing
  10636.           listing #1,  then the  files for this list should be in the first
  10637.           subdirectory on  the CD-Disc.  It might  be helpful  to  issue  a
  10638.           Directory listing  of your CD-Rom drive and redirect this listing
  10639.           to your  printer. You  will then  have  a  physical  map  of  the
  10640.           subdirectories on your CD-Disc.
  10641.  
  10642.           For the  Source File, type the name of the List File that you are
  10643.           currently importing.
  10644.  
  10645.  
  10646.  
  10647.  
  10648.  
  10649.  
  10650.                                       Page 183
  10651.  
  10652.  
  10653.  
  10654.           GAP Communications                                FileBase Editor
  10655.  
  10656.  
  10657.  
  10658.  
  10659.           For the  Destination Area,  type the  Area number  where you want
  10660.           these files  to be  classified in.  Area 0 is the Main Board, any
  10661.           other number represents a Forum.
  10662.  
  10663.           For the  Destination Subject,  type the Subject number that these
  10664.           files will be classified under. The subject number corresponds to
  10665.           the numbers  you gave  each category  in your  DIRS file  and the
  10666.           number a  caller must  type (as shown to your callers in your DIR
  10667.           and DIRG files) to view the files in this particular subject.
  10668.  
  10669.           Select Start  to begin  the Import process. For each file that is
  10670.           imported, the  file will be given the Keywords, Description, File
  10671.           Size, and Date that are contained in the List File.
  10672.  
  10673.           You will need to repeat the above process for each List File that
  10674.           you have  to Import. It can take several hours to Import the 6000
  10675.           plus files  that are  contained on  a CD-Disc,  so plan your time
  10676.           accordingly. You  only need  to be  around to  provide the actual
  10677.           input to the Import Menu Choices.
  10678.  
  10679.           Because there  is no  direct correlation  with the List Files and
  10680.           the files  actually contained in the directory that you specified
  10681.           as the  Source Directory, you will now need to run Update. Makers
  10682.           of CD-Discs provide us with wonderful Categories of files, but we
  10683.           have yet  to see a CD-Disc where 100% of the files in a specified
  10684.           Category are actually in the corresponding disc directory. If you
  10685.           think you  have just spent a great deal of time in getting all of
  10686.           these files  into your  FileBase, imagine  the amount  of time it
  10687.           takes to actually create a CD-Disc!
  10688.  
  10689.           In order  to actually  check each  of  the  new  files  you  just
  10690.           Imported into  your FileBase,  GAPFILE now  needs  to  check  the
  10691.           directory that  is contained  in the Where field for each file to
  10692.           see if  the file  is actually in that directory. If a file is not
  10693.           in that directory, your callers will be unable to download it. In
  10694.           order to do this, GAPFILE needs to search all of your disk drives
  10695.           to try  and locate the file (providing the file isn't where it is
  10696.           supposed to  be). Before running Update, make sure that line 1 of
  10697.           your GAPFILE.CNF file contains only the drive letter for your CD-
  10698.           ROM. This  will force  GAPFILE to search just the CD-ROM. Be sure
  10699.           to change this back after the Update is finished so that the only
  10700.           drives that  will ever  be searched  are your  actual  hard  disk
  10701.           drives. Once the Update of a CD-ROM is complete, there will never
  10702.           be a need to search it again.
  10703.  
  10704.  
  10705.  
  10706.  
  10707.  
  10708.                                       Page 184
  10709.  
  10710.  
  10711.  
  10712.           GAP Communications                                FileBase Editor
  10713.  
  10714.  
  10715.  
  10716.  
  10717.           Before beginning  the Update, we need to go to the hardware level
  10718.           and make  sure the  hardware is working for us instead of against
  10719.           us. If  you do not have expanded memory the following advice does
  10720.           not apply  to you. MSCDEX, the software program that oversees the
  10721.           CD-ROM, allows  you to  set  the  Cache  buffer  size.  Normally,
  10722.           entering /M:32  is sufficient  (or even  using the default buffer
  10723.           size is  sufficient). Since  GAP itself  never has  to physically
  10724.           search for  a file  (you are  doing all that drudgery right now),
  10725.           having a  large buffer  serves no  useful purpose. However, right
  10726.           now, in performing the Update, we need a pretty large CD-ROM Disc
  10727.           Cache.  If you have over 1 meg of expanded memory, we suggest you
  10728.           set your Cache buffer to 512. This will set the Cache buffer to 1
  10729.           meg. The MSCDEX parameters for implementing this are :
  10730.  
  10731.                /E /M:512
  10732.  
  10733.           This will  set up a 1 megabyte  CD-Disc cache in expanded memory.
  10734.           The reason  you need  such a  large cache  is to keep MSCDEX from
  10735.           physically searching  the CD-Disc  for a  file (should the Update
  10736.           not be  able to find the file in the directory the Import Utility
  10737.           said it is in).  Once the entire disc is searched for a file, all
  10738.           of the  directory structure  for the  CD-Disc will be in MSCDEX's
  10739.           Cache buffer. This will speed up the Update process tremendously,
  10740.           since MSCDEX  no longer  needs to  access the  CD-Disc;  all  the
  10741.           information that  it needs  to locate  a file  will already be in
  10742.           fast RAM.
  10743.  
  10744.           Note that  versions of  MSCDEX prior  to 2.2  have a  severe  bug
  10745.           whereby if  you try  to allocate a Cache buffer greater than 63k,
  10746.           the  cache  will  corrupt  itself.  You  will  see  this  problem
  10747.           manifesting itself  as "file not found" or if you do a DIR of the
  10748.           CD-Disc, you  may only  see some of the directories displayed. If
  10749.           you need to set a Cache buffer greater than 63k and you are using
  10750.           a version  of MSCDEX  prior to 2.2, call Microsoft now and obtain
  10751.           an update to the program.
  10752.  
  10753.           Now that  the hardware  is taken care of, we are ready to run our
  10754.           much needed  Update. From  the Utilities  Menu of GAPFILE, select
  10755.           Update. Move  the cursor  down to  All Subjects  and press Enter.
  10756.           This will  cause a  check mark  to be  displayed in  front of All                                                                        
  10757.           Subjects. Make  sure File  Date has  a check mark in front of it.
  10758.           You toggle  individual options  on or off by pressing Enter while
  10759.           the bar  is highlighting  the Menu  Item.  For Delete File and/or                                                     
  10760.           Offline File  (both of  them are mutually exclusive) the decision
  10761.           is yours.  If Update  cannot locate  a particular  file  it  will
  10762.  
  10763.  
  10764.  
  10765.  
  10766.                                       Page 185
  10767.  
  10768.  
  10769.  
  10770.           GAP Communications                                FileBase Editor
  10771.  
  10772.  
  10773.  
  10774.  
  10775.           either delete  the FileBase listing for the file or mark the file
  10776.           as OFFLINE.  As long as you have everything configured correctly,
  10777.           if the  file cannot be located, it simply does not exist. You may
  10778.           choose at  this point  to simply  OFFLINE files  that  cannot  be
  10779.           found. By  marking non-existent  files as  OFFLINE, you  keep the
  10780.           FileBase Entry  for the  file, but  if a caller requests the file
  10781.           for download,  it will  be up  to you  to locate  it and  make it
  10782.           available.
  10783.  
  10784.           By now  it is probably 10:00 PM and you are ready for bed. Select
  10785.           Start from  the sub-Menu and go to sleep. The entire process will
  10786.           take a  minimum of  8 hours.  If you  do not  have at  least a  1
  10787.           megabyte expanded  memory cache that MSCDEX can use, it will take
  10788.           over 18 hours to complete the Update process.
  10789.  
  10790.           Keep in  mind that you are dealing with a device that is probably
  10791.           10 times slower than your 1.4 meg floppy drive. Also keep in mind
  10792.           that your  callers will  think you  have the  best  BBS  in  town
  10793.           because you  have all  these neat  files that  nobody  else  has.
  10794.           Little do they know what you had to go thru to provide them!
  10795.  
  10796.           The Update  process will  insure that  each file in your FileBase
  10797.           can be  located by  GAPBBS. The  time spent  initially installing
  10798.           your CD-Disc  is time  well spent since you will never have to do
  10799.           it again (CD-ROMS do not change).
  10800.  
  10801.  
  10802.           Command Line Interface
  10803.  
  10804.           You may  run GAPFILE  in batch  mode to  produce  a  Master  File
  10805.           Listing. The  Master File Utility Menu must already be configured
  10806.           so that  GAPFILE knows  the name  of the  Master File  list,  the
  10807.           Area(s) to  utilize, whether  or not  to produce  a Condensed  or
  10808.           Enhanced list, etc.
  10809.  
  10810.           The commands to accomplish this are as follows:
  10811.  
  10812.                               +------------------------+
  10813.                                  GAPFILE 6 U M S Q R                              |                        |
  10814.                               +------------------------+
  10815.  
  10816.  
  10817.  
  10818.  
  10819.  
  10820.  
  10821.  
  10822.  
  10823.  
  10824.                                       Page 186
  10825.  
  10826.  
  10827.  
  10828.           GAP Communications                                FileBase Editor
  10829.  
  10830.  
  10831.  
  10832.  
  10833.           Which corresponds to:
  10834.  
  10835.                       +----------------------------------------+
  10836.                          Run GAPFILE                      |                                        |
  10837.                          Select the Utility Menu                      |                                        |
  10838.                          Select the Master File List                      |                                        |
  10839.                          Start the Listing Process                      |                                        |
  10840.                          Select the Quit Menu                      |                                        |
  10841.                          Return To GAPMENU                      |                                        |
  10842.                       +----------------------------------------+
  10843.  
  10844.           The spaces in the command line and the ordering of the parameters
  10845.           are required.
  10846.  
  10847.           GAPFILE will also accept a command line parameter of:
  10848.  
  10849.                               +------------------------+
  10850.                                   UPDATE 6 FILENAME                              |                        |
  10851.                               +------------------------+
  10852.  
  10853.           Where FILENAME is the name of a file to Update.
  10854.  
  10855.           You would  probably want  to use  this command  after producing a
  10856.           Master File  Listing so  that if you ZIP the listing and place it
  10857.           in your  Upload Directory,  GAP will  always show the file as new
  10858.           whenever you update it.
  10859.  
  10860.           Since Update cannot be intermixed with the previous commands, you
  10861.           will need  to run  GAPFILE twice  if you wish to produce a Master
  10862.           File Listing  and Update  the date  and size of the resultant ZIP
  10863.           file that your batch file will create/update.
  10864.  
  10865.           The following  is an  example of  how to  produce a  Master  File
  10866.           Listing, ZIP the listing, then update the FileBase:
  10867.  
  10868.                     MASTER.BAT
  10869.                     +--------------------------------------------+
  10870.                        GAPFILE 6 U M S Q R                    |                                            |
  10871.                        PKZIP H:\UP\CROWLIST.ZIP MASTER.LST                    |                                            |
  10872.                        GAPFILE 6 UPDATE CROWLIST.ZIP                    |                                            |
  10873.                     +--------------------------------------------+
  10874.  
  10875.           Note that  in using  the above  example, you  should make sure to
  10876.           have only one (1) CROWLIST.ZIP in the Filebase since GAPFILE will
  10877.           search for  and accept  the first  instance of  the file it finds
  10878.  
  10879.  
  10880.  
  10881.  
  10882.                                       Page 187
  10883.  
  10884.  
  10885.  
  10886.           GAP Communications                                FileBase Editor
  10887.  
  10888.  
  10889.  
  10890.  
  10891.           (same as  what occurs  when you  use F8  to find  a file  in  All
  10892.           Subjects).
  10893.  
  10894.           Unlike the  commands to  create the  Master List  where you  must
  10895.           specify the  commands to  cause GAPFILE to Quit to GAPMENU, after
  10896.           performing the  Update on  the file,  GAPFILE will  automatically
  10897.           Quit.
  10898.  
  10899.  
  10900.           Indirection Files
  10901.  
  10902.           An Indirection  File is  a file that holds the names of users who
  10903.           are authorized to download the file to which the indirection file
  10904.           is attached.  You attach  an indirection  file to  a file  in the
  10905.           FileBase by placing the name of the indirection file (preceded by
  10906.           an AT (@) sign) in the password field.
  10907.  
  10908.           Lets say  you have  a file  called FILE.ZIP and you wish to allow
  10909.           only Bob  Jones and  Betty Smith  to have  access  to  this  file
  10910.           (because  for  whatever  reason,  you  don't  want  to  give  out
  10911.           passwords and perhaps all of your users have the same level), you
  10912.           can create  an indirection  file called  FILE.PRO  (or  something
  10913.           similar that you can associate with the FILE.ZIP), and place this
  10914.           file in your Indirection Directory.                       
  10915.  
  10916.           The file would be formatted as follows:
  10917.  
  10918.                               FILE.PRO
  10919.                               +------------------------+
  10920.                                 Bob Jones                              |                        |
  10921.                                 Betty Smith                              |                        |
  10922.                               +------------------------+
  10923.  
  10924.           In the  Password field  for  FILE.ZIP,  enter  @FILE.PRO  as  the
  10925.           password. When a user attempts to download FILE.ZIP, GAP will see
  10926.           that it  is protected  by an  indirection file  and will read the
  10927.           file to  see if  the user's name is contained within it. GAP will
  10928.           not allow the download if it cannot locate the user's name in the
  10929.           file.
  10930.  
  10931.           Indirection files  must be  given a  name that is 9 characters or
  10932.           less in  length. In addition, the '@' character cannot be used as
  10933.           the first  character of  a password (unless of course, you intend
  10934.           to use an Indirection file).
  10935.  
  10936.  
  10937.  
  10938.  
  10939.  
  10940.                                       Page 188
  10941.  
  10942.  
  10943.  
  10944.  
  10945.  
  10946.  
  10947.  
  10948.  
  10949.  
  10950.           Chapter 15
  10951.  
  10952.  
  10953.  
  10954.                                                          External Protocols
  10955.  
  10956.  
  10957.  
  10958.  
  10959.  
  10960.  
  10961.           General Information
  10962.  
  10963.           GAP allows  the sysop  to define  up to 20 external protocols. To
  10964.           implement these  protocols, you  will need  an external  protocol
  10965.           driver.
  10966.  
  10967.           The first  thing you  must do  is edit your PROTO file so that it
  10968.           shows the  external protocols  you wish to make available to your
  10969.           users:
  10970.  
  10971.                PROTO
  10972.                +------------------------------------------------------+
  10973.                |                                                      |
  10974.                               File Transfer Protocols               |                                                      |
  10975.                |                                                      |
  10976.                        Ascii                   Ymodem               |                                                      |
  10977.                        Xmodem                  F-Xmodem 1K  (MNP)               |                                                      |
  10978.                        Crc Xmodem              G-Ymodem-G   (MNP)               |                                                      |
  10979.                        1K Xmodem               Zmodem               |                                                      |
  10980.                                         None               |                                                      |
  10981.                |                                                      |
  10982.                                  External Protocols               |                                                      |
  10983.                |                                                      |
  10984.                        Dsz (Zmodem)            Hs-Link               |                                                      |
  10985.                |                                                      |
  10986.                +------------------------------------------------------+
  10987.  
  10988.           Next, you  need to  go into  the Configuration Editor, select the
  10989.           Files Systems  Options from  the Goto  Menu, set the Use External
  10990.           Protocols field  to Yes  and in the Ext Protocol File Name field,                                              
  10991.           type in  the name  of the  data  file  that  holds  the  external
  10992.           protocol information. The default name is PROTO.DAT. This file is
  10993.           placed in  the GEN  directory. Next, press F9 to save the changes
  10994.  
  10995.  
  10996.  
  10997.  
  10998.                                       Page 189
  10999.  
  11000.  
  11001.  
  11002.           GAP Communications                             External Protocols
  11003.  
  11004.  
  11005.  
  11006.  
  11007.           and  then  select  Ext  Protocols  from  the  Files  Menu.  After
  11008.           selecting the  data file  to edit,  you will  be presented with a
  11009.           screen similar to the following:
  11010.  
  11011.           ARTWORK
  11012.  
  11013.  
  11014.  
  11015.  
  11016.  
  11017.  
  11018.  
  11019.  
  11020.  
  11021.  
  11022.  
  11023.  
  11024.  
  11025.  
  11026.  
  11027.           Here you  configure each  of the  external protocols so that they
  11028.           will run properly with GAP.
  11029.  
  11030.           Ltr - This is the character the user must type in order to select
  11031.           the protocol. It can be any character of your choosing but it may
  11032.           not contain  the letter  of one  of the internal protocols (i.e.,
  11033.           1ACFGNXYZ). This  letter also  forms one of the characters in the
  11034.           batch files used to invoke this protocol.
  11035.  
  11036.           Batch -  If the  protocol is  capable of  sending  and  receiving
  11037.           multiple files  in one  invocation, then you would set this field
  11038.           to Yes.  In order to qualify as a Batch protocol, the driver must
  11039.           be able  to produce  a DSZ type of log file. Nearly all protocols
  11040.           that support batch transfers will produce this log. The DSZLOG is
  11041.           a text  file that  lists the  success or  failure of  each of the
  11042.           files the  user has  downloaded. Upon  return from the shell, GAP
  11043.           will read  this log  to determine which files the user downloaded
  11044.           and will update the user record and the FileBase accordingly.
  11045.  
  11046.           In order  for GAP  to know where to find the DSZLOG, you must set
  11047.           an environment  variable in  your  AUTOEXEC.BAT  that  tells  the
  11048.           protocol where  to write  the file  and GAP where to read it. You
  11049.           may name  the file  anything you  like, but for simplicity, it is
  11050.           best to  name it  DSZLOG. In  your AUTOEXEC.BAT  you would  enter
  11051.           something similar to:
  11052.  
  11053.  
  11054.  
  11055.  
  11056.                                       Page 190
  11057.  
  11058.  
  11059.  
  11060.           GAP Communications                             External Protocols
  11061.  
  11062.  
  11063.  
  11064.  
  11065.  
  11066.                SET DSZLOG=C:\GAP
  11067.  
  11068.           Besides being  able to  write a  DSZLOG, the  batch protocol must
  11069.           also be  able to read an indirection file. An indirection file is
  11070.           a text  file that  lists the  full path and name of the files the
  11071.           user wants  to download.  The name of this file is then passed to
  11072.           the protocol  on the  command line.  The protocol  will read this
  11073.           file and send each of the files listed in it to the caller.
  11074.  
  11075.           If the  external protocol is designated as a batch protocol, then
  11076.           GAP will  allow the user to download as many files at one time as
  11077.           his security level allows. In order to accomplish this, GAP keeps
  11078.           track of  the files the user has selected in a binary file called
  11079.           FILELST.DWN. GAP  uses this  file with  its  own  internal  batch
  11080.           protocols. On  your distribution  disks, you  will find a program
  11081.           called READBTCH.EXE.  This program will read the FILELST.DWN file
  11082.           and create  a text  file called  FILELST.TXT. This  text file may
  11083.           then be passed as the indirection file to the protocol driver.
  11084.  
  11085.           BiDir -  If the  protocol is  capable of sending files as well as
  11086.           receiving them  at the  same time,  then you  would answer Yes in
  11087.           this field.  Bi-Directional capability  only works  when  a  user
  11088.           begins a  download  of  file(s)  from  the  BBS  and  instead  of
  11089.           instructing his  communications program to Download, he tells the
  11090.           program to  upload, and supplies a list of files to send. The Bi-
  11091.           Directional protocol  will take care of the sending and receiving
  11092.           of the files.
  11093.  
  11094.           When a  protocol is  configured as  Bi-Directional, then when the
  11095.           user returns  from the shell, GAP will update the user record and
  11096.           the FileBase  with the  file(s) the  user has downloaded and will
  11097.           then check  the upload  work directory  to see  if any files were
  11098.           also uploaded.  If so,  GAP will  then  prompt  the  user  for  a
  11099.           description of  each one  of the  files  it  finds  in  the  work
  11100.           directory.
  11101.  
  11102.           MNP - If the protocol depends upon an Error Correcting Connection
  11103.           between the  two modems  then you would answer Yes in this field.
  11104.           If a  user selects  an MNP  designated protocol  and yet does not
  11105.           have an MNP connection, GAP will issue a warning message.
  11106.  
  11107.           Pro -  tells GAP  whether or not to protect the Sysop status line
  11108.           (the bottom  two lines on the screen). If a protocol makes a mess
  11109.           of the  screen, then  the presence  of the  sysop status  line is
  11110.  
  11111.  
  11112.  
  11113.  
  11114.                                       Page 191
  11115.  
  11116.  
  11117.  
  11118.           GAP Communications                             External Protocols
  11119.  
  11120.  
  11121.  
  11122.  
  11123.           probably causing  it. If  so, you would want to set this field to
  11124.           No.
  11125.  
  11126.           Name -  is a  descriptive name  to give  the protocol. It will be
  11127.           displayed to the user during various activities.
  11128.  
  11129.           In order for GAP to call up the external driver, you will need to
  11130.           create two batch files for each external you wish to support. The
  11131.           download batch  files are  called EXTSx.BAT  and the upload batch
  11132.           files are  called EXTRx.BAT, where the 'x' is the protocol letter
  11133.           for your  external protocol.  These files  go in your GAP DEFAULT
  11134.           directory. The  actual driver may be placed in any directory that
  11135.           is in the DOS path.
  11136.  
  11137.           When uploading,  GAP will  pass the following 4 parameters to the
  11138.           external driver (EXTRx.BAT):
  11139.  
  11140.                     +--------------------------------------------+
  11141.                        %1     Port Number                    |                                            |
  11142.                        %2     Computer to Modem BPS Rate                    |                                            |
  11143.                        %3     Path and/or name of file                    |                                            |
  11144.                        %4     Modem to Caller BPS Rate                    |                                            |
  11145.                     +--------------------------------------------+
  11146.  
  11147.  
  11148.           When downloading, GAP will pass the above 4 parameters along with
  11149.           the following two (EXTSx.BAT):
  11150.  
  11151.                     +--------------------------------------------+
  11152.                        %5     Upload Directory                    |                                            |
  11153.                        %6     0 or 1 if Uploads are allowed                    |                                            |
  11154.                     +--------------------------------------------+
  11155.  
  11156.  
  11157.           The following are sample batch files for DSZ:
  11158.  
  11159.           EXTSD.BAT
  11160.           +----------------------------------------------------------------+
  11161.              @echo off          |                                                                |
  11162.              del dszlog          |                                                                |
  11163.              del filelst.txt          |                                                                |
  11164.              readbtch          |                                                                |
  11165.              dsz ha on z pB4096 estimate 0 %4 sz -y-m @c:\gap\filelst.txt          |                                                                |
  11166.           +----------------------------------------------------------------+
  11167.  
  11168.  
  11169.  
  11170.  
  11171.  
  11172.                                       Page 192
  11173.  
  11174.  
  11175.  
  11176.           GAP Communications                             External Protocols
  11177.  
  11178.  
  11179.  
  11180.  
  11181.           EXTRD.BAT
  11182.           +----------------------------------------------------------------+
  11183.              @echo off          |                                                                |
  11184.              del dszlog          |                                                                |
  11185.              dsz ha on z pB4096 estimate 0 %4 rz -y-m %3          |                                                                |
  11186.           +----------------------------------------------------------------+
  11187.  
  11188.           The external  driver must  return an  exit code  to the operating
  11189.           system. This exit code is returned to GAP by COMMAND.COM. An exit
  11190.           code of 0 means the transfer was successful. Any other code means
  11191.           an unsuccessful transfer.
  11192.  
  11193.           You should be aware that when executing the external protocol, if
  11194.           the batch  file cannot  be found, COMMAND.COM will issue an error
  11195.           message to  the console  but it  will return an exit code of 0 to
  11196.           GAP. This  means the  user will be credited with the download (or
  11197.           upload) even  if  the  attempt  to  shell  to  the  protocol  was
  11198.           unsuccessful.
  11199.  
  11200.           Note that  if you  use DSZ  as an external protocol, your copy of
  11201.           the program  must be registered. Otherwise, during an upload, DSZ
  11202.           will place  the files  in the  current directory  instead of  the
  11203.           directory GAP specifies.
  11204.  
  11205.  
  11206.  
  11207.  
  11208.  
  11209.  
  11210.  
  11211.  
  11212.  
  11213.  
  11214.  
  11215.  
  11216.  
  11217.  
  11218.  
  11219.  
  11220.  
  11221.  
  11222.  
  11223.  
  11224.  
  11225.  
  11226.  
  11227.  
  11228.  
  11229.  
  11230.                                       Page 193
  11231.  
  11232.  
  11233.  
  11234.  
  11235.  
  11236.  
  11237.  
  11238.  
  11239.  
  11240.           Chapter 16
  11241.  
  11242.  
  11243.  
  11244.                                                         Questions & Answers
  11245.  
  11246.  
  11247.  
  11248.  
  11249.  
  11250.           Question: I have  number of  NEWS files that I want my callers to
  11251.                     read, however most of them either answer No at the More
  11252.                     Prompt or  type CTRL-K  to abort  the files.  How can I
  11253.                     force them to read these files in their entirety?
  11254.  
  11255.           Answer:   Place an  @USEPAUSE as  the very  first AnsiCmd  in the
  11256.                     file(s). When GAP encounters this AnsiCmd it will issue
  11257.                     the Pause  Prompt instead  of the  More Prompt and will
  11258.                     disable the CTRL-K and CTRL-X keys.
  11259.  
  11260.  
  11261.           Question: When a caller logs off, my modem will not hang up.
  11262.  
  11263.           Answer:   You probably  have  your  modem  configured  such  that
  11264.                     carrier detect  is always on. The modem needs to be set
  11265.                     so that  GAP has complete control over this signal. For
  11266.                     modems that do not have NRAM this is usually controlled
  11267.                     by  an  external  switch.  For  NRAM  modems,  this  is
  11268.                     normally controlled by the &D2 command.
  11269.  
  11270.  
  11271.           Question: I run  a Network and notice that sometimes when I bring
  11272.                     up the Call Waiting program on one of the client nodes,
  11273.                     there is  a long  delay after  the screen  comes up and
  11274.                     before the Main Menu appears.
  11275.  
  11276.           Answer:   All of  the  GAP  programs  include  a  Critical  Error
  11277.                     Handler. Probably what is occurring is that the Network
  11278.                     connection was  lost (either  because the server logged
  11279.                     the node  off the network or because the server was re-
  11280.                     booted), and  the delay you are experiencing is GAPMENU
  11281.                     trying to  re-establish the  network  connection.  This
  11282.                     delay should not last more than 5 seconds.
  11283.  
  11284.  
  11285.  
  11286.  
  11287.  
  11288.                                       Page 195
  11289.  
  11290.  
  11291.  
  11292.           GAP Communications                            Questions & Answers
  11293.  
  11294.  
  11295.  
  11296.  
  11297.           Question: In a  similar vain,  sometimes I  notice that  the Free
  11298.                     Disk Space  shown in  the Drive  Window is  either some
  11299.                     abnormally large  number or a string of asterisks. What
  11300.                     causes this?
  11301.  
  11302.           Answer:   If GAPMENU  cannot re-establish the connection with the
  11303.                     server, it will be unable to obtain the free disk space
  11304.                     information.  The   abnormally  large   number  or  the
  11305.                     asterisks is  a visual  clue that  the network  is  not
  11306.                     operating correctly.  If you try to log into the system
  11307.                     you will  receive an Error 12 which means GAP is unable
  11308.                     to open any files.
  11309.  
  11310.  
  11311.           Question: I am  using a  9600 baud  modem and  have my  COM  port
  11312.                     locked in at that rate, yet when callers download using
  11313.                     Ymodem-G or Zmodem, they get less than 1000 cps.
  11314.  
  11315.           Answer:   In order  to achieve  better than  9600 cps with a high
  11316.                     speed modem,  you need  to set and lock the COM port at
  11317.                     19200 (or  the highest  speed your  modem is capable of
  11318.                     operating at).  In addition,  your callers  need to set
  11319.                     their modem  to operate  at its  highest speed. Setting
  11320.                     the MNP to level 5 also speeds up throughput.
  11321.  
  11322.  
  11323.           Question: I have  my COM port set to 19200 but when a caller logs
  11324.                     on at that speed, the status line says 9600.
  11325.  
  11326.           Answer:   Your modem  does not return a CONNECT 19200 message. It
  11327.                     is returning  CONNECT 9600.  That is the speed that GAP
  11328.                     displays on  the status  line. Some older Dual Standard
  11329.                     modems are  able to establish connections with a remote
  11330.                     modem at  14,400 bps  but they return CONNECT 9600 back
  11331.                     to GAP.  GAP can  only display  and utilize the CONNECT
  11332.                     message that the modem returns.
  11333.  
  11334.  
  11335.  
  11336.  
  11337.  
  11338.  
  11339.  
  11340.  
  11341.  
  11342.  
  11343.  
  11344.  
  11345.  
  11346.                                       Page 196
  11347.  
  11348.  
  11349.  
  11350.           GAP Communications                            Questions & Answers
  11351.  
  11352.  
  11353.  
  11354.  
  11355.           Question: When using  Ymodem, the  system  seems  to  hang  after
  11356.                     sending a file. About a minute later, it will come back
  11357.                     with a time-out message.
  11358.  
  11359.           Answer:   The caller  is not  using Ymodem.  Ymodem  is  a  batch
  11360.                     protocol and  the hang  you see  is GAP waiting for the
  11361.                     receiver to  acknowledge the  end of  batch signal. The
  11362.                     caller is no doubt using Xmodem 1k.
  11363.  
  11364.  
  11365.           Question: Whenever a  user tries to upload a file, GAP gives them
  11366.                     a "Sorry,  insufficient free  space" and will not allow
  11367.                     the upload.  I've got  more than  4 megs  of free  disk
  11368.                     space!
  11369.  
  11370.           Answer:   One of  two possibilities.  The first  is you  have the
  11371.                     Minimum Free  Upload Space set too high. The second and
  11372.                     most likely,  you did  not enter  a drive designator in
  11373.                     front of  the upload  directory path  in configuration.
  11374.                     GAP needs  to know  which disk  drives the  uploads are
  11375.                     going to.  If you do not enter a disk drive in front of
  11376.                     the path,  GAP has no idea what drive to check for free
  11377.                     space.
  11378.  
  11379.  
  11380.           Question: There is  a serious problem with text files. Whenever I
  11381.                     change one  of my  files such  as the NEWS, the changes
  11382.                     are not  shown to  callers. GAP  still  shows  the  old
  11383.                     version of the file.
  11384.  
  11385.           Answer:   First, it  is physically  impossible for GAP to show an
  11386.                     old copy  of a news file. If you modified the NEWS file
  11387.                     in the  GEN directory,  that is  the file GAP displays.
  11388.                     Chances are,  you are not updating the color version of
  11389.                     the file  and your  callers who  enable color  mode are
  11390.                     seeing the old version.
  11391.  
  11392.  
  11393.  
  11394.  
  11395.  
  11396.  
  11397.  
  11398.  
  11399.  
  11400.  
  11401.  
  11402.  
  11403.  
  11404.                                       Page 197
  11405.  
  11406.  
  11407.  
  11408.           GAP Communications                            Questions & Answers
  11409.  
  11410.  
  11411.  
  11412.  
  11413.           Question: Every once  in a  while when  using Sysop function 1 to
  11414.                     view the  caller log,  the log  displays all  over  the
  11415.                     screen instead  of nice rows and columns. Also, GAPCALL
  11416.                     produces very strange efficiency ratings.
  11417.  
  11418.           Answer:   You are  either editing  the caller  logs or allowing a
  11419.                     door program  to write to them. The logs are binary and
  11420.                     as such cannot be edited.
  11421.  
  11422.  
  11423.           Question: When I  log on  as the sysop, I only have 12 minutes of
  11424.                     time.
  11425.  
  11426.           Answer:   GAP cannot find your security level in the SECLEV file.
  11427.                     Since the  sysop usually has the highest security level
  11428.                     available, GAP  read to  the end  of  the  SECLEV  file
  11429.                     without finding  your level (or a higher level) and you
  11430.                     are ending  up with the default level of 12 minutes. Go
  11431.                     into the  Configuration Editor,  select the  Files Menu
  11432.                     and edit  your SECLEV  file so  that it  includes  your
  11433.                     sysop security level.
  11434.  
  11435.  
  11436.           Question: I have  my F5  (Shell To  DOS) set  to use COMMAND.COM.
  11437.                     However, whenever  I press  the F5  key inside  of  GAP
  11438.                     there is  a brief flash and I'm returned to the Command
  11439.                     Prompt.
  11440.  
  11441.           Answer:   When you have GAP configured to use COMMAND.COM instead
  11442.                     of swapping, GAP remains in memory while you are in the
  11443.                     DOS shell.  If there  is not  enough memory  to load  a
  11444.                     secondary copy  of COMMAND.COM you will experience this
  11445.                     problem. Try  removing unnecessary TSR programs to free
  11446.                     up some  extra DOS  memory. If  you are running under a
  11447.                     multi tasker, increase the size of the GAP window.
  11448.  
  11449.  
  11450.  
  11451.  
  11452.  
  11453.  
  11454.  
  11455.  
  11456.  
  11457.  
  11458.  
  11459.  
  11460.  
  11461.  
  11462.                                       Page 198
  11463.  
  11464.  
  11465.  
  11466.           GAP Communications                            Questions & Answers
  11467.  
  11468.  
  11469.  
  11470.  
  11471.           Question: I set up a Forum with 2 File Directories. When I log on
  11472.                     and try to access the Files Menu GAP tells me there are
  11473.                     no file directories. What's going on?
  11474.  
  11475.           Answer:   It is possible for a Forum to share the Main Board file
  11476.                     directories and  have no  directories of its own, share
  11477.                     the directories  and have  its own special directories,
  11478.                     not share the directories and have its own directories,
  11479.                     or not  have any  files at all. In order to accommodate
  11480.                     the last  option where  the sysop does not want a Forum
  11481.                     to have  any files  available  at  all,  GAP  uses  the
  11482.                     presence of  the DIR  file (the  file  that  lists  the
  11483.                     available File  Subjects) to  tell it  if the Forum has
  11484.                     files available.  You  may  have  either  neglected  to
  11485.                     include the  DIR file in the Forum GEN directory or you
  11486.                     created a  color version  of the  file (DIRG) and not a
  11487.                     regular non-color version.
  11488.  
  11489.  
  11490.           Question: Sometimes while  reading messages  I see a red "Message
  11491.                     Skipped" instead of a message.
  11492.  
  11493.           Answer:   When reading messages, GAP allocates memory to hold the
  11494.                     largest possible  message as  determined by the Maximum
  11495.                     Number Of  Message Lines  that you  have configured. If
  11496.                     the message  that is  about to  be read  from  disk  is
  11497.                     larger than  will  fit  in  the  memory  that  GAP  has
  11498.                     allocated, you  will see  this message  displayed. This
  11499.                     occurs  because  you  lowered  the  Maximum  Number  Of
  11500.                     Message Lines  and there  are messages in the file that
  11501.                     were left  when the  maximum lines  was set to a higher
  11502.                     value.
  11503.  
  11504.  
  11505.  
  11506.  
  11507.  
  11508.  
  11509.  
  11510.  
  11511.  
  11512.  
  11513.  
  11514.  
  11515.  
  11516.  
  11517.  
  11518.  
  11519.  
  11520.                                       Page 199
  11521.  
  11522.  
  11523.  
  11524.           GAP Communications                            Questions & Answers
  11525.  
  11526.  
  11527.  
  11528.  
  11529.           Question: I was  told that  it  is  not  necessary  to  have  two
  11530.                     versions of  each of  the text  files and  that you can
  11531.                     eliminate the  'G' version  of the file and the regular
  11532.                     file (NEWS  for instance) can contain ANSI color and if
  11533.                     the caller  is in  non color  mode, GAP will just strip
  11534.                     the color  codes out  of the  file.  I  tried  this  by
  11535.                     deleting my  NEWS file  and renaming the NEWSG to NEWS.
  11536.                     It doesn't  work! The  caller doesn't receive any color
  11537.                     but the NEWS is a total mess on his screen!
  11538.  
  11539.           Answer:   It is  true that you do not need two versions of a file
  11540.                     - Color  and Non  Color. The  basic file  (NEWS in your
  11541.                     example) can  contain ANSI color codes. But that is all                                                                        
  11542.                     that  it   can  contain.  GAP  strips  only  the  color
  11543.                     sequences out of the file if the caller is in non color
  11544.                     mode. Any  other ANSI sequences are sent to the caller.
  11545.                     If the  NEWS file  appears "jumbled"  on  the  caller's
  11546.                     screen, it  is because  the file  contains  other  ANSI
  11547.                     sequences besides  color codes.  TheDraw, for instance,
  11548.                     saves  screens   using  space  compression  codes.  For
  11549.                     instance, if  you have  a screen  that  has  20  spaces
  11550.                     between one word and another, the program will save the
  11551.                     file using  an ANSI sequence that moves the cursor over
  11552.                     20 spaces  instead of using 20 actual hard spaces. Your
  11553.                     caller, because  he or she does not have ANSI emulation
  11554.                     turned on,  will see  the ANSI  codes instead of the 10
  11555.                     spaces. It  is suggested that if you are going to use a
  11556.                     single basic  file that  contains color  codes that you
  11557.                     use an  XCode Editor  instead of  an ANSI editor. These
  11558.                     programs write  only XCodes  to the  file and  no  ANSI
  11559.                     sequences. As  an alternative,  you can  edit the  file
  11560.                     with a  Text Editor  and  replace  all  of  the  cursor
  11561.                     movement sequences with actual hard spaces.
  11562.  
  11563.  
  11564.  
  11565.  
  11566.  
  11567.  
  11568.  
  11569.  
  11570.  
  11571.  
  11572.  
  11573.  
  11574.  
  11575.  
  11576.  
  11577.  
  11578.                                       Page 200
  11579.  
  11580.  
  11581.  
  11582.           GAP Communications                            Questions & Answers
  11583.  
  11584.  
  11585.  
  11586.  
  11587.           Question: When users  upload files  they seem to receive a lot of
  11588.                     CRC errors.  What is  a CRC  error and what can I do to
  11589.                     prevent this? I'm using a 9600 baud modem.
  11590.  
  11591.           Answer:   A CRC  error means  that the  last block  of  data  GAP
  11592.                     received from  the modem  was incorrect.  This  can  be
  11593.                     caused by many things but if it happens with regularity
  11594.                     it is  due to  a hardware  problem with  your computer.
  11595.                     Either your  phone lines are excessively noisy, you are
  11596.                     using an  internal modem  and need  to clean  the  edge
  11597.                     connectors on  the modem  card, you  are using Extended
  11598.                     Memory for  a Disk  Cache, or  your serial port card is
  11599.                     not using  a  16550  UART.  High  speed  communications
  11600.                     require that  your serial  port be able to keep up with
  11601.                     the modem.  Most computers  and serial  port cards come
  11602.                     equipped with  older, outdated,  UART chips. These UART
  11603.                     chips simply  cannot keep up and will loose data. There
  11604.                     is also  the possibility  that the  problem lies on the
  11605.                     other end  of the  connection or  that  your  board  is
  11606.                     situated in  a calling area where all phone connections
  11607.                     are routed through an antiquated switching system.
  11608.  
  11609.  
  11610.           Question: I want  to upgrade from single user to multi user. Will
  11611.                     GAP allow  me to  run more  than one  node on  a single
  11612.                     computer?
  11613.  
  11614.           Answer:   GAP itself  is not a multi tasking program. To run more
  11615.                     than one  node you  will need  either a  LAN or a multi
  11616.                     tasking program  such as DESQview. If you intend to run
  11617.                     more than  one node on a single computer, DESQview is a
  11618.                     good choice  if the computer is a 386 or better and you
  11619.                     have at  least 4  megabytes of memory. You will be able
  11620.                     to run  at least  4 nodes  and a  private "local  only"
  11621.                     node. Of  course you will also need 4 phone lines and 4
  11622.                     modems! We  recommend using  a LAN  if you  want to run
  11623.                     multiple nodes,  but if  you do  not mind a performance
  11624.                     penalty, then multi tasking will work as well.
  11625.  
  11626.  
  11627.  
  11628.  
  11629.  
  11630.  
  11631.  
  11632.  
  11633.  
  11634.  
  11635.  
  11636.                                       Page 201
  11637.  
  11638.  
  11639.  
  11640.           GAP Communications                            Questions & Answers
  11641.  
  11642.  
  11643.  
  11644.  
  11645.           Question: I run  a closed  board that  is dedicated to "in house"
  11646.                     support of our sales people and do not want GAP placing
  11647.                     uninvited callers  into the  user file.  Why  does  the
  11648.                     program do  this and  is there  some way  I can prevent
  11649.                     it?
  11650.  
  11651.           Answer:   GAP places  new users  in the  user file  (but with the
  11652.                     Private User  flag set  to No) to make it easier on the
  11653.                     sysop to  update the  records of  new users  after they
  11654.                     have been  verified and  paid their  subscription.  For
  11655.                     truly closed  boards where new users are not wanted, in
  11656.                     your NEWUSER  file, explain  to the  caller  that  your
  11657.                     board is closed, that no new users are allowed onto the
  11658.                     system, and  at the  end of the file, use an @PAUSE and
  11659.                     an @DISCON  AnsiCmd. The Pause will give the caller the
  11660.                     opportunity to read the screen and the Discon will tell
  11661.                     GAP to  disconnect the caller. Since this occurs before
  11662.                     the caller  is given  an opportunity to register, there
  11663.                     will be no record of the caller in the user file.
  11664.  
  11665.  
  11666.           Question: GAP allows me to restrict callers based upon their baud
  11667.                     rate but  what I  really need  to do  is  restrict  any
  11668.                     caller, irregardless  of their  baud rate,  who doesn't
  11669.                     have a  level of  90 during  the hours  of 8:00  am and
  11670.                     12:00 pm. Can I do this?
  11671.  
  11672.           Answer:   Absolutely! Go  into the  Seclev Editor of GAPSETUP and
  11673.                     set the  Minutes Available  field for all levels except
  11674.                     the sysop  level and  level 90 to 0. Press F10 and save
  11675.                     the file  as SECLEV.080.  Press F10  again and save the
  11676.                     file as  SECLEV.090. Repeat this process until you have
  11677.                     saved 5  files, each  with an  extension of .080, .090,
  11678.                     .100, .110,  and .120. Then create a file called NOTIME
  11679.                     in your  GEN directory. This file should explain to any
  11680.                     caller that  doesn't have  a level of 90 the reason why
  11681.                     they are  not being  allowed on  the system during your
  11682.                     restricted hours. By the way, your Time Specific SECLEV
  11683.                     files need  only include  a few security levels such as
  11684.                     89, 90,  and 110  (or whatever your sysop level is). If
  11685.                     callers at  level 40 or 50 try to log on, GAP will give
  11686.                     them the  allotments for  level 89  which will  be  (or
  11687.                     should be all zeros).
  11688.  
  11689.  
  11690.  
  11691.  
  11692.  
  11693.  
  11694.                                       Page 202
  11695.  
  11696.  
  11697.  
  11698.           GAP Communications                            Questions & Answers
  11699.  
  11700.  
  11701.  
  11702.  
  11703.           Question: When some of my callers list the file directories there
  11704.                     is an  asterisk (*)  displayed in  front of some of the
  11705.                     file descriptions. What does the asterisk mean?
  11706.  
  11707.           Answer:   When listing  files, if  any file  is  newer  than  the
  11708.                     user's last  New Files  Scan Date,  the  file  will  be                                 
  11709.                     flagged with an asterisk in Condensed Mode. In Enhanced
  11710.                     Mode the header will say 'New'.
  11711.  
  11712.  
  11713.           Question: When my callers are automatically taken to the Bulletin
  11714.                     Menu (because there are new bulletins) it seems like it
  11715.                     takes forever for the Bulletin Menu to appear. Is there
  11716.                     something wrong with my system to cause this delay?
  11717.  
  11718.           Answer:   If there  are any  new bulletins,  GAP will display the
  11719.                     numbers  of  the  bulletins  that  are  new  above  the
  11720.                     Bulletin Command  prompt. In  order to  determine which
  11721.                     bulletins are  new, GAP  has  to  check  each  of  your
  11722.                     bulletin files  and compare  the date  on the file with
  11723.                     the date  the user  was last  on. If  you have over 100
  11724.                     bulletins, this  process can  take a bit of time. There
  11725.                     is nothing  we can  do with GAP to speed the process up
  11726.                     since we  are simply  asking DOS  for the  date on  the
  11727.                     bulletin  file.   Do  you   really  need  100  or  more
  11728.                     bulletins? If  you run  lots of  doors and  display the
  11729.                     scoreboards from each of the door programs that produce
  11730.                     such bulletins,  you might consider putting all of your
  11731.                     doors in  a Doors Forum and configure the door programs
  11732.                     to write their bulletins to that Forum's GEN Directory.
  11733.  
  11734.  
  11735.           Question: I have  the Force New Bulletins set to Yes and I update
  11736.                     my News  file once  a week,  but some of my callers are
  11737.                     typing "Y  Q NS O" at the logon prompt and they are not
  11738.                     being forced to read the News or the new bulletins.
  11739.  
  11740.           Answer:   On the Third Miscellaneous Screen in GAPSETUP, there is                           
  11741.                     a field  called Level  To Override Logon. Set this to a
  11742.                     security level that is higher than that of your regular
  11743.                     callers. This  will prevent callers who do not have the
  11744.                     security level  you specify  from overriding your News,
  11745.                     Security News,  User Info  files and  New Bulletins. On
  11746.                     the same  configuration screen  is a field called Allow
  11747.                     Quick Logon. Set this field to No.
  11748.  
  11749.  
  11750.  
  11751.  
  11752.                                       Page 203
  11753.  
  11754.  
  11755.  
  11756.           GAP Communications                            Questions & Answers
  11757.  
  11758.  
  11759.  
  11760.  
  11761.           Question: All of a sudden, whenever I or one of my users tries to
  11762.                     save a  message, GAP  issues a  "Sorry, Message File Is
  11763.                     Full" and won't save the message.
  11764.  
  11765.           Answer:   Go  to   the  Miscellaneous   Info  2   screen  in  the
  11766.                     Configuration Editor and increase the Max # of Messages
  11767.                     field. You've  reached the  maximum number  of messages
  11768.                     that you configured so GAP won't allow any new messages
  11769.                     to be saved.
  11770.  
  11771.  
  11772.  
  11773.  
  11774.  
  11775.  
  11776.  
  11777.  
  11778.  
  11779.  
  11780.  
  11781.  
  11782.  
  11783.  
  11784.  
  11785.  
  11786.  
  11787.  
  11788.  
  11789.  
  11790.  
  11791.  
  11792.  
  11793.  
  11794.  
  11795.  
  11796.  
  11797.  
  11798.  
  11799.  
  11800.  
  11801.  
  11802.  
  11803.  
  11804.  
  11805.  
  11806.  
  11807.  
  11808.  
  11809.  
  11810.                                       Page 204
  11811.  
  11812.  
  11813.  
  11814.  
  11815.  
  11816.  
  11817.  
  11818.  
  11819.  
  11820.  
  11821.                                                                    Index
  11822.  
  11823.  
  11824.  
  11825.  
  11826.  
  11827.             Address
  11828.               Changing     27, 153
  11829.             ANSI 33, 113, 200
  11830.             AnsiCmd   32, 38, 113
  11831.             ARC Files 24, 39, 69
  11832.             Archive Menu Commands    24, 153
  11833.             Archives
  11834.               Transfering A File From     24, 69, 155
  11835.             Attached File Directory  18
  11836.             Attaching Files     14, 150
  11837.             Base Address   19
  11838.             Batch Download 52
  11839.             Batch Files
  11840.               ARCTRANS.BAT 24, 69
  11841.               Doors   52
  11842.               Event   111
  11843.               GAPCOMM.BAT  129
  11844.               LOGON.BAT    73
  11845.               Special 68
  11846.               Startup 11, 51
  11847.               UPCHECK.BAT  69
  11848.             Birth Date     23, 27, 153
  11849.             Bulletins 26, 28, 35
  11850.               Forcing 26
  11851.               New     26
  11852.               Statistic    26
  11853.             Call Waiting   28, 127
  11854.               Customizing  135
  11855.             Caller Alarm   128, 157
  11856.             Caller Log     16, 123
  11857.               Viewing 129, 158, 198
  11858.             Callers
  11859.               Displaying Name Of Last     28
  11860.               Restricting  21, 58, 66, 202
  11861.             Carbon Copy Messages     31, 46, 150
  11862.             Carrier Detect 18, 79
  11863.             CD-Rom    178
  11864.             Closed Board   35, 63, 202
  11865.             Color     30, 31, 46, 152
  11866.             Color Files    22, 38, 41, 51, 113, 119, 200
  11867.             Commands
  11868.               Archive Menu 24, 153
  11869.               File Menu    24, 153
  11870.  
  11871.  
  11872.  
  11873.  
  11874.                                       Page 205
  11875.  
  11876.  
  11877.  
  11878.             GAP Communications                                          Index
  11879.  
  11880.  
  11881.  
  11882.  
  11883.               Main Menu    22, 147
  11884.               Sysop   156
  11885.               View/Change Stats Menu 25, 152
  11886.             Comments  13, 23, 41, 45, 47
  11887.             Communications Port 19
  11888.             Configuration  11, 12
  11889.             Corrupted Files     53
  11890.             Country   13
  11891.             CRC Errors     20, 201
  11892.             CTS  20
  11893.             Custom Menus   23
  11894.             Default Country     13
  11895.             Default Directory   2, 6, 11, 23, 43, 48, 51
  11896.             Default Filename Extension    39
  11897.             Deleting Messages   31, 46, 150
  11898.             Description Files   69, 154
  11899.             Directories    5, 37, 45, 48
  11900.               Default 6, 11, 23, 43, 48, 51
  11901.               Forum   67
  11902.               Forum Default     67
  11903.               Forum Gen    68
  11904.               Forum Upload 68
  11905.               Gen     6, 17, 62
  11906.               Help    17, 57
  11907.               Indirection Files 18, 188
  11908.               Loose Files  17
  11909.               Main    6, 17, 57
  11910.               Upload  17
  11911.             Doors     16, 48, 87, 88
  11912.               And Events   110
  11913.             Downloading Messages     74
  11914.             Duplicate Files     39, 176
  11915.             Duplicate Records   142
  11916.             Echo Mail 30, 47
  11917.             Editing Messages    14
  11918.             EMS  33
  11919.             Enforcing File Ratios    38, 58, 66
  11920.             Enforcing Time Limit     27, 58
  11921.             Entering Messages   150
  11922.             Errors    125
  11923.               Fatal   53
  11924.               Message File Full 204
  11925.  
  11926.  
  11927.  
  11928.  
  11929.  
  11930.  
  11931.  
  11932.  
  11933.  
  11934.  
  11935.  
  11936.  
  11937.  
  11938.                                       Page 206
  11939.  
  11940.  
  11941.  
  11942.             GAP Communications                                          Index
  11943.  
  11944.  
  11945.  
  11946.  
  11947.             Events    34, 40, 107
  11948.             Expired Subscription     35, 47, 64, 141, 143, 146
  11949.             Expired Time   27
  11950.             Exporting Messages  158
  11951.             External Protocols  39, 48, 49, 52, 189
  11952.             Failed Check Level  23
  11953.             Fatal Errors   53
  11954.             File Description    154
  11955.             File Directories    37
  11956.             File Menu Commands  24, 153
  11957.             File Ratios    38, 58, 66
  11958.             File Transfer Protocols  65, 189
  11959.               Changing     153
  11960.             FileBase  18, 161
  11961.             Files
  11962.               ARC     24
  11963.               ARCTRANS.BAT 24, 69
  11964.               Baud Rate Restriction  22
  11965.               Caller Log   16
  11966.               Closed  35, 63
  11967.               Color   113, 200
  11968.               COMMENT 41
  11969.               Corrupted    53
  11970.               Default Extension 39
  11971.               Description  69
  11972.               Doors   16, 52, 73
  11973.               Duplicate    39, 176
  11974.               EXPIRE  36, 64
  11975.               FAILED  23
  11976.               Forum Data   17
  11977.               GAPCOMM.BAT  129
  11978.               Importing    158, 173
  11979.               Indirection  188
  11980.               Locating     154, 167
  11981.               LOCKOUT 41
  11982.               LOGON.BAT    73
  11983.               Message 15
  11984.               Moving  174
  11985.               NEWQUEST     35
  11986.               News    16, 31, 115
  11987.               Offline 129, 172, 185
  11988.               Overwriting  14
  11989.               Packing 54
  11990.               Remote Exit  17
  11991.               REMOTE.BAT   56
  11992.               SECLEV  16, 23, 37, 48, 58, 65, 145
  11993.               Security     114
  11994.               Security Menus    115
  11995.               Security News     115
  11996.               Sharing 12
  11997.               Stray   173
  11998.  
  11999.  
  12000.  
  12001.  
  12002.                                       Page 207
  12003.  
  12004.  
  12005.  
  12006.             GAP Communications                                          Index
  12007.  
  12008.  
  12009.  
  12010.  
  12011.               System  51
  12012.               Text    20, 114
  12013.               Time & Bytes 16, 23, 37, 48, 58, 65, 145
  12014.               TWIT    41
  12015.               UPCHECK.BAT  69
  12016.               Uploads 14, 154
  12017.               User    15
  12018.               User Info    34, 116
  12019.               Verifying    69
  12020.               Welcome 16, 66
  12021.               ZIP     24
  12022.             Finding Files  167
  12023.             Finding Users  140
  12024.             Flow Control   20
  12025.             Forcing Bulletin Menu    26
  12026.             Forcing New Bulletins    26
  12027.             Forum     27, 43
  12028.               Data File    17
  12029.               Default Directory 67
  12030.               Directories  67
  12031.               Gen Directory     68
  12032.               Locking User Out Of    139
  12033.               Name    43
  12034.               Number Available  32
  12035.               Registering Users In   141
  12036.               Subscription 47
  12037.               Sysop   44, 139
  12038.               Upload Directory  68
  12039.             GAPPACK   54
  12040.             GAPREBLD  53
  12041.             Gen Directory  6, 17, 62
  12042.             Handle    27, 46, 47, 140, 153
  12043.             Help Directory 17, 57
  12044.             Importing Files     158, 173
  12045.             Indirection Files   18, 188
  12046.             Init String    18
  12047.             IRQ  19
  12048.             ISAM 53
  12049.             Keyboard Time-Out   32
  12050.             Last Caller    28
  12051.             Locating Files 154, 167
  12052.             Locating Users 140
  12053.             Locked Out Users    16, 28, 41, 62, 156
  12054.               In Forums    139
  12055.             Logon     73
  12056.             Logon Overriding    28
  12057.             Loose Files Directory    17
  12058.             Main Directory 6, 17, 57
  12059.             Main Menu
  12060.               Security Level Specific     115
  12061.               Sysop Defined Items    23
  12062.  
  12063.  
  12064.  
  12065.  
  12066.                                       Page 208
  12067.  
  12068.  
  12069.  
  12070.             GAP Communications                                          Index
  12071.  
  12072.  
  12073.  
  12074.  
  12075.             Main Menu Commands  22, 147
  12076.             Master File Listing 173, 186
  12077.             Memory Image   33
  12078.             Menus
  12079.               Sysop Defined     131
  12080.             Message File Full   204
  12081.             Message Headers     14
  12082.             Messages
  12083.               ANSI    46
  12084.               Attached File Directory     18
  12085.               Attaching Files To     14, 150
  12086.               Carbon Copy  31, 46, 150
  12087.               Deleting     31, 46, 150
  12088.               Downloading  74
  12089.               Echo    30, 47
  12090.               Editing 14, 150
  12091.               Entering     150
  12092.               Exporting    158
  12093.               Forum   43
  12094.               Full    30
  12095.               Importing    158
  12096.               Main Board   15
  12097.               Maximum Number Of 30, 45, 204
  12098.               Number Left  28
  12099.               Number Of Lines   30, 199
  12100.               Off-line Reading Of    74
  12101.               Private 13, 44, 46
  12102.               Protecting   13, 150
  12103.               Quoting 31
  12104.               Reading 14, 150
  12105.               Resetting Last Read    141
  12106.               Restoring    159
  12107.               Saving  150
  12108.               Searching    149
  12109.               Skipped 199
  12110.               Snooping     14, 151
  12111.               Time Credit For Leaving     31, 45
  12112.               UnDeleting   159
  12113.               UnProtecting 13, 150
  12114.               Validating   46
  12115.             Modem
  12116.               Buffer  20
  12117.               Configuration     18, 79, 195
  12118.               Connect 19, 20, 79
  12119.               Delay   20
  12120.             Moving Files   174
  12121.             Multi User     11
  12122.             NetBIOS   29
  12123.             Network   11, 15, 20, 27, 29, 32, 52, 57, 195
  12124.               Viewing Activity Of    129
  12125.  
  12126.  
  12127.  
  12128.  
  12129.  
  12130.                                       Page 209
  12131.  
  12132.  
  12133.  
  12134.             GAP Communications                                          Index
  12135.  
  12136.  
  12137.  
  12138.  
  12139.             New Bulletins  26
  12140.             New User  28
  12141.               Level   23
  12142.               Preventing   202
  12143.               Questionnaire     16, 106
  12144.               Welcome File 16, 202
  12145.             News 16, 17, 28, 31, 47, 64
  12146.               Security     36, 115
  12147.             Non-Standard Ports  19
  12148.             Non-Stop Mode  20
  12149.             Off Hook String     18
  12150.             Offline Files  129, 172, 185
  12151.             Overriding Logon Screens 28
  12152.             Overwriting Files   14
  12153.             Packing Files  54
  12154.             Paging Sysop   65, 128, 148, 157
  12155.             Password  13, 153
  12156.             Phone Number   23, 27, 28
  12157.             Preventing New Users     202
  12158.             Printer   27, 128
  12159.             Private Mail   13, 46
  12160.             Private Uploads     38
  12161.             Private User   35, 63, 145, 202
  12162.             Protecting Files    188
  12163.             Protecting Messages 13, 150
  12164.             Protocols 65, 189
  12165.               Changing     153
  12166.  
  12167.  
  12168.  
  12169.  
  12170.  
  12171.  
  12172.  
  12173.  
  12174.  
  12175.  
  12176.  
  12177.  
  12178.  
  12179.  
  12180.  
  12181.  
  12182.  
  12183.  
  12184.  
  12185.  
  12186.  
  12187.  
  12188.  
  12189.  
  12190.  
  12191.  
  12192.  
  12193.  
  12194.                                       Page 210
  12195.  
  12196.  
  12197.  
  12198.             GAP Communications                                          Index
  12199.  
  12200.  
  12201.  
  12202.  
  12203.             Questionnaires 16, 35, 93
  12204.             Quick Logon    28
  12205.             Quoting Messages    31
  12206.             QWK  30, 74
  12207.             Ratios    38, 58, 66
  12208.             Real Names     27
  12209.             Rebuilding Files    53
  12210.             Registration   16, 23, 27, 28
  12211.             Remote Exit    17, 56
  12212.             REP  30, 74
  12213.             Reset String   18
  12214.             Restoring Messages  159
  12215.             Restricting Callers 21, 58, 66, 202
  12216.             Ring Detect    19
  12217.             RTS  20
  12218.             SECLEV    16, 23, 37, 48, 58, 65, 145, 202
  12219.             Security Files 114
  12220.             Security Level 158
  12221.             Security Menus 115
  12222.             Security News  36, 115
  12223.             SHARE.EXE 12
  12224.             Skipped Messages    199
  12225.             Startup Batch File  11, 51
  12226.             Statistic Bulletins 26
  12227.             Status Line    33
  12228.             Stray Files    173
  12229.             Subscription   35, 43, 47, 64, 141, 202
  12230.             Swap File 33
  12231.             Sysop Commands 156
  12232.             Sysop Defined Menus 23, 25, 131
  12233.             Sysop Defined Screens    135
  12234.             Sysop Levels   13, 44
  12235.             Sysop Menus    66
  12236.             Sysop Name     13
  12237.             Sysop Page     65, 128, 148, 157
  12238.             Sysop Password 13
  12239.             System Files   51
  12240.             System Operation    147
  12241.             Text Files     2, 15, 41, 113, 156
  12242.               Aborting     20
  12243.               Color   15, 22, 38, 41
  12244.             Text Search Messages     149
  12245.             Time
  12246.               Available    158
  12247.               Credits 31, 45
  12248.               Expired 27, 65, 198
  12249.  
  12250.  
  12251.  
  12252.  
  12253.  
  12254.  
  12255.  
  12256.  
  12257.  
  12258.                                       Page 211
  12259.  
  12260.  
  12261.  
  12262.             GAP Communications                                          Index
  12263.  
  12264.  
  12265.  
  12266.  
  12267.             Time & Bytes File   16, 23, 37, 48, 58, 65, 145, 202
  12268.             Time Limit     27, 65, 145, 198, 202
  12269.             Transfering Files   24, 69, 155
  12270.             Trash Can 16, 41, 62, 156
  12271.             TWIT 41, 157
  12272.             UnDeleting Messages 159
  12273.             UnProtecting Messages    13, 150
  12274.             Upload Directory    17, 43, 45
  12275.             Uploads
  12276.               And Events   34, 110
  12277.               Checking     69, 154
  12278.               CRC Errors   20, 201
  12279.               Description  69
  12280.               Free Disk Space   38
  12281.               Help    66
  12282.               Keeping In Forum  45, 68
  12283.               Overwriting  14
  12284.               Private 38, 45
  12285.               Security Level    39, 44
  12286.               Time Credits 38
  12287.               Unwanted     65
  12288.               Writing To Disk   20
  12289.               Zmodem  20
  12290.             User Editor    139
  12291.             User Statistics
  12292.               Displaying   28
  12293.               Last Caller  28
  12294.             USERINFO  34, 116
  12295.             Users
  12296.               Adding  139
  12297.               Deleting     139
  12298.               Locating     140
  12299.               Locked Out   28, 41, 62, 156
  12300.               Registering In Forum   141
  12301.               Time-Out     32
  12302.             Validating
  12303.               Messages     31, 46
  12304.               Phone Numbers & Birthdays   58
  12305.               Registration Information    23, 28
  12306.             View/Change Stats Menu Commands    25, 152
  12307.             Virus     69, 154
  12308.             Welcome File   16, 28, 66
  12309.               New User     16
  12310.             XCodes    27, 119
  12311.             ZIP Files 24, 39, 69
  12312.             Zmodem    20
  12313.  
  12314.  
  12315.  
  12316.  
  12317.  
  12318.  
  12319.  
  12320.  
  12321.  
  12322.                                       Page 212