






                                 QWK/REP Sub-System

          Description

          The QWK/REP  sub-system is  a very  basic method  to  allow  your
          callers to  download QWK  packets containing  all new messages in
          Forums the  callers have  selected. It  also  allows  callers  to
          upload messages that were created with an off-line mail reader.



          Setting Up

          Setting up the QWK/REP sub-system is very similar to setting up a
          door for  use with GAP. The only basic difference is that this is
          NOT a  door and  must not  be configured  as part  of your  doors
          system since  the commands  to activate  the modules are built in
          commands and the initial prompts are a part of GAPBBS.

          Create a directory off of your DEFAULT directory called QWKREP:

               C:\GAP\QWKREP

          This directory will contain the following files:

               REPIMPRT.EXE
               QWKEXPRT.EXE
               QWKREPx.CNF
               QWKH
               QWKMENU
               QWKMENUG
               SEND.BAT
               RECV.BAT

          The QWKREPx.CNF is a configuration file that supplies the modules
          with the necessary information they need in order to run. The 'x'
          is the  Node Number that the configuration applies to. If you run
          single node  GAP software,  you may leave the node number off and
          simply name the file QWKREP.CNF.

          QWKH is a help file that is utilized by the QWK Module.

          QWKMENU and  QWKMENUG are  Menus that  are utilized  by  the  QWK
          Module.

          SEND.BAT and  RECV.BAT are  batch files that the QWK modules will
          invoke to send a QWK packet and receive a REP packet.



          GAP Communications                             QWK/REP Sub-System


          The configuration file consists of the following lines:

               Default Directory
               Name of BBS
               IRQ
               Base Address
               QWK/REP ID
               SEND.BAT
               RECV.BAT
               NODOSWIN (or blank)
               SYSOP NAME
               Duplicate Message Directory

          The Default  Directory is the directory where your GAPBBS.CNF and
          DOOR.SYS files reside.

          The Name of BBS is your BBS Name.

          The IRQ  is the  Interrupt Request  Number  for  the  port.  This
          applies only  if you  are using ports other than COM 1 and COM 2.
          If you are using standard COM ports, enter a 0 on this line.

          The Base  Address is the Port address (in hexadecimal). This line
          also only applies if you are using non-standard COM ports. If you
          are using standard COM ports, enter a 0 on this line.

          The QWK/REP  ID is a unique Identifier for your BBS. It must be 8
          characters or less in length and entered in all upper case.

          The SEND.BAT  file line  can be  given any DOS batch file name of
          your choice.  When a caller requests a QWK packet, the QWK module
          will call  this batch  file to  invoke DSZ  or any  other  Zmodem
          protocol program.

          The following parameters will be passed to this batch file:

               %1   -    COM Port Number
               %2   -    COM Port Speed (DTE bps rate)
               %3   -    Caller's bps rate
               %4   -    The directory where the QWK packet is located.











                                       Page 2



          GAP Communications                             QWK/REP Sub-System


          The RECV.BAT  file line  can be  given any DOS batch file name of
          your choice.  When a caller requests a REP packet, the REP or QWK
          module will  call this  batch file  to invoke  DSZ or  any  other
          Zmodem protocol program.

          The following parameters will be passed to this batch file:

               %1   -    COM Port Number
               %2   -    COM Port Speed (DTE bps rate)
               %3   -    Caller's bps rate
               %4   -    The directory where the Protocol should place the
                         REP packet.

          Line 8  can either  be NODOSWIN  or the  end of the configuration
          file. When shelling to PKZIP or DSZ, the QWK/REP modules create a
          "DOS Window"  into which  all output  will be re-directed. If you
          use a  full screen  version of  DSZ or have other reasons for not
          using the DOS Window, you may enter NODOSWIN on this line and the
          modules will not attempt to redirect all DOS output to a window.

          Line 9  is the Sysop's Real Name. When messages are imported, any
          message that  is TO  the Sysop's  real name  will be  changed  to
          SYSOP.

          Line 10  is the  full path  to the  directory that  will hold the
          files that  contain  Duplicate  Message  pointers.  When  a  user
          imports messages, the programs will check to see if a message has
          already been  imported.  If  so,  the  current  message  will  be
          rejected. If  you do  not want  QWKEXPRT and  REPIMPRT to perform
          Duplicate Message  Checking, leave  this line  blank. If you also
          use GAPNET,  this field  should contain  the directory where your
          GAPNET DUP files reside.



















                                       Page 3



          GAP Communications                             QWK/REP Sub-System


          A sample configuration file would look like this:

               QWKREP.CNF
               ---------------------------
               C:\GAP
               The Crow's Nest BBS
               0
               0
               CROWNEST
               SEND.BAT
               RECV.BAT
               USE DOS WINDOW
               DARIN MAY
               C:\GAP\QWKREP\DUP

          If you  run multi  nodes, you  will need  a separate configuation
          file for each node.



          Next you will need to create two batch files that GAP will invoke
          when a caller types the appropriate QWK/REP command from the Main
          Menu (the commands are also available from the Files Menu). These
          batch files are placed in your DEFAULT directory.

          The first  is called  QWK.BAT. It  is  associated  with  the  QWK
          command. This  file will  invoke the QWKEXPRT.EXE module, passing
          to it  the name  of the  configuration file  for the  appropriate
          node. Such a file would look like this:

               QWK.BAT
               ---------------------------
               @echo off
               c:
               cd \gap\qwkrep
               qwkexprt qwkrep1.cnf
               c:
               cd \gap

          Notice that  the file  changes  into  the  QWKREP  directory  and
          invokes  the   QWKEXPRT  module,  passing  it  the  name  of  the
          configuration file for Node 1. If you run muliple nodes, you will
          need a  QWK.BAT file  for each  node. The only difference between
          the files  would be  the drive and directory designators, and the
          line that  calls up  the QWKEXPRT  module. Each  node must  use a
          different configuration  file and  pass the  name of this file to
          the QWKEXPRT module.




                                       Page 4



          GAP Communications                             QWK/REP Sub-System


          The second  batch file  is called  REP.BAT. It is associated with
          the REP  command. This  file will invoke the REPIMPRT.EXE module,
          passing to  it  the  name  of  the  configuration  file  for  the
          appropriate node. Such a file would look like this:

               REP.BAT
               ---------------------------
               @echo off
               c:
               cd \gap\qwkrep
               repimprt qwkrep1.cnf
               c:
               cd \gap

          Notice that  the file  changes  into  the  QWKREP  directory  and
          invokes  the   REPIMPRT  module,  passing  it  the  name  of  the
          configuration file for Node 1. If you run muliple nodes, you will
          need a  REP.BAT file  for each  node. The only difference between
          the files  would be  the drive and directory designators, and the
          line that  calls up  the REPIMPRT  module. Each  node must  use a
          different configuration  file and  pass the  name of this file to
          the REPIMPRT module.

          Both QWK/REP modules can share the same configuation file.

          The QWK/REP modules are distributed in two ZIP files:

               QWKREP-S.ZIP - Single User
               QWKREP-M.ZIP - Multi User

          If you  are running  multi-nodes, you  MUST  use  the  multi-user
          modules.



          In Configuration  (GAPSETUP), on  the Main  Menu Commands screen,
          you enter the security level a user must have in order to use the
          QWK and  REP commands. Notice that these commands are internal to
          GAP and do not utilize your Sysop Defined commands.

          Do not configure the QWK/REP modules as Doors. In other words, do
          not place  them in  your DOORS.DAT  file and  do not list them on
          your Doors  Menu. If  you do so, the callers will not be prompted
          if they  actually do  wish to  invoke the  modules. Instead,  the
          doors system  will run the modules and without any prompting, the
          programs will immediately begin a QWK Export or REP Import.





                                       Page 5



          GAP Communications                             QWK/REP Sub-System


          The QWK  and REP commands belong on your Main Menu as part of the
          regular Main Commands.

          Both modules  can be  run in local mode. Simple log on to the BBS
          locally and issue the appropriate commands.

          When used  from remote, the modules expect that your SEND.BAT and
          RECV.BAT files will invoke a Zmodem Protocol program such as DSZ.
          Your copy of DSZ must be registered or your batch files will have
          to change  "into" the  work directory  that is  passed as the 4th
          parameter to the batch file, invoke the zmodem protocol, and then
          change back to the QWKREP directory.







































                                       Page 6