home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / q_asc110 / quickbbs.txt < prev    next >
Text File  |  1993-06-10  |  320KB  |  8,116 lines
  1.  
  2.  
  3.        ----           --         ---     ------  ------   ----
  4.       --  --                      --      --  --  --  -- --  --
  5.       --  -- --  --  ---   ----   --  --  --  --  --  -- ---
  6.       --  -- --  --   --  --  --  -- --   -----   -----   ---
  7.       --  -- --  --   --  --      ----    --  --  --  --    ---
  8.       -- --- --  --   --  --  --  -- --   --  --  --  -- --  --
  9.        ----   --- -- ----  ----  ---  -- ------  ------   ----
  10.           -
  11.                                                 ----   --------
  12.                                                --  --  -  --  -
  13.                                                ---        --
  14.                                                 ---       --
  15.                                                  ---      --
  16.                                                   ---     --
  17.                                                --  --     --
  18.                                                 ----     ----
  19.  
  20.                                 version 1.10
  21.  
  22.                       The Quick Bulletin Board System
  23.                            for Atari ST computers
  24.  
  25.                                      by
  26.  
  27.                            Jon Webb and Theo Runia
  28.                             
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.      The  QuickBBS ST package is Copyright (c) 1990-93 by Jon  Webb  and 
  51.      Theo  Runia.  It  is  in  no  way  connected  to  the  QuickBBS  PC 
  52.      version.  Read the license agreement for copyright information  and 
  53.      distribution rules.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.      -------------------------------------------------------------------
  62.      QuickBBS ST                                                  Page 1
  63.  
  64.  
  65.  
  66.  
  67.      QuickBBS ST                                                  Page 2
  68.      -------------------------------------------------------------------
  69.  
  70.      TABLE OF CONTENTS
  71.  
  72.      Section  1 : Introduction                     Page
  73.  
  74.        License Agreement .........................    5
  75.        Bug Reports, Questions, Ideas .............    8
  76.        Notices ...................................    8
  77.        Thank You .................................    9
  78.        Features ..................................    9
  79.        Overview ..................................   10
  80.        QuickStart ................................   10
  81.        Documentation .............................   10
  82.        Required Hardware .........................   11
  83.        Required Software .........................   11
  84.        Required Software for FidoNet .............   11
  85.        Recommended Setup .........................   12
  86.        First Time SysOps .........................   12
  87.        
  88.      Section  2 : Installation                     Page
  89.  
  90.        Unpacking the Archives ....................   13
  91.        Directory Structure .......................   14
  92.        Creating the System Files .................   15
  93.        Creating the User Base ....................   15
  94.        Creating a Configuration File .............   16
  95.        Installing 4KBUF ..........................   17
  96.        Requesting a Key ..........................   18
  97.        Running the BBS ...........................   18
  98.  
  99.      Section  3 : Configuration/Operation          Page
  100.  
  101.        More about QConfig ........................   20
  102.        Function Keys .............................   26
  103.        SysOp Keys ................................   27
  104.        Chatting & Yell Tunes .....................   28
  105.        The Status Bar ............................   29
  106.  
  107.      Section  4 : Users                            Page
  108.  
  109.        User Information ..........................   30
  110.        Packing the User Base .....................   32
  111.        The Limits File ...........................   32
  112.        The TrashCan File .........................   33
  113.        The Accounting system .....................   33
  114.  
  115.      Section  5 : Text & Graphics                  Page
  116.  
  117.        Text Files & Graphics Modes ...............   34
  118.        System Text Files .........................   35
  119.        Text File Control Codes ...................   37
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.      ------------------------------------------------------------------
  128.      QuickBBS ST                                                 Page 2
  129.  
  130.  
  131.  
  132.  
  133.      QuickBBS ST                                                 Page 3
  134.      ------------------------------------------------------------------
  135.  
  136.      Section  6 : Menus                            Page
  137.  
  138.        The Menu System ...........................   40
  139.        Menu Text .................................   41
  140.        Menu Structure ............................   41
  141.        The Menu Editor ...........................   42
  142.        Menu Option Types .........................   43
  143.        Menu Parameters ...........................   48
  144.        Automatic Menu Execution ..................   49
  145.        The Menu Optimiser ........................   49
  146.  
  147.      Section  7 : Messages                         Page
  148.  
  149.        The Message System ........................   50
  150.        Message Area Access .......................   51
  151.        The Language Check File ...................   51
  152.        The UpperCase Check .......................   51
  153.        Allow use of an alias .....................   52
  154.        Allow 8 bit characters ....................   52
  155.        File attached messages ....................   52
  156.        Group number ..............................   52
  157.        LastRead Pointers .........................   53
  158.        Packing the Message Base ..................   53
  159.        The Mail Area Lister ......................   53
  160.  
  161.      Section  8 : Files                            Page
  162.  
  163.        File Areas ................................   56
  164.        The File Search File ......................   57
  165.        The File Area Lister ......................   57
  166.        Transfer Protocols ........................   59
  167.        Uploads & Downloads .......................   60
  168.        Transfer Drivers ..........................   61
  169.        External Protocols ........................   61
  170.        The Online Archiver .......................   62
  171.        The File Browser ..........................   62
  172.        Mark File Menu ............................   63
  173.  
  174.      Section  9 : Doors                            Page
  175.  
  176.        External Programs .........................   64
  177.        DOR Files .................................   66
  178.        Exit With ErrorLevel ......................   71
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.      ------------------------------------------------------------------
  194.      QuickBBS ST                                                 Page 3
  195.  
  196.  
  197.  
  198.  
  199.      QuickBBS ST                                                 Page 3
  200.      ------------------------------------------------------------------
  201.  
  202.      Section 10 : FidoNet                          Page
  203.  
  204.        What is FidoNet? ..........................   72
  205.        Practical, please .........................   73
  206.        FidoNet Organisation ......................   74
  207.        NetWork Addresses .........................   75
  208.        Points ....................................   75
  209.        What's a Mailer? ..........................   76
  210.        Import and Export .........................   76
  211.        Installing the Mailer .....................   77
  212.        Compiling the NodeList ....................   78
  213.        Writing NetMail ...........................   79
  214.        Reading and Writing EchoMail ..............   79
  215.        Generating EchoMail .......................   79
  216.        Events and Routing ........................   80
  217.        Exporting Mail ............................   80
  218.        Importing Mail ............................   80
  219.        Archived Mail .............................   81
  220.        Batch Files and such ......................   81
  221.  
  222.      Section 11 : Appendices                       Page
  223.  
  224.        A - Jargon Guide ..........................   83
  225.        B - SysOp Keys ............................   97
  226.        C - Menu Options ..........................   98
  227.        D - System Text Files .....................   99
  228.        E - Text File Control Codes ...............  101
  229.        F - .DOR File Commands ....................  103
  230.        G - VT-52 Escape Codes ....................  104
  231.        H - Ansi-BBS Escape Codes .................  105
  232.        I - RS-232 Pins ...........................  110
  233.        J - FSE Interface .........................  111
  234.        K - External Chat Interface ...............  113
  235.        L - Available Utilities ...................  114
  236.        M - Errorlevels & Parameters ..............  116
  237.        N - Example Batch Files ...................  117
  238.        O - Bug Report Form .......................  123
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.      ------------------------------------------------------------------
  260.      QuickBBS ST                                                 Page 4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.      ==================================================================
  268.      =================== Section 1 : Introduction =====================
  269.      ==================================================================
  270.  
  271.      LICENSE AGREEMENT
  272.  
  273.      QuickBBS  ST  uses a key which can be requested from  the  Support 
  274.      BBS. There are two sorts of keys available:
  275.  
  276.      » A Demo key will operate for a period of 60 days.  No more than 4 
  277.        demo keys will be provided, and there must be at least one month 
  278.        between  the date on which one demo key expires and the date  on 
  279.        which the next demo key is requested.
  280.  
  281.      » A Full key can be bought from Theo Runia. Once you have bought a 
  282.        full  key  you are a registered owner of QuickBBS  ST  and  have 
  283.        unlimited  use  of  the program.  A full  key  costs  150  Dutch 
  284.        Guilders  (approx.  $80/£50)  and can be ordered  by  sending  a 
  285.        cheque  or postal order for the above amount,  made  payable  to 
  286.        Theo Runia to:
  287.  
  288.                Theo Runia
  289.                P.O. Box 1183
  290.                8900 CD Leeuwarden
  291.                The Netherlands
  292.  
  293.        Please  include  a note with your name,  phone  number  and  key 
  294.        number (which is displayed by QuickBBS when it checks your  demo 
  295.        key).
  296.      
  297.      Now  for  the  different  methods  of  payment,  in order of  
  298.      preference:
  299.  
  300.  
  301.      » By International Postal Money Order is quickest on our  end.
  302.        I just have to go to the post office to cash them.  A postal
  303.        money order can be sent from your local post office. This is
  304.        fast as I get them within a week, and a  full  key  will  be
  305.        ready at that day.
  306.  
  307.      » By EuroCheque is also fairly quick.  Because EuroCheques are 
  308.        guaranteed by the bank,  your full key will be available  as 
  309.        soon  as  the cheque arrives here.  Most banks  charge  very 
  310.        little for EuroCheques.
  311.  
  312.      » If you live in Europe and have access to a giro account, you 
  313.        can transfer the money directly to mine.  My  giro  bank  is 
  314.        called  Postbank  N.V. in Arnhem and  my account  number  is
  315.        2740040.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.      ------------------------------------------------------------------
  326.      QuickBBS ST                                                 Page 5
  327.  
  328.  
  329.  
  330.  
  331.      QuickBBS ST                                                 Page 6
  332.      ------------------------------------------------------------------
  333.  
  334.      » You can also transfer money via the SWIFT system. This is an
  335.        international money transfer system. Almost all banks should
  336.        have access to this. You should show the following  to  your
  337.        bank:
  338.  
  339.        Transfer 150 dutch guilders via the  SWIFT  transfer  system
  340.        to my bank, my bank is:
  341.  
  342.        Friesland bank
  343.        Zaailand 110
  344.        Leeuwarden
  345.        The Netherlands
  346.  
  347.        My account number there is 29.63.18.418  on the name of:
  348.        Theo Runia in Leeuwarden.
  349.  
  350.        The swiftcode for the Friesland bank is FRBKNL2L
  351.  
  352.        With this code it should be easy for a bank to transfer  the
  353.        money. But please mention your  keynumber,  it  make's  live
  354.        easier for me and you.
  355.  
  356.      » A bank cheque of your bank is possible  too.  It  should  be
  357.        drawn on a Dutch bank. But normally this is  the  case  with
  358.        bank cheques. The disadvantage is  that I  get  the  cheques
  359.        fast enough but I will have to wait 1-2  weeks  before  it's
  360.        cleared by the bank. But generally it's quite a good system.
  361.  
  362.  
  363.      If you have sent a cheque or postal order etc.  and your  demo 
  364.      key runs out, just post a message on the Support BBS or send a
  365.      netmail. In  general  we  will  make  an  extended  demo   key
  366.      available.
  367.  
  368.      We wil send a netmail via Fidonet if the key is ready,  so  do
  369.      supply your nodenumber. If you want the key on disc please say
  370.      so. This will however take longer.
  371.  
  372.      Any invalid cheques and postal orders will be returned to you, 
  373.      with a description of what was wrong.
  374.  
  375.      And please don't forget to mention your  keynumber, the number 
  376.      of users is so big that it is sometimes diffecult to find  out
  377.      who send the money.
  378.  
  379.      If  you  have experience with  international  money  transfers 
  380.      which  you think would be of use to others,  let me  know  and 
  381.      I'll include it in this file.
  382.  
  383.  
  384.      We  reserve the right to refuse any key request.  We also  reserve 
  385.      the right to withdraw your key,  even a full key,  if you  violate 
  386.      the distribution rules.
  387.  
  388.  
  389.  
  390.  
  391.      ------------------------------------------------------------------
  392.      QuickBBS ST                                                 Page 6
  393.  
  394.  
  395.  
  396.  
  397.      QuickBBS ST                                                 Page 7
  398.      ------------------------------------------------------------------
  399.  
  400.      The QuickBBS ST package may be made available for download as long 
  401.      as you stick to the following rules:
  402.  
  403.      » You may not distribute modified programs or documentation,
  404.      » You  may translate the documentation,  but the original  English 
  405.        version must be in the documentation archive,
  406.      » You may not distribute incomplete archives,
  407.      » You may not distribute the key,
  408.      » You  may not charge anything for the package other than  nominal 
  409.        copying cost or on-line fees.
  410.  
  411.      Violation of these rules will lead to the withdrawal of your key!
  412.  
  413.      You can also send 2 formatted discs together with 2  international 
  414.      reply coupons.  You will be send the latest version of QuickBBS ST 
  415.      and some nice utils. You can also request a demokey this way. Make 
  416.      very  sure you put on the disc a file or send a letter  with  your 
  417.      name and address on it and include the following:
  418.  
  419.      Sysop Name
  420.      BBS Name
  421.      Nodenumber
  422.  
  423.      This  way we can generate a demo key so you can start the BBS  the 
  424.      moment you recieve the discs back.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.      ------------------------------------------------------------------
  458.      QuickBBS ST                                                 Page 7
  459.  
  460.  
  461.  
  462.  
  463.      QuickBBS ST                                                 Page 8
  464.      ------------------------------------------------------------------
  465.  
  466.      BUG REPORTS, QUESTIONS, IDEAS, ETC.
  467.  
  468.      The best way to contact us is via the QuickBBS ST Support BBS:
  469.  
  470.           QuickBBS ST Leeuwarden
  471.           FidoNet 2:282/301, NeST 90:5/0
  472.           Holland +31-(0)58 - 153 849
  473.           300-14400 Bps, HST/V32bis
  474.           24 hours per day
  475.  
  476.      The  SysOp - Theo Runia - has been running QuickBBS ST ever  since 
  477.      the  first  version  was tested,  and can answer  just  about  any 
  478.      questions you care to ask. But don't forget he's doing all this in 
  479.      his spare time, and might be very busy doing something else.
  480.  
  481.      Another  way  of getting in touch is in the  QUICKBBS.ST  echomail 
  482.      area.  This  area  is  currently also linked into  the  NeST  area 
  483.      N.GATE.QBBS.ST and might be linked to other areas in the future.
  484.  
  485.  
  486.      
  487.      NOTICES
  488.  
  489.      We can not be held responsible for any damages which may occur due 
  490.      to  the  use  of QuickBBS ST  and/or  associated  programs  and/or 
  491.      documentation.  If you use the system, you do so at your own risk. 
  492.      QuickBBS ST is supplied as-is.  If it doesn't suite your needs I'm 
  493.      sorry.
  494.  
  495.      We am in no way connected to Adam Hudson,  the original author  of 
  496.      the PC version, other that he gave Jon webb the 'go ahead and try' 
  497.      signal.  QuickBBS ST was not ported, it was rewritten from scratch 
  498.      in GfA 3.0 and Turbo-C/ST.
  499.  
  500.      We  have  heard that Adam Hudson is no longer  developing  the  PC 
  501.      version,  and  has  sold the source.  We hope this will  speed  up 
  502.      implementation of new features in the PC version. In fact we think 
  503.      the  new developers have 'borrowed' a few of our ideas,  which  is 
  504.      fine by us.
  505.  
  506.      When the name QuickBBS is used in this documentation,  it  relates 
  507.      of course to the ST version, not the PC version. QuickBBS is often 
  508.      called 'QBBS' or 'Quick'.
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.      ------------------------------------------------------------------
  524.      QuickBBS ST                                                 Page 8
  525.  
  526.  
  527.  
  528.  
  529.      QuickBBS ST                                                 Page 9
  530.      ------------------------------------------------------------------
  531.  
  532.      THANK YOU
  533.  
  534.      A lot of people have assisted in the development of this  package, 
  535.      and it is impossible to list them all here.  However,  I'd like to 
  536.      express special thanks to ...
  537.  
  538.      » Theo  Runia,  the very first QuickBBS ST board and SysOp of  our 
  539.        Support BBS.  Theo has been very helpful,  coming up with ideas, 
  540.        (lots of) bug reports and doing an enormous amount of listening. 
  541.        From version 1.06 onwards Theo took over development.
  542.      » Jac Kersing, author of The-Box and Pandora, has spent many hours 
  543.        on the phone with me, at first when testing The-Box and Pandora, 
  544.        afterwards when technical problems arose during the  development 
  545.        of Quick.
  546.      » Iain  Summers,  for his help with all sorts of  bits-and-pieces, 
  547.        especially the internal Zmodem drivers,  and for putting up with 
  548.        me for a few days when I was over in the UK 8-).
  549.      » all the SysOps of our 'other' main beta sites,  Lasse  Eriksson, 
  550.        Jens Fischer,   Joop Koopman,  Kaj Lehtinen and Erno Meffert and 
  551.        Wilco Roos.
  552.  
  553.      FEATURES
  554.  
  555.      QuickBBS is a very powerful and flexible BBS system.  A few of the 
  556.      features which are implemented in the current version:
  557.  
  558.      » The complete menu system,  the menu text and the menu  structure 
  559.        are SysOp-configurable,
  560.      » Most of the other text the user sees is SysOp-configurable,
  561.      » Nearly  all  keys in the BBS are HotKeys,  that means  the  user 
  562.        doesn't  have to wait for the menu or to be completed,  he  just 
  563.        presses the key he wants,
  564.      » Up to 200 message areas, and an unlimited number of file areas,
  565.      » Fully  FidoNet  compatible,  linking your BBS  to  20000  others 
  566.        worldwide,
  567.      » Uploads and downloads with Xmodem,  Xmodem 1K,  Ymodem, Windowed 
  568.        Xmodem and Zmodem, and a powerfull external protocol interface,
  569.      » VT-52 Standard, Monochrome, Colour and Ansi graphics modes,
  570.      » New Mail pointers for each user in each area,
  571.      » Online Archiver with support for .ARC and .LZH archives,
  572.      » Language check, uppercase check and quoting in the line editor,
  573.      » Separate  front-end for Stand Alone mode includes terminal  with 
  574.        dialer, VT-52 and Ansi graphics, File Transfers etc.
  575.      » External programs can be started from within the BBS,  providing 
  576.        access to doorgames,  utilities and such. Most FoReM and Pandora 
  577.        doorgames can be run,
  578.      » Free updates,
  579.      » Lots, lots more...
  580.  
  581.  
  582.      As you can see,  no other BBS package on the ST offers so much for 
  583.      so little money. And best of all: QuickBBS is very fast, otherwise 
  584.      it wouldn't be called that, would it?
  585.  
  586.  
  587.  
  588.  
  589.      ------------------------------------------------------------------
  590.      QuickBBS ST                                                 Page 9
  591.  
  592.  
  593.  
  594.  
  595.      QuickBBS ST                                                Page 10
  596.      ------------------------------------------------------------------
  597.  
  598.      OVERVIEW
  599.  
  600.      QuickBBS  ST  is closely related to the The-Box system  which  was 
  601.      written  by Jac Kersing and Jan-Paul Middelink.  It does  not  use 
  602.      The-Box itself,  but it uses the same mail utilities,  due to  the 
  603.      fact  that  the  message base is  of  identical  format.  Nowadays 
  604.      Binkley ST is used more and more. Most mail utilities on the Atari 
  605.      now  use  this messagebase,  it's often referred to as  the  'QBBS 
  606.      format'.
  607.  
  608.      The QuickBBS package consists of the following files:
  609.  
  610.      » QINSTALL.PRG      Installation program
  611.      » QKEY.PRG          Key Requester
  612.      » QUICKBBS.PRG      The main program
  613.      » QSTART.PRG        QuickStart, for Stand Alone use
  614.      » QSTART.OVL        Overlay for QuickStart
  615.      » USEREDIT.PRG      The user editor
  616.      » MCONFIG.PRG       The message base configuration program
  617.      » QCONFIG.PRG       The general configuration program
  618.      » MENUEDIT.PRG      The menu editor, written by Theo Runia
  619.      » FASTPACK.PRG      The message base packer
  620.      » 4KBUF.PRG         Communications buffer program
  621.      » XFER.00?          Ymodem/Windowed Xmodem/Zmodem modules
  622.  
  623.      These  and other files have been placed in a number  of  archives, 
  624.      ready to be extracted by the installation program.
  625.  
  626.      QUICKSTART
  627.  
  628.      QuickStart  is a program which is run 'in front' of  QuickBBS.  It 
  629.      initialises the modem, answers the phone when a user calls etc. It 
  630.      also has a terminal with file transfer capabilities, Ansi graphics 
  631.      etc.  When  a  user  calls  QuickStart  will  start  up  QuickBBS. 
  632.      QuickStart has its own documentation file.
  633.  
  634.      DOCUMENTATION
  635.  
  636.      This  documentation  is available in ASCII or in First  Word  Plus 
  637.      format.  The  First Word Plus file has extension .DOC  (with  .GEM 
  638.      illustrations),  the  ASCII file has extension .TXT and  does  not 
  639.      contain  any  illustrations.  A  special print  program  is  being 
  640.      developed   to  print  out  the  First  Word  Plus  document   and 
  641.      illustrations.  The program can either print a plain ASCII version 
  642.      or - if you have GDOS (or G+Plus),  a printer driver and a printer 
  643.      font  - a version with pictures,  styles etc.  Of course  you  can 
  644.      print out the .DOC and .IMG files with First Word Plus.
  645.  
  646.      If,  after reading this documentation,  something is still unclear 
  647.      you could have a look at the QuickBBS PC documentation.  More help 
  648.      with FidoNet can be found in the Binkley ST manuals.
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.      ------------------------------------------------------------------
  656.      QuickBBS ST                                                Page 10
  657.  
  658.  
  659.  
  660.  
  661.      QuickBBS ST                                                Page 11
  662.      ------------------------------------------------------------------
  663.  
  664.      REQUIRED HARDWARE
  665.  
  666.      QuickBBS is currently being developed on an Atari 520 ST with  2.5 
  667.      Mb of ram and a SM-124 mono monitor, and lots of HD space (+/- 500 
  668.      Mb).  It  works  on  TOS 1.04,  but should work oke  on  most  TOS 
  669.      versions.  It also works with almost all HD drivers,  at least all 
  670.      the  ones  we tested.  We do recommend that you  install  a  cache 
  671.      program  to speed up HD acces,  the mailscan really benefits  from 
  672.      this.
  673.  
  674.      You need at least 1 megabyte of memory to run QuickBBS.
  675.  
  676.      It  might also be possible to run QuickBBS on a single  or  double 
  677.      drive  system,  but I doubt whether you'll have a nice time  doing 
  678.      so.  A harddisk should be used,  but there is no technical  reason 
  679.      why  it  couldn't  be done with less.
  680.  
  681.      As for a modem,  you will need a fairly Hayes-compatible one which 
  682.      is  capable  of  answering  the  phone,  monitoring  the  carrier, 
  683.      responding to DTR and switching to the correct baudrate. There are 
  684.      so  many modems out there that it is impossible to test  and  list 
  685.      them all.  The connection cable between the computer and the modem 
  686.      is very important.  It must have at least the Ground,  RX, TX, DTR 
  687.      and  CD  pins wired through.  Complete pinout information  can  be 
  688.      found in the appendix section. On highspeed modems (9600 and over) 
  689.      you must use the CTS and RTS lines. For this to work on your Atari 
  690.      you  must  install  a CTS fix program  in  your  autofolder,  e.g. 
  691.      HS_FIX,  TurboCts,  Serialfix etc. From TOS 2.06 onwards it should 
  692.      work without. But do enable RTS/CTS in your modem control panel.
  693.  
  694.      REQUIRED SOFTWARE
  695.  
  696.      You will need a text editor such as Micro Emacs or  Tempus.  First 
  697.      Word  in ASCII mode (WP Mode OFF) will do,  but I can't  recommend 
  698.      it.  For  creating screens a VT-52 and Ansi editor could  come  in 
  699.      handy.
  700.  
  701.      The  QuickBBS ST is in .ZIP format,  you need STZip to unpack  it, 
  702.      STzip is made by Vincent Pomey (hay vincent!).  But you might have 
  703.      to use some archivers like LHarc,  Arc, Unarj, Zoo, etc. to unpack 
  704.      all kinds of third party utilities.
  705.  
  706.      REQUIRED SOFTWARE FOR FIDONET
  707.  
  708.      If  you want to run QuickBBS as a FidoNet node,  you will  need  a 
  709.      mailer in addition to the software mentioned above.  At the moment 
  710.      there  are  two  mailers  available  for  the  ST:   The-Box   and 
  711.      Binkley/ST.  Both can be downloaded or requested from our  Support 
  712.      BBS.  You  will  also need a shell (often called  a  Command  Line 
  713.      Interpreter,  or CLI for short). PCommand is a good choice, but it 
  714.      doesn't  support command line parameters.  PCommand is  shareware. 
  715.      Another possibility is Gulam. This is a Unix-like shell, it should 
  716.      be  possible to use that.  A commercially available  shell  called 
  717.      Craft might work too. Whatever you choose, the shell must:
  718.  
  719.  
  720.  
  721.      ------------------------------------------------------------------
  722.      QuickBBS ST                                                Page 11
  723.  
  724.  
  725.  
  726.  
  727.      QuickBBS ST                                                Page 12
  728.      ------------------------------------------------------------------
  729.  
  730.      » Support batch files
  731.      » Support environment variables
  732.      » Support errorlevels
  733.      » If  possible,  accept  a batch file to execution passed  on  the 
  734.        command line.
  735.  
  736.      Try to get one that doesn't take up too much memory.  The examples 
  737.      given here are for PCommand.
  738.  
  739.      You  wil also need a mailtosser,  software to proces the  incoming 
  740.      and  outgoing  mailpackets.  There are quite a lot,  but  we  will 
  741.      mention some to give an idea:
  742.  
  743.      Bermuda,
  744.      Jetmail,
  745.      Marsmail,     
  746.      IOS,
  747.      
  748.  
  749.      RECOMMENDED SETUP
  750.  
  751.      The  usual  and  recommended setup for a  reasonable  QuickBBS  ST 
  752.      system is
  753.  
  754.      » Atari 1040 STf with either TOS 1.04 or higher
  755.      » Monochrome or Color monitor,
  756.      » Harddisk, we recommend to start at least at 30 Mb
  757.      » 2400 Bps or better a 14.400 Bps modem
  758.      » Battery-backed clock! Don't forget :-)
  759.  
  760.      20  or  30 Mb of hard disk space is enough to start  with,  but  a 
  761.      major BBS often has 60 or 100 Mb or more.  A second ST would  also 
  762.      come  in handy to be able to do some work without taking  the  BBS 
  763.      offline,  though it certainly isn't essential.  You could  connect 
  764.      that  up via one of the cheap Midi networks,  so you  can  preform 
  765.      some tasks and still keep the system online
  766.  
  767.      FIRST TIME SYSOPS
  768.  
  769.      This is not a communications tutorial. I assume you know how a BBS 
  770.      works  from the users point of view,  and have a  reasonable  idea 
  771.      what  a  SysOps job is.  If you haven't had much  experience  with 
  772.      using a BBS, spend some time calling other (Quick)BBS's first.
  773.  
  774.      Although  you won't need to do any programming  yourself,  I  will 
  775.      also assume you know a fair a bit about your computer.  Explaining 
  776.      everything  from  scratch would make this manual a  few  MegaBytes 
  777.      larger.  Again,  if  you don't know much about how your ST  works, 
  778.      wait a few months.
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.      ------------------------------------------------------------------
  788.      QuickBBS ST                                                Page 12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.      ==================================================================
  796.      ==================== Section 2 : Installation ====================
  797.      ==================================================================
  798.  
  799.      UNPACKING THE ARCHIVES
  800.  
  801.      The  very  first thing you must do is check your system  date  and 
  802.      time (if you don't have a built-in clock,  that is).  The date and 
  803.      time must always be correct when you run your BBS.  Strange things 
  804.      will happen if they are incorrect.
  805.  
  806.      QuickBBS is distributed as a set of three archives:
  807.  
  808.      » Q_DOC.ZIP    contains  the  First  Word  Plus  version  of   the 
  809.                     documentation,
  810.      » Q_ASC.ZIP    contains   the  no-frills  ASCII  version  of   the 
  811.                     documentation,
  812.      » QUICKBBS.ZIP contains the BBS system itself.
  813.  
  814.      To install QuickBBS you must have STZip 2.0 or higher to be able
  815.      to  unpack QuickBBS and it's docs.  STZip is copyright by  Vincent 
  816.      Pomey and is available at most Atari BBS's, if need be you can get 
  817.      it at our support BBS.
  818.  
  819.        If you have one disk drive:
  820.  
  821.        »  Place QUICKBBS.ZIP on a diskette,
  822.        »  Create   a  ramdisk  large  enough  to  hold  the  files   in 
  823.           QUICKBBS.ZIP, plus STZIP.PRG,
  824.        »  Place STZIP.PRG on the ramdisk,
  825.        »  Extract QUICKBBS.ZIP to the ramdisk,
  826.        »  Insert a blank, formatted diskette in your disk drive,
  827.        »  Start up 4KBUF.PRG from the ramdisk,
  828.        »  Start up QINSTALL.PRG from the ramdisk,
  829.        »  Choose Select Drive and enter drive A.
  830.  
  831.        If you have two disk drives:
  832.  
  833.        Either  follow the instructions for single disk  drive  systems, 
  834.        or...
  835.  
  836.        »  Place QUICKBBS.ZIP on a diskette in drive A,
  837.        »  Place STZIP.PRG on a diskette in drive B,
  838.        »  Extract QUICKBBS.ZIP to drive B,
  839.        »  Insert a blank, formatted diskette in drive A,
  840.        »  Start up 4KBUF.PRG from drive B,
  841.        »  Start up QINSTALL.PRG from drive B,
  842.        »  Choose Select Drive and enter drive A.
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.      ------------------------------------------------------------------
  854.      QuickBBS ST                                                Page 13
  855.  
  856.  
  857.  
  858.  
  859.      QuickBBS ST                                                Page 14
  860.      ------------------------------------------------------------------
  861.  
  862.        If you have a hard disk:
  863.  
  864.        »  Create a temporary directory,
  865.        »  Place STZIP.PRG and QUICKBBS.ZIP in that directory,
  866.        »  Extract  QUICKBBS.ZIP (after extracting this archive  you  no 
  867.           longer need it),
  868.        »  Start up 4KBUF.PRG,
  869.        »  Start up QINSTALL.PRG,
  870.        »  If  you  don't  want  to  install  the  BBS  on  the  current 
  871.           partition,  choose  Select Drive and enter the  partition  on 
  872.           which the BBS is to be installed.
  873.  
  874.      One of the files you just extracted and executed was 4KBUF.PRG. It 
  875.      must  be  placed in the AUTO folder of your boot  disk,  and  must 
  876.      always be installed when QuickBBS or QuickStart is run.
  877.  
  878.      DIRECTORY STRUCTURE
  879.  
  880.      The QInstall program can be used to create a runable demonstration 
  881.      system which should help you get started.  It sets up a  directory 
  882.      structure on the drive of your choice and unpacks all the archives 
  883.      into the correct directories.
  884.  
  885.      The first thing you should do,  if you haven't done it already, is 
  886.      to define on which drive or partition you want to install the BBS. 
  887.      Use the Select Drive option for this.  This doesn't mean you  must 
  888.      always run the BBS on this drive,  you can always change it  later 
  889.      if you change your mind.
  890.  
  891.      Now  you  must  create a directory  structure,  using  the  Create 
  892.      Directories  option.  You should not attempt to run QuickBBS  from 
  893.      the  root directory,  because root directories can't contain  more 
  894.      than 112 files. You won't notice this at first, but it might cause 
  895.      problems later.
  896.  
  897.      The directory structure QInstall creates looks like this:
  898.  
  899.           \QBBS                         home directory
  900.           \QBBS\CONF                    configuration directory
  901.           \QBBS\TEXT                    text file directory
  902.           \QBBS\MENUS                   menu file directory
  903.           \QBBS\MSGS                    message base directory
  904.           \QBBS\OARC                    online archiver directory
  905.           \QBBS\TUNES                   yelltune directory
  906.           \QBBS\DOWNLOAD                downloads:
  907.           \QBBS\DOWNLOAD\GENERAL        general download area
  908.           \QBBS\DOWNLOAD\UTILS          utility download area
  909.           \QBBS\DOWNLOAD\COMMS          communications download area
  910.           \QBBS\UPLOAD                  uploads:
  911.           \QBBS\UPLOAD\GENERAL          general upload area
  912.           \QBBS\UPLOAD\UTILS            utility upload area
  913.           \QBBS\UPLOAD\COMMS            communications upload area
  914.  
  915.      I've used some jargon here, but do not fear, all will be explained 
  916.      when  the time is right.  If you can't wait,  have a look  in  the 
  917.      Jargon Guide in the appendix section.
  918.  
  919.      ------------------------------------------------------------------
  920.      QuickBBS ST                                                Page 14
  921.  
  922.  
  923.  
  924.  
  925.      QuickBBS ST                                                Page 15
  926.      ------------------------------------------------------------------
  927.  
  928.      CREATING THE SYSTEM FILES
  929.  
  930.      So we've created the directory structure,  but everything is still 
  931.      empty.  Now  we  must  fill them up.  Remember  you  unpacked  the 
  932.      distribution archive QUICKBBS.ZIP?  Well,  you should now have the 
  933.      following files:
  934.  
  935.      » Q_PRG.ZIP         program files,
  936.      » Q_CFG.ZIP         configuration files,
  937.      » Q_MNU.ZIP         menu files,
  938.      » Q_TXT.ZIP         text files,
  939.      » Q_MUS.ZIP         yelltune files.
  940.  
  941.      These  archives are unpacked by QInstall.  Select the Write  Files 
  942.      option from the main menu.  
  943.  
  944.      QInstall will now unpack all these archives using STZip and  place 
  945.      the extracted files in the correct directories. When the unpacking 
  946.      is completed return to the main menu.
  947.  
  948.      CREATING A USER BASE
  949.  
  950.      The  next option you need to select is Run UserEdit.  This  option 
  951.      starts up the user edit program. The user file is called USERS.BBS 
  952.      and  is  located  in the home  directory.  It  contains  important 
  953.      information about each user.  UserEdit will tell you it can't find 
  954.      any LastRead pointers, and ask you whether they should be created. 
  955.      Just say Yes for now.
  956.  
  957.      The  very  first user in the user base must always be  you  -  the 
  958.      SysOp. To change this user record:
  959.  
  960.      » Press  Return and type in your name.  If your name  consists  of 
  961.        more  than two words you should use a dot to separate the  words 
  962.        (e.g. Alexis Carrington.Colby.Dexter). QuickBBS only accepts one 
  963.        space in a users name,
  964.      » Use Cursor Up and Cursor Down to move the highlighted bar to the 
  965.        password  field,  press  Return  and enter a  password  of  your 
  966.        choice,
  967.      » Move the bar to the Security Level field, press Return and enter 
  968.        500.
  969.      » Press Escape to save and exit.
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.      ------------------------------------------------------------------
  986.      QuickBBS ST                                                Page 15
  987.  
  988.  
  989.  
  990.  
  991.      QuickBBS ST                                                Page 16
  992.      ------------------------------------------------------------------
  993.  
  994.      CREATING A CONFIGURATION FILE
  995.  
  996.      QuickBBS  gets  most  of  its configuration  from  a  file  called 
  997.      QCONFIG.BBS,  located  in  the home directory.  This file  can  be 
  998.      created and edited with the configuration program QConfig.  Select 
  999.      the Run QConfig option from the main menu. You will see...
  1000.  
  1001.           1 ... Modem Parameters.
  1002.           2 ... System Paths, General Info.
  1003.           3 ... Restrictions.
  1004.           4 ... New user parameters
  1005.           5 ... NetMail Information, Screen Settings
  1006.           6 ... Toggles.
  1007.           7 ... Terminal, Stand Alone Mode.
  1008.           8 ... External Protocol interface
  1009.           9 ... Accounting system
  1010.  
  1011.      This is the QConfig main menu. For the moment there are only a few 
  1012.      settings which are of great importance.
  1013.  
  1014.      Choose option 1,  Modem Parameters.  In this screen you can define 
  1015.      what commands QuickBBS should send to your modem,  what speed your 
  1016.      modem works at etc.
  1017.  
  1018.      The first important setting is Max Baudrate.  Here you should fill 
  1019.      in the highest speed at which your modem can work.  If you have  a 
  1020.      highspeed modem (9600 and higher) you need to lock the modem at  a 
  1021.      certain speed. The Locked Baudrate is the baudrate the RS-232 will 
  1022.      always stay at. Mostly the value will be 19200 .
  1023.  
  1024.      Then  move  the  highlighted bar (with the cursor  keys)  to  Init 
  1025.      String.  This  is  the command which QuickStart will send  to  the 
  1026.      modem  when it starts up.  It should put the modem in  Auto-Answer 
  1027.      mode, which can usually be done with the command AT S0=1. It should 
  1028.      also make sure the modem tells us at what baudrate the  connection 
  1029.      is. Most modems accept AT X1 to do this.
  1030.  
  1031.      All  modem  command  strings  can  contain  a  number  of  special 
  1032.      characters. See the chapter on configuring QuickBBS for more info.
  1033.  
  1034.      A good init string which works with most modems is...
  1035.  
  1036.           AT Z|~AT X1 S0=1|
  1037.  
  1038.      Some modems need to be told that the carrier and DTR must be used. 
  1039.      This can often be accomplished with...
  1040.  
  1041.           AT &D1 &C1|
  1042.  
  1043.      The Reset String is the command which is sent to the modem  before 
  1044.      QuickStart exits. A good reset string is
  1045.  
  1046.           AT Z|~AT H1 S0=0|
  1047.  
  1048.  
  1049.  
  1050.  
  1051.      ------------------------------------------------------------------
  1052.      QuickBBS ST                                                Page 16
  1053.  
  1054.  
  1055.  
  1056.  
  1057.      QuickBBS ST                                                Page 17
  1058.      ------------------------------------------------------------------
  1059.  
  1060.      Init Response and Reset Response are the strings which your  modem 
  1061.      sends  back when it has successfully executed the init  and  reset 
  1062.      strings. A simple OK is generally enough.
  1063.                                                                        
  1064.      Now  press  Escape to return to the QConfig main menu  and  select 
  1065.      option  2,  System Paths,  General Info.  Another screen  will  be 
  1066.      displayed, and at the bottom you will see the two lines we need to 
  1067.      edit...
  1068.  
  1069.           SysOp Name..........
  1070.           System Name.........
  1071.  
  1072.      Use the cursor keys to move the highlighted bar to SysOp Name  and 
  1073.      type  in the name you just entered in the user  editor.  The  name 
  1074.      entered  here  must  be exactly the same as entered  in  the  user 
  1075.      editor, otherwise QuickBBS will not run.
  1076.  
  1077.      Now  move  the bar to System Name and type the name of  your  BBS. 
  1078.      Then press Escape to return to QConfigs main menu.
  1079.  
  1080.      Select option 5,  NetMail Information, Screen Settings. At the top 
  1081.      of the screen you will see...
  1082.  
  1083.           Zone Number ...........
  1084.           Net Number ............
  1085.           Node Number ...........
  1086.  
  1087.      If your BBS is a Stand-Alone BBS,  enter zeroes as Zone,  Net  and 
  1088.      Node  numbers.  If  you  already have a FidoNet  or  other  (NeST, 
  1089.      AtariNet etc.) address,  enter it here.  If you don't know what  a 
  1090.      FidoNet address is,  just enter zeroes.  Press Escape to return to 
  1091.      QConfigs main menu and Escape again to save the configuration  and 
  1092.      return to QInstall.  If you have several nodenumbers then only use 
  1093.      the main number, in most cases your FidoNet number.
  1094.  
  1095.  
  1096.      INSTALLING 4KBUF
  1097.  
  1098.      You must make sure that 4KBUF.PRG is in your autofolder, reset the 
  1099.      system first so this is active. Both the keysystem and QuickBBS ST 
  1100.      need this little buffer to be active
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.      ------------------------------------------------------------------
  1118.      QuickBBS ST                                                Page 17
  1119.  
  1120.  
  1121.  
  1122.  
  1123.      QuickBBS ST                                                Page 18
  1124.      ------------------------------------------------------------------
  1125.  
  1126.      REQUESTING A KEY
  1127.  
  1128.      You  can test and run QuickBBS locally without the need of a  key, 
  1129.      if you want to allow users to login you must have a key,  either a 
  1130.      demo or full key.
  1131.  
  1132.      To get a (demo) key select Run QKey from the QInstall  menu.  QKey 
  1133.      is the program which can be used to request a key from our Support 
  1134.      BBS.  The  key  is a small file which must be placed in  the  home 
  1135.      directory.
  1136.  
  1137.      For  people who live outside Holland:  requesting a key  from  the 
  1138.      Support  BBS should only take about a minute,  so it doesn't  cost 
  1139.      much.  But you can also request a key via the mail,  read the part 
  1140.      about paying for the key.
  1141.  
  1142.      QKey  will  ask you a few questions.  We would like to  know  some 
  1143.      things like your voice & BBS phone numbers, postal address etc. so 
  1144.      we  can  contact you if needed.  Please fill in  this  information 
  1145.      truthfully. It will - of course - be kept secret.
  1146.  
  1147.      At  this point you must also confirm that the information  entered 
  1148.      in  QConfig  and UserEdit is correct.  The key will  contain  this 
  1149.      information.  If  the  information in the key  doesn't  match  the 
  1150.      configuration,  QuickBBS  will  not run.  This means that  if  you 
  1151.      change  -  say  - your BBS name you will have  to  request  a  new 
  1152.      key.
  1153.  
  1154.      QKey has a little terminal built in. Set the correct baudrate (the 
  1155.      Support BBS runs at all speeds ),  and dial the number. As soon as 
  1156.      QKey detects a carrier it will take over.  If you use a  highspeed 
  1157.      modem  (9600 and higher) set the baudrate to the locked  baudrate, 
  1158.      mostly 19200. Otherwise it won't work.
  1159.      
  1160.      If you can't get a good connect try to disable HST, use V32bis, or 
  1161.      disable MNP-5. And very sure that 4KBUF.PRG is active!
  1162.  
  1163.      So now you should have your own,  personal demo key.  It should be 
  1164.      called QUICKBBS.KEY and placed in the home directory (QKey will do 
  1165.      this for you).
  1166.  
  1167.      RUNNING THE BBS
  1168.  
  1169.      It's about time we had a look inside the BBS by now!  Quit to  the 
  1170.      DeskTop  and start up QSTART.PRG.  When it's finished loading  you 
  1171.      will see the QuickStart screen. Your modem will be initialised and 
  1172.      QuickStart  will  wait for the first caller.  Press L  (Local)  to 
  1173.      start  up the BBS.  QuickStart will reset your modem  and  execute 
  1174.      QUICKBBS.PRG, the actual BBS program.
  1175.  
  1176.      You  can also start QuickBBS via a commandline  interpreter  (like 
  1177.      Pcommand). To logg in locally you must enter: quickbbs -l
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.      ------------------------------------------------------------------
  1184.      QuickBBS ST                                                Page 18
  1185.  
  1186.  
  1187.  
  1188.  
  1189.      QuickBBS ST                                                Page 19
  1190.      ------------------------------------------------------------------
  1191.  
  1192.      Quick  will read the configuration files and check your  key.  And 
  1193.      then you can finally type in your name!  Play around with the demo 
  1194.      system  for  a bit to find out what it looks like from  the  users 
  1195.      point of view.
  1196.  
  1197.      When  you've  had  enough,  log off and have a  look  at  the file 
  1198.      SYSTEM.LOG  in  the home directory.  This file contains  all major 
  1199.      actions,   possible   error  messages  and  bits   of  interesting 
  1200.      information.  It  will grow and grow until you delete it.  Any new 
  1201.      users that log in will be recorded in the file NEWUSER.LOG.
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.      ------------------------------------------------------------------
  1250.      QuickBBS ST                                                Page 19
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.      ==================================================================
  1258.      =========== Section 3 : Configuration / Operation ================
  1259.      ==================================================================
  1260.  
  1261.      MORE ABOUT QCONFIG
  1262.  
  1263.      Well,  what do you think of the demonstration system?  Please keep 
  1264.      in  mind that it is precisely that.  It doesn't make use  of  many 
  1265.      advanced  features  of  QuickBBS.  Of  course  you  will  want  to 
  1266.      customise  your BBS,  develop your own 'look & feel'.  To do  that 
  1267.      we'll  have to explain some more about the  configuration  program 
  1268.      QConfig first.
  1269.  
  1270.      » The  Modem Parameters screen contains most of the modem  control 
  1271.        information as used by QuickStart.
  1272.  
  1273.        »» Max Baudrate is the maximum speed at which your modem  works. 
  1274.           QuickStart can only operate at speeds of up to 2400  bps.  If 
  1275.           your  modem  is faster than 2400 bps you will have to  use  a 
  1276.           mailer as front-end.
  1277.        »» Locked Baudrate is the baudrate at wich the serial port is
  1278.           locked. You need this with  modems  that  are  9600  Bps   or
  1279.           higher. Normally  You set this to 19200.  And  always  use  a
  1280.           CTS/RTS fix  in your  autofolder as TOS <2.06 doesn't support
  1281.           CTS/RTS.  You  could use  TurboCTS,  HS-Fix,  Serialfix  etc.
  1282.           for this task. 
  1283.        »» Max Init Tries is the maximum number of times QuickStart  may 
  1284.           try  to  initialise/reset your modem.  If the  modem  doesn't 
  1285.           respond  correctly  after  the  maximum  number  of   retries 
  1286.           QuickStart will abort.
  1287.        »» Connect Delay (Seconds) is the maximum time between detection 
  1288.           of  a  ring and receiving a Connect.  Used in  manual  answer 
  1289.           mode.
  1290.        »» Answer Delay (Seconds) is the delay between detecting a  ring 
  1291.           and sending the answer string. Used in manual answer mode.
  1292.        »» Init  String  is a command which is sent to  the  modem  when 
  1293.           QuickStart starts up. If you are not using manual answer mode 
  1294.           it should make the modem auto-answer. All command strings can 
  1295.           contain these special characters:
  1296.  
  1297.                |    Sends a carriage return,
  1298.                ~    Waits  half  a  second  before  sending  the   next 
  1299.                     character of the command,
  1300.                !    Sends  a carriage return and waits for  a  response 
  1301.                     from the modem,
  1302.                ^    Raises DTR,
  1303.                v    Lowers DTR.
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.      ------------------------------------------------------------------
  1316.      QuickBBS ST                                                Page 20
  1317.  
  1318.  
  1319.  
  1320.  
  1321.      QuickBBS ST                                                Page 21
  1322.      ------------------------------------------------------------------
  1323.  
  1324.        »» Reset String is sent to the modem when the BBS goes  off-line 
  1325.           (e.g. when QuickStart exits or starts a utility).
  1326.        »» Answer String is used in manual answer mode.  QuickStart will 
  1327.           look for the Ring Detection string and check the RING pin  on 
  1328.           the RS-232 interface. When it notices the phone is ringing it 
  1329.           will  send  the  Answer String to the modem and  wait  for  a 
  1330.           Connect string.  To use the manual answer mode you must  also 
  1331.           change a setting in the 'Toggles' screen of QConfig.
  1332.        »» Ring Detection is the string your modem sends when the  phone 
  1333.           is ringing, used in manual answer mode.
  1334.        »» Init  Response  is  the  string  your  modem  sends  when  it 
  1335.           successfully received the Init String.  If this string is not 
  1336.           received from the modem QuickStart will try to initialise the 
  1337.           modem again.
  1338.        »» Reset Response is the same as the Init Response,  but now for 
  1339.           the Reset String.
  1340.  
  1341.      » System Paths,  General Info is where you define what directories 
  1342.        should be used by QuickBBS to access the system files.
  1343.  
  1344.        »» Menu Path is the path leading to your Menu files,
  1345.        »» Textfile Path is the path leading to your Text files,
  1346.        »» Message Path is the path leading to your Message Base files,
  1347.        »» OARC  Path  should  point to a scratch  directory  which  the 
  1348.           Online  Archiver can use.  This directory should be  reserved 
  1349.           for the Online Archiver only.
  1350.        »» Shell  Program is the program which is started when  you  use 
  1351.           the Alt-J key (Jump to DOS) in QuickStart and QuickBBS.  This 
  1352.           can be any program you like,  but a command line  interpreter 
  1353.           would  be  an  obvious choice.  If you  want  you  could  put 
  1354.           something like NeoDesk in here.
  1355.        »» External  Chat can point to a chat program which is  executed 
  1356.           by  QuickBBS  when  a user yells for  you.  If  this  program 
  1357.           doesn't exist,  or if this field is left blank,  the internal 
  1358.           chat is used.
  1359.        »» FSE Program points to a Full Screen Editor which is  executed 
  1360.           by QuickBBS when a user writes a message. At the moment there 
  1361.           is no such program, so leave this blank.
  1362.        »» Nodelist  Path is for FidoNet nodes.  It should point to  the 
  1363.           directory  which  contains  your  nodelist,  translated  with 
  1364.           XLTLST, ParslST or BTNC.
  1365.        »» SysOp Name is your name.  If a user writes a message to SysOp 
  1366.           this  name  will  automatically  be  substituted.  It  should 
  1367.           correspond  exactly  to  the name of the first  user  in  the 
  1368.           userbase, and to the name contained in the key.
  1369.        »» System Name is the name which you have given your  BBS.  This 
  1370.           can't be changed without requesting a new key.
  1371.        »» Leave message in chat on board is the board number in mconfig 
  1372.           that  a  user can leave a message in  after  an  unsuccesfull 
  1373.           yell.
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.      ------------------------------------------------------------------
  1382.      QuickBBS ST                                                Page 21
  1383.  
  1384.  
  1385.  
  1386.  
  1387.      QuickBBS ST                                                Page 22
  1388.      ------------------------------------------------------------------
  1389.  
  1390.      » The Restrictions, screen lets you define certain restrictions.
  1391.  
  1392.        »» Start  300 Baud Access (HH:MM) and End 300 Baud  Access:  You 
  1393.           can  define a certain period of time in which 300 Baud  users 
  1394.           are  allowed on your BBS.  If a 300 Baud user  calls  outside 
  1395.           this period he will not be allowed in. If you don't want such 
  1396.           a  restriction,  enter 00:00 as start time and 24:00  as  end 
  1397.           time.
  1398.        »» Start Download Hours and End Download Hours:  Users are  only 
  1399.           allowed  to  download between these times.  Enter  00:00  and 
  1400.           24:00 to allow users to download at any time of day.
  1401.        »» Start  Paging  Hours and End Paging  Hours:  Users  are  only 
  1402.           allowed to yell for you between these times.  Enter 00:00 and 
  1403.           24:00 to enable yelling at all times.
  1404.        »» Minimum  Baudrate to Logon:  if a user tries to log into  the 
  1405.           BBS  at  a  slower  baudrate than this  setting  he  will  be 
  1406.           refused.
  1407.        »» Minimum  Baudrate for Graphics:  users with slower  baudrates 
  1408.           than  this setting will not be allowed to choose  a  graphics 
  1409.           mode other than ASCII.
  1410.        »» Minimum Baudrate for Xfer:  users with slower baudrates  than 
  1411.           this  setting will not be allowed to upload  and/or  download 
  1412.           files.
  1413.        »» Max OARC Size (Kb) is the maximum size an Online Archive  may 
  1414.           be.  This  is  the  size of the archive,  not  of  the  files 
  1415.           contained  in the archive,  in KiloBytes.  Enter zero if  you 
  1416.           want  QuickBBS to use all available disk space minus a  small 
  1417.           safety buffer.
  1418.        »» TimeOut  (seconds) defines how long the user may remain  idle 
  1419.           (i.e.  not type anything) before QuickBBS decides he's fallen 
  1420.           asleep and logs him off.  This should be at least 30 seconds, 
  1421.           because QuickBBS sends a message warning the user 30  seconds 
  1422.           before this time limit expires.
  1423.        »» Default Logon Time (minutes) defines how many minutes per day 
  1424.           a  user may use the BBS.  The file LIMITS.CTL overrides  this 
  1425.           setting,  but  it  can be used to set the number  of  minutes 
  1426.           available  for  new  users before  they  have  completed  the 
  1427.           registration sequence.
  1428.        »» Password Tries: if a user types his password wrong more times 
  1429.           than this value he will be disconnected.
  1430.        »» Maximum Pages defines the maximum number of times a user  may 
  1431.           yell for you per call.
  1432.        »» Page Tune Length (seconds) is the length of the yell tune  or 
  1433.           beep.
  1434.  
  1435.      » The  New user settings,  screen lets you defime what  level  and 
  1436.        flags a new user gets.
  1437.  
  1438.        »» New User Security:  The security level which is given to  new 
  1439.           users.  Must be between 1 and 32000. See the section on Users 
  1440.           for more information.
  1441.        »» New User Flags:  Flags which are given to new users.  See the 
  1442.           section on Users for more information.
  1443.        »» New  User  Credit  (cents) is used  for  FidoNet  nodes,  and 
  1444.           defines  how  much NetMail credit a new user  gets.  See  the 
  1445.           section on FidoNet for more information.
  1446.  
  1447.      ------------------------------------------------------------------
  1448.      QuickBBS ST                                                Page 22
  1449.  
  1450.  
  1451.  
  1452.  
  1453.      QuickBBS ST                                                Page 23
  1454.      ------------------------------------------------------------------
  1455.  
  1456.      » In NetMail Information,  Screen Settings you define your FidoNet 
  1457.        address, screen colours etc.
  1458.  
  1459.        »» With  Zone  Number,  Net  Number and  Node  Number  you  tell 
  1460.           QuickBBS what your FidoNet address is.  Refer to the  section 
  1461.           on  FidoNet  for more information.  Point Number is  not  yet 
  1462.           supported.
  1463.        »» Fake Net Number, some older mailer software still uses a Fake 
  1464.           Net  for  it's  points.  QuickBBS can readress  mail  in  the 
  1465.           netmail area so it doesn't show this Fake Net and uses a full 
  1466.           4D point address.
  1467.        »» Allow  Reply to Unlisted Nodes Will allow users to  reply  to 
  1468.           messages  originating  from  a  node  which  is  not  in  our 
  1469.           NodeList.
  1470.        »» Use  netmail Credits allows you to charge a user for the  use 
  1471.           of netmail.  This will only work with the The Box and Version 
  1472.           6  Binkley  ST nodelist.  It doesn't work with the  new  BTNC 
  1473.           nodelist format.
  1474.        »» Status Line Character Colour is the colour of the text in the 
  1475.           status bar at the bottom of the screen. For colour monitors I 
  1476.           recommend 3, for monochrome systems try 0.
  1477.        »» Status Line Background Colour is the colour of the status bar 
  1478.           itself.  If you use a colour monitor try 2,  for a monochrome 
  1479.           monitor try 1.
  1480.        »» Colour 0,  1, 2 and 3 are the RGB colours on a colour monitor 
  1481.           and  allow  you  to reverse the  'colours'  on  a  monochrome 
  1482.           monitor. Try 000, 700, 007 and 777.
  1483.        »» Screen  Saver  Delay  (seconds) is the length  of  the  delay 
  1484.           before QuickStart's screen saver blanks the screen.  As  soon 
  1485.           as  any  activity  is detected QuickStart  will  restore  the 
  1486.           screen.
  1487.  
  1488.      » In the Toggles screen you can switch all sorts of things on  and 
  1489.        off...
  1490.  
  1491.        »» ^E  at  Logon:   Quite  a  few  communications  programs  can 
  1492.           automatically send a name and a password when a ^E  (Control-
  1493.           E,  ASCII  5)  character is received.  When  this  option  is 
  1494.           switched  on  QuickBBS will send a ^E when it  asks  for  the 
  1495.           users name.
  1496.        »» Fast Logon Locally: if this option is switched on Quick won't 
  1497.           ask for a user name when you log in locally.  Instead it will 
  1498.           just  take the first user in the userbase,  which  should  of 
  1499.           course be you.
  1500.        »» Ask  for  Pwd  Locally:  when this is on  you  must  enter  a 
  1501.           password  when  you log in locally,  even if  Fast  Logon  is 
  1502.           switched on.
  1503.        »» Use LastRead Pointers: currently unused. Always used
  1504.        »» Exit  for Net/Echo:  QuickBBS exist with an errorlevel  after 
  1505.           mail has been entered
  1506.        »» Check for Mail:  by switching on this toggle you activate the 
  1507.           MailScan  when  a user logs in.  QuickBBS will  look  in  the 
  1508.           message  base  to see whether there is any mail  waiting  for 
  1509.           this user. The MailScan can be aborted by pressing Space.
  1510.  
  1511.  
  1512.  
  1513.      ------------------------------------------------------------------
  1514.      QuickBBS ST                                                Page 23
  1515.  
  1516.  
  1517.  
  1518.  
  1519.      QuickBBS ST                                                Page 24
  1520.      ------------------------------------------------------------------
  1521.  
  1522.        »» Ask  Voice Phone and Ask Data Phone will make Quick  ask  new 
  1523.           users for their voice and data phone numbers.
  1524.        »» When Ask New Users Graphics is switched on new users will  be 
  1525.           asked which Graphics Mode they would like to use.  If this is 
  1526.           switched off they will get plain ASCII text.
  1527.        »» By switching off Use Xmodem,  Xmodem-1K, Ymodem, WXmodem, and 
  1528.           Zmodem  you  can  disallow the use of  any  of  the  internal 
  1529.           protocols, both for Uploading and for Downloading.
  1530.        »» Allow  Batch  Uploads  can  be  used  to  disallow  Uploading 
  1531.           multiple files at once with Ymodem and Zmodem.
  1532.        »» With Touch Uploads you can choose whether you want to set the 
  1533.           date and time stamp of uploaded files to the current date and 
  1534.           time. Files uploaded with non-batch protocols always have the 
  1535.           current date and time.
  1536.        »» Use Download Counters will let QuickBBS update the number  of 
  1537.           times a file is download. It will put a [xx] at the beginning 
  1538.           of the file description in the FILES.BBS.
  1539.        »» Enforce  Language can be used to stop users writing  messages 
  1540.           in your local language in international EchoMail areas (where 
  1541.           messages should be in English).  See the section on  Messages 
  1542.           for more info.
  1543.        »» When  Enforce Lower Case is switched on each message  entered 
  1544.           is  checked  for  lowercase characters.  If  the  message  is 
  1545.           entirely  in uppercase the user will not be allowed  to  save 
  1546.           it.
  1547.        »» By  switching  Allow Quoting on you allow users  to  use  the 
  1548.           reply-quoting feature of the message editor.
  1549.        »» Save Combined Boards is not implemented.
  1550.        »» When  Use Manual Answer is switched on QuickStart  will  wait 
  1551.           for the phone to ring and then send the Answer  String.  When 
  1552.           this option is switched off QuickStart will assume the  modem 
  1553.           answers  the phone by itself,  and just waits for  a  Connect 
  1554.           string.
  1555.        »» Use Yelltunes switches the yell tunes on and  off.  Depending 
  1556.           on a users name or security level you can get Quick to  sound 
  1557.           a  different tune when the user yells for you.  When this  is 
  1558.           switched  off you will just hear a beep.  See the section  on 
  1559.           Chatting for more information.
  1560.        »» Use  External  Xmodem:  QuickBBS has two versions  of  Xmodem 
  1561.           available.  One is built-in,  the other is a separate driver, 
  1562.           XFER.000.  When  this  option is switched  off  the  internal 
  1563.           Xmodem is used.  Try it out, and if you have problems use the 
  1564.           external one.  NOTE:  XFER.000 is still needed for Ymodem and 
  1565.           Windowed Xmodem transfers!
  1566.        »» Allow  VT-52 Monochrome:  Switch this off if you  don't  want 
  1567.           your users in VT-52 Mono graphics mode.
  1568.        »» Allow VT-52 Colour: Same as above, but for VT-52 Colour.
  1569.        »» Allow VT-52 Standard:  Same as above,  now for the  no-frills 
  1570.           Standard VT-52 mode.
  1571.        »» Allow Ansi: Again, for Ansi graphics mode.
  1572.        »» Use PC font for Ansi:  by switching this on QuickBBS will use 
  1573.           a PC-style font when Ansi Graphics are active, so you can use 
  1574.           the  nice box characters etc.  This font doesn't show if  you 
  1575.           have an old (pre-1.6) version of TurboST installed.
  1576.  
  1577.  
  1578.  
  1579.      ------------------------------------------------------------------
  1580.      QuickBBS ST                                                Page 24
  1581.  
  1582.  
  1583.  
  1584.  
  1585.      QuickBBS ST                                                Page 25
  1586.      ------------------------------------------------------------------
  1587.  
  1588.        »» Allow Optimiser:  if you want to allow your users to use  the 
  1589.           Menu Optimiser,  switch this on. See the section on Menus for 
  1590.           more info.
  1591.        »» Translate  [x]  to <x>:  In some Scandinavian  countries  the 
  1592.           square brackets are used for their local character set.  When 
  1593.           this  option is switched on the system menus will use  angled 
  1594.           brackets instead of square ones.
  1595.        »» Fun mode in chat,  if switched on your chats can become  very 
  1596.           exiting. Just have a try.
  1597.        »» Logoff after transfers,  will ask a user before a download if 
  1598.           he wants to be logged off directly after the transfer.
  1599.        »» Allow  message  uploads,  a user can now  upload  a  prepared 
  1600.           message text. So he hasn't type it all in online.
  1601.  
  1602.      » With  Terminal,  Stand-Alone  mode you can control some  of  the 
  1603.        features  and  defaults  in  QuickStart.   These  settings   are 
  1604.        described in the QuickStart documentation.
  1605.  
  1606.      » In the External Protocols screen you can program QuickBBS on how 
  1607.        to use the external protocols. For more info read the section on 
  1608.        external protocols.
  1609.  
  1610.        »» Number  on/off switches the protocol on or off.  Be  carefull 
  1611.           that  if you use a protocol that already is used in  QuickBBS 
  1612.           you disable this in the toggle screen. 
  1613.        »» Name,  is the name of the protocol,  this is used when asking 
  1614.           the user which protocol to use. 
  1615.        »» Key,  is the key a user has to press to select this protocol. 
  1616.        »» Full  Duplex,  enable  this for protocols that  can  up-  and 
  1617.           download at the same time.  Currently only Jekyll (great) can 
  1618.           do this. With Jekyll you can up- and download and chat at the 
  1619.           same time.  This option makes sure that QuickBBS always scans 
  1620.           for uploaded files after a transfer.
  1621.        »» Door file,  every external protocol must have a .DOR file  in 
  1622.           where  path's and commandline etc.  are programmed.  See  the 
  1623.           section  about External protocols for this.  For example  you 
  1624.           can use something like JEKYLL,  QuickBBS then uses JEKYLL.DOR 
  1625.           for Jekyll. 
  1626.        »» Logfile ID,  is used to identify a protocol in the upload- or 
  1627.           download.log. It must be 2 characters. For example Z-Modem is 
  1628.           ZM, Jekyll JK etc. etc. 
  1629.        »» Batch files, enable this for protocols that can transfer more 
  1630.           then one file at a time,  like Z-Modem/Y-Modem/Jekyll etc. Do 
  1631.           not enable this for X-Modem/X-Modem 1k.
  1632.        »» F-Path,  Full path,  enable if a protocol always needs a full 
  1633.           path.  Mostly you can specify a path and filename seperately, 
  1634.           so in most cases it's off.
  1635.  
  1636.      » With  Terminal,  Stand-Alone  mode you can control some  of  the 
  1637.        features  and  defaults  in  QuickStart.   These  settings   are 
  1638.        described in the QuickStart documentation.
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.      ------------------------------------------------------------------
  1646.      QuickBBS ST                                                Page 25
  1647.  
  1648.  
  1649.  
  1650.  
  1651.      QuickBBS ST                                                Page 26
  1652.      ------------------------------------------------------------------
  1653.  
  1654.      » Accounting  system,  here  you  can define on  how  to  use  the 
  1655.        accounting system. See the accounting section for mroe info. 
  1656.  
  1657.        »» Download  - per Kb,  determines how many points are added  or 
  1658.           subtracted for every download KiloByte.  The number of points 
  1659.           can be negative or positive.
  1660.        »» Download - per file, de termines how many points are added or 
  1661.           subtracted for every file download. Same as per Kb
  1662.        »» Upload - per Kb,  same as download except it's for uploads.
  1663.        »» Upload - per file,  same as download except it's for uploads.
  1664.        »» Connect - per call,  number of points given each time a  user 
  1665.           calls.
  1666.        »» Connect - per minute,  number of points given for each minute 
  1667.           a user has been online.
  1668.        »» Read - per message,  number of points given for each  message 
  1669.           a user has read.
  1670.        »» Post - per message,  number of points given for each  message 
  1671.           a user has posted (entered).
  1672.        »» Maximum  points,  is the maximum number of points a user  can 
  1673.           get, the abslute maximum is +32767
  1674.        »» Minimum  points,  is the  lowest number of points a user  can 
  1675.           get, the abslute minimum is -32767
  1676.        »» New user points,  is the  number of points a new user gets. 
  1677.  
  1678.      
  1679.      FUNCTION KEYS
  1680.  
  1681.      You  can  create  a number of files in  your  CONF\  configuration 
  1682.      directory which assign strings to the function keys. QuickBBS will 
  1683.      load  different function key files in different parts of the  BBS. 
  1684.      There are files for chat mode, the message editor etc.
  1685.  
  1686.      Each  line  in the function key files should start with  a  number 
  1687.      between 1 and 20, followed by a column (:) and the string you wish 
  1688.      to  assign.  A  vertical bar (|) will be replaced  by  a  Carriage 
  1689.      Return and a Line Feed. The files are...
  1690.  
  1691.      » FUNCKEYS.BBS      loaded when a user is on-line,
  1692.      » LOCLKEYS.BBS      loaded in local mode,
  1693.      » CHATKEYS.BBS      loaded in chat mode,
  1694.      » EDITKEYS.BBS      loaded in the message editor,
  1695.      » DOSKEYS. BBS      loaded when you jump to DOS,
  1696.      » TERMKEYS.BBS      loaded in terminal mode in QuickStart,
  1697.      » WAITKEYS.BBS      loaded in unattended mode in QuickStart.
  1698.  
  1699.      The  WaitKeys file doesn't assign a string to the  function  keys. 
  1700.      Instead  it defines programs to start up when the key is  pressed. 
  1701.      See  the  QuickStart documentation.  A ChatKeys  file  might  look 
  1702.      something like...
  1703.  
  1704.           1:Just a sec...|
  1705.           2:You called?|
  1706.  
  1707.      When  you press f1 the text "Just a sec..." is sent to  the  user, 
  1708.      followed  by a Carriage Return and Line Feed (CRLF).  Each  string 
  1709.      may be up to 30 characters long. It may include tab characters.
  1710.  
  1711.      ------------------------------------------------------------------
  1712.      QuickBBS ST                                                Page 26
  1713.  
  1714.  
  1715.  
  1716.  
  1717.      QuickBBS ST                                                Page 27
  1718.      ------------------------------------------------------------------
  1719.  
  1720.      SYSOP KEYS
  1721.  
  1722.      While  a user is online QuickBBS allows you to modify some of  his 
  1723.      parameters  and do some other nice things by pressing one  of  the 
  1724.      Sysop Keys.
  1725.  
  1726.      » Help         shows you a brief list of the available SysOp  keys 
  1727.                     in  the  status  bar.   The  user  doesn't   notice 
  1728.                     anything.
  1729.      » Clr/Home     updates the status bar and/or restores it to normal 
  1730.                     after  pressing  Help.   The  user  doesn't  notice 
  1731.                     anything.
  1732.      » Cursor Up    increases  the users time limit by 5  minutes.  The 
  1733.                     user  doesn't notice anything except that he has  5 
  1734.                     minutes more.
  1735.      » Cursor Down  decreases  the users time limit by 5  minutes.  The 
  1736.                     user  doesn't notice anything except that he has  5 
  1737.                     minutes less.
  1738.      » Alt-A        changes the users graphics mode to ASCII.
  1739.      » Alt-C        enters chat mode. See below.
  1740.      » Alt-D        cycles Display Mode:  switches the status bar  off, 
  1741.                     then  the  screen  display if you  press  this  key 
  1742.                     again.  Use Shift-Shift-Alt-D to switch status  bar 
  1743.                     and screen display back on.
  1744.      » Alt-F        allows  you to edit the users flags.  The  user  is 
  1745.                     told to wait.
  1746.      » Alt-H        hangup: disconnects the user directly.
  1747.      » Alt-I        gives   some  extra  info  about  the  user   like: 
  1748.                     Phonenumbers,  lat time he/she called,  up/download 
  1749.                     files, account etc.
  1750.                     told to wait.
  1751.      » Alt-J        jump to DOS: starts the program defined in QConfig. 
  1752.                     The user is told to wait.
  1753.      » Alt-L        lockout:    disconnects   the   user,    asks   for 
  1754.                     confirmation  and zeroes the users security  level, 
  1755.                     locking him out of the BBS.
  1756.      » Alt-O        allows you to edit the users account.  The user  is 
  1757.                     told to wait.
  1758.      » Alt-P        switches printer logging on and off. If the printer 
  1759.                     doesn't respond printer logging is switched off.
  1760.      » Alt-S        allows  you to edit the users security  level.  The 
  1761.                     user is told to wait.
  1762.      » Undo         clears the daily download counter and asks you  for 
  1763.                     a new download limit for this call only.
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.      ------------------------------------------------------------------
  1778.      QuickBBS ST                                                Page 27
  1779.  
  1780.  
  1781.  
  1782.  
  1783.      QuickBBS ST                                                Page 28
  1784.      ------------------------------------------------------------------
  1785.  
  1786.      CHATTING & YELL TUNES
  1787.  
  1788.      A few extra keys can be used in chat mode:
  1789.  
  1790.      » Control-C    clear the screen
  1791.      » Control-F    switch Funmodem on or off
  1792.      » Control-G    sound a bell, beep or tune
  1793.      » Control-L    switch the chat log on and off
  1794.      » Control-U    switch the users CapsLock on and off
  1795.      » Control-V    view a file
  1796.      » Escape       exit chat mode
  1797.  
  1798.      The  chat log is called CHATLOG.TXT and can be found in  the  home 
  1799.      directory. It contains everything you type and everything the user 
  1800.      types.
  1801.  
  1802.      Control-U  comes in handy when users don't know what the  CapsLock 
  1803.      key  is  for.  If  a user types  everything  in  uppercase,  press 
  1804.      Control-U.  Quick  will  transform  whatever  the  user  types  to 
  1805.      lowercase.  The user will see this too,  and hopefully switch  his 
  1806.      CapsLock off.  As soon as he types a lowercase character,  or  you 
  1807.      press Control-U again, the transformation is disabled.
  1808.  
  1809.      Control-V  will prompt you for a file to display (and send to  the 
  1810.      user). This can be a text or graphics file, all control codes will 
  1811.      be translated.  See the section on Text Files and Menus.  This key 
  1812.      is identical to executing a menu option type 5.
  1813.  
  1814.      Control-G sends a bell signal to the user.  If the user is in Ansi 
  1815.      graphics  mode he'll even hear a tune!  When the user  presses  it 
  1816.      he's sure to get your attention.
  1817.  
  1818.      Control-F  will  switch  the Funmode on or off.  If  you  use  the 
  1819.      Funmode some very strange things can happen.  QuickBBS will  start 
  1820.      to behave very strange. Try it, it will surprise you...
  1821.  
  1822.      If  a user tried to page you and you didn't answer he is asked  to 
  1823.      leave a message.  You must enter the areanumber where this message 
  1824.      must end up in Qconfig.
  1825.  
  1826.      Quick  can  sound a different tune depending on a  users  name  or 
  1827.      security level.  To use this feature you must create an ASCII file 
  1828.      called YELLTUNE.BBS in your CONF\ directory.  Each line can either 
  1829.      start with the users name (with spaces replaced by underscores) or 
  1830.      a  security level.  This should be followed by a file path +  name 
  1831.      which  contains the XBios 32 (DoSound) instructions.  Such a  file 
  1832.      can  be created by programs like Composer (downloadable  from  the 
  1833.      Support BBS) or Musix32. An example:
  1834.  
  1835.           
  1836.           Robert_Redford \QBBS\TUNES\MICHELLE.MUS
  1837.           200 \QBBS\TUNES\PRELUD.MUS
  1838.           10 \QBBS\TUNES\STUPID.MUS
  1839.  
  1840.      If a user with level 200 yells the file PRELUD.MUS is  played.  If 
  1841.      Robert Redford yells you'll hear the tune in MICHELLE.MUS.
  1842.  
  1843.      ------------------------------------------------------------------
  1844.      QuickBBS ST                                                Page 28
  1845.  
  1846.  
  1847.  
  1848.  
  1849.      QuickBBS ST                                                Page 29
  1850.      ------------------------------------------------------------------
  1851.  
  1852.      THE STATUS BAR
  1853.  
  1854.      A status bar is displayed at the bottom of the screen. It contains 
  1855.      some  information about the current user.  The top line shows  the 
  1856.      users  name and city,  in the bottom line you'll see his  security 
  1857.      level,  when  he logged in,  how much time he has left,  how  many 
  1858.      times  he's  called and what his graphics mode is  (A  for  Ascii, 
  1859.      M for VT-52 Monochrome,  C for VT-52 Colour,  S for VT-52 Standard 
  1860.      and I for (IBM) Ansi).
  1861.  
  1862.      In Local mode the amount of free RAM is displayed in the middle of 
  1863.      the bar. If a user yells for you it will be shown there instead.
  1864.  
  1865.      If  you press Alt-I you will get some more info about the  current 
  1866.      user. Mayby you want to check his phonenumber !
  1867.  
  1868.      The  status bar and the local display can be switched on  and  off 
  1869.      with  the Alt-D key.  This is for use with multi-tasking  packages 
  1870.      like  the MTC-shell and MX2.  Press Alt-D once to switch  off  the 
  1871.      status bar. Press Alt-D again to switch off the display. To switch 
  1872.      them both back on again you must press Shift-Shift-Alt-D.  You can 
  1873.      also  switch it off if you put -n on the  commandline,  the  mouse 
  1874.      will be switched on too then.
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.      ------------------------------------------------------------------
  1910.      QuickBBS ST                                                Page 29
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.      ==================================================================
  1918.      ======================== Section 4 : Users =======================
  1919.      ==================================================================
  1920.  
  1921.      USER INFORMATION
  1922.  
  1923.      QuickBBS knows quite a lot about the user.  The two most important 
  1924.      items of information are the his Security Level and his Flags. The 
  1925.      Security  Level,  sometimes called User Level or Privilege,  is  a 
  1926.      value between 0 and 32000.  Depending on this level he may or  may 
  1927.      not  have  access  to certain options in  the  BBS.  A  user  with 
  1928.      security  level zero will not even be allowed into the  BBS.  Nice 
  1929.      way of locking out your mother-in-law!
  1930.  
  1931.      The user has four sets of Flags.  Each set contains 8 flags  which 
  1932.      can be either on or off. The sets are 'numbered' A to D, the flags 
  1933.      are  numbered  1  to 8,  so one flag can  be  identified  as,  for 
  1934.      instance, A1 or C6. A flag which is on is marked with an X, a flag 
  1935.      which is off is marked with a minus (-).  Both the security  level 
  1936.      and the flags can be changed in the user editor.
  1937.  
  1938.      Each option in a menu in the BBS has a security level and a set of 
  1939.      flags  too.  These  items  are compared  to  the  users  settings. 
  1940.      Depending  on the result,  the user may or may not have access  to 
  1941.      that option. An example:
  1942.  
  1943.      A menu option has the following settings:
  1944.  
  1945.           Security Level : 50
  1946.           A-Flags        : --X---X-
  1947.           B-Flags        : -------X
  1948.           C-Flags        : --------
  1949.           D-Flags        : --------
  1950.  
  1951.      A user logs in with the following settings:
  1952.  
  1953.           Security Level : 100
  1954.           A-Flags        : XXX---XX
  1955.           B-Flags        : --------
  1956.           C-Flags        : --X-----
  1957.           D-Flags        : --------
  1958.  
  1959.      QuickBBS  will first look at the required Security Level (50)  and 
  1960.      compare it to the users Security Level (100).  The users level  is 
  1961.      higher. If it was lower the user wouldn't have access to , or even 
  1962.      see (!) the menu option.
  1963.  
  1964.      Based on the Security Levels the user has access,  but Quick  will 
  1965.      now compare the required Flags and the users Flags:
  1966.  
  1967.           Required A-Flags    : --X---X-
  1968.           Users A-Flags       : XXX---XX
  1969.           Binary AND                    
  1970.           Result              : --X---X-
  1971.  
  1972.  
  1973.  
  1974.  
  1975.      ------------------------------------------------------------------
  1976.      QuickBBS ST                                                Page 30
  1977.  
  1978.  
  1979.  
  1980.  
  1981.      QuickBBS ST                                                Page 31
  1982.      ------------------------------------------------------------------
  1983.  
  1984.      If a required flag is on,  then the users flag must also be on  if 
  1985.      he  is  allowed  to use the menu option.  This  operation  can  be 
  1986.      compared to a binary AND.  Notice that the result is equal to  the 
  1987.      required flags.
  1988.  
  1989.      Based on the A-flags the user also has access, so we continue with 
  1990.      the B flags...
  1991.  
  1992.           Required B-Flags    : -------X
  1993.           Users B-Flags       : --------
  1994.           Binary AND
  1995.           Result              : --------
  1996.  
  1997.      The  menu option requires flag B8 to be on,  but the user  doesn't 
  1998.      have  flag  B8!  This means he does not have access  to  the  menu 
  1999.      option,  and  it  will be invisible to him.  This might be  a  bit 
  2000.      difficult  to  grasp  at  first,   and  might  require  a   little 
  2001.      experimenting.  Notice  the  result isn't equal  to  the  required 
  2002.      flags.
  2003.  
  2004.      The menus aren't the only part of the BBS which have  flags.  Each 
  2005.      message  board  has security level and flag  protection  for  read 
  2006.      access, write access and SysOp access. More on that later.
  2007.  
  2008.      What else does QuickBBS know about the user? Well, let's see...
  2009.  
  2010.      » Calls          The number of times the user has called your BBS,
  2011.      » City           Where the user says he lives,
  2012.      » Home Phone     His voice phone number,
  2013.      » Data Phone     and data phone number,
  2014.      » Last Date      The  last  date  the  user  logged  in,  MM/DD/YY 
  2015.                       format,
  2016.      » Last Time      The last time the user logged in, HH:MM format,
  2017.      » Used Today     How long he has been online today,
  2018.      » Credit         His NetMail credit,
  2019.      » Downloaded     How many files & Kb he has downloaded,
  2020.      » Uploaded       How many files & Kb he has uploaded,
  2021.      » DL Today       How many Kb he has downloaded today,
  2022.      » Posted         How many messages he has written,
  2023.      » Deleted        Is this user to be deleted next time UserPack  is 
  2024.                       run?
  2025.      » Clear Screen   Does  this user want his screen  cleared  between 
  2026.                       menus?
  2027.      » More Prompt    Does  he  want the 'More [Y/n] ?'  prompt  to  be 
  2028.                       displayed at the bottom of every screen?
  2029.      » Screen Length  If so, how many lines can his screen display?
  2030.      » Ignore DL Hrs  May  this  user  download  outside  the  download 
  2031.                       period as specified in QConfig?
  2032.      » Graphics Mode  What is the users graphics mode?
  2033.      » Account        What is his number of account points?
  2034.  
  2035.      Quick also keeps track of which messages the user has read in  the 
  2036.      message base,  if the file LASTREAD.BBS exists.  This file can  be 
  2037.      created with UserEdit.
  2038.  
  2039.  
  2040.  
  2041.      ------------------------------------------------------------------
  2042.      QuickBBS ST                                                Page 31
  2043.  
  2044.  
  2045.  
  2046.  
  2047.      QuickBBS ST                                                Page 32
  2048.      ------------------------------------------------------------------
  2049.  
  2050.      PACKING THE USERBASE
  2051.  
  2052.      When you delete a user in UserEdit he is not actually removed from 
  2053.      the userbase.  He's just marked as deleted.  You must run the PACK 
  2054.      option in the usereditor to really delete the user and update  the 
  2055.      lastreadpointers.  Here  you  can also delete users  that  haven't 
  2056.      logged in for a while.  It asks after how many days a user must be 
  2057.      deleted.
  2058.  
  2059.      THE LIMITS FILE
  2060.  
  2061.      QConfig  allows you to define a default time limit for each  user. 
  2062.      But you might like some users more than others,  and want to  give 
  2063.      them  more time in the BBS.  I'd give Kelly LeBrock (remember  The 
  2064.      Woman  in Red?) all day if she wanted it 8-).  It would make  much 
  2065.      more  sense  to  have  a time limit which  depends  on  the  users 
  2066.      Security  Level.   Well,  that's  possible  of  course.  With  the 
  2067.      optional LIMITS.CTL file.
  2068.  
  2069.      The Limits file is a plain ASCII one which should be placed in the 
  2070.      home  directory.  It contains one or more lines,  each  terminated 
  2071.      with  a CRLF (Carriage Return and Line Feed,  ASCII 13  and  ASCII 
  2072.      10).  Each  line contains three numbers.  The first number is  the 
  2073.      security  level.  The second is the maximum time in  the  BBS,  in 
  2074.      minutes, per day. The third value is the maximum amount users with 
  2075.      that Security Level may download, in Kb, per day. The file must be 
  2076.      sorted on Security Level.
  2077.  
  2078.      Quick will search through the file looking for the users  Security 
  2079.      Level.  If it doesn't find the exact level it will use the closest 
  2080.      lower level.
  2081.  
  2082.      An example: Kelly LeBrock has level 200. Our LIMITS.CTL file looks 
  2083.      like this:
  2084.  
  2085.           1 10 20
  2086.           10 20 50
  2087.           50 30 100
  2088.           100 45 200
  2089.           500 60 250
  2090.  
  2091.      Level 200 isn't in the Limits file,  so Quick will use the  values 
  2092.      defined for Security Level 100 instead:  45 minutes per day in the 
  2093.      BBS and 200 Kb of download per day.
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.      ------------------------------------------------------------------
  2108.      QuickBBS ST                                                Page 32
  2109.  
  2110.  
  2111.  
  2112.  
  2113.      QuickBBS ST                                                Page 33
  2114.      ------------------------------------------------------------------
  2115.  
  2116.      THE TRASHCAN FILE
  2117.  
  2118.      The TrashCan file is also located in the home  directory.  Another 
  2119.      optional ASCII file. Each line in TRASHCAN.CTL can contain a whole 
  2120.      name or part of a name which is not allowed to be used on the BBS. 
  2121.      You  might  want  to put some dirty words in  there  too  (an  old 
  2122.      favourite of VIC-20 users).
  2123.  
  2124.      An example:  a new user called Douglas Duck logs in. Your TrashCan 
  2125.      file contains...
  2126.  
  2127.           HITLER
  2128.           REAGAN
  2129.           DONALD DUCK
  2130.           MICKEY MOUSE
  2131.  
  2132.      Douglas  Duck  would  be allowed onto the  BBS,  because  no  line 
  2133.      contains  only  the words 'Douglas  Duck',  'Douglas'  or  'Duck'. 
  2134.      However,  if a new user called Robin Reagan logged in he would not 
  2135.      be allowed on, because one of the lines is the word 'Reagan'.
  2136.  
  2137.      THE ACCOUNTING SYSTEM
  2138.  
  2139.      This  is  a very powerfull part of QuickBBS.  You  can  reward  or 
  2140.      punish  a  user  depending on his actions.  Have  a  look  at  the 
  2141.      accounting  section in Qconfig.  You can determine there what  the 
  2142.      'reward' will be for several actions.
  2143.  
  2144.      The account can run from -32767 to +32767. But you can set a lower 
  2145.      max. or higher min. too.
  2146.  
  2147.      QuickBBS only registers the account,  it doesn't do anything  with 
  2148.      it itself.  That is up to you. To give you an idea you could use a 
  2149.      .DOR  file in the download section of the BBS that is run after  a 
  2150.      file  is  downloaded.  You can use the account as *O in  the  .DOR 
  2151.      file,  with  the IF ...  THEN ..  statements you could change  the 
  2152.      users level and/or downloadlimit depending on his account.
  2153.  
  2154.      So let them gray cells work,  this is really very nice if you make 
  2155.      good use of it.
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.      ------------------------------------------------------------------
  2174.      QuickBBS ST                                                Page 33
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.      ==================================================================
  2182.      ================== Section 5 : Text & Graphics ===================
  2183.      ==================================================================
  2184.  
  2185.      TEXT FILES & GRAPHICS MODES
  2186.  
  2187.      Your Text File Directory contains a whole lot of text  files.  You 
  2188.      can  edit any of these files to customise your BBS,  add new  ones 
  2189.      etc.
  2190.  
  2191.      QuickBBS  supports five Graphics Modes.  By selecting  a  graphics 
  2192.      mode the user can get QuickBBS to make better use of his terminal, 
  2193.      by using Escape Sequences to control things like  colours,  cursor 
  2194.      position etc.
  2195.  
  2196.      The text files come in five flavours,  one for each Graphics Mode. 
  2197.      QuickBBS  selects  the  file to display by  looking  at  the  file 
  2198.      extension. The text files which contain escape codes are sometimes 
  2199.      called Graphics Files.
  2200.  
  2201.      The  simplest Graphics Mode is plain ASCII.  No escape  codes  are 
  2202.      sent in this mode.  The text files for this mode end in .ASC.
  2203.  
  2204.      Then we have three VT-52 modes.  VT-52 Monochrome and VT-52 Colour 
  2205.      are for use on Atari ST's only.  They use some escape codes  which 
  2206.      are  Atari-private and might do strange things on other  machines. 
  2207.      The  Monochrome flavour has extension .VTM and should not  contain 
  2208.      any colour escapes.  The Colour flavour is called .VTC.  If a user 
  2209.      is  running software on a different computer with VT-52  emulation 
  2210.      he can select VT-52 Standard.  In this mode the BBS will not  send 
  2211.      any of the Atari-private escapes. The file extension here is .VTS.
  2212.  
  2213.      The  most fancy mode is Ansi.  This isn't real Ansi,  but the  IBM 
  2214.      version,  as implemented in many comms packages on the PC.  It  is 
  2215.      often  called Ansi-BBS.  When operating in this mode QuickBBS  can 
  2216.      use a PC-style font so that you can see the IBM character set with 
  2217.      box  graphics etc.  The extension is .ANS.  Though the  most  used 
  2218.      escapes can be interpreted by QuickBBS, the implementation of Ansi 
  2219.      is  not complete.  If QuickBBS sees an escape it doesn't  know  it 
  2220.      will ignore that escape. The escape will be sent to the user.
  2221.  
  2222.      Please  refer  to the appendix section for VT-52 and  Ansi  escape 
  2223.      sequences.  And  remember:  you can do a hell of a lot with  these 
  2224.      escapes,  but your users don't call your BBS to look at the pretty 
  2225.      pictures.  I've  seen a number of boards using Ansi  to  implement 
  2226.      DropDown menus. Looks great, but is very very slow.
  2227.  
  2228.      The   different  text/graphics  files  can  contain   non-standard 
  2229.      escapes,  if  you  want.  In Ansi mode Quick will  only  use  Ansi 
  2230.      escapes in the system menus,  but you are free to put anything you 
  2231.      like in the graphics files (not that it would make much sense).
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.      ------------------------------------------------------------------
  2240.      QuickBBS ST                                                Page 34
  2241.  
  2242.  
  2243.  
  2244.  
  2245.      QuickBBS ST                                                Page 35
  2246.      ------------------------------------------------------------------
  2247.  
  2248.      SYSTEM TEXT FILES
  2249.  
  2250.      There are a number of system text files which you can edit  and/or 
  2251.      create.  Some  of the files can only have an .ASC version  because 
  2252.      they are displayed before the users Graphics Mode is known.
  2253.  
  2254.      » BANNER       displayed  by  QuickStart while the  BBS  is  being 
  2255.                     loaded. ASCII only, and may not contain any control 
  2256.                     codes.
  2257.      » BROWSER      displayed  when  the user selects [H]elp  from  the 
  2258.                     File Browser.
  2259.      » DNLDHRS      displayed if the user attempts to download  outside 
  2260.                     download hours.
  2261.      » EDITHELP     displayed  when  the user selects [H]elp  from  the 
  2262.                     Message Editor.
  2263.      » FILEMENU     displayed  when  the user selects [H]elp  from  the 
  2264.                     File Menu.
  2265.      » GOODBYE      displayed just before QuickBBS disconnects.
  2266.      » GRAPHELP     displayed  when  the user selects [H]elp  from  the 
  2267.                     Graphics Mode menu. To be on the safe side use .ASC 
  2268.                     only.
  2269.      » HOTNEWS      displayed after login, and only if the file date is 
  2270.                     newer then the last time the user called.
  2271.      » LANGUAGE     displayed  when  the user tries to save  a  message 
  2272.                     which doesn't pass the language test.
  2273.      » LOGO         the  very first file QuickBBS displays  (after  the 
  2274.                     banner file,  displayed by QuickStart). Because the 
  2275.                     graphics mode is not yet determined,  the file  has 
  2276.                     ASCII only flavour.
  2277.      » MAXPAGE      displayed  if  the user attempts to page  you  more 
  2278.                     times than allowed, as specified in QConfig.
  2279.      » NEWS         displayed  just  before the system checks  for  new 
  2280.                     mail.
  2281.      » NEWUSER1     displayed  to a new user after he has verified  his 
  2282.                     name,  but  before any questions are  asked.  ASCII 
  2283.                     only.
  2284.      » NEWUSER2     displayed  after  the  new  user  has  selected   a 
  2285.                     password.
  2286.      » NEWUSER3     displayed  when the new user has filled in all  the 
  2287.                     questions.
  2288.      » NO300        displayed  when a call comes in at 300 Bps  outside 
  2289.                     the 300 Bps hours.
  2290.      » NODELIST     displayed  when  a  user selects  [H]elp  from  the 
  2291.                     NodeList menu.
  2292.      » NOTAVAIL     displayed when a user pages you outside the  paging 
  2293.                     hours defined in QConfig.
  2294.      » NOTFOUND     displayed if the system can't find the user in  the 
  2295.                     User Base,  but before he is asked whether his name 
  2296.                     is correct.  You should explain the FidoNet  naming 
  2297.                     convention (Alexis Carrington.Colby.Dexter) etc.
  2298.      » OARCHELP     displayed  when  the user selects [H]elp  from  the 
  2299.                     Online Archiver main menu.
  2300.      » OARCTYPE     displayed  when  the user selects [H]elp  from  the 
  2301.                     Online  Archiver  type  selection  menu  (when   he 
  2302.                     chooses between .ARC and .LZH archives).
  2303.  
  2304.  
  2305.      ------------------------------------------------------------------
  2306.      QuickBBS ST                                                Page 35
  2307.  
  2308.  
  2309.  
  2310.  
  2311.      QuickBBS ST                                                Page 36
  2312.      ------------------------------------------------------------------
  2313.  
  2314.      » OPTIMISE     displayed  when  the user selects [H]elp  from  the 
  2315.                     Menu Optimiser menu.
  2316.      » PAGEABRT     displayed if the SysOp aborts a page.
  2317.      » PAGED        displayed  when  you don't respond to  a  page.  It 
  2318.                     should  inform  the user that the  SysOp  has  been 
  2319.                     paged.
  2320.      » PASSWORD     displayed  before  a  new  user  is  asked  for   a 
  2321.                     password, and when the user changes his password.
  2322.      » POSTCHAT     displayed after a chat
  2323.      » PRECHAT      displayed before a chat
  2324.      » PRE-UPLD     displayed before uploading
  2325.      » READHELP     displayed  when  the user selects [H]elp  from  the 
  2326.                     Read Messages menu.
  2327.      » SCANHELP     displayed  when  the user selects [H]elp  from  the 
  2328.                     Scan Messages menu.
  2329.      » SECxxx       displayed after login if user with level xxx calls.
  2330.      » TOOSLOW      displayed  if  a user calls with a  baudrate  lower 
  2331.                     than the "Minimum Baudrate to Logon" as defined  in 
  2332.                     QConfig.
  2333.      » TRASHCAN     displayed  if  the name typed in by  the  new  user 
  2334.                     conflicts with the TRASHCAN.CTL file. ASCII only.
  2335.      » UP-DESC      displayed  after upload but before asking the  user 
  2336.                     for the description of the uploaded file(s)
  2337.      » UPPER        displayed when a user tries to save a message which 
  2338.                     doesn't pass the UpperCase check.
  2339.      » USERxxx      displayed  after  login to the  user   with  record 
  2340.                     number xxx.  Example:  USER006.ASC is shown to user 
  2341.                     number 6.
  2342.      » WELCOME      displayed  after the user has entered his name  and 
  2343.                     password.  This  is  where you might  like  to  get 
  2344.                     elaborate. It's ASCII only.
  2345.      » XFERHELP     displayed when a user selects [H]elp from the  File 
  2346.                     Transfer Protocol menu. It should explain what each 
  2347.                     protocol does, and which is best.
  2348.  
  2349.      Your  menus  can contain commands to display  text  files.  Unless 
  2350.      otherwise  stated  these files should be located in  the  Textfile 
  2351.      Directory.  Do not include an extension in the name of the file to 
  2352.      display, Quick will add it depending on the current Graphics Mode.
  2353.  
  2354.  
  2355.      If  there  is  no graphics file for  the  current  Graphics  Mode, 
  2356.      QuickBBS will downgrade,  e.g. if there is no WELCOME.ANS the file 
  2357.      WELCOME.ASC  is used.  When looking for a file Quick  will  follow 
  2358.      this chart...
  2359.  
  2360.           Graphics Mode       Search order
  2361.  
  2362.           ASCII               *.ASC
  2363.           ANSI                *.ANS     *.ASC
  2364.           VT-52 Standard      *.VTS     *.ASC
  2365.           VT-52 Mono          *.VTM     *.VTS     *.ASC
  2366.           VT-52 Colour        *.VTC     *.VTM     *.VTS     *.ASC
  2367.  
  2368.  
  2369.  
  2370.  
  2371.      ------------------------------------------------------------------
  2372.      QuickBBS ST                                                Page 36
  2373.  
  2374.  
  2375.  
  2376.  
  2377.      QuickBBS ST                                                Page 37
  2378.      ------------------------------------------------------------------
  2379.  
  2380.      TEXT FILE CONTROL CODES
  2381.  
  2382.      Each  text file other than BANNER.ASC can contain  control  codes. 
  2383.      These  codes  are replaced when QuickBBS  displays  the  file,  or 
  2384.      cause QuickBBS to take a certain action.  Most editors can  insert 
  2385.      such  codes into a text file.  First Word Plus can't,  in fact  it 
  2386.      will  often  refuse to load a file with such  control  codes.  Try 
  2387.      Tempus, Micro Emacs or the capture buffer in Flash.
  2388.  
  2389.      In this (and most other) documentation a control code is shown  as 
  2390.      a ^ sign followed by a character.  For example, ^A (Control-A) has 
  2391.      ASCII code 1, ^B is code 2 etc.
  2392.  
  2393.      In Tempus you can use the character table to enter the  codes,  or 
  2394.      keep  the Alternate key pressed while you type the ASCII value  on 
  2395.      the  numeric keypad,  e.g.  to type control-C you would hold  down 
  2396.      Alternate,  press  3 and release Alternate.  In most  Micro  Emacs 
  2397.      versions  you  can press control-Q followed by the  character  you 
  2398.      want, e.g. control-Q followed by control-C.
  2399.  
  2400.      The  control  codes known to QuickBBS can be split up  into  three 
  2401.      groups:  System Control,  User Information and System Information. 
  2402.  
  2403.      The User Info and System Info are two-character codes.  They start 
  2404.      with either a ^F or ^K, followed by another character. This second 
  2405.      character is not a control code!
  2406.  
  2407.      The codes are...
  2408.  
  2409.           System Control
  2410.  
  2411.           Code ASCII     Function
  2412.  
  2413.           ^A   001       Pause and wait for the user to press Return.
  2414.           ^B   002       Turn  [S]top  aborting  off.   The  user   can 
  2415.                          normally  abort any textfile with the  S  key, 
  2416.                          and pause with the P key.
  2417.           ^C   003       Turn [S]top aborting on.
  2418.           ^D   004       Turn the More [Y/n] prompts off.
  2419.           ^E   005       Turn the More [Y/n] prompts on.
  2420.           ^F   006       User Information code.
  2421.           ^G   007       Sound bell/beep.
  2422.           ^H   008       BackSpace.
  2423.           ^I   009       Tab.
  2424.           ^J   010       LineFeed.
  2425.           ^K   011       System Information code.
  2426.           ^L   012       FormFeed (clear screen).
  2427.           ^M   013       Carriage Return
  2428.      
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.      ------------------------------------------------------------------
  2438.      QuickBBS ST                                                Page 37
  2439.  
  2440.  
  2441.  
  2442.  
  2443.      QuickBBS ST                                                Page 38
  2444.      ------------------------------------------------------------------
  2445.  
  2446.           User Information
  2447.  
  2448.           Code ASCII     Function
  2449.      
  2450.           ^FA  006 065   Users full name.
  2451.           ^FB  006 066   City.
  2452.           ^FC  006 067   Password (use with care!).
  2453.           ^FD  006 068   Data phone.
  2454.           ^FE  006 069   Voice phone.
  2455.           ^FF  006 070   Last date user called.
  2456.           ^FG  006 071   Last time user called.
  2457.           ^FH  006 072   Users A-Flags.
  2458.           ^FI  006 073   Users B-Flags.
  2459.           ^FJ  006 074   Users C-Flags.
  2460.           ^FK  006 075   Users D-Flags.
  2461.           ^FL  006 076   NetMail Credit in cents.
  2462.           ^FM  006 077   Number of messages the user has posted.
  2463.           ^FO  006 079   Users Security Level.
  2464.           ^FP  006 080   Number of times the user has called.
  2465.           ^FQ  006 081   Number of files the user has uploaded.
  2466.           ^FR  006 082   Number of KiloBytes the user has uploaded.
  2467.           ^FS  006 083   Number of files the user has downloaded.
  2468.           ^FT  006 084   Number of KiloBytes the user has downloaded.
  2469.           ^FU  006 085   Number of minutes user has been online today.
  2470.           ^FV  006 086   Length of the users screen.
  2471.           ^FW  006 087   Users first name.
  2472.           ^FX  006 088   Users Graphics Mode.
  2473.           ^FY  006 089   More prompt  : ON or OFF.
  2474.           ^FZ  006 090   Screen Clear : ON or OFF.
  2475.           ^F0  006 048   Optimiser    : ON or OFF.
  2476.           ^F1  006 049   KiloBytes the user has downloaded today.
  2477.           ^F2n 006 050   Flag An      : ON or OFF.
  2478.           ^F3n 006 051   Flag Bn      : ON or OFF.
  2479.           ^F4n 006 052   Flag Cn      : ON or OFF.
  2480.           ^F5n 006 053   Flag Dn      : ON or OFF.
  2481.           ^F6  006 054   Current Account
  2482.           ^F7  006 055   Full Screen Editor : ON or OFF.
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.      ------------------------------------------------------------------
  2504.      QuickBBS ST                                                Page 38
  2505.  
  2506.  
  2507.  
  2508.  
  2509.      QuickBBS ST                                                Page 39
  2510.      ------------------------------------------------------------------
  2511.  
  2512.        System Information
  2513.  
  2514.           Code ASCII     Function
  2515.  
  2516.           ^KA  011 065   Number of calls to the BBS.
  2517.           ^KB  011 066   Name of the last caller.
  2518.           ^KF  011 070   Number of times you've been paged.
  2519.           ^KG  011 071   Day of the week (i.e. Monday, Tuesday etc.).
  2520.           ^KH  011 072   Number of users in the User Base.
  2521.           ^KI  011 073   Current time in 24 hour format (HH:MM)
  2522.           ^KJ  011 074   Current date, format DD MMM YY (04 Nov 89).
  2523.           ^KK  011 075   Time connected - minutes.
  2524.           ^KL  011 076   Time connected - seconds.
  2525.           ^KM  011 077   Time used - minutes.
  2526.           ^KN  011 078   Time used - seconds.
  2527.           ^KO  011 079   Time remaining - minutes.
  2528.           ^KP  011 080   Time remaining - seconds.
  2529.           ^KQ  011 081   Time limit in minutes.
  2530.           ^KR  011 082   Baud rate.
  2531.           ^KS  011 083   Abbreviated day of week (i.e. Mon, Tue etc.).
  2532.           ^KT  011 084   Download limit in Kb.
  2533.           ^KWx 011 087   Amount of free space on drive 'x'.
  2534.           ^KX  011 088   Amount of free RAM.
  2535.  
  2536.      You'd  like  an example?  Okay.  The file PAGED.ASC  contains  the 
  2537.      following text and control codes...
  2538.  
  2539.           Hello  ^FW,  the  SysOp  doesn't  seem to be  around  at  the 
  2540.           moment.  You have ^KO minutes and ^KP seconds left for today, 
  2541.           so why don't you write him a message?
  2542.  
  2543.           Press [Return] to continue...^A
  2544.  
  2545.      When this file is displayed it might look something like this...
  2546.  
  2547.           Hello  Dave,  the  SysOp  doesn't seem to be  around  at  the 
  2548.           moment.  You have  24 minutes and  18 seconds left for today, 
  2549.           so why don't you write him a message?
  2550.  
  2551.           Press [Return] to continue...
  2552.  
  2553.      at  which point Quick would wait for Dave to press the Return.
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.      ------------------------------------------------------------------
  2570.      QuickBBS ST                                                Page 39
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.      ==================================================================
  2578.      ======================= Section 6 : Menus ========================
  2579.      ==================================================================
  2580.  
  2581.      THE MENU SYSTEM
  2582.  
  2583.      Each menu on a board running QuickBBS is 100%  SysOp-configurable. 
  2584.      Not only the menu text and menu keys, but also the menu structure.
  2585.  
  2586.      Each  menu  has  a menu file which can be created  with  the  menu 
  2587.      editor (MENUEDIT.PRG). This program was written by Theo Runia. The 
  2588.      menu  files  are  located  in the Menu  File  Directory  and  have 
  2589.      extension .MNU.
  2590.  
  2591.      When  a user calls,  the first menu he will get is  TOP.MNU.  This 
  2592.      menu  must  always  be present.  From this point  onward  you  are 
  2593.      completely free to choose your own menu names.
  2594.  
  2595.      A  menu contains one or more menu options.  Each  option  consists 
  2596.      of...
  2597.  
  2598.      » Text Line              what the user sees on the screen.
  2599.      » Data Line              depends on the Option Type.
  2600.      » Option Type            what the option does.
  2601.      » Option Key             key which activates the option.
  2602.      » Required Security      Security Level needed.
  2603.      » Required Flags         Flags needed.
  2604.      » ForeGround Colour      foreground colour in VTC/ANS mode.
  2605.      » BackGround Colour      background colour in VTC/ANS mode.
  2606.  
  2607.      The  Text  Line will only be displayed if the user has  access  to 
  2608.      the  option.  This depends on the Required Security  and  Required 
  2609.      Flags, and the users Security Level and Flags.
  2610.  
  2611.      There  are  three special characters which can be used in  a  text 
  2612.      line. They are:
  2613.  
  2614.        ^  Toggles highlight on/off in VT-52 Mono/Colour and Ansi modes,
  2615.        ~  Is replaced by the number of minutes left,
  2616.        ;  If the text line ends with a semi-column no CRLF is added, so 
  2617.           you can put two or more options next to each other.
  2618.  
  2619.      The  Option  Key is the key the user must press  to  activate  the 
  2620.      option. Of course this is a HotKey.
  2621.  
  2622.      The Foreground and Background Colour items are not implemented  in 
  2623.      the current version of QuickBBS.
  2624.  
  2625.      The Option Type is the most important of the whole lot. It defines 
  2626.      what  the  option actually does.  There are option types  to  read 
  2627.      mail, to view files, to yell for the SysOp etc. etc.
  2628.  
  2629.      The  Data  Line can contain parameters depending on  which  Option 
  2630.      Type  you have chosen.  Some people call it the Command  Line  for 
  2631.      some reason or other.
  2632.  
  2633.  
  2634.  
  2635.      ------------------------------------------------------------------
  2636.      QuickBBS ST                                                Page 40
  2637.  
  2638.  
  2639.  
  2640.  
  2641.      QuickBBS ST                                                Page 41
  2642.      ------------------------------------------------------------------
  2643.  
  2644.      MENU TEXT
  2645.  
  2646.      What the user sees when your menu is displayed is the Text Line of 
  2647.      each menu option he has access to.  The Text Line should  indicate 
  2648.      what key the user must press to activate the option.  You can  use 
  2649.      the  ^  character to highlight parts of your  Text  Line.  If  you 
  2650.      define the line as
  2651.  
  2652.           ^[F]^ File Menu
  2653.  
  2654.      then the [F] will either be reversed (in VT-52 Mono mode) or  have 
  2655.      a different colour (in Ansi and VT-52 Colour mode).  In ASCII  and 
  2656.      VT-52  Standard  modes  QuickBBS  can't  change  any  colours   or 
  2657.      attributes. The square brackets make sure that the key is clear in 
  2658.      those modes too.
  2659.  
  2660.      MENU STRUCTURE
  2661.  
  2662.      Anybody  who has ever programmed in BASIC will know  the  commands 
  2663.      GoTo, GoSub and Return to branch to a certain section of the code. 
  2664.      You use a similar method to describe the structure of your menus.
  2665.  
  2666.      Option  Type 1 is the GoTo option.  It makes QuickBBS  forget  the 
  2667.      current  menu  and  load a new one.  Option type 2  is  the  GoSub 
  2668.      option. It also loads a new menu, but remembers from which menu it 
  2669.      was loaded from. With option type 3 you can Return to that menu.
  2670.  
  2671.      This  may  sound rather complicated but in fact it is  very  easy. 
  2672.      Think of the menu structure as a hierarchy.  The highest level  is 
  2673.      the TOP menu,  each branch is a sub-menu,  called with option type 
  2674.      2.  To go back to the TOP menu you use option type 3.  A  sub-menu 
  2675.      can also have branches, up to 20 levels deep.
  2676.  
  2677.      Time  for  an example.  We want to create a menu  structure  which 
  2678.      looks something like this...
  2679.  
  2680.                                  +-------+
  2681.                                  |  TOP  |
  2682.                                  +-------+
  2683.                                   /     \
  2684.                                  /       \
  2685.                                 /         \
  2686.                      +----------+         +----------+
  2687.                      |   FILE   |         |   MAIL   |
  2688.                      +----------+         +----------+
  2689.                         |     |             |     |
  2690.                     +----+  +----+       +----+  +----+
  2691.                     | F1 |  | F2 |       | M1 |  | M2 |
  2692.                     +----+  +----+       +----+  +----+
  2693.  
  2694.      ...where TOP is the main menu,  FILE is a menu where you select  a 
  2695.      file  area  menu (F1 or F2) and MAIL lets you select a  mail  area 
  2696.      menu (M1 or M2).
  2697.  
  2698.  
  2699.  
  2700.  
  2701.      ------------------------------------------------------------------
  2702.      QuickBBS ST                                                Page 41
  2703.  
  2704.  
  2705.  
  2706.  
  2707.      QuickBBS ST                                                Page 42
  2708.      ------------------------------------------------------------------
  2709.  
  2710.      We'd have seven menu  files:  TOP.MNU,  FILE.MNU,  MAIL.MNU, 
  2711.      F1.MNU, F2.MNU, M1.MNU and M2.MNU. It's a quite easy to do it with 
  2712.      less, but I'll save that for later.
  2713.  
  2714.      TOP would contain two GoSub menu options. One to load FILE and one 
  2715.      to load MAIL.  I assume you want to be able to get back to the top 
  2716.      menu from within one of the sub-menus,  so FILE and MAIL will both 
  2717.      contain a Return option. They would also allow a selection between 
  2718.      either  F1 and F2 or M1 and M2,  with GoSub  options.
  2719.  
  2720.      The  lowest level menus could contain an option to either go  back 
  2721.      to the selection menu (with Return),  or straight back to TOP.  To 
  2722.      accomodate for this sort of construction Quick knows a fourth menu 
  2723.      structure option,  called Clear Stack and GoTo New Menu (got it?). 
  2724.      What it does is this:  first it forgets how it got to the  current 
  2725.      menu (it clears the menu stack).  Then it just loads the new  menu 
  2726.      like the GoTo option does. You'd use this option to go straight to 
  2727.      TOP.
  2728.  
  2729.      All these options - exept for Return - expect the name of the menu 
  2730.      to be on the data line.  If a menu isn't found Quick will warn the 
  2731.      user (and the SysOp, in the logfile) and return to the TOP menu.
  2732.  
  2733.      THE MENU EDITOR
  2734.  
  2735.      is  called MENUEDIT.PRG.  When executed it will display a  list of 
  2736.      existing  menus.  With the function keys you can copy,  delete and 
  2737.      rename existing menus. To create a new menu or  edit  an  existing
  2738.      one just type in the name.                                        
  2739.  
  2740.      You will then see the main menu of MenuEdit. From here you can Add 
  2741.      new options to the 'end' of the menu,  Insert a new option between 
  2742.      two existing options, Change (edit) or Delete options.
  2743.  
  2744.      With  Simulate  you can see what your menu looks like when  it  is 
  2745.      displayed  to the user.  You'll have to enter a Security Level  to 
  2746.      determine which menu options are used,  but all flags are  assumed 
  2747.      on. The List command shows a list of all the options in your menu.
  2748.  
  2749.      When  you  Add,  Insert  or Change an option the  edit  screen  is 
  2750.      displayed. All the fields of the menu can be changed here.
  2751.  
  2752.      The  menu Prompt is really just another menu option right down  at 
  2753.      the bottom of the screen (the very last option). The difference is 
  2754.      that it is only a Text Line and doesn't actually do anything.  The 
  2755.      HighLight colours aren't implemented in the current version.
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.      ------------------------------------------------------------------
  2768.      QuickBBS ST                                                Page 42
  2769.  
  2770.  
  2771.  
  2772.  
  2773.      QuickBBS ST                                                Page 43
  2774.      ------------------------------------------------------------------
  2775.  
  2776.      MENU OPTION TYPES
  2777.  
  2778.      There  are about 40 different option types in the current  version 
  2779.      of QuickBBS. They are...
  2780.  
  2781.        Type Description
  2782.  
  2783.           0 Text Line,  not considered a command. Use this to add extra 
  2784.             lines of text to your menu, such as titles and empty lines.
  2785.  
  2786.           1 GoTo New Menu. The menu name and any menu parameters should 
  2787.             be placed on the Data Line.
  2788.  
  2789.           2 GoSub New Menu.  The Data Line should contain the menu name 
  2790.             and any menu parameters.
  2791.  
  2792.           3 Return from Previous Gosub returns to the menu which loaded 
  2793.             the current menu.
  2794.  
  2795.           4 Clear Stack & GoTo New Menu.  Data Line: menu name and menu 
  2796.             parameters.
  2797.  
  2798.           5 Display Text File.  The Data Line contains the name of  the 
  2799.             file,  without extension and without path.  The file should 
  2800.             be located in the Text File Directory.
  2801.  
  2802.           7 Execute  Program.  Starts up an external program,  see  the 
  2803.             section on Doors.
  2804.  
  2805.           8 Version Information.  Displays the version of QuickBBS, the 
  2806.             copyright information etc. No Data Line.
  2807.  
  2808.           9 Log off. Terminates the connection. No Data Line.
  2809.  
  2810.          10 Display  System Usage Graph.  This displays a graph of  the 
  2811.             usage of your BBS per hour. No Data Line.
  2812.  
  2813.          11 Yell  for  SysOp  will either  execute  the  external  chat 
  2814.             program or page you using the internal chat  routines.
  2815.  
  2816.          13 List/Search User Base.  This allows the user to enter  part 
  2817.             of  a  name to search the User Base  with,  or  just  press 
  2818.             Return  to view the whole User Base.  The  name,  city  and 
  2819.             date-of-last-call of each user are displayed. No Data Line.
  2820.  
  2821.          14 Display  Time/Download  Statistics  shows  the  user   some 
  2822.             information about how long he has been in the BBS, how much 
  2823.             time he has left, how much he can download etc.
  2824.  
  2825.          15 Exit with ErrorLevel terminates QuickBBS with an errorlevel 
  2826.             specified  in  the  Data  Line.   The  connection  is   not 
  2827.             terminated. See the section on Doors.
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.      ------------------------------------------------------------------
  2834.      QuickBBS ST                                                Page 43
  2835.  
  2836.  
  2837.  
  2838.  
  2839.      QuickBBS ST                                                Page 44
  2840.      ------------------------------------------------------------------
  2841.  
  2842.          16 Change  City allows the user to modify the 'City' field  he 
  2843.             filled in as a new user. No Data Line.
  2844.  
  2845.          17 Change Password will display the text file PASSWORD in  the 
  2846.             Text  File Directory and will then ask the user for  a  new 
  2847.             password. No Data Line.
  2848.  
  2849.          18 Change  Screen Length allows the user to change his  screen 
  2850.             length (used for the More [Y/n] prompt). No Data Line.
  2851.  
  2852.          19 Toggle Clear Screen will switch the screen-clear codes sent 
  2853.             between menus on and off. No Data Line.
  2854.  
  2855.          20 Toggle  More  [Y/n] Prompt switches the prompt on  and  off 
  2856.             which  is  displayed at the end of each page  when  reading 
  2857.             text files, messages etc. No Data Line.
  2858.  
  2859.          21 Change Graphics Mode allows the user to select a  different 
  2860.             Graphics Mode. No Data Line.
  2861.  
  2862.          22 Check for Personal Mail will scan the message base for mail 
  2863.             to this user which he has not yet read. You can specify the 
  2864.             area number to scan on the Data Line.  If the Data Line  is 
  2865.             empty  all areas to which the user has access are  scanned. 
  2866.             You can also specify ALL, in this cases message To: ALL are 
  2867.             scanned.
  2868.  
  2869.          23 Read Messages allows the user to read messages in the  area 
  2870.             number supplied on the Data Line,  as long has he has read-
  2871.             access to that area. See the section on Messages.
  2872.  
  2873.          24 Scan  Messages displays the headers of the messages in  the 
  2874.             area number supplied on the Data Line if the user has read- 
  2875.             access.  The  user is asked if he wants to Mark a  message, 
  2876.             this can be read with Read Messages (Marked)  later.  Refer 
  2877.             to the section on Messages.
  2878.  
  2879.          25 QuickScan  Messages displays a list of the messages in  the 
  2880.             area number supplied on the Data Line if the user has read-
  2881.             access. Refer to the section on Messages.
  2882.  
  2883.          27 Write  a New Message is used to write messages in the  area 
  2884.             supplied on the Data Line.  The Data Line can also  contain 
  2885.             the /T and /L modifiers.  /T=First_Last forces the  message 
  2886.             to a certain name,  the /L modifier logs the user off after 
  2887.             the message has been completed.
  2888.  
  2889.          30 Raw  Directory  displays a list of files in  the  directory 
  2890.             specified in the Data Line.  The file names,  sizes,  times 
  2891.             and  dates  are displayed.  The files don't need to  be  in 
  2892.             FILES.BBS (see the section about File Areas).
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.      ------------------------------------------------------------------
  2900.      QuickBBS ST                                                Page 44
  2901.  
  2902.  
  2903.  
  2904.  
  2905.      QuickBBS ST                                                Page 45
  2906.      ------------------------------------------------------------------
  2907.  
  2908.          31 Display  File List shows the user the  formatted  FILES.BBS 
  2909.             file, with file names, sizes, dates and descriptions. Refer 
  2910.             to  the  section about File Areas.  The  Data  Line  should 
  2911.             contain the directory of the file area.
  2912.  
  2913.          32 Download  a  File allows the user to download one  or  more 
  2914.             files  from the directory specified in the Data  Line.  See 
  2915.             the section on File Areas.  The Data Line can also  contain 
  2916.             the name of the file to download.
  2917.  
  2918.          33 Upload a File lets the user upload one or more files to the 
  2919.             directory  specified in the Data Line.  See the section  on 
  2920.             File Areas for more information.
  2921.  
  2922.          34 Show  Contents of Archive prompts the user for the name  of 
  2923.             an .ARC,  .LZH,  .ZIP, .ZOO or .ZIP archive or .GIF picture 
  2924.             file  in  the directory specified in the  Data  Line,  then 
  2925.             displays  the contents of that archive or picture.  With  a 
  2926.             .GIF  file (picture) it can also test the integrity of  the 
  2927.             .GIF fil.
  2928.  
  2929.          35 Search  for a File by Keyword searches all areas  specified 
  2930.             in  FLSEARCH.CTL for a word supplied by the user.  See  the 
  2931.             section on File Areas.
  2932.  
  2933.          37 List New Files displays a list of new files since the  user 
  2934.             last  called.  The Data Line can contain the  directory  to 
  2935.             search.  If  the Data Line is empty all areas specified  in 
  2936.             FLSEARCH.CTL are used.  The user is prompted for a date  to 
  2937.             start  the scan from,  defaults to the last time  the  user 
  2938.             called.
  2939.  
  2940.          38 View Text File asks the user for the name of a text file in 
  2941.             the directory specified in the Data Line, then displays the 
  2942.             file.
  2943.  
  2944.          39 Display Text File lets the user read a text file which  you 
  2945.             specify in the Data Line. With this option you must specify 
  2946.             the full path, name and extension of the file to display.
  2947.  
  2948.          40 Replace Menu Text is used with Automatic Menu Execution and 
  2949.             allows you to replace the menu Text Line with the  contents 
  2950.             of a graphics file. Automatic Execution is explained below. 
  2951.             The Data Line is the same as in type 5.
  2952.  
  2953.          41 Toggle  Full Screen Editor switches the Full Screen  Editor 
  2954.             on and off.  No Data Line. The user can't switch on the FSE 
  2955.             in ASCII mode.
  2956.  
  2957.          45 Display Text File with Return is the same as option type 5, 
  2958.             but displays the 'Press Return' prompt when done and  waits 
  2959.             for the user to press Return.
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.      ------------------------------------------------------------------
  2966.      QuickBBS ST                                                Page 45
  2967.  
  2968.  
  2969.  
  2970.  
  2971.      QuickBBS ST                                                Page 46
  2972.      ------------------------------------------------------------------
  2973.  
  2974.          57 Change  Voice  Phone of the current  user,  if  nothing  is 
  2975.             entered then it won't be changed.  The phonenumber is  only 
  2976.             changed in USERS.BBS and not in NEWUSER.LOG.
  2977.  
  2978.          58 Change Data Phone is the same as 57, except that it changes 
  2979.             the Data phone number.
  2980.  
  2981.          80 Online  Archiver  is used to extract parts of  archives  to 
  2982.             download.  See  the  section on Online  Archives  for  more 
  2983.             information.  The  Data Line specifies the directory  which 
  2984.             contains the archive to extract from.
  2985.  
  2986.          81 Pump File will send a file to the user without interpreting 
  2987.             any control codes.  This can be used for things like VidTex 
  2988.             graphics.  The Data Line should contain the full path, name 
  2989.             and extension of the file to display,  preceded by a + or a 
  2990.             -  modifier.  If  the  modifier  is a -  the  file  is  not 
  2991.             displayed locally.
  2992.  
  2993.          82 Select  Menu  Optimiser  will display  the  Menu  Optimiser 
  2994.             selection menu, which is explained below. No Data Line.
  2995.  
  2996.          83 File Browser starts the File Browser,  explained later. The 
  2997.             Data Line contains the full path, name and extension of the 
  2998.             file to view.
  2999.  
  3000.          84 File Mark Menu is a sort of browser for your download.  The 
  3001.             optional  data line takes a path to the  download  area.  A 
  3002.             User can step trough a files.bbs listing here,  jump  pages 
  3003.             ahead  etc.  He  can also mark file for  download.  In  the 
  3004.             current  version of QuickBBS it only remembers  the  marked 
  3005.             files  for the current area.  Mor info can be found in  the  
  3006.             Section about File Areas.
  3007.  
  3008.          85 Mail Area Lister generates a list of mailareas for the user 
  3009.             to  choose from.  This is not for the Novice sysop  though. 
  3010.             The  optional Data line takes as first parameter the  Group 
  3011.             number  of  the  areas to list,  this number  is  enter  in 
  3012.             Mconfig.  The second option is optional,  if used you  must 
  3013.             put there the name of the menu that it has to Jump to after 
  3014.             the  user has made a selection.  If you omit this the  user 
  3015.             will be returned to the current menu.  The Mail Area Lister 
  3016.             will put on the optional data line of the menu:
  3017.             Areanumber Areaname
  3018.  
  3019.             You  can use &1 in the menu for the areanumber and  &2  for 
  3020.             the name of the area.
  3021.  
  3022.             For more info read the Section about Mail Areas.
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.      ------------------------------------------------------------------
  3032.      QuickBBS ST                                                Page 46
  3033.  
  3034.  
  3035.  
  3036.  
  3037.      QuickBBS ST                                                Page 47
  3038.      ------------------------------------------------------------------
  3039.  
  3040.          86 File Area Lister does the same job as option 85 but in this 
  3041.             case it's for the file areas. It works the same only in the 
  3042.             the         first  option on the optional data  line  is  a 
  3043.             string  that  must be  available in the description  of  an 
  3044.             area in FLSEARCH.CTL.  This  string is then deleted.So  for 
  3045.             example put (ATARI) after the atari   areas,  use as string 
  3046.             (ATARI).  Then  all areas with this string are    displayed 
  3047.             minus this string.
  3048.  
  3049.             This option also returns 2 items on the optional data  line 
  3050.             of the menu it will return to:
  3051.             Path Description (from FLSEARCH.CTL)
  3052.  
  3053.             So  you can use &1 as path info and &2 as areaname in  your 
  3054.             menu.
  3055.  
  3056.             For more info read the Section about File Areas.
  3057.  
  3058.  
  3059.      Quite a lot of different commands aren't there?  A shorter list of 
  3060.      these commands can be found in the appendix section.
  3061.  
  3062.      The  menu files (.MNU) are compatible to the ones used by  the  PC 
  3063.      version  of QuickBBS.  That version supports all types up  to  and 
  3064.      including type 57,  though there are some minor differences in the 
  3065.      Data  Lines.  The option types supported by QuickBBS ST  only  are 
  3066.      numbered 80 upwards, to avoid problems.
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.      ------------------------------------------------------------------
  3098.      QuickBBS ST                                                Page 47
  3099.  
  3100.  
  3101.  
  3102.  
  3103.      QuickBBS ST                                                Page 48
  3104.      ------------------------------------------------------------------
  3105.  
  3106.      MENU PARAMETERS
  3107.  
  3108.      If  you  have  a lot of different file or  mail  areas  you  would 
  3109.      normally  need  one menu for each area.  With the  PC  version  of 
  3110.      QuickBBS some SysOps have over 500 different menu files!  I  think 
  3111.      that is absolutely ridiculous,  so QuickBBS ST can pass parameters 
  3112.      from one menu to another.
  3113.  
  3114.      When you call a menu using GoTo (type 1),  GoSub (type 2) or Clear 
  3115.      Stack  and Goto (type 4) you can pass up to 10 parameters  to  the 
  3116.      menu  you  are calling.  These parameters are placed in  the  Data 
  3117.      Line,  after the name of the new menu.  They must be separated  by 
  3118.      spaces.
  3119.  
  3120.      These  parameters  can  be used in the new menu  by  placing  a  & 
  3121.      character  in the text or data line,  followed by a  number.  That 
  3122.      number selects the parameter to insert into the text or data line.
  3123.  
  3124.      An  example:  you call a menu called UPDOWN with a GoSub  command. 
  3125.      The data line used to call it is...
  3126.  
  3127.           UPDOWN Communications_programs \QBBS\DOWNLOAD\COMMS\
  3128.  
  3129.      the new menu is loaded and displayed.  The first option in  UPDOWN 
  3130.      is  a Text Line (type 0).  It displays the name of the  file  area 
  3131.      which this menu is used for.  So the Text Line of the first option 
  3132.      would be something like...
  3133.  
  3134.           Current Area : &1.
  3135.  
  3136.      ...Quick would translate that to...
  3137.  
  3138.           Current Area : Communications programs.
  3139.  
  3140.      ( Note  that  Quick replaces the underscores with a space  in  the 
  3141.        Text Line only )
  3142.  
  3143.      Then  you could have an option to - say - download  a  file.  That 
  3144.      might have a Data Line which contains only &2. Quick would replace 
  3145.      that  '&2'  with  the  second  parameter  passed  to  UPDOWN,  the 
  3146.      directory \QBBS\DOWNLOAD\COMMS\. The file would be downloaded from 
  3147.      that directory.
  3148.  
  3149.      On most boards each file or mail area menu looks exactly the same, 
  3150.      except  the  name of the area and the directory of that  area  are 
  3151.      different.  With  QuickBBS ST you can create one uniform menu  and 
  3152.      call  it with different parameters,  saving you lots and  lots  of 
  3153.      work!
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.      ------------------------------------------------------------------
  3164.      QuickBBS ST                                                Page 48
  3165.  
  3166.  
  3167.  
  3168.  
  3169.      QuickBBS ST                                                Page 49
  3170.      ------------------------------------------------------------------
  3171.  
  3172.      AUTOMATIC MENU EXECUTION
  3173.  
  3174.      NOTE:  This topic isn't suitable for novice SysOps. If you've only 
  3175.             just started using QuickBBS, skip this part.
  3176.  
  3177.      Automatic  Menu Execution,  sometimes called AutoExec  for  short, 
  3178.      makes  Quick  execute  the option while the  menu  file  is  being 
  3179.      loaded.  You can define an AutoExec option by giving it a ^A  key. 
  3180.      This  is  a little difficult in the current version  of  the  menu 
  3181.      editor,  but nevertheless possible.  Move the highlight to the key 
  3182.      field  and  press Control-A.  Then type 1 and  press  Return.  You 
  3183.      should see an arrow pointing upwards. This is a raw ^A character.
  3184.  
  3185.      AutoExec options are quite powerful.  One option type is specially 
  3186.      made for AutoExec-ing. It's type 40,  and can be  used to  replace
  3187.      the Text Line of the AutoExec option with the  contents of a  file
  3188.      in the  Text  File Directory.  That file can contain all the usual
  3189.      control and escape  codes, except for  the Press Return and  Enter
  3190.      Line codes. This  way you can  create  customised  VT-52 and  Ansi
  3191.      menus! Type 40 can only be used as an AutoExec option.  It will be
  3192.      ignored if it isn't automatically executed.
  3193.  
  3194.      Using  AutoExec  you  can get Quick to  execute  any  option  type 
  3195.      automatically.  The only 'but' is this:  when the option has  been 
  3196.      executed the rest of the menu is handled, except when the AutoExec 
  3197.      option loaded a new menu. In that case the menu is re-loaded after 
  3198.      a Return, and the AutoExec option is executed again.
  3199.  
  3200.      One way to get round this problem is to work with flags. By giving 
  3201.      the AutoExec option a 'required flag',  and clearing that flag  in 
  3202.      the sub-menu (using a .DOR file).  Then the AutoExec option  isn't 
  3203.      executed on return, because the required flag isn't set.
  3204.  
  3205.      THE MENU OPTIMISER
  3206.  
  3207.      For non-ASCII users Quick provides a Menu Optimiser.  It  replaces 
  3208.      multiple spaces,  carriage returns and line feeds by VT-52 or Ansi 
  3209.      escape codes to position the cursor,  but only if the escape  code 
  3210.      is  shorter  than the original.  At 300 and 1200 baud  this  makes 
  3211.      quite a lot of difference!  The Menu Optimiser can switched on and 
  3212.      off with option type 82.
  3213.  
  3214.      In  some  cases  it  is undesirable to  have  the  Menu  Optimiser 
  3215.      switched  on.  For instance,  if you want to send coloured  spaces 
  3216.      (spaces  with a background colour greater than 0),  the  optimiser 
  3217.      might  jump over some 'coloured' background with an  escape  code. 
  3218.      There is a special control code which you can put in your AutoExec 
  3219.      graphic files.  It's ^O,  and it temporarily toggles the optimiser 
  3220.      on and off.
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.      ------------------------------------------------------------------
  3230.      QuickBBS ST                                                Page 49
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.      ==================================================================
  3238.      ======================== Section 7 : Messages ====================
  3239.      ==================================================================
  3240.  
  3241.      THE MESSAGE SYSTEM
  3242.  
  3243.      QuickBBS  can handle up to 200 different Message Areas  (sometimes 
  3244.      called Boards).  Each area has a number ranging from 1 to 200. All 
  3245.      messages  in  one area are stored in two files,  located  in  your 
  3246.      Message File Directory.
  3247.  
  3248.      These files are called nnnn.HDR and nnnn.MSG,  where 'nnnn' is the 
  3249.      number of the area (decimal).  The .HDR files contain the  message 
  3250.      headers (from, to, subject etc). The actual message text is stored 
  3251.      in the .MSG files.
  3252.  
  3253.      You  can  assign the area numbers with the  program  MConfig.  The 
  3254.      message base configuration is read from BOARDS.BBS which should be 
  3255.      in your CONF\ directory.
  3256.  
  3257.      Each  area has an area name,  which is displayed to the  user.  If 
  3258.      this  area name is blank the message area doesn't exist as far  as 
  3259.      Quick is concerned. The areas must also have a specific area type. 
  3260.      This can be one of the following types...
  3261.  
  3262.      » Local        messages  are  not  sent  to  any  other  nodes  in 
  3263.                     FidoNet.
  3264.      » EchoMail     messages are sent to all FidoNet nodes connected to 
  3265.                     this EchoMail area.
  3266.      » NetMail      messages  are  sent to the FidoNet  node  the  user 
  3267.                     specified.
  3268.  
  3269.      If  you  are running a Stand-Alone BBS all areas should  be  Local 
  3270.      areas.  Refer  to  the section on FidoNet  for  information  about 
  3271.      EchoMail and NetMail.
  3272.  
  3273.      You  can specify what kind of messages you want to allow  in  this 
  3274.      area...
  3275.  
  3276.      » Public       means the messages written in this area may only be 
  3277.                     public (i.e.  anyone who has access to the area can 
  3278.                     read them).
  3279.      » Private      means  the messages in this area must  be  private, 
  3280.                     only  the SysOp,  the writer and the  receiver  can 
  3281.                     read them (if they have access to the area).
  3282.      » Both         means the messages can be either public or private. 
  3283.                     The user is asked which kind of message he wants to 
  3284.                     write.
  3285.  
  3286.      If you have specified the area as EchoMail you will have to  enter 
  3287.      an Origin Line. Refer to the FidoNet section.
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.      ------------------------------------------------------------------
  3296.      QuickBBS ST                                                Page 50
  3297.  
  3298.  
  3299.  
  3300.  
  3301.      QuickBBS ST                                                Page 51
  3302.      ------------------------------------------------------------------
  3303.  
  3304.      MESSAGE AREA ACCESS
  3305.  
  3306.      Each message area has three sets of Security Levels and Flags. The 
  3307.      user  can access the area in three different ways,  if he has  the 
  3308.      required Security Level and Flags...
  3309.  
  3310.      » Read Access  allows him to read messages in this area,
  3311.      » Write Access allows him to reply to messages in this  area,  and 
  3312.                     to post new messages,
  3313.      » SysOp Access allows him to read all private mail and delete  any 
  3314.                     messages.
  3315.  
  3316.      If the user tries to read messages in an area he doesn't have read 
  3317.      access to Quick will tell him so and return to the menu. Same with 
  3318.      Write.  If  the user has Sysop Access the Read Messages menu  will 
  3319.      just contain some extra options (to delete the message, send it to 
  3320.      the printer, forward it etc).
  3321.  
  3322.      THE LANGUAGE CHECK FILE
  3323.  
  3324.      A  lot  of EchoMail areas are international.  In  such  areas  all 
  3325.      messages should be written in English. There are thousands of dim-
  3326.      witted  users out there who either don't care or don't  know,  and 
  3327.      write their messages in German,  French,  Dutch or whatever  other 
  3328.      language they fancy.
  3329.  
  3330.      QuickBBS  can put an end to all that with the Language  Check.  If 
  3331.      you switch this on in MConfig all messages the users write in that 
  3332.      area  are checked before they are saved.  To enable this  checking 
  3333.      you must also switch it on in QConfig.
  3334.  
  3335.      Of  course you have to tell Quick how to check the  message.  That 
  3336.      can be done with the LANGUAGE.BBS file,  a plain ASCII one located 
  3337.      in the CONF\ directory. It contains one word per line. These words 
  3338.      may not appear in the message.  Each language has some words  that 
  3339.      can't be used in English,  but are often used in messages.  That's 
  3340.      the kind of words you want.  You might like to put some dirty ones 
  3341.      in there too...
  3342.  
  3343.      If  the  message contains illegal words the file LANGUAGE  in  the 
  3344.      text file directory is displayed. The user is then returned to the 
  3345.      message editor to correct his mistake.
  3346.  
  3347.      THE UPPERCASE CHECK
  3348.  
  3349.      Another old favourite of dumb users is an UPPERCASE message.  Some 
  3350.      people just don't know what that the CapsLock key is for.  You can 
  3351.      get  Quick  to check for this too by switching  on  the  UpperCase 
  3352.      Check options in MConfig and QConfig.
  3353.  
  3354.      When  the user tries to save a message Quick will test  each  line 
  3355.      for lowercase characters. If a lowercase character is found in any 
  3356.      line,  the message is saved.  If no lowercase characters are found 
  3357.      the  file  UPPER  is displayed and the is  user  returned  to  the 
  3358.      message editor.
  3359.  
  3360.  
  3361.      ------------------------------------------------------------------
  3362.      QuickBBS ST                                                Page 51
  3363.  
  3364.  
  3365.  
  3366.  
  3367.      QuickBBS ST                                                Page 52
  3368.      ------------------------------------------------------------------
  3369.  
  3370.      ALLOW THE USE OF AN ALIAS
  3371.  
  3372.      On  most  Bulletin Boards you must use your real  name.  The  same 
  3373.      applies  to most mailnetworks.  But sometimes your are allowed  to 
  3374.      use  an  alias  (Fakename  etc.).  For  example  in  Role  Playing 
  3375.      Adventures every everone as there own fanatsie name.
  3376.      So  this options allows the user to use a different name for  this 
  3377.      area only. The Alias is only remembered for the current session.
  3378.  
  3379.      ALLOW 8 BIT CHARACTERS
  3380.  
  3381.      In  most  networks  you are only allow to  use  ASCII  characters, 
  3382.      mainly because the characters above 127 are not  standarized.  But 
  3383.      in some country's you need those (mostly scandinavian). So you can 
  3384.      allow the use for 8 bit characters per area.  Do make sure you ask 
  3385.      if this is allowed!
  3386.  
  3387.      FILE ATTACHED MESSAGES
  3388.  
  3389.      With  this flag you can let user attach a file to a  message.  The 
  3390.      user  will be asked if he wants to attach a file to  the  message. 
  3391.      The  file  can  then  be downloaded by  the  one  the  message  is 
  3392.      addressed to. The file can only be download by the user in the To: 
  3393.      field,  the only exception is if the message is addressed to  ALL, 
  3394.      in that case everyone can download the file.
  3395.      The message wil first be shown, after that the user is asked if he 
  3396.      wants to download a file. Mind you can recieve file attach message 
  3397.      from all areas, you must only allow it for them to be posted.
  3398.  
  3399.      The  file  is put into \QBBS\PVT_FILE\ and  the  filename/path  is 
  3400.      stored  in the subject field,  which can't be edited  anymore  for 
  3401.      safety  reasons.  The With file flag is also set.  This system  is 
  3402.      compatible  with  Fidonet,  so  you can also  send  file  attached 
  3403.      message from say LED.
  3404.  
  3405.      On  thing though,  you can also make the netmail area file  attach 
  3406.      but  take in account that you generally are not allowed  to  route 
  3407.      file  attached message over/via other systems,  you  should  bring 
  3408.      them by crashmail.
  3409.  
  3410.      GROUP NUMBER
  3411.  
  3412.      This is a number from 0 to 255 where 0 disables the group  number. 
  3413.      Currently this is only used in menu option 85 (Mail Area  Lister). 
  3414.      You can divided your message areas into groups, for example:
  3415.  
  3416.      Group nr 1: Local areas
  3417.      Group nr 2: National echomail areas
  3418.      Group nr 3: International echomail areas
  3419.      Group nr 4: Atari areas
  3420.      etc. etc.
  3421.  
  3422.      With Menu type 85 you can use this group to make several lists  of 
  3423.      areas.  This will make life very easy for the sysop.  He now  only 
  3424.      needs  to add a new area in mconfig and pronto it appears  in  the 
  3425.      area list in the BBS...
  3426.  
  3427.      ------------------------------------------------------------------
  3428.      QuickBBS ST                                                Page 52
  3429.  
  3430.  
  3431.  
  3432.  
  3433.      QuickBBS ST                                                Page 53
  3434.      ------------------------------------------------------------------
  3435.  
  3436.      LASTREAD POINTERS
  3437.  
  3438.      QuickBBS keeps track of which messages the user has read in  every 
  3439.      area.  These  pointers are stored in the file LASTREAD.BBS in  the 
  3440.      home directory. They are used in two ways:
  3441.  
  3442.      » In the MailScan the message areas are scanned starting with  the 
  3443.        first unread message.
  3444.      » When a user selects the [N]ew option from the read messages menu 
  3445.        the first unread message is displayed.
  3446.  
  3447.  
  3448.      PACKING THE MESSAGE BASE
  3449.  
  3450.      Once you are running your BBS the message base will get larger and 
  3451.      larger  unless  you  do something about  it.  This  is  where  the 
  3452.      FastPack  program  comes in.  It packs your  message  base,  which 
  3453.      means...
  3454.  
  3455.      » Deleted messages are always removed.
  3456.      » You can define how old a message may be before it is removed.
  3457.      » You  can define a minimum number of messages which  must  always 
  3458.        remain in a certain area.
  3459.  
  3460.      It's a good idea to pack your message base once a day if you  have 
  3461.      a  busy  system.  The FastPack program has its  own  documentation 
  3462.      files.
  3463.  
  3464.      There  are  other programs that can pack and update  the  lastread 
  3465.      pointers too, some names:
  3466.      Bermuda
  3467.      Jetmail
  3468.      IOS
  3469.      etc.
  3470.  
  3471.      Mind you be carefull with those,  always check if they update  the 
  3472.      pointers the right way.  If you have problems with wrong  pointers 
  3473.      then let the programmer of the packer contact us,  so we can  tell 
  3474.      him the exact format of the pointers and how to work with them.
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.      ------------------------------------------------------------------
  3494.      QuickBBS ST                                                Page 53
  3495.  
  3496.  
  3497.  
  3498.  
  3499.      QuickBBS ST                                                Page 54
  3500.      ------------------------------------------------------------------
  3501.  
  3502.      THE MAIL AREA LISTER
  3503.  
  3504.      This is menutype 85.  With this option you can generate a list  of 
  3505.      Mail Areas for the user to choose from.  You can choose what areas 
  3506.      to  list by using a the group number.  The areas are  also  sorted 
  3507.      alfabeticly to make it easier to read.
  3508.  
  3509.      The Optional Data Line looks like:
  3510.  
  3511.            <groupnumber> (up/download menuname)
  3512.  
  3513.            1 readmail
  3514.  
  3515.      Now only mail areas that have group number 1 are shown.
  3516.  
  3517.      The groupnumber is entered in mconfig, see above,
  3518.  
  3519.      The second parameter is the menu it will jump to. You can also 
  3520.      leave  this out, it will return you then  to the current menu, for 
  3521.      example if you use a Change Area option in your readmail menu.
  3522.  
  3523.      After the use made a choice the menu readmail (in this example)
  3524.      will be run. On the optional data line it will put:
  3525.  
  3526.       <areanumber> <description>
  3527.  
  3528.       20 From/To_the_sysop
  3529.  
  3530.      In  the  menu  readmail you can use &1 as  areanumber  and  &2  as 
  3531.      description.
  3532.  
  3533.      Here is another example.  You have a mail menu in where the   user 
  3534.      can choose between National,  International and local areas. If he 
  3535.      does  it will run a mailarealist menu that will run  the  readmail 
  3536.      menu:
  3537.  
  3538.      Mail -> Mailarealist -> Readmail
  3539.  
  3540.      Mail:
  3541.  
  3542.                     [N] National areas
  3543.                     [I] International areas
  3544.                     [L] Local areas
  3545.  
  3546.      Readmail menu:
  3547.  
  3548.                     [R] Read messages
  3549.                     [W] Write messages
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.      ------------------------------------------------------------------
  3560.      QuickBBS ST                                                Page 54
  3561.  
  3562.  
  3563.  
  3564.  
  3565.      QuickBBS ST                                                Page 55
  3566.      ------------------------------------------------------------------
  3567.  
  3568.      The mailarealist menu will have to options:
  3569.  
  3570.      1: Type 85, Optional data: 1 readmail
  3571.      2: Type 3, Return from gosub.
  3572.  
  3573.      Both lines have ^A as key. This way they are run directly when the 
  3574.      menu  is called.  So if you choose N for national you will  get  a 
  3575.      list  with  national areas.  After you make your choice  the  menu 
  3576.      readmail  is  run.  When  you return from this menu  you  will  be 
  3577.      presented with the list again.
  3578.  
  3579.      This  option is not for the novice sysop,  but it will  make  much 
  3580.      easier for the experienced sysop as now you only need to enter new 
  3581.      areas  into MCONFIG and you don't have to be bother  with 
  3582.      having to adapt all those menu's.
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.      ------------------------------------------------------------------
  3626.      QuickBBS ST                                                Page 55
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.      ==================================================================
  3634.      ======================= Section 8 : Files ========================
  3635.      ==================================================================
  3636.  
  3637.      FILE AREAS
  3638.  
  3639.      The number of file areas you have is only limited to the amount of 
  3640.      free disk space.  Each file area must have its own directory. That 
  3641.      directory must be specified on the Data Line in some menu options.
  3642.  
  3643.      Each directory should contain a FILES.BBS file.  This is an  ASCII 
  3644.      file with a description of each file in the area (=directory).
  3645.  
  3646.      One directory might contain the following files:
  3647.  
  3648.           FILES.BBS
  3649.           TCARC.TTP
  3650.           TCARC.DOC
  3651.           LHARC.PRG
  3652.           LHARC.DOC
  3653.  
  3654.      The FILES.BBS file should describe the other four  files,  perhaps 
  3655.      like this:
  3656.  
  3657.           +--------------------------------------------------------+
  3658.           |                      Archive programs                  |
  3659.           +--------------------------------------------------------+
  3660.  
  3661.           TCARC.TTP    [10] ARC compatible archiver, 50-80% faster.
  3662.           TCARC.DOC    [1]  Documentation for TCARC.
  3663.           LHARC.PRG    v201 of LHarc-ST, for using .LZH archives.
  3664.           LHARC.DOC    Documentation for LHarc-ST.
  3665.           STZIP.TOS    STZIP 2.2, for using .ZIP archives (with docs)
  3666.  
  3667.      When QuickBBS displays this list it will insert the size and  date 
  3668.      of  the  file between the name and the description.  If  the  file 
  3669.      isn't found the text '---MISSING---' is inserted instead.
  3670.  
  3671.      FILES.BBS can contain comments lines.  Any character which is  not 
  3672.      usually  part  of a file name can be used to  indicate  a  comment 
  3673.      line. Empty lines are also allowed, as are multiple spaces between 
  3674.      the file name and the description.
  3675.  
  3676.      If a description is too long to fit onto one line Quick will word-
  3677.      wrap  and indent it on the next line.  Your ASCII editor  must  be 
  3678.      able to handle long lines to use this feature.  Tempus can, and so 
  3679.      can  First Word.  Some versions of Micro Emacs can't  handle  long 
  3680.      lines.
  3681.  
  3682.      The number between brackets ([]) is the number of times a file  is 
  3683.      downloaded. QuickBBS updates this number after a download, you can 
  3684.      en/disable this option in qconfig under toggles.
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.      ------------------------------------------------------------------
  3692.      QuickBBS ST                                                Page 56
  3693.  
  3694.  
  3695.  
  3696.  
  3697.      QuickBBS ST                                                Page 57
  3698.      ------------------------------------------------------------------
  3699.  
  3700.      THE FILE SEARCH FILE
  3701.  
  3702.      ...is called FLSEARCH.CTL and can be found in the home  directory. 
  3703.      It's  an ASCII list of all file areas in your BBS.  Each line  has 
  3704.      the following layout:
  3705.  
  3706.             <path> <security> <description>
  3707.  
  3708.      where  <path> is the directory,  <security> is the security  level 
  3709.      needed  to  search the area and <description> is the name  of  the 
  3710.      area. An example:
  3711.  
  3712.             \QBBS\DOWNLOAD\GENERAL 10 General Area
  3713.             \QBBS\DOWNLOAD\COMMS   10 Communications Programs
  3714.             \QBBS\DOWNLOAD\UTILS   20 Utilities
  3715.             \QBBS\UPLOAD\GENERAL   50 Uploaded General Files
  3716.             \QBBS\UPLOAD\COMMS     50 Uploaded Comms Programs
  3717.             \QBBS\UPlOAD\UTILS     50 Uploaded Utilities
  3718.  
  3719.      The menu options New Files and Search for File use this file. Each 
  3720.      line  is  checked  for  a valid  Security  Level  and  (if  valid) 
  3721.      searched. Please note that the Security Levels in this file do not 
  3722.      affect uploading,  downloading, file lists etc. They are only used 
  3723.      in the two option types above.
  3724.  
  3725.      THE FILE AREA LISTER
  3726.  
  3727.      This is menutype 86.  With this option you can generate a list  of 
  3728.      File Areas for the user to choose from.  You can choose what areas 
  3729.      to  list  by  using a search string.  The areas  are  also  sorted 
  3730.      alfabeticly to make it easier to read.
  3731.  
  3732.      The Optional Data Line looks like:
  3733.  
  3734.            <searchstring> (up/download menuname)
  3735.  
  3736.            atari updown
  3737.  
  3738.      Now only file areas that have ATARI in the description are shown.
  3739.  
  3740.      This description is taken from the flsearch.ctl file. This way 
  3741.      you can make several list for different computers.
  3742.  
  3743.      The searchstring is case sensitive!! Mind you on the first      20 
  3744.      characters of the description are shown. The word ATARI will be 
  3745.      taken out of the list though!
  3746.  
  3747.      The second parameter is the menu it will jump to. You can also 
  3748.      leave  this out, it will return you then  to the current menu, for 
  3749.      example if you use a Change Area option in your up/download menu.
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.      ------------------------------------------------------------------
  3758.      QuickBBS ST                                                Page 57
  3759.  
  3760.  
  3761.  
  3762.  
  3763.      QuickBBS ST                                                Page 58
  3764.      ------------------------------------------------------------------
  3765.  
  3766.      After the use made a choice the menu updown (in this example) will
  3767.      be run. On the optional data line it will put:
  3768.  
  3769.       <path> <description>
  3770.  
  3771.       c:\atari\falcon\ Falcon_files
  3772.  
  3773.      In the up/down menu you can then use &1 as  path  and  &2  as  the
  3774.      description.
  3775.  
  3776.      Here is another example.  You have a files menu in where the  user 
  3777.      can choose between Atari,  MS-DOS, Amiga areas. IF he does it will 
  3778.      run a filelist menu that will run the up/download menu:
  3779.  
  3780.      Files -> Filelist -> Up/download
  3781.  
  3782.      Files:
  3783.  
  3784.                     [A] Atari areas
  3785.                     [M] MS-DOS
  3786.  
  3787.      Up/download menu:
  3788.  
  3789.                     [D] Download
  3790.                     [U] Upload
  3791.  
  3792.      The filelist menu will have to options:
  3793.  
  3794.      1: Type 86, Optional data: ATARI UPDOWN
  3795.      2: Type 3, Return from gosub.
  3796.  
  3797.      Both lines have ^A as key. This way they are run directly when the 
  3798.      menu is called.  So if you choose A for atari you will get a  list 
  3799.      with areas that have ATARI in de description.  After you make your 
  3800.      choice the menu up/down is run. When you return from this menu you 
  3801.      will be presented with the list again.
  3802.  
  3803.      This  option is not for the novice sysop,  but it will  make  much 
  3804.      easier for the experienced sysop as now you only need to enter new 
  3805.      areas  into the FLSEARCH.CTL and you don't have to be bother  with 
  3806.      having to adapt all those menu's.
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.      ------------------------------------------------------------------
  3824.      QuickBBS ST                                                Page 58
  3825.  
  3826.  
  3827.  
  3828.  
  3829.      QuickBBS ST                                                Page 59
  3830.      ------------------------------------------------------------------
  3831.  
  3832.      TRANSFER PROTOCOLS
  3833.  
  3834.      When a user wants to upload or download a file the first thing  he 
  3835.      sees  is  the  protocol menu.  If you  haven't  switched  off  any 
  3836.      protocols  in  QConfig the user can choose one  of  the  following 
  3837.      transfer methods:
  3838.  
  3839.      » Xmodem  is the oldest and slowest.  When   downloading  QuickBBS 
  3840.        will  detect  three flavours  of  Xmodem  automatically:  Xmodem 
  3841.        Checksum,  Xmodem CRC and Xmodem 1K. The first two are very slow 
  3842.        (about  50%  efficiency).  Xmodem 1K is slightly faster  if  the 
  3843.        connection is good (about 60%), but slower on bad lines.
  3844.  
  3845.      » Ymodem  is  derived from Xmodem.  For some  stupid  reason  some 
  3846.        communications and BBS programs think Xmodem 1K is Ymodem.  This 
  3847.        is not true.  Ymodem uses mixed 128 and 1024 byte blocks, and is 
  3848.        always  a  batch  protocol (more than one file can  be  sent  at 
  3849.        once). Ymodem is no faster than Xmodem 1K.
  3850.  
  3851.      » Windowed Xmodem is another Xmodem flavour.  It doesn't wait  for 
  3852.        the receiver to acknowledge the block,  but assumes that no news 
  3853.        is  good news.  Windowed Xmodem is much faster than  the  normal 
  3854.        Xmodem.  In some ways it's rather like SEAlink,  but it  doesn't 
  3855.        support batch transfers. Efficiency is about 75%.
  3856.  
  3857.      » Zmodem is the best of all.  It supports batch transfers,  and is 
  3858.        very  fast  (90% to 98% efficiency).  It also uses  32  bit  CRC 
  3859.        instead of 16 bit, making it much more reliable. If the transfer 
  3860.        fails during a Zmodem upload/download (carrier lost or any other 
  3861.        cause)  you  don't have to start all  over  again,  Zmodem  will 
  3862.        continue where it left off!
  3863.  
  3864.      The  efficiency  is the ratio between the actual  number of  bytes 
  3865.      transferred  per  second and the theoretically possible number  of 
  3866.      bytes per second.
  3867.  
  3868.      Always  use  Zmodem if at all possible.  It's  much  faster,  much 
  3869.      easier and much more reliable.
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.      ------------------------------------------------------------------
  3890.      QuickBBS ST                                                Page 59
  3891.  
  3892.  
  3893.  
  3894.  
  3895.      QuickBBS ST                                                Page 60
  3896.      ------------------------------------------------------------------
  3897.  
  3898.      UPLOADS & DOWNLOADS
  3899.  
  3900.      When  downloading  Quick will ask for the files  to  transfer.  If 
  3901.      Ymodem  or Zmodem are selected the user can type in more than  one 
  3902.      filename,  separated  by  spaces.  Quick will check  the  download 
  3903.      limit,  time  limit  and start the download.  If the  download  is 
  3904.      succesfull QuickBBS will add a number to the file description like 
  3905.      this:
  3906.  
  3907.                QUICKBBS.ZIP [100] The BEST Atari ST(E)/TT/Falcon BBS
  3908.  
  3909.      The  number between brackets [] is the number of times a  file  is 
  3910.      download.
  3911.  
  3912.      NOTE:     The  user can download any file from the  directory  you 
  3913.                specify.   A  file  doesn't  have  to  be  described  in 
  3914.                FILES.BBS for the user to download it.
  3915.  
  3916.      When uploading files with a non-batch protocol the user must  type 
  3917.      the  file  name.  The file may not yet exist in the  directory  to 
  3918.      which the user is uploading.  With a batch protocol Quick will not 
  3919.      allow  existing files to be overwritten.  After the  transfer  the 
  3920.      user  must type in a description for each file he  uploaded.  This 
  3921.      description will be added to the end of FILES.BBS.  The time  used 
  3922.      during an upload is added to the users time limit.
  3923.  
  3924.      The  log file SYSTEM.LOG will show you what the user has  uploaded 
  3925.      or  downloaded.  Two  additional log  files  are  updated,  called 
  3926.      UPLOAD.LOG and DOWNLOAD.LOG.
  3927.  
  3928.      Both  log files contain 1 file per line.  Lines starting  with  an 
  3929.      asterisk  (*) should be ignored.  Each line in UPLOAD.LOG has  the 
  3930.      following format:
  3931.  
  3932.        TP User_Name FILESPEC Description
  3933.  
  3934.      and DOWNLOAD.LOG just contains:
  3935.  
  3936.        TP User_Name FILESPEC
  3937.  
  3938.      where...
  3939.  
  3940.      » TP is the transfer protocol:
  3941.  
  3942.        »» XM : Xmodem Checksum or CRC
  3943.        »» XK : Xmodem 1K
  3944.        »» YM : Ymodem
  3945.        »» WX : Windowed Xmodem
  3946.        »» ZM : Zmodem
  3947.  
  3948.      » User_Name  is the name of the user,  with an underscore to  mark 
  3949.        spaces,
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.      ------------------------------------------------------------------
  3956.      QuickBBS ST                                                Page 60
  3957.  
  3958.  
  3959.  
  3960.  
  3961.      QuickBBS ST                                                Page 61
  3962.      ------------------------------------------------------------------
  3963.  
  3964.      » FILESPEC is the path + name of the file,
  3965.  
  3966.      » Description is the file description entered by the user.
  3967.  
  3968.      Example:  James  Bond  uploads  a file called  PACMAN.LZH  to  the 
  3969.      General Area. He uses Zmodem to upload the file. The line added to 
  3970.      UPLOAD.LOG would be something like...
  3971.  
  3972.        ZM James_Bond \QBBS\UPLOAD\GENERAL\PACMAN.LZH Very old game.
  3973.  
  3974.      The line is only added if the transfer was successful,  of course, 
  3975.      and  ONLINE.ARC  and  ONLINE.LZH (see Online  Archiver)  are  also 
  3976.      added, when they are downloaded.
  3977.  
  3978.      TRANSFER DRIVERS
  3979.  
  3980.      At the moment Quick uses a number of different driver programs  to 
  3981.      upload and download files. Some are internal, others are external. 
  3982.      In QConfig you can select whether you wish to use the internal  or 
  3983.      the external drivers. This is what Quick uses:
  3984.  
  3985.      » XFER.000     is always used for Ymodem and Windowed  Xmodem.  In 
  3986.                     QConfig  you  can  get Quick to use  this  for  the 
  3987.                     'normal' Xmodem transfers too.
  3988.  
  3989.      The  driver   must  be in the home  directory.  Try  the  internal 
  3990.      drivers first. If they cause problems switch to the external  one,  
  3991.      and please let us know what's going wrong!
  3992.  
  3993.      EXTERNAL PROTOCOLS
  3994.  
  3995.      To top it all off you can hang virtual every protocol on  QuickBBS 
  3996.      using  the  external  protocol interface.  You  must  Configure  a 
  3997.      protocol  firstly in Qconfig under the external protocol  section. 
  3998.      Read that section of the document first! You must also make a kind 
  3999.      of script file for each protocol.  We use the door file  interface 
  4000.      for  this.  As  example there are some .DOR  files  included.  For 
  4001.      example ZMODEM.DOR for XYZ.TTP, it might look like:
  4002.  
  4003.      uploadpath D:\ATARI\UPLOADS\
  4004.      upload     C:\QBBS\XYZ.TTP -c D:\ATARI\UPLOADS\
  4005.      download   C:\QBBS\XYZ.TTP -U -c *PATH*FILES
  4006.  
  4007.      *PATH is replaced by the current path, and *FILES by the files the 
  4008.      user wants to download.
  4009.      Upload  defines  the  filename of the  upload  protocol  and  it's 
  4010.      commandline.
  4011.      Download does the same for the download protocol.
  4012.      Uploadpath  is  special  and  only need  if  you  have  1  special 
  4013.      uploadpath.  Normally  QuickBBS scans the *PATH (current path) for 
  4014.      new uploaded files. If Uploadpath is specified then that directory 
  4015.      is scanned in stead.
  4016.  
  4017.      You can use almost all .DOR file commands in this file too,  mayby 
  4018.      you  need it to generate a commandline.  But the complete .DOR  is 
  4019.      read. After that is done QuickBBS will start the protocol.
  4020.  
  4021.      ------------------------------------------------------------------
  4022.      QuickBBS ST                                                Page 61
  4023.  
  4024.  
  4025.  
  4026.  
  4027.      QuickBBS ST                                                Page 62
  4028.      ------------------------------------------------------------------
  4029.  
  4030.      THE ONLINE ARCHIVER
  4031.  
  4032.      Ever  wanted  to download the documentation files from  a  200  Kb 
  4033.      archive  before  you downloaded the rest,  just to make  sure  you 
  4034.      really   want  it?   Or  perhaps  you've  lost  that  one   little 
  4035.      configuration file from a large archive?  In that case the  Online 
  4036.      Archiver would come in very handy.
  4037.  
  4038.      The  Online Archiver lets you extract files from one or more  .ARC 
  4039.      or  .LZH  archives and put them into a  temporary  archive  called 
  4040.      ONLINE.ARC or ONLINE.LZH, ready for downloading.
  4041.  
  4042.      These  Online Archives are placed in a directory you specified  in 
  4043.      QConfig. They can be downloaded from the Online Archiver menu, and 
  4044.      are  deleted  when Quick exits.  In QConfig you  can  specify  the 
  4045.      maximum size of these archives in Kb, or (by entering 0) let Quick 
  4046.      use all available disk space, minus a small safety buffer.
  4047.  
  4048.      If  no  Online Archive exists the user is required  to  select  an 
  4049.      archive type - Arc or LHarc. Because different compression methods 
  4050.      are used these two can't be mixed.  The user can then add files to 
  4051.      the  Online Archive,  remove files,  clear the whole archive  (and 
  4052.      select a new type) or download it.
  4053.  
  4054.      QuickBBS  doesn't need ARC or LHarc to create  the  archives.  The 
  4055.      archiving routines are internal.
  4056.  
  4057.      If  an error occurs during an archive operation  (perhaps  because 
  4058.      of a damaged archive) the log file will contain a warning,  so you 
  4059.      can do something about it. The Online Archive will be cleared.
  4060.  
  4061.      The  Online Archiver menus each have a help option  which  display 
  4062.      the  OARCTYPE  and OARCHELP files.  You will have to  promote  the 
  4063.      Online Archiver a bit.  Most users haven't the slightest idea what 
  4064.      it is,  and don't go to the 'trouble' of finding out how it  works 
  4065.      if they do know what it is... Just say it saves money, and they'll 
  4066.      come around sooner or later 8-)
  4067.  
  4068.      THE FILE BROWSER
  4069.  
  4070.      is  menu  option type 83.  A textfile is split up into  pages  and 
  4071.      displayed page by page,  with a menu inbetween each page  allowing 
  4072.      the user to move forward, backward etc. as well as search the text 
  4073.      for a string or jump to a certain page.  You could put a table  of 
  4074.      contents on page 1, and let the user use the 'Goto' option to jump 
  4075.      to the page of his choice.
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.      ------------------------------------------------------------------
  4088.      QuickBBS ST                                                Page 62
  4089.  
  4090.  
  4091.  
  4092.  
  4093.      QuickBBS ST                                                Page 63
  4094.      ------------------------------------------------------------------
  4095.  
  4096.      MARK FILE MENU
  4097.  
  4098.      Is menutype 84.  It looks a bit like the browser.  A user can list 
  4099.      the files in an area.  he can also jump to a certain page. Jumping 
  4100.      to the last page will show him the newest files.
  4101.      He  can mark files to download.  With M of Mark you will get  into 
  4102.      the Mark files menu.  Here you can mark a file for download,  just 
  4103.      enter it's number.  The user can also list what files are  already 
  4104.      marked  en  delete some of them for the list.  If  he  decides  to 
  4105.      download he can choose Download from the main menu. All files will 
  4106.      be send (if he his levels check out!).  The marked files are  only 
  4107.      remember  if  the user stays in the Mark File menu.  In  a  future 
  4108.      version you can expect global downloads.
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.      ------------------------------------------------------------------
  4154.      QuickBBS ST                                                Page 63
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.      ==================================================================
  4162.      ======================= Section 9 : Doors ========================
  4163.      ==================================================================
  4164.  
  4165.      EXTERNAL PROGRAMS
  4166.  
  4167.      Quick can start up external programs,  also known as Doors.  A lot 
  4168.      of  boards run DoorGames,  where the user can play a game  against 
  4169.      other users of the BBS.
  4170.  
  4171.      Menu option type 7 (Execute Program) will run anything you specify 
  4172.      on  the  Data Line  (path+name+extension).  Everything  after  the 
  4173.      program  name is passed to that program on the command  line.  The 
  4174.      current directory is changed to the directory where the program is 
  4175.      located.
  4176.  
  4177.      External  programs may never modify the order of the user base  or 
  4178.      the  LastRead pointers.  The program may change the  current  user 
  4179.      record,  but  that  wouldn't make much sense  because  Quick  will 
  4180.      overwrite it when the user logs off.
  4181.  
  4182.      Because Quick remains in memory while an external program is being 
  4183.      executed  you  will need enough spare RAM.  Any program  which  is 
  4184.      started while the user is online should...
  4185.  
  4186.      » trap errors and exit if one occurs. It should not wait for input 
  4187.        from the SysOp.
  4188.      » monitor the carrier and exit if the carrier is lost.
  4189.      » keep  track of the amount of time the user has  left,  and  exit 
  4190.        when the time is nearly up.
  4191.      » exit  if the user doesn't type anything for a minute or two  (in 
  4192.        case he's fallen asleep).
  4193.      » handle its own modem I/O.
  4194.  
  4195.      Most DoorGames have some way of doing this. But, you ask, how does 
  4196.      the program know how much time the user has left?  It can find out 
  4197.      in two of different way:
  4198.  
  4199.      » The data line can contain a command line to pass to the program. 
  4200.        There are some special codes that you can put in there which are 
  4201.        replaced by Quick:
  4202.  
  4203.        »» *A is replaced by the users current alias,
  4204.        »» *B is replaced by the current baudrate or 0 in local mode,
  4205.        »» *C is replaced by the errorlevel that is returned when a
  4206.              program is executed
  4207.        »» *F is replaced by the users first name,
  4208.        »» *G is replaced by the number of the users graphics mode,
  4209.        »» *L is replaced by the users last name,
  4210.        »» *O is replaced by the users account,
  4211.        »» *P (privilege) is replaced by the users security level,
  4212.        »» *R is replaced by the users record number in USERS.BBS,
  4213.        »» *T  (time) is replaced by the number of minutes the user  has 
  4214.           left.
  4215.  
  4216.  
  4217.  
  4218.  
  4219.      ------------------------------------------------------------------
  4220.      QuickBBS ST                                                Page 64
  4221.  
  4222.  
  4223.  
  4224.  
  4225.      QuickBBS ST                                                Page 65
  4226.      ------------------------------------------------------------------
  4227.  
  4228.        A special case is *S, which makes Quick leave the Status Line at 
  4229.        the bottom of the screen on, handy for programs which don't show 
  4230.        you who is online.
  4231.  
  4232.        Another special case is the *E code, which executes the commands 
  4233.        in a little script file.  It must be the first code on the  data 
  4234.        line. More on that later.
  4235.  
  4236.        Example:  James  Bond is online at 2400 baud and has 20  minutes 
  4237.        left. If the data line is...
  4238.  
  4239.             \QBBS\GAMES\MR\MOONRAKE.TTP baud *B name *F time *T
  4240.  
  4241.        ...then   Quick   will   change   the   current   directory   to 
  4242.        \QBBS\GAMES\MR\, start up MOONRAKE.TTP with command line...
  4243.  
  4244.             baud 2400 name James time 20
  4245.  
  4246.        Refer  to the documentation of the program you wish to start  to 
  4247.        see what parameters it needs.
  4248.  
  4249.      » Before the program is started Quick will write a few  files from 
  4250.        which the external program can read the user info. The files are
  4251.  
  4252.        »» LASTUSER.LOG is compatible to Pandora.  It's plain ASCII, and 
  4253.           contains the users name on line 1, his security level on line 
  4254.           2, a zero on line 3 and finally the number of minutes left on 
  4255.           line 4.
  4256.  
  4257.        »» DORINFO1.DEF is also an ASCII file, and contains...
  4258.  
  4259.           »»» the SysOps first name,
  4260.           »»» the SysOps last name,
  4261.           »»» the current baudrate (0 = Local),
  4262.           »»» the users first name,
  4263.           »»» the users last name,
  4264.           »»» where the guy lives,
  4265.           »»» his graphics mode,
  4266.           »»» the length of his screen,
  4267.           »»» his security level,
  4268.           »»» the number of minutes left,
  4269.           »»» his record number in the USERS.BBS file.
  4270.  
  4271.        »» FOREM.DAT  is compatible to the FoReM BBS program.  Refer  to 
  4272.           the FoReM documentation of info about this file,
  4273.  
  4274.        »» EXITINFO.BBS described in the developers guide.
  4275.  
  4276.        The  documentation of DoorGames will usually say what files  are 
  4277.        used.
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.      ------------------------------------------------------------------
  4286.      QuickBBS ST                                                Page 65
  4287.  
  4288.  
  4289.  
  4290.  
  4291.      QuickBBS ST                                                Page 66
  4292.      ------------------------------------------------------------------
  4293.  
  4294.      DOR FILES
  4295.  
  4296.      The special *E code can be used to execute a .DOR file.  The  data 
  4297.      line should contain something like
  4298.  
  4299.           *E game
  4300.  
  4301.      You can also pass parameters to the dor file like:
  4302.  
  4303.           *E game param1 param2 param3 param4
  4304.  
  4305.      You  can use these parameters in the .DOR file with the known  &1, 
  4306.      &2 etc. parameters.
  4307.  
  4308.      Quick will execute the commands it finds in a file called GAME.DOR 
  4309.      in the home directory. Valid commands in that file are:
  4310.  
  4311.      » ACCOUNT <number>  Changes the users account.  Number  can 
  4312.                          be expressed in three ways:
  4313.  
  4314.                          +n   increases the users account by n.
  4315.                          -n   decreases the users account by n.
  4316.                          n    sets the users account to n.
  4317.  
  4318.                          The  account  cannot  go above  or  below  the 
  4319.                          maximum or minimum set in qconfig.
  4320.  
  4321.                               ACCOUNT +10    (ACCOUNT up 10)
  4322.                               ACCOUNT -5     (ACCOUNT down 5)
  4323.                               ACCOUNT 50     (ACCOUNT set to 50)
  4324.  
  4325.      » CD <path>         Changes the current directory to  <path>.  Can 
  4326.                          change to another drive too. Example:
  4327.  
  4328.                               CD c:\qbbs\doors\galemp
  4329.  
  4330.      » CL <command>      Sets  the current command line which  will  be 
  4331.                          used when a program is executed (see EXEC)  to 
  4332.                          <command>,   which   may  contain  the   usual 
  4333.                          codes like *F, *B etc. but not *E. Example:
  4334.  
  4335.                               cl -N=*F_*L -T=*T
  4336.  
  4337.      » CLRFLAG <flag>    Is the opposite of SETFLAG and switches one of 
  4338.                          the users flags off.
  4339.  
  4340.      » CLS               Clears the screen
  4341.  
  4342.      » COPY <src> <dest> Copies file <src> to <dest>.  Full path may be 
  4343.                          specified,  but  wildcards  are  not  allowed. 
  4344.                          Example:
  4345.  
  4346.                               Copy lastuser.log \doors\ste\lastuser.log
  4347.  
  4348.  
  4349.  
  4350.  
  4351.      ------------------------------------------------------------------
  4352.      QuickBBS ST                                                Page 66
  4353.  
  4354.  
  4355.  
  4356.  
  4357.      QuickBBS ST                                                Page 67
  4358.      ------------------------------------------------------------------
  4359.  
  4360.      » CTIME  <number>    Increases,  decreases or sets time limit  for 
  4361.                           the rest of the current session.  Works  like 
  4362.                           ACCOUNT.
  4363.  
  4364.      » DEL <spec>        Deletes  all file matching  the  specification 
  4365.                          <spec>. Examples:
  4366.  
  4367.                               DEL \qbbs\doors\dorinfo1.def
  4368.                               Del \qbbs\temp\*.*
  4369.  
  4370.      » DEXIST <path>     Same as FEXIST, but for Directories (folders)
  4371.  
  4372.      » DLIMIT  <number>  Increases,  decreases or sets   the   download 
  4373.                          limit for the current session.  Works the same 
  4374.                          as ACCOUNT.
  4375.  
  4376.      » ECHO <text>       Same as Send, see there for info.
  4377.  
  4378.      » EXEC <program> <cl> Executes <program>, using the  command  line  
  4379.                          set with CL, or <cl> if used. QuickBBS  checks 
  4380.                          whether the file exists, releases (nearly) all 
  4381.                          memory  then executes.  You must  specify  the 
  4382.                          extension (e.g. STE.PRG or GALEMP.TOS). If the 
  4383.                          program  exits with  an  errorlevel,  QuickBBS 
  4384.                          will put that in the logfile. Examples:
  4385.  
  4386.                               Exec \doors\galemp\galemp.tos
  4387.                               EXEC ste.prg
  4388.  
  4389.      » EXIT              Stop  executing  the  current  .DOR  file  and 
  4390.                          return.
  4391.  
  4392.      » FEXIST <file>     Checks if <file> exist.  The result is  stored 
  4393.                          in the parameter *C. (*C=1 file exist)
  4394.      » GOTO <label>      Jump to a label.  A label is preced by a : and 
  4395.                          starts at the beginning of a line.  Example of 
  4396.                          a label:
  4397.  
  4398.                          :start
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.      ------------------------------------------------------------------
  4418.      QuickBBS ST                                                Page 67
  4419.  
  4420.  
  4421.  
  4422.  
  4423.      QuickBBS ST                                                Page 68
  4424.      ------------------------------------------------------------------
  4425.  
  4426.      » IF <value> <operator> <value> THEN <command>
  4427.                          <operator> can be :
  4428.                          =              equal
  4429.                          ~              equal, case independent
  4430.                          <>             not equal
  4431.                          >              greater than
  4432.                          <              smaller than
  4433.                          =>             greater or equal
  4434.                          <=             smaller or equal
  4435.                          $              contains the string
  4436.  
  4437.                          Valid parameters for <value> are :
  4438.                          All the *x parameters listed before and :
  4439.                          *C             result code of FEXIST or
  4440.                                         DEXIST
  4441.                          *ASC           the   ASCII  value    of    the 
  4442.                                         character pressed.
  4443.                          *CHR           the character pressed.
  4444.                          *TXT           string entered after  an  INPUT
  4445.                                         command.
  4446.                          &<n>           parameter n
  4447.  
  4448.                          <command> can be any .DOR command.
  4449.  
  4450.      » INPUT <type> [<len>] [<"str">]
  4451.                          Allows the user to enter a line of  text.  The 
  4452.                          string  entered  will be stored  in  the  *TXT 
  4453.                          parameter.
  4454.                          <type> can be ?
  4455.                            ANY         all characters (ASCII 32 .. 126)
  4456.                                        are valid
  4457.                            USER        to enter a username
  4458.                            PASSWORD    to enter a password, asterisks
  4459.                                        are echoed
  4460.                            FILE        to enter a file name
  4461.                          <len> (optional) is the maximum length of the
  4462.                                        the line (default is 80)
  4463.                          <"str"> (optional) is a string with valid
  4464.                                        characters. Put them between ""
  4465.  
  4466.      » KEY               Wait for the user to press a key.
  4467.                          The  characters  pressed  is  stored  in   two 
  4468.                          parameters:
  4469.                          *CHR         the key pressed
  4470.                          *ASC         the ASCII value of the key
  4471.                                       pressed
  4472.  
  4473.      » LEVEL <number>    Changes  the users security level.  Works  the 
  4474.                          same as with ACCOUNT.
  4475.  
  4476.      » LOCAL <text>      Almost identical to SEND and ECHO, but it only 
  4477.                          displays it locally (not via the modem)
  4478.  
  4479.  
  4480.  
  4481.  
  4482.      ------------------------------------------------------------------
  4483.      QuickBBS ST                                                Page 68
  4484.  
  4485.  
  4486.  
  4487.  
  4488.      QuickBBS ST                                                Page 69
  4489.      ------------------------------------------------------------------
  4490.  
  4491.      » LOG <option> <data> Writes <text> to the system log file
  4492.  
  4493.      » MENU <option> <data>
  4494.                          Execute a QuickBBS menu option.
  4495.                          <option> can be every menu option except for
  4496.                          the numbers 0 to 4, 7 and 40.
  4497.                          <data> is the optional data line you would
  4498.                          normally use.
  4499.  
  4500.      » PAUSE             Prompt and wait for a [Return]
  4501.  
  4502.      » PROMT <text>      Identical  to  SEND  and  ECHO  commands,  but 
  4503.                          leaves the cursor on the same line.  You could 
  4504.                          do and INPUT after this.
  4505.  
  4506.      » READMARKED        This  will try to read the file MARKED.DAT  in 
  4507.                          the QBBS directory.  This files should contain 
  4508.                          all message that have to be read.  After  this 
  4509.                          it will show all the marked messages. Read the 
  4510.                          mailscan section for more info.
  4511.  
  4512.      » REN <old> <new>   Renames file <old> to <new>.  This can also be 
  4513.                          used  to  move a file,  by using  a  different 
  4514.                          path,  as  long  as  it is  moved  within  one 
  4515.                          partition.    Wildcards   are   not   allowed. 
  4516.                          Examples:
  4517.  
  4518.                               ren forem.dat \qbbs\doors\progs\forem.dat
  4519.                               REN lastuser.log xyz.log
  4520.  
  4521.  
  4522.      » SEND <text>       Sends the line <text> to the user, followed by 
  4523.                          a carriage return and line feed. Examples:
  4524.  
  4525.                               Send Wait a sec, getting D&D for you...
  4526.                               SEND Back to QuickBBS!
  4527.  
  4528.      » SETFLAG <flag>    Switches one of the users flags on. The <flag> 
  4529.                          parameter  is two characters long.  The  first 
  4530.                          can be between A and D,  the second between  1 
  4531.                          and  8,  indicating  the flag  to  switch  on. 
  4532.                          Examples:
  4533.  
  4534.                               SETFLAG a1
  4535.                               SetFlag d8
  4536.  
  4537.      » SHOW <file>       Displays  <file> in exactly the same way  menu 
  4538.                          option type 5 does. Examples:
  4539.  
  4540.                               Show DDST1
  4541.                               Show GoodBye
  4542.  
  4543.                          Not valid:
  4544.  
  4545.                               Show \wp\manual.doc
  4546.                               Show ddst1.asc
  4547.                               Show doors\score.vtm
  4548.  
  4549.      ------------------------------------------------------------------
  4550.      QuickBBS ST                                                Page 69
  4551.  
  4552.  
  4553.  
  4554.  
  4555.      QuickBBS ST                                                Page 70
  4556.      ------------------------------------------------------------------
  4557.  
  4558.      » STATUS <ON/OFF>   Switches the status bar on or off.  The status 
  4559.                          bar  will  remain  on  the  screen  while  the 
  4560.                          program  is being executed.  Handy  for  doors 
  4561.                          that don't show you who is online.
  4562.  
  4563.      » SYSTEM  <command> This  command  can only be  used  with  three 
  4564.                          command line interpreters:  Craft,  Mupfel and 
  4565.                          Gulam.   QuickBBS   can  acces  these   shells 
  4566.                          directly,  without needing to load the program 
  4567.                          files,  by  calling them through  the  shell_p 
  4568.                          system variable.  The presence and type of the 
  4569.                          shell  is checked.  If anyone knows  of  other 
  4570.                          shells  which  support  the  shell_p  variable 
  4571.                          correctly, please let us know. And example:
  4572.  
  4573.                          SYSTEM ls
  4574.  
  4575.                          Will display a directory listing ("ls" is  the 
  4576.                          Unix command which does this, supported by all 
  4577.                          three shells).  Programs and script files  can 
  4578.                          also be started through the SYSTEM command  as 
  4579.                          long as they free memory when  completed.  Due 
  4580.                          to  the case sensitivity of Unix  shells,  the 
  4581.                          command  is NOT converted  to  uppercase.  The 
  4582.                          return  code  of  the  command  can  also   be 
  4583.                          accessed with the *C parameter.
  4584.  
  4585.      » TIME <number>     Increase,  decrease or set time limit for  the 
  4586.                          rest of the day. Works like ACCOUNT.
  4587.  
  4588.      » WRITE <type>      Will  write  a  certain  file  (specified   by 
  4589.                          <type>) in the current directory. Examples:
  4590.  
  4591.                               Write lastuser.log
  4592.                               write FOREM.DAT
  4593.                               WRITE DorInfo1.Def
  4594.  
  4595.      If  an error occurs while a .DOR file is being  executed  QuickBBS 
  4596.      will write a message in the log file and return to the menu  which 
  4597.      started the file. Errorlevels returned by the executed program are 
  4598.      not errors.
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.      ------------------------------------------------------------------
  4616.      QuickBBS ST                                                Page 70
  4617.  
  4618.  
  4619.  
  4620.  
  4621.      QuickBBS ST                                                Page 71
  4622.      ------------------------------------------------------------------
  4623.  
  4624.      EXIT WITH ERRORLEVEL
  4625.  
  4626.      If you are running QuickBBS using a batch file you can use  option 
  4627.      type 15 (Exit with ErrorLevel) to run your doors. Quick will write 
  4628.      the 'door files' and exit with the errorlevel you specified in the 
  4629.      Data Line. The connection is not terminated.
  4630.  
  4631.      The  batch  file can detect the errorlevel and  start  up  another 
  4632.      program.
  4633.  
  4634.      When  the  program returns the batch file can  start  up  QuickBBS 
  4635.      again.  By  passing the -R switch on the command line Quick  won't 
  4636.      ask the user for a name/password,  but read the EXITINFO.BBS  file 
  4637.      instead. The user is returned to the top menu.
  4638.  
  4639.      This method has three good points and three bad points:
  4640.  
  4641.      + You  have much more RAM free,  because Quick doesn't  remain  in 
  4642.        memory.
  4643.      + The  user record can be changed.  Quick will re-read the  record 
  4644.        when it is started with the -R switch.
  4645.      + You can use any batch file commands and any utility program  you 
  4646.        like,
  4647.      - The  user is returned to the top menu,  instead of to  the  menu 
  4648.        which contained the exit-with-errorlevel option.
  4649.      - It takes a while for Quick to load and read its configuration.
  4650.      - This  method can only be used in conjunction with a batch  file, 
  4651.        not when QuickStart is being used.
  4652.  
  4653.      Note  that you still can't run programs which change the order  of 
  4654.      the user base,  because Quick saves the user record number to  one 
  4655.      of the door files and reads it again when it is restarted.
  4656.  
  4657.      As always, it's up to you...
  4658.      
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.      ------------------------------------------------------------------
  4682.      QuickBBS ST                                                Page 71
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.      ==================================================================
  4690.      ====================== Section 10 : FidoNet ======================
  4691.      ==================================================================
  4692.  
  4693.      WHAT IS FIDONET?
  4694.  
  4695.      Far back in the mists of ancient time,  in the great and  glorious 
  4696.      days of CP/M and Commodore 64's,  life was wild,  rich and largely 
  4697.      tax free.  In those days spirits were brave, the stakes were high, 
  4698.      men  were  real  men,  women were  real  women,  and  small  furry 
  4699.      creatures from Alpha Centauri were real small furry creatures from 
  4700.      Alpha Centauri.
  4701.  
  4702.      It  was  in  those  days that a brave  young  pioneer  called  Tom 
  4703.      Jennings  named  a random group of bytes,  which  by  an  entirely 
  4704.      meaningless coincidence actually did something,  after his pet dog 
  4705.      Fido.
  4706.  
  4707.      The random group of bytes,  when inserted into a certain piece  of 
  4708.      machinery called a PC, allowed carbon-based bipedal life-forms who 
  4709.      had  just discovered the basics of datacommunications  (henceforth 
  4710.      known  as  Users)  to spend hours  and  hours  reading  bulletins, 
  4711.      posting  and  reading  messages and - best of all  -  sending  and 
  4712.      receiving  other  random groups of bytes they  called  files.  The 
  4713.      users chose to call all this a Bulletin Board System.
  4714.  
  4715.      Now it is such a bizarrely improbable coincidence that anything so 
  4716.      mindbogglingly  useful  could have evolved purely by  chance  that 
  4717.      some thinkers have chosen to see it as a final and clinching proof 
  4718.      of  the  non-existence of God.  The argument goes  something  like 
  4719.      this:
  4720.  
  4721.           "I refuse to prove that I exist," says God, "for proof denies 
  4722.           faith, and without faith I am nothing."
  4723.  
  4724.           "But,"  says Man,  "the BBS is a dead giveaway isn't  it?  It 
  4725.           could not have evolved by chance. It proves you exist, and so 
  4726.           therefore, by your own arguments, you don't. QED."
  4727.  
  4728.           "Oh dear," says God, "I hadn't thought of that," and promptly 
  4729.           vanishes into a puff of logic.
  4730.  
  4731.           "Oh,  that was easy," says Man,  and for an encore goes on to 
  4732.           prove that black is white and gets himself killed on the next 
  4733.           zebra crossing.
  4734.  
  4735.      <loosely based on the Babel Fish entry in The Hitch Hikers Guide>
  4736.  
  4737.      In the meantime Fido was feeling rather lonely.  So TJ thought  it 
  4738.      would be a pretty neat idea if he added some more random bytes  to 
  4739.      his Fido program which automatically talked to other  Fido's.  And 
  4740.      that's how FidoNet was created.
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.      ------------------------------------------------------------------
  4748.      QuickBBS ST                                                Page 72
  4749.  
  4750.  
  4751.  
  4752.  
  4753.      QuickBBS ST                                                Page 73
  4754.      ------------------------------------------------------------------
  4755.  
  4756.      PRACTICAL, PLEASE...
  4757.  
  4758.      Oh,  you  don't  like fun manuals?  Guess I'd  better  explain  it 
  4759.      differently then...
  4760.  
  4761.      FidoNet links more than 20000 (!) Bulletin Boards  world-wide.  It 
  4762.      defines a standard way of transferring messages,  files and  other 
  4763.      random groups of bytes (oops, sorry) between these boards.
  4764.  
  4765.      Messages on a BBS which is connected FidoNet can be split up  into 
  4766.      three groups:
  4767.  
  4768.      » Local Mail: these messages don't go anywhere.
  4769.  
  4770.      » Network  Mail or NetMail:  these messages are sent to one  other 
  4771.        BBS which is the user specifies.
  4772.  
  4773.      » EchoMail: these messages are sent to all other boards in FidoNet 
  4774.        who wish to receive them.
  4775.  
  4776.      NetMail  is  normally used for person-to-person  mail.  If  -  for 
  4777.      instance  - you have a friend on the other side of the  world  who 
  4778.      calls a FidoNet-BBS there,  you can send him messages. The message 
  4779.      is sent to that board only (although it may be routed,  but  we'll 
  4780.      keep that for later).
  4781.  
  4782.      EchoMail  is  divided  up into a whole  lot  of  different  topics 
  4783.      (areas).  There are EchoMail areas for animal lovers, cooks, Basic 
  4784.      programmers and dentists,  to name but a few.  Some EchoMail areas 
  4785.      are national (e.g.  German), some are continental (e.g. European). 
  4786.      There are quite a few world-wide areas too.
  4787.  
  4788.      By  posting a message in an EchoMail area it can be read  on  each 
  4789.      and  every BBS which carries that area.  Any problem you  wish  to 
  4790.      pose  is usually answered within days,  if  not  hours.  You,  the 
  4791.      SysOp, can choose from a wide selection of different topics.
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.      ------------------------------------------------------------------
  4814.      QuickBBS ST                                                Page 73
  4815.  
  4816.  
  4817.  
  4818.  
  4819.      QuickBBS ST                                                Page 74
  4820.      ------------------------------------------------------------------
  4821.  
  4822.      FIDONET ORGANISATION
  4823.  
  4824.      In the following section I will explain how FidoNet is  organised. 
  4825.      At least,  what the theory behind the organisation is. In practice 
  4826.      the organisation differs on quite a few points.
  4827.  
  4828.      Of  course it would be stupid,  impossible in fact,  to call  each 
  4829.      connected  BBS when one of your users has entered a message in  an 
  4830.      EchoMail area. It would also be silly if ten boards sent their own 
  4831.      mail to the other side of the world.  It would be much cheaper  if 
  4832.      just one BBS gathered the mail and sent it all at once.
  4833.  
  4834.      The  organisation of FidoNet can be viewed in two different  ways: 
  4835.      the  topographic organisation and the structural or  hierarchical 
  4836.      organisation.
  4837.  
  4838.      The topographic organisation can be seen in figure 5.1.  The whole 
  4839.      world  is  divided into a number of different  Zones.  Zone  1  is 
  4840.      America,  zone  2 is Europe and zone 3  is  Australia/Asia.  There 
  4841.      aren't many connections in Africa, so it is included in zone 2.
  4842.  
  4843.      Each zone is subdivided into Regions.  The regions don't have  any 
  4844.      effect   on   the  structural  organisation,   and   are   usually 
  4845.      disregarded.
  4846.  
  4847.      Each region contains Networks.  A network is generally a group  of 
  4848.      boards  located  in the same geographic area,  to cut  down  phone 
  4849.      costs. The actual Bulletin Boards are called Nodes.
  4850.  
  4851.      When you look at the structural organisation (figure 5.2) you will 
  4852.      see that each zone has a sort of tree shape. Right  up at the  top
  4853.      of the tree (or at the root,  if you like) we have a ZoneGate. The 
  4854.      ZoneGate  takes  care  of  all  inter-zone  mail.  It calls  other 
  4855.      ZoneGates  in  other zones when mail must be transferred from  one 
  4856.      zone to another. So you could say that the ZoneGate is head of the 
  4857.      zone.
  4858.  
  4859.      At the head of each network we have a Host. The host takes care of 
  4860.      inter-network  mail.  If  a node sends a message to a  node  in  a 
  4861.      different network, it goes via the host.
  4862.  
  4863.      In some large networks Hubs are used.  Some networks have hundreds 
  4864.      of nodes. One single host couldn't handle that many calls, so hubs 
  4865.      are introduced. They act as a host for a group of nodes.
  4866.  
  4867.      Right  down  at  the  bottom of the  tree  you'll  see  the  nodes 
  4868.      themselves.  By the way,  a zonegate,  host or hub is a node  too! 
  4869.      Each node has a number, the host is usually just node number 0.
  4870.  
  4871.      As  I stated earlier,  this is how it works in  theory.  To  speed 
  4872.      things up a bit, some hosts call inter-zone themselves. And a node 
  4873.      often  sends  mail for another network to the host of  that  other 
  4874.      network.
  4875.  
  4876.    
  4877.  
  4878.  
  4879.      ------------------------------------------------------------------
  4880.      QuickBBS ST                                                Page 74
  4881.  
  4882.  
  4883.  
  4884.  
  4885.      QuickBBS ST                                                Page 75
  4886.      ------------------------------------------------------------------
  4887.  
  4888.      For  EchoMail  an  EchoMail Backbone is  used.  It  transfers  the 
  4889.      EchoMail  between the hosts (generally all hosts in  one  region), 
  4890.      and to and from other regions.
  4891.  
  4892.      NETWORK ADDRESSES
  4893.  
  4894.      Every  BBS  in  the  network has its own  address  which  has  the 
  4895.      following format:
  4896.  
  4897.           zone:net/node
  4898.  
  4899.      where 'zone' is the zone number,  'net' is the network number  and 
  4900.      'node' is the node number.  Our Support BBS (zone 2,  network 282, 
  4901.      node 301) has address
  4902.  
  4903.           2:282/301
  4904.  
  4905.      Hosts are normally node 0 in a network.  So,  the host of  network 
  4906.      282 would have address
  4907.  
  4908.           2:282/0
  4909.  
  4910.      This address is unique for each node in FidoNet. No two nodes have 
  4911.      the same address.  If you don't yet have an address you should ask 
  4912.      your  Regional Coordinator or a local Host for  information  about 
  4913.      getting one.
  4914.  
  4915.      POINTS
  4916.  
  4917.      A  fairly new part of FidoNet is the point.  A point is one  level 
  4918.      lower  than  a node.  It's really just a sort  of  super-user  who 
  4919.      doesn't log into your BBS to read his mail,  but uses a mailer  to 
  4920.      collect  it  and  read it  at  home,  offline.  Before  you  start 
  4921.      promising  people all sorts of things you should have  your  board 
  4922.      running  in  FidoNet  without major problems  for  a  few  months. 
  4923.      QuickBBS doesn't need to know anything about points. They are just 
  4924.      extra nodes, as far as Quick is concerned.
  4925.  
  4926.      Points  have a different format address,  with an extra number  at 
  4927.      the end.  The first three numbers are generally the same as  their 
  4928.      boss  (the node which sends them mail).  The last number is  their 
  4929.      point number. So a point of our Support BBS might have address
  4930.  
  4931.        2:282/301.4
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.      ------------------------------------------------------------------
  4946.      QuickBBS ST                                                Page 75
  4947.  
  4948.  
  4949.  
  4950.  
  4951.      QuickBBS ST                                                Page 76
  4952.      ------------------------------------------------------------------
  4953.  
  4954.      WHAT'S A MAILER?
  4955.  
  4956.      A  mailer is a program which handles all the mail  transfers  from 
  4957.      one node to another.  It sits 'in front' of QuickBBS and waits for 
  4958.      the phone to ring. If there's a user at the other end it starts up 
  4959.      QuickBBS. If the other end is a mailer it may send or receive some 
  4960.      mail.
  4961.  
  4962.      At the moment there are two mailers available for the ST:  The-Box 
  4963.      and  Binkley/ST.  Both  are PD/Shareware,  downloadable  from  the 
  4964.      Support BBS.
  4965.  
  4966.      It's  not up to me to tell you which mailer you should  use.  Both 
  4967.      mailers have their positive and negative sides.  The-Box is a very 
  4968.      reliable   and  flexible  mailer,   but  the  user  interface   is 
  4969.      practically  non-existent.  Binkley on the other hand  looks  very 
  4970.      pretty,  but isn't as stable or as powerful as The-Box. It's up to 
  4971.      you  to  decide  what  you  think  is  more   important.   Example 
  4972.      configuration  files  given here are  for  The-Box.  Binkley  uses 
  4973.      similar methods though.
  4974.  
  4975.      IMPORT AND EXPORT
  4976.  
  4977.      Neither  The-Box nor Binkley understand the way in which  QuickBBS 
  4978.      stores the messages.  Outgoing mail (from us to someone else) must 
  4979.      be  exported.  Any incoming mail will have to be  imported  before 
  4980.      QuickBBS can use it.
  4981.  
  4982.      To  export  and import mail we have three programs,  part  of  the 
  4983.      Bermuda package.  They are
  4984.  
  4985.      » IMPORT.TTP   for  importing  NetMail and EchoMail  from  FidoNet 
  4986.                     into the QuickBBS message base.
  4987.      » PACK.TTP     for  exporting  NetMail from the  QuickBBS  message 
  4988.                     base to FidoNet.
  4989.      » SCAN.TTP     for  copying  outgoing EchoMail  into  the  Netmail 
  4990.                     area or directly to FidoNet.
  4991.      » CRUNCH.TTP   for  deleting deleted messages in the  messagebase, 
  4992.                     it  can  also  delete  mail  older  then  xx  days. 
  4993.                     Basicly the same as out Fastpack.
  4994.  
  4995.  
  4996.      The mailer sends and receives packets.  These are files containing 
  4997.      one  or more messages.  Import will translate packets to .HDR  and 
  4998.      .MSG files for QuickBBS to use, pack will do the precise opposite. 
  4999.      Scan only copies EchoMail to the NetMail or directly in packets if 
  5000.      yuo  use  -p on the commandline area.  Figure 5.3  shows  this  in 
  5001.      schematic  form.  Even  if you are running Binkley you  will  need 
  5002.      these programs from the The-Box package.  Another program you will 
  5003.      need  is XLTLST for translating the NodeList.  For Binkley ST  you 
  5004.      should use PARSELST or BTNC to translate the nodelist.
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.      ------------------------------------------------------------------
  5012.      QuickBBS ST                                                Page 76
  5013.  
  5014.  
  5015.  
  5016.  
  5017.      QuickBBS ST                                                Page 77
  5018.      ------------------------------------------------------------------
  5019.  
  5020.      INSTALLING THE MAILER
  5021.  
  5022.      To  run  QuickBBS  with  a mailer  you  will  need  a  shell.  The 
  5023.      environment   variable  MAILER  should  point  to  the   directory 
  5024.      containing your mailer configuration files (for Import,  pack  and 
  5025.      Scan). Most shells can set the variable with either
  5026.  
  5027.           SET MAILER=\QBBS\MAILER\
  5028.      or
  5029.           setenv MAILER=\QBBS\MAILER\
  5030.  
  5031.      but fill in your own path of course.  More on shells,  batch files 
  5032.      and environment variables later.
  5033.  
  5034.      In  your  mailer configuration file you will need  to  define  two 
  5035.      special  directories which will contain your InBound and  OutBound 
  5036.      packets.  You  will also need a directory for your NodeList  files 
  5037.      and one for your mailer configuration files.
  5038.  
  5039.      Import  looks  in the Inbound directory to see if  there  are  any 
  5040.      packets  which need unpacking.  Pack places outgoing mail  in  the 
  5041.      OutBound directory.
  5042.  
  5043.      Import and Pack use a file called AREAS.BBS to find out what areas 
  5044.      are  linked  to other nodes.  The first line contains  the  origin 
  5045.      line.  Because  QuickBBS has already filled this one in  it  isn't 
  5046.      used. The format of the rest of the file is:
  5047.  
  5048.        <filespec> <name> [node] [node] [node...]
  5049.  
  5050.      where...
  5051.  
  5052.      » filespec  is the path to the message area,  followed by  the  4-
  5053.        digit area number. Do not add an extension.
  5054.  
  5055.      » name can be:
  5056.  
  5057.        »» LOCAL:xxxxx  to  indicate a local area which  should  not  be 
  5058.           exported,
  5059.        »» MAIL to indicate that this area is the NetMail area,
  5060.        »» anything else should be the name of the EchoMail  area.  Your 
  5061.           host can tell you what the name of each area is.
  5062.  
  5063.      » node is an address in the format zone:net/node. The area is sent 
  5064.        to and received from this node.
  5065.  
  5066.      The  address following the NetMail area should be the  address  of 
  5067.      your host. You can only have one NetMail area!
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.  
  5074.  
  5075.  
  5076.  
  5077.      ------------------------------------------------------------------
  5078.      QuickBBS ST                                                Page 77
  5079.  
  5080.  
  5081.  
  5082.  
  5083.      QuickBBS ST                                                Page 78
  5084.      ------------------------------------------------------------------
  5085.  
  5086.      Example:  You have five areas in your BBS:  two local ones (1  and 
  5087.      2),  a  NetMail  one (3) and two EchoMail areas (4 and  5)  called 
  5088.      BASIC and CHAT.  NetMail is sent to your host 2:282/0,  and so  is 
  5089.      the  BASIC echo.  The CHAT echo is an area you share only  with  a 
  5090.      friendly  node,  2:282/350.  Your AREAS.BBS file would  look  like 
  5091.      this:
  5092.  
  5093.           <Dummy Origin Line>
  5094.           \QBBS\MSGS\0001     LOCAL:General_Area
  5095.           \QBBS\MSGS\0002     LOCAL:From/To_SysOp
  5096.           \QBBS\MSGS\0003     MAIL                     282/0
  5097.           \QBBS\MSGS\0004     BASIC                    282/0
  5098.           \QBBS\MSGS\0005     CHAT                     282/350
  5099.  
  5100.      The name of an area which you define in MConfig has nothing to  do 
  5101.      with the name of the EchoMail area in AREAS.BBS!
  5102.  
  5103.      COMPILING THE NODELIST
  5104.  
  5105.      Both  Quick and the mailer need to know what the structure of  the 
  5106.      network is.  This structure is described in the NodeList. Ask your 
  5107.      host  for the most recent one.  A new nodelist is  published  each 
  5108.      week.
  5109.  
  5110.      Because the nodelist is a few hundred Kb in size it would cost far 
  5111.      too  much to get a whole nodelist every week.  To solve  that  the 
  5112.      FidoNet  people  have  thought up  a  slightly  cheaper  way:  the 
  5113.      NodeDiff  file.  This  contains all the differences  between  last 
  5114.      weeks  nodelist  and  the new one.  It's  much  smaller  than  the 
  5115.      complete nodelist.  Most hosts can automatically send you the  new 
  5116.      NodeDiff each week.
  5117.  
  5118.      The  nodelist  and  nodediff files  are  called  NODELIST.nnn  and 
  5119.      NODEDIFF.nnn,  where  'nnn'  is  the day on  which  the  file  was 
  5120.      published. The files are usually archived. The archives are called 
  5121.      NODELIST.Ann and NODEDIFF.Ann. 
  5122.  
  5123.      Before  Quick  and  The-Box or Binkley can use  the  nodelist  and 
  5124.      nodediff files (which are in ASCII form,  very slow) they must  be 
  5125.      compiled. You can use XLTLST to do this for you. First it extracts 
  5126.      the  files  from the archives using ARC.  It then  takes  the  old 
  5127.      nodelist  and  the  new nodediff and  generates  a  new  nodelist. 
  5128.      Finally it translates the nodelist file from ASCII to binary.  The 
  5129.      output  is placed in two files:  MAILER.NET  and  MAILER.NOD.  For 
  5130.      Binkley  you must use PARSELST which wil generate  a  NODELIST.DAT 
  5131.      and NODELIST.IDX.  You could also use BTNC, in the current version 
  5132.      (before   2.0)   it  uses   3   files:   DOMAINS.BNL,   INDEX.BNL, 
  5133.      NODEINFO.BNL.  Use QConfig to tell QuickBBS where these files are. 
  5134.      With  a  little  experimentation you should be able  to  make  the 
  5135.      nodelist compilation automatic.
  5136.  
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.      ------------------------------------------------------------------
  5144.      QuickBBS ST                                                Page 78
  5145.  
  5146.  
  5147.  
  5148.  
  5149.      QuickBBS ST                                                Page 79
  5150.      ------------------------------------------------------------------
  5151.  
  5152.      WRITING NETMAIL
  5153.  
  5154.      When  you  write a NetMail message in QuickBBS you  will  have  to 
  5155.      enter  the address of the node where the message should  be  sent. 
  5156.      This is done in the NodeList Menu. If you know the address you can 
  5157.      just type it in.  If you don't,  use the list or search options to 
  5158.      find out.
  5159.  
  5160.      To send NetMail you must have credit.  The amount of credit a user 
  5161.      has can be changed in UserEdit. When a message is sent the cost of 
  5162.      the message is subtracted from the users credit.  In the XLTLST or 
  5163.      PARSELST  control file you can specify what a message  will  cost, 
  5164.      based on the phone number (area code) of the destination node.
  5165.  
  5166.      READING AND WRITING ECHOMAIL
  5167.  
  5168.      EchoMail  is fairly transparent to the user.  Writing an  EchoMail 
  5169.      message  is the same as writing a message in a  local  area.  When 
  5170.      reading  EchoMail you will notice a few extra lines at the  bottom 
  5171.      of the message.
  5172.  
  5173.      The line beginning with '---' is the Tear Line.  It identifies the 
  5174.      program  which was used to write the message.  The  line beginning 
  5175.      with  '* Origin' is the Origin Line.  This identifies the BBS from 
  5176.      which  the message was sent.  It is followed by the address of the 
  5177.      node.
  5178.  
  5179.      The  origin  line  which is added by QuickBBS can  be  defined  in 
  5180.      MConfig.  Each area can have a different origin line.  You  should 
  5181.      always  put at least the name of your BBS in the origin  line.  If 
  5182.      possible, put the phone number in too. Don't include your address, 
  5183.      it will be added by Quick.
  5184.  
  5185.      GENERATING ECHOMAIL
  5186.  
  5187.      The Scan program 'exports' EchoMail.  It exports it for each  node 
  5188.      linked to the area. Let's write an EchoMail message using QuickBBS 
  5189.      to see if everything works okay.
  5190.  
  5191.      Make   sure  you  have  correct  AREAS.BBS  and  TB.CFG   (The-Box 
  5192.      Configuration) files, then start Scan.
  5193.  
  5194.      Each area in AREAS.BBS will be scanned for outgoing EchoMail.  You 
  5195.      should  put  -P  on the  commandline,  then  it  creates  directly 
  5196.      mailpackets.
  5197.  
  5198.      After this you must run Pack,  it will archive the Packets so they 
  5199.      can be send to the nodes.
  5200.  
  5201.      One  of the options in the Read menu is the Kludge  command.  This 
  5202.      option  switches  off  the filtering of  Kludge  Lines  (sometimes 
  5203.      called  ^A lines).  Some extra lines are included in  an  EchoMail 
  5204.      message.   These  are  the  Kludge  Lines.  Normally  the  message 
  5205.      contains  two sorts of kludges:  PATH and SEEN-BY.  They help  the 
  5206.      EchoMail  utilities  keep track of which nodes have  received  the 
  5207.      message (SEEN-BY) and how the message got here (PATH). 
  5208.  
  5209.      ------------------------------------------------------------------
  5210.      QuickBBS ST                                                Page 79
  5211.  
  5212.  
  5213.  
  5214.  
  5215.      QuickBBS ST                                                Page 80
  5216.      ------------------------------------------------------------------
  5217.  
  5218.      EVENTS AND ROUTING
  5219.  
  5220.      Before you can export any mail you have to tell Pack when the mail 
  5221.      must  be sent.  This is done in two files,  called the  Event  and 
  5222.      Route files.  These files are TB.EVT and TB.RTE and are  described 
  5223.      in  detail in the Export and The-Box documentation.  Refer to  the 
  5224.      Jargon  Guide  in the appendix section to find out  what  all  the 
  5225.      technical talk means.
  5226.  
  5227.      An event is a 'piece of day'. With events you can split the day up 
  5228.      into various parts, and tell The-Box how it should act during such 
  5229.      a period.  If you don't understand how the TB.EVT file works, just 
  5230.      put the following lines in it:
  5231.  
  5232.           a ALL 00:00 01:59 b c t=1,10 a=120 m=10,10
  5233.           b ALL 02:00 02:59     t=1,10 a=120 m=10,10
  5234.           c ALL 03:00 23:59 b c t=1,10 a=120 m=10,10
  5235.  
  5236.      With  routing you can send your mail via another  node  (generally 
  5237.      your host),  so that you don't go sending mail all over the world. 
  5238.      In  the  route file you also define what nodes you want  to  call, 
  5239.      when  to call them,  whether or not you want to pick up  any  mail 
  5240.      they  have waiting for you etc.  If you don't understand  how  the 
  5241.      TB.RTE file works, use the above event example and...
  5242.  
  5243.           Route-To zone:net/node ALL
  5244.           Schedule B
  5245.           Poll     zone:net/node
  5246.  
  5247.      and  replace  the 'zone:net/node' with the address of  your  host. 
  5248.      This  will  cause  mail to be sent to your host between  2  and  3 
  5249.      o'clock at night (check with your host to see what time suits  him 
  5250.      best). No users will be allowed into the BBS during this period.
  5251.  
  5252.      EXPORTING MAIL
  5253.  
  5254.      The Pack program translates outgoing messages in the NetMail  area 
  5255.      (including  EchoMail copied by Scan) into packets in the  OutBound 
  5256.      directory. These packets can be sent by the mailer.
  5257.  
  5258.      When  Pack has done its job correctly you should find a packet  in 
  5259.      the outbound directory (called x.CM, for Crash Mail). Now start up 
  5260.      The-Box  with  command line UNATTENDED and watch your  mail  being 
  5261.      sent!
  5262.  
  5263.      IMPORTING MAIL
  5264.  
  5265.      Of course it's not all one-way traffic:  other nodes can call your 
  5266.      mailer.  They might send you mail,  which must be translated  from 
  5267.      Packet  format  to  the QuickBBS message base.  This  is  done  by 
  5268.      Import.  The InBound directory is scanned for packets.  If  Import 
  5269.      finds  one  it will unpack it and place it in  the  correct  area, 
  5270.      depending on the AREA kludge. Easy huh?
  5271.  
  5272.  
  5273.  
  5274.  
  5275.      ------------------------------------------------------------------
  5276.      QuickBBS ST                                                Page 80
  5277.  
  5278.  
  5279.  
  5280.  
  5281.      QuickBBS ST                                                Page 81
  5282.      ------------------------------------------------------------------
  5283.  
  5284.      ARCHIVED MAIL
  5285.  
  5286.      Most  modern  mailers and mail utilities can  handle  ArcMail.  An 
  5287.      ArcMail file just contains all packets to one node ARCed together. 
  5288.      ArcMail is used for two reasons:  it saves time (and  money),  and 
  5289.      due to the CRC check in ARC it improves reliability.
  5290.  
  5291.      The  ARC.TTP program should be in the current directory to  import 
  5292.      and export ArcMail. You an specify which nodes are sent ArcMail in 
  5293.      the route file, or on the command line (see the Export docs).
  5294.  
  5295.      LZHMail is the same as ArcMail,  but LHarc is used instead of ARC. 
  5296.      LHarc is much better at compressing than ARC is.
  5297.  
  5298.      ZIPMail  is  again  the same but for you need  STZip  to  extract. 
  5299.      ZIPMail is the most commonly used in fidonet now.
  5300.  
  5301.      BATCH FILES AND SUCH
  5302.  
  5303.      As  a  FidoNet node you use a mailer instead  of  QuickStart.  The 
  5304.      mailer doesn't know as much about QuickBBS as QuickStart does.  So 
  5305.      we  need to use a shell and a batch file to start up  the  mailer, 
  5306.      the mail utilities and QuickBBS.
  5307.  
  5308.      It's all based on ErrorLevels.  An ErrorLevel is a value  returned 
  5309.      by  a  program.  It can be used by the shell  to  determine  which 
  5310.      action to take.
  5311.  
  5312.      The-Box,  for instance,  exits with a certain errorlevel when mail 
  5313.      is received (which you defined in TB.EVT).  In the batch file  you 
  5314.      can  tell  the  shell  that import should  be  started  when  that 
  5315.      errorlevel is returned.
  5316.  
  5317.      When The-Box detects a user on the other end it will exit with  an 
  5318.      errorlevel of baudrate/100 (e.g.  1200 baud = errorlevel 12).  The 
  5319.      batch file detects this,  and starts up QuickBBS. QuickBBS must be 
  5320.      told  what  the  current baudrate is.  This is done  with  the  -B 
  5321.      parameter on the command line.
  5322.  
  5323.      When  you press one of the function keys in The-Box it  will  exit 
  5324.      with an errorlevel of 10 * key (e.g.  70 for F7).  Use this to log 
  5325.      into the BBS locally.  To start Quick in local mode you should put 
  5326.      the -L parameter on the command line.
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.      ------------------------------------------------------------------
  5342.      QuickBBS ST                                                Page 81
  5343.  
  5344.  
  5345.  
  5346.  
  5347.      QuickBBS ST                                                Page 82
  5348.      ------------------------------------------------------------------
  5349.  
  5350.      A  very  simple  batch  file for PCommand  might  look  like  this 
  5351.      (comments in brackets should not be typed in) ...
  5352.  
  5353.        CD \qbbs                                      (change directory)
  5354.        :start                                           ("Start" Label)
  5355.        tb unattended                                      (run The-Box)
  5356.  
  5357.        IF ERRORLEVEL 100 GOTO qlocal        (errorlevel 100? Local BBS)
  5358.        IF ERRORLEVEL 192 GOTO qbbs          (errorlevel 192? 19200 bps)
  5359.        IF ERRORLEVEL 144 GOTO qbbs          (errorlevel 144? 14400 bps)
  5360.        IF ERRORLEVEL 96  GOTO qbbs          (errorlevel  96?  9600 bps)
  5361.        IF ERRORLEVEL 48  GOTO qbbs          (errorlevel  48?  4800 bps)
  5362.        IF ERRORLEVEL 24  GOTO qbbs          (errorlevel  24?  2400 bps)
  5363.        IF ERRORLEVEL 12  GOTO qbbs          (errorlevel  12?  1200 bps)
  5364.        IF ERRORLEVEL  3  GOTO qbbs          (errorlevel   3?   300 bps)
  5365.        GOTO end                             (lower than   3?     Exit!)
  5366.  
  5367.        :qlocal                                      ("BBS Local" label)
  5368.        quickbbs -L                            (run Quick in local mode)
  5369.        GOTO start                                  (jump back to start)
  5370.  
  5371.        :qbbs                                    ("BBS online" label)
  5372.        quickbbs -B%:e00                         (run Quick at xx00 bps)
  5373.        GOTO start                                             (restart)
  5374.  
  5375.        :end                                      (jump to here to exit)
  5376.        echo BBS Offline.                                 (show message)
  5377.  
  5378.      Although this very simple it should work.  It doesn't provide  any 
  5379.      handling of import or export though.  A more complete example  can 
  5380.      be found in the appendix section. To log in locally press f10.
  5381.  
  5382.      Environment  Variables can be used to help Quick and The-Box  find 
  5383.      their  configuration  files.  An Environment Variable is  a  value 
  5384.      which  the shell can pass to any program it starts.  They  usually 
  5385.      have  the  form NAME=VALUE.  We're interested  in  two  variables: 
  5386.      MAILER and QBBS. The MAILER variable should point to the directory 
  5387.      containing  the configuration files for  The-Box  (TB.CFG,  TB.RTE 
  5388.      etc).  The  QBBS  variable  should  point  to  the  QuickBBS  home 
  5389.      directory (with USERS.BBS etc).
  5390.  
  5391.      When  these variables have been set you can start  The-Box,  Quick 
  5392.      and  the utilities from any directory you like,  for  instance  by 
  5393.      typing...
  5394.  
  5395.           \QBBS\QCONFIG
  5396.  
  5397.      when  you're  in  \COMMS\FLASH\.   QConfig  will  still  find  the 
  5398.      configuration files.  Most shells use the set or setenv command to 
  5399.      define an environment variable. Refer to your shell documentation.
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.      ------------------------------------------------------------------
  5408.      QuickBBS ST                                                Page 82
  5409.  
  5410.  
  5411.  
  5412.  
  5413.    
  5414.     
  5415.      ==================================================================
  5416.      ==================== Section 11 : Appendices =====================
  5417.      ==================================================================
  5418.  
  5419.      APPENDIX A - JARGON GUIDE
  5420.  
  5421.      Of  all areas of computer science,  communications is probably  in 
  5422.      the top-5 of the list when it comes to the amount of jargon  which 
  5423.      is used.  To help you understand what everyone is talking about  I 
  5424.      have compiled a list of the most frequently used jargon.
  5425.  
  5426.       A                 
  5427.  
  5428.      Adams, Douglas      ex-script-writer  of  numerous  TV  and  radio 
  5429.                          series (among which Doctor Who), ex-actor, ex-
  5430.                          director,   ex-barn-builder,  ex-chicken-shed-
  5431.                          cleaner,   ex-lots-of-other-silly-things   and 
  5432.                          author  of  the best book  ever  written:  The 
  5433.                          Hitch  Hikers Guide to the  Galaxy.  Lives  in 
  5434.                          Islington  with a lady barrister and an  Apple 
  5435.                          Macintosh.
  5436.      Address             unique  code which identifies a FidoNet  node. 
  5437.                          It  usually has the form zone:net/node or  (in 
  5438.                          point addressing) zone:net/node.point.
  5439.      Ansi                1. American National Standards  Institute,  an 
  5440.                             organization  which develops and  describes 
  5441.                             all sorts of standards.
  5442.                          2. Ansi X3.64 is a terminal emulation standard 
  5443.                             often used on large computer  systems.  VT-
  5444.                             100  and  Ansi-BBS  are  subsets  of   this 
  5445.                             standard.
  5446.                          3. Ansi-BBS  is a subset of Ansi  X3.64,  with 
  5447.                             some additional escapes, and is used by IBM 
  5448.                             and compatible computers. It is implemented 
  5449.                             in  a device driver  called  ANSI.SYS,  and 
  5450.                             often used in communications packages.
  5451.      ARC                 1. archiver  developed by  System  Enhancement 
  5452.                             Associates (SEA).
  5453.                          2. an  ARC:  archive created by  an  archiver.
  5454.                          3. to  ARC:  to  add files to  an  archive  or 
  5455.                             create a new archive.
  5456.      Archive             1. one or more files combined into one file by 
  5457.                             an   archiver.   The  files   are   usually 
  5458.                             compressed.
  5459.                          2. to archive:  to add files to an archive  or 
  5460.                             to create a new archive.
  5461.      Archiver            program which can create and extract archives.
  5462.      ArcMail             one or more packets to a single node placed in 
  5463.                          an archive.
  5464.      Area                part  of  the  message base  of  a  BBS  which 
  5465.                          contains  messages  which  have  the  same  or 
  5466.                          similar topic. Often called Board.
  5467.      Arrrggghhh!         sound made by a Sysop when a user uploads  the 
  5468.                          same  file  for  the   one-hundred-and-twenty-
  5469.                          second time.
  5470.  
  5471.  
  5472.  
  5473.      ------------------------------------------------------------------
  5474.      QuickBBS ST                                                Page 83
  5475.  
  5476.  
  5477.  
  5478.  
  5479.      QuickBBS ST                                                Page 84
  5480.      ------------------------------------------------------------------
  5481.  
  5482.      ASCII file          a text file consisting of any codes between 32 
  5483.                          and 127.  Each line (including the last line!) 
  5484.                          should  be  terminated with  a  CRLF  sequence 
  5485.                          (Carriage  Return  followed by  a  Line  Feed, 
  5486.                          codes 13 and 10).
  5487.      Asynchronous        in an Asynchronous connection the transmitting 
  5488.                          side sends a start bit,  then 8 data bits  and 
  5489.                          one or two stop bits. No synchronisation lines 
  5490.                          are needed (we only have one: the phone line). 
  5491.                          All BBS systems use Asynchronous connections.
  5492.      AutoDL              short for Auto DownLoad. This is a sequence of 
  5493.                          characters which triggers a file transfer with 
  5494.                          Zmodem.
  5495.      Auto Execute        menu  option which is executed while the  menu 
  5496.                          is  being loaded.  Options which have a ^A  as 
  5497.                          key are Auto Executed. Often called AutoExec.
  5498.  
  5499.       B                 
  5500.  
  5501.      Batch File          file  containing  instructions  for  a  shell, 
  5502.                          which are sequentially executed.
  5503.      Batch Protocol      file transfer protocol which can  send/receive 
  5504.                          more than one file in one go.  The file names, 
  5505.                          sizes and dates are usually sent.
  5506.      BaudRate            speed at which a modem can work.  This is  not 
  5507.                          really  the same as BPS,  but nobody seems  to 
  5508.                          care.
  5509.      BBS                 short for Bulletin Board System (or  Service). 
  5510.                          If  you  didn't  know this one  you  won't  be 
  5511.                          needing QuickBBS!
  5512.      BiModem             fairly new transfer protocol which allows data 
  5513.                          transfer  in  two  directions  simultaneously, 
  5514.                          e.g. user can  upload and download at the same 
  5515.                          time.  Written in 8088 assembler, so no chance 
  5516.                          of ever having that in QuickBBS ST I'm afraid.
  5517.      Binkley             mailer program developed on MS-DOS systems and 
  5518.                          ported to the ST.
  5519.      Board               see Area.
  5520.      Boss                a node in FidoNet which has points.
  5521.      BPS                 Bits Per Second,  the number of bits which are 
  5522.                          sent through the RS-232 interface each second.
  5523.      Bulletin            a  text  file  displayed  to  the  user  which 
  5524.                          contains news,  ideas,  tips & tricks or other 
  5525.                          more or less interesting information.  In some 
  5526.                          BBS  systems  the first menu you  see  is  the 
  5527.                          Bulletin menu.
  5528.      BullShit            contents   of  most  messages  found  in   the 
  5529.                          INTERNAT EchoMail area.
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.      ------------------------------------------------------------------
  5540.      QuickBBS ST                                                Page 84
  5541.  
  5542.  
  5543.  
  5544.  
  5545.      QuickBBS ST                                                Page 85
  5546.      ------------------------------------------------------------------
  5547.  
  5548.       C                 
  5549.  
  5550.      Carrier             to  transmit  and receive data a  modem  sends 
  5551.                          sounds over the phone line.  The Carrier is  a 
  5552.                          sound of a constant frequency, which tells the 
  5553.                          modem  on  the other end that  the  connection 
  5554.                          exists.
  5555.      CCITT               short  for  Comité  Consultatif  International 
  5556.                          Télégraphique  et  Téléphoniquequequeque,   an 
  5557.                          institute which defines the V-standards.
  5558.      CD                  Carrier  Detect,  pin  number 8 on  an  RS-232 
  5559.                          interface.  A  logical  high signal  from  the 
  5560.                          modem means a carrier is present. Often called 
  5561.                          DCD (Data Carrier Detect).
  5562.      Chat, to-           to  talk  with somebody through  keyboard  and 
  5563.                          screen.  Normally you press Return twice  when 
  5564.                          you have said what you want to say to let  the 
  5565.                          person on the other side know that it's  their 
  5566.                          turn.
  5567.      CheckSum            the lower byte of the total of all bytes in  a 
  5568.                          block,  used  to  check that those  bytes  are 
  5569.                          correct.  This  can  be  used  by  the  Xmodem 
  5570.                          protocol  and  is  not  as  reliable  as   CRC 
  5571.                          checking.
  5572.      CLI                 Command Line Interface, see Shell.
  5573.      CrashMail           One   or  more  messages  which   have   Crash 
  5574.                          priority,  i.e. should be sent right away, and 
  5575.                          straight to the destination node (they are not 
  5576.                          routed).
  5577.      CRC                 Cyclic  Redundancy  Check,   very  complicated 
  5578.                          calculation performed on a block of  data.  If 
  5579.                          the  CRC of one block is the same as  that  of 
  5580.                          another block,  it is pretty likely the blocks 
  5581.                          are  the  same  too.  Used  by  most  transfer 
  5582.                          protocols,  and is much more reliable than the 
  5583.                          Checksum method.
  5584.  
  5585.       D                 
  5586.  
  5587.      Dent, Arthur        a  rather  stupid earthling  whose  house  was 
  5588.                          knocked down to make way for a bypass.
  5589.      DL                  See DownLoad.
  5590.      Door                a program executed by the BBS while a user  is 
  5591.                          online.
  5592.      DoorGame            a  game  program executed by the BBS  while  a 
  5593.                          user is online. Often the users of the BBS can 
  5594.                          play games against each other.
  5595.      Download            1. to  Download:  to transfer a file from  the 
  5596.                             BBS to the user.
  5597.                          2. a  Download:  one or more files which  have 
  5598.                             been downloaded.
  5599.                          3. the Download:  all files in a BBS which the 
  5600.                             users can download.
  5601.  
  5602.  
  5603.  
  5604.  
  5605.      ------------------------------------------------------------------
  5606.      QuickBBS ST                                                Page 85
  5607.  
  5608.  
  5609.  
  5610.  
  5611.      QuickBBS ST                                                Page 86
  5612.      ------------------------------------------------------------------
  5613.  
  5614.      DTR                 Data  Terminal  Ready,  pin 20  on  an  RS-232 
  5615.                          interface.  By lowering this pin the  computer 
  5616.                          can tell the modem to disconnect.  When DTR is 
  5617.                          low most modem don't answer incoming calls.
  5618.      Duplex              full-duplex means two connected computers  can 
  5619.                          send data at the same time, but in half-duplex 
  5620.                          only one of the computers can send at any  one 
  5621.                          time. BBS systems always work in full-duplex.
  5622.      DupKiller           program which removes duplicate messages  from 
  5623.                          your message base.
  5624.      Duplicate           an  EchoMail message which has  been  received 
  5625.                          more than once.  This often occurs when the  a 
  5626.                          node gets an area from two different  sources. 
  5627.                          You should take the greatest care not to cause 
  5628.                          duplicate  messages,  and use a  DupKiller  to 
  5629.                          remove such messages if they exist.
  5630.  
  5631.       E                 
  5632.  
  5633.      Echo                an EchoMail area.
  5634.      EchoMail            messages  in FidoNet that can be read on  each 
  5635.                          node  who wishes to receive the area in  which 
  5636.                          the message was written (i.e.  is connected to 
  5637.                          the echo).
  5638.      EchoMail Backbone   FidoNet  node who handles some  inter-net  and 
  5639.                          inter-region EchoMail transfers.
  5640.      Earth               mostly harmless.
  5641.      Electronic Mail     messages stored by an electronic medium like a 
  5642.                          BBS.  Devices  like  a  fax  don't  store  the 
  5643.                          messages,   so  they  aren't  Electronic  Mail 
  5644.                          handlers.
  5645.      Email               see Electronic Mail.
  5646.      ErrorLevel          is  a value returned by a program to  whatever 
  5647.                          executed  it.  Some  shells can  examine  this 
  5648.                          value to determine what to do next.
  5649.      Escape              1. ASCII character 27.
  5650.                          2. A key on the keyboard, usually marked Esc.
  5651.                          3. A  sequence  of  bytes,  starting  with  an 
  5652.                             Escape character,  which controls the users 
  5653.                             terminal.
  5654.      Event               a  period of time which has certain  flags  to 
  5655.                          influence  the operation of a program  like  a 
  5656.                          mailer. Really just something that happens.
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.  
  5666.  
  5667.  
  5668.  
  5669.  
  5670.  
  5671.      ------------------------------------------------------------------
  5672.      QuickBBS ST                                                Page 86
  5673.  
  5674.  
  5675.  
  5676.  
  5677.      QuickBBS ST                                                Page 87
  5678.      ------------------------------------------------------------------
  5679.  
  5680.       F                 
  5681.  
  5682.      Fido                Bulletin  Board System which was the first  to 
  5683.                          do mail transfers from one BBS to another.
  5684.      FidoNet             a  world-wide  network of  BBS  systems  which 
  5685.                          allows mail to be transferred from one BBS  to 
  5686.                          another, of from one BBS to lots of others.
  5687.      File Request        to  use your mailer to ask another  mailer  to 
  5688.                          send  one or more specified  files.  The  file 
  5689.                          names  are  given  to  your  mailer.   Can  be 
  5690.                          compared to downloading a file without  having 
  5691.                          to enter the BBS.
  5692.      File Transfer       sending  a file from one computer to  another, 
  5693.                          using a file transfer protocol.
  5694.      Flag                a switch each user,  each menu option and each 
  5695.                          message area has.  The switch can be on (X) or 
  5696.                          off (-).  If the flag is on in the menu option 
  5697.                          or  message  area it must also be  on  in  the 
  5698.                          users record. There are 4 sets of flags (A-D), 
  5699.                          with each 8 flags (1-8).
  5700.      Flash               the best communications program available  for 
  5701.                          the Atari ST.  Distributed by  Antic,  current 
  5702.                          version is 1.6.
  5703.      Fmail               a  message which has a file belonging  to  it. 
  5704.                          Can  be used to send a message and a  file  to 
  5705.                          one or more specified users at once.
  5706.      Full-duplex         see Duplex.
  5707.  
  5708.       G                 
  5709.  
  5710.      GfA                 German  company  which  produces  a   language 
  5711.                          called GfA-Basic. It isn't really basic, but a 
  5712.                          mixture between Basic,  Pascal and a little C. 
  5713.                          Very fast,  very structured and very easy. GfA 
  5714.                          never meet dead-lines.
  5715.      Graphics Mode       one  of  five  different  terminal  emulations 
  5716.                          which the user selects in QuickBBS.  To use  a 
  5717.                          Graphics  Mode the communications program  the 
  5718.                          user is running must also support the terminal 
  5719.                          emulation.
  5720.      Great               word  often used when speaking about  products 
  5721.                          from Theo Runia and Jon Webb.
  5722.      GROUND              pin  numbers 1 and 7 on an  RS-232  interface. 
  5723.                          Pin  number  1 is PG (Protective  Ground)  and 
  5724.                          ensures  both  devices have the  same  voltage 
  5725.                          levels. Number 7 is SG (Signal Ground). It has 
  5726.                          a  logically  low  signal.  All  other  signal 
  5727.                          levels depend on this pin.
  5728.  
  5729.  
  5730.  
  5731.  
  5732.  
  5733.  
  5734.  
  5735.  
  5736.  
  5737.      ------------------------------------------------------------------
  5738.      QuickBBS ST                                                Page 87
  5739.  
  5740.  
  5741.  
  5742.  
  5743.      QuickBBS ST                                                Page 88
  5744.      ------------------------------------------------------------------
  5745.  
  5746.       H                 
  5747.  
  5748.      Half-duplex         See Duplex.
  5749.      Hayes               Company  which produce modems.  Quite  a  long 
  5750.                          time  ago they developed a modem which  had  a 
  5751.                          small  instruction  set (called  the  AT  set) 
  5752.                          built  in.  Most modern modems also have  this 
  5753.                          instruction set and are Hayes Compatible.
  5754.      Hayes, Maddie       photo model,  private detective and very good-
  5755.                          looking.  Can  be  admired  in  the  TV-series 
  5756.                          Moonlighting.
  5757.      Head Crash          what  always seems to happen to your  harddisk 
  5758.                          when you haven't made a backup for six months.
  5759.      HFL                 dutch currency, please send lots.
  5760.      Home Directory      the  directory containing the QuickBBS  system 
  5761.                          files (e.g.  USERS.BBS). You must either start 
  5762.                          QuickBBS  from this directory or point  to  it 
  5763.                          with the environment variable QBBS.
  5764.      Host                a  node  in  FidoNet  which  is  'head'  of  a 
  5765.                          network.  It collects mail from all the  nodes 
  5766.                          in  the network and sends it to the  hosts  of 
  5767.                          other networks.
  5768.      HST                 High  Speed Transfer,  a method used  by  some 
  5769.                          modern modems to transfer information at  high 
  5770.                          speed  (up to 14400 bps). Old HST modems  were 
  5771.                          not  reliable,   new  ones  are  better.   Not 
  5772.                          compatible with the V.32(bis) standard.
  5773.      Hub                 a  node  in  FidoNet which is  used  in  large 
  5774.                          networks  to  take some of the  load  off  the 
  5775.                          hosts shoulders. It acts as a host for a group 
  5776.                          of nodes within the network.
  5777.  
  5778.       I                 
  5779.  
  5780.      IFNA                International  FidoNet  Association.  Like  to 
  5781.                          think  of themselves as the governing body  of 
  5782.                          FidoNet (and are,  in a way).  Though not many 
  5783.                          people  in FidoNet are actually IFNA  members, 
  5784.                          their  technical standards and  policy  affect 
  5785.                          each node in the IFNA nodelist.
  5786.      Infocom             Company  that  makes the best  ever  adventure 
  5787.                          games  for all sorts of  computers.  They  are 
  5788.                          very   well   known   for   their    high-tech 
  5789.                          programming,  good  plots and  extremely  good 
  5790.                          atmosphere.
  5791.      Interlink           Communications program for the Atari ST  which 
  5792.                          is second in my top-5 of comms packages.  Very 
  5793.                          good Ansi graphics, nice bells & whistles, but 
  5794.                          too slow and too buggy.  Current version 1.89, 
  5795.                          available from InterSect.
  5796.  
  5797.  
  5798.  
  5799.  
  5800.  
  5801.  
  5802.  
  5803.      ------------------------------------------------------------------
  5804.      QuickBBS ST                                                Page 88
  5805.  
  5806.  
  5807.  
  5808.  
  5809.      QuickBBS ST                                                Page 89
  5810.      ------------------------------------------------------------------
  5811.  
  5812.       J                 
  5813.  
  5814.  
  5815.      JEKYLL              a transfer protocol which enables you to  down 
  5816.                          and upload and chat!  at the same  time.  It's 
  5817.                          written by Vincent Partington for the Atari.
  5818.  
  5819.      Jmodem              a   transfer  protocol  which   is   sometimes 
  5820.                          slightly faster than Zmodem.  Written in  8088 
  5821.                          assembler, so it's very difficult to implement 
  5822.                          on an ST.
  5823.      Jon                 me.
  5824.  
  5825.       K                 
  5826.  
  5827.      Kermit              1. little  green frog which  attracts  female, 
  5828.                             fat pigs,
  5829.                          2. old-fashioned file transfer protocol often 
  5830.                              used by stupid people and Unix machines.
  5831.      Kludge              one or more lines in an EchoMail message  used 
  5832.                          by  mail utilities.  Some kludge  lines  start 
  5833.                          with a ^A code. Well-known ones are AREA which 
  5834.                          defines the EchoMail area to which the message 
  5835.                          belongs,  SEEN-BY to keep track of which nodes 
  5836.                          have received the message and PATH to find out 
  5837.                          how the message got here.
  5838.  
  5839.       L                 
  5840.  
  5841.      LastRead Pointers   set  of  numbers Quick uses to keep  track  of 
  5842.                          what  the  last message was a user read  in  a 
  5843.                          certain area. Stored in the file LASTREAD.BBS.
  5844.      LHarc               archiver developed by Yoshi and ported to  the 
  5845.                          ST by yours truly. It's a bit slower than ARC, 
  5846.                          but achieves much better compression results.
  5847.      Log in, to-         1. to call a BBS.
  5848.                          2. to type in the user name and password.
  5849.      Log off, to-        to  tell  the BBS you want it  to  hangup  the 
  5850.                          phone.
  5851.      LZH                 archive created by the LHarc archiver.
  5852.  
  5853.       M                 
  5854.  
  5855.      Mail                one or more messages.
  5856.      Mailer              a  program  which sends mail to  other  nodes, 
  5857.                          receives  mail from other nodes and waits  for 
  5858.                          users to call the BBS.
  5859.      Menu                a  screen  in  the BBS from  which  users  can 
  5860.                          choose an option.
  5861.      Menu Optimiser      a  feature  of  QuickBBS  which  can   replace 
  5862.                          spaces,  carriage returns and line feeds  with 
  5863.                          VT-52 or Ansi escape sequences to position the 
  5864.                          cursor. Speeds up the menus quite a bit at 300 
  5865.                          and 1200 baud.
  5866.  
  5867.  
  5868.  
  5869.      ------------------------------------------------------------------
  5870.      QuickBBS ST                                                Page 89
  5871.  
  5872.  
  5873.  
  5874.  
  5875.      QuickBBS ST                                                Page 90
  5876.      ------------------------------------------------------------------
  5877.  
  5878.      Message             a text written by one user and sent to another 
  5879.                          user, or to ALL other users.
  5880.      Message Base        all messages on a BBS. The messages are stored 
  5881.                          in  the  .HDR and .MSG files  in  the  Message 
  5882.                          Directory.
  5883.      MNP                 a system used by some modems to eliminate line 
  5884.                          noise,  check  data  integrity  and  sometimes 
  5885.                          compress   the  data.   There  are   different 
  5886.                          generations of MNP modems.  The newer ones  do 
  5887.                          data  compression.  All  modems  are  downward 
  5888.                          compatible (or should be,  at least). Most MNP 
  5889.                          modems can communicate with non-MNP modems.
  5890.  
  5891.       N                 
  5892.  
  5893.      NetMail             one  or  more  messages  which  each  have   a 
  5894.                          destination  node  defined  by  the  user.   A 
  5895.                          NetMail  message  is sent to  only  one  other 
  5896.                          node. The user must have enough credit to send 
  5897.                          NetMail messages.
  5898.      NetWork             1. the organisation of a whole lot of Bulletin 
  5899.                             Boards to enable mail transfer.
  5900.                          2. a   group   of  Bulletin   Boards   (nodes) 
  5901.                             geographically  close together.  A host  is 
  5902.                             the head of the network.
  5903.      Net                 See NetWork.
  5904.      NMH                 National Mail Hour,  a time at which all nodes 
  5905.                          must  be  available  for  receiving  mail.  In 
  5906.                          Zone 2 this is often disregarded, because each 
  5907.                          node  can  agree on a time with  the  host.  I 
  5908.                          think Zone 1 still uses this.
  5909.      Node                a  Bulletin  Board which is part  of  FidoNet. 
  5910.                          Nodes are grouped together into NetWorks.
  5911.      NodeDiff            a file which contains the differences  between 
  5912.                          last  weeks and this weeks  NodeList.  If  you 
  5913.                          have  last  weeks  NodeList  and  this   weeks 
  5914.                          NodeDiff you can create a new NodeList.
  5915.      NodeList            file  containing a description of the  current 
  5916.                          structure of FidoNet.  A new one is  published 
  5917.                          every  week,  but  because it is so  big  most 
  5918.                          people prefer to receive a NodeDiff file every 
  5919.                          week.
  5920.      Node Number         See Address.
  5921.  
  5922.  
  5923.  
  5924.  
  5925.  
  5926.  
  5927.  
  5928.  
  5929.  
  5930.  
  5931.  
  5932.  
  5933.  
  5934.  
  5935.      ------------------------------------------------------------------
  5936.      QuickBBS ST                                                Page 90
  5937.  
  5938.  
  5939.  
  5940.  
  5941.      QuickBBS ST                                                Page 91
  5942.      ------------------------------------------------------------------
  5943.  
  5944.       O                 
  5945.  
  5946.      Offline             1. a user is offline:  Not connected to a  BBS 
  5947.                             at the moment.
  5948.                          2. a BBS is offline:  the BBS is currently not 
  5949.                             available to users.
  5950.                          3. a printer is offline:  can not receive  any 
  5951.                             characters to print because the operator is 
  5952.                             mucking around with the switches.
  5953.      Online              the opposite of Offline.
  5954.      Online Archiver     feature  of  QuickBBS which  allows  users  to 
  5955.                          extract  files from one or more  archives  and 
  5956.                          place  them  in a temporary one which  can  be 
  5957.                          downloaded.  Handy if you only want part of an 
  5958.                          archive.
  5959.      Opus                a FidoNet compatible BBS program which runs on 
  5960.                          an  MS-DOS  PC.   This  BBS  is  command  line 
  5961.                          oriented and hardly configurable.
  5962.      Origin Line         A line added to an EchoMail message. It starts 
  5963.                          with  '*  Origin:' and ends with  the  FidoNet 
  5964.                          address of the node in brackets.  Whatever  is 
  5965.                          inbetween can be specified by the SysOp.
  5966.  
  5967.       P                 
  5968.  
  5969.      Packet              one or more FidoNet messages ready to be  sent 
  5970.                          to another node, or just received from another 
  5971.                          node.
  5972.      Pandora             1. Adrian Mole's girlfriend.
  5973.                          1. Fido-ish   BBS  program  written   by   Jac 
  5974.                             Kersing.  QuickBBS  uses the  same  message 
  5975.                             base  format.   Pandora  is  command   line 
  5976.                             oriented and slightly configurable.
  5977.      Parity              a  bit added to each byte transferred over  an 
  5978.                          RS-232   connection  (possibly   with   modems 
  5979.                          inbetween).  You  can have  Even  Parity,  Odd 
  5980.                          Parity or No Parity. With Even Parity the byte 
  5981.                          plus extra bit must form an even number.  With 
  5982.                          Odd  Parity they must form an odd  number.  If 
  5983.                          the parity is incorrect an error is  reported. 
  5984.                          All BBS programs work with No Parity, where no 
  5985.                          parity bit is sent/received.
  5986.      Path                1. directory specification.
  5987.                          2. route of a message before it got to us i.e. 
  5988.                             nodes through which the message passed.
  5989.      Point               a  user of a BBS who uses a mailer to  receive 
  5990.                          and send mail instead of logging into the BBS. 
  5991.                          A  point has an address with an  extra  number 
  5992.                          added,   the  point  number.   The  format  is 
  5993.                          zone:net/node.point.  The first three  numbers 
  5994.                          are the same as in the address of the BBS (the 
  5995.                          boss). This format is called 4D addressing.
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.      ------------------------------------------------------------------
  6002.      QuickBBS ST                                                Page 91
  6003.  
  6004.  
  6005.  
  6006.  
  6007.      QuickBBS ST                                                Page 92
  6008.      ------------------------------------------------------------------
  6009.  
  6010.      Poll, to-           To  call another FidoNet node to see if  there 
  6011.                          is any mail waiting.  Calling another node  to 
  6012.                          send mail is often also called polling.
  6013.      Private             a private message cannot be read by anyone but 
  6014.                          the writer,  the receiver and the SysOp.  Some 
  6015.                          programs cannot handle private EchoMail.
  6016.      Privilege           See Security Level.
  6017.      Protocol            a method of transferring one or more files. By 
  6018.                          agreeing  on a protocol the  transmitting  and 
  6019.                          receiving programs can make sure that the file 
  6020.                          is  transferred correctly and  sometimes  send 
  6021.                          information about the file  name,  size,  date 
  6022.                          etc.   too.   Normally  the  transmitter   and 
  6023.                          receiver must use exactly the same protocol.
  6024.      Psychiatrist        the person you are going to meet once you have 
  6025.                          been running your BBS for a year or so.
  6026.      Public              a public message can be read by anyone who has 
  6027.                          access to the message area.
  6028.  
  6029.       Q                 
  6030.  
  6031.      QBBS                short for QuickBBS.
  6032.      QuickBBS            unknown.
  6033.      QuickStart          program used to handle all modem control for a 
  6034.                          Stand Alone QuickBBS system.  Initialises  the 
  6035.                          modem,  answers the phone if it rings,  starts 
  6036.                          up QuickBBS itself now and then.  Also acts as 
  6037.                          a terminal and a shell for all the utilities.
  6038.      Quote               part  of  the  message to which  the  user  is 
  6039.                          replying.  By quoting parts of the message  he 
  6040.                          can  remind  the writer what the  message  was 
  6041.                          about.
  6042.  
  6043.       R                 
  6044.  
  6045.      RD                  Receive Data,  pin 3 on the RS-232  interface. 
  6046.                          Sometimes called RX.  This connection is  used 
  6047.                          to transfer bytes from the modem to the ST.
  6048.      Recover, to-        1. what  you try to do when you go on  holiday 
  6049.                             to Jamaica after a brain-crash,  approx. 14 
  6050.                             months since you started running a BBS.
  6051.                          2. what    Zmodem   does   when   it    starts 
  6052.                             transferring  a  file  which  was   aborted 
  6053.                             before.  If a Zmodem transfer fails it will 
  6054.                             pick up where it left off the next time you 
  6055.                             try.
  6056.      Reply Link          pointer  to the message to which this  message 
  6057.                          is a reply.  By using the - and + commands  in 
  6058.                          the Read Message menu you can see the original 
  6059.                          message and replies to this message.  QuickBBS 
  6060.                          doesn't  do  this in  EchoMail  by  itself.  A 
  6061.                          utility is available to create Reply Links  in 
  6062.                          EchoMail.
  6063.  
  6064.  
  6065.  
  6066.  
  6067.      ------------------------------------------------------------------
  6068.      QuickBBS ST                                                Page 92
  6069.  
  6070.  
  6071.  
  6072.  
  6073.      QuickBBS ST                                                Page 93
  6074.      ------------------------------------------------------------------
  6075.  
  6076.      Request             see File Request.
  6077.      RS-232              the  serial interface on the back of your  ST, 
  6078.                          marked with a little phone. The pins on an RS-
  6079.                          232  interface  are +3V..+15V  when  they  are 
  6080.                          logically   low,   -3V..-15V  when  they   are 
  6081.                          logically high.  Recommended voltages are +12V 
  6082.                          and -12V.
  6083.      RTS/CTS             Request To Send and Clear To Send,  pins 4 and 
  6084.                          5  on  the RS-232 interface.  These  are  flow 
  6085.                          control  signals.  When the ST wants  to  send 
  6086.                          data  it  makes RTS high.  When the  modem  is 
  6087.                          ready  to  receive  it  makes  CTS  high.   It 
  6088.                          enables  the ST to send at a  higher  (locked) 
  6089.                          baudrate  than the modem can  handle.  Doesn't 
  6090.                          work in most TOS versions,  and is not  really 
  6091.                          needed for QuickBBS.
  6092.  
  6093.       S                 
  6094.  
  6095.      SEAlink             transfer  protocol  from  System   Enhancement 
  6096.                          Associates (SEA) based on Xmodem.  Instead  of 
  6097.                          waiting for the other end to acknowledge  each 
  6098.                          block it keeps on sending, and assumes no news 
  6099.                          is good news.  If an error occurs it goes back 
  6100.                          to the faulty block.  This protocol is  nearly 
  6101.                          as fast as Zmodem! Can also transfer more than 
  6102.                          one file at once (batch protocol).
  6103.      Security Level      a number each user has in QuickBBS.  Based  on 
  6104.                          this  number you can tell Quick how much  time 
  6105.                          the user may spend in the BBS each day,  allow 
  6106.                          him  to access certain menu  options,  message 
  6107.                          areas etc.
  6108.      Seen-By             kludge line added to EchoMail messages that
  6109.                          informs  the mail utilities which  nodes  have 
  6110.                          received this message.
  6111.      Shell               a utility which allows you to type in commands 
  6112.                          on  the keyboard instead of clicking on  files 
  6113.                          with  the mouse.  Has the  useful  side-effect 
  6114.                          that  you can put lots of these commands in  a 
  6115.                          batch  file which can be executed when  you're 
  6116.                          not there.
  6117.      Sleep Delay         the  number of seconds Quick waits  before  it 
  6118.                          disconnects  the  user when  he  doesn't  type 
  6119.                          anything.  This is in case the user has fallen 
  6120.                          asleep, or in case his own major intestine, in 
  6121.                          a   desperate   attempt  to  save   life   and 
  6122.                          civilization,  leaps  straight up through  his 
  6123.                          neck  and throttles his  brain.  Whatever  the 
  6124.                          reason, it should keep your BBS available.
  6125.      Start Bit           one  or  two bits sent before each  data  byte 
  6126.                          over  an RS-232 connection to synchronise  the 
  6127.                          transmitter and the receiver.
  6128.      Stop Bit            same as Start Bit, but now sent after the data 
  6129.                          byte. A BBS should use 1 stop bit.
  6130.  
  6131.  
  6132.  
  6133.      ------------------------------------------------------------------
  6134.      QuickBBS ST                                                Page 93
  6135.  
  6136.  
  6137.  
  6138.  
  6139.      QuickBBS ST                                                Page 94
  6140.      ------------------------------------------------------------------
  6141.  
  6142.      Synchronous         method  of connection used by  large  computer 
  6143.                          systems.  Instead  of sending start  and  stop 
  6144.                          bits  the synchronisation info is 'hidden'  in 
  6145.                          the  data byte.  There can't be any pauses  in 
  6146.                          the      transmission,      otherwise      the 
  6147.                          synchronisation is lost. A BBS never uses this 
  6148.                          method.
  6149.      SysOp               System Operator, the person who makes sure the 
  6150.                          BBS is in working order, helps users when they 
  6151.                          have  problems  with the BBS  and  does  about 
  6152.                          three million other tasks.
  6153.      STZip               Program  ported  from  tyhe  PC  PKZIP,  STZip 
  6154.                          generates  and  unpack  .ZIP  files.   It   is 
  6155.                          written/ported to the Atari by Vincent Pomey.
  6156.  
  6157.       T                 
  6158.  
  6159.      TD                  Transmit Data,  pin 2 on an RS-232  interface. 
  6160.                          This is used to transmit bytes from the ST  to 
  6161.                          the modem. Sometimes called TX.
  6162.      Terminal            1. the computer which is connected to the  BBS 
  6163.                             via a modem.
  6164.                          2. the  communications  program  the  user  is 
  6165.                             running.
  6166.      Terminal Emulation  a  method of controlling the colour  of  text, 
  6167.                          positioning  the cursor,  clearing the  screen 
  6168.                          and  all other fancy things.  This is done  by 
  6169.                          sending Escape sequences. The BBS and the user 
  6170.                          must  be  using the  same  Terminal  Emulation 
  6171.                          (graphics mode).
  6172.      Tea                 the most scarce drink in the universe.
  6173.      The-Box             a  mailer  program  which  works  nicely  with 
  6174.                          QuickBBS.
  6175.      Towel               an item that each Hitch Hiker should have.
  6176.      Transfer            See File Transfer.
  6177.      TurboDos            a program available from Atari which speeds up 
  6178.                          the  hard  disk by 200% to  500%.  You  should 
  6179.                          install  either TurboDos or TOS 1.4  when  you 
  6180.                          run QuickBBS, otherwise it ain't so Quick.
  6181.  
  6182.       U                 
  6183.  
  6184.      UL                  see UpLoad.
  6185.      Upload              1. to Upload:  to send a file from the user to 
  6186.                             the BBS.
  6187.                          2. an Upload: a file uploaded by a user.
  6188.      Uppercase           what  most messages from users are written  in 
  6189.                          if you have Uppercase Checking switched off.
  6190.      User                1. one who calls a BBS,
  6191.                          2. ---CENSORED---
  6192.      User Base           1. all users of a BBS.
  6193.                          2. the  file containing information about  all 
  6194.                             your users, called USERS.BBS.
  6195.  
  6196.  
  6197.  
  6198.  
  6199.      ------------------------------------------------------------------
  6200.      QuickBBS ST                                                Page 94
  6201.  
  6202.  
  6203.  
  6204.  
  6205.      QuickBBS ST                                                Page 95
  6206.      ------------------------------------------------------------------
  6207.  
  6208.      UseNet              a  network  of Unix machines  which  has  some 
  6209.                          quite interesting messages.  UseNet has  links 
  6210.                          with FidoNet (i.e.  some messages from  UseNet 
  6211.                          can be transferred to FidoNet).
  6212.                                                                           
  6213.       V                 
  6214.  
  6215.      V.21                hardware  standard  defined by the  CCITT  for 
  6216.                          transferring information at 300 bps.
  6217.      V.22                same as V.21, but now for 1200 bps.
  6218.      V.22 bis            same as V.21, but now for 2400 bps.
  6219.      V.23                same  as  V.21,  but  now  for  1200/75  split 
  6220.                          baudrate. Not often used for BBS systems.
  6221.      V.29                same as V.21, but now for 4800 bps.
  6222.      V.32                same as V.21, but now for 9600 bps.
  6223.      V.32bis             same as V.21, but now for 14400 bps.
  6224.      VT-52               terminal emulation defined by DEC. Much faster 
  6225.                          than Ansi (in fact it's a subset of Ansi X3.64 
  6226.                          and  VT-100),  but  doesn't  provide  as  many 
  6227.                          possibilities.  The  screen  on an ST  can  be 
  6228.                          controlled using VT-52 escape sequences.
  6229.      VT-100              another terminal emulation from DEC.  This  is 
  6230.                          nearly  the  same  as  Ansi-BBS,  but  doesn't 
  6231.                          support things like colour changes.
  6232.  
  6233.       W                 
  6234.  
  6235.      WaZoo               Warp   Zillion  Opus-to-Opus,   one   of   the 
  6236.                          sessions  used  by  modern  mailers.  A  WaZoo 
  6237.                          session  starts with a YOOHOO packet  exchange 
  6238.                          and  then sends mail or files with SEAlink  or 
  6239.                          Zmodem.
  6240.      Windowed Xmodem     see Xmodem, Windowed.
  6241.      Wow!                sound often heard when observing a FoReM sysop 
  6242.                          who has just logged in to a QuickBBS system.
  6243.  
  6244.       X                 
  6245.  
  6246.      Xfer                short for Transfer.
  6247.      Xmodem              an old transfer protocol. Uses either 128 byte 
  6248.                          or 1024 byte blocks and either Checksum or CRC 
  6249.                          error checking. Slow.
  6250.      Xmodem-1K           the  version  of Xmodem which uses  1024  byte 
  6251.                          blocks. Often incorrectly called Ymodem.
  6252.      Xmodem, Windowed    sort  of Xmodem where the transmitter  doesn't 
  6253.                          wait for the receiver to acknowledge a  block. 
  6254.                          It  assumes that no news is  good  news.  Much 
  6255.                          faster than Xmodem.
  6256.      Xon/Xoff            another flow control method.  The receiver can 
  6257.                          send a ^S code to pause the  transmitter,  and 
  6258.                          continue with a ^Q code.  Not usually used  in 
  6259.                          QuickBBS.
  6260.  
  6261.  
  6262.  
  6263.  
  6264.  
  6265.      ------------------------------------------------------------------
  6266.      QuickBBS ST                                                Page 95
  6267.  
  6268.  
  6269.  
  6270.  
  6271.      QuickBBS ST                                                Page 96
  6272.      ------------------------------------------------------------------
  6273.  
  6274.       Y                 
  6275.  
  6276.      Yell, to-           to  call the SysOp for a chat.
  6277.      Ymodem              a sort of Xmodem which can transfer more  than 
  6278.                          one  file at once.  Often Xmodem 1K is  called 
  6279.                          Ymodem,  but  this  is  incorrect.  Ymodem  is 
  6280.                          always a batch protocol.
  6281.      YOOHOO              a handshaking protocol used by modern  (WaZoo) 
  6282.                          mailers.  The YOOHOO/2U2 handshake passes such 
  6283.                          information  as  your  address,   system   and 
  6284.                          operator name as well as password information.
  6285.  
  6286.       Z                 
  6287.  
  6288.      ZIP                 name  of files generated by PKZip on a  PC  or 
  6289.                          STZip on the Atari series of computers.
  6290.      Zone                a large geographic area in FidoNet.  The whole 
  6291.                          network  is  split  into  three  zones,   each 
  6292.                          covering  a continent.  Each zone is split  up 
  6293.                          into regions and nets.
  6294.      ZoneGate            a  node in FidoNet which transfers  mail  from 
  6295.                          one zone to another.
  6296.      ZOO                 yet  another  archiver.  It's  fast,  slightly 
  6297.                          better  at compressing than ARC,  but  not  as 
  6298.                          good as LHarc. ST version available.
  6299.      Zmodem              The  best transfer  protocol  available.  Very 
  6300.                          fast, extremely easy to use and very reliable. 
  6301.                          If you've got Zmodem: use it!
  6302.  
  6303.       Other            
  6304.  
  6305.      0                   IQ of an average user.
  6306.      8-)                 smiley, turn 90 degrees clockwise.
  6307.      150                 price of a Full Key in Dutch Guilders.
  6308.      -218                IQ of an average Amiga user.
  6309.      ^                   1. Character used to signify the  Control-key. 
  6310.                             ^C  means  hold down the  control  key  and 
  6311.                             press C.
  6312.                          2. Character  used  to  mark  a  Control-code. 
  6313.                             ^C is the character with the ASCII value of 
  6314.                             the C character minus 64.
  6315.      ^A                  ASCII  code  1,  marks the start of  a  kludge 
  6316.                          line in a message. Also used in QuickBBS menus 
  6317.                          to define a menu option as auto-executing.
  6318.  
  6319.  
  6320.  
  6321.  
  6322.  
  6323.  
  6324.  
  6325.  
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.      ------------------------------------------------------------------
  6332.      QuickBBS ST                                                Page 96
  6333.  
  6334.  
  6335.  
  6336.  
  6337.      QuickBBS ST                                                Page 97
  6338.      ------------------------------------------------------------------
  6339.  
  6340.      APPENDIX B - SYSOP KEYS
  6341.  
  6342.      Keys available while a user is online:
  6343.  
  6344.      Help           brief list of available SysOp keys.
  6345.      Clr/Home       updates/restores status bar.
  6346.      Cursor Up      increases users time limit by 5 minutes.
  6347.      Cursor Down    decreases users time limit by 5 minutes.
  6348.      Alt-A          change users graphics mode to ASCII.
  6349.      Alt-C          enters chat mode.
  6350.      Alt-D          cycles Display Mode. Shift-Shift-Alt-D restores.
  6351.      Alt-F          edit users flags.
  6352.      Alt-H          hangup: disconnects user directly.
  6353.      Alt-I          show  info over the user in the  statusbar,  nr. of 
  6354.                     calls, last date called, phonenumbers etc. etc.
  6355.      Alt-J          jump to DOS.
  6356.      Alt-L          lockout: disconnects, zeroes security level.
  6357.      Alt-O          edit users account.
  6358.      Alt-P          switches printer logging on and off.
  6359.      Alt-S          edit users security level.
  6360.      Undo           clear daily download & ask for new download limit.
  6361.  
  6362.      Additional keys in chat mode:
  6363.      
  6364.      Control-C      clear the screen.       
  6365.      Control-F      switch Funmode on or off
  6366.      Control-G      sound a bell, beep or tune.
  6367.      Control-L      switch the chat log on and off.
  6368.      Control-U      switch the users CapsLock on and off.
  6369.      Control-V      view a file.
  6370.      Escape         exit chat mode.
  6371.  
  6372.  
  6373.  
  6374.  
  6375.  
  6376.  
  6377.  
  6378.  
  6379.  
  6380.  
  6381.  
  6382.  
  6383.  
  6384.  
  6385.  
  6386.  
  6387.  
  6388.  
  6389.  
  6390.  
  6391.  
  6392.  
  6393.  
  6394.  
  6395.  
  6396.  
  6397.      ------------------------------------------------------------------
  6398.      QuickBBS ST                                                Page 97
  6399.  
  6400.  
  6401.  
  6402.  
  6403.      QuickBBS ST                                                Page 98
  6404.      ------------------------------------------------------------------
  6405.  
  6406.      APPENDIX C - MENU OPTIONS
  6407.  
  6408.      In this reference chart optional parameters are enclosed in square 
  6409.      brackets [x] and required parameters in angled brackets <x>.
  6410.  
  6411.      Type Name                          Data Line
  6412.  
  6413.      0    Text Line (not a command)
  6414.      1    GoTo New Menu                 <menu name> [parameters]
  6415.      2    GoSub New Menu                <menu name> [parameters]
  6416.      3    Return from Previous Gosub
  6417.      4    Clear Stack & GoTo New Menu   <menu name> [parameters]
  6418.      5    Display Text File             <1-8 character name>
  6419.      7    Execute Program               <full path+name> [command line]
  6420.      8    Version Information
  6421.      9    Log off
  6422.      10   Display System Usage Graph
  6423.      11   Yell for Sysop
  6424.      13   List/Search User Base
  6425.      14   Display Time/Download Stats
  6426.      15   Exit with ErrorLevel          <errorlevel>
  6427.      16   Change City
  6428.      17   Change Password
  6429.      18   Change Screen Length
  6430.      19   Toggle Clear Screen
  6431.      20   Toggle More [Y/n] Prompt
  6432.      21   Change Graphics Mode
  6433.      22   Check for Personal Mail       [board number] or [ALL]
  6434.      23   Read Messages                 <board number>
  6435.      24   Scan Messages                 <board number>
  6436.      25   QuickScan Messages            <board number>
  6437.      27   Write a New Message           <board board> [/L] [/T=...]
  6438.      30   Raw Directory                 <path to area>
  6439.      31   Display File List             <path to area>
  6440.      32   Download a File               <path to area> [filename]
  6441.      33   Upload a File                 <path to area>
  6442.      34   Show Contents of Archive      <path to area>
  6443.      35   Search for a File by Keyword
  6444.      37   List New Files                [path to area]
  6445.      38   View Text File                <path to area>
  6446.      39   Display Direct Text File      <full path & name>
  6447.      40   Replace Menu Text (AutoExec)  <1-8 character name>
  6448.      41   Toggle FSE
  6449.      45   Display Text File with Return <1-8 character name>
  6450.      57   Change Voice Phone
  6451.      58   Change Data Phone
  6452.      80   Online Archiver               <path to area>
  6453.      81   Pump File                     <+ or -> <full path & name>
  6454.      82   Select Menu Optimiser
  6455.      83   File Browser                  <full path & name>
  6456.      84   Mark File Menu                <path to area>
  6457.      85   Mail areas lister             <group nr.> [menu to jump to]
  6458.      86   File areas lister             <search key> [menu to jump to]
  6459.  
  6460.  
  6461.  
  6462.  
  6463.      ------------------------------------------------------------------
  6464.      QuickBBS ST                                                Page 98
  6465.  
  6466.  
  6467.  
  6468.  
  6469.      QuickBBS ST                                                Page 99
  6470.      ------------------------------------------------------------------
  6471.  
  6472.      APPENDIX D - SYSTEM TEXT FILES
  6473.  
  6474.      These  text  files  are  displayed at  various  points  during the 
  6475.      operation of QuickBBS and QuickStart.
  6476.  
  6477.      NAME      DISPLAYED...
  6478.  
  6479.      BANNER    by QuickStart while the BBS is being loaded. ASCII only, 
  6480.                may not contain any control codes.
  6481.      BROWSER   when the user selects [H]elp from the File Browser.
  6482.      DNLDHRS   if the user attempts to download outside download hours.
  6483.      EDITHELP  when the user selects [H]elp from the Message Editor.
  6484.      FILEMENU  when the user selects [H]elp from the File Menu.
  6485.      GOODBYE   just before QuickBBS disconnects.
  6486.      GRAPHELP  when the user selects [H]elp from the Graphics Mode menu.
  6487.      HOTNEWS   displayed after login in the file is newer then the last 
  6488.                time the user called.
  6489.      LANGUAGE  when the user tries to save a message which doesn't pass 
  6490.                the language test.
  6491.      LOGO      before the user types his name. ASCII only.
  6492.      MAXPAGE   if the user attempts to page you more times than allowed.
  6493.      NEWS      just before the system checks for new mail.
  6494.      NEWUSER1  to a new user after he has verified his name, but before 
  6495.                any questions are asked. ASCII only.
  6496.      NEWUSER2  after the new user has selected a password.
  6497.      NEWUSER3  when the new user has filled in all the questions.
  6498.      NO300     when  a  call  comes in at 300 Bps outside  the  300 Bps 
  6499.                hours.
  6500.      NODELIST  when a user selects [H]elp from the NodeList menu.
  6501.      NOTAVAIL  when a user pages you outside the paging hours.
  6502.      NOTFOUND  if the system can't find the user in the User  Base, but 
  6503.                before  he  is asked whether his  name  is  correct.
  6504.      OARCHELP  when  the  user selects [H]elp from the  Online Archiver 
  6505.                main menu.
  6506.      OARCTYPE  when  the  user selects [H]elp from the  Online Archiver 
  6507.                type  selection  menu (when he chooses between .ARC  and 
  6508.                .LZH archives).
  6509.      OPTIMISE  when  the  user selects [H]elp from  the  Menu Optimiser 
  6510.                menu.
  6511.      PAGEABRT  if the SysOp aborts a page.
  6512.      PAGED     when you don't respond to a page.
  6513.      PASSWORD  before a new user is asked for a password,  and when the 
  6514.                user changes his password.
  6515.      POSTCHAT  displayed after a chat.
  6516.      PRECHAT   displayed before a chat
  6517.      PRE-UPLD  displayed before uploading.
  6518.      READHELP  when the user selects [H]elp from the Read Messages menu.
  6519.      SCANHELP  when the user selects [H]elp from the Scan Messages menu.
  6520.      SECxxx    when a user with level xxx calls (ex. SEC100.ASC)
  6521.      TOOSLOW   if  a users baudrate is too slow.
  6522.      TRASHCAN  if  the name typed in by the new user conflicts with the 
  6523.                TRASHCAN.CTL file. ASCII only.
  6524.  
  6525.  
  6526.  
  6527.  
  6528.  
  6529.      ------------------------------------------------------------------
  6530.      QuickBBS ST                                                Page 99
  6531.  
  6532.  
  6533.  
  6534.  
  6535.      QuickBBS ST                                               Page 100
  6536.      ------------------------------------------------------------------
  6537.  
  6538.      UP-DESC   displayed before describing an upload.
  6539.      UPPER     when  a user tries to save a message which  doesn't pass 
  6540.                the UpperCase check.
  6541.      USERxxx   when user nr. xxx calls (ex. USER001.ASC)
  6542.      WELCOME   after the user has entered his name and password.
  6543.      XFERHELP  when  a  user  selects  [H]elp  from  the  File Transfer 
  6544.                Protocol menu. 
  6545.  
  6546.  
  6547.  
  6548.  
  6549.  
  6550.  
  6551.  
  6552.  
  6553.  
  6554.  
  6555.  
  6556.  
  6557.  
  6558.  
  6559.  
  6560.  
  6561.  
  6562.  
  6563.  
  6564.  
  6565.  
  6566.  
  6567.  
  6568.  
  6569.  
  6570.  
  6571.  
  6572.  
  6573.  
  6574.  
  6575.  
  6576.  
  6577.  
  6578.  
  6579.  
  6580.  
  6581.  
  6582.  
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.  
  6589.  
  6590.  
  6591.  
  6592.  
  6593.  
  6594.  
  6595.      ------------------------------------------------------------------
  6596.      QuickBBS ST                                               Page 100
  6597.  
  6598.  
  6599.  
  6600.  
  6601.      QuickBBS ST                                               Page 101
  6602.      ------------------------------------------------------------------
  6603.  
  6604.      APPENDIX E - TEXT FILE CONTROL CODES
  6605.  
  6606.      can be used in any textfile displayed by QuickBBS.
  6607.  
  6608.      System Control
  6609.  
  6610.      Code ASCII     Function
  6611.  
  6612.      ^A   001       Pause and wait for the user to press Return.
  6613.      ^B   002       Turn [S]top aborting off.
  6614.      ^C   003       Turn [S]top aborting on.
  6615.      ^D   004       Turn the More [Y/n] prompts off.
  6616.      ^E   005       Turn the More [Y/n] prompts on.
  6617.      ^F   006       User Information code.
  6618.      ^G   007       Sound bell/beep.
  6619.      ^H   008       BackSpace.
  6620.      ^I   009       Tab.
  6621.      ^J   010       LineFeed.
  6622.      ^K   011       System Information code.
  6623.      ^L   012       FormFeed (clear screen).
  6624.      ^M   013       Carriage Return
  6625.  
  6626.      User Information
  6627.  
  6628.      Code ASCII     Function
  6629.  
  6630.      ^FA  006 065   Users full name.
  6631.      ^FB  006 066   City.
  6632.      ^FC  006 067   Password (use with care!).
  6633.      ^FD  006 068   Data phone.
  6634.      ^FE  006 069   Voice phone.
  6635.      ^FF  006 070   Last date user called.
  6636.      ^FG  006 071   Last time user called.
  6637.      ^FH  006 072   Users A-Flags.
  6638.      ^FI  006 073   Users B-Flags.
  6639.      ^FJ  006 074   Users C-Flags.
  6640.      ^FK  006 075   Users D-Flags.
  6641.      ^FL  006 076   NetMail Credit in cents.
  6642.      ^FM  006 077   Number of messages the user has posted.
  6643.      ^FO  006 079   Users Security Level.
  6644.      ^FP  006 080   Number of times the user has called.
  6645.      ^FQ  006 081   Number of files the user has uploaded.
  6646.      ^FR  006 082   Number of KiloBytes the user has uploaded.
  6647.      ^FS  006 083   Number of files the user has downloaded.
  6648.      ^FT  006 084   Number of KiloBytes the user has downloaded.
  6649.      ^FU  006 085   Number of minutes user has been online today.
  6650.      ^FV  006 086   Length of the users screen.
  6651.      ^FW  006 087   Users first name.
  6652.      ^FX  006 088   Users Graphics Mode.
  6653.      ^FY  006 089   More prompt  : ON or OFF.
  6654.      ^FZ  006 090   Screen Clear : ON or OFF.
  6655.      ^F0  006 048   Optimiser    : ON or OFF.
  6656.      ^F1  006 049   Number of KiloBytes the user has downloaded today.
  6657.  
  6658.  
  6659.  
  6660.  
  6661.      ------------------------------------------------------------------
  6662.      QuickBBS ST                                               Page 101
  6663.  
  6664.  
  6665.  
  6666.  
  6667.      QuickBBS ST                                               Page 102
  6668.      ------------------------------------------------------------------
  6669.  
  6670.      ^F2n 006 050   Flag An      : ON or OFF.
  6671.      ^F3n 006 051   Flag Bn      : ON or OFF.
  6672.      ^F4n 006 052   Flag Cn      : ON or OFF.
  6673.      ^F5n 006 053   Flag Dn      : ON or OFF.
  6674.      ^F6  006 054   Current Account
  6675.      ^F7  006 055   Full Screen Editor : ON or OFF.
  6676.  
  6677.  
  6678.      System Information
  6679.  
  6680.      Code ASCII     Function
  6681.  
  6682.      ^KA  011 065   Number of calls to the BBS.
  6683.      ^KB  011 066   Name of the last caller.
  6684.      ^KF  011 070   Number of times you've been paged.
  6685.      ^KG  011 071   Day of the week (i.e. Monday, Tuesday etc.).
  6686.      ^KH  011 072   Number of users in the User Base.
  6687.      ^KI  011 073   Current time in 24 hour format (HH:MM)
  6688.      ^KJ  011 074   Current date, format DD MMM YY (04 Nov 89).
  6689.      ^KK  011 075   Time connected - minutes.
  6690.      ^KL  011 076   Time connected - seconds.
  6691.      ^KM  011 077   Time used - minutes.
  6692.      ^KN  011 078   Time used - seconds.
  6693.      ^KO  011 079   Time remaining - minutes.
  6694.      ^KP  011 080   Time remaining - seconds.
  6695.      ^KQ  011 081   Time limit in minutes.
  6696.      ^KR  011 082   Baud rate.
  6697.      ^KS  011 083   Abbreviated day of week (i.e. Mon, Tue etc.).
  6698.      ^KT  011 084   Download limit in Kb.
  6699.      ^KWx 011 087   Amount of free space on drive 'x'.
  6700.      ^KX  011 088   Amount of free RAM.
  6701.  
  6702.  
  6703.  
  6704.  
  6705.  
  6706.  
  6707.  
  6708.  
  6709.  
  6710.  
  6711.  
  6712.  
  6713.  
  6714.  
  6715.  
  6716.  
  6717.  
  6718.  
  6719.  
  6720.  
  6721.  
  6722.  
  6723.  
  6724.  
  6725.  
  6726.  
  6727.      ------------------------------------------------------------------
  6728.      QuickBBS ST                                               Page 102
  6729.  
  6730.  
  6731.  
  6732.  
  6733.      QuickBBS ST                                               Page 103
  6734.      ------------------------------------------------------------------
  6735.  
  6736.      APPENDIX F - .DOR FILE COMMANDS
  6737.  
  6738.      The  data line of menu option type 7 can contain the *E (extended) 
  6739.      command to execute instructions in a .DOR file. The commands are..
  6740.  
  6741.      ACCOUNT <number>   increases, decreases or sets the account
  6742.      CD <path>          changes the current directory to <path>
  6743.      CL <command>       sets the current command line
  6744.      CLRFLAG <flag>     Switches one of the users flags off
  6745.      CLS                clears the screen
  6746.      COPY <src> <dest>  copies file <src> to <dest>
  6747.      CTIME <number>     increases, decreases or sets current time limit
  6748.      DEL <spec>         deletes files matching <spec>
  6749.      DEXIST <path>      checks if a directory exists
  6750.      DLIMIT             increases, decreases or sets download limit
  6751.      ECHO <text.        sends the line <text> to the user
  6752.      EXEC <program> <cl> executes <program> with command line
  6753.      EXIT               stop executing the current .DOR file and return
  6754.      FEXIST <file>      checks if a file exists
  6755.      GOTO <label>       jump to label (:label in .dor file)
  6756.      IF <value> <operator> <value> THEN <command>
  6757.                         if true execute <command>
  6758.      INPUT <type> [<len>] [<"str">]
  6759.                         inputs line of text from user, stored in *TXT
  6760.      KEY                Wait for keypress, stored in *CHR and *ASC
  6761.      LEVEL <number>     Increases, decreases or sets the security level
  6762.      LOCAL <text>       <text> is displayed locally only
  6763.      LOG <text>         writes <text> to the system log file
  6764.      MENU <option> <data> execute a menu option.
  6765.      PAUSE              Prompt and wait for return
  6766.      PROMT <text>       sends <text> but leaves cursor on same line
  6767.      READMARKED         read MARKED.DAT and read marked messages
  6768.      REN <old> <new>    renames file <old> to <new>
  6769.      SEND <text>        Sends the line <text> to the user
  6770.      SETFLAG <flag>     Switches one of the users flags on
  6771.      SHOW <file>        Displays <file> in the textfile directory
  6772.      STATUS <on|off>    Switches the status bar on or off
  6773.      SYSTEM <command>   send <command> to Craft, Mupfel or Gulam
  6774.      TIME  <number>     increase,  decrease or set time limit  for  the 
  6775.                         rest of the day
  6776.      WRITE <type>       will write a file depending on <type>, which 
  6777.                         can be LASTUSER.LOG, FOREM.DAT or DORINFO1.DEF
  6778.  
  6779.      The  DEL  command is the only command which  accepts  wildcards as 
  6780.      parameters.
  6781.  
  6782.  
  6783.  
  6784.  
  6785.  
  6786.  
  6787.  
  6788.  
  6789.  
  6790.  
  6791.  
  6792.  
  6793.      ------------------------------------------------------------------
  6794.      QuickBBS ST                                               Page 103
  6795.  
  6796.  
  6797.  
  6798.  
  6799.      QuickBBS ST                                               Page 104
  6800.      ------------------------------------------------------------------
  6801.  
  6802.      APPENDIX G - VT-52 ESCAPE CODES
  6803.  
  6804.      Please  note that all lowercase characters are  Atari-private, and 
  6805.      should not be used in VT-52 Standard mode.
  6806.  
  6807.      Esc-A     Moves the cursor up one line,  but not beyond the top of 
  6808.                the screen.
  6809.      Esc-B     Moves  the  cursor  down  one line, but not  beyond  the
  6810.                bottom of the screen.
  6811.      Esc-C     Moves  the cursor right one column,  but not  beyond the 
  6812.                edge of the screen.
  6813.      Esc-D     Moves the cursor  left one  column, but  not beyond  the  
  6814.                edge of the screen.
  6815.      Esc-E     Clears the  screen and puts the cursor in the  top  left 
  6816.                corner. This code is Atari-private!
  6817.      Esc-H     Places the cursor in the top left corner of the screen.
  6818.      Esc-I     Moves the cursor up one line. If the cursor was  already 
  6819.                at the top, the screen is scrolled down.
  6820.      Esc-J     Erases   the  screen  starting  at  the  current  cursor 
  6821.                position.
  6822.      Esc-K     Clears  the screen between the cursor and the end of the 
  6823.                line.
  6824.      Esc-L     Inserts an empty  line at the  current cursor  position.
  6825.                the  cursor is  placed in  the first  column  of the new
  6826.                line, the rest of the screen is scrolled down.
  6827.      Esc-M     Deletes  the  line  at the current  cursor  position and 
  6828.                scrolls the rest of the screen  up. The cursor is  moved
  6829.                to the first column of the line.
  6830.      Esc-Yyx   Moves   the  cursor  to  the  position  defined  in  the 
  6831.                characters <y> and <x>, of which the ASCII codes must be 
  6832.                incremented  by  32  (i.e.  Esc-Y-space-space  moves the 
  6833.                cursor home).
  6834.      Esc-bx    Sets the foreground text colour to <x>. Only the lower 4 
  6835.                bits  of the colour are used,  so Esc-b-1 is the same as 
  6836.                Esc-b-A.  The number of colours available depends on the 
  6837.                screen 'resolution'.
  6838.      Esc-cx    Same as Esc-bx,  but now for the background  colour. All 
  6839.                screen clearing is done in this colour.
  6840.      Esc-d     Clears  the  screen between the cursor position  and the 
  6841.                start of the screen.
  6842.      Esc-e     Switches the cursor on.
  6843.      Esc-f     Switches the cursor off.
  6844.      Esc-j     Remembers the cursor position.
  6845.      Esc-k     Restores  the  cursor  position  saved  with  Esc-j. Not 
  6846.                nestable.
  6847.      Esc-l     Erases the current line and puts the cursor on the first 
  6848.                column.
  6849.      Esc-o     Erases  the current line between the left of  the screen 
  6850.                and the cursor position.
  6851.      Esc-p     Switches to reverse video.
  6852.      Esc-q     Switches reverse video off.
  6853.      Esc-v     Causes  the text to wrap over the right hand side of the 
  6854.                screen if a line is longer than 80 characters.
  6855.      Esc-w     Causes  the  text  which  exceeds  80  characters  to be 
  6856.                discarded.
  6857.  
  6858.  
  6859.      ------------------------------------------------------------------
  6860.      QuickBBS ST                                               Page 104
  6861.  
  6862.  
  6863.  
  6864.  
  6865.      QuickBBS ST                                               Page 105
  6866.      ------------------------------------------------------------------
  6867.  
  6868.      APPENDIX H - ANSI-BBS ESCAPE CODES
  6869.  
  6870.      Due  to the structural differences between the screen of a  PC and 
  6871.      that  of  an  ST,   the  Ansi  driver  in  QuickBBS  ST  has  some 
  6872.      'differences'...
  6873.  
  6874.      » A PC with CGA monitor can display 8 colours for foreground and 8 
  6875.        colours for background, whereas the ST can  only display 4  each  
  6876.        on a colour monitor. See the 'change attributes' escape sequence 
  6877.        to see how Quick handles colours.
  6878.  
  6879.      » A  PC can underline,  highlight,  blink and reverse text.  An ST 
  6880.        using  BIOS/GEMDOS  for  output can only  use  reverse.  See the 
  6881.        'change attributes' escape sequence.
  6882.  
  6883.      » I have not found any way of changing the scroll region X, Y, and 
  6884.        Width for TOS output.
  6885.  
  6886.      » All  escape  sequences  that QuickBBS ST  doesn't  know  will be 
  6887.        ignored. They will be sent to the user on-line.
  6888.  
  6889.      The  implementation in QuickBBS ST also has some  escape sequences 
  6890.      not  found in  ANSI.SYS  (the Ansi driver on a PC), but  which are 
  6891.      part of X3.64, or frequently used by Unix machines. 
  6892.  
  6893.      QuickBBS   ST  recognises  and  reacts  to  the  following  escape 
  6894.      sequences.  All  characters in <brackets> should be  replaced, and 
  6895.      spaces should be removed...
  6896.  
  6897.      Name      : CUU - Cursor Up
  6898.      Escape    : <ESC> [ <n> A
  6899.      Example   : <ESC> [  5  A
  6900.  
  6901.      This  sequence moves the cursor up <n> lines.  If parameter <n> is 
  6902.      omitted, the cursor moves up  one line.  The cursor will  not move 
  6903.      off  the screen,  nor  will  the screen  scroll down.  The  cursor 
  6904.      remains on the same column.
  6905.  
  6906.      Name      : CUD - Cursor Down
  6907.      Escape    : <ESC> [ <n> B
  6908.      Example   : <ESC> [  3  B
  6909.  
  6910.      CUD  is the same as CUU (cursor up),  but the cursor is moved down 
  6911.      instead.
  6912.  
  6913.      Name      : CUF - Cursor Forward (right)
  6914.      Escape    : <ESC> [ <n> C
  6915.      Example   : <ESC> [  8  B
  6916.  
  6917.      This  moves  the cursor <n> columns to the  right.  If  the cursor 
  6918.      reaches column 80,  it will stay there.  The cursor remains on the 
  6919.      same line. If <n> is omitted, the cursor moves one column.
  6920.  
  6921.      Name      : CUB - Cursor Backward (left)
  6922.      Escape    : <ESC> [ <n> D
  6923.      Example   : <ESC> [  7  D
  6924.  
  6925.      ------------------------------------------------------------------
  6926.      QuickBBS ST                                               Page 105
  6927.  
  6928.  
  6929.  
  6930.  
  6931.      QuickBBS ST                                               Page 106
  6932.      ------------------------------------------------------------------
  6933.  
  6934.      Is  identical to CUF (cursor forward),  except that the  cursor is 
  6935.      moved to the left, as far as the left hand side of the screen.
  6936.  
  6937.      Name      : CUP - Cursor Position
  6938.      Escape    : <ESC> [ <y> ; <x> H
  6939.      Example   : <ESC> [ 10  ; 20  H
  6940.  
  6941.      This escape moves the cursor to location (x,y), where X is between 
  6942.      1 and 80,  and Y between 1 and 24. If <y> and <x> are omitted, the 
  6943.      cursor is moved to the top left-hand corner (1,1). The sequences
  6944.  
  6945.           <ESC> [ <y> ; <x> H
  6946.           <ESC> [ <y> ; <x> f
  6947.           <ESC> [ <y> ; <x> j
  6948.  
  6949.      are identical, but the first is recommended.
  6950.  
  6951.      Name      : SCP - Save Cursor Position
  6952.      Escape    : <ESC> [ s
  6953.      
  6954.      SCP tells the Ansi driver to note down the current cursor position 
  6955.      for future use.  If an RCP is received the cursor will be returned 
  6956.      to this position. The SCP and RCP escapes are not nestable.
  6957.  
  6958.      Name      : RCP - Restore Cursor Position
  6959.      Escape    : <ESC> [ u
  6960.  
  6961.      RCP places the cursor at the location noted down by SCP.
  6962.  
  6963.      Name      : ED - Erase Display
  6964.      Escape    : <ESC> [ <n> J
  6965.      Example   : <ESC> [  2  J
  6966.  
  6967.      ED erases all or part of the screen depending on the parameter <n>. 
  6968.      If this parameter is omitted, it is assumed to be '0'...
  6969.  
  6970.        <n> = 0 :    The  screen  is erased between  the  current cursor 
  6971.                     location  and the lower right corner of the screen, 
  6972.                     inclusive. The cursor doesn't move.
  6973.        <n> = 1 :    The  screen is erased between the upper left corner 
  6974.                     of  the  screen  and the  current  cursor location, 
  6975.                     inclusive. The cursor doesn't move.
  6976.        <n> = 2 :    The  whole screen is erased and the cursor is moved 
  6977.                     to the upper left corner.
  6978.  
  6979.      The screen is cleared using the current background colour.
  6980.  
  6981.  
  6982.  
  6983.  
  6984.  
  6985.  
  6986.  
  6987.  
  6988.  
  6989.  
  6990.  
  6991.      ------------------------------------------------------------------
  6992.      QuickBBS ST                                               Page 106
  6993.  
  6994.  
  6995.  
  6996.  
  6997.      QuickBBS ST                                               Page 107
  6998.      ------------------------------------------------------------------
  6999.  
  7000.      Name      : EL - Erase Line
  7001.      Escape    : <ESC> [ <n> K
  7002.      Example   : <ESC> [  0  K
  7003.  
  7004.      All or part of the current line is erased,  depending on parameter 
  7005.      <n>.  The cursor is never moved by this escape. If <n> is omitted, 
  7006.      it is assumed to be '0'...
  7007.  
  7008.      <n> = 0 : All characters to the right of the cursor are erased.
  7009.      <n> = 1 : All characters to the left  of the cursor are erased.
  7010.      <n> = 2 : All characters on the current line are erased.
  7011.  
  7012.      The line is cleared using the current background colour.
  7013.  
  7014.      Name      : IL - Insert Lines
  7015.      Escape    : <ESC> [ <n> L
  7016.      Example   : <ESC> [  3  L
  7017.  
  7018.      IL  inserts <n> lines at the current cursor location.  The current 
  7019.      line and all lines below it are moved down. Lines at the bottom of 
  7020.      the screen will be lost.  If <n> is omitted, one line is inserted. 
  7021.      The  cursor  doesn't move.  The new line will be displayed in  the 
  7022.      current background colour.
  7023.  
  7024.      Name      : DL - Delete Lines
  7025.      Escape    : <ESC> [ <n> M
  7026.      Example   : <ESC> [  9  M
  7027.  
  7028.      DL deletes <n> lines,  starting with the current cursor  line. All 
  7029.      lines  underneath the line(s) to be deleted will be moved  up. New 
  7030.      lines, in the current background colour, will appear at the bottom 
  7031.      of the screen. The cursor doesn't move.
  7032.  
  7033.      Name      : DECSC - DEC Private, Save Cursor Parameters
  7034.      Escape    : <ESC> 7
  7035.  
  7036.      This is supposed to be a DEC Private escape,  but is used on other 
  7037.      systems as well.  It saves the current cursor position (like SCP), 
  7038.      but also  stores  the current  text attributes  and colours.  With
  7039.      DECRC these parameters can be restored. This is not implemented in 
  7040.      ANSI.SYS!!!
  7041.  
  7042.      Name      : DECRC - DEC Private, Restore Cursor Parameters
  7043.      Escape    : <ESC> 8
  7044.  
  7045.      DECRC  is  the opposite of DECSC,  and restores  the  saved cursor 
  7046.      parameters. This is not implemented in ANSI.SYS!!!
  7047.  
  7048.      Name      : RIS - Reset to Initial State
  7049.      Escape    : <ESC> c
  7050.  
  7051.      This  'resets'  the Ansi driver:  the colours are  set to  default 
  7052.      values,  all  text  attributes are switched off and the screen  is 
  7053.      cleared. It is the same as doing an SGR 0 followed  by ED 2.  This  
  7054.      is not implemented in ANSI.SYS!!!
  7055.  
  7056.  
  7057.      ------------------------------------------------------------------
  7058.      QuickBBS ST                                               Page 107
  7059.  
  7060.  
  7061.  
  7062.  
  7063.      QuickBBS ST                                               Page 108
  7064.      ------------------------------------------------------------------
  7065.  
  7066.      Name      : NEL - Next Line
  7067.      Escape    : <ESC> E
  7068.  
  7069.      This  moves  the  cursor to the first position on  the next  line, 
  7070.      scrolling the screen up if necessary.  It is effectively the  same 
  7071.      as Carriage Return followed by Line  Feed, and is not  implemented 
  7072.      in ANSI.SYS!!!
  7073.  
  7074.      Name      : SGR - Set Graphics Rendition
  7075.      Escape    : <ESC> [ <n> ; <n> ; ... ; <n> m
  7076.      Example   : <ESC> [  1  ; 37  m
  7077.  
  7078.      Now  this  is the good stuff...  With this escape you  can control 
  7079.      three things:
  7080.  
  7081.      » The text foreground colour,
  7082.      » The text background colour,
  7083.      » The text attributes.
  7084.  
  7085.      There  can  be  any  number  of  parameters,  separated  by  ';'
  7086.      characters. The effect is cumulative. If no parameters are passed,
  7087.      '0' is   assumed. The following parameters are available:
  7088.  
  7089.           0    Reset colours and attributes
  7090.           1    Bold (*)
  7091.           4    Underlined (*)
  7092.           5    Blink (*)
  7093.           7    Reverse Video
  7094.  
  7095.           30   Foreground Black
  7096.           31   Foreground Red
  7097.           32   Foreground Green
  7098.           33   Foreground Yellow
  7099.           34   Foreground Blue
  7100.           35   Foreground Magenta
  7101.           36   Foreground Cyan
  7102.           37   Foreground White
  7103.  
  7104.           40 to 47  Background Colours
  7105.  
  7106.      Attributes  marked by (*) are ignored by Quick.  When running on a 
  7107.      monochrome  monitor  the  colours are also  ignored.  On  a colour 
  7108.      monitor  colour  30  is black (register  0),  colour  37  is white 
  7109.      (register  3),  and  all  colours  inbetween  are  alternated Blue 
  7110.      (register 1) and Red (register 2).  Of course this depends on your 
  7111.      screen  settings,  but  the above are  the  QuickBBS  defaults. If 
  7112.      foreground  and  background turn out to be  the  same,  Quick will 
  7113.      adjust the background colour.
  7114.  
  7115.      Some examples...
  7116.  
  7117.           Bold, White on Blue     : <ESC>[0;1;37;44m
  7118.           Blink, Red on Yellow    : <ESC>[0;5;31;43m
  7119.           Normal, White on Black  : <ESC>[m or <ESC>[0m
  7120.           Bold, Underlined, Green : <ESC>[0;1;4;32m
  7121.  
  7122.  
  7123.      ------------------------------------------------------------------
  7124.      QuickBBS ST                                               Page 108
  7125.  
  7126.  
  7127.  
  7128.  
  7129.      QuickBBS ST                                               Page 109
  7130.      ------------------------------------------------------------------
  7131.  
  7132.      Note  that  setting - say - Bold does not effect any of  the other 
  7133.      attributes,  nor  the colours.  To make sure you've got  the right 
  7134.      mode, you could add a '0' at  the beginning,  but that depends  on
  7135.      how intelligent your Ansi editor is.
  7136.  
  7137.      You can create your Ansi screens  in a number of  different  ways.  
  7138.      The  hardest way is to do  it all in a text editor like Tempus  or   
  7139.      the capture buffer in  Flash.  This is lots of hard work,  and you
  7140.      can't get many fancy effects this way.
  7141.  
  7142.      The  most  expensive method is to buy a PC and use an  editor like 
  7143.      TheDraw.  These editors have lots of nice options to do stuff like 
  7144.      animation.
  7145.  
  7146.      The  simplest  is  to create your screens in  a  VT-52  editor and 
  7147.      convert  them to Ansi using the QANSI program,  available from our 
  7148.      Support BBS.  You just specify the input VT-52 file, and your Ansi 
  7149.      file is ready to use!  The only limitation is:  QANSI can't handle 
  7150.      more than one screen at a time.
  7151.  
  7152.      Perhaps someone has time to write a good VT-52 and Ansi editor for 
  7153.      the ST? It's about time we had something we can work with!
  7154.  
  7155.  
  7156.  
  7157.  
  7158.  
  7159.  
  7160.  
  7161.  
  7162.  
  7163.  
  7164.  
  7165.  
  7166.  
  7167.  
  7168.  
  7169.  
  7170.  
  7171.  
  7172.  
  7173.  
  7174.  
  7175.  
  7176.  
  7177.  
  7178.  
  7179.  
  7180.  
  7181.  
  7182.  
  7183.  
  7184.  
  7185.  
  7186.  
  7187.  
  7188.  
  7189.      ------------------------------------------------------------------
  7190.      QuickBBS ST                                               Page 109
  7191.  
  7192.  
  7193.  
  7194.  
  7195.      QuickBBS ST                                               Page 110
  7196.      ------------------------------------------------------------------
  7197.  
  7198.      APPENDIX I - RS-232 PINOUT
  7199.  
  7200.      On an RS-232 interface a logically low (binary 0) signal is between 
  7201.      +3V  and +15V (+12V is recommended).  A logically high  (binary  1) 
  7202.      signal  is between -3V and -15V (-12V recommended).  There are  two 
  7203.      types  of  ports  (DCE  on the ST and  DTE  on  the  modem),  which 
  7204.      generally  ensure  that  receive and send  are  inter-connected  on 
  7205.      either side.
  7206.  
  7207.      Most  RS-232 ports have 25 pins (pin number 1 should be  marked  on 
  7208.      the plug).  Some PC's use 9-pin 'joystick' connectors for their RS-
  7209.      232. The pin numbering is different, but the meaning is the same. A 
  7210.      jumper  box always comes in handy when trying to connect  equipment 
  7211.      using RS-232!
  7212.  
  7213.      The minimum requirement for QuickBBS is CD,  DTR,  TD,  RD,  PG and 
  7214.      GND.  For modems of 9600 bps or over you must also use RTS and CTS. 
  7215.      Not all pins are connected on an ST. Available pins are...
  7216.  
  7217.      Pin  Name      Description
  7218.  
  7219.        1  PG        Protective Ground,  protects your equipment  against 
  7220.                     current surges, different voltage levels etc.
  7221.        2  TD        Transmit Data.  The computer sends data to the modem 
  7222.                     on this pin.
  7223.        3  RD        Receive  Data.  Data  sent  from the  modem  to  the 
  7224.                     computer goes through this pin.
  7225.        4  RTS       Request To Send,  goes high when the computer  wants 
  7226.                     to send data to the modem.
  7227.        5  CTS       Clear To Send (response to RTS),  goes high when the 
  7228.                     modem is ready to receive data from the computer.
  7229.        7  GND       Ground,  all  other  signals  are  relative  to  the 
  7230.                     voltage on this pin.
  7231.        8  CD        Carrier Detect is made high by the modem when a user 
  7232.                     is online (a connection is in progress).
  7233.        20 DTR       Data  Terminal Ready,  is made low by QuickBBS  when 
  7234.                     the modem should terminate the connection.
  7235.        22 RI        RIng,  goes high when the modem detects an  incoming 
  7236.                     call (the phone is ringing).
  7237.  
  7238.  
  7239.  
  7240.  
  7241.  
  7242.  
  7243.  
  7244.  
  7245.  
  7246.  
  7247.  
  7248.  
  7249.  
  7250.  
  7251.  
  7252.  
  7253.  
  7254.  
  7255.      ------------------------------------------------------------------
  7256.      QuickBBS ST                                               Page 110
  7257.  
  7258.  
  7259.  
  7260.  
  7261.      QuickBBS ST                                               Page 111
  7262.      ------------------------------------------------------------------
  7263.  
  7264.      APPENDIX J - FSE INTERFACE
  7265.  
  7266.      The  Full Screen Editor is called by QuickBBS when the  user  wants 
  7267.      to  write a message.  Before Quick executes the FSE it changes  the 
  7268.      current  directory  to  the  directory where  the  FSE  program  is 
  7269.      located  and writes one or two files.  The command line of the  FSE 
  7270.      contains the current baudrate (0 for local),  the number of minutes 
  7271.      the user has left,  the number of seconds before the user should be 
  7272.      timed out and the users graphics mode number.
  7273.  
  7274.      Quick will always write a file called MSGINFO.FSE, which is a plain 
  7275.      ASCII file with 7 lines:
  7276.  
  7277.      » who the message is from (max. 35 characters),
  7278.      » who the message is to (max. 35 characters),
  7279.      » the subject of the message (max. 72 characters),
  7280.      » the originating FidoNet address,
  7281.      » the destination FidoNet address,
  7282.      » an area name (max. 35 characters),
  7283.      » some message bits.
  7284.  
  7285.      The to,  from and subject lines are checked for validity by  Quick. 
  7286.      If the message is a Local or EchoMail message the FidoNet addresses 
  7287.      are 0, otherwise these lines contain the zone, net and node numbers 
  7288.      in the usual format,  followed by a space and the name of the  node 
  7289.      (max. 35 characters).
  7290.  
  7291.      The  message bits are stored as a string of 8 zeroes and ones  (MSB 
  7292.      first), which mean:
  7293.  
  7294.        Bit     Change?   Meaning
  7295.  
  7296.        0       Yes       the message is private
  7297.        1       No        the message is a reply
  7298.        2       No        the message is local
  7299.        3       No        the message is EchoMail
  7300.        4       Yes       the message 'to' line may be changed
  7301.        5       Yes       the message 'subject' line may be changed
  7302.        6       Yes       the message has a file attached
  7303.        7       No        reserved
  7304.  
  7305.      If  the  message  is  a  reply Quick  will  create  a  file  called 
  7306.      MSGTEXT.FSE, which contains the text of the original message. It is 
  7307.      unformatted,  null  terminated and contains linefeeds to  mark  the 
  7308.      end-of-paragraph. It may also contain kludge lines.
  7309.  
  7310.      The  FSE should add its own quote characters,  but please  use  the 
  7311.      standard  quote  format (e.g.  " XX> " or " > ").  This  way  other 
  7312.      editors  can detect them and quoting will not end up in an  extreme 
  7313.      mess.
  7314.  
  7315.  
  7316.  
  7317.  
  7318.  
  7319.  
  7320.  
  7321.      ------------------------------------------------------------------
  7322.      QuickBBS ST                                               Page 111
  7323.  
  7324.  
  7325.  
  7326.  
  7327.      QuickBBS ST                                               Page 112
  7328.      ------------------------------------------------------------------
  7329.  
  7330.      When  the  editor  returns  to  the BBS  it  should  exit  with  an 
  7331.      errorlevel:
  7332.  
  7333.        ErrorLevel   Meaning
  7334.        
  7335.        0            all went okay, save the message
  7336.        1            user aborted the message
  7337.        2            user dropped the carrier
  7338.        3            user fell asleep
  7339.        other        internal error - Quick will abort the message
  7340.  
  7341.      If  the editor returns with errorlevel 0 it must have  written  the 
  7342.      two files with new info. MSGTEXT.FSE will contain the message text, 
  7343.      null terminated, LF's to terminate paragraphs. CR's will be ignored 
  7344.      by Quick.  The message text may only contain characters 10,  13 and 
  7345.      the  range  32  to 127.  A null should be  used  to  terminate  the 
  7346.      message.
  7347.  
  7348.      The new MSGINFO.FSE may have lines 2 and 3 changed,  and in line  7 
  7349.      only  those bits marked with 'change?' above.  If line 2 or 3  have 
  7350.      been changed then the corresponding message bits should be set.  If 
  7351.      the  'to' field is changed in a local message the FSE should  check 
  7352.      the user base to validate the new name.
  7353.  
  7354.      If  either  of  the two files are not found Quick  will  abort  the 
  7355.      message.
  7356.  
  7357.  
  7358.  
  7359.  
  7360.  
  7361.  
  7362.  
  7363.  
  7364.  
  7365.  
  7366.  
  7367.  
  7368.  
  7369.  
  7370.  
  7371.  
  7372.  
  7373.  
  7374.  
  7375.  
  7376.  
  7377.  
  7378.  
  7379.  
  7380.  
  7381.  
  7382.  
  7383.  
  7384.  
  7385.  
  7386.  
  7387.      ------------------------------------------------------------------
  7388.      QuickBBS ST                                               Page 112
  7389.  
  7390.  
  7391.  
  7392.  
  7393.      QuickBBS ST                                               Page 113
  7394.      ------------------------------------------------------------------
  7395.  
  7396.      APPENDIX K - EXTERNAL CHAT INTERFACE
  7397.  
  7398.      The external chat program is called if...
  7399.  
  7400.      » the user yells for the SysOp
  7401.      » the SysOp presses Alt-C to start chatting
  7402.  
  7403.      Quick changes the current directory to the directory containing the 
  7404.      chat program and executes it with command line
  7405.  
  7406.        <Yell?> <Baud> <FirstName> <LastName> <Graphics> <Record>
  7407.  
  7408.      where
  7409.  
  7410.        <Yell?>      is  1 if the user yelled or 0 if the  SysOp  pressed 
  7411.                     Alt-C,
  7412.        <Baud>       is the current baudrate, or 0 in local mode,
  7413.        <FirstName>  is the users first name,
  7414.        <LastName>   is the users last name,
  7415.        <Graphics>   is the users graphics mode number,
  7416.        <Record>     is the users record number in USERS.BBS.
  7417.  
  7418.      The chat program should page the SysOp if <Yell?> is 1 etc.
  7419.  
  7420.  
  7421.  
  7422.  
  7423.  
  7424.  
  7425.  
  7426.  
  7427.  
  7428.  
  7429.  
  7430.  
  7431.  
  7432.  
  7433.  
  7434.  
  7435.  
  7436.  
  7437.  
  7438.  
  7439.  
  7440.  
  7441.  
  7442.  
  7443.  
  7444.  
  7445.  
  7446.  
  7447.  
  7448.  
  7449.  
  7450.  
  7451.  
  7452.  
  7453.      ------------------------------------------------------------------
  7454.      QuickBBS ST                                               Page 113
  7455.  
  7456.  
  7457.  
  7458.  
  7459.      QuickBBS ST                                               Page 114
  7460.      ------------------------------------------------------------------
  7461.  
  7462.      APPENDIX L - AVAILABLE UTILITIES
  7463.  
  7464.      There  are already quite a lot of utilities available for  QuickBBS 
  7465.      ST.  Most  of  them can be downloaded from our  Support  BBS.  Some 
  7466.      utilities  require  a  batch file setup.  The  ones  supplied  with 
  7467.      QuickBBS aren't listed here.
  7468.  
  7469.      Utilities
  7470.  
  7471.      » COMPOSER can be used to create yelltunes. Runs in high resolution 
  7472.        only and needs GfA-Basic 2.0. Provided as source code.
  7473.      » FSU can be used to scan your file areas for missing files  and/or 
  7474.        descriptions.
  7475.      » WOWSER can extract text files from archives and reads them,  wrks 
  7476.        a bit like the internal browser.
  7477.      » AMAIL  can  generate  .QWK mail packets  for  use  with  off-line 
  7478.        editors. Very power- and usefull, it's shareware
  7479.      » FIBU compiles your FILES.BBS file descriptions into one big file. 
  7480.      » LAST10 makes charts in ASCII,  VTM and VTC graphics modes of  the 
  7481.        last 10 callers.
  7482.      » LED is an offline message editor in a Gem environment (i.e.  with 
  7483.        windows etc). Very nice indeed!
  7484.      » QANSI converts VT-52 screens to Ansi graphics.  Supports  limited 
  7485.        animation but can only handle one screen at a time.
  7486.      » STICK (FidoNet), used to send and receive files to and from other 
  7487.        FidoNet   nodes.   It   automatically  sends   newest   versions, 
  7488.        descriptions etc.
  7489.      » TOP10  makes charts in ASCII,  VTM and VTC graphics modes of  the 
  7490.        top 10 uploaders, downloaders, message writers and callers.
  7491.  
  7492.      DoorGames     
  7493.  
  7494.      Because Quick can run Pandora and FoReM DoorGames you have quite  a 
  7495.      choice in this department too. A small selection...
  7496.  
  7497.      » Arcade is a collection of simple games like hang man and tic-tac-
  7498.        toe (noughts & crosses).
  7499.      » Dungeons  &  Dragons should ring a bell?  In this game  the  user 
  7500.        plays against your ST. He must search through dungeons collecting 
  7501.        treasures & fighting monsters. Very nice VT-52 graphics!
  7502.      » Galactic Empire is a sort of Space Empire Elite, but doesn't play 
  7503.        as well.
  7504.      » Space  Empire  Elite is an old favourite of  mine.  Users  battle 
  7505.        other  users trying to build a large empire.  You set  a  maximum 
  7506.        number of turns per day.  There are planets to be bought and fed, 
  7507.        troops  to  be  payed,  espionage  to  be  done  etc.  etc.  Very 
  7508.        addictive.
  7509.      » Space  Trader  Elite is another space game which is played  on  a 
  7510.        map.  You can travel from planet to planet,  buy and sell  goods, 
  7511.        attack other users and so on.  Not as competitive as Space Empire 
  7512.        though.
  7513.      » ST  Nationals concerns road racing.  You can race  against  other 
  7514.        users  and  spend your winnings on new or better parts  for  your 
  7515.        car.
  7516.  
  7517.  
  7518.  
  7519.      ------------------------------------------------------------------
  7520.      QuickBBS ST                                               Page 114
  7521.  
  7522.  
  7523.  
  7524.  
  7525.      QuickBBS ST                                               Page 115
  7526.      ------------------------------------------------------------------
  7527.  
  7528.      Others
  7529.  
  7530.      » QSTRUCT contains all the QuickBBS ST file structures.
  7531.  
  7532.  
  7533.  
  7534.  
  7535.  
  7536.  
  7537.  
  7538.  
  7539.  
  7540.  
  7541.  
  7542.  
  7543.  
  7544.  
  7545.  
  7546.  
  7547.  
  7548.  
  7549.  
  7550.  
  7551.  
  7552.  
  7553.  
  7554.  
  7555.  
  7556.  
  7557.  
  7558.  
  7559.  
  7560.  
  7561.  
  7562.  
  7563.  
  7564.  
  7565.  
  7566.  
  7567.  
  7568.  
  7569.  
  7570.  
  7571.  
  7572.  
  7573.  
  7574.  
  7575.  
  7576.  
  7577.  
  7578.  
  7579.  
  7580.  
  7581.  
  7582.  
  7583.  
  7584.  
  7585.      ------------------------------------------------------------------
  7586.      QuickBBS ST                                               Page 115
  7587.  
  7588.  
  7589.  
  7590.  
  7591.      QuickBBS ST                                               Page 116
  7592.      ------------------------------------------------------------------
  7593.  
  7594.      APPENDIX M - ERRORLEVELS & PARAMETERS
  7595.  
  7596.      QuickBBS exits with different ErrorLevels when NetMail or  EchoMail 
  7597.      is entered, when a system error occurs etc...
  7598.  
  7599.        Errorlevel   Meaning
  7600.  
  7601.                 0   Normal Exit
  7602.                 1   Normal Exit
  7603.                 2   Setup error
  7604.                 3   Carrier Dropped
  7605.                 4   NetMail written
  7606.                 5   EchoMail written
  7607.             other   Menu option errorlevel (type 15)
  7608.  
  7609.      By  checking  for  errorlevels 4 and 5 you can run  Scan  and  Pack 
  7610.      directly after QuickBBS to export any mail which was just written.
  7611.  
  7612.      A few parameters can be passed on the command line too...
  7613.  
  7614.      Parameter Meaning
  7615.  
  7616.      -B300     User online, 300 bps
  7617.      -B1200    User online, 1200 bps
  7618.      -B2400    User online, 2400 bps
  7619.      -B4800    User online, 4800 bps
  7620.      -B9600    User online, 9600 bps
  7621.      -B14400   User online, 14400 Bps
  7622.      -B19200   User online, 19200 bps
  7623.      -L        Operate in Local Mode
  7624.      -R        Re-login after exit-with-errorlevel
  7625.      -S        Simulate: don't use fast screen routines locally
  7626.      -N        Disable  statusbar and show mouse.  Should be  used  when 
  7627.                running MultiTos.
  7628.  
  7629.      As  you  can see,  when started from a batch file (with  a  mailer) 
  7630.      Quick can operate at speeds up to 19200 bps.  With the -R parameter 
  7631.      you don't need to select speed or local mode.
  7632.  
  7633.  
  7634.  
  7635.  
  7636.  
  7637.  
  7638.  
  7639.  
  7640.  
  7641.  
  7642.  
  7643.  
  7644.  
  7645.  
  7646.  
  7647.  
  7648.  
  7649.  
  7650.  
  7651.      ------------------------------------------------------------------
  7652.      QuickBBS ST                                               Page 116
  7653.  
  7654.  
  7655.  
  7656.  
  7657.      QuickBBS ST                                               Page 117
  7658.      ------------------------------------------------------------------
  7659.  
  7660.      APPENDIX N - EXAMPLE BATCH FILES
  7661.  
  7662.      The batch files listed here are for the PCommand shell.  This shell 
  7663.      has  a few bugs in the batch file handling  department.  The  batch 
  7664.      files shouldn't be too big (no larger than 5 or 6 Kb), and it seems 
  7665.      like  calling  one batch file from  another  causes  problems.  All 
  7666.      commands  are in uppercase,  the parameters are in  lowercase  (for 
  7667.      clarity,  PCommand doesn't care).  The comments in brackets  should 
  7668.      not be typed in.
  7669.  
  7670.      Running QuickBBS with QuickStart
  7671.  
  7672.      ECHO off
  7673.  
  7674.      REM ==========
  7675.      REM QuickBBS ST + QuickStart example batch file. To use this one
  7676.      REM you must rename QSTART.OVL to QSTART.PRG.
  7677.      REM ==========
  7678.  
  7679.      :start                              (jump here to rerun QuickStart)
  7680.      CLS
  7681.      ECHO Loading QuickStart
  7682.  
  7683.      CD \qbbs                                (change to right directory)
  7684.      qstart                                             (run QuickStart)
  7685.  
  7686.      CLS
  7687.      ECHO QuickStart exit with ErrorLevel %:e
  7688.  
  7689.      REM Check errorlevel returned by QuickStart...
  7690.  
  7691.        IF ERRORLEVEL 192 GOTO qbbs          (errorlevel 192? 19200 bps)
  7692.        IF ERRORLEVEL 144 GOTO qbbs          (errorlevel 144? 14400 bps)
  7693.        IF ERRORLEVEL 96  GOTO qbbs          (errorlevel  96?  9600 bps)
  7694.        IF ERRORLEVEL 48  GOTO qbbs          (errorlevel  48?  4800 bps)
  7695.        IF ERRORLEVEL 24  GOTO qbbs          (errorlevel  24?  2400 bps)
  7696.        IF ERRORLEVEL 12  GOTO qbbs          (errorlevel  12?  1200 bps)
  7697.        IF ERRORLEVEL  3  GOTO qbbs          (errorlevel   3?   300 bps)
  7698.        IF ERRORLEVEL  2  GOTO errorend      (level  2:   error!)
  7699.        IF ERRORLEVEL  1  GOTO local         (level  1:    local)
  7700.      GOTO end                                       (level  0:  offline)
  7701.  
  7702.      REM ==========
  7703.  
  7704.      :local                                 (jump here to login locally)
  7705.      CLS
  7706.      CD \qbbs                                    (go to right directory)
  7707.      quickbbs -L                            (run QuickBBS in local mode)
  7708.      IF ERRORLEVEL 6 GOTO afterquick             (exit with errorlevel?)
  7709.      GOTO start                                 (nope, rerun QuickStart)
  7710.  
  7711.  
  7712.  
  7713.  
  7714.  
  7715.  
  7716.  
  7717.      ------------------------------------------------------------------
  7718.      QuickBBS ST                                               Page 117
  7719.  
  7720.  
  7721.  
  7722.  
  7723.      QuickBBS ST                                               Page 118
  7724.      ------------------------------------------------------------------
  7725.  
  7726.      REM ==========
  7727.  
  7728.      :qbbs                                  (jump here for xxx bps users)
  7729.      CLS
  7730.      ECHO Starting up QuickBBS at %:e00 bps.
  7731.      CD \qbbs                                    (go to right directory)
  7732.      quickbbs -B%:e00                            (run QuickBBS at 300 bps)
  7733.      IF ERRORLEVEL 6 GOTO afterquick             (exit with errorlevel?)
  7734.      GOTO start                                 (no, back to QuickStart)
  7735.  
  7736.      REM ==========
  7737.  
  7738.      :end                             (jump here to bring board offline)
  7739.      CLS
  7740.      ECHO @3 18 - QuickBBS is Offline -
  7741.      ECHO .
  7742.      CD \QBBS
  7743.      EXIT                                            (out of batch file)
  7744.  
  7745.      REM ==========
  7746.  
  7747.      :errorend                               (jump here if error occurs)
  7748.      BELL                                               (sound the bell)
  7749.      CLS
  7750.      ECHO @3 18 - QuickStart Error
  7751.      ECHO .
  7752.      CD \qbbs
  7753.      BELL
  7754.      EXIT                                                  (out out out)
  7755.  
  7756.      REM ==========
  7757.      REM DoorGames etc. here...
  7758.      REM ==========
  7759.  
  7760.      :afterquick
  7761.  
  7762.      REM Check what errorlevel was returned by Quick. Note that the
  7763.      REM 'if errorlevel 6' bit actually means 'if errorlevel >= 6'
  7764.  
  7765.      IF ERRORLEVEL 7 GOTO dosgate                (level 7: remote shell)
  7766.      IF ERRORLEVEL 6 GOTO starwars               (level 6:  play a game)
  7767.      GOTO relogin                                (should never get here)
  7768.  
  7769.      REM ==========
  7770.  
  7771.      :relogin                       (rerun Quick with user still online)
  7772.      CLS
  7773.      ECHO Restarting QuickBBS.
  7774.      CD \qbbs
  7775.      quickbbs -R                         (rerun Quick, -R means Relogin)
  7776.      IF ERRORLEVEL 6 GOTO aferquick      (another exit-with-errorlevel?)
  7777.      GOTO start                                 (no, back to QuickStart)
  7778.  
  7779.  
  7780.  
  7781.  
  7782.  
  7783.      ------------------------------------------------------------------
  7784.      QuickBBS ST                                               Page 118
  7785.  
  7786.  
  7787.  
  7788.  
  7789.      QuickBBS ST                                               Page 119
  7790.      ------------------------------------------------------------------
  7791.  
  7792.      REM ==========
  7793.  
  7794.      :dosgate                               (jump here for remote shell)
  7795.      CLS
  7796.      ECHO Remote Dosgate in operation...
  7797.  
  7798.      CD \qbbs
  7799.      CTTY AUX                               (redirect PCommand to modem)
  7800.      cdwatch ON                         (monitor carrier, reset if lost)
  7801.  
  7802.      ECHO QuickBBS DOSGATE
  7803.      ECHO ================
  7804.      ECHO Type 'EXIT' to return to QuickBBS.
  7805.  
  7806.      INPUT                                        (interactive commands)
  7807.  
  7808.      cdwatch OFF                                  (carrier watching off)
  7809.      CTTY CON                                 (redirect back to console)
  7810.      ECHO Back from Dosgate
  7811.      GOTO relogin                                       (rerun QuickBBS)
  7812.  
  7813.      REM ==========
  7814.  
  7815.      :starwars                                  (Jump here to play game)
  7816.      CLS
  7817.      ECHO Starting DoorGame: StarWars
  7818.      CD \qbbs\starwars
  7819.      starwars                                         (start up program)
  7820.      GOTO relogin                                       (rerun QuickBBS)
  7821.  
  7822.      REM =======
  7823.      REM The End
  7824.      REM =======
  7825.  
  7826.  
  7827.  
  7828.  
  7829.  
  7830.  
  7831.  
  7832.  
  7833.  
  7834.  
  7835.  
  7836.  
  7837.  
  7838.  
  7839.  
  7840.  
  7841.  
  7842.  
  7843.  
  7844.  
  7845.  
  7846.  
  7847.  
  7848.  
  7849.      ------------------------------------------------------------------
  7850.      QuickBBS ST                                               Page 119
  7851.  
  7852.  
  7853.  
  7854.  
  7855.      QuickBBS ST                                               Page 120
  7856.      ------------------------------------------------------------------
  7857.  
  7858.      Running QuickBBS with The-Box or Binkley
  7859.  
  7860.      ECHO off
  7861.  
  7862.      REM ==========
  7863.      REM QuickBBS ST + The-Box example batch file.
  7864.      REM ==========
  7865.  
  7866.      :start                                 (jump here to rerun The-Box)
  7867.      CLS
  7868.      ECHO Loading The-Box
  7869.  
  7870.      CD \qbbs                                (change to right directory)
  7871.      tb unattended                          (run The-Box in mailer mode)
  7872.  
  7873.      CLS
  7874.      ECHO The-Box exit with ErrorLevel %:e
  7875.  
  7876.      REM Check errorlevel returned by The-Box...
  7877.      REM Use f10 to login locally. The levels for import/export depend
  7878.      REM on your TB.EVT configuration file.
  7879.  
  7880.      IF ERRORLEVEL 100 GOTO local             (level 100:         local)
  7881.      IF ERRORLEVEL 192 GOTO qbbs          (errorlevel 192? 19200 bps)
  7882.      IF ERRORLEVEL 144 GOTO qbbs          (errorlevel 144? 14400 bps)
  7883.      IF ERRORLEVEL  96 GOTO qbbs          (errorlevel  96?  9600 bps)
  7884.      IF ERRORLEVEL  48 GOTO qbbs          (errorlevel  48?  4800 bps)
  7885.      IF ERRORLEVEL  24 GOTO qbbs          (errorlevel  24?  2400 bps)
  7886.      IF ERRORLEVEL  12 GOTO qbbs          (errorlevel  12?  1200 bps)
  7887.      IF ERRORLEVEL   9 GOTO import        (level   9: received mail)
  7888.      IF ERRORLEVEL   4 GOTO export        (level   4:     pack mail)
  7889.      IF ERRORLEVEL   3 GOTO qbbs          (errorlevel   3?   300 bps)
  7890.      IF ERRORLEVEL   1 GOTO errorend      (level   1:        error!)
  7891.      GOTO end                             (level   0:       offline)
  7892.  
  7893.      REM ==========
  7894.  
  7895.      :local                                 (jump here to login locally)
  7896.      CLS
  7897.      CD \qbbs                                    (go to right directory)
  7898.      quickbbs -L                            (run QuickBBS in local mode)
  7899.      IF ERRORLEVEL 6 GOTO afterquick             (exit with errorlevel?)
  7900.      GOTO start                                    (nope, rerun The-Box)
  7901.  
  7902.      REM ==========
  7903.  
  7904.      :qbbs                                  (jump here for xxx bps users)
  7905.      CLS
  7906.      ECHO Starting up QuickBBS at %:e00 bps.
  7907.      CD \qbbs                                    (go to right directory)
  7908.      quickbbs -%:e300                            (run QuickBBS at xx bps)
  7909.      IF ERRORLEVEL 6 GOTO afterquick             (exit with errorlevel?)
  7910.      GOTO start                                    (no, back to The-Box)
  7911.  
  7912.  
  7913.  
  7914.  
  7915.      ------------------------------------------------------------------
  7916.      QuickBBS ST                                               Page 120
  7917.  
  7918.  
  7919.  
  7920.  
  7921.      QuickBBS ST                                               Page 121
  7922.      ------------------------------------------------------------------
  7923.  
  7924.      REM ==========
  7925.  
  7926.      :end                             (jump here to bring board offline)
  7927.      CLS
  7928.      ECHO @3 18 - QuickBBS is Offline -
  7929.      ECHO .
  7930.      CD \QBBS
  7931.      EXIT                                            (out of batch file)
  7932.  
  7933.      REM ==========
  7934.  
  7935.      :errorend                               (jump here if error occurs)
  7936.      BELL                                               (sound the bell)
  7937.      CLS
  7938.      ECHO @3 18 - The-Box Error -
  7939.      ECHO .
  7940.      CD \qbbs
  7941.      BELL
  7942.      EXIT                                                  (out out out)
  7943.  
  7944.      REM ==========
  7945.      REM DoorGames etc. here...
  7946.      REM ==========
  7947.  
  7948.      :afterquick
  7949.  
  7950.      REM Check what errorlevel was returned by Quick. Note that the
  7951.      REM 'if errorlevel 6' bit actually means 'if errorlevel >= 6'
  7952.  
  7953.      IF ERRORLEVEL 7 GOTO dosgate                (level 7: remote shell)
  7954.      IF ERRORLEVEL 6 GOTO starwars               (level 6:  play a game)
  7955.      GOTO relogin                                (should never get here)
  7956.  
  7957.      REM ==========
  7958.  
  7959.      :relogin                       (rerun Quick with user still online)
  7960.      CLS
  7961.      ECHO Restarting QuickBBS.
  7962.      CD \qbbs
  7963.      quickbbs -R                         (rerun Quick, -R means Relogin)
  7964.      IF ERRORLEVEL 6 GOTO aferquick      (another exit-with-errorlevel?)
  7965.      GOTO start                                    (no, back to The-Box)
  7966.  
  7967.      REM ==========
  7968.  
  7969.      :dosgate                               (jump here for remote shell)
  7970.      CLS
  7971.      ECHO Remote Dosgate in operation...
  7972.  
  7973.      CD \qbbs
  7974.      CTTY AUX                               (redirect PCommand to modem)
  7975.      cdwatch ON                         (monitor carrier, reset if lost)
  7976.  
  7977.      ECHO QuickBBS DOSGATE
  7978.      ECHO ================
  7979.      ECHO Type 'EXIT' to return to QuickBBS.
  7980.  
  7981.      ------------------------------------------------------------------
  7982.      QuickBBS ST                                               Page 121
  7983.  
  7984.  
  7985.  
  7986.  
  7987.      QuickBBS ST                                               Page 122
  7988.      ------------------------------------------------------------------
  7989.  
  7990.      INPUT                                        (interactive commands)
  7991.  
  7992.      cdwatch OFF                                  (carrier watching off)
  7993.      CTTY CON                                 (redirect back to console)
  7994.      ECHO Back from Dosgate
  7995.      GOTO relogin                                       (rerun QuickBBS)
  7996.  
  7997.      REM ==========
  7998.  
  7999.      :starwars                                  (Jump here to play game)
  8000.      CLS
  8001.      ECHO Starting DoorGame: StarWars
  8002.      CD \qbbs\starwars
  8003.      starwars                                         (start up program)
  8004.      GOTO relogin                                       (rerun QuickBBS)
  8005.  
  8006.      REM ==========
  8007.  
  8008.      :import                         (jump here to import received mail)
  8009.      CLS
  8010.      CD \qbbs
  8011.      ECHO Mail received, starting Import.
  8012.      ECHO # 
  8013.      import                                                 (run Import)
  8014.      GOTO start                                        (back to The-Box)
  8015.  
  8016.      REM ==========
  8017.  
  8018.      :export                           (jump here to pack outbound mail)
  8019.      CD \qbbs
  8020.      CLS
  8021.      ECHO Scanning echomail...
  8022.      ECHO #
  8023.      scan -p                                         (now scan EchoMail)
  8024.  
  8025.      CLS
  8026.      ECHO Scanning NetMail...
  8027.      ECHO #
  8028.      pack                                            (then scan NetMail)
  8029.      GOTO start                                        (back to The-Box)
  8030.  
  8031.      REM =======
  8032.      REM The End
  8033.      REM =======
  8034.  
  8035.  
  8036.  
  8037.  
  8038.  
  8039.  
  8040.  
  8041.  
  8042.  
  8043.  
  8044.  
  8045.  
  8046.  
  8047.      ------------------------------------------------------------------
  8048.      QuickBBS ST                                               Page 122
  8049.  
  8050.  
  8051.  
  8052.  
  8053.      QuickBBS ST                                               Page 123
  8054.      ------------------------------------------------------------------
  8055.  
  8056.      APPENDIX O - BUG REPORT FORM
  8057.  
  8058.      To  be  used  if you discover a bug in QuickBBS ST or  one  of  the 
  8059.      provided utilities.
  8060.  
  8061.      If you have problems please make sure...
  8062.  
  8063.      » that you have read the documentation properly,
  8064.      » that your configuration is right,
  8065.      » that your system date is correct,
  8066.      » that you have installed 4KBUF in your Auto folder,
  8067.      » that you have the latest version of the program.
  8068.  
  8069.      Then  remove all programs from your Auto folder (except 4KBUF)  and 
  8070.      all accessories, reboot and try again.
  8071.  
  8072.      If it still goes wrong,  fill in the bug report form below and send 
  8073.      it (as a message or as a file) to our Support BBS.  Please tell  us 
  8074.      as much as you can about the problem,  and if possible describe how 
  8075.      we  can  reproduce  it.  If you're  having  trouble  with  terminal 
  8076.      emulation or during file transfers, include the name of the program 
  8077.      'on the other end' (e.g.  Flash,  Interlink,  Procomm etc.).  Thank 
  8078.      you!
  8079.  
  8080.      Your name           _______________________________________________
  8081.      Key serial number   _______________________________________________
  8082.      BBS name            _______________________________________________
  8083.      BBS phone number    _______________________________________________
  8084.      FidoNet address     _______________________________________________
  8085.  
  8086.      System              Atari _______ ST ______________________________
  8087.                          _______________________________________ Monitor
  8088.                          ______________________________________ Harddisk
  8089.                          _________________________________________ Modem
  8090.                          TOS version ___________________________________
  8091.                          ___________________________________ Kb RAM free
  8092.                          _______________________________________________
  8093.                          _______________________________________________
  8094.  
  8095.      Auto folder         _______________________________________________
  8096.                          _______________________________________________
  8097.                          _______________________________________________
  8098.                          _______________________________________________
  8099.  
  8100.      Accessories         _______________________________________________
  8101.                          _______________________________________________
  8102.                          _______________________________________________
  8103.                          _______________________________________________
  8104.  
  8105.      Program             _______________________________________________
  8106.      Version             _______________________________________________
  8107.  
  8108.      Description etc. :
  8109.  
  8110.  
  8111.  
  8112.  
  8113.      ------------------------------------------------------------------
  8114.      QuickBBS ST                                               Page 123
  8115.  
  8116.