home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMMUNIC / CA24_1.ZIP / BBS&HOST.ZIP / BBS.DOC < prev    next >
Encoding:
Text File  |  1988-07-06  |  20.4 KB  |  1,037 lines
  1. COM-AND Scripted BBS
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.           ------------------------------------------
  22.                 COM-AND Scripted BBS
  23.           Script based Bulletin Board for the IBM PC
  24.           ------------------------------------------
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.     COM-AND is distributed freely and may be copied by anyone for any
  33.     number of machines.  The author offers COM-AND and accessory
  34.     programs (e.g.    PC-VCO or CCHESS) as "shareware".  If the program
  35.     is found to be useful or entertaining, a registration of $35.00
  36.     is requested.  If response warrants, COM-AND will be enhanced
  37.     and more accessory programs developed.    The author may be reached:
  38.  
  39.  
  40.                  CABER Software
  41.                  R. (Scott) McGinnis
  42.                  P.O. Box 3607 Mdse Mart
  43.                  Chicago, IL 60654-0607
  44.  
  45.                  PLINK, GEnie id: TARTAN
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 1.0: 880706
  61.  
  62. COM-AND Scripted BBS
  63.  
  64.  
  65.                  Table of Contents
  66.                  -----------------
  67.  
  68. I.    Introduction  .............................................. page 1
  69.  
  70. II.    Installing the BBS ......................................... page 2
  71.  
  72. III.    Logon ...................................................... page 3
  73.  
  74. IV.    Bulletins .................................................. page 4
  75.  
  76. V.    Mail ....................................................... page 5
  77.  
  78. VI.    Files (Upload and Download) ................................ page 6
  79.  
  80. VII.    Chat mode .................................................. page 7
  81.  
  82. VIII.    Privileged commands ........................................ page 8
  83.  
  84. IX.    Program Requirements ....................................... page 9
  85.  
  86. X.    Program and Author Information    ............................ page 10
  87.  
  88.  
  89.                 Appendices
  90.                 ----------
  91.  
  92.  
  93. A.    Required and optional files ................................ page 11
  94.  
  95. B.    File structures ............................................ page 12
  96.  
  97. C.    Maintenance ................................................ page 13
  98.  
  99. D.    Modem configuration ........................................ page 14
  100.  
  101. E.    Sample files ............................................... page 15
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121. Version 1.0: 880706
  122.  
  123. COM-AND Scripted BBS                             Page   1
  124.  
  125.  
  126. I.    Introduction
  127.  
  128.  
  129.     A. What is COM-AND?
  130.  
  131.  
  132.        COM-AND for the IBM PC and compatibles is a communications
  133.        program that may be used by itself, or with several integrated
  134.        accessory programs (which themselves may be used independently of
  135.        COM-AND).  COM-AND provides standard comm program functions:  a
  136.        dialing directory, macros, disc logging, binary and ASCII file
  137.        transfers, scripted execution and so on.
  138.  
  139.     B. The BBS script
  140.  
  141.        This document details the BBS script provided with version 2.2 of
  142.        COM-AND.  The BBS script supports
  143.  
  144.        o    300/1200/2400 baud autoanswer
  145.  
  146.        o    Reliable use whether the modem reports true CD or no
  147.  
  148.        o    Access by ID and password
  149.         .. SYSOP must post ID and password to grant access
  150.         .. the BBS supports a 'registration' function which could
  151.            automatically post a new ID/password, but does not now
  152.         .. two privilege levels
  153.         .. time limit for non privileged
  154.  
  155.        o    Comments to SYSOP from callers
  156.  
  157.        o    SYSOP posted bulletins
  158.  
  159.        o    Public and private mail
  160.  
  161.        o    File upload and download
  162.         .. WXMODEM, XMODEM,YMODEM and KERMIT
  163.         .. Uploads are not included in time limit computation
  164.  
  165.        o    SYSOP-to-caller chat mode (initiated by SYSOP)
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. Version 1.0: 880706
  183.  
  184. COM-AND Scripted BBS                             Page   2
  185.  
  186.  
  187. II.    Installation
  188.  
  189.  
  190.     A. Create a subdirectory \BBS
  191.  
  192.        The only file required in this subdirectory is BBS-User, which
  193.        specifies IDs and passwords for callers.  Modify the supplied
  194.        BBS-User file with any ASCII text editor (ASCII files are also
  195.        known as non-document format).
  196.  
  197.     B. Create a subdirectory \BBS\FILES
  198.  
  199.        On this subdirectory, the file BBS-FILE contains a list of files
  200.        available for downloading, and newly uploaded.  If BBS-FILE does
  201.        not exit, the script will create it.
  202.  
  203.        Uploads are appended to the end of this file.  I recommend that
  204.        the new SYSOP initially create a BBS-FILE in this subdirectory.
  205.        It contains comments indicating new uploads.
  206.  
  207.        The script will create this file if it does not exist.
  208.  
  209.     C. Create a subdirectory \BBS\MAIL
  210.  
  211.        On this subdirectory, the script expects to find the file
  212.        BBS-MAIL.  This file is used to scan, read and list messages.
  213.        Entries in this file point to single files, each of which
  214.        represents a single message.
  215.  
  216.        The script will create this file if it does not exist.
  217.  
  218.     D. Create a subdirectory \BBS\BULLETIN
  219.  
  220.        On this subdirectory, the script expects to find the file
  221.        BBS-BULL.  This file is used to list and to read bulletins.
  222.        Entries in this file point to single files, each of which
  223.        represents a single bulletin.
  224.  
  225.        The script will create this file if it does not exist.
  226.  
  227.     E. To start, type:
  228.  
  229.        "d"> COM-AND/fBBS-SRC (from anywhere)
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243. Version 1.0: 880706
  244.  
  245. COM-AND Scripted BBS                             Page   3
  246.  
  247.  
  248. III.    Logon
  249.  
  250.  
  251.     Callers to this BBS must be identified through and ID and password
  252.     in the BBS-User file.  The posting if IDs and passwords is a manual
  253.     process at this time.
  254.  
  255.     New callers may 'register'... their name/address/telephone and
  256.     requested ID/password are logged to the BBS-NOTE file for SYSOp
  257.     review.
  258.  
  259.     Two privilege levels are supported at this time.  Non-privileged
  260.     callers are granted 60 minutes of connect time per call.  Privileged
  261.     users are granted unlimited connect.  Note that non-privileged
  262.     callers may call back.    The BBS does not record time used accross a
  263.     day.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304. Version 1.0: 880706
  305.  
  306. COM-AND Scripted BBS                             Page   4
  307.  
  308.  
  309. IV.    Bulletins
  310.  
  311.  
  312.     The B)ulletin submenu supports the following user commands:
  313.  
  314.     o    L)ist        List available bulletins
  315.     o    #        Read a specific bulletin
  316.  
  317.  
  318.     The list of available bulletins is taken from the file BBS-BULL.
  319.     Comments in the file are not printed for the caller to see.
  320.     Bulletin numbers may be arbitrarily assigned, and certain bulletins
  321.     may be restricted to privileged callers only.
  322.  
  323.  
  324.     The caller selects a bulletin number to view from the list supplied.
  325.     The bulletin is transferred using an ASCII send function:  control-
  326.     S and control-Q may be used to suspend the transfer.
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. Version 1.0: 880706
  366.  
  367. COM-AND Scripted BBS                             Page   5
  368.  
  369.  
  370. V.    Mail
  371.  
  372.  
  373.     The M)ail submenu supports the following user commands:
  374.  
  375.     o    S)can        Scan postings for mail 'to' the caller
  376.     o    L)ist        List mail (to,from,date,subject)
  377.     o    R)ead        Read mail (to caller, and public posts)
  378.     o    W)rite        Write a message (public or private)
  379.  
  380.     This script does not support editing of postings at this time.
  381.  
  382.  
  383.     The list of pending mail is taken from the file BBS-MAIL.  Comments
  384.     in the file are not printed for the caller to see.  Mail is only
  385.     readable sequentially (at this time).  Mail is marked 'private' to
  386.     receiver when it is created.
  387.  
  388.  
  389.     The mail file is not automatically purged of entries older than a
  390.     given date.  Such a script would be easily written - at this time
  391.     however, its a manual task.
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426. Version 1.0: 880706
  427.  
  428. COM-AND Scripted BBS                             Page   6
  429.  
  430.  
  431. VI.    Files (download and Upload)
  432.  
  433.     The F)iles submenu supports the following user commands:
  434.  
  435.     o    L)ist        List available files
  436.     o    S)earch     Search the file list for a substring
  437.     o    U)pload     Upload a file (to the board)
  438.     o    D)ownload    Download a file (from the board)
  439.  
  440.     Files may be uploaded and downloaded from this script using:
  441.  
  442.     o    WXMODEM (Windowed XMODEM)
  443.     o    XMODEM (CRC or checksum)
  444.     o    YMODEM (CRC or checksum)
  445.     o    KERMIT (Windowed or plain)
  446.  
  447.     Non-privileged callers are not allowed to upload files that
  448.     duplicate files on the \BBS\Files subdirectory.
  449.  
  450.     Non-privileged callers are limited to downloading files on the
  451.     \BBS\Files subdirectory (not necessarily all listed in the file
  452.     BBS-FILE).
  453.  
  454.     Privileged callers may upload/download to/from any accessible disc
  455.     device and subdirectory.
  456.  
  457.     Uploads are noted in the \BBS-FILE file with a caller supplied
  458.     description.
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487. Version 1.0: 880706
  488.  
  489. COM-AND Scripted BBS                             Page   7
  490.  
  491.  
  492. VII.    Chat with SYSOP
  493.  
  494.  
  495.     The A)larm command at the main prompt sounds a tune on the local
  496.     console's speaker.  If the SYSOP wishes to respond the SYSOP may
  497.     interrupt the caller (whether the ALARM has been used or no) with
  498.     the ESCape key.
  499.  
  500.  
  501.     Pressing the ESCape key during the script's operation will interrupt
  502.     the script - however, the caller is not disconnected immediately.
  503.     The SYSOP may choose to terminate the script (in which case a HANGUP
  504.     is performed).    The SYSOP may alternately choose to CHAT with the
  505.     caller.
  506.  
  507.  
  508.     When the SYSOP chooses CHAT, the caller is informed of operator
  509.     intervention.  The SYSOP is prompted for a line of text (blank lines
  510.     entered by the SYSOP result in a query: "Continue" and are the means
  511.     for termination of the CHAT).  When the SYSOP presses CR, any text
  512.     is sent to the caller and the caller is prompted for text.  The chat
  513.     continues back and forth, one line at a time, until the caller
  514.     disconnects or the SYSOP terminates the chat.
  515.  
  516.  
  517.     At this time, time spent in CHAT is not added back to the caller's
  518.     total time alotment.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548. Version 1.0: 880706
  549.  
  550. COM-AND Scripted BBS                             Page   8
  551.  
  552.  
  553. VIII.    Privileged access
  554.  
  555.  
  556.     Users flagged in the BBS-User file with privileged access are
  557.     allowed an additional main prompt command ("P").  The "Privilege"
  558.     command gives access to a submenu with the commands:
  559.  
  560.     o    L)ist       performs a DIR on the current subdirectory
  561.  
  562.     o    S)ubdir    changes the current drive:subdirectory
  563.  
  564.     o    P)ath       provides a graphics display of the tree structure
  565.                of the current default disc (required the P/d
  566.                utility TREED.COM)
  567.  
  568.     o    D)os       performs a DOS command
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609. Version 1.0: 880706
  610.  
  611. COM-AND Scripted BBS                             Page   9
  612.  
  613.  
  614. IX.    Program requirements
  615.  
  616.  
  617.     This program can only function on an IBM PC or DOS compatible
  618.     machine.  COM-AND does direct to screen buffer fetches and stores
  619.     (unless BIOS screen updates are directed using the /C switch or the
  620.     Alt-O options menu).
  621.  
  622.  
  623.     COM-AND supports MDA, CGA, EGA and Hercules.  COM-AND uses a Micro-
  624.     soft Mouse if one is available (not well, but it'll certainly get
  625.     better).
  626.  
  627.  
  628.     COM-AND disk I/O is done through the 'Handle' oriented I/O routines
  629.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  630.  
  631.  
  632.     COM-AND (Version 2.2) requires 215K for itself.  You need 256K
  633.     (minimally), and more to take advantage of the DOS Gateway and
  634.     even more yet to load accessories.
  635.  
  636.  
  637.     This script requires a 300, 1200 or 2400 baud modem.  [Others could
  638.     be supported with modification to the script.]    This script is most
  639.     reliable if the modem is set to report true CD.
  640.  
  641.  
  642.     And of course, for a Bulletin Board, you need a lot of disc
  643.     freespace!
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670. Version 1.0: 880706
  671.  
  672. COM-AND Scripted BBS                             Page  10
  673.  
  674.  
  675. X.    Author information
  676.  
  677.  
  678.     COM-AND was written using Microsoft Macro-Assembler.  The
  679.     author likes assembler.  Assembly language is an entirely
  680.     appropriate vehicle for some of the program, and a not-inappro-
  681.     priate vehicle for the rest of it.  Everything, in moderation...
  682.  
  683.  
  684.     The author of this program is R. Scott McGinnis of Chicago,
  685.     Illinois.  PLINK and GEnie ID:    TARTAN.  Comment and suggestions
  686.     (and criticism in moderation) are welcomed:
  687.  
  688.              CABER Software
  689.              R. (Scott) McGinnis
  690.              P.O. Box 3607 Mdse Mart
  691.              Chicago, IL 60654-0607
  692.  
  693.  
  694.     I want to thank Mike Todd (SYSOP of the IBM PC SIG on the SOURCE)
  695.     and John Poindexter for their valuable comments and gripes on the
  696.     2.1 version of COM-AND script language.  This BBS script was in
  697.     fact created to test the script changes made for version 2.2.
  698.  
  699.  
  700.     I also thank my wife, Elizabeth, who laughs when I laugh (and smiles
  701.     almost always, regardless).
  702.  
  703.  
  704.     This script (Version 1.0) may be distributed freely (but it isn't a
  705.     whole lot of use without COM-AND).  Any improvements that are
  706.     returned to the author will get attention...  errors reported to the
  707.     author will be corrected.  COM-AND is shareware.  If COM-AND is
  708.     found entertaining or useful, a contribution of $35.00 is requested.
  709.     Should response warrant it, I will continue to develop and support
  710.     this product.
  711.  
  712.  
  713.     Most of the hardware names and software names in this document are
  714.     trademarks or trade names of specific manufacturers.
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731. Version 1.0: 880706
  732.  
  733. COM-AND Scripted BBS                             Page  11
  734.  
  735.  
  736. A.    Required and optional files
  737.  
  738.     (1) Files in subdirectory \BBS
  739.  
  740.         BBS-USER            ID/Password file (required)
  741.         BBS-NOTE            Comments/registrations - created if D.N.E
  742.         BBS-LOG            Log of usage - created if D.N.E
  743.  
  744.     (2) Optional Files in subdirectory \BBS
  745.  
  746.         BBS-Welc            Welcome message
  747.         BBS-NpMe            Non-privileged user main menu
  748.         BBS-PrMe            Privileged user main menu
  749.         BBS-PpMe            Privileged user privileged submenu
  750.         BBS-NoMe            Message displayed when NOTE requested
  751.         BBS-ReMe            Message displayed when REGISTER requested
  752.         BBS-FiMe            All users: files submenu
  753.         BBS-MeMe            All users: mail submenu
  754.         BBS-BuMe            All users: bulletins submenu
  755.  
  756.     (3) Optional files in subdirectory \BBS\Mail
  757.  
  758.         BBS-MAIL            Points to existing and deleted messages
  759.  
  760.     (4) Optional files in subdirectory \BBS\Files
  761.  
  762.         BBS-FILE            Points to files uploaded and downloadable
  763.  
  764.     (5) Optional files in subdirectory \BBS\Bulletin
  765.  
  766.         BBS-BULL            Points to available bulletins
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792. Version 1.0: 880706                           Appendices
  793.  
  794. COM-AND Scripted BBS                             Page  12
  795.  
  796.  
  797. B.    File Structures
  798.  
  799.  
  800.     (1) \BBS\BBS-User             (User IDs/passwords)
  801.  
  802.         The BBS-User file is structured:
  803.  
  804.         0          8     16 17
  805.         +---/ /---+---/ /---+--+---/ /---+---/ /---+---/ /---+
  806.         ! ID      ! Passwd    !  ! Comments             !
  807.         +---/ /---+---/ /---+--+---/ /---+---/ /---+---/ /---+
  808.                 ^Privilege flag = P
  809.  
  810.         "<" in column 1 indicates a comment line; comments ignored
  811.  
  812.     (2) \BBS\Mail\BBS-MAIL             (Mail items)
  813.  
  814.         The BBS-MAIL file is structured:
  815.  
  816.         0          8     16 17         25        38
  817.         +---/ /---+---/ /---+--+---/ /---+---/ /---+-------/ /--------+
  818.        ! To ID   ! From ID !  ! Date    ! Fname   ! Subject (40 char)!
  819.         +---/ /---+---/ /---+--+---/ /---+---/ /---+-------/ /--------+
  820.                  ^Privacy flag = P
  821.  
  822.         "*" in column 1 indicates a comment line; comments are not
  823.         printed
  824.  
  825.     (3) \BBS\Bulletin\BBS-BULL         (Bulletin items)
  826.  
  827.         The BBS-BULL file is structured:
  828.         0          5     13 14         26
  829.         +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  830.         ! Number  ! Date    !  ! Fname   ! Subject (40 char)!
  831.         +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  832.                   ^Privileged access if nonblank
  833.  
  834.         "*" in column 1 indicates a comment line; comments are not
  835.         printed
  836.  
  837.     (4) \BBS\File\BBS-FILE             (File items)
  838.  
  839.         The BBS-FILE file is structured:
  840.         0          13    20 21         28
  841.         +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  842.         ! Fname   ! Date    !  ! Size    ! Description    !
  843.         +---/ /---+---/ /---+--+---/ /---+-------/ /--------+
  844.                   ^ Privilege req'd if non-blank
  845.  
  846.         "*" in column 1 indicates a comment line; comments are printed
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853. Version 1.0: 880706                           Appendices
  854.  
  855. COM-AND Scripted BBS                             Page  13
  856.  
  857.  
  858. C.    Maintenance
  859.  
  860.  
  861.     (1) Registrations
  862.  
  863.         Registrations are not automatically entered into the BBS-User
  864.         file.  The registrations exist as comments in the BBS-NOTE file.
  865.         A registering user is asked for a password and an ID.  IDs
  866.         may not contain "."s, by the way.  The SYSOP must add a record
  867.         to the BBS-User file to activate the ID.
  868.  
  869.     (2) Mail
  870.  
  871.         The Mail routines depend on the file BBS-MAIL in the \BBS\Mail
  872.         subdirectory for finding messages.    The BBS does not update the
  873.         BBS-MAIL file upon deletion - the logic detects a deleted file
  874.         and skips the record.
  875.  
  876.         However, with many deleted mail messages, list, scan, and read
  877.         will slow down percetibly.    Records in BBS-MAIL pointing to
  878.         messages (files) which do not exist should be eliminated
  879.         regularly.
  880.  
  881.     (3) Bulletins
  882.  
  883.         If the file BBS-BULL does not exist on the subdirectory
  884.         \BBS\BULLETIN, the caller will be informed there are no bulletins.
  885.         BBS-BULL must be created to support the Bulletin function.    Again,
  886.         records in BBS-BULL that do not point to existing text files are
  887.         skipped by the logic.
  888.  
  889.     (4) Files (uploads and downloads)
  890.  
  891.         The file BBS-FILE in the subdirectory \BBS\FILES will be auto-
  892.         matically created upon the first upload.  However, comments in
  893.         this file are displayed and may be used for informational pur-
  894.         poses.  If you want these comments, they must be added manually.
  895.  
  896.         Uploads are always added at the end of the file.  They may be
  897.         moved.
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914. Version 1.0: 880706                           Appendices
  915.  
  916. COM-AND Scripted BBS                             Page  14
  917.  
  918.  
  919. D.    Modem Configuration
  920.  
  921.  
  922.     COM-AND default values do not require your modem to be configured
  923.     in any particular manner.  However, certain features cannot be used
  924.     unless you configure your modem before you use COM-AND.
  925.  
  926.  
  927.     1. DTR (Data Terminal Ready)
  928.  
  929.        COM-AND, by default, hangs up using the command sequences defined
  930.        through the Alt-S setup (hangup and modem escape).  However, you
  931.        may alternately select 'Drop DTR to hangup' through the Alt-O
  932.        options.  Dropping DTR is the only way to hangup certain modems,
  933.        and is generally much faster than the command sequences.
  934.  
  935.  
  936.        Most Hayes compatible modems allow configuration of the DTR sense
  937.        through a switch-block.  If you wish to use DTR to hangup, be sure
  938.        that your modem follows the DTR signal.  Refer to the documenta-
  939.        tion provided with your modem to be sure that option switches are
  940.        set appropriately.
  941.  
  942.  
  943.     2. CD (Carrier Detect)
  944.  
  945.        COM-AND (presently) uses the CD sense line for several purposes.
  946.        The 'CONNECTED' test supported in the script language, test for
  947.        carrier detect upon exit, and the file transfer protocols all
  948.        require that the modem report carrier detect.  True carrier detect
  949.        is the only way to determine if you are 'on-line' or 'off-line'.
  950.  
  951.  
  952.        Many Hayes compatible modems are sold with a carrier detect
  953.        override (in other words the modem reports carrier detect all the
  954.        time).  When carrier detect is overridden, COM-AND cannot detect
  955.        when carrier is lost during a file transfer or whether to ask if
  956.        you want to hangup when you exit.
  957.  
  958.  
  959.        Be sure that the modem is reporting true CD (instead of it just
  960.        saying 'yes').  Most Hayes compatible modems allow configuration
  961.        of the CD sense through a switch-block.  Refer to the documenta-
  962.        tion provided with your modem to be sure that option switches are
  963.        set appropriately.
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975. Version 1.0: 880706                           Appendices
  976.  
  977. COM-AND Scripted BBS                             Page  15
  978.  
  979.  
  980. D.    Sample files
  981.  
  982.  
  983.     1. BBS-USER
  984.        --------
  985.  
  986.     <------------------------------------------------------------------>
  987.     <    Comment entries begin '<'; Case is not signifigant in IDs
  988.     <    and passwords.    ID field begins in column 1.
  989.     <
  990.     <- ID ->< Pass >P<---------- Comments ----------------------------->
  991.     Scott    xxxxxxxxP
  992.  
  993.     2. BBS-BULL
  994.        --------
  995.  
  996.     ********************************************************************
  997.     *    Comment entries begin '*'; Each entry points to a file (nnn).
  998.     *    Each entry is numbered explicitly (###).
  999.     *                                       *
  1000.     *####ddddddddfnnnnnnnnnnnnddddddddddddddddddddddddddddddddddddddddd*
  1001.     ********************************************************************
  1002.     1     4/05/88 BULL.1      ISENGARD BBS's ANSI display
  1003.  
  1004.     3. BBS-MAIL (created automatically)
  1005.        --------
  1006.  
  1007.     ALL    SCOTT      4/06/88ALL.1          This board
  1008.  
  1009.     4. BBS-FILE (created automatically, but nice to post initially)
  1010.        --------
  1011.  
  1012.     *
  1013.     *    Board related files
  1014.     *
  1015.     BBS-SRC.CMD   4/05/88        Source code for this BBS
  1016.     *
  1017.     *    Uploads
  1018.     *
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036. Version 1.0: 880706                           Appendices
  1037.