home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / bbsx2.zip / BBSX.DOC next >
Text File  |  1989-01-10  |  147KB  |  4,819 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                              Rich Levin's BBSXpress (tm)
  28.  
  29.                         Installation and Configuration Guide
  30.                         ─══════════════════════════════════─
  31.  
  32.                          Copyright (c) 1988 Richard B. Levin
  33.                                  All Rights Reserved
  34.  
  35.                               Revised January 10, 1989
  36.  
  37.                        ╒════════════════════════════════════╕
  38.                        │ ██████████████████████████████████ │
  39.                        │ ██     ███     ███      ██  ██  ██ │
  40.                        │ ██  █  ███  █  ███  ██████      ██ │
  41.                        ┤ ██      ██      ██      ████  ████ ├
  42.                        │ ██   █  ██   █  ██████  ██      ██ │
  43.                        │ ██      ██      ██      ██  ██  ██ │
  44.                        │ ██████████████████████████████████ │
  45.                        ╘════════════════════════════════════╛
  46.                                 The Personal BBS (tm)
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                   ═════════════════
  74.                                   Table of Contents
  75.                                   ═════════════════
  76.  
  77.           DEDICATION.................................................1
  78.  
  79.           ACKNOWLEDGEMENTS...........................................1
  80.  
  81.           PROGRAM INFO...............................................1
  82.  
  83.           MINIMUM HARDWARE AND SOFTWARE REQUIREMENTS.................2
  84.  
  85.           BBSX'S ARCHIVE CONTENTS....................................2
  86.  
  87.               Source code (ASCII)....................................2
  88.               Batch files (ASCII)....................................2
  89.               Sample bulletins (ASCII)...............................2
  90.               Utilities (Binary).....................................3
  91.               Documents (ASCII)......................................3
  92.               Executable files (Binary)..............................3
  93.               Initialization files (ASCII)...........................3
  94.               Sample file descriptions (ASCII).......................3
  95.               Sample polls (ASCII)...................................3
  96.  
  97.           COPYRIGHT NOTICE...........................................3
  98.  
  99.           OWNER REGISTRATION.........................................4
  100.  
  101.               CORPORATE AND GOVERNMENT USERS.........................4
  102.               PRIVATE USERS..........................................4
  103.               DISTRIBUTION POLICY....................................4
  104.               UPGRADE POLICY.........................................5
  105.  
  106.           REGISTRATION FORM..........................................6
  107.  
  108.               REGISTRATION FEE AND PLEDGE FOR NON-PRIVATE USERS......9
  109.               WAIVER OF REGISTRATION FEE ... FOR PRIVATE USERS......10
  110.  
  111.           BBSX - THE PERSONAL BBS (tm)..............................11
  112.  
  113.           INSTALLING BBSX...........................................11
  114.  
  115.           CONFIGURING BBSX..........................................11
  116.  
  117.               STEP 1 - Editing the BBSX.INI file....................12
  118.  
  119.                   BAUD_RATE=........................................13
  120.                   CARRIER_DETECT_TIMER=.............................13
  121.                   COM_PORT=.........................................14
  122.                   DOWNLOAD_UPLOAD_RATIO=............................14
  123.                   MESSAGE_LINES=....................................14
  124.                   MESSAGE_SCROLL_RATE=..............................14
  125.                   MODEM_INI=........................................14
  126.                   MODEM_TIMER=......................................14
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                   NEW_USER_SECURITY=................................14
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                   NEW_USER_TIME=....................................15
  206.                   SECURITY_TO_DOWNLOAD=.............................15
  207.                   SECURITY_TO_READ=.................................15
  208.                   SECURITY_TO_UPLOAD=...............................15
  209.                   SECURITY_TO_WRITE=................................15
  210.                   SYSOP=............................................15
  211.                   SYSOP_DOS_PASSWORD=...............................15
  212.                   UPLOAD_PATH=......................................16
  213.  
  214.                   General information about BBSX.INI................16
  215.  
  216.               STEP 2 - Editing the GROUP.INI file...................16
  217.  
  218.                   GROUP_SECURITY=...................................17
  219.                   GROUP_PASSWORD=...................................18
  220.                   GROUP_NAME=.......................................18
  221.                   GROUP_FILENAME=...................................18
  222.                   END_OF_GROUPS=Y...................................19
  223.  
  224.                   General information about GROUP.INI...............19
  225.                   Examples of GROUP.INI files.......................19
  226.  
  227.               STEP 3 - Editing the FILES.INI file...................24
  228.  
  229.                   FILES_SECURITY=...................................25
  230.                   FILES_PASSWORD=...................................26
  231.                   FILES_AREA=.......................................26
  232.                   FILES_PATH=.......................................26
  233.                   END_OF_FILES=Y....................................26
  234.  
  235.                   General information about FILES.INI...............27
  236.                   Examples of FILES.INI files.......................27
  237.  
  238.               STEP 4 - Storing the PROTOCOL.INI file................32
  239.  
  240.                   General information about PROTOCOL.INI............33
  241.  
  242.               STEP 5 - Editing the BBS.BAT file.....................33
  243.  
  244.                   BBSX's optional start-up switches.................34
  245.                   General information about BBS.BAT.................36
  246.  
  247.               STEP 6 - Editing the DAILY.BAT file...................36
  248.  
  249.                   General information about DAILY.BAT...............37
  250.  
  251.               STEP 7 - Editing the DOS.BAT file.....................38
  252.  
  253.                   General information about DOS.BAT.................39
  254.  
  255.               STEP 8 - Storing the FTX.BAT file.....................40
  256.  
  257.                   General information about FTX.BAT.................41
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.               STEP 9 - Editing the MENU.BLT file....................41
  272.  
  273.                   Controlling .BLT file output......................42
  274.                   ~FORCEREAD or ~F - the "Force-Read" command.......43
  275.                   ~NONSTOP or ~N - the "Non-stop" command...........43
  276.                   General information about MENU.BLT................44
  277.  
  278.               STEP 10 - Editing the System .BLT files...............44
  279.  
  280.                   General information about system .BLT files.......45
  281.  
  282.               STEP 11 - Editing the MENU.POL file...................46
  283.  
  284.                   Controlling .POL file output......................47
  285.                   ~FORCEREAD or ~F - the "Force-Read" command.......47
  286.                   ~NONSTOP or ~N - the "Non-stop" command...........48
  287.                   General information about MENU.POL................48
  288.  
  289.               STEP 12 - Installing yourself as a SysOp..............49
  290.  
  291.               STEP 13 - Going on-line...............................50
  292.  
  293.           LEARNING TO USE BBSX......................................51
  294.  
  295.           REQUIRED MODEM DIP-SWITCH SETTINGS........................51
  296.  
  297.           HOW TO....................................................52
  298.  
  299.               USE ANOTHER DISK OR SUBDIRECTORY NAME.................52
  300.               CREATE OR CONVERT FILE DESCRIPTION FILES..............52
  301.  
  302.           BBSX'S F KEY ASSIGNMENTS..................................53
  303.  
  304.           TROUBLESHOOTING...........................................54
  305.  
  306.               MODEM HANGS UP ON CALLERS.............................54
  307.               MODEM WON'T HANG UP...................................54
  308.               SYSTEM HANGS DURING DROPS TO DOS......................54
  309.               FILE TRANSFERS BOMB...................................55
  310.  
  311.           ERROR CODES AND EXPLANATIONS..............................55
  312.  
  313.               FATAL ERRORS..........................................59
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.           APPENDIX A - FILE TRANSFER TECHNICAL REFERENCE............59
  338.  
  339.               Editing the FTX.BAT file..............................59
  340.               Editing the PROTOCOL.INI file.........................63
  341.  
  342.                   PROTOCOL_NAME=....................................63
  343.                   PROTOCOL_CODE=....................................64
  344.                   END_OF_PROTOCOLS=Y................................64
  345.  
  346.           APPENDIX B - TCD.COM COMMAND REFERENCE....................64
  347.  
  348.               COMMAND LINE ARGUMENT SYNTAX..........................65
  349.               EXAMPLES OF COMMAND LINE ARGUMENTS....................65
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                                                         1
  401.  
  402.  
  403.  
  404.           ══════════
  405.           DEDICATION
  406.           ══════════
  407.  
  408.               BBSX is dedicated to my wife, Carol; to the Mother Board BBS'
  409.           regular callers (you know who you are) and to BBSX SysOps
  410.           everywhere.
  411.  
  412.           ════════════════
  413.           ACKNOWLEDGEMENTS
  414.           ════════════════
  415.  
  416.               Special thanks to Scott Russell for coding TCD.COM (The
  417.           Carrier Detective) and programming guidance; to Keith Russell,
  418.           for many on-line ßeta test sessions and crazy ideas; and to John
  419.           Ellard, for giving me the kick-start on Word.
  420.  
  421.           ════════════
  422.           PROGRAM INFO
  423.           ════════════
  424.  
  425.              Program:  Rich Levin's BBSXpress (tm)
  426.             Function:  Multi-SIG/LIB e-mail and file transfer system
  427.                Class:  PC/MS DOS-compatible bulletin board system
  428.                Price:  $50.00 per node/per computer
  429.               Editor:  Norton Editor v.1.3C
  430.                Trace:  AddLine v.1.5
  431.             Compiler:  Microsoft BASIC v.6.0
  432.             Math LIB:  BC6 Alternate (/FPA)
  433.               Linker:  Microsoft Segmented-Executable Linker v.5.01.20
  434.               Author:  Richard B. Levin
  435.              Address:  P.O. Box 14546, Phila., PA 19115
  436.            Telephone:  (215) 333-8274
  437.                  BBS:  The Mother Board @ (215) 333-8275 (300/1200/2400)
  438.  
  439.           Documentation - Author:  Richard B. Levin
  440.                     Proof reader:  Carol Levin
  441.  
  442.           Principal distribution points:  The Mother Board BBS
  443.                                           CompuServe IBMNET
  444.                                           GEnie IBM and BBS RTs
  445.  
  446.           BBSX is published by Richard B. Levin
  447.                                9405 Bustleton Ave.
  448.                                P.O. Box 14546
  449.                                Phila., PA  19115
  450.           
  451.                                Lab:  (215) 333-8274
  452.                                BBS:  (215) 333-8275
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                                                         2
  467.  
  468.  
  469.               The latest version of BBSX is available for downloading on
  470.           the Mother Board BBS.  Support is also available through Rich
  471.           Levin's lab.  Please leave a message on our answering machine if
  472.           we are unable to answer your call personally.  We return long
  473.           distance calls collect.
  474.  
  475.           ══════════════════════════════════════════
  476.           MINIMUM HARDWARE AND SOFTWARE REQUIREMENTS
  477.           ══════════════════════════════════════════
  478.  
  479.               IBM PC, XT, AT, PS/2 or true compatible
  480.               384k RAM
  481.               Monochrome display adaptor
  482.               Monochrome monitor
  483.               Hard disk drive
  484.               RS232C serial port configured as COM1 or COM2
  485.               Hayes 300, 1200, 2400 or 9600 baud modem or true compatible
  486.               PC/MS DOS v.3.0 or higher
  487.  
  488.           ═══════════════════════
  489.           BBSX'S ARCHIVE CONTENTS
  490.           ═══════════════════════
  491.  
  492.               The BBSX archive contains the following files:
  493.  
  494.                   Source code (ASCII)
  495.                   ───────────────────
  496.  
  497.                   BBSXSRC  BAS   BASIC source to BBSX file formats
  498.  
  499.                   Batch files (ASCII)
  500.                   ───────────────────
  501.  
  502.                   BBS      BAT   Loads and recycles BBSX
  503.                   DAILY    BAT   Performs routine tasks once daily
  504.                   DOS      BAT   Provides link between BBSX and DOS
  505.                   FTX      BAT   Manages file transfers (down/uploads)
  506.                   INSTALL  BAT   Installs BBSX on a hard disk
  507.  
  508.                   Sample bulletins (ASCII)
  509.                   ────────────────────────
  510.  
  511.                   1        BLT   Bulletin # 1
  512.                   2        BLT   Bulletin # 2
  513.                   3        BLT   Bulletin # 3
  514.                   DOWNLOAD BLT   Displayed before downloads
  515.                   GOODBYE  BLT   Displayed after log off
  516.                   HELLO    BLT   Displayed after log on
  517.                   MAIN     BLT   Displayed after entering MAIN group
  518.                   MENU     BLT   Bulletin menu
  519.                   NEWS     BLT   Displayed after HELLO.BLT
  520.                   NEWUSER  BLT   Displayed to new users after NEWS.BLT
  521.                   UPLOAD   BLT   Displayed before uploads
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                                                         3
  533.  
  534.  
  535.                   Utilities (Binary)
  536.                   ──────────────────
  537.  
  538.                   TCD      COM   Monitors carrier during drop-to-DOS
  539.  
  540.                   Documents (ASCII)
  541.                   ─────────────────
  542.  
  543.                   BBSX     DOC   This file
  544.                   CHANGES  DOC   List of major system changes
  545.                   README   DOC   May or may not be present
  546.                   REGISTER DOC   Owner registration form
  547.  
  548.                   Executable files (Binary)
  549.                   ─────────────────────────
  550.  
  551.                   BBSX     EXE   BBSX program
  552.                   BRUN60AR EXE   BBSX run-time module
  553.  
  554.                   Initialization files (ASCII)
  555.                   ────────────────────────────
  556.  
  557.                   BBSX     INI   General initialization file
  558.                   FILES    INI   File areas initialization file
  559.                   GROUP    INI   Message groups initialization file
  560.                   PROTOCOL INI   Transfer protocols initialization file
  561.  
  562.                   Sample file descriptions (ASCII)
  563.                   ────────────────────────────────
  564.  
  565.                   FILES    LST   Example of file description file format
  566.  
  567.                   Sample polls (ASCII)
  568.                   ────────────────────
  569.  
  570.                   1        POL   Questionnaire # 1
  571.                   2        POL   Questionnaire # 2
  572.                   3        POL   Questionnaire # 3
  573.                   4        POL   Questionnaire # 4
  574.                   5        POL   Questionnaire # 5
  575.                   MENU     POL   Questionnaire menu
  576.  
  577.           ════════════════
  578.           COPYRIGHT NOTICE
  579.           ════════════════
  580.  
  581.               The names "BBSXpress," "BBSX" and the BBSX program,
  582.           documentation, BBSX-created input and output files, visual
  583.           displays, interface, look and feel (hereinafter referred to as
  584.           "the BBSX system") are copyright (c) and trademark (tm) 1988
  585.           Richard B. Levin (hereinafter referred to as "the author"), all
  586.           rights reserved.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                                                         4
  599.  
  600.  
  601.               The author reserves the right to make changes to the BBSX
  602.           system at any time without prior notice.  The BBSX system is
  603.           provided to the user "as is" without warranty of any kind, either
  604.           express or implied.  No part of the BBSX system may be reproduced
  605.           without the written permission of the author.
  606.  
  607.               The BBSX system is protected by United States Copyright Law
  608.           (Title 17 United States Code).  Unauthorized modification,
  609.           reproduction, duplication, transfer or sales may result in
  610.           imprisonment of up to one year and fines of up to $10,000.00 (17
  611.           USC 506).  Copyright infringers may also be subject to civil
  612.           liability.  The Federal Bureau of Investigation investigates
  613.           allegations of criminal copyright infringement.
  614.  
  615.           ══════════════════
  616.           OWNER REGISTRATION
  617.           ══════════════════
  618.  
  619.               ──────────────────────────────
  620.               CORPORATE AND GOVERNMENT USERS
  621.               ──────────────────────────────
  622.  
  623.               For-profit, non-profit and not-for-profit corporations,
  624.           governmental offices and agencies and private individuals using
  625.           BBSX within these classifications are required to register their
  626.           ownership of the BBSX system with the author.  Every registration
  627.           must be accompanied by a registration fee of $50.00 for each
  628.           computer running the BBSX system.
  629.  
  630.               Registered owners must submit an additional registration form
  631.           and fee whenever the BBSX system is installed on an unregistered
  632.           computer.
  633.  
  634.               Site licenses and disk copies are available on request.
  635.  
  636.               ─────────────
  637.               PRIVATE USERS
  638.               ─────────────
  639.  
  640.               Private users of BBSX are required to register their
  641.           ownership of the BBSX system with the author but are not required
  642.           to remit the $50.00 registration fee.  Donations are accepted.
  643.  
  644.               ───────────────────
  645.               DISTRIBUTION POLICY
  646.               ───────────────────
  647.  
  648.               Users are permitted to distribute the BBSX system free of
  649.           charge to other users when the following conditions are met:
  650.  
  651.               *   The BBSX system must be distributed in its entirety
  652.                   as originally produced by the author.
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                                                                         5
  665.  
  666.  
  667.               *   No part of the BBSX system may be altered, added to,
  668.                   removed, re-archived or modified in any way
  669.                   whatsoever.
  670.  
  671.               FAILURE TO COMPLY WITH THE ABOVE TERMS AND CONDITIONS IS A
  672.           VIOLATION OF UNITED STATES COPYRIGHT LAW.
  673.  
  674.               ──────────────
  675.               UPGRADE POLICY
  676.               ──────────────
  677.  
  678.               The latest edition of BBSX is stored on the Mother Board BBS
  679.           (listed above) in the "Software by Rich Levin" area and can be
  680.           downloaded at any time.
  681.  
  682.               Upgrades are regularly posted to the IBMNET Forum on the
  683.           CompuServe Information Service (GO IBMNET) and the IBM and BBS
  684.           RoundTables (RTs) on the General Electric Network for Information
  685.           Exchange (GEnie).
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                                                         6
  731.  
  732.  
  733.           - - - - - - - - - - - - Tear Here - - - - - - - - - - - - -
  734.  
  735.  
  736.           ═════════════════
  737.           REGISTRATION FORM
  738.           ═════════════════
  739.  
  740.            ALL USERS ARE REQUIRED BY LAW TO COMPLETE AND RETURN THIS FORM
  741.               WITH PAYMENT WITHIN TEN DAYS OF ACQUIRING THE BBSX SYSTEM
  742.  
  743.           Print, complete and mail to Richard B. Levin
  744.                                       BBSX Registration
  745.                                       P.O. Box 14546
  746.                                       Phila., PA  19115
  747.  
  748.                Please make checks payable to "Richard B. Levin."
  749.  
  750.                Important: Please hand print your responses to the
  751.                           registration questionnaire; do not type or
  752.                           computer-print them.  If necessary, use
  753.                           additional sheets of paper to complete this
  754.                           form.
  755.  
  756.  
  757.           Date of registration:
  758.  
  759.           ____________________________________________________________
  760.  
  761.  
  762.           Registered owner's name:
  763.  
  764.           ____________________________________________________________
  765.  
  766.           ____________________________________________________________
  767.  
  768.  
  769.           Title:
  770.  
  771.           ____________________________________________________________
  772.  
  773.           ____________________________________________________________
  774.  
  775.  
  776.           Department:
  777.  
  778.           ____________________________________________________________
  779.  
  780.           ____________________________________________________________
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                                                         7
  797.  
  798.  
  799.           Company:
  800.  
  801.           ____________________________________________________________
  802.  
  803.           ____________________________________________________________
  804.  
  805.  
  806.           Street address:
  807.  
  808.           ____________________________________________________________
  809.  
  810.           ____________________________________________________________
  811.  
  812.  
  813.           P.O. Box:
  814.  
  815.           ____________________________________________________________
  816.  
  817.           ____________________________________________________________
  818.  
  819.  
  820.           Mail stop:
  821.  
  822.           ____________________________________________________________
  823.  
  824.           ____________________________________________________________
  825.  
  826.  
  827.           City:
  828.  
  829.           ____________________________________________________________
  830.  
  831.           ___________________________________________________________
  832.  
  833.  
  834.           State:
  835.  
  836.           ____________________________________________________________
  837.  
  838.           ____________________________________________________________
  839.  
  840.  
  841.           Zip:
  842.  
  843.           ____________________________________________________________
  844.  
  845.           ____________________________________________________________
  846.  
  847.  
  848.           Telephone:  (           )           -
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                                                                         8
  863.  
  864.  
  865.           What feature(s) do you like most about BBSX?
  866.  
  867.           ____________________________________________________________
  868.  
  869.           ____________________________________________________________
  870.  
  871.  
  872.           What feature(s) do you like least about BBSX?
  873.  
  874.           ____________________________________________________________
  875.  
  876.           ____________________________________________________________
  877.  
  878.  
  879.           What feature(s) would you most like to see in BBSX that are not
  880.           there now?
  881.  
  882.           ____________________________________________________________
  883.  
  884.           ____________________________________________________________
  885.  
  886.  
  887.           Have you operated a BBS before?
  888.  
  889.               [   ] Yes   [   ] No
  890.  
  891.  
  892.           Please list the name(s) of the BBSes you have operated if you
  893.           answered YES to the previous question:
  894.  
  895.           ____________________________________________________________
  896.  
  897.           ____________________________________________________________
  898.  
  899.  
  900.           How did you hear about BBSX?
  901.  
  902.           ____________________________________________________________
  903.  
  904.           ____________________________________________________________
  905.  
  906.  
  907.           How did you acquire your copy(s) of BBSX?
  908.  
  909.           ____________________________________________________________
  910.  
  911.           ____________________________________________________________
  912.  
  913.  
  914.           Do you own or use any other software by Rich Levin?
  915.  
  916.               [   ] Yes   [   ] No
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                                                                         9
  929.  
  930.  
  931.           Please list the name(s) of the program(s) you own or use if you
  932.           answered YES to the previous question:
  933.  
  934.           ____________________________________________________________
  935.  
  936.           ____________________________________________________________
  937.  
  938.  
  939.               ─────────────────────────────────────────────────
  940.               REGISTRATION FEE AND PLEDGE FOR NON-PRIVATE USERS
  941.               ─────────────────────────────────────────────────
  942.  
  943.               Please enclose check or money order (made payable to "Richard
  944.           B. Levin") in the amount of $50.00 for each copy of BBSX
  945.           installed on an unregistered computer.
  946.  
  947.                   Total number of
  948.                   unregistered computers
  949.                   running BBSX............[#              ]
  950.  
  951.                                            X $50.00 each =
  952.                                           ────────────────
  953.                   Amount enclosed.........[$             ]
  954.                                           ════════════════
  955.  
  956.               I agree to use BBSX in accordance with the terms and
  957.           conditions specified in this document.  I pledge to do my best to
  958.           insure that registration forms (and fees, if applicable) are
  959.           submitted to the author whenever the BBSX system is installed on
  960.           unregistered computers.
  961.  
  962.  
  963.           Date:  _____________________________________________________
  964.  
  965.           
  966.  
  967.           Signature:  ________________________________________________
  968.  
  969.           
  970.  
  971.           Attest:  ___________________________________________________
  972.  
  973.           
  974.  
  975.               Thank you for registering!
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.                                                                         10
  995.  
  996.  
  997.               ───────────────────────────────────────────────────────
  998.               WAIVER OF REGISTRATION FEE AND PLEDGE FOR PRIVATE USERS
  999.               ───────────────────────────────────────────────────────
  1000.  
  1001.               I certify that I am a private user using BBSX in my home on
  1002.           my personal computer(s) and that said computer(s) are not used on
  1003.           behalf of any for-profit, non-profit and not-for-profit
  1004.           corporations or governmental offices or agencies.
  1005.  
  1006.               I agree to use BBSX in accordance with the terms and
  1007.           conditions specified in this document.  I pledge to do my best to
  1008.           insure that registration forms (and fees, if applicable) are
  1009.           submitted to the author whenever the BBSX system is installed on
  1010.           unregistered computers.
  1011.  
  1012.  
  1013.           Date:  _____________________________________________________
  1014.  
  1015.           
  1016.  
  1017.           Signature:  ________________________________________________
  1018.  
  1019.           
  1020.  
  1021.           Attest:  ___________________________________________________
  1022.  
  1023.  
  1024.                Site licenses and disk copies available on request.
  1025.                Prices subject to change without notice.  Please allow
  1026.                4 to 6 weeks for registrations to be processed.
  1027.  
  1028.  
  1029.           - - - - - - - - - - - - Tear Here - - - - - - - - - - - - -
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                                                                         11
  1061.  
  1062.  
  1063.           ════════════════════════════
  1064.           BBSX - THE PERSONAL BBS (tm)
  1065.           ════════════════════════════
  1066.  
  1067.               BBSX is a bulletin board system that remains true to the
  1068.           spirit of personal computing.  BBSX provides users with an
  1069.           inexpensive, full-featured, user-supported alternative to
  1070.           commercial BBSes.  It's easy to buy, install, use and maintain,
  1071.           plus 24 hour technical support is free for the asking.
  1072.  
  1073.               In this first build, BBSX provides most, if not all, of the
  1074.           popular features users demand.  In addition, BBSX users are not
  1075.           subject to configuration limitations, nor are they burdened with
  1076.           BBS maintenance.  On the contrary, BBSX imposes no limit to the
  1077.           number of conferences, file areas, protocols, bulletins,
  1078.           questionnaires or message sizes, and system maintenance is fully
  1079.           automated.
  1080.  
  1081.           ═══════════════
  1082.           INSTALLING BBSX
  1083.           ═══════════════
  1084.  
  1085.               Before BBSX can be run, it must be installed and configured.
  1086.           To install BBSX, do the following:
  1087.  
  1088.               1.  Copy the BBSX files to the root directory of the
  1089.                   hard disk (usually C:\).
  1090.  
  1091.               2.  Run the INSTALL.BAT file by entering the following
  1092.                   command:
  1093.  
  1094.                        INSTALL
  1095.  
  1096.           ════════════════
  1097.           CONFIGURING BBSX
  1098.           ════════════════
  1099.  
  1100.               BBSX can be tailored to suit your specific needs; thousands
  1101.           of configurations are possible.  After initial installation,
  1102.           however, BBSX is pre-configured to provide the following:
  1103.  
  1104.               *   Monochrome (black and white) screen colors.
  1105.  
  1106.               *   Support for 2400 baud operation on COM1.
  1107.  
  1108.               *   Sample DOWNLOAD, HELLO, GOODBYE, NEWS, NEWUSER and
  1109.                   UPLOAD bulletins.
  1110.  
  1111.               *   A sample bulletin menu and three sample bulletins.
  1112.  
  1113.               *   A sample "polls" menu and six sample polls.
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.                                                                         12
  1127.  
  1128.  
  1129.               *   Five public message groups:  MAIN, Computer
  1130.                   Hardware, Computer Software, Programmer's Corner and
  1131.                   Word Processing.
  1132.  
  1133.               *   One sample message group bulletin for the MAIN
  1134.                   section.
  1135.  
  1136.               *   Messages limited to 100 lines.
  1137.  
  1138.               *   Automatic "scrolling" of message group data bases
  1139.                   every 300 messages (per group).
  1140.  
  1141.               *   Four public files areas:  New uploads, Disk
  1142.                   Utilities, Printer Utilities and Telecommunication
  1143.                   Programs.
  1144.  
  1145.               *   Five file transfer protocols:  Xmodem 128, Xmodem
  1146.                   1k, Ymodem 128, Ymodem 1k and Zmodem.
  1147.  
  1148.               *   Uploads immediately posted for public consumption.
  1149.  
  1150.               *   New users granted an access level of 60, providing
  1151.                   one hour of daily access on their first call.
  1152.  
  1153.               *   New users granted a security level of 2, allowing
  1154.                   reading and writing of messages in all message
  1155.                   groups.
  1156.  
  1157.               *   Enforced download/upload ratio of 5 to 1 (where 1
  1158.                   upload is required after every 5 downloads).
  1159.  
  1160.               *   Drop-to-DOS support for SysOp-level users.
  1161.  
  1162.               You can operate BBSX as is or you can reconfigure the
  1163.           installation to suit your needs.
  1164.  
  1165.               ──────────────────────────────────
  1166.               STEP 1 - Editing the BBSX.INI file
  1167.               ──────────────────────────────────
  1168.  
  1169.               BBSX.INI is the general initialization file.  It must be
  1170.           edited using an ASCII editor operating in non-document mode.
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                                                                         13
  1193.  
  1194.  
  1195.               Load BBSX.INI into any ASCII editor.  The following text will
  1196.           be displayed:
  1197.  
  1198.                   ~ Rich Levin's BBSXpress (tm)
  1199.                   ~ BBSX.INI
  1200.                   ~ Copyright (c) 1988 Richard B. Levin
  1201.                   ~ All Rights Reserved
  1202.                   ~
  1203.                   ~ Revised January 10, 1989
  1204.                   ~
  1205.                   ~ Precede comments with a tilde.
  1206.                   ~ Delete comments to optimize this file.
  1207.                   ~
  1208.                   BAUD_RATE=2400
  1209.                   CARRIER_DETECT_TIMER=30
  1210.                   COM_PORT=1
  1211.                   DOWNLOAD_UPLOAD_RATIO=5
  1212.                   MESSAGE_LINES=100
  1213.                   MESSAGE_SCROLL_RATE=300
  1214.                   MODEM_INI=ATE0F1M0Q0V1X1S0=1
  1215.                   MODEM_TIMER=2
  1216.                   NEW_USER_SECURITY=2
  1217.                   NEW_USER_TIME=60
  1218.                   SECURITY_TO_DOWNLOAD=2
  1219.                   SECURITY_TO_READ=2
  1220.                   SECURITY_TO_UPLOAD=2
  1221.                   SECURITY_TO_WRITE=2
  1222.                   SYSOP=your name goes here
  1223.                   SYSOP_DOS_PASSWORD=put a unique password here
  1224.                   UPLOAD_PATH=\BBSX\FILES
  1225.  
  1226.               Edit each field to reflect your configuration requirements:
  1227.  
  1228.               1.  ~ Rich Levin's BBSXpress (tm)
  1229.  
  1230.                   A comment.  Text preceded by a tilde character is
  1231.                   ignored by BBSX.
  1232.  
  1233.               2.  BAUD_RATE=
  1234.  
  1235.                   The maximum baud rate supported by the modem.  Four
  1236.                   characters maximum.  Use 300, 1200, 2400 or 9600 to
  1237.                   signify 300, 1200, 2400 and 9600 bauds,
  1238.                   respectively.
  1239.  
  1240.               3.  CARRIER_DETECT_TIMER=
  1241.  
  1242.                   The maximum amount of time to wait for DCD (Data
  1243.                   Carrier Detect) on incoming calls before hanging up.
  1244.                   Two characters maximum.  Use a whole number from 10
  1245.                   to 60 seconds.
  1246.  
  1247.                   This timer should match the modem's S7 register
  1248.                   setting.
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.                                                                         14
  1259.  
  1260.  
  1261.               4.  COM_PORT=
  1262.  
  1263.                   The port number of the RS232C communications channel
  1264.                   to use.  One character maximum.  Use 1 for COM1, 2
  1265.                   for COM2.
  1266.  
  1267.               5.  DOWNLOAD_UPLOAD_RATIO=
  1268.  
  1269.                   The maximum number of downloads allowed before BBSX
  1270.                   requests one upload.  Three characters maximum.  Use
  1271.                   a whole number from 0 to 999.
  1272.  
  1273.               6.  MESSAGE_LINES=
  1274.  
  1275.                   The maximum number of lines allowed per message.
  1276.                   Three characters maximum.  Use a whole number from
  1277.                   25 to 999 lines.
  1278.  
  1279.               7.  MESSAGE_SCROLL_RATE=
  1280.  
  1281.                   The maximum number of messages, per message group,
  1282.                   stored on disk before the oldest 25% are
  1283.                   automatically deleted.  Four characters maximum.
  1284.                   Use a whole number from 25 to 9999 messages.
  1285.  
  1286.               8.  MODEM_INI=
  1287.  
  1288.                   A string of Hayes-standard AT-commands used for
  1289.                   modem initialization.  40 characters maximum.  The
  1290.                   first two characters must be "AT."  Do not use ATZ,
  1291.                   ATH or escape codes.
  1292.  
  1293.                   The MODEM_INI string featured is designed for use
  1294.                   with Hayes-compatible modems.
  1295.  
  1296.               9.  MODEM_TIMER=
  1297.  
  1298.                   The amount of time the modem needs to process
  1299.                   AT-commands.  One character maximum.  Use a whole
  1300.                   number from 1 to 9 seconds.
  1301.  
  1302.                   Some modems take longer than others to digest
  1303.                   AT-commands.  Increase this setting if the system
  1304.                   behaves abnormally.
  1305.  
  1306.               10. NEW_USER_SECURITY=
  1307.  
  1308.                   The security level granted to new users on their
  1309.                   first call.  Three characters maximum.  Use a whole
  1310.                   number from 0 to 994.
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.                                                                         15
  1325.  
  1326.  
  1327.               11. NEW_USER_TIME=
  1328.  
  1329.                   The amount of daily on-line time granted to new
  1330.                   users on their first call.  Four characters maximum.
  1331.                   Use a whole number from 0 and 1440 minutes.
  1332.  
  1333.                   Setting this field to 0 locks out new users.
  1334.  
  1335.               12. SECURITY_TO_DOWNLOAD=
  1336.  
  1337.                   The security level required to DOWNLOAD files.
  1338.                   Three characters maximum.  Use a whole number from 0
  1339.                   to 999.
  1340.  
  1341.               13. SECURITY_TO_READ=
  1342.  
  1343.                   The security level required to READ messages in any
  1344.                   group.  Three characters maximum.  Use a whole
  1345.                   number from 0 to 999.
  1346.  
  1347.               14. SECURITY_TO_UPLOAD=
  1348.  
  1349.                   The security level required to UPLOAD files.  Three
  1350.                   characters maximum.  Use a whole number from 0 to
  1351.                   999.
  1352.  
  1353.               15. SECURITY_TO_WRITE=
  1354.  
  1355.                   The security level required to WRITE messages in any
  1356.                   group.  Three characters maximum.  Use a whole
  1357.                   number from 0 to 999.
  1358.  
  1359.               16. SYSOP=
  1360.  
  1361.                   The name of the board's SysOp.  50 characters
  1362.                   maximum.  Control and high-bit ASCII characters are
  1363.                   accepted.
  1364.  
  1365.                   This entry must match the SysOp's USER.LOG record
  1366.                   exactly; it is used by BBSX to find the SysOp's
  1367.                   record when messages are posted "To:  SysOp."
  1368.  
  1369.               17. SYSOP_DOS_PASSWORD=
  1370.  
  1371.                   The password required to grant SysOp-level users
  1372.                   remote access to DOS.  25 characters maximum.
  1373.                   Control and high-bit ASCII characters are accepted.
  1374.  
  1375.                   This password should not be the same as the SysOp's
  1376.                   log-in password; it should be known only to those
  1377.                   persons who are granted a security level of 999 and
  1378.                   are allowed total access to the hard disk.
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.                                                                         16
  1391.  
  1392.  
  1393.               18. UPLOAD_PATH=
  1394.  
  1395.                   The path where uploaded files are stored.  Use any
  1396.                   legal DOS directory pathname.  53 characters
  1397.                   maximum.
  1398.  
  1399.                   If a "\" character is not the last character of the
  1400.                   UPLOAD_PATH, BBSX will insert it.  Drive letters are
  1401.                   optional.
  1402.  
  1403.                   If you want users to be able to download from the
  1404.                   new uploads directory, you must set a FILES_PATH
  1405.                   (see Step 3, item 4, in the "Editing the FILES.INI
  1406.                   file" section, below) equal to the UPLOAD_PATH.
  1407.  
  1408.                   If the UPLOAD_PATH field is BLANK, BBSX will store
  1409.                   uploads in the last FILES_PATH selected by the user.
  1410.  
  1411.                   General information about BBSX.INI
  1412.                   ──────────────────────────────────
  1413.  
  1414.               The following rules apply to BBSX.INI:
  1415.  
  1416.                   1.  BBSX.INI must be stored in the BBSX
  1417.                       subdirectory.
  1418.  
  1419.                   2.  If BBSX.INI cannot be found in the BBSX
  1420.                       subdirectory, BBSX will initialize using
  1421.                       hard-coded defaults.  If these defaults are not
  1422.                       correct for your installation, BBSX will fail to
  1423.                       operate properly.
  1424.  
  1425.                   3.  The data fields can appear in any order.  They
  1426.                       have been sorted alphabetically for esthetic
  1427.                       purposes.
  1428.  
  1429.               ───────────────────────────────────
  1430.               STEP 2 - Editing the GROUP.INI file
  1431.               ───────────────────────────────────
  1432.  
  1433.               GROUP.INI is the message group configuration file.  This file
  1434.           is optional, used only by systems supporting a variety of message
  1435.           groups.
  1436.  
  1437.               BBSX always features one message group called "MAIN."  The
  1438.           MAIN group is hard-coded into the program.  All other groups are
  1439.           listed in GROUP.INI.
  1440.  
  1441.               If you plan to support only the MAIN message group or if you
  1442.           are in a hurry to get BBSX up and running, remove the GROUP.INI
  1443.           file from the BBSX subdirectory and jump directly to
  1444.           configuration Step 3, "Editing the FILES.INI file," below.
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.                                                                         17
  1457.  
  1458.  
  1459.               GROUP.INI must be edited using an ASCII editor operating in
  1460.           non-document mode.
  1461.  
  1462.               Load GROUP.INI into any ASCII editor.  The following text
  1463.           will be displayed:
  1464.  
  1465.                   ~ Rich Levin's BBSXpress (tm)
  1466.                   ~ GROUP.INI
  1467.                   ~ Copyright (c) 1988 Richard B. Levin
  1468.                   ~ All Rights Reserved
  1469.                   ~
  1470.                   ~ Revised January 10, 1989
  1471.                   ~
  1472.                   ~ Precede comments with a tilde.
  1473.                   ~ Delete comments to optimize this file.
  1474.                   ~
  1475.                   GROUP_SECURITY=2
  1476.                   GROUP_PASSWORD=
  1477.                   ~
  1478.                   GROUP_NAME=Computer Hardware Forum
  1479.                   GROUP_FILENAME=HARDWARE
  1480.                   ~
  1481.                   GROUP_NAME=Computer Software Forum
  1482.                   GROUP_FILENAME=SOFTWARE
  1483.                   ~
  1484.                   GROUP_NAME=Programmer's Corner
  1485.                   GROUP_FILENAME=PROGRAM
  1486.                   ~
  1487.                   GROUP_NAME=Word Processing Conference
  1488.                   GROUP_FILENAME=WORDPRO
  1489.                   ~
  1490.                   END_OF_GROUPS=Y
  1491.  
  1492.               Edit each field to reflect your configuration requirements:
  1493.  
  1494.               1.  ~ Rich Levin's BBSXpress (tm)
  1495.  
  1496.                   A comment.  Text preceded by a tilde character is
  1497.                   ignored by BBSX.
  1498.  
  1499.               2.  GROUP_SECURITY=
  1500.  
  1501.                   The security level required to read or write
  1502.                   messages in the groups defined below it.  Three
  1503.                   characters maximum.  Use a whole number from 0 to
  1504.                   999.
  1505.  
  1506.                   GROUP_SECURITY settings must appear before all other
  1507.                   fields.
  1508.  
  1509.                   Multiple GROUP_SECURITY settings can be used.  Each
  1510.                   new setting affects the groups defined below it.
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.                                                                         18
  1523.  
  1524.  
  1525.                   If multiple settings are used, a default setting
  1526.                   must be the first field in GROUP.INI.  This prevents
  1527.                   the last setting encountered from looping back to
  1528.                   the top.
  1529.  
  1530.                   If a GROUP_SECURITY setting does not appear, the
  1531.                   NEW_USER_SECURITY (see Step 1, item 10, in the
  1532.                   "Editing the BBSX.INI file" section, above) will be
  1533.                   used in its place.
  1534.  
  1535.               3.  GROUP_PASSWORD=
  1536.  
  1537.                   The password required to read or write messages in
  1538.                   the groups defined below it.  25 characters maximum.
  1539.                   Control and high-bit ASCII characters are accepted.
  1540.  
  1541.                   GROUP_PASSWORDs must appear after a GROUP_SECURITY
  1542.                   setting.
  1543.  
  1544.                   Multiple GROUP_PASSWORDs can be used.  Each new
  1545.                   password affects the groups defined below it.
  1546.  
  1547.                   Use a blank password to unprotect groups.  Each new
  1548.                   blank password unprotects the groups defined below
  1549.                   it.
  1550.  
  1551.                   If multiple passwords are used, a default (or a
  1552.                   blank) password be the second field in GROUP.INI.
  1553.                   This prevents the last password encountered from
  1554.                   looping back to the top.
  1555.  
  1556.                   If a GROUP_PASSWORD does not appear, all groups will
  1557.                   be unprotected by passwords.
  1558.  
  1559.               4.  GROUP_NAME=
  1560.  
  1561.                   The name of a message group.  50 characters maximum.
  1562.                   Control, ANSI and high-bit ASCII characters are
  1563.                   accepted.
  1564.  
  1565.                   Every GROUP_NAME must be followed by a
  1566.                   GROUP_FILENAME.
  1567.  
  1568.               5.  GROUP_FILENAME=
  1569.  
  1570.                   The disk filename of a message group.  8 characters
  1571.                   maximum.  All legal DOS filenames are accepted.
  1572.  
  1573.                   Every GROUP_FILENAME must be preceded by a
  1574.                   GROUP_NAME.
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.                                                                         19
  1589.  
  1590.  
  1591.               6.  END_OF_GROUPS=Y
  1592.  
  1593.                   An end-of-data (EOD) flag.  Must be the last entry
  1594.                   in GROUP.INI.  BBSX stops searching for GROUP.INI
  1595.                   fields when this entry is encountered.
  1596.  
  1597.                   This EOD flag allows users to optionally merge
  1598.                   GROUP.INI into BBSX.INI, providing a central
  1599.                   initialization file.  If GROUP.INI fields are merged
  1600.                   into BBSX.INI, the GROUP.INI file is not used;
  1601.                   however, BBSX performs better when GROUP.INI and
  1602.                   BBSX.INI are not merged.
  1603.  
  1604.                   General information about GROUP.INI
  1605.                   ───────────────────────────────────
  1606.  
  1607.               The following rules apply to GROUP.INI:
  1608.  
  1609.                   1.  GROUP.INI must be stored in the BBSX
  1610.                       subdirectory.
  1611.  
  1612.                   2.  BBSX always features one message group called
  1613.                       "MAIN."  The MAIN group is hard-coded into the
  1614.                       program.  All other groups are listed in
  1615.                       GROUP.INI.
  1616.  
  1617.                   3.  If GROUP.INI fields cannot be found in the BBSX
  1618.                       subdirectory, BBSX will support only the MAIN
  1619.                       group.
  1620.  
  1621.                   4.  There is no limit to the number of message
  1622.                       groups, group security levels and group
  1623.                       passwords that BBSX can support.
  1624.  
  1625.                   5.  SysOps and Co-SysOps are not queried for a
  1626.                       password when entering protected groups.
  1627.  
  1628.                   Examples of GROUP.INI files
  1629.                   ───────────────────────────
  1630.  
  1631.               The following examples demonstrate how the GROUP.INI fields
  1632.           provide SysOps with the flexibility to create a variety of
  1633.           message groups:
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.                                                                         20
  1655.  
  1656.  
  1657.                   1.  This example allows users between security
  1658.                       levels 2 and 999 access to the Computer Hardware
  1659.                       and Software Forums and the Programmer's Corner.
  1660.                       Security levels 500 through 999 can access the
  1661.                       Word Processing Conference.  Levels below 2 have
  1662.                       access to the MAIN group* only.  No passwords
  1663.                       are used.
  1664.  
  1665.                       GROUP_SECURITY=2
  1666.                       GROUP_PASSWORD=
  1667.                       ~
  1668.                       GROUP_NAME=Computer Hardware Forum
  1669.                       GROUP_FILENAME=HARDWARE
  1670.                       ~
  1671.                       GROUP_NAME=Computer Software Forum
  1672.                       GROUP_FILENAME=SOFTWARE
  1673.                       ~
  1674.                       GROUP_NAME=Programmer's Corner
  1675.                       GROUP_FILENAME=PROGRAM
  1676.                       ~
  1677.                       GROUP_SECURITY=500
  1678.                       GROUP_NAME=Word Processing Conference
  1679.                       GROUP_FILENAME=WORDPRO
  1680.                       ~
  1681.                       END_OF_GROUPS=Y
  1682.  
  1683.                   2.  This example allows users between security
  1684.                       levels 2 and 999 access to the Computer Hardware
  1685.                       and Software Forums.  Security levels 500
  1686.                       through 999 can access the Programmer's Corner
  1687.                       and Word Processing Conference.  Levels below 2
  1688.                       have access to the MAIN group* only.  No
  1689.                       passwords are used.
  1690.  
  1691.                       GROUP_SECURITY=2
  1692.                       GROUP_PASSWORD=
  1693.                       ~
  1694.                       GROUP_NAME=Computer Hardware Forum
  1695.                       GROUP_FILENAME=HARDWARE
  1696.                       ~
  1697.                       GROUP_NAME=Computer Software Forum
  1698.                       GROUP_FILENAME=SOFTWARE
  1699.                       ~
  1700.                       GROUP_SECURITY=500
  1701.                       ~
  1702.                       GROUP_NAME=Programmer's Corner
  1703.                       GROUP_FILENAME=PROGRAM
  1704.                       ~
  1705.                       GROUP_NAME=Word Processing Conference
  1706.                       GROUP_FILENAME=WORDPRO
  1707.                       ~
  1708.                       END_OF_GROUPS=Y
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.                                                                         21
  1721.  
  1722.  
  1723.                   3.  This example allows users between security
  1724.                       levels 2 through 999 access to the Computer
  1725.                       Hardware Forum; levels 3 through 999 have access
  1726.                       to the Computer Software Forum; levels 4 through
  1727.                       999 can access the Programmer's Corner; levels 5
  1728.                       through 999 may enter the Word Processing
  1729.                       Conference.  Levels below 2 have access to the
  1730.                       MAIN group* only.  No passwords are used.
  1731.  
  1732.                       GROUP_SECURITY=2
  1733.                       GROUP_PASSWORD=
  1734.                       GROUP_NAME=Computer Hardware Forum
  1735.                       GROUP_FILENAME=HARDWARE
  1736.                       ~
  1737.                       GROUP_SECURITY=3
  1738.                       GROUP_NAME=Computer Software Forum
  1739.                       GROUP_FILENAME=SOFTWARE
  1740.                       ~
  1741.                       GROUP_SECURITY=4
  1742.                       GROUP_NAME=Programmer's Corner
  1743.                       GROUP_FILENAME=PROGRAM
  1744.                       ~
  1745.                       GROUP_SECURITY=5
  1746.                       GROUP_NAME=Word Processing Conference
  1747.                       GROUP_FILENAME=WORDPRO
  1748.                       ~
  1749.                       END_OF_GROUPS=Y
  1750.  
  1751.                   4.  This example allows users between security
  1752.                       levels 2 through 999 access to the Computer
  1753.                       Hardware and Software Forums and the
  1754.                       Programmer's Corner without requiring a
  1755.                       password.  Access to the Word Processing
  1756.                       Conference is limited to users who know the
  1757.                       password "orbit.shelf."  Levels below 2 have
  1758.                       access to the MAIN group* only.
  1759.  
  1760.                       GROUP_SECURITY=2
  1761.                       GROUP_PASSWORD=
  1762.                       ~
  1763.                       GROUP_NAME=Computer Hardware Forum
  1764.                       GROUP_FILENAME=HARDWARE
  1765.                       ~
  1766.                       GROUP_NAME=Computer Software Forum
  1767.                       GROUP_FILENAME=SOFTWARE
  1768.                       ~
  1769.                       GROUP_NAME=Programmer's Corner
  1770.                       GROUP_FILENAME=PROGRAM
  1771.                       ~
  1772.                       GROUP_PASSWORD=orbit.shelf
  1773.                       GROUP_NAME=Word Processing Conference
  1774.                       GROUP_FILENAME=WORDPRO
  1775.                       ~
  1776.                       END_OF_GROUPS=Y
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.                                                                         22
  1787.  
  1788.  
  1789.                   5.  This example allows users between security
  1790.                       levels 2 and 999 access to the Computer Hardware
  1791.                       and Software Forums.  Access to the Programmer's
  1792.                       Corner and the Word Processing Conference is
  1793.                       limited to users who know the password
  1794.                       "edit!compile!crash."  Levels below 2 have
  1795.                       access to the MAIN group* only.
  1796.  
  1797.                       GROUP_SECURITY=2
  1798.                       GROUP_PASSWORD=
  1799.                       ~
  1800.                       GROUP_NAME=Computer Hardware Forum
  1801.                       GROUP_FILENAME=HARDWARE
  1802.                       ~
  1803.                       GROUP_NAME=Computer Software Forum
  1804.                       GROUP_FILENAME=SOFTWARE
  1805.                       ~
  1806.                       GROUP_PASSWORD=edit!compile!crash
  1807.                       ~
  1808.                       GROUP_NAME=Programmer's Corner
  1809.                       GROUP_FILENAME=PROGRAM
  1810.                       ~
  1811.                       GROUP_NAME=Word Processing Conference
  1812.                       GROUP_FILENAME=WORDPRO
  1813.                       ~
  1814.                       END_OF_GROUPS=Y
  1815.  
  1816.                   6.  This example allows users between security
  1817.                       levels 2 and 999 access to all groups, provided
  1818.                       they know the passwords.  Levels below 2 have
  1819.                       access to the MAIN group* only.
  1820.  
  1821.                       GROUP_SECURITY=2
  1822.                       ~
  1823.                       GROUP_PASSWORD=mips 'n chips
  1824.                       GROUP_NAME=Computer Hardware Forum
  1825.                       GROUP_FILENAME=HARDWARE
  1826.                       ~
  1827.                       GROUP_PASSWORD=folder@rules
  1828.                       GROUP_NAME=Computer Software Forum
  1829.                       GROUP_FILENAME=SOFTWARE
  1830.                       ~
  1831.                       GROUP_PASSWORD=diner#wheel
  1832.                       GROUP_NAME=Programmer's Corner
  1833.                       GROUP_FILENAME=PROGRAM
  1834.                       ~
  1835.                       GROUP_PASSWORD=road$mirror
  1836.                       GROUP_NAME=Word Processing Conference
  1837.                       GROUP_FILENAME=WORDPRO
  1838.                       ~
  1839.                       END_OF_GROUPS=Y
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.                                                                         23
  1853.  
  1854.  
  1855.                   7.  This example allows users between security
  1856.                       levels 2 and 999 access to the Computer Hardware
  1857.                       and Software Forums, provided they know the
  1858.                       passwords; levels 500 through 999 have password
  1859.                       protected access to the Programmer's Corner and
  1860.                       Word Processing Conference.  Levels below 2 have
  1861.                       access to the MAIN group* only.
  1862.  
  1863.                       GROUP_SECURITY=2
  1864.                       ~
  1865.                       GROUP_PASSWORD=tinkerbell%squander
  1866.                       GROUP_NAME=Computer Hardware Forum
  1867.                       GROUP_FILENAME=HARDWARE
  1868.                       ~
  1869.                       GROUP_PASSWORD=verb^coil
  1870.                       GROUP_NAME=Computer Software Forum
  1871.                       GROUP_FILENAME=SOFTWARE
  1872.                       ~
  1873.                       GROUP_SECURITY=500
  1874.                       ~
  1875.                       GROUP_PASSWORD=holes&bottle
  1876.                       GROUP_NAME=Programmer's Corner
  1877.                       GROUP_FILENAME=PROGRAM
  1878.                       ~
  1879.                       GROUP_PASSWORD=esc*fp*down4
  1880.                       GROUP_NAME=Word Processing Conference
  1881.                       GROUP_FILENAME=WORDPRO
  1882.                       ~
  1883.                       END_OF_GROUPS=Y
  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.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.                                                                         24
  1919.  
  1920.  
  1921.                   8.  This example allows users between security
  1922.                       levels 2 through 999 access to the Computer
  1923.                       Hardware Forum; levels 3 through 999 have access
  1924.                       the Computer Software Forum; levels 4 through
  1925.                       999 can access the Programmer's Corner; levels 5
  1926.                       through 999 may enter the Word Processing
  1927.                       Conference.  All groups are individually
  1928.                       password protected.  Levels below 2 have access
  1929.                       to the MAIN group* only.
  1930.  
  1931.                       GROUP_SECURITY=2
  1932.                       GROUP_PASSWORD=bagle(shade
  1933.                       GROUP_NAME=Computer Hardware Forum
  1934.                       GROUP_FILENAME=HARDWARE
  1935.                       ~
  1936.                       GROUP_SECURITY=3
  1937.                       GROUP_PASSWORD=virus)checkup
  1938.                       GROUP_NAME=Computer Software Forum
  1939.                       GROUP_FILENAME=SOFTWARE
  1940.                       ~
  1941.                       GROUP_SECURITY=4
  1942.                       GROUP_PASSWORD=seat_display
  1943.                       GROUP_NAME=Programmer's Corner
  1944.                       GROUP_FILENAME=PROGRAM
  1945.                       ~
  1946.                       GROUP_SECURITY=5
  1947.                       GROUP_PASSWORD=pulley-south
  1948.                       GROUP_NAME=Word Processing Conference
  1949.                       GROUP_FILENAME=WORDPRO
  1950.                       ~
  1951.                       END_OF_GROUPS=Y
  1952.  
  1953.               These examples demonstrate how GROUP_SECURITY and
  1954.           GROUP_PASSWORD fields can be mixed and matched to create an
  1955.           infinite variety of configurations.
  1956.  
  1957.           *Note:  Users will be unable to read or write messages in any
  1958.                   group, including MAIN, if their security level is less
  1959.                   than the SECURITY_TO_READ or SECURITY_TO_WRITE.  (See
  1960.                   Step 1, items 13 and 15, in the "Editing the BBSX.INI
  1961.                   file" section, above.)
  1962.  
  1963.               ───────────────────────────────────
  1964.               STEP 3 - Editing the FILES.INI file
  1965.               ───────────────────────────────────
  1966.  
  1967.               FILES.INI is the file areas configuration file.  This file is
  1968.           optional, used only by systems supporting a variety of file
  1969.           areas.
  1970.  
  1971.               If you do not plan to support any file areas or if you are in
  1972.           a hurry to get BBSX up and running, remove the FILES.INI file
  1973.           from the BBSX subdirectory and jump directly to configuration
  1974.           Step 4, "Storing the PROTOCOL.INI file," below.
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.                                                                         25
  1985.  
  1986.  
  1987.               FILES.INI must be edited using an ASCII editor operating in
  1988.           non-document mode.
  1989.  
  1990.               Load FILES.INI into any ASCII editor.  The following text
  1991.           will be displayed:
  1992.  
  1993.                   ~ Rich Levin's BBSXpress (tm)
  1994.                   ~ FILES.INI
  1995.                   ~ Copyright (c) 1988 Richard B. Levin
  1996.                   ~ All Rights Reserved
  1997.                   ~
  1998.                   ~ Revised January 10, 1989
  1999.                   ~
  2000.                   ~ Precede comments with a tilde.
  2001.                   ~ Delete comments to optimize this file.
  2002.                   ~
  2003.                   FILES_SECURITY=2
  2004.                   FILES_PASSWORD=
  2005.                   FILES_AREA=New Uploads
  2006.                   FILES_PATH=\BBSX\FILES
  2007.                   FILES_AREA=Disk Utilities
  2008.                   FILES_PATH=\BBSX\FILES\DISK
  2009.                   FILES_AREA=Printer Utilities
  2010.                   FILES_PATH=\BBSX\FILES\PRINTER
  2011.                   FILES_AREA=Telecommunication Programs
  2012.                   FILES_PATH=\BBSX\FILES\TELECOM
  2013.                   END_OF_FILES=Y
  2014.  
  2015.               Edit each field to reflect your configuration requirements:
  2016.  
  2017.               1.  ~ Rich Levin's BBSXpress (tm)
  2018.  
  2019.                   A comment.  Text preceded by a tilde character is
  2020.                   ignored by BBSX.
  2021.  
  2022.               2.  FILES_SECURITY=
  2023.  
  2024.                   The security level required to download or upload
  2025.                   files in the areas defined below it.  Three
  2026.                   characters maximum.  Use a whole number from 0 to
  2027.                   999.
  2028.  
  2029.                   FILES_SECURITY settings must appear before all other
  2030.                   fields.
  2031.  
  2032.                   Multiple FILES_SECURITY settings can be used.  Each
  2033.                   new setting affects the file areas defined below it.
  2034.  
  2035.                   If multiple settings are used, a default setting
  2036.                   must be the first field in FILES.INI.  This prevents
  2037.                   the last setting encountered from looping back to
  2038.                   the top.
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.                                                                         26
  2051.  
  2052.  
  2053.                   If a FILES_SECURITY setting does not appear, the
  2054.                   NEW_USER_SECURITY (see Step 1, item 10, in the
  2055.                   "Editing the BBSX.INI file" section, above) will be
  2056.                   used in its place.
  2057.  
  2058.               3.  FILES_PASSWORD=
  2059.  
  2060.                   The password required to download or upload files in
  2061.                   the areas defined below it.  25 characters maximum.
  2062.                   Control and high-bit ASCII characters are accepted.
  2063.  
  2064.                   FILES_PASSWORDs must appear after a FILES_SECURITY
  2065.                   setting.
  2066.  
  2067.                   Multiple FILES_PASSWORDs can be used.  Each new
  2068.                   password affects the areas defined below it.
  2069.  
  2070.                   Use a blank password to unprotect areas.  Each new
  2071.                   blank password unprotects the areas defined below
  2072.                   it.
  2073.  
  2074.                   If multiple passwords are used, a default (or a
  2075.                   blank) password must be the second field in
  2076.                   FILES.INI.  This prevents the last password
  2077.                   encountered from looping back to the top.
  2078.  
  2079.                   If a FILES_PASSWORD does not appear, all areas will
  2080.                   be unprotected by passwords.
  2081.  
  2082.               4.  FILES_AREA=
  2083.  
  2084.                   The name of a files area.  50 characters maximum.
  2085.                   Control, ANSI and high-bit ASCII characters are
  2086.                   accepted.
  2087.  
  2088.                   Every FILES_AREA must be followed by a FILES_PATH.
  2089.  
  2090.               5.  FILES_PATH=
  2091.  
  2092.                   The disk pathname to a files area.  8 characters
  2093.                   maximum.  All legal DOS pathnames are accepted.
  2094.  
  2095.                   Every FILES_PATH must be preceded by a FILES_AREA.
  2096.  
  2097.               6.  END_OF_FILES=Y
  2098.  
  2099.                   An end-of-data (EOD) flag.  Must be the last entry
  2100.                   in FILES.INI.  BBSX stops searching for FILES.INI
  2101.                   fields when this entry is encountered.
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.                                                                         27
  2117.  
  2118.  
  2119.                   This EOD flag also allows users to optionally merge
  2120.                   FILES.INI into BBSX.INI, providing a central
  2121.                   initialization file.  If FILES.INI fields are merged
  2122.                   into BBSX.INI, the FILES.INI file is not used;
  2123.                   however, BBSX performs better when FILES.INI and
  2124.                   BBSX.INI are not merged.
  2125.  
  2126.                   General information about FILES.INI
  2127.                   ───────────────────────────────────
  2128.  
  2129.               The following rules apply to FILES.INI:
  2130.  
  2131.                   1.  FILES.INI must be stored in the BBSX
  2132.                       subdirectory.
  2133.  
  2134.                   2.  If FILES.INI fields cannot be found in the BBSX
  2135.                       subdirectory, BBSX will display the message "No
  2136.                       AREAS available" when requested to list them.
  2137.  
  2138.                   3.  There is no limit to the number of file areas,
  2139.                       file security levels and file area passwords
  2140.                       that BBSX can support.
  2141.  
  2142.                   4.  SysOps and Co-SysOps are not queried for a
  2143.                       password when entering protected areas.
  2144.  
  2145.                   Examples of FILES.INI files
  2146.                   ───────────────────────────
  2147.  
  2148.               The following examples demonstrate how the FILES.INI fields
  2149.           provide SysOps with the flexibility to create a variety of file
  2150.           areas:
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.                                                                         28
  2183.  
  2184.  
  2185.                   1.  This example allows users between security
  2186.                       levels 2 and 999 access to the New Uploads, Disk
  2187.                       Utilities and Printer Utilities areas.  Security
  2188.                       levels 500 through 999 can access the
  2189.                       Telecommunication Programs area.  Levels below 2
  2190.                       cannot access any file areas.*  No passwords are
  2191.                       used.
  2192.  
  2193.                       FILES_SECURITY=2
  2194.                       FILES_PASSWORD=
  2195.                       ~
  2196.                       FILES_AREA=New Uploads
  2197.                       FILES_PATH=\BBSX\FILES
  2198.                       ~
  2199.                       FILES_AREA=Disk Utilities
  2200.                       FILES_PATH=\BBSX\FILES\DISK
  2201.                       ~
  2202.                       FILES_AREA=Printer Utilities
  2203.                       FILES_PATH=\BBSX\FILES\PRINTER
  2204.                       ~
  2205.                       FILES_SECURITY=500
  2206.                       FILES_AREA=Telecommunication Programs
  2207.                       FILES_PATH=\BBSX\FILES\TELECOM
  2208.                       ~
  2209.                       END_OF_FILES=Y
  2210.  
  2211.                   2.  This example allows users between security
  2212.                       levels 2 and 999 access to the New Uploads and
  2213.                       Disk Utilities areas.  Security levels 500
  2214.                       through 999 can access the Printer Utilities and
  2215.                       Telecommunication Programs areas.  Levels below
  2216.                       2 cannot access any file areas.*  No passwords
  2217.                       are used.
  2218.  
  2219.                       FILES_SECURITY=2
  2220.                       FILES_PASSWORD=
  2221.                       ~
  2222.                       FILES_AREA=New Uploads
  2223.                       FILES_PATH=\BBSX\FILES
  2224.                       ~
  2225.                       FILES_AREA=Disk Utilities
  2226.                       FILES_PATH=\BBSX\FILES\DISK
  2227.                       ~
  2228.                       FILES_SECURITY=500
  2229.                       ~
  2230.                       FILES_AREA=Printer Utilities
  2231.                       FILES_PATH=\BBSX\FILES\PRINTER
  2232.                       ~
  2233.                       FILES_AREA=Telecommunication Programs
  2234.                       FILES_PATH=\BBSX\FILES\TELECOM
  2235.                       ~
  2236.                       END_OF_FILES=Y
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.                                                                         29
  2249.  
  2250.  
  2251.                   3.  This example allows users between security
  2252.                       levels 2 through 999 access to New Uploads;
  2253.                       levels 3 through 999 have access to Disk
  2254.                       Utilities; levels 4 through 999 can access
  2255.                       Printer Utilities; levels 5 through 999 may
  2256.                       enter Telecommunication Programs.  Levels below
  2257.                       2 cannot access any file areas.*  No passwords
  2258.                       are used.
  2259.  
  2260.                       FILES_SECURITY=2
  2261.                       FILES_PASSWORD=
  2262.                       FILES_AREA=New Uploads
  2263.                       FILES_PATH=\BBSX\FILES
  2264.                       ~
  2265.                       FILES_SECURITY=3
  2266.                       FILES_AREA=Disk Utilities
  2267.                       FILES_PATH=\BBSX\FILES\DISK
  2268.                       ~
  2269.                       FILES_SECURITY=4
  2270.                       FILES_AREA=Printer Utilities
  2271.                       FILES_PATH=\BBSX\FILES\PRINTER
  2272.                       ~
  2273.                       FILES_SECURITY=5
  2274.                       FILES_AREA=Telecommunication Programs
  2275.                       FILES_PATH=\BBSX\FILES\TELECOM
  2276.                       ~
  2277.                       END_OF_FILES=Y
  2278.  
  2279.                   4.  This example allows users between security
  2280.                       levels 2 through 999 access to the New Uploads,
  2281.                       Disk Utilities and Printer Utilities areas
  2282.                       without requiring a password.  Access to the
  2283.                       Telecommunication Programs area is limited to
  2284.                       users who know the password "company.refract."
  2285.                       Levels below 2 cannot access any file areas.*
  2286.  
  2287.                       FILES_SECURITY=2
  2288.                       FILES_PASSWORD=
  2289.                       ~
  2290.                       FILES_AREA=New Uploads
  2291.                       FILES_PATH=\BBSX\FILES
  2292.                       ~
  2293.                       FILES_AREA=Disk Utilities
  2294.                       FILES_PATH=\BBSX\FILES\DISK
  2295.                       ~
  2296.                       FILES_AREA=Printer Utilities
  2297.                       FILES_PATH=\BBSX\FILES\PRINTER
  2298.                       ~
  2299.                       FILES_PASSWORD=company.refract
  2300.                       FILES_AREA=Telecommunication Programs
  2301.                       FILES_PATH=\BBSX\FILES\TELECOM
  2302.                       ~
  2303.                       END_OF_FILES=Y
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.                                                                         30
  2315.  
  2316.  
  2317.                   5.  This example allows users between security
  2318.                       levels 2 and 999 access to the New Uploads and
  2319.                       Disk Utilities areas.  Access to the Printer
  2320.                       Utilities and Telecommunication Programs areas
  2321.                       is limited to users who know the password
  2322.                       "gwackle!doo."  Levels below 2 cannot access any
  2323.                       file areas.*
  2324.  
  2325.                       FILES_SECURITY=2
  2326.                       FILES_PASSWORD=
  2327.                       ~
  2328.                       FILES_AREA=New Uploads
  2329.                       FILES_PATH=\BBSX\FILES
  2330.                       ~
  2331.                       FILES_AREA=Disk Utilities
  2332.                       FILES_PATH=\BBSX\FILES\DISK
  2333.                       ~
  2334.                       FILES_PASSWORD=gwackle!doo
  2335.                       ~
  2336.                       FILES_AREA=Printer Utilities
  2337.                       FILES_PATH=\BBSX\FILES\PRINTER
  2338.                       ~
  2339.                       FILES_AREA=Telecommunication Programs
  2340.                       FILES_PATH=\BBSX\FILES\TELECOM
  2341.                       ~
  2342.                       END_OF_FILES=Y
  2343.  
  2344.                   6.  This example allows users between security
  2345.                       levels 2 and 999 access to all groups, provided
  2346.                       they know the passwords.  Levels below 2 cannot
  2347.                       access any file areas.*
  2348.  
  2349.                       FILES_SECURITY=2
  2350.                       ~
  2351.                       FILES_PASSWORD=face@wood
  2352.                       FILES_AREA=New Uploads
  2353.                       FILES_PATH=\BBSX\FILES
  2354.                       ~
  2355.                       FILES_PASSWORD=manual#luggage
  2356.                       FILES_AREA=Disk Utilities
  2357.                       FILES_PATH=\BBSX\FILES\DISK
  2358.                       ~
  2359.                       FILES_PASSWORD=spin$piece
  2360.                       FILES_AREA=Printer Utilities
  2361.                       FILES_PATH=\BBSX\FILES\PRINTER
  2362.                       ~
  2363.                       FILES_PASSWORD=staple%post
  2364.                       FILES_AREA=Telecommunication Programs
  2365.                       FILES_PATH=\BBSX\FILES\TELECOM
  2366.                       ~
  2367.                       END_OF_FILES=Y
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.                                                                         31
  2381.  
  2382.  
  2383.                   7.  This example allows users between security
  2384.                       levels 2 and 999 access to the New Uploads and
  2385.                       Disk Utilities areas, provided they know the
  2386.                       passwords; levels 500 through 999 have password
  2387.                       protected access to the Printer Utilities and
  2388.                       Telecommunication Programs areas.  Levels below
  2389.                       2 cannot access any file areas.*
  2390.  
  2391.                       FILES_SECURITY=2
  2392.                       ~
  2393.                       FILES_PASSWORD=plastic^threat
  2394.                       FILES_AREA=New Uploads
  2395.                       FILES_PATH=\BBSX\FILES
  2396.                       ~
  2397.                       FILES_PASSWORD=os&who
  2398.                       FILES_AREA=Disk Utilities
  2399.                       FILES_PATH=\BBSX\FILES\DISK
  2400.                       ~
  2401.                       FILES_SECURITY=500
  2402.                       ~
  2403.                       FILES_PASSWORD=power*tree
  2404.                       FILES_AREA=Printer Utilities
  2405.                       FILES_PATH=\BBSX\FILES\PRINTER
  2406.                       ~
  2407.                       FILES_PASSWORD=indicate(dust
  2408.                       FILES_AREA=Telecommunication Programs
  2409.                       FILES_PATH=\BBSX\FILES\TELECOM
  2410.                       ~
  2411.                       END_OF_FILES=Y
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.                                                                         32
  2447.  
  2448.  
  2449.                   8.  This example allows users between security
  2450.                       levels 2 through 999 access to New Uploads;
  2451.                       levels 3 through 999 have access Disk Utilities;
  2452.                       levels 4 through 999 can access Printer
  2453.                       Utilities; levels 5 through 999 may enter
  2454.                       Telecommunication Programs.  All areas are
  2455.                       individually password protected.  Levels below 2
  2456.                       cannot access any file areas.*
  2457.  
  2458.                       FILES_SECURITY=2
  2459.                       FILES_PASSWORD=box)card
  2460.                       FILES_AREA=New Uploads
  2461.                       FILES_PATH=\BBSX\FILES
  2462.                       ~
  2463.                       FILES_SECURITY=3
  2464.                       FILES_PASSWORD=vent_ruler
  2465.                       FILES_AREA=Disk Utilities
  2466.                       FILES_PATH=\BBSX\FILES\DISK
  2467.                       ~
  2468.                       FILES_SECURITY=4
  2469.                       FILES_PASSWORD=bulb-date
  2470.                       FILES_AREA=Printer Utilities
  2471.                       FILES_PATH=\BBSX\FILES\PRINTER
  2472.                       ~
  2473.                       FILES_SECURITY=5
  2474.                       FILES_PASSWORD=can+tube
  2475.                       FILES_AREA=Telecommunication Programs
  2476.                       FILES_PATH=\BBSX\FILES\TELECOM
  2477.                       ~
  2478.                       END_OF_FILES=Y
  2479.  
  2480.               These examples demonstrate how FILES_SECURITY and
  2481.           FILES_PASSWORD fields can be mixed and matched to create an
  2482.           infinite variety of configurations.
  2483.  
  2484.           *Note:  Users will be unable to download or upload if their
  2485.                   security level is less than the SECURITY_TO_DOWNLOAD or
  2486.                   SECURITY_TO_UPLOAD.  (See Step 1, items 12 and 14, in the
  2487.                   "Editing the BBSX.INI file" section, above.)
  2488.  
  2489.               ──────────────────────────────────────
  2490.               STEP 4 - Storing the PROTOCOL.INI file
  2491.               ──────────────────────────────────────
  2492.  
  2493.               PROTOCOL.INI is a control file used by BBSX to manage file
  2494.           transfer protocol selection.  This file is optional, used only by
  2495.           systems supporting a variety of file transfer protocols.
  2496.  
  2497.               If you are not supporting file areas, remove the PROTOCOL.INI
  2498.           file from the BBSX subdirectory and jump directly to
  2499.           configuration Step 5, "Editing the BBS.BAT file," below.
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.                                                                         33
  2513.  
  2514.  
  2515.               PROTOCOL.INI should not be edited by anyone other than
  2516.           experienced programmers.  (A programmer's technical reference
  2517.           guide to PROTOCOL.INI appears in appendix A.)
  2518.  
  2519.               PROTOCOL.INI IS PRE-CONFIGURED FOR USE WITH "DSZ," AN
  2520.           EXTERNAL FILE TRANSFER PROTOCOL DRIVER PRODUCED BY OMEN
  2521.           TECHNOLOGY, INC. AND RECOMMENDED FOR USE WITH BBSX.  DSZ is
  2522.           available for downloading on the Mother Board BBS (215-333-8275),
  2523.           Omen Technology's TeleGodzilla BBS (503-621-3746) and many public
  2524.           BBSes.
  2525.  
  2526.                   General information about PROTOCOL.INI
  2527.                   ──────────────────────────────────────
  2528.  
  2529.               The following rules apply to PROTOCOL.INI:
  2530.  
  2531.                   1.  PROTOCOL.INI must be stored in the BBSX
  2532.                       subdirectory.
  2533.  
  2534.                   2.  If PROTOCOL.INI fields cannot be found on disk,
  2535.                       BBSX will display the message "No PROTOCOLS
  2536.                       available" when requested to list them.
  2537.  
  2538.                   3.  To insure its correct operation, do not edit
  2539.                       PROTOCOL.INI.
  2540.  
  2541.               ─────────────────────────────────
  2542.               STEP 5 - Editing the BBS.BAT file
  2543.               ─────────────────────────────────
  2544.  
  2545.               BBS.BAT is a batch file used to load and recycle the BBSX
  2546.           program.  BBS.BAT must be edited using an ASCII editor operating
  2547.           in non-document mode.
  2548.  
  2549.               Load BBS.BAT into any ASCII editor.  The following text will
  2550.           be displayed:
  2551.  
  2552.                   echo off
  2553.                   break on
  2554.                   goto top
  2555.                   
  2556.                   Rich Levin's BBSXpress (tm)
  2557.                   BBS.BAT
  2558.                   Copyright (c) 1988 Richard B. Levin
  2559.                   All Rights Reserved
  2560.                   
  2561.                   Revised January 10, 1989
  2562.                   
  2563.                   :top
  2564.                       echo Loading BBSX
  2565.                       c:
  2566.                       cd \bbsx
  2567.                       bbsx
  2568.                       goto top
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.                                                                         34
  2579.  
  2580.  
  2581.               Edit BBS.BAT to reflect your configuration requirements:
  2582.  
  2583.               1.  Change the reference to drive "c:" to the letter of
  2584.                   the disk drive being used.
  2585.  
  2586.               2.  Change the reference to "\bbsx" to the name of the
  2587.                   subdirectory being used.
  2588.  
  2589.                   BBSX's optional start-up switches
  2590.                   ─────────────────────────────────
  2591.  
  2592.               The following start-up switches can be added, in any order,
  2593.           to BBS.BAT after the "bbsx" command:
  2594.  
  2595.               1.  /BLOCK or /BL
  2596.  
  2597.                   Causes BBSX to use a full-cell cursor on the local
  2598.                   screen instead of the default underline-style
  2599.                   cursor.
  2600.  
  2601.               2.  /CANADA or /CA
  2602.  
  2603.                   Runs BBSX in Canadian mode.
  2604.  
  2605.               3.  /COLOR or /CO
  2606.  
  2607.                   Runs BBSX in color mode.
  2608.  
  2609.               4.  /DASH or /DA
  2610.  
  2611.                   Causes BBSX to use a dash-style cursor on the local
  2612.                   screen instead of the default underline-style
  2613.                   cursor.
  2614.  
  2615.               5.  /DEBUG or /DE
  2616.  
  2617.                   Runs BBSX in DEBUG mode.  DEBUG mode peppers the
  2618.                   NODE.LOG with information that helps track
  2619.                   configuration bugs.  DEBUG mode decreases system
  2620.                   performance.
  2621.  
  2622.               6.  /DLALL or /DL
  2623.  
  2624.                   Allows users to download FILES.LST.  Normally, only
  2625.                   SysOp and Co-SysOp level users can download
  2626.                   FILES.LST, because FILES.LST may contain private
  2627.                   information.
  2628.  
  2629.               7.  /E71 or /E7
  2630.  
  2631.                   Runs BBSX using communication parameters of E71
  2632.                   instead of the default N81.
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.                                                                         35
  2645.  
  2646.  
  2647.               8.  /FLASH or /FL
  2648.  
  2649.                   Causes BBSX to use a continuously blinking cursor on
  2650.                   the local screen instead of the default
  2651.                   soft-blinking cursor.
  2652.  
  2653.               9.  /HALF or /HA
  2654.  
  2655.                   Causes BBSX to use a half-cell cursor on the local
  2656.                   screen instead of the default underline-style
  2657.                   cursor.
  2658.  
  2659.               10. /IGNOREDCD or /IG
  2660.  
  2661.                   Causes BBSX to ignore the state of carrier detect.
  2662.                   Use when running BBSX with a null modem that does
  2663.                   not provide a carrier.
  2664.  
  2665.               11. /NOLOG or /NO
  2666.  
  2667.                   Suppresses output to the NODE.LOG.  Increases system
  2668.                   performance but eliminates activity records.
  2669.  
  2670.               12. /NULLMODEM or /NU
  2671.  
  2672.                   Runs BBSX only at the baud rate specified in
  2673.                   BBSX.INI and skips modem initialization and
  2674.                   AT-command interaction.
  2675.  
  2676.               13. /PRINTER or /PR
  2677.  
  2678.                   Redirects NODE.LOG output to the printer.
  2679.  
  2680.               14. /RATIOFREE or /RA
  2681.  
  2682.                   Ignores DL/UL ratios, allowing users to continue
  2683.                   downloading after their DL/UL ratio goes out of
  2684.                   balance.
  2685.  
  2686.               15. /SKIPATZ or /SK
  2687.  
  2688.                   Skips resetting the modem with an ATZ.
  2689.  
  2690.               16. /SOLID or /SO
  2691.  
  2692.                   Causes BBSX to use a solid, non-blinking cursor on
  2693.                   the local screen instead of the default
  2694.                   soft-blinking cursor.
  2695.  
  2696.               17. /THIN or /TH
  2697.  
  2698.                   Causes BBSX to use a thin, single scan line cursor
  2699.                   on the local screen instead of the default
  2700.                   underline-style cursor.
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.                                                                         36
  2711.  
  2712.  
  2713.                   General information about BBS.BAT
  2714.                   ─────────────────────────────────
  2715.  
  2716.               The following rules apply to BBS.BAT:
  2717.  
  2718.               1.  BBS.BAT must be stored in the BBSX subdirectory or
  2719.                   in a subdirectory specified by the DOS PATH
  2720.                   environment variable.
  2721.  
  2722.               2.  If BBS.BAT cannot be found on disk, BBSX will fail
  2723.                   to operate properly.
  2724.  
  2725.               3.  BBSX must be run using the BBS.BAT file.  Do not run
  2726.                   BBSX without using BBS.BAT.
  2727.  
  2728.               4.  BBS.BAT is designed to infinitely loop.  Do not
  2729.                   alter this procedure.
  2730.  
  2731.               5.  To exit BBS.BAT, wait until the "... Press ^C ..."
  2732.                   prompt echos to the screen; then press ^C or
  2733.                   ^ScrollLock.  If the batch file does not "break,"
  2734.                   press ^C or ^ScrollLock again.  Do not press ^C or
  2735.                   ^ScrollLock while BBSX is unloading from memory;
  2736.                   some computers lock-up if a break key is struck
  2737.                   while returning to DOS.
  2738.  
  2739.               6.  Multiple switches can be specified on the command
  2740.                   line.  For example, the following command line runs
  2741.                   BBSX in Canadian mode, in color:
  2742.  
  2743.                       BBSX /CANADA /COLOR
  2744.  
  2745.               7.  Start-up switches can be entered as terse,
  2746.                   two-letter arguments.  For example, the following
  2747.                   command line also runs BBSX in Canadian mode, in
  2748.                   color:
  2749.  
  2750.                       BBSX /CA /CO
  2751.  
  2752.               ───────────────────────────────────
  2753.               STEP 6 - Editing the DAILY.BAT file
  2754.               ───────────────────────────────────
  2755.  
  2756.               DAILY.BAT is a batch file run by BBSX once daily.  This file
  2757.           is optional; it is provided so SysOps can automate maintenance
  2758.           functions not supported internally by BBSX.
  2759.  
  2760.               If you are in a hurry to get BBSX up and running, you can
  2761.           delay editing DAILY.BAT (or remove it from the hard disk
  2762.           altogether) and jump directly to configuration Step 7, "Editing
  2763.           the DOS.BAT file," below.
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.                                                                         37
  2777.  
  2778.  
  2779.               DAILY.BAT IS PRE-CONFIGURED FOR USE WITH "ZOO," A FILE
  2780.           COMPRESSION UTILITY PRODUCED BY RAHUL DHESI AND RECOMMENDED FOR
  2781.           USE WITH BBSX.  ZOO is available for downloading on the Mother
  2782.           Board BBS (215-333-8275), GEnie's IBM RT and many public BBSes.
  2783.  
  2784.               DAILY.BAT must be edited using an ASCII editor operating in
  2785.           non-document mode.
  2786.  
  2787.               Load DAILY.BAT into any ASCII editor.  The following text
  2788.           (demonstrating how DAILY.BAT can be used to back-up
  2789.           system-critical files) will be displayed:
  2790.  
  2791.                   echo on
  2792.                   goto top
  2793.                   
  2794.                   Rich Levin's BBSXpress (tm)
  2795.                   DAILY.BAT
  2796.                   Copyright (c) 1988 Richard B. Levin
  2797.                   All Rights Reserved
  2798.                   
  2799.                   Revised January 10, 1989
  2800.                   
  2801.                   :top
  2802.                       c:
  2803.                       cd \bbsx
  2804.                       if not exist bak\bbsx.zoo md bak
  2805.                   
  2806.                       zoo a: bbsx \bin\exe\bbsx.exe
  2807.                       zoo a: hdr *.hdr
  2808.                       zoo a: ini *.ini
  2809.                       zoo a: log *.log
  2810.                       zoo a: msg *.msg
  2811.                       zoo a: ptr *.ptr
  2812.                       zoo a: rsp *.rsp
  2813.                   
  2814.                       copy *.zoo bak
  2815.                       del *.zoo
  2816.  
  2817.               Edit DAILY.BAT to reflect your configuration requirements:
  2818.  
  2819.               1.  Change the reference to drive "c:" to the letter of
  2820.                   the disk drive being used.
  2821.  
  2822.               2.  Change the reference to "\bbsx" to the name of the
  2823.                   subdirectory being used.
  2824.  
  2825.                   General information about DAILY.BAT
  2826.                   ───────────────────────────────────
  2827.  
  2828.               The following rules apply to DAILY.BAT:
  2829.  
  2830.               1.  DAILY.BAT must be stored in the BBSX subdirectory or
  2831.                   in a subdirectory specified by the DOS PATH
  2832.                   environment variable.
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.                                                                         38
  2843.  
  2844.  
  2845.               2.  If DAILY.BAT cannot be found on disk, BBSX will
  2846.                   display the message "Bad command or file name" after
  2847.                   attempting to launch the child process.
  2848.  
  2849.               3.  DAILY.BAT can be programmed to perform any series of
  2850.                   legal DOS commands.  BBSX will execute the commands
  2851.                   once daily.
  2852.  
  2853.               4.  To disable DAILY.BAT, delete it from disk or replace
  2854.                   the commands in the above example with the
  2855.                   following:
  2856.  
  2857.                       rem daily.bat disabled
  2858.  
  2859.               5.  Programmers developing external utilities for BBSX
  2860.                   should incorporate their run-time calls into
  2861.                   DAILY.BAT.
  2862.  
  2863.               ─────────────────────────────────
  2864.               STEP 7 - Editing the DOS.BAT file
  2865.               ─────────────────────────────────
  2866.  
  2867.               DOS.BAT is a batch file used to provide SysOps with remote
  2868.           access to DOS.  This file is optional.
  2869.  
  2870.               If you are in a hurry to get BBSX up and running, you can
  2871.           delay editing DOS.BAT (or remove it from the hard disk
  2872.           altogether) and jump directly to configuration Step 8, "Storing
  2873.           the FTX.BAT file," below.
  2874.  
  2875.               DOS.BAT must be edited using an ASCII editor operating in
  2876.           non-document mode.
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.                                                                         39
  2909.  
  2910.  
  2911.               Load DOS.BAT into any ASCII editor.  The following text will
  2912.           be displayed:
  2913.  
  2914.                   echo off
  2915.                   goto top
  2916.                   
  2917.                   Rich Levin's BBSXpress (tm)
  2918.                   DOS.BAT
  2919.                   Copyright (c) 1988 Richard B. Levin
  2920.                   All Rights Reserved
  2921.                   
  2922.                   Revised January 10, 1989
  2923.                   
  2924.                   :top
  2925.                       tcd /com1 /on
  2926.                       ctty com1
  2927.                       echo Wait...
  2928.                   
  2929.                       command
  2930.                       
  2931.                       echo Wait...
  2932.                       ctty con
  2933.                       tcd /com1 /off
  2934.                   
  2935.                       c:
  2936.                       cd \bbsx
  2937.  
  2938.               Edit DOS.BAT to reflect your configuration requirements:
  2939.  
  2940.               1.  Change the reference to drive "c:" to the letter of
  2941.                   the disk drive being used.
  2942.  
  2943.               2.  Change the reference to "\bbsx" to the name of the
  2944.                   subdirectory being used.
  2945.  
  2946.               3.  Change the reference to "com1" to the port number of
  2947.                   the RS232C communications channel being used.
  2948.  
  2949.                   General information about DOS.BAT
  2950.                   ─────────────────────────────────
  2951.  
  2952.               The following rules apply to DOS.BAT:
  2953.  
  2954.               1.  DOS.BAT must be stored in the BBSX subdirectory or
  2955.                   in a subdirectory specified by the DOS PATH
  2956.                   environment variable.
  2957.  
  2958.               2.  If DOS.BAT cannot be found on disk, BBSX will
  2959.                   display the message "Bad command or file name" after
  2960.                   attempting to launch the child process and will not
  2961.                   provide DOS-level access to remote SysOps.
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.                                                                         40
  2975.  
  2976.  
  2977.               3.  The program file TCD.COM (provided with BBSX) must
  2978.                   be stored in the BBSX subdirectory or in a
  2979.                   subdirectory specified by the DOS PATH environment
  2980.                   variable.
  2981.  
  2982.                   TCD.COM is a resident utility that automatically
  2983.                   re-boots a computer when carrier is lost.  When a
  2984.                   SysOp working at DOS-level disconnects the telephone
  2985.                   (drops carrier) before returning to BBSX, TCD.COM
  2986.                   re-boots the system to prevent unauthorized callers
  2987.                   from accessing the DOS prompt.  If the last command
  2988.                   in AUTOEXEC.BAT is "BBS," BBSX will recycle.  (A
  2989.                   technical reference guide to TCD.COM appears in
  2990.                   appendix B.)
  2991.  
  2992.               4.  A copy of COMMAND.COM must be stored in the BBSX
  2993.                   subdirectory or in a subdirectory specified by the
  2994.                   DOS PATH environment variable.
  2995.  
  2996.               5.  To insure correct operation, we recommend the
  2997.                   COMSPEC environment variable be SET in the
  2998.                   AUTOEXEC.BAT file:
  2999.  
  3000.                       SET COMSPEC=[d:][path]COMMAND.COM
  3001.  
  3002.                   See your DOS manual for information on the COMSPEC
  3003.                   environment variable.
  3004.  
  3005.               6.  Some versions of MS DOS feature a buggy CTTY command
  3006.                   that causes system lock-ups during redirected
  3007.                   DOS-level backspacing.  Users of true-blue IBM PC
  3008.                   DOS will not encounter this bug.
  3009.  
  3010.                   If you experience difficulty with BBSX's drop-to-DOS
  3011.                   function, visit the Mother Board BBS (215-333-8275)
  3012.                   and download GAPCTY.ARC or GATEWAY.ARC.  These files
  3013.                   contain enhancements to the CTTY command that
  3014.                   resolve the MS DOS bugs.
  3015.  
  3016.               ─────────────────────────────────
  3017.               STEP 8 - Storing the FTX.BAT file
  3018.               ─────────────────────────────────
  3019.  
  3020.               FTX.BAT is a batch file used by BBSX to control file
  3021.           downloads and uploads.  FTX.BAT is an extension of BBSX's program
  3022.           code and should not be edited by anyone other than experienced
  3023.           programmers.  (A programmer's technical reference guide to
  3024.           FTX.BAT appears in appendix A.)
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.                                                                         41
  3041.  
  3042.  
  3043.               FTX.BAT IS PRE-CONFIGURED FOR USE WITH "DSZ," AN EXTERNAL
  3044.           FILE TRANSFER PROTOCOL DRIVER PRODUCED BY OMEN TECHNOLOGY, INC.
  3045.           AND RECOMMENDED FOR USE WITH BBSX.  DSZ is available for
  3046.           downloading on the Mother Board BBS (215-333-8275), Omen
  3047.           Technology's TeleGodzilla BBS (503-621-3746) and many public
  3048.           BBSes.
  3049.  
  3050.                   General information about FTX.BAT
  3051.                   ─────────────────────────────────
  3052.  
  3053.               The following rules apply to FTX.BAT:
  3054.  
  3055.               1.  FTX.BAT must be stored in the BBSX subdirectory or
  3056.                   in a subdirectory specified by the DOS PATH
  3057.                   environment variable.
  3058.  
  3059.               2.  If FTX.BAT cannot be found on disk, BBSX will
  3060.                   display the message "Bad command or file name" after
  3061.                   attempting to launch the child process and will be
  3062.                   unable to perform file transfers.
  3063.  
  3064.               3.  DSZ.EXE must be stored in the BBSX subdirectory or
  3065.                   in a subdirectory specified by the DOS PATH
  3066.                   environment variable.
  3067.  
  3068.               4.  If DSZ.EXE cannot be found on disk, BBSX will
  3069.                   display the message "Bad command or file name" after
  3070.                   attempting to launch the protocol driver and will be
  3071.                   unable to perform file transfers.
  3072.  
  3073.               5.  To insure its correct operation, do not edit
  3074.                   FTX.BAT.
  3075.  
  3076.               ───────────────────────────────────
  3077.               STEP 9 - Editing the MENU.BLT file
  3078.               ───────────────────────────────────
  3079.  
  3080.               MENU.BLT is the main bulletin menu file, displayed to users
  3081.           when they request the BULLETINS menu.  This file is optional; it
  3082.           is provided so SysOps can offer callers a variety of bulletins.
  3083.  
  3084.               If you do not plan to provide bulletins or if you are in a
  3085.           hurry to get BBSX up and running, remove the MENU.BLT file from
  3086.           the BBSX subdirectory and jump directly to configuration Step 10,
  3087.           "Editing the system .BLT files," below.
  3088.  
  3089.               MENU.BLT must be edited using an ASCII editor operating in
  3090.           non-document mode.
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.                                                                         42
  3107.  
  3108.  
  3109.               Load MENU.BLT into any ASCII editor.  The following text will
  3110.           be displayed:
  3111.  
  3112.                       ╒══════════════════════╕
  3113.                       │ -- BULLETINS Menu -- │
  3114.                       ╘══════════════════════╛
  3115.                   
  3116.                       1   Contact Info ... Software by Rich Levin
  3117.                       2   User Supported Software ... Production Staff
  3118.                       3   How to Get Increased Access
  3119.                   
  3120.                   █═══════════════════════════════════════════════════════█
  3121.                   │   DOWNLOAD        A download reminder                 │
  3122.                   │   GOODBYE         Log-off screen                      │
  3123.                   │   HELLO           Welcoming screen                    │
  3124.                   │   MENU            This menu again!                    │
  3125.                   │   NEWS            The daily news file                 │
  3126.                   │   NEWUSER         Information for new users           │
  3127.                   │   UPLOAD          Upload requests                     │
  3128.                   █═══════════════════════════════════════════════════════█
  3129.  
  3130.               Edit MENU.BLT to reflect your configuration requirements:
  3131.  
  3132.               1.  MENU.BLT should list available bulletins by name,
  3133.                   number and description.
  3134.  
  3135.               2.  Each bulletin listed must have a corresponding .BLT
  3136.                   file on disk.  For example, bulletin #1 must appear
  3137.                   on disk as "1.BLT," bulletin #2 as "2.BLT," bulletin
  3138.                   #3 as "3.BLT," the HELLO bulletin as "HELLO.BLT" and
  3139.                   so on.  Names, numbers, legal DOS filename
  3140.                   characters and combinations thereof can be used to
  3141.                   identify .BLT files.
  3142.  
  3143.               3.  Format MENU.BLT and .BLT files using the designs of
  3144.                   your choice.  Control, ANSI and high-bit ASCII
  3145.                   characters are accepted.
  3146.  
  3147.                   Controlling .BLT file output
  3148.                   ────────────────────────────
  3149.  
  3150.               There are times when the output of a bulletin must be
  3151.           controlled.  For instance, some SysOps want to prevent new users
  3152.           from cancelling a display of system rules and regulations; others
  3153.           want to display ANSI-animated bulletins without pausing after
  3154.           every full screen.
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.                                                                         43
  3173.  
  3174.  
  3175.               BBSX provides facilities to address these needs.  The
  3176.           following commands, when embedded in .BLT files, control their
  3177.           output:
  3178.  
  3179.                   1.  ~FORCEREAD or ~F - the "Force-Read" command
  3180.  
  3181.                       When the word FORCEREAD or the letter F is
  3182.                       preceded by a tilde (ASCII character 126, "~")
  3183.                       in a .BLT file, requests by the user to abort
  3184.                       the display are ignored.
  3185.  
  3186.                       There must not be any spaces between the tilde
  3187.                       and the force-read command.  BBSX will interpret
  3188.                       the command as a comment if a space appears.
  3189.  
  3190.                       For best results, place the force-read command
  3191.                       on the first line of a .BLT file.
  3192.  
  3193.                       The force-read command can be entered in upper
  3194.                       or lower case.
  3195.  
  3196.                       The NEWUSER.BLT file (provided with BBSX)
  3197.                       contains an example of the force-read command.
  3198.  
  3199.                   2.  ~NONSTOP or ~N - the "Non-stop" command
  3200.  
  3201.                       When the word NONSTOP or the letter N is
  3202.                       preceded by a tilde (ASCII character 126, "~")
  3203.                       in a .BLT file, the file is displayed to its end
  3204.                       without interruption.  Requests by the user to
  3205.                       abort the display are honored unless the
  3206.                       force-read command has also been issued.
  3207.  
  3208.                       There must not be any spaces between the tilde
  3209.                       and the non-stop command.  BBSX will interpret
  3210.                       the command as a comment if a space appears.
  3211.  
  3212.                       For best results, place the non-stop command on
  3213.                       the first line of a .BLT file.
  3214.  
  3215.                       The non-stop command can be entered in upper or
  3216.                       lower case.
  3217.  
  3218.                       The 1.BLT file (provided with BBSX) contains an
  3219.                       example of the non-stop command.
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.                                                                         44
  3239.  
  3240.  
  3241.                   General information about MENU.BLT
  3242.                   ──────────────────────────────────
  3243.  
  3244.               The following rules apply to MENU.BLT:
  3245.  
  3246.               1.  MENU.BLT must be stored in the BBSX subdirectory.
  3247.  
  3248.               2.  If the MENU.BLT file cannot be found in the BBSX
  3249.                   subdirectory, the message "BULLETINS have not been
  3250.                   posted today" will be displayed when users request
  3251.                   the BULLETINS menu.
  3252.  
  3253.               3.  Users requesting .BLT files that BBSX cannot find in
  3254.                   the BBSX subdirectory will receive the message
  3255.                   "BULLETIN not available."
  3256.  
  3257.               4.  If a .BLT file does not appear in MENU.BLT but does
  3258.                   exist on disk, it can be viewed if the user knows
  3259.                   its name or number.
  3260.  
  3261.               5.  There is no limit to the number of bulletins (.BLT
  3262.                   files) BBSX can support.
  3263.  
  3264.               ───────────────────────────────────────
  3265.               STEP 10 - Editing the System .BLT files
  3266.               ───────────────────────────────────────
  3267.  
  3268.               There are seven .BLT files reserved for system use:
  3269.           DOWNLOAD, GOODBYE, HELLO, MENU, NEWS, NEWUSER and UPLOAD.  These
  3270.           files, displayed automatically at specific session times, are
  3271.           optional; they are provided so SysOps can customize the look and
  3272.           feel of the BBS.
  3273.  
  3274.               If you do not plan to support an exclusive BBS image or if
  3275.           you are in a hurry to get BBSX up and running, remove the system
  3276.           .BLT files from the BBSX subdirectory and jump directly to
  3277.           configuration Step 11, "Editing the MENU.POL file," below.
  3278.  
  3279.               System .BLT files must be edited using an ASCII editor
  3280.           operating in non-document mode.
  3281.  
  3282.               Each system .BLT file functions in a unique manner, described
  3283.           below.  Edit the sample .BLT files (provided with BBSX) using any
  3284.           ASCII editor before putting your board on-line:
  3285.  
  3286.               1.  DOWNLOAD.BLT
  3287.  
  3288.                   An upload information screen.  Displayed to users
  3289.                   once daily, immediately after they enter a request
  3290.                   to download a file.
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.                                                                         45
  3305.  
  3306.  
  3307.               2.  GOODBYE.BLT
  3308.  
  3309.                   A closing "goodbye" message.  Displayed to users
  3310.                   once daily, immediately after they log off.
  3311.  
  3312.               3.  HELLO.BLT
  3313.  
  3314.                   An opening "welcoming" screen.  Displayed to users
  3315.                   once daily, immediately after they log in.
  3316.  
  3317.               4.  MENU.BLT
  3318.  
  3319.                   See Step 10, "Editing the MENU.BLT file," above.
  3320.  
  3321.               5.  NEWS.BLT
  3322.  
  3323.                   An opening "news" screen.  Displayed to users once
  3324.                   daily, immediately after the HELLO.BLT file is
  3325.                   displayed.
  3326.  
  3327.               6.  NEWUSER.BLT
  3328.  
  3329.                   An opening "new user information" screen.  Displayed
  3330.                   to users on their first call, immediately after the
  3331.                   NEWS.BLT file is displayed.
  3332.  
  3333.               7.  UPLOAD.BLT
  3334.  
  3335.                   An upload information screen.  Displayed to users
  3336.                   once daily, immediately after they enter a request
  3337.                   to upload a file.
  3338.  
  3339.               In addition, message groups can have associated bulletins.
  3340.           Message group bulletins are presented to users once daily,
  3341.           immediately after they enter the message group.
  3342.  
  3343.               To link a bulletin to a message group, give the .BLT file the
  3344.           same name as the GROUP_FILENAME.  (See Step 2, item 5, in the
  3345.           "Editing the GROUP.INI file" section, above).
  3346.  
  3347.               For example, to present users with a greeting when they enter
  3348.           the MAIN group, store a file with the name of "MAIN.BLT" in the
  3349.           BBSX subdirectory.  A sample MAIN.BLT is provided with BBSX.
  3350.  
  3351.                   General information about system .BLT files
  3352.                   ───────────────────────────────────────────
  3353.  
  3354.               The following rules apply to system .BLT files:
  3355.  
  3356.               1.  System .BLT files must be stored in the BBSX
  3357.                   subdirectory.
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.                                                                         46
  3371.  
  3372.  
  3373.               2.  The commands for controlling .BLT file output apply
  3374.                   to system .BLT files.  (See Step 9, the "Editing the
  3375.                   MENU.BLT file" section, "Controlling .BLT file
  3376.                   output" subsection), above.
  3377.  
  3378.               ───────────────────────────────────
  3379.               STEP 11 - Editing the MENU.POL file
  3380.               ───────────────────────────────────
  3381.  
  3382.               MENU.POL is the main questionnaire menu file, displayed to
  3383.           users when they request the POLLS menu.  This file is optional,
  3384.           used only by systems supporting a variety of questionnaires.
  3385.  
  3386.               If you do not plan to support questionnaires or if you are in
  3387.           a hurry to get BBSX up and running, remove the MENU.POL file from
  3388.           the BBSX subdirectory and jump directly to configuration Step 12,
  3389.           "Installing yourself as SysOp," below.
  3390.  
  3391.               MENU.POL must be edited using an ASCII editor operating in
  3392.           non-document mode.
  3393.  
  3394.               Load MENU.POL into any ASCII editor.  The following text will
  3395.           be displayed:
  3396.  
  3397.                   ╒══════════════════════╕
  3398.                   │ ──── POLLS Menu ──── │
  3399.                   ╘══════════════════════╛
  3400.                   
  3401.                         1   New User Questionnaire
  3402.                         2   User Hardware Profile
  3403.                         3   User Software Profile
  3404.                         4   Add a BBS to our BBS list
  3405.                         5   BBS Users Survey
  3406.                   
  3407.                   COMMENT   Post a private comment to the SysOp
  3408.  
  3409.               Edit MENU.POL to reflect your configuration requirements:
  3410.  
  3411.               1.  MENU.POL should list available polls by name, number
  3412.                   and description.
  3413.  
  3414.               2.  Each poll listed must have a corresponding .POL file
  3415.                   on disk.  For example, poll #1 must appear on disk
  3416.                   as "1.POL," poll #2 as "2.POL," poll #3 as "3.POL,"
  3417.                   the COMMENT poll as "COMMENT.POL" and so on.  Names,
  3418.                   numbers, legal DOS filename characters and
  3419.                   combinations thereof can be used to identify .POL
  3420.                   files.
  3421.  
  3422.               3.  Format MENU.POL and .POL files using the designs of
  3423.                   your choice.  Control, ANSI and high-bit ASCII
  3424.                   characters are accepted.
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.                                                                         47
  3437.  
  3438.  
  3439.                   Controlling .POL file output
  3440.                   ────────────────────────────
  3441.  
  3442.               There are times when the output of a poll must be controlled.
  3443.           For instance, some SysOps want to prevent users from cancelling a
  3444.           display; others want to display ANSI-animated polls without
  3445.           pausing after every full screen.
  3446.  
  3447.               BBSX provides facilities to address these needs.  The
  3448.           following commands, when embedded in .POL files, control their
  3449.           output:
  3450.  
  3451.                   1.  ~? - the "Input" command
  3452.  
  3453.                       When a question mark is preceded by a tilde
  3454.                       (ASCII character 126, "~") in a .POL file, BBSX
  3455.                       prompts the user for input.
  3456.  
  3457.                       The format of the input command is as follows:
  3458.  
  3459.                           ~?#
  3460.  
  3461.                       where "#" is a number from 1 to 99, representing
  3462.                       the maximum number of lines to be input.  For
  3463.                       example, the following command causes BBSX to
  3464.                       accept nine lines of input:
  3465.  
  3466.                           ~?9
  3467.  
  3468.                       User responses are recorded in a corresponding
  3469.                       ".RSP" file.  .RSP files follow the same naming
  3470.                       conventions as .POL files; that is, a poll named
  3471.                       "1.POL" would have its responses stored in a
  3472.                       file named "1.RSP."
  3473.  
  3474.                       The response date, time and user name are
  3475.                       automatically recorded in .RSP files.
  3476.  
  3477.                       .RSP files can be viewed using any ASCII editor.
  3478.  
  3479.                   2.  ~FORCEREAD or ~F - the "Force-Read" command
  3480.  
  3481.                       When the word FORCEREAD or the letter F is
  3482.                       preceded by a tilde (ASCII character 126, "~")
  3483.                       in a .POL file, requests by the user to abort
  3484.                       the display are ignored.
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.                                                                         48
  3503.  
  3504.  
  3505.                       There must not be any spaces between the tilde
  3506.                       and the force-read command.  BBSX will interpret
  3507.                       the command as a comment if a space appears.
  3508.  
  3509.                       For best results, place the force-read command
  3510.                       on the first line of a .POL file.
  3511.  
  3512.                       The force-read command can be entered in upper
  3513.                       or lower case.
  3514.  
  3515.                   3.  ~NONSTOP or ~N - the "Non-stop" command
  3516.  
  3517.                       When the word NONSTOP or the letter N is
  3518.                       preceded by a tilde (ASCII character 126, "~")
  3519.                       in a .POL file, the file is displayed without
  3520.                       interruption.  Requests by the user to abort the
  3521.                       display are honored unless the force-read
  3522.                       command has been issued.
  3523.  
  3524.                       There must not be any spaces between the tilde
  3525.                       and the non-stop command.  BBSX will interpret
  3526.                       the command as a comment if a space appears.
  3527.  
  3528.                       For best results, place the non-stop command on
  3529.                       the first line of a .POL file.
  3530.  
  3531.                       The non-stop command can be entered in upper or
  3532.                       lower case.
  3533.  
  3534.                   General information about MENU.POL
  3535.                   ──────────────────────────────────
  3536.  
  3537.               The following rules apply to MENU.POL:
  3538.  
  3539.               1.  MENU.POL must be stored in the BBSX subdirectory.
  3540.  
  3541.               2.  If the MENU.POL file cannot be found in the BBSX
  3542.                   subdirectory, the message "POLLS have not been
  3543.                   posted today" will be displayed when users request
  3544.                   the POLLS menu.
  3545.  
  3546.               3.  Users requesting .POL files that BBSX cannot find in
  3547.                   the BBSX subdirectory will receive the message "POLL
  3548.                   not available."
  3549.  
  3550.               4.  If a .POL file does not appear in MENU.POL but does
  3551.                   exist on disk, it can be viewed if the user knows
  3552.                   its name or number.
  3553.  
  3554.               5.  There is no limit to the number of questionnaires
  3555.                   (.POL files) and response files (.RSPs) that BBSX
  3556.                   can support.
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.                                                                         49
  3569.  
  3570.  
  3571.               ────────────────────────────────────────
  3572.               STEP 12 - Installing yourself as a SysOp
  3573.               ────────────────────────────────────────
  3574.  
  3575.               Every BBS requires a system operator, popularly referred to
  3576.           as the "SysOp."  Guess what?  You're it!
  3577.  
  3578.               BBSX SysOps are granted special privileges, among them the
  3579.           ability to:
  3580.  
  3581.               *   Have unlimited on-line time
  3582.  
  3583.               *   Access the SYSTEM menu
  3584.  
  3585.               *   Change user access (time) and security levels
  3586.  
  3587.               *   "Lock-out" users
  3588.  
  3589.               *   Delete and undelete users
  3590.  
  3591.               *   View and edit the USER.LOG
  3592.  
  3593.               *   View and delete the NODE.LOG (an activity/audit log)
  3594.  
  3595.               *   Access all message and file areas
  3596.  
  3597.               *   Waive group and files password requirements
  3598.  
  3599.               *   Read "private" mail
  3600.  
  3601.               *   Delete and undelete messages regardless of who
  3602.                   posted
  3603.  
  3604.               *   Access DOS from a remote computer
  3605.  
  3606.               *   Watch users on-line
  3607.  
  3608.               *   Force users in CHAT mode
  3609.  
  3610.               *   Disconnect users
  3611.  
  3612.               Assuming BBSX has been correctly installed and configured,
  3613.           the next step is to let it know who's boss.
  3614.  
  3615.               To install yourself as the SysOp:
  3616.  
  3617.               1.  Confirm that BBSX.EXE and BRUN60AR.EXE are in the
  3618.                   BBSX subdirectory or in a subdirectory specified by
  3619.                   the DOS PATH environment variable.
  3620.  
  3621.               2.  Enter the following commands:
  3622.  
  3623.                       CD \BBSX
  3624.                       BBSX /SYSOP
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.                                                                         50
  3635.  
  3636.  
  3637.               3.  BBSX will load, display the message "WARNING:  The
  3638.                   /SYSOP start-up switch is ACTIVE" and then prompt:
  3639.  
  3640.                       Local (CR), Quit (ESC)
  3641.  
  3642.                   Press CR or enter the letter "L."
  3643.  
  3644.               4.  BBSX will go off hook and prompt:
  3645.  
  3646.                       First name:
  3647.  
  3648.                   Enter your first name.
  3649.  
  3650.               5.  BBSX will prompt:
  3651.  
  3652.                       Last name:
  3653.  
  3654.                   Enter your last name.
  3655.  
  3656.               6.  BBSX will prompt:
  3657.  
  3658.                       Are you a NEW user (y/N)?
  3659.  
  3660.                   Enter the letter "Y."
  3661.  
  3662.               7.  BBSX will prompt:
  3663.  
  3664.                       Password:
  3665.  
  3666.                   Enter a password that YOU and ONLY YOU will know.
  3667.                   Control and high-bit ASCII characters are accepted.
  3668.  
  3669.               8.  After a moment, BBSX will exit to DOS, having
  3670.                   registered you as the board's SysOp.
  3671.  
  3672.                   Never run BBSX with the /SYSOP switch again.
  3673.  
  3674.               ───────────────────────
  3675.               STEP 13 - Going on-line
  3676.               ───────────────────────
  3677.  
  3678.               Assuming BBSX has been correctly installed and configured and
  3679.           that the SysOp has been installed, the next step is to go
  3680.           on-line.
  3681.  
  3682.               Always run BBSX using the BBS.BAT file.  To put BBSX on-line:
  3683.  
  3684.               *   If BBS.BAT is stored in the BBSX subdirectory, enter
  3685.                   the following commands:
  3686.  
  3687.                       CD \BBSX
  3688.                       BBS
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.                                                                         51
  3701.  
  3702.  
  3703.               *   If BBS.BAT is stored in a subdirectory specified by
  3704.                   the DOS PATH environment variable, enter the
  3705.                   command:
  3706.  
  3707.                       BBS
  3708.  
  3709.               BBSX will load and answer incoming calls automatically.
  3710.  
  3711.           ════════════════════
  3712.           LEARNING TO USE BBSX
  3713.           ════════════════════
  3714.  
  3715.               We don't provide a comprehensive "command reference" for BBSX
  3716.           -- it's not necessary.  We think you'll agree that BBSX's
  3717.           interface is intuitive for novice and professional users alike.
  3718.  
  3719.               Users adapt quickly to BBSX's instinctive approach to BBSing;
  3720.           the less documentation there is to wade through, the faster users
  3721.           get up to speed.
  3722.  
  3723.               Jump in and start exploring the BBSXperience (tm).  Feel free
  3724.           to call for support (215-333-8274/voice or 215-333-8275/data)
  3725.           should the need arise.
  3726.  
  3727.           ══════════════════════════════════
  3728.           REQUIRED MODEM DIP-SWITCH SETTINGS
  3729.           ══════════════════════════════════
  3730.  
  3731.               The following DIP-switch settings correspond to the Hayes
  3732.           Smartmodem 1200 (external) and the MultiTech MultiModem 224E
  3733.           (external); your modem's DIP-switches may not correspond to this
  3734.           chart:
  3735.  
  3736.               SWITCH      POSITION    FUNCTION
  3737.               ────────────────────────────────────────────────────────
  3738.               1           DOWN        Modem ignores status of DTR
  3739.               2           UP          Enables verbose (word) responses
  3740.               3           DOWN        Enables command responses
  3741.               4           UP          Enables command character echo
  3742.               5           UP          Enables auto-answer
  3743.               6           UP          DCD & DSR reflect actual status
  3744.               7           UP          Single line telephone jack
  3745.               8           DOWN        Enables command mode
  3746.  
  3747.               The following DIP-switch settings correspond to the Hayes
  3748.           Smartmodem 1200B (internal); your modem's DIP-switches may not
  3749.           correspond to this chart:
  3750.  
  3751.               SWITCH      POSITION    FUNCTIONS
  3752.               ────────────────────────────────────────────────────────
  3753.               1           RIGHT       Designates a COM1 device*
  3754.               2           LEFT        Single line telephone jack
  3755.               3           RIGHT       DCD reflects actual status
  3756.               4           RIGHT       Modem ignores status of DTR
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.                                                                         52
  3767.  
  3768.  
  3769.               (*1         LEFT        Designates a COM2 device)
  3770.  
  3771.               The modem must be set to ignore the status of DTR (generally
  3772.           referred to as "forcing DTR on").  Otherwise, the modem will hang
  3773.           up on callers after CONNECTing and during file transfers.
  3774.           Ignoring the status of DTR should not adversely effect other
  3775.           communications programs.
  3776.  
  3777.               Notes:
  3778.  
  3779.               1.  Some modems do not have DIP-switches.  Instead, AT-
  3780.                   and S-register commands are used for configuration.
  3781.  
  3782.                   Modems that do not use DIP-switches usually use an
  3783.                   "AT&D0" command to force DTR on.  By adding "&D0" to
  3784.                   the MODEM_INI string, the modem will be configured
  3785.                   to ignore the status of DTR.  (See Step 1, item 8,
  3786.                   in the "Editing the BBSX.INI file" section, above.)
  3787.  
  3788.                   Refer to the modem manufacturer's owners manual for
  3789.                   the appropriate commands, or call us for support.
  3790.  
  3791.               2.  DCD = Data Carrier Detect (usually referred to as
  3792.                   "Carrier Detect"), DTR = Data Terminal Ready.
  3793.  
  3794.           ══════
  3795.           HOW TO
  3796.           ══════
  3797.  
  3798.               1.  USE ANOTHER DISK OR SUBDIRECTORY NAME
  3799.  
  3800.                   For reference purposes, this document calls the main
  3801.                   BBSX data directory "BBSX."  You can name and locate
  3802.                   the main BBSX data directory any way you like.
  3803.                   Remember to change the .BAT files (see Steps 5
  3804.                   through 8, the "Editing the *.BAT file" sections,
  3805.                   above) to reflect the correct drive and directory
  3806.                   where the BBSX files are stored.
  3807.  
  3808.               2.  CREATE OR CONVERT FILE DESCRIPTION FILES
  3809.  
  3810.                   File descriptions are stored in ASCII text files
  3811.                   named FILES.LST.  Each files directory must contain
  3812.                   a FILES.LST file; the INSTALL.BAT file created
  3813.                   temporary FILES.LST files during the installation
  3814.                   process.
  3815.  
  3816.                   FILES.LST files are formatted exactly like the
  3817.                   output of a DOS DIR command.  The easiest way to
  3818.                   create or add information to a FILES.LST file is to
  3819.                   use the following command:
  3820.  
  3821.                       CD [files_path*]
  3822.                       DIR >> FILES.LST
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.                                                                         53
  3833.  
  3834.  
  3835.                   (*See Step 3, item 4, in the "Editing the FILES.INI
  3836.                   file" section, above.)
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.  
  3845.  
  3846.  
  3847.  
  3848.  
  3849.  
  3850.  
  3851.  
  3852.  
  3853.  
  3854.  
  3855.  
  3856.  
  3857.  
  3858.  
  3859.  
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.                                                                         54
  3899.  
  3900.  
  3901.                   Load FILES.LST into any ASCII editor and delete the
  3902.                   DOS-specific data:
  3903.  
  3904.                     Volume in drive C is BBSX               <- Delete
  3905.                     Directory of  C:\FILES\EXAMPLE          <- Delete
  3906.                                                             <- KEEP
  3907.                   .            <DIR>      8-09-88   6:29p   <- Delete
  3908.                   ..           <DIR>      8-09-88   6:29p   <- Delete
  3909.                   FOO      MS      1234   1-01-80  12:24a   <- KEEP
  3910.                   BASIC60I S#1     1988  10-08-88  11:09a   <- KEEP
  3911.                   WHATSUP  DOC      808   7-30-86   9:44a   <- KEEP
  3912.                   FILES    LST        0   8-13-88   8:21a   <- Delete
  3913.                   SHNICK   ARC      128  12-12-52  12:55p   <- KEEP
  3914.                   PLORK    TXT     3476   9-30-88   1:59p   <- KEEP
  3915.                           8 File(s) 922509568 bytes free    <- Delete
  3916.                                          ||
  3917.                                          ||
  3918.                                          Column 24
  3919.                                          |
  3920.                                          Column 25
  3921.  
  3922.                   Next, delete the time stamps, and enter the file
  3923.                   descriptions where the times used to be (2
  3924.                   characters after the file date).  Descriptions can
  3925.                   be up to 47 characters long.
  3926.  
  3927.                   To convert RBBS, PCBoard, Postmaster or other ASCII
  3928.                   text file descriptions to BBSX's format, rename the
  3929.                   old files "FILES.LST."  Next, confirm the date field
  3930.                   starts in the 24th column of the text (because
  3931.                   BBSX's "NEW" files search expects to find it there).
  3932.                   Note that months less than two digits long have a
  3933.                   blank space in the 24th column (see diagram, above).
  3934.  
  3935.           ════════════════════════
  3936.           BBSX'S F KEY ASSIGNMENTS
  3937.           ════════════════════════
  3938.  
  3939.               System keys             On-line keys
  3940.               ────────────────────────────────────────────────────────
  3941.               F1   Help               F2    Who's on
  3942.               F3   Speaker            F4    Extended caller info
  3943.               F5   Screen             F6    Force chat
  3944.               F7   Reserve system     F8    Disconnect caller
  3945.               F9   Date/time          F10   Clear/cancel
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.                                                                         55
  3965.  
  3966.  
  3967.           ═══════════════
  3968.           TROUBLESHOOTING
  3969.           ═══════════════
  3970.  
  3971.               1.  MODEM HANGS UP ON CALLERS
  3972.  
  3973.                   The modem is not 100% Hayes-compatible or is not set
  3974.                   to ignore the status of DTR.
  3975.  
  3976.                   Confirm the modem is set to ignore the status of
  3977.                   DTR.  (See the "REQUIRED MODEM DIP-SWITCH SETTINGS"
  3978.                   section, above.)
  3979.  
  3980.               2.  MODEM WON'T HANG UP
  3981.  
  3982.                   The modem is not 100% Hayes-compatible or the
  3983.                   MODEM_INI and MODEM_TIMER fields in BBSX.INI are not
  3984.                   set correctly.
  3985.  
  3986.                   Confirm the MODEM_INI and MODEM_TIMER fields in
  3987.                   BBSX.INI are set correctly.  (See Step 1, items 8
  3988.                   and 9, in the "Editing the BBSX.INI file" section,
  3989.                   above.)
  3990.  
  3991.                   Some Practical Peripheral's (PPI) modems do not
  3992.                   respond to the escape code sent by BBSX at the end
  3993.                   of a call and, consequently, cannot hang up the
  3994.                   phone.  Practical Peripherals acknowledged a bug in
  3995.                   PPI EPROM versions 1.04 and earlier is at the root
  3996.                   of this problem.  Owners of PPI modems can call PPI
  3997.                   Tech Support at 1-818-706-2474 and request a free
  3998.                   EPROM upgrade.  We thank PPI for their outstanding
  3999.                   support.
  4000.  
  4001.               3.  SYSTEM HANGS DURING DROPS TO DOS
  4002.  
  4003.                   The DOS.BAT file is not configured correctly (see
  4004.                   Step 7, the "Editing the DOS.BAT file" section,
  4005.                   above).
  4006.  
  4007.                   Confirm there is enough free RAM to run COMMAND.COM
  4008.                   after BBSX has loaded.
  4009.  
  4010.                   Do not run programs within the DOS shell unless they
  4011.                   support redirection.  Programs supporting standard
  4012.                   DOS input and output (DOS commands and DOS programs,
  4013.                   like EDLIN) can be run through the COM ports.
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.                                                                         56
  4031.  
  4032.  
  4033.                   Some MS DOS releases feature a buggy CTTY command
  4034.                   that causes system lock-ups during redirected
  4035.                   backspacing.  Users of true-blue IBM PC DOS will not
  4036.                   encounter this bug.  If you experience difficulty
  4037.                   with the drop-to-DOS function, visit the Mother
  4038.                   Board BBS and download GAPCTY.ARC or GATEWAY.ARC.
  4039.                   Both files contain enhancements to the CTTY command
  4040.                   that resolve the bugs.
  4041.  
  4042.               4.  FILE TRANSFERS BOMB
  4043.  
  4044.                   The PROTOCOL.INI and/or FTX.BAT file configurations
  4045.                   are incorrect.  (See Step 4, the "Storing the
  4046.                   PROTOCOL.INI file" section and Step 8, the "Storing
  4047.                   the FTX.BAT file" section, above).
  4048.  
  4049.                   Confirm the FTX.BAT file and external file transfer
  4050.                   protocol drivers are stored in the BBSX subdirectory
  4051.                   or in a subdirectory specified by the DOS PATH
  4052.                   environment variable.
  4053.  
  4054.                   Confirm the external file transfer protocol drivers
  4055.                   are setting the correct ERRORLEVELs.
  4056.  
  4057.                   Confirm the FILES_PATH path names specified in
  4058.                   BBSX.INI or FILES.INI are considered legal by DOS
  4059.                   and actually exist.
  4060.  
  4061.                   Confirm the PROTOCOL_CODEs specified in BBSX.INI or
  4062.                   PROTOCOL.INI are correct.
  4063.  
  4064.                   If FTX.BAT has been edited, confirm the changes
  4065.                   conform with FTX.BAT's documented programming
  4066.                   conventions.
  4067.  
  4068.                   If all else fails, reinstall the original FTX.BAT
  4069.                   and PROTOCOL_CODEs provided with BBSX.
  4070.  
  4071.           ════════════════════════════
  4072.           ERROR CODES AND EXPLANATIONS
  4073.           ════════════════════════════
  4074.  
  4075.               1.  Endless loop error
  4076.  
  4077.                   See the explanation of LOOP ERROR, below.
  4078.  
  4079.               2.  Bad command or file name
  4080.  
  4081.                   BBSX was unable to launch a child process (like
  4082.                   DAILY.BAT, DOS.BAT or FTX.BAT).
  4083.  
  4084.                   Confirm the child process files are stored in the
  4085.                   BBSX subdirectory or in a subdirectory specified by
  4086.                   the DOS PATH environment variable.
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.                                                                         57
  4097.  
  4098.  
  4099.               3.  Bad FILES_PATH in BBSX.INI or FILES.INI
  4100.  
  4101.                   A FILES_PATH field in BBSX.INI or FILES.INI file
  4102.                   contains illegal characters or does not exist.
  4103.  
  4104.                   Double check the FILES_PATHs to confirm the path
  4105.                   names are considered legal by DOS and actually
  4106.                   exist.
  4107.  
  4108.               4.  Bad or outdated .HDR
  4109.  
  4110.                   BBSX encountered a corrupted or outdated .HDR file.
  4111.  
  4112.                   Delete the file and associated .MSG and .PTR files.
  4113.  
  4114.                   If DAILY.BAT is used, backups might be stored in the
  4115.                   BAK <DIR>.  Restore the files from the backups.
  4116.  
  4117.               5.  Bad or outdated USER.LOG
  4118.  
  4119.                   BBSX encountered a corrupted or outdated USER.LOG
  4120.                   file.
  4121.  
  4122.                   Delete the file and the associated INDEX.LOG.
  4123.  
  4124.                   If DAILY.BAT is used, backups might be stored in the
  4125.                   BAK <DIR>.  Restore the files from the backups.
  4126.  
  4127.               6.  BBSX.INI file not found
  4128.  
  4129.                   BBSX cannot find the BBSX.INI file in the BBSX
  4130.                   subdirectory.
  4131.  
  4132.                   The BBSX.INI file must be stored in the directory
  4133.                   specified by the BBS.BAT file.
  4134.  
  4135.               7.  Communication-buffer overflow
  4136.  
  4137.                   The communications receive buffer (1024 bytes)
  4138.                   overflowed.  Usually caused by an on-line user
  4139.                   leaning on the keyboard.
  4140.  
  4141.               8.  Device fault
  4142.                   Device timeout
  4143.                   Device unavailable
  4144.                   Disk media error
  4145.                   Disk not ready
  4146.  
  4147.                   Indicates a hardware configuration problem (like an
  4148.                   open disk drive door; bad, non-existent or
  4149.                   incorrectly specified device) or a hardware failure.
  4150.  
  4151.                   Check disk drive doors, printer switches, cables,
  4152.                   connections, and related hardware.
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.                                                                         58
  4163.  
  4164.  
  4165.               9.  Device I/O error
  4166.  
  4167.                   An unrecoverable I/O error occurred.  Usually caused
  4168.                   by an on-line user repeatedly striking ^ScrollLock,
  4169.                   sending extended break signals or leaning on the CR
  4170.                   key during autobaud (baud rate adjust).
  4171.  
  4172.                   If a modem is not 100% Hayes-compatible, the escape
  4173.                   code sent by BBSX may not be processed correctly,
  4174.                   possibly causing this error.
  4175.  
  4176.               10. Disk full
  4177.  
  4178.                   The disk is full.
  4179.  
  4180.                   Delete some non-BBSX related files and try again.
  4181.  
  4182.               11. Out of environment space
  4183.  
  4184.                   There is not enough DOS environment space available.
  4185.  
  4186.                   Increase environment space with the DOS "SHELL"
  4187.                   command.  See your DOS manual for information on the
  4188.                   SHELL command.
  4189.  
  4190.               12. Out of memory
  4191.                   Out of string space
  4192.  
  4193.                   BBSX needs more RAM than is available.
  4194.  
  4195.                   Unload TSRs (memory resident utilities like
  4196.                   "SideKick") or buy a RAM card to increase the amount
  4197.                   of on-board RAM.
  4198.  
  4199.               13. Out of paper
  4200.  
  4201.                   The printer is out of paper or the paper is jammed.
  4202.  
  4203.                   Add paper or clear the paper path.
  4204.  
  4205.               14. Path/File access error
  4206.                   Path not found
  4207.  
  4208.                   BBSX was unable to access a path specified in
  4209.                   BBSX.INI or FILES.INI file.
  4210.  
  4211.                   Review the BBSX.INI and FILES.INI files to confirm
  4212.                   that the specified paths exist on the hard disk and
  4213.                   the path names are syntactically correct.
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.                                                                         59
  4229.  
  4230.  
  4231.               15. Permission denied
  4232.  
  4233.                   An attempt was made to write to a write-protected
  4234.                   disk or to a locked file in a multi-user
  4235.                   environment.
  4236.  
  4237.               16. /SYSOP switch active
  4238.  
  4239.                   The /SYSOP start-up switch was used on the BBSX
  4240.                   command line.
  4241.  
  4242.                   Remove the /SYSOP switch from the command line.
  4243.  
  4244.               17. Too many files
  4245.  
  4246.                   BBSX was unable to open multiple files.
  4247.  
  4248.                   Try adding the following statement to the CONFIG.SYS
  4249.                   file:
  4250.  
  4251.                       FILES = 25
  4252.  
  4253.               18. Too many response lines allocated in [ *.POL ]
  4254.  
  4255.                   The allocated responses (input commands) in the .POL
  4256.                   file exceeds 999.
  4257.  
  4258.                   Reduce the number of allocated responses.  A maximum
  4259.                   of 999 response lines per .POL file is allowed.
  4260.  
  4261.               19. Loop error
  4262.  
  4263.                   See the explanation for ENDLESS LOOP ERROR, above.
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.                                                                         60
  4295.  
  4296.  
  4297.               ────────────
  4298.               FATAL ERRORS
  4299.               ────────────
  4300.  
  4301.               The following error messages should not occur.  If they do,
  4302.           they indicate an internal programming problem (read:  bug) within
  4303.           BBSX.  Contact us if any of these error messages are encountered
  4304.           more than once:
  4305.  
  4306.                   RETURN without GOSUB
  4307.                   Out of DATA
  4308.                   Illegal function call
  4309.                   Overflow
  4310.                   Subscript out of range
  4311.                   Division by zero
  4312.                   String formula too complex
  4313.                   No RESUME
  4314.                   RESUME without ERROR
  4315.                   CASE ELSE expected
  4316.                   Variable required
  4317.                   FIELD overflow
  4318.                   Internal error
  4319.                   Bad file name or number
  4320.                   File not found
  4321.                   Bad file mode
  4322.                   File already open
  4323.                   FIELD statement active
  4324.                   File already exists
  4325.                   Bad record length
  4326.                   Input past end of file
  4327.                   Bad record number
  4328.                   Bad file name
  4329.                   Advanced feature unavailable
  4330.                   Rename across disks
  4331.                   User record alias error
  4332.                   Inter-module communication error
  4333.                   Unassigned error
  4334.                   Total global thermonuclear war error
  4335.  
  4336.           ══════════════════════════════════════════════
  4337.           APPENDIX A - FILE TRANSFER TECHNICAL REFERENCE
  4338.           ══════════════════════════════════════════════
  4339.  
  4340.               ────────────────────────
  4341.               Editing the FTX.BAT file
  4342.               ────────────────────────
  4343.  
  4344.               The following information is provided for programmers only;
  4345.           to guarantee its correct operation, non-programmers should not
  4346.           edit FTX.BAT.
  4347.  
  4348.               BBSX does not support internal file transfer protocols.
  4349.           Instead, strong support for most external file transfer protocol
  4350.           drivers is provided.
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.                                                                         61
  4361.  
  4362.  
  4363.               Omen Technology's DSZ program is recommended for use with
  4364.           BBSX to support Xmodem (128 and 1k), Xmodem Over-thruster, Ymodem
  4365.           (128 and 1k), Ymodem Over-thruster, Zmodem and Zmodem
  4366.           Over-thruster, as well as mutant variations on these standard
  4367.           protocols.  We have been advised that Omen Technology's ZCOMM
  4368.           also supports these protocols, as well as Kermit, Sealink and
  4369.           others.
  4370.  
  4371.               Any manufacturer's protocol drivers can be used, as long as
  4372.           they support the standard command syntax and error reporting
  4373.           conventions as Omen Technology's DSZ and ZCOMM programs.
  4374.           Protocol drivers that do not generate a DOS "errorlevel"
  4375.           corresponding to the success or failure of a file transfer
  4376.           prevent programmers from testing conditions in FTX.BAT.
  4377.           
  4378.               BBSX sends the following information to FTX.BAT.  Programmers
  4379.           can configure support for almost any protocol driver.  If you are
  4380.           not an experienced batch file programmer, do not attempt to
  4381.           modify the parameter control code in FTX.BAT:
  4382.  
  4383.                   Parameter = Data sent by BBSX
  4384.                   ────────────────────────────────────────────────────
  4385.                   %1 = com port # (1 or 2)
  4386.                   %2 = baud rate (300, 1200, 2400, or 9600)
  4387.                   %3 = s = user download, r = user upload
  4388.                   %4 = protocol_code* selected by user
  4389.                   %5 = target [d:][path][filename.ext]
  4390.  
  4391.                   (*See the "Editing the PROTOCOL.INI file" section,
  4392.                   below.)
  4393.  
  4394.               The steps to add support for additional protocol drivers are:
  4395.  
  4396.               1.  Add the new PROTOCOL_NAMEs and PROTOCOL_CODEs* to
  4397.                   PROTOCOL.INI.
  4398.  
  4399.               2.  Add the conditional branch
  4400.  
  4401.                       if %4 == [PROTOCOL_CODEs] goto [labels]"
  4402.  
  4403.                   beneath FTX.BAT's "TOP" label.
  4404.  
  4405.               3.  Port the batch file code under the "DSZ" label to
  4406.                   suit the new application programs.
  4407.  
  4408.               The "if errorlevel" portion of the code tests for failed
  4409.           transfers.  The logic followed is:
  4410.  
  4411.                   if errorlevel = 1 (failure) then
  4412.                       delete the bbsx.tmp file**
  4413.                       exit
  4414.                   else
  4415.                       exit
  4416.                   end if
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.                                                                         62
  4427.  
  4428.  
  4429.               (*See the "Editing the PROTOCOL.INI file" section,
  4430.               below.)
  4431.  
  4432.               (**Because the Microsoft Professional BASIC Compiler
  4433.               [v.6.0] is unable to retrieve the errorlevel of a child
  4434.               process without extensive fiddling, BBSX.TMP is created
  4435.               by BBSX before file transfers; non-existence tells BBSX
  4436.               that the transfer failed.)
  4437.  
  4438.               Note that aborted uploads cause FTX.BAT to delete the
  4439.           incomplete file.
  4440.  
  4441.               FTX.BAT must be edited using an ASCII editor operating in
  4442.           non-document mode.
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.                                                                         63
  4493.  
  4494.  
  4495.               Load FTX.BAT into any ASCII editor.  The following text will
  4496.           be displayed:
  4497.  
  4498.                   echo off
  4499.                   goto top
  4500.                   
  4501.                   Rich Levin's BBSXpress (tm)
  4502.                   FTX.BAT
  4503.                   Copyright (c) 1988 Richard B. Levin
  4504.                   All Rights Reserved
  4505.                   
  4506.                   Revised January 10, 1989
  4507.                   
  4508.                   :top
  4509.                       if %4 == b goto dsz
  4510.                       if %4 == b-k goto dsz
  4511.                       if %4 == x goto dsz
  4512.                       if %4 == x-k goto dsz
  4513.                       if %4 == z goto dsz
  4514.                       goto s_err
  4515.                   
  4516.                   :dsz
  4517.                       if %3 == r goto dsz_r
  4518.                       if %3 == s goto dsz_s
  4519.                       goto xit
  4520.                           
  4521.                           :dsz_r
  4522.                               dsz port %1 speed %2 r%4 %5
  4523.                               if errorlevel 1 goto r_err
  4524.                               if not exist %5 goto r_err
  4525.                               goto xit
  4526.                   
  4527.                           :dsz_s
  4528.                               dsz port %1 speed %2 s%4 %5
  4529.                               if errorlevel 1 goto s_err
  4530.                               goto xit
  4531.                   
  4532.                   :r_err
  4533.                       rem failed receive attempts branch here
  4534.                       rem change del %5 to ren %5 to save aborted uploads
  4535.                       if exist %5 del %5
  4536.                       if exist bbsx.tmp del bbsx.tmp
  4537.                       goto xit
  4538.                   
  4539.                   :s_err
  4540.                       rem failed send attempts branch here
  4541.                       if exist bbsx.tmp del bbsx.tmp
  4542.                       goto xit
  4543.                   
  4544.                   :xit
  4545.                       if exist *.$$$ del *.$$$
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.                                                                         64
  4559.  
  4560.  
  4561.               ─────────────────────────────
  4562.               Editing the PROTOCOL.INI file
  4563.               ─────────────────────────────
  4564.  
  4565.               PROTOCOL.INI must be edited using an ASCII editor operating
  4566.           in "non-document" mode.
  4567.  
  4568.               Load PROTOCOL.INI into any ASCII editor.  The following text
  4569.           will be displayed:
  4570.  
  4571.                   ~ Rich Levin's BBSXpress (tm)
  4572.                   ~ PROTOCOL.INI
  4573.                   ~ Copyright (c) 1988 Richard B. Levin
  4574.                   ~ All Rights Reserved
  4575.                   ~
  4576.                   ~ Revised January 10, 1989
  4577.                   ~
  4578.                   ~ Precede comments with a tilde.
  4579.                   ~ Delete comments to optimize this file.
  4580.                   ~
  4581.                   PROTOCOL_NAME=Xmodem 128
  4582.                   PROTOCOL_CODE=x
  4583.                   PROTOCOL_NAME=Xmodem 1k
  4584.                   PROTOCOL_CODE=x-k
  4585.                   PROTOCOL_NAME=Ymodem 128
  4586.                   PROTOCOL_CODE=b
  4587.                   PROTOCOL_NAME=Ymodem 1k
  4588.                   PROTOCOL_CODE=b-k
  4589.                   PROTOCOL_NAME=Zmodem
  4590.                   PROTOCOL_CODE=z
  4591.                   END_OF_PROTOCOLS=Y
  4592.  
  4593.               Edit each field to reflect your configuration requirements:
  4594.  
  4595.               1.  ~ Rich Levin's BBSXpress (tm)
  4596.  
  4597.                   A comment.  Text preceded by a tilde character is
  4598.                   ignored by BBSX.
  4599.  
  4600.               2.  PROTOCOL_NAME=
  4601.  
  4602.                   The name of a file transfer protocol.  50 characters
  4603.                   maximum.  Control characters and high-bit ASCII are
  4604.                   accepted.
  4605.  
  4606.                   Every PROTOCOL_NAME must be followed by a
  4607.                   PROTOCOL_CODE.
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.                                                                         65
  4625.  
  4626.  
  4627.               3.  PROTOCOL_CODE=
  4628.  
  4629.                   The protocol identification command parameter sent
  4630.                   by BBSX to FTX.BAT (see the "Editing the FTX.BAT
  4631.                   file" section, above).  9 characters maximum.
  4632.  
  4633.                   Every PROTOCOL_CODE must be preceded by a
  4634.                   PROTOCOL_NAME.
  4635.  
  4636.                   Important:  Do not use spaces in the PROTOCOL_CODE
  4637.                               field; they prevent BBSX from supplying
  4638.                               drive, path, and filename data to
  4639.                               FTX.BAT.
  4640.  
  4641.               4.  END_OF_PROTOCOLS=Y
  4642.  
  4643.                   An end-of-data (EOD) flag.  Must be the last entry
  4644.                   in PROTOCOL.INI.  BBSX stops searching for PROTOCOL_
  4645.                   fields when this field is encountered.
  4646.  
  4647.                   This EOD flag also allows users to optionally merge
  4648.                   PROTOCOL.INI into BBSX.INI, providing a central
  4649.                   initialization file.  If PROTOCOL_ fields are merged
  4650.                   into BBSX.INI, the PROTOCOL.INI file is not used;
  4651.                   however, BBSX performs better when PROTOCOL.INI and
  4652.                   BBSX.INI are not merged.
  4653.  
  4654.           ══════════════════════════════════════
  4655.           APPENDIX B - TCD.COM COMMAND REFERENCE
  4656.           ══════════════════════════════════════
  4657.  
  4658.               TCD ("The Carrier Detective") is a utility used to re-boot an
  4659.           IBM-compatible computer when DCD (Data Carrier Detect) is lost.
  4660.  
  4661.               TCD is used in batch files called by telecommunication hosts
  4662.           before and after providing remote users access to DOS.
  4663.  
  4664.               Once activated, TCD continuously monitors the status of DCD.
  4665.           If DCD is lost, TCD re-boots the host computer.  The host
  4666.           completes a POST (power-on self-test) and processes CONFIG.SYS
  4667.           and AUTOEXEC.BAT files.  The last command in AUTOEXEC.BAT should
  4668.           be one to restart the host.
  4669.  
  4670.               If DCD is not lost, TCD is toggled off by the batch files
  4671.           after users exit DOS level.
  4672.  
  4673.               Using TCD in this manner prevents hosts from sitting idle at
  4674.           DOS-level, allowing unauthorized users unrestricted access when
  4675.           carrier is dropped.
  4676.  
  4677.               TCD is often used by bulletin board system's external "doors"
  4678.           programs, file transfer protocols, and "drops-to-DOS."  It can
  4679.           also be used by telecommunication programs providing remote DOS
  4680.           access.
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.                                                                         66
  4691.  
  4692.  
  4693.               ────────────────────────────
  4694.               COMMAND LINE ARGUMENT SYNTAX
  4695.               ────────────────────────────
  4696.  
  4697.           Launch syntax is
  4698.  
  4699.               TCD COM[1|2|3|4] [ON|OFF] [Q] [?|H]
  4700.  
  4701.           Where:
  4702.  
  4703.           PARAMETER = DESCRIPTION
  4704.           ─────────────────────────────────────────────────────────────────
  4705.           COM#        Serial communications port assignment, where "#"
  4706.                       represents the RS232C channel number used for
  4707.                       remote access.
  4708.  
  4709.           ON or OFF   ON installs and activates TCD.  OFF deactivates
  4710.                       and uninstalls TCD.
  4711.  
  4712.           Q           Quiet mode.  Suppresses messages from TCD.
  4713.                       Ignored if an error occurs.
  4714.  
  4715.           ? or H      Help command.  Displays program information.
  4716.  
  4717.               The first two parameters (COM# and ON|OFF) are required for
  4718.           proper operation of TCD.
  4719.  
  4720.               ──────────────────────────────────
  4721.               EXAMPLES OF COMMAND LINE ARGUMENTS
  4722.               ──────────────────────────────────
  4723.  
  4724.           TCD             Displays TCD syntax
  4725.  
  4726.           TCD /COM1 /ON   Loads and activates TCD monitoring of COM1
  4727.           TCD /COM1 /OFF  Unloads and deactivates TCD monitoring of COM1
  4728.  
  4729.           TCD /COM2 /ON   Loads and activates TCD monitoring of COM2
  4730.           TCD /COM2 /OFF  Unloads and deactivates TCD monitoring of COM2
  4731.  
  4732.           TCD /COM3 /ON   Loads and activates TCD monitoring of COM3
  4733.           TCD /COM3 /OFF  Unloads and deactivates TCD monitoring of COM3
  4734.  
  4735.           TCD /COM4 /ON   Loads and activates TCD monitoring of COM4
  4736.           TCD /COM4 /OFF  Unloads and deactivates TCD monitoring of COM4
  4737.  
  4738.           TCD /H          Displays TCD program information
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.                                                                         67
  4757.  
  4758.  
  4759.                     This document was created using Microsoft WORD v.4.0
  4760.  
  4761.                                      - End of BBSX.DOC -
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.