home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / HILFEN / MODEM / COMAND28 / BBS.DOC < prev    next >
Text File  |  1993-12-01  |  44KB  |  1,595 lines
  1. COM-AND Scripted BBS
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.           ------------------------------------------
  18.                 COM-AND Scripted BBS
  19.           Script based Bulletin Board for the IBM PC
  20.           ------------------------------------------
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.     COM-AND is distributed freely and may be copied by anyone for
  33.     any number of machines, for purposes of evaluation.  The author
  34.     offers COM-AND and its accessory programs as a package, as
  35.     "shareware".  If you USE the program a registration of $50.00 is
  36.     required.  The author may be reached:
  37.  
  38.  
  39.                  CABER Software
  40.                  R. (Scott) McGinnis
  41.                  P.O. Box 3607 Mdse Mart
  42.                  Chicago, IL 60654-0607
  43.  
  44.                  PLINK, GEnie id: TARTAN
  45.                  CIS is: 73147,2665
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Version 1.1: 910711
  55.  
  56. COM-AND Scripted BBS
  57.  
  58.  
  59.  
  60.                  Table of Contents
  61.                  -----------------
  62.  
  63.  
  64. I.    Introduction  .............................................. page 1
  65.  
  66.     A. What is COM-AND? ........................................ page 1
  67.     B. The BBS script .......................................... page 1
  68.  
  69. II.    Installing the BBS ......................................... page 2
  70.  
  71.     A. Create a subdirectory \BBS .............................. page 2
  72.     B. Load BBSETUP ............................................ page 2
  73.     C. Use BBSETUP ............................................. page 3
  74.     D. Exit BBSETUP and load BBMAINT ........................... page 4
  75.     E. Execute BBS ............................................. page 5
  76.  
  77. III.    Logon ...................................................... page 6
  78.  
  79. IV.    Bulletins .................................................. page 7
  80.  
  81. V.    Mail ....................................................... page 8
  82.  
  83. VI.    Files (Upload and Download) ................................ page 9
  84.  
  85. VII.    Chat mode .................................................. page 11
  86.  
  87. VIII.    Privileged commands ........................................ page 12
  88.  
  89. IX.    Menu tree .................................................. page 13
  90.  
  91.     A. Connect ................................................. page 13
  92.     B. Logon ................................................... page 13
  93.     C. Main Menu ............................................... page 13
  94.     D. Privileged .............................................. page 16
  95.     E. Registration ............................................ page 16
  96.  
  97. X.    BBS-Log .................................................... page 17
  98.  
  99. XI.    Program Requirements ....................................... page 18
  100.  
  101. XII.    Program and Author Information    ............................ page 19
  102.  
  103. XIII.    SupportWare BBS ............................................ page 20
  104.  
  105.  
  106.  
  107.  
  108.  
  109. Version 1.1: 910711
  110.  
  111. COM-AND Scripted BBS
  112.  
  113.  
  114.  
  115.                 Appendices
  116.                 ----------
  117.  
  118.  
  119. A.    Required and optional files ................................ page 21
  120.  
  121.     1. Required files in subdirectory \BBS ..................... page 21
  122.     2. Optional files in subdirectory \BBS ..................... page 21
  123.     3. Optional files in subdirectory \BBS\Bulletin ............ page 21
  124.     4. Optional files in subdirectory \BBS\Mail ................ page 21
  125.     5. Optional files in subdirectory \BBS\FILE ................ page 21
  126.  
  127. B.    File structures ............................................ page 22
  128.  
  129.     1. \BBS\BBS-USER ........................................... page 22
  130.     2. \BBS\Bulletin\BBS-BULL .................................. page 22
  131.     3. \BBS\Mail\BBS-MAIL ...................................... page 22
  132.     4. \BBS\FILE\BBS-FILE ...................................... page 22
  133.  
  134. C.    Maintenance ................................................ page 23
  135.  
  136.     1. Registrations ........................................... page 23
  137.     2. Mail .................................................... page 23
  138.     3. Bulletins ............................................... page 23
  139.     4. Files ................................................... page 23
  140.  
  141. D.    Modem configuration ........................................ page 24
  142.  
  143.     1. DTR ..................................................... page 24
  144.     2. CD ...................................................... page 24
  145.     3. Modem ESCAPE ............................................ page 25
  146.     4. Hangup .................................................. page 25
  147.     5. Modem Init .............................................. page 25
  148.     6. Other settings .......................................... page 25
  149.  
  150. E.    Sample files ............................................... page 26
  151.  
  152.     1. BBS-USER ................................................ page 26
  153.     2. BBS-BULL ................................................ page 26
  154.     3. BBS-MAIL ................................................ page 26
  155.     4. BBS-FILE ................................................ page 26
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164. Version 1.1: 910711
  165.  
  166. COM-AND Scripted BBS                             Page   1
  167.  
  168.  
  169. I.    Introduction
  170.  
  171.  
  172.     A. What is COM-AND?
  173.  
  174.  
  175.        COM-AND for the IBM PC and compatibles is a communications program
  176.        that may be used by itself, or with several integrated accessory
  177.        programs (which themselves may be used independently of COM-AND).
  178.        COM-AND provides standard comm program functions:  a dialing
  179.        directory, macros, disc logging, binary and ASCII file transfers,
  180.        scripted execution and so on.
  181.  
  182.  
  183.     B. The BBS script
  184.  
  185.  
  186.        This document details the BBS script provided with each version
  187.        of COM-AND.    The BBS script supports
  188.  
  189.        o    300/1200/2400 baud autoanswer
  190.        o    Reliable use whether the modem reports true CD or no
  191.        o    Access by ID and password
  192.  
  193.         .. SYSOP assigns ID and passwords to grant access
  194.         .. two privilege levels
  195.         .. time limited access for non-privileged IDs
  196.         .. the BBS supports a 'registration' function which could
  197.            automatically post a new ID/password, but does not now
  198.  
  199.        o    Comments to SYSOP from callers
  200.        o    SYSOP posted bulletins
  201.        o    Public and private mail
  202.        o    File upload and download
  203.  
  204.         .. WXMODEM, XMODEM, YMODEM, ZMODEM, and KERMIT
  205.         .. Uploads are not included in time limit computation
  206.  
  207.        o    SYSOP-to-caller chat mode (initiated by SYSOP)
  208.  
  209.        The BBS script is interpreted by COM-AND.  Therefore, it is not as
  210.        fast as a compiled program.    However, the speed of the COM-AND in-
  211.        terpretor is sufficient for this application on most modern PCs.
  212.  
  213.        The BBS script does not intend to provide a full fledged Bulletin
  214.        Board host.    It has been, and is now a work in progress.  Comments
  215.        and suggestions are welcomed.
  216.  
  217.  
  218.  
  219. Version 1.1: 910711
  220.  
  221. COM-AND Scripted BBS                             Page   2
  222.  
  223.  
  224. II.    Installation
  225.  
  226.  
  227.     Included with the BBS script are two utility scripts, one for BBS
  228.     setup and one for BBS file maintenance.  The BBSETUP script should be
  229.     run BEFORE BBS is loaded, of course.  However, it is suggested that
  230.     the first step taken is to create a subdirectory for the BBS on disk.
  231.  
  232.     The BBS script (as well as BBSETUP and BBMAINT) default to the sub-
  233.     directory \BBS for the main BBS subdirectory.  The default name for
  234.     the main subdirectory may be overridden through BBSETUP.
  235.  
  236.     A. Create a subdirectory \BBS
  237.  
  238.        From the DOS prompt, from the drive you wish to use for BBS, type:
  239.  
  240.         "d>" MD \BBS
  241.  
  242.        As noted above, ANY name may be used for the main subdirectory.
  243.        [In the following discussion \BBS will represent the main sub-
  244.        directory, what ever it may be named.] The "d>" above represents
  245.        the DOS prompt.  Copy the BBS script(s), BBSETUP, BBMAINT,
  246.        BBMAINT1, BBMAINT2, BBMAINT3, and BBMAINT4 to this subdirectory,
  247.        from the place they were de-archived:
  248.  
  249.         "d>" COPY BB*.* \BBS\*.*
  250.  
  251.     B. Load BBSETUP
  252.  
  253.        At this point, load COM-AND and invoke BBSETUP from the new sub-
  254.        directory.  For example, from the DOS prompt:
  255.  
  256.          "d>" COM-AND /f\BBS\BBSETUP
  257.  
  258.        loads COM-AND and invokes BBSETUP from the \BBS subdirectory.
  259.        It is important that BBSETUP be executed FROM the BBS main sub-
  260.        directory the first time, as BBSETUP creates a parametrization
  261.        file for BBS that best resides on that subdirectory.  The file
  262.        BBSETUP creates is named BBSDAT.  BBSDAT is placed by BBSETUP:
  263.  
  264.        1) If BBSDAT does not exist on the default subdirectory, on the
  265.           subdirectory indicated by the COM-AND= environment variable, OR
  266.           on the subdirectory from which BBSETUP was executed, it will be
  267.           created on the subdirectory from which BBSETUP was executed.
  268.  
  269.        2) If BBSDAT exists in any of the above mentioned three places,
  270.           preference in the order given, it will be overwritten there.
  271.  
  272.  
  273.  
  274. Version 1.1: 910711
  275.  
  276. COM-AND Scripted BBS                             Page   3
  277.  
  278.  
  279. II.    Installation (continued)
  280.  
  281.  
  282.     C. Use BBSETUP to identify values to be used by the BBS
  283.  
  284.        From BBSETUP's main menu, select the items in numeric order.
  285.  
  286.        1) Identify subdirectories used by BBS;        Do this 1st!
  287.  
  288.           a) Identify BBS main subdir; Regardless of the subdirectory
  289.          from which BBSETUP was executed, the first time BBSETUP is
  290.          used, it will show \BBS.  Change this value as needed.
  291.  
  292.           b) Identify BBS Files subdir; This defaults to \BBS\FILES.  It
  293.          may be placed anywhere.  [It does not need to be related to
  294.          the main subdirectory, or even on the same disk!]  The sub-
  295.          directory may not even exist... it may be created (below).
  296.  
  297.           c) Identify BBS Mail subdir; This defaults to \BBS\MAIL. See
  298.          notes to 1)b above.
  299.  
  300.           d) Identify BBS Bulletins subdir; Default is to \BBS\BULLETIN.
  301.          See notes to 1)b above.
  302.  
  303.  
  304.        2) Create BBS subdirectories and files;        Do this 2nd!
  305.  
  306.           Once the above subdirectories have been identified, select this
  307.           item from the BBSETUP main menu.    If any of the subdirectories
  308.           identified in the first step do not exist, they will be listed,
  309.           and you will be asked if they are to be created.
  310.  
  311.  
  312.        3) Identify modem values                Finally...
  313.  
  314.           a) Identify modem port; The default value is the default for
  315.          COM-AND.  You may wish to change this for the BBS.  Whatever
  316.          port you indicate here WILL be the BBS's communication port.
  317.  
  318.           b) Identify modem speed; The default value is the default for
  319.          COM-AND.  You may wish to change this for the BBS.  This is
  320.          the speed set by the BBS when waiting for a call.
  321.  
  322.           c) Identify modem control string;  The default value for this
  323.          is appropriate for most Hayes compatible modems.  It may
  324.          need modification for some modems; if so, refer to the
  325.          documentation that came with the modem.
  326.  
  327.  
  328.  
  329. Version 1.1: 910711
  330.  
  331. COM-AND Scripted BBS                             Page   4
  332.  
  333.  
  334. II.    Installation (continued)
  335.  
  336.  
  337.     D. Exit BBSETUP and load BBMAINT
  338.  
  339.        ESC or successive carriage returns will exit BBSETUP.  Back in
  340.        COM-AND, invoke BBMAINT through the F2 key.    In the script prompt
  341.        window, for example, type:
  342.  
  343.         \BBS\BBMAINT
  344.  
  345.        [Execute BBMAINT from the main subdirectory for the BBS.]  The
  346.        BBMAINT script is used to maintain (and create) the control files
  347.        used by BBS.  The only file that MUST be altered before BBS is
  348.        executed the first time is the User file.  There must be at least
  349.        ONE user ID for logon!
  350.  
  351.        The BBMAINT script provides the following functions:
  352.  
  353.        1) Update BBS User file
  354.  
  355.           a) Add an ID
  356.           b) Delete an ID
  357.           c) Modify an ID's values
  358.           d) Print User list
  359.  
  360.        2) Update BBS File directory
  361.  
  362.           a) Add a file to the up/download list [NOTE: The file being
  363.          listed should reside on the Bulletin subdirectory before it
  364.          is added.  It does not HAVE to exist there, but it should.]
  365.           b) Delete a file from the list
  366.           c) Modify a file's listing
  367.           d) Print a file list
  368.  
  369.        3) Update BBS Mail listing
  370.  
  371.           a) Clean up mail directory
  372.           b) Delete notes older than ...
  373.  
  374.        4) Update BBS Bulletin listing
  375.  
  376.           a) Add a bulletin to the list.  [NOTE:  The file containing the
  377.          bulletin should reside on the Bulletin subdirectory before
  378.          it is added.  It does not HAVE to exist, but it should.]
  379.           b) Delete a bulletin from the list
  380.           c) Modify a bulletin's listing
  381.           d) Print a bulletin list
  382.  
  383.  
  384. Version 1.1: 910711
  385.  
  386. COM-AND Scripted BBS                             Page   5
  387.  
  388.  
  389. II.    Installation (continued)
  390.  
  391.  
  392.     E. Execute BBS
  393.  
  394.        Two BBS script files are included in each release.  The script
  395.        BBS.SRC is commented source for the BBS.  The file BBS.CMD is a
  396.        stripped script; it contains no comments and is not very readable.
  397.        BBS.CMD is the script that should be executed (stripped, it exe-
  398.        cutes faster than BBS.SRC).    BBS.SRC is provided for the intrepid
  399.        who wish to modify the BBS.
  400.  
  401.  
  402.        For example, in COM-AND, from the F2 script prompt window, type:
  403.  
  404.         \BBS\BBS
  405.  
  406.        [COM-AND will not recognize BBS.SRC as a script unless the ".SRC"
  407.        is explicit.]  Again, execute the BBS from the BBS main subdirec-
  408.        tory, so that BBS may find the BBSDAT file created by BBSETUP.
  409.  
  410.  
  411.        Having loaded BBS, it is suggested you then call in from another
  412.        PC and test the setup.
  413.  
  414.  
  415.        Should the use of BBS become a habit (horrors!), a simple batch
  416.        file may be used to invoke it from the DOS prompt:
  417.  
  418.         COM-AND /q/f\BBS\BBS
  419.  
  420.        [The /q inhibits COM-AND's automatic execution of COM-AND.CMD, if
  421.        one is found.  COM-AND.CMD's that pause for entry are difficult to
  422.        use in batch mode.]
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439. Version 1.1: 910711
  440.  
  441. COM-AND Scripted BBS                             Page   6
  442.  
  443.  
  444. III.    Logon
  445.  
  446.  
  447.     Callers to this BBS must be identified through and ID and password
  448.     in the BBS-User file.  The posting if IDs and passwords is performed
  449.     through the BBMAINT script.
  450.  
  451.  
  452.     New callers may 'register'... their name, address, telephone and
  453.     requested ID/password are logged to the BBS-NOTE file (created by
  454.     BBS in the main subdirectory when comments are posted) for review.
  455.  
  456.  
  457.     Two privilege levels are supported at this time.  Non-privileged
  458.     callers are granted 60 minutes of connect time per call.  Privileged
  459.     users are granted unlimited connect.  Note that non-privileged users
  460.     may call back.    The BBS does not record time used across a day.
  461.  
  462.  
  463.     A non-privileged user has the ability to upload files (to the BBS
  464.     files subdirectory) and download files (from the BBS files subdirec-
  465.     tory).    A non-privileged user may read bulletins that are not marked
  466.     'privileged', may read mail addressed to that User-ID or ALL, and may
  467.     write mail to any ID.
  468.  
  469.  
  470.     A privileged user has the ability to upload files to any legitimate
  471.     subdirectory and download files from any legitimate subdirectory.
  472.     A privileged user may read any posted bulletins, may read mail
  473.     address any ID, and may write mail to any ID.
  474.  
  475.  
  476.     In addition, the privileged user has access to a 'Privileged' menu of
  477.     functions (from the main menu).  The menu provides:
  478.  
  479.     o    Listing of files on any legitimate subdirectory
  480.     o    Changing the default subdirectory (temporarily... this change
  481.         only holds during the 'Privileged' menu)
  482.     o    Listing the subdirectory tree from any disk (using the TREED
  483.         utility, public domain, not supplied with this script)
  484.     o    Shell to DOS on the host machine and execute single DOS
  485.         command lines (BE VERY CAREFUL - this can be fatal to BBS!)
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494. Version 1.1: 910711
  495.  
  496. COM-AND Scripted BBS                             Page   7
  497.  
  498.  
  499. IV.    Bulletins
  500.  
  501.  
  502.     Bulletins are files displayed to the caller on request from the
  503.     B)ulletin menu of BBS.    Bulletins are identified to the BBS through
  504.     the BBS-BULL file on the BBS Bulletins subdirectory.  This file is
  505.     maintained through Add/Delete/Modify bulletin functions of BBMAINT.
  506.  
  507.  
  508.     [Note that a bulletin file should exist on the Bulletins subdirectory
  509.     BEFORE it is added by BBMAINT.    If a bulletin file is listed but
  510.     does not exist, it will not appear in the listing given the caller.]
  511.  
  512.  
  513.     The B)ulletin submenu supports the following user commands:
  514.  
  515.     o    L)ist        List available bulletins
  516.     o    #        Read a specific bulletin
  517.  
  518.  
  519.     The list of available bulletins is taken from the file BBS-BULL.
  520.     Comments in the file are not printed for the caller to see.  Bull-
  521.     etin numbers may be arbitrarily assigned (and may even be alpha!).
  522.  
  523.  
  524.     Individual bulletins may be restricted to privileged callers only.
  525.  
  526.  
  527.     The caller selects a bulletin number to view from the list supplied.
  528.     The bulletin is transferred using an ASCII send function:  control-
  529.     S and control-Q may be used to suspend the transfer.
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549. Version 1.1: 910711
  550.  
  551. COM-AND Scripted BBS                             Page   8
  552.  
  553.  
  554. V.    Mail
  555.  
  556.  
  557.     Letters are files displayed to the caller on request from the M)ail
  558.     menu of BBS.  Mail files identified to the BBS through the BBS-MAIL
  559.     file on the BBS Mail subdirectory.  This file is maintained through
  560.     Cleanup/Delete-old functions of BBMAINT.
  561.  
  562.  
  563.     The M)ail submenu supports the following user commands:
  564.  
  565.     o    S)can        Scan postings for mail 'to' the caller
  566.     o    L)ist        List mail (to,from,date,subject)
  567.     o    N)ew        Read new mail (to caller, and public posts)
  568.     o    A)ll        Read all mail (to caller, and public posts)
  569.     o    W)rite        Write a message (public or private)
  570.  
  571.  
  572.     BBS does not support editing of postings at this time.
  573.  
  574.  
  575.     The list of pending mail is taken from the file BBS-MAIL.  Comments
  576.     in the file are not printed for the caller to see.  Mail is only
  577.     readable sequentially (at this time).  Mail is marked 'private' to
  578.     receiver when it is created (unless it is posted to the ID ALL).
  579.  
  580.  
  581.     The BBMAINT script provides two maintenance functions for mail.
  582.  
  583.     o    Cleanup: The clean function reconciles the BBS-Mail listing
  584.         against mail files actually existing.  Regular use of this
  585.         service speeds user access to mail.
  586.  
  587.     o    Delete: The delete function will delete letters older than a
  588.         given age (prompted).  It performs a cleanup function at the
  589.         same time.  [NOTE:  the age of letters to be kept is limited
  590.         to the start of the year before the current year.]
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604. Version 1.1: 910711
  605.  
  606. COM-AND Scripted BBS                             Page   9
  607.  
  608.  
  609. VI.    Files (Upload and Download)
  610.  
  611.  
  612.     "Files" in this context are files displayed to the caller on request
  613.     from the F)iles menu of BBS.  Files are identified to the BBS through
  614.     the BBS-FILE file on the BBS Files subdirectory (or elsewhere, see
  615.     below).  BBS-File is maintained through Add/Delete/Modify bulletin
  616.     functions of BBMAINT, and is also updated by the BBS script upon
  617.     successful upload.
  618.  
  619.  
  620.     [Note that a file should exist on the Files subdirectory BEFORE it is
  621.     added by BBMAINT.  If a file is listed but does not exist, it will
  622.     not appear in the listing given the caller.  See also note below.]
  623.  
  624.  
  625.     The F)iles submenu supports the following user commands:
  626.  
  627.     o    L)ist        List available files
  628.     o    S)earch     Search the file list for a substring
  629.     o    U)pload     Upload a file (to the board)
  630.     o    D)ownload    Download a file (from the board)
  631.  
  632.  
  633.     Files may be uploaded and downloaded from this script using:
  634.  
  635.     o    WXMODEM (Windowed XMODEM)
  636.     o    XMODEM (CRC or checksum)
  637.     o    YMODEM (XMODEM 1-K, CRC or checksum)
  638.     o    ZMODEM
  639.     o    KERMIT (Windowed or plain)
  640.  
  641.  
  642.     Non-privileged callers are not allowed to upload files that duplicate
  643.     files on the \BBS\Files subdirectory.  Non-privileged callers are
  644.     limited to downloading files (1) listed in BBS-File and (2) from the
  645.     Files subdirectory (not necessarily just those listed by the L)ist
  646.     display, but the caller must know the file is there).
  647.  
  648.  
  649.     Privileged callers may upload/download to/from any accessible disc
  650.     device and subdirectory, by specifically qualifying the file name.
  651.  
  652.  
  653.     Uploads are added at the end of the BBS-FILE file with a caller sup-
  654.     plied description, UNLESS the caller is privileged, AND the upload
  655.     was performed to a specific path.  When a file is uploaded to a spec-
  656.     ific subdirectory, no BBS-FILE entry is made.
  657.  
  658.  
  659. Version 1.1: 910711
  660.  
  661. COM-AND Scripted BBS                             Page  10
  662.  
  663.  
  664. VI.    Files (continued)
  665.  
  666.  
  667.     Files listed through BBS-FILE may actually reside on any path or
  668.     drive.    By default, a file must exist on the \BBS\FILES subdirectory.
  669.     However, if the description field of a BBS-File record begins with ^A
  670.     (control-a, not caret/letter-a), and if a second ^A is found after
  671.     it, the information in between will be used for pathing the file
  672.     specified.  In this manner, files listed in BBS-File may point to
  673.     from ANY drive or subdirectory.
  674.  
  675.  
  676.     For example, the description:
  677.  
  678.         xc:\prodxThis is a file description
  679.  
  680.     where 'x' on the screen is a 'happy face' (^A is represented as a
  681.     happy face on IBM PC compatible monitors) directs BBS to search for
  682.     the file on the "C:\PROD" drive and subdirectory.  The pathing will
  683.     NOT show to a caller of the BBS - the remainder of the description
  684.     (following the second ^A) is what is displayed.
  685.  
  686.  
  687.     When adding a file to BBS-FILE through BBMAINT, BBMAINT will inform
  688.     that the file does not exist, and query if it is to be added anyway.
  689.     When a file that BBMAINT cannot 'see' is added to BBS-FILE, its date
  690.     and size are set to "******".  When BBS sees the "*****"s and has
  691.     located the file, it replaces the fields with the file's actual date
  692.     and size.
  693.  
  694.  
  695.     In this manner, too, a file may be listed in BBS-FILE through BBMAINT
  696.     and THEN copied to the \BBS\FILES subdirectory.  [However, it is
  697.     recommended the file be copied there first, as a policy.]
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714. Version 1.1: 910711
  715.  
  716. COM-AND Scripted BBS                             Page  11
  717.  
  718.  
  719. VII.    Chat with SYSOP
  720.  
  721.  
  722.     The A)larm command at the main prompt sounds a tune on the local
  723.     console's speaker.  If the SYSOP wishes to respond the SYSOP may
  724.     interrupt the caller (whether the ALARM has been used or no) with
  725.     the ESCape key.
  726.  
  727.  
  728.     Pressing the ESCape key during the script's operation will interrupt
  729.     the script; however, the caller is not disconnected immediately.
  730.     The SYSOP may choose to terminate the script (in which case a HANGUP
  731.     is performed).    The SYSOP may alternately choose to CHAT with the
  732.     caller.
  733.  
  734.  
  735.     When the SYSOP selects CHAT, the caller is informed of operator in-
  736.     tervention.  The SYSOP is prompted for a line of text (blank lines
  737.     entered by the SYSOP result in a query: "Continue" and are the means
  738.     for termination of the CHAT).  When the SYSOP presses CR, any text
  739.     is sent to the caller and the caller is prompted for text.  The chat
  740.     continues back and forth, one line at a time, until the caller
  741.     disconnects or the SYSOP terminates the chat.
  742.  
  743.  
  744.     At this time, time spent in CHAT is not added back to the caller's
  745.     total time alotment.
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769. Version 1.1: 910711
  770.  
  771. COM-AND Scripted BBS                             Page  12
  772.  
  773.  
  774. VIII.    Privileged access
  775.  
  776.  
  777.     Users flagged in the BBS-User file with privileged access are
  778.     provided an additional main menu subcommand ("P").  The "Privilege"
  779.     command gives access to a submenu with the commands:
  780.  
  781.  
  782.     o    L)ist       performs a DIR on the current subdirectory
  783.  
  784.     o    S)ubdir    changes the current drive:subdirectory;  This
  785.                holds only for the duration of the "Privilege"
  786.                menu.
  787.  
  788.     o    P)ath       provides a graphics display of the tree structure
  789.                of the current default disc (This requires the
  790.                public domain utility TREED.COM)
  791.  
  792.     o    D)os       performs a DOS command; BE WARY OF THIS FUNCTION!
  793.                A DOS command that does NOT return immediately,
  794.                such as, say, 123, will halt the BBS.  Redirection
  795.                is used to display the results of the DOS command.
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824. Version 1.1: 910711
  825.  
  826. COM-AND Scripted BBS                             Page  13
  827.  
  828.  
  829. IX.    Menu Tree
  830.  
  831.  
  832.     A. Connect
  833.  
  834.        The Flying Scotsman greets you!
  835.  
  836.        The connect text, above, is issued if the file 'BBS-Welc' is not
  837.        found on the \BBS subdirectory.  If BBS-Welc is available, it is
  838.        transmitted instead (as an ASCII file).
  839.  
  840.     B. Logon
  841.  
  842.        Enter your ID (or enter GUEST):
  843.        Enter your password:
  844.  
  845.        The logon prompt, above, is issued after the connect welcome.  If
  846.        the response to the logon prompt is "GUEST", the caller is shunted
  847.        to "REGISTRATION" below (after which the caller is disconnected).
  848.        Any non-null response BUT "GUEST" to the logon prompt results in a
  849.        password prompt.  The password response, too, must be non-null. A
  850.        failed ID/Password pair is retried 3 times.
  851.  
  852.     C. Main menu
  853.  
  854.        C)omment, B)ulletins, M)ail, F)iles, A)larm or E)xit:
  855.  
  856.        The main menu text, above, is issued to a non-privileged caller if
  857.        the file 'BBS-NpMn' is not found on the \BBS subdirectory.  If
  858.        BBS-NpMn is available, it is transmitted instead.
  859.  
  860.        P)rivileged, C)omment, B)ulletins, M)ail, F)iles, A)larm or E)xit:
  861.  
  862.        The main menu text, above, is issued to a privileged caller if
  863.        the file 'BBS-PrMn' is not found on the \BBS subdirectory.  If
  864.        BBS-PrMn is available, it is transmitted instead.
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879. Version 1.1: 910711
  880.  
  881. COM-AND Scripted BBS                             Page  14
  882.  
  883.  
  884. IX.    Menu Tree
  885.  
  886.  
  887.     C. Main menu (continued)
  888.  
  889.        1. Comment
  890.  
  891.           Do you wish to leave a comment? (Y/N, cr=n):
  892.  
  893.           The comment prompt, above, is issued if the file 'BBS-NoMe' is
  894.           not found on the \BBS subdirectory.  If BBS-NoMe is available,
  895.           it is transmitted instead.  If the response is "y", the fol-
  896.           lowing queries are issued:
  897.  
  898.           Each line, as you enter it will be recorded.  No edits, yet...
  899.           Enter a line/line(s) of text.  A blank line ends the note.
  900.           1:
  901.           2:
  902.           ...
  903.  
  904.        2. Bulletin
  905.  
  906.           L)ist, M)ain, E)xit, or a bulletin number:
  907.  
  908.           The bulletin submenu, above, is issued if the file 'BBS-BuMe'
  909.           is not found on the \BBS subdirectory.  If BBS-BuMe is avail-
  910.           able, it is transmitted instead.
  911.  
  912.           a) List: <no subcommands>
  913.           b) bulletin number: <no subcommands>
  914.  
  915.        3. Mail
  916.  
  917.           S)can, L)ist, N)ew, A)ll, W)rite, M)ain or E)xit:
  918.  
  919.           The mail submenu, above, is issued if the file 'BBS-MeMe' is
  920.           not found on the \BBS subdirectory.  If BBS-MeMe is available,
  921.           it is transmitted instead.
  922.  
  923.           a) SCAN: <no subcommands>
  924.           b) LIST: <no subcommands>
  925.           c) NEW:  <no subcommands>
  926.  
  927.          D)elete, R)eply, Q)uit (cr=continue):
  928.          - or -   R)eply, Q)uit (cr=continue):
  929.  
  930.          After each note is read, the above text prompts for
  931.          action.
  932.  
  933.  
  934. Version 1.1: 910711
  935.  
  936. COM-AND Scripted BBS                             Page  15
  937.  
  938.  
  939. IX.    Menu Tree
  940.  
  941.  
  942.     C. Main menu (continued)
  943.  
  944.        3. Mail (continued)
  945.  
  946.           d) ALL:  <no subcommands>
  947.  
  948.          After each note is read, the same prompts as for 'NEW'
  949.          (above) are issued.
  950.  
  951.           e) WRITE:
  952.  
  953.          To:
  954.          Subject:
  955.          Each line, as you enter it will be recorded.  No edits, yet
  956.          Enter a line/line(s) of text.    A blank line ends the text.
  957.          1:
  958.          2:
  959.          ...
  960.          Save? (Y/N, cr=y):
  961.          Private? (Y/N, cr=n):
  962.  
  963.        4. Files
  964.  
  965.           L)ist, S)earch, U)pload, D)ownload, M)ain or E)xit:
  966.  
  967.           The files submenu, above, is issued if the file 'BBS-FiMe' is
  968.           not found on the \BBS subdirectory.  If BBS-FiMe is available,
  969.           it is transmitted instead.
  970.  
  971.           a) LIST: <no subcommands>
  972.           b) SEARCH:
  973.  
  974.          Enter the search string:
  975.  
  976.           c) UPLOAD:
  977.  
  978.          Enter the file name:
  979.          W)xmodem, X)modem, Y)modem (X1k), Z)modem, or K)ermit:
  980.          Description:
  981.  
  982.           d) DOWNLOAD:
  983.  
  984.          Enter the file name:
  985.          W)xmodem, X)modem, Y)modem, Z)modem, K)ermit, or A)scii:
  986.  
  987.  
  988.  
  989. Version 1.1: 910711
  990.  
  991. COM-AND Scripted BBS                             Page  16
  992.  
  993.  
  994. IX.    Menu Tree
  995.  
  996.  
  997.     D. Privileged
  998.  
  999.        L)ist, P)ath, S)ubdir, D)OS, M)ain or E)xit:
  1000.  
  1001.        The privileged submenu, above, is issued if the file 'BBS-PpMn' is
  1002.        not found on the \BBS subdirectory.    If BBS-PpMn is available, it
  1003.        is transmitted instead.
  1004.  
  1005.        a) SUBDIR:
  1006.  
  1007.         Enter the drive:subdirectory:
  1008.  
  1009.        b) PATH:
  1010.  
  1011.         Pathlist command:
  1012.  
  1013.        c) DOS:
  1014.  
  1015.         Warning: this command may be used to invoke ANY COMMAND that
  1016.         DOS can execute.  If you load a program requiring keyboard
  1017.         entry, you lock yourself out and leave the board unusable.
  1018.  
  1019.         Enter your command:
  1020.  
  1021.        d) DIR:
  1022.  
  1023.         Directory command:
  1024.  
  1025.     E. Registration
  1026.  
  1027.        Do you wish to register? (Y/N, cr=Y):
  1028.  
  1029.           The query, above, is issued if the file 'BBS-Reme' is not found
  1030.           on the \BBS subdirectory.  If BBS-Reme is found, its contents
  1031.           are transmitted instead.    On 'Y' entry:
  1032.  
  1033.        Enter your full name:
  1034.        Enter your street address:
  1035.        Enter your city/state and zip:
  1036.        Enter a area code and phone number where
  1037.        you may be reached:
  1038.        Enter the ID (1-8 chars) you wish to use:
  1039.        Enter the password (1-8 chars) you wish to use:
  1040.        Repeating your entry...
  1041.        Is this correct? (Y/N, cr=n):
  1042.  
  1043.  
  1044. Version 1.1: 910711
  1045.  
  1046. COM-AND Scripted BBS                             Page  17
  1047.  
  1048.  
  1049. X.    BBS-Log
  1050.  
  1051.  
  1052.     BBS activity is logged to a file BBS-Log on the \BBS subdirectory.
  1053.     BBS-Log is an ASCII file.  It may be printed with the DOS PRINT
  1054.     command.  The following events are logged:
  1055.  
  1056.  
  1057.     o   * BBS script loaded                 (also to calllog)
  1058.     o   * BBS cycled                    (also to calllog)
  1059.     o   * BBS script terminated                (also to calllog)
  1060.  
  1061.     o   <connect string from modem on connect, carries speed usually)
  1062.  
  1063.     o   Logon <ID>                        (also to calllog)
  1064.     o   Failed logon            (max number of attempts exceeded)
  1065.     o   Logoff <ID>                     (also to calllog)
  1066.  
  1067.     o   Upload: (x): <name>, Success            (x -> method)
  1068.     o   Uload of <name> succeeded, but BBS-FIle open failed
  1069.     o   Upload: (x): <name>, Failure            (x -> method)
  1070.  
  1071.     o   Download: (x): <name>, Success            (x -> method)
  1072.     o   Download: (x): <name>, Failure            (x -> method)
  1073.  
  1074.     o   Comment recorded
  1075.  
  1076.     o   Bulletin <number> read
  1077.  
  1078.     o   Registration aborted - disconn
  1079.     o   Registration declined by caller
  1080.     o   Registration requested
  1081.  
  1082.  
  1083.     If BBS-Log does not exist when the BBS script tries to write to the
  1084.     log, the file is created.  It is suggested that the log be printed
  1085.     regularly, and the file deleted afterwards.
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099. Version 1.1: 910711
  1100.  
  1101. COM-AND Scripted BBS                             Page  18
  1102.  
  1103.  
  1104. XI.    Program requirements
  1105.  
  1106.  
  1107.     This program can only function on an IBM PC or DOS compatible
  1108.     machine.  COM-AND does direct to screen buffer fetches and stores
  1109.     (unless BIOS screen updates are directed using the /C switch or the
  1110.     Alt-O options menu).
  1111.  
  1112.  
  1113.     COM-AND is TopView aware even without the /C switch or Alt-O option.
  1114.  
  1115.  
  1116.     COM-AND supports MDA, CGA, EGA and Hercules.  COM-AND uses a Micro-
  1117.     soft Mouse if one is available...
  1118.  
  1119.  
  1120.     COM-AND disk I/O is done through the 'Handle' oriented I/O routines
  1121.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  1122.  
  1123.  
  1124.     COM-AND (Version 2.8) requires 256K for itself.  You need 384K to
  1125.     take advantage of the DOS Gateway and to load accessories.
  1126.  
  1127.  
  1128.     This script requires a 300, 1200 or 2400 baud modem.  [Others could
  1129.     be supported with modification to the script.]    This script is most
  1130.     reliable if the modem is set to report true CD.
  1131.  
  1132.  
  1133.     And of course, for a Bulletin Board, you need alot of disc space!
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154. Version 1.1: 910711
  1155.  
  1156. COM-AND Scripted BBS                             Page  19
  1157.  
  1158.  
  1159. XII.    Author information
  1160.  
  1161.  
  1162.     COM-AND was written using Microsoft Macro-Assembler.  The author
  1163.     likes assembler.  Assembly language is an entirely appropriate
  1164.     vehicle for some of the program, and a not-inappropriate vehicle
  1165.     for the rest of it.  Everything, in moderation...
  1166.  
  1167.  
  1168.     The author of COM-AND and this script is R.  Scott McGinnis of
  1169.     Chicago, IL.  His PLINK and GEnie ID:  TARTAN.    Comment and
  1170.     suggestions (and criticism in moderation) are welcomed:
  1171.  
  1172.              CABER Software
  1173.              R. (Scott) McGinnis
  1174.              P.O. Box 3607 Mdse Mart
  1175.              Chicago, IL 60654-0607
  1176.  
  1177.  
  1178.     I want to thank Mike Todd (SYSOP of the IBM PC SIG on the late
  1179.     SOURCE, and then on UNISON) and John Poindexter for their valuable
  1180.     comments on the 2.1 version of COM-AND script language.  This BBS
  1181.     script was, in fact, created to test the script changes made for
  1182.     version 2.2 of COM-AND.  [The current version of the BBS requires
  1183.     COM-AND 2.7 or later!]
  1184.  
  1185.  
  1186.     I also thank my wife, Elizabeth, who laughs often (and smiles almost
  1187.     always, regardless).
  1188.  
  1189.  
  1190.     This script (Version 1.1) may be distributed freely (but it isn't a
  1191.     whole lot of use without COM-AND).  Any improvements that are
  1192.     returned to the author will get attention...  errors reported to the
  1193.     author will be corrected.  COM-AND is shareware.  If COM-AND is USED
  1194.     after a reasonable period of evaluation, a registration of $50.00 is
  1195.     required.
  1196.  
  1197.  
  1198.     Most of the hardware names and software names in this document are
  1199.     trademarks or trade names of specific manufacturers.
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209. Version 1.1: 910711
  1210.  
  1211. COM-AND Scripted BBS                             Page  20
  1212.  
  1213.  
  1214. XIII.    SupportWare BBS
  1215.  
  1216.  
  1217.     A version of this BBS script (constantly evolving) is maintained for
  1218.     COM-AND support and distribution by SupportWare in Long Beach, CA.
  1219.     SupportWare supports, markets and distributes COM-AND (among other
  1220.     products).  The version of this script used by SupportWare provides
  1221.     instant access, after BBS registration.
  1222.  
  1223.  
  1224.     Mike Todd, the sysop of the BBS and President of SupportWare always
  1225.     has the most current release (or beta) of COM-AND available on that
  1226.     board.    Mike also makes the version of the BBS script he uses (con-
  1227.     siderably extended beyond the functions documented here) available
  1228.     as a SupportWare product.
  1229.  
  1230.  
  1231.     Mike was the founder of the Capitol PC User's Group, and the founder
  1232.     of the IBM SIG(s) on CIS, the SOURCE, and UNISON.  His experience
  1233.     with telecommunications is considerable!  COM-AND's script language
  1234.     itself owes much to Mike Todd's ever pushing the limits of COM-AND.
  1235.  
  1236.  
  1237.     SupportWare may be contacted:
  1238.  
  1239.     Voice:    (213) 439-6104
  1240.     BBS:    (213) 439-7714 (1200/2400 8n1)
  1241.  
  1242.     Mail:    SupportWare
  1243.         P.O.Box 14927
  1244.         Long Beach CA, 90803-1449
  1245.  
  1246.     UNISON: MIKETODD (PARTI: Mike Todd)
  1247.  
  1248.  
  1249.     Mike is always in contact with the author of COM-AND and up-to-date
  1250.     on COM-AND developments.  Many innovations in the use of COM-AND and
  1251.     COM-AND scripts are available first through the SupportWare BBS (and
  1252.     are Mike's suggestions, embodied, t'boot).  Having read this far, the
  1253.     author recommends you call SupportWare!
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264. Version 1.1: 910711
  1265.  
  1266. COM-AND Scripted BBS                             Page  21
  1267.  
  1268.  
  1269. A.    Required and optional files
  1270.  
  1271.     1. Required files in subdirectory \BBS
  1272.  
  1273.        BBS-USER           ID/Password file (created by BBSETUP/BBMAINT)
  1274.  
  1275.     2. Optional files in subdirectory \BBS
  1276.  
  1277.        BBS-NOTE           Comments/registrations - created if D.N.E
  1278.        BBS-LOG           Log of usage - created if D.N.E
  1279.        BBS-Welc           Welcome message
  1280.        BBS-NpMn           Non-privileged user main menu
  1281.        BBS-PrMn           Privileged user main menu
  1282.        BBS-PpMn           Privileged user privileged submenu
  1283.        BBS-NoMe           Message displayed when NOTE requested
  1284.        BBS-ReMe           Message displayed when REGISTER requested
  1285.        BBS-FiMe           All users: files submenu
  1286.        BBS-MeMe           All users: mail submenu
  1287.        BBS-BuMe           All users: bulletins submenu
  1288.  
  1289.     3. Optional files in subdirectory \BBS\Bulletin
  1290.  
  1291.        BBS-BULL           Points to available bulletins
  1292.                    (created by BBSETUP; updated by BBMAINT)
  1293.        BBS-BuMe           (may exist here as well) optional submenu
  1294.  
  1295.     4. Optional files in subdirectory \BBS\Mail
  1296.  
  1297.        BBS-MAIL           Points to existing and deleted messages
  1298.                    (created by BBS if it does not exist)
  1299.        BBS-MeMe           (may exist here as well) optional submenu
  1300.  
  1301.     5. Optional files in subdirectory \BBS\Files
  1302.  
  1303.        BBS-FILE           Points to files uploaded and downloadable
  1304.                    (created by BBSETUP; updated by BBMAINT)
  1305.        BBS-FiMe           (may exist here as well) optional submenu
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319. Version 1.1: 910711                          Appendices
  1320.  
  1321. COM-AND Scripted BBS                             Page  22
  1322.  
  1323.  
  1324. B.    File Structures
  1325.  
  1326.  
  1327.     1. \BBS\BBS-User            (User IDs/passwords)
  1328.  
  1329.        The BBS-User file is structured:
  1330.  
  1331.        0         8           16 17
  1332.        +---/ /---+---/ /---+--+---/ /---+---/ /---+---/ /---+
  1333.        ! ID      ! Passwd  !  ! Comments            !
  1334.        +---/ /---+---/ /---+--+---/ /---+---/ /---+---/ /---+
  1335.                    ^Privilege flag = P
  1336.  
  1337.        "<" in column 1 indicates a comment line; comments ignored
  1338.  
  1339.     2. \BBS\Bulletin\BBS-BULL        (Bulletin items)
  1340.  
  1341.        The BBS-BULL file is structured:
  1342.        0         5           13 14        26
  1343.        +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  1344.        ! Number  ! Date    !  ! Fname   ! Subject (40 char)!
  1345.        +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  1346.                  ^Privileged access if nonblank
  1347.  
  1348.        "*" in column 1 indicates a comment line; comments not printed
  1349.  
  1350.     3. \BBS\Mail\BBS-MAIL            (Mail items)
  1351.  
  1352.        The BBS-MAIL file is structured:
  1353.  
  1354.        0         8           16 17        25          38
  1355.        +---/ /---+---/ /---+--+---/ /---+---/ /---+-------/ /--------+
  1356.        ! To ID   ! From ID !  ! Date    ! Fname   ! Subject (40 char)!
  1357.        +---/ /---+---/ /---+--+---/ /---+---/ /---+-------/ /--------+
  1358.                 ^Privacy flag = P
  1359.  
  1360.        "*" in column 1 indicates a comment line; comments not printed
  1361.  
  1362.     4. \BBS\File\BBS-FILE            (File items)
  1363.  
  1364.        The BBS-FILE file is structured:
  1365.        0         12        20 21        28
  1366.        +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  1367.        ! Fname   ! Date    !  ! Size    ! Description      !
  1368.        +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  1369.                  ^ Privilege req'd if non-blank
  1370.  
  1371.        "*" in column 1 indicates a comment line; comments are printed
  1372.  
  1373.  
  1374. Version 1.1: 910711                          Appendices
  1375.  
  1376. COM-AND Scripted BBS                             Page  23
  1377.  
  1378.  
  1379. C.    Maintenance
  1380.  
  1381.  
  1382.     1. Registrations
  1383.  
  1384.        Registrations are not automatically entered into the BBS-User
  1385.        file.  The registrations exist as comments in the BBS-NOTE file.
  1386.        BBS-NOTE may be printed with the DOS PRINT or COPY commands.  A
  1387.        registering user is asked for a password and an ID.    IDs may not
  1388.        contain "."s, by the way.  The SYSOP must add a record to the
  1389.        BBS-User file to activate the ID (using the BBMAINT script).
  1390.  
  1391.     2. Mail
  1392.  
  1393.        The Mail routines depend on the file BBS-MAIL in the Mail sub-
  1394.        directory for finding messages.  When a letter is deleted the BBS
  1395.        script deletes the file.  BBS does not update the BBS-MAIL file
  1396.        upon letter deletion; rather, BBS detects a deleted file and
  1397.        skips the record.  BBMAINT may be used to cleanup BBS-MAIL.
  1398.  
  1399.     3. Bulletins
  1400.  
  1401.        If the file BBS-BULL does not exist on the Bulletin subdirectory,
  1402.        the caller will be informed there are no bulletins.    BBS-BULL
  1403.        may be created and modified through the BBMAINT script.  Again,
  1404.        records in BBS-BULL that do not point to existing files are
  1405.        skipped by the BBS logic.
  1406.  
  1407.     4. Files (uploads and downloads)
  1408.  
  1409.        The file BBS-FILE in the subdirectory \BBS\FILES will be auto-
  1410.        matically created upon the first upload.  However, comments in
  1411.        this file are displayed and may be used for informational pur-
  1412.        poses.  If you want these comments, they must be added manually.
  1413.  
  1414.        Please note the method described above for files on subdirector-
  1415.        ies other than \BBS\FILES to be listed in the files directory.
  1416.  
  1417.        Add files to the listing with the BBMAINT script.  Uploads are
  1418.        always added at the end of the file by the BBS script.
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429. Version 1.1: 910711                          Appendices
  1430.  
  1431. COM-AND Scripted BBS                             Page  24
  1432.  
  1433.  
  1434. D.    Modem Configuration
  1435.  
  1436.  
  1437.     COM-AND default values do not require your modem to be configured
  1438.     in any particular manner.  However, certain features cannot be used
  1439.     unless you configure your modem before you use COM-AND.
  1440.  
  1441.  
  1442.     1. DTR (Data Terminal Ready)
  1443.  
  1444.        COM-AND, by default, hangs up using the command sequences defined
  1445.        through the Alt-S setup (hangup and modem escape).  However, you
  1446.        may alternately select 'Drop DTR to hangup' through the Alt-O
  1447.        options.  Dropping DTR is the only way to hangup certain modems,
  1448.        and is generally much faster than the command sequences.
  1449.  
  1450.  
  1451.        Most Hayes compatible modems allow configuration of the DTR sense
  1452.        through a switch-block.  If you wish to use DTR to hangup, be sure
  1453.        that your modem follows the DTR signal.  Refer to the documenta-
  1454.        tion provided with your modem to be sure that option switches are
  1455.        set appropriately.
  1456.  
  1457.  
  1458.     2. CD (Carrier Detect)
  1459.  
  1460.        COM-AND (presently) uses the CD sense line for several purposes.
  1461.        The 'CONNECTED' test supported in the script language, test for
  1462.        carrier detect upon exit, and the file transfer protocols all
  1463.        require that the modem report carrier detect.  True carrier detect
  1464.        is the only way to determine if you are 'on-line' or 'off-line'.
  1465.  
  1466.  
  1467.        Many Hayes compatible modems are sold with a carrier detect
  1468.        override (in other words the modem reports carrier detect all the
  1469.        time).  When carrier detect is overridden, COM-AND cannot detect
  1470.        when carrier is lost during a file transfer or whether to ask if
  1471.        you want to hangup when you exit.
  1472.  
  1473.  
  1474.        Be sure that the modem is reporting true CD (instead of it just
  1475.        saying 'yes').  Most Hayes compatible modems allow configuration
  1476.        of the CD sense through a switch-block.  Refer to the documenta-
  1477.        tion provided with your modem to be sure that option switches are
  1478.        set appropriately.
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484. Version 1.1: 910711                          Appendices
  1485.  
  1486. COM-AND Scripted BBS                             Page  25
  1487.  
  1488.  
  1489. D.    Modem Configuration (continued)
  1490.  
  1491.  
  1492.     3. Modem Escape
  1493.  
  1494.        COM-AND issues the "Modem escape" defined through the Alt-S setup,
  1495.        prior to modem initialization and hangup.  Be sure this value is
  1496.        set correctly in Alt-S (or see below).
  1497.  
  1498.  
  1499.     4. Hangup
  1500.  
  1501.        COM-AND hangs up using the command sequences defined through the
  1502.        Alt-S setup (hangup and modem escape) and the drop DTR setting as
  1503.        discussed above.  be sure these values are set correctly (or see
  1504.        below).
  1505.  
  1506.  
  1507.     5. Modem Init
  1508.  
  1509.        COM-AND transmits the modem initialization sequence defined by
  1510.        Alt-S setup to configure the modem.    BBS re-issues this initial-
  1511.        ization when BBS is exited.    If BBS is used, it is suggested that
  1512.        autoanswer be turned OFF in the Alt-S modem init string.
  1513.  
  1514.  
  1515.     6. Other settings
  1516.  
  1517.        The BBS sets its own values BEFORE executing the BBSDAT file (the
  1518.        BBSDAT is an executable script).  Therefore, you may override any
  1519.        COM-AND default settings by editing the BBSDAT file.  Have a care
  1520.        NOT to change variables already defined in BBSDAT!  When BBS is
  1521.        exited, a RESET statement is performed.
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539. Version 1.1: 910711                          Appendices
  1540.  
  1541. COM-AND Scripted BBS                             Page  26
  1542.  
  1543.  
  1544. E.    Sample files
  1545.  
  1546.  
  1547.     1. BBS-USER
  1548.        --------
  1549.  
  1550.     <------------------------------------------------------------------>
  1551.     <    Comment entries begin '<'; Case is not significant in IDs
  1552.     <    and passwords.    ID field begins in column 0.
  1553.     <
  1554.     <- ID ->< Pass >P<---------- Comments ----------------------------->
  1555.     Scott    xxxxxxxxP
  1556.  
  1557.     2. BBS-BULL
  1558.        --------
  1559.  
  1560.     ********************************************************************
  1561.     *    Comment entries begin '*'; Each entry points to a file (nnn).
  1562.     *    Each entry is numbered explicitly (###).
  1563.     ********************************************************************
  1564.     1     4/05/88 BULL.1      ISENGARD BBS's ANSI display
  1565.  
  1566.     3. BBS-MAIL (created automatically)
  1567.        --------
  1568.  
  1569.     ALL    SCOTT      4/06/88ALL.1          This board
  1570.  
  1571.     4. BBS-FILE (created automatically, but nice to post initially)
  1572.        --------
  1573.  
  1574.     ********************************************************************
  1575.     *
  1576.     *    Board related files
  1577.     *
  1578.     BBS.SRC      4/05/88           Source code w/comments for this BBS
  1579.     *
  1580.     *    Uploads...
  1581.     *
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594. Version 1.1: 910711                          Appendices
  1595.