home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CEL202R.ZIP / CEL202-3.ZIP / CELERITY.DOC next >
Text File  |  1994-08-29  |  360KB  |  10,123 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                              C E L E R I T Y  B B S
  22.  
  23.                                   Version 2.02
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                         Copyright 1990, 1992, 1993, 1994
  39.  
  40.  
  41.                          All rights reserved worldwide
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.                    Written by Brendon Woirhaye and Dave Hicks
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Legal "Stuff"
  61. =============
  62.  
  63.  
  64. CELERITY SHAREWARE SOFTWARE LICENSE
  65. -----------------------------------
  66.  
  67. *****     This version of CELERITY is neither public domain *****
  68. *****     nor is it free software, but is being distributed *****
  69. *****     as "shareware" for EVALUATION PURPOSES ONLY.      *****
  70.  
  71.  
  72. Copyright, Proprietary Rights
  73. -----------------------------
  74.  
  75. The CELERITY software and documentation is owned by Brendon
  76. Woirhaye and Dave Hicks. It is protected by United States copyright
  77. laws and international treaty provisions. You may not reverse
  78. engineer, decompile, disassemble, or create derivative works based
  79. on the software for any purpose. This software embodies valuable
  80. trade secrets proprietary to the authors; you may not disclose any
  81. information regarding the internal operations of this software to
  82. others.
  83.  
  84.  
  85. Usage Restrictions
  86. ------------------
  87.  
  88. The Authors grant a limited license to individuals to use this
  89. shareware software for a 30-day evaluation period for the express
  90. purpose of determining whether Celerity is suitable for their
  91. needs. At the end of this 30-day evaluation period, the individual
  92. must either purchase a license and receive a validation key for
  93. continued use of the program, or discontinue using Celerity.
  94.  
  95. Archival copies of the Celerity validation key may be made by the
  96. owner of a Celerity license for his personal use and protection
  97. only. In no circumstances is a sysop to give his Validation key to
  98. someone else. If the sysop does release his validation key, he will
  99. lose all rights to support and future updates of Celerity.
  100.  
  101. What does this mean? If you use this program on a continued basis,
  102. you must purchase a license for its use. Celerity is NOT free, and
  103. we are not giving away free copies. We are giving you the
  104. opportunity to try it before paying for a license for continued
  105. use. It is that simple. Try it. Then either pay for it, or quit
  106. using it.
  107.  
  108. Paying for a license to continue using the software product is not
  109. only required, but also allows the authors to provide support and
  110. updates, and stay in business. Licensed users receive technical
  111. support (by a support BBS), and makes them eligible for substantial
  112. discounts on future versions.
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Purchasing a license for Celerity entitles you to use the program
  119. on only one computer system. (Multiple computers, networked to
  120. support multi-node operation are considered as one computer
  121. system). If you would like a site license, please contact the
  122. authors for details.
  123.  
  124.  
  125.  
  126.  
  127.  
  128. Distribution, Copying Restrictions
  129. ----------------------------------
  130.  
  131. Individuals are granted a limited license to copy the shareware version 
  132. of Celerity only for the trial use of other individuals and subject to 
  133. the above limitations. This license DOES NOT include distribution or 
  134. copying of this software package:
  135.  
  136.      1: In connection with any other product or service;
  137.      2: For general use within a company, institution, or agency;
  138.      3: For any consideration or 'disk fee'; or
  139.      4: In modified form (i.e., any distribution that does not include 
  140.      ALL FILES supplied with the shareware version WITHOUT ALTERATION. 
  141.      This also prohibits distribution of all or portions of the 
  142.      documentation in printed form.)
  143.  
  144. Operators of electronic bulletin board systems (Sysops) are permitted 
  145. and encouraged to support the ShareWare concept and post the shareware 
  146. version of Celerity for downloading by their users, as long as the 
  147. above conditions are met.  Though a fee may be charged for BBS access, 
  148. NO FEE may be charged to specifically access or download the Celerity
  149. shareware files.
  150.  
  151. Non-profit computer-related User Groups may distribute the
  152. shareware version of Celerity provided the above conditions are
  153. met. However, such User Groups MAY charge a NOMINAL fee (not to
  154. exceed $5.00 US) to cover the cost of the disk and copying of the
  155. software.
  156.  
  157. Disk vendors MUST obtain written permission from the authors before
  158. distributing the shareware version of Celerity. Certain
  159. restrictions apply.
  160.  
  161.  
  162. Warranty Disclaimer
  163. -------------------
  164.  
  165. THE AUTHORS PROVIDE THE SHAREWARE VERSION OF CELERITY "AS IS" AND
  166. WITHOUT ANY WARRANTY. TO THE EXTENT PERMITTED UNDER APPLICABLE LAW,
  167. THE AUTHORS DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  168. BUT NOT LIMITED TO, ANY IMPLIED WARRANTY OF MERCHANTABILITY OR
  169. FITNESS FOR A PARTICULAR PURPOSE. SPECIFICALLY, THE AUTHORS MAKE NO
  170. REPRESENTATION OR WARRANTY THAT THE SOFTWARE IS FIT FOR ANY
  171. PARTICULAR PURPOSE.
  172. THE AUTHORS SHALL NOT BE LIABLE FOR ANY DAMAGES RESULTING FROM THE
  173. USE OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, LOSS OF PROFIT,
  174. DATA OR USE OF THE SOFTWARE, OR SPECIAL, INCIDENTAL OR
  175. CONSEQUENTIAL DAMAGES OR OTHER SIMILAR CLAIMS, EVEN IF THE AUTHORS
  176. HAVE BEEN SPECIFICALLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  177. SOME STATES DO NOT ALLOW THE EXCLUSION OF INCIDENTAL OR
  178. CONSEQUENTIAL DAMAGES, SO THE FOREGOING LIMITATION MAY NOT APPLY.
  179.  
  180.  
  181.  
  182.  
  183.  
  184. US GOVERNMENT RESTRICTED RIGHTS
  185. -------------------------------
  186.  
  187. This software and documentation are provided with RESTRICTED
  188. RIGHTS. Use, duplication or disclosure by the U.S. Government is
  189. subject to restrictions as set forth in subparagraph (c)(1)(ii) of
  190. the Rights in Technical Data and Computer Software clause at
  191. 252.227-7013. Ordering Information
  192.  
  193. Purchasing a license for Celerity allows you to use the product on
  194. a regular and/or continuing basis. Registration of your licensed
  195. copy of Celerity entitles you to technical support from the authors
  196. BBS, discounts on updates, and access to the Registered Sysop area
  197. of our support BBSes
  198.  
  199. With your purchase, you will receive your Validation key, tailored
  200. for your particular BBS.
  201.  
  202.  
  203. Ordering Information
  204. --------------------
  205.  
  206. For further information and current pricing, please see
  207. REGISTER.DOC.
  208.  
  209. We offer discounts to educational institutions, US government
  210. agencies, and various approved computer-related User Groups.
  211. Contact us for details.
  212.  
  213.  
  214. Site Licenses and Quantity Purchases:
  215. -------------------------------------
  216.  
  217. All corporate, business, government or other commercial, public, or
  218. private users of Celerity must be licensed. We offer quantity
  219. discounts as well as site licensing. Please call or write for more
  220. information. Please see SITELICN.DOC for details
  221.  
  222.  
  223. Orders Outside the U.S./Canada/Mexico:
  224. --------------------------------------
  225.  
  226. Please send a check drawn on a US bank payable in US dollars.
  227. Please add $10 for each copy to cover overseas shipping.
  228.  
  229.  
  230.  
  231.  
  232.  
  233. Table of Contents:
  234. ------------------
  235.  
  236.  
  237. Legal "Stuff"  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   2
  238.      CELERITY SHAREWARE SOFTWARE LICENSE  .  .  .  .  .  .  .  .  .  .  .  .   2
  239.      Copyright, Proprietary Rights  .  .  .  .  .  .  .  .  .  .  .  .  .  .   2
  240.      Usage Restrictions .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   2
  241.      Distribution, Copying Restrictions.  .  .  .  .  .  .  .  .  .  .  .  .   4
  242.      Warranty Disclaimer.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   4
  243.      US GOVERNMENT RESTRICTED RIGHTS.  .  .  .  .  .  .  .  .  .  .  .  .  .   5
  244.      Ordering Information  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   5
  245.           Site Licenses and Quantity Purchases: .  .  .  .  .  .  .  .  .  .   5
  246.           Orders Outside the U.S./Canada/Mexico:.  .  .  .  .  .  .  .  .  .   5
  247.  
  248. Section 1: What Is Celerity?  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                1 
  249.      General Description.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                1 
  250.      List of features:  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                1 
  251.      Hardware Requirements .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                6 
  252.      Required Extras .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                6 
  253.  
  254. Section 2: Setting Up Celerity.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                7 
  255.      Initial Setup.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                7 
  256.      Preparation  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                8 
  257.      Demo Installation  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                8 
  258.      Registering Celerity  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                9 
  259.      New System Installation  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .                                                                                9 
  260.      Upgrading .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    11 
  261.           Upgrading from Celerity BBS v1.42 or Alacrity v1.42: .  .  .  .    11 
  262.           Upgrading from Celerity BBS v2.00 or 2.01.  .  .  .  .  .  .  .    12 
  263.      Running CELSETUP.EXE  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    13 
  264.           System Info.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    14 
  265.           System Options.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    14 
  266.           Look and Feel Settings .  .  .  .  .  .  .  .  .  .  .  .  .  .    17 
  267.           Serial Port Setup.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    19 
  268.           Modem Setup.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    20 
  269.                Custom Modem Strings .  .  .  .  .  .  .  .  .  .  .  .  .    23 
  270.           Video Options .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    24 
  271.           Login Sequence.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    25 
  272.           Transfer Options .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    27 
  273.           Color Settings.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    31 
  274.           Pathnames  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    32 
  275.           Multinode Options.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    35 
  276.           Chat Options  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    36 
  277.           System Passwords .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    37 
  278.           Timed Events  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    38 
  279.           Access Levels .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    39 
  280.           Login Shell.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    41 
  281.           Login Commands.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    43 
  282.           Information Scripts .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    44 
  283.           New User Options .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    45 
  284.           User Ratios.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    50 
  285.           Access Templates .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    51 
  286.           Quick Validation Templates.  .  .  .  .  .  .  .  .  .  .  .  .    52 
  287.  
  288.  
  289.  
  290.  
  291.  
  292.      Running Multiple Bulletin Board Systems .  .  .  .  .  .  .  .  .  .    54 
  293.      Multi-node Operation  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    56 
  294.           Celerity Under DesqView.  .  .  .  .  .  .  .  .  .  .  .  .  .    59 
  295.                Standard Options  .  .  .  .  .  .  .  .  .  .  .  .  .  .    59 
  296.                Advanced Options  .  .  .  .  .  .  .  .  .  .  .  .  .  .    60 
  297.           Celerity under Windows .  .  .  .  .  .  .  .  .  .  .  .  .  .    62 
  298.           Celerity under Windows 4.0 "Chicago"  .  .  .  .  .  .  .  .  .    65 
  299.           Celerity under OS/2 .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    66 
  300.                Setting up your Celerity DOS Session under OS/2 .  .  .  .    67 
  301.                Setting up your Celerity OS/2 Session under OS/2.  .  .  .    68 
  302.                Setting up your OS/2 CONFIG.SYS for running Celerity  .  .    69 
  303.           Celerity under a Local Area Network.  .  .  .  .  .  .  .  .  .    71 
  304.      Running Celerity from a RAMdisk.  .  .  .  .  .  .  .  .  .  .  .  .    72 
  305.      Modes of Operation .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    74 
  306.           CAE Mode.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    74 
  307.           CAE/TAC Mode  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    75 
  308.      MAIN.BAT Operational Details.  .  .  .  .  .  .  .  .  .  .  .  .  .    77 
  309.           Command Line Parameters.  .  .  .  .  .  .  .  .  .  .  .  .  .    77 
  310.           Running MAIN.BAT For The First Time.  .  .  .  .  .  .  .  .  .    77 
  311.      Celerity Access Conditions  .  .  .  .  .  .  .  .  .  .  .  .  .  .    79 
  312.      Celerity Conference System  .  .  .  .  .  .  .  .  .  .  .  .  .  .    81 
  313.           Conference Structure.  .  .  .  .  .  .  .  .  .  .  .  .  .  .    81 
  314.           Creating Conference Trees .  .  .  .  .  .  .  .  .  .  .  .  .    85 
  315.      Creating Message Sub-Boards .  .  .  .  .  .  .  .  .  .  .  .  .  .    87 
  316.           FidoNet Conferencing.  .  .  .  .  .  .  .  .  .  .  .  .  .  .    89 
  317.           Using QWK Offline Readers .  .  .  .  .  .  .  .  .  .  .  .  .    89 
  318.      Setting Up A Transfer Section  .  .  .  .  .  .  .  .  .  .  .  .  .    90 
  319.           Creating Transfer File Areas .  .  .  .  .  .  .  .  .  .  .  .    90 
  320.      Setting Up Doors.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    92 
  321.           Door Example  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    93 
  322.  
  323. Section 3: BBS Operations  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    94 
  324.      Wait For Calls Screen .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    94 
  325.      Online Commands .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    97 
  326.      Inside the BBS  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    98 
  327.  
  328. Section 4: Customizing Celerity  .  .  .  .  .  .  .  .  .  .  .  .  .  .    99 
  329.      Introduction .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    99 
  330.      Color Codes  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .    99 
  331.      The CelerityText Display System.  .  .  .  .  .  .  .  .  .  .  .  .   101 
  332.           What is CelerityText?  .  .  .  .  .  .  .  .  .  .  .  .  .  .   101 
  333.           Editing CelerityText files.  .  .  .  .  .  .  .  .  .  .  .  .   102 
  334.           Command Directives  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   103 
  335.      Information Scripts.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   108 
  336.           The Infoscript Display File  .  .  .  .  .  .  .  .  .  .  .  .   108 
  337.           The Infoscript Answer File.  .  .  .  .  .  .  .  .  .  .  .  .   109 
  338.           Infoscript Command File.  .  .  .  .  .  .  .  .  .  .  .  .  .   109 
  339.      Customizing Text Files.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   118 
  340.      Customizing Console Commands.  .  .  .  .  .  .  .  .  .  .  .  .  .   119 
  341.           How to Customize the Keyboard.  .  .  .  .  .  .  .  .  .  .  .   119 
  342.           Internally Supported Commands.  .  .  .  .  .  .  .  .  .  .  .   120 
  343.      Online Tools .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   123 
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350. Section 5: Strategies for Running a Good Board  .  .  .  .  .  .  .  .  .   125 
  351.      Introduction .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   125 
  352.      Policies  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   125 
  353.           Local callers .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   125 
  354.           Slow Callers  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   126 
  355.           Access requirements .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   127 
  356.           Rules of Conduct .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   127 
  357.           Voice Validation .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   127 
  358.           Access Levels .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   128 
  359.           Advertising.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   128 
  360.  
  361. Appendices  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   130 
  362.      Appendix A, Serial I/O Chips.  .  .  .  .  .  .  .  .  .  .  .  .  .   130 
  363.      Appendix B: An Introductory Lesson in High-Speed Modems.  .  .  .  .   133 
  364.           A Modem Story .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   133 
  365.           What makes two modems compatible?  .  .  .  .  .  .  .  .  .  .   133 
  366.                CCITT and ITU: International Standards .  .  .  .  .  .  .   134 
  367.                Baud and bps: Are they the same? .  .  .  .  .  .  .  .  .   134 
  368.           Data Transmission Protocols ("Speed") .  .  .  .  .  .  .  .  .   135 
  369.           Error Correction and Data Compression Protocols.  .  .  .  .  .   141 
  370.           Other error correction and data compression protocols.  .  .  .   143 
  371.           Summing Up Modems.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   145 
  372.      Appendix C: Index Of Files Used By Celerity BBS  .  .  .  .  .  .  .   146 
  373.           Conference Directory:  .  .  .  .  .  .  .  .  .  .  .  .  .  .   146 
  374.           Multinode Directory:.  .  .  .  .  .  .  .  .  .  .  .  .  .  .   148 
  375.           Electronic Mail Directory:.  .  .  .  .  .  .  .  .  .  .  .  .   149 
  376.           Language Directory: .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   150 
  377.           Data Directory:  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   151 
  378.           Node Directory:  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   153 
  379.           Main BBS Directory: .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   155 
  380.           Display Directory:  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   156 
  381.      Appendix D: References.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   159 
  382.  
  383. Trademark Information.  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   162 
  384.  
  385. Credits and Acknowledgements  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   163 
  386.  
  387. AFTERWORD: The Tao of BBSing  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   165 
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                 -= Celerity v2.0 Operations Manual =-
  394.   -----------------------------------------------------------------
  395.  
  396. Section 1: What Is Celerity?
  397. ============================
  398.  
  399. General Description
  400. -------------------
  401.  
  402. Celerity is a BBS which attempts to combine:
  403.      1. The best features of other BBS software.
  404.      2. The newest innovations in BBS technology.
  405.      3. New and original concepts.
  406.      4. Seamless integration of highly configurable options.
  407.  
  408. Various utilities exist for celerity, and more are released every day by both
  409. members of the celerity project and 3rd party programmers. As they are finished
  410. and declared bug "Free" they are distributed on the Celerity Support BBS and
  411. other sites around the world.
  412.  
  413.  
  414. List of features:
  415. -----------------
  416.  
  417. (> Celerity is capable of hosting a wide array of message and transfer areas.
  418.  
  419. (> Celerity supports unlimited message conferences.
  420.  
  421. (> Celerity supports unlimited transfer conferences, with up to 999 sub-areas in
  422. each conference.
  423.  
  424. (> In conjunction with CelToScn (freeware utility) and a front-end mailer,
  425. Celerity can participate in any Fido technology network.
  426.  
  427. (> Celerity is optimized for speed.
  428.  
  429. (> It takes advantage of 286 / 386 / 486 / Pentium(586) processors (if present)
  430. for quick memory access.
  431.  
  432. (> It fully supports the 1655x class of buffered UARTs (SIO chips) for greater
  433. efficiency.
  434.  
  435. (> Celerity is designed with high speed modems in mind.  Particular support has
  436. been given to 9600, 14,400, 16,800, and 19,200, 21,600, 24,000, and 28,800 bps
  437. modems.
  438.  
  439. (> True high-speed DTE rates from 19200 to 115200 bps. Get the maximum
  440. performance your modem and serial card can handle.
  441.  
  442. (> Complete support for v.42, v.42bis, v.32, v.32bis, v.32Ter, v.Fast, v.FC,
  443. v.34, HST, PEP, TPEP, and MNP Modems.
  444.  
  445.   -----------------------------------------------------------------
  446.     Celerity v2.0                                         Page 1
  447.  
  448.  
  449.  
  450.  
  451.  
  452.                 -= Celerity v2.0 Operations Manual =-
  453.   -----------------------------------------------------------------
  454.  
  455. (> FAT file move for incredible file management speed.
  456.  
  457. (> ANSI/Avatar/VT100 display enhancement.
  458.  
  459. (> Internal ANSI driver to end reliance on slow DOS ANSI drivers which other
  460. many other BBS programs use. - Full support of Avatar/0+ specification,
  461. including character repetition, cursor positioning, and color support.
  462.  
  463. (> Scrollback for the local console which saves the entire session.
  464.  
  465. (> Translation of ANSI display screens to Avatar for improved speed. Ability to
  466. disable color for even greater speed.
  467.  
  468. (> Communications support for the North American Presentation Level Protocol
  469. Syntax (NAPLPS) graphics standard (ANSI X3.110-1983) for menus and displays.
  470.  
  471. (> Communications support for the Remote Imaging Protocol (RIP) graphics
  472. standard designed by TeleGraphix Communications, Inc.
  473.  
  474. (> Users can be given or denied access to any of the transfer or message
  475. conferences. Access rights can be granted to any area based on Sysop selected
  476. attributes (Such as transfer level, age, sex, bps rate, node, etc..(32 sysop
  477. flags and 32 user flags in all!) Access can be given to all new users, as users
  478. are quick-validated, or manually at any time thereafter.
  479.  
  480. (> User template system allowing the sysop to set up a template to control
  481. specific access level ranges.
  482.  
  483. (> Quick validation templates allow a sysop to give a user any set of access
  484. details at the press of one or two keys, rather than setting each option
  485. individually.
  486.  
  487. (> With menu scripting, access can be further distinguished on the basis of age,
  488. bps rate, transfer/message conference flags, sysop access flags, security level,
  489. transfer level, and more.
  490.  
  491. (> New users can be "Quick Validated" with one keystroke. No need to edit each
  492. access flag unless you desire to.
  493.  
  494. (> Fully automated new user voting (NUV) section, to allow your 
  495. users to decide who gets access and who doesn't. The sysop has veto power, of
  496. course.
  497.  
  498. (> New user voting section can be completely automated, at the sysop's
  499. discretion.
  500.  
  501.  
  502.  
  503.  
  504.   -----------------------------------------------------------------
  505.     Celerity v2.0                                         Page 2
  506.  
  507.  
  508.  
  509.  
  510.  
  511.                 -= Celerity v2.0 Operations Manual =-
  512.   -----------------------------------------------------------------
  513.  
  514. (> New users can be required to upload an example of their newest software, for
  515. examination by sysop and new user voting committee.  Complete user editing
  516. available while the user is online.
  517.  
  518. (> "Suggested Point Value" to make file validation easy.
  519.  
  520. (> Automatic Archive commenting if desired.
  521.  
  522. (> An internal upload processor which can:
  523.      1: Comment archives
  524.      2: Clean archives (Delete ads)
  525.      3: Verify archives
  526.      4: Scan for viruses
  527.      5: Import file_id.diz and desc.sdi descriptions
  528.  
  529. (> An optional freeware Upload Spooler (UPSPOOL) which can perform all the
  530. functions of the upload processor in the background or after a caller hangs up,
  531. so the user does not have to wait for his upload to be processed before
  532. continuing BBS use.
  533.  
  534. (> An optional freeware remote access utility (REMOTE.EXE) which allows a remote
  535. sysop to drop to DOS and run nearly any      character-based application as if
  536. he was at the BBS console.
  537.  
  538. (> Auto-Validate allows the sysop to have all uploads either automatically
  539. cleared for downloading as soon as they are uploaded or held for manual release
  540. by the SYSOP.  
  541.  
  542. (> Easy-to-use setup program.
  543.  
  544. (> A multitude of sysop-configurable options.
  545.  
  546. (> Celerity is one of the most fully configurable BBS programs available on the
  547. market today, despite its low cost.
  548.  
  549. (> Fully configurable logon shell. Shell commands can be added and removed as
  550. the sysop desires, and each command is fully configurable. The shell can exist
  551. as either a conventional menu-type shell, a DOS simulator shell, a UNIX
  552. simulator, VMS simulator, an interactive lightbar shell, or even an external
  553. sysop-developed shell. The shells are optional, of course, and can be disabled.
  554.  
  555. (> CelerityText files.  Virtually all of the text in Celerity v2.0 is contained
  556. in external CelerityText language files which can be easily edited by the sysop
  557. to tailor the text to his or her BBS. Anything from simple text changes to a
  558. completely new motif can be designed.  Multiple CelerityText files can be used
  559. at once on a BBS, allowing users to choose a motif or language of their
  560. preference, and multiple CelerityText files will be available on the support
  561. BBSes.  CelerityText language files support an extensive list of command
  562.  
  563.   -----------------------------------------------------------------
  564.     Celerity v2.0                                         Page 3
  565.  
  566.  
  567.  
  568.  
  569.  
  570.                 -= Celerity v2.0 Operations Manual =-
  571.   -----------------------------------------------------------------
  572.  
  573. directives allowing the language artist to insert information about the user,
  574. about the board, or context-sensitive details.  Celerity's CelerityText files
  575. are dynamic, and therefore the entries are not restricted to fixed-length data
  576. strings as most other software (PCBoard, Searchlight, WWIV, Remote Access,
  577. Telegard).  If you have need for it, a text entry can be many megabytes in
  578. length (for animated or graphical displays, perhaps).
  579.  
  580. (> Foreign Languages are fully supportable through the CelerityText files,
  581. translations are lined up for German, Spanish, Norwegian, Swedish, and Russian.
  582.  
  583. (> Fully configurable file listings. Each user can choose what file list
  584. information he or she desires.
  585.  
  586. (> Configurable menu scripting. Celerity allows the sysop to redefine which keys
  587. do what on any particular menu. Sysops can also change the command descriptions,
  588. access requirements (including access discrimination based on access levels,
  589. sysop access flags, age, bps rate, and more). Sysops can even delete commands to
  590. tailor the BBS to their own particular needs.
  591.  
  592. (> Configurable login sequence. The sysop can choose which events will be
  593. engaged for the user, and in which order they     will occur. Celerity's login
  594. is not limited to internal static events. The login sequence can display
  595. external files and even run external doors.
  596.  
  597. (> Celerity will support COM 1-4 with its standard internal drivers and
  598. selections, COM 0-8 as "configurable" ports with fully configurable addresses,
  599. interrupts, and IRQ's(Com Port 0 allows the BBS to be run in "Local only mode"),
  600. or COM 0-36 as DigiBoard ports. With any of the internal COM port selections, 
  601. the board will co-exist with a FOSSIL driver.
  602.  
  603. (> File commission system. If the sysop desires, users will get file points
  604. every time their upload is downloaded. You can even have it set up so a user
  605. gets NO points for uploading, and only gets points when people download his
  606. file. This way, users are not rewarded for uploading files that nobody wants,
  607. and users who upload good ones are well rewarded for their efforts.
  608.  
  609. (> CAE mode. Celerity once again brings a new revolution (or a very old one, if
  610. you were familiar with the old AE's and Catfurs in the Apple community years
  611. ago) to the PC modem world. 
  612.  
  613. (> Celerity is compatible with Fido EchoMail and QWK-compatible networks.
  614.  
  615. (> Celerity supports Multi-node operation.
  616.  
  617. (> Using network cards or a multitasking operating system, Celerity can support
  618. up to 250 sperate nodes.
  619.  
  620.  
  621.  
  622.   -----------------------------------------------------------------
  623.     Celerity v2.0                                         Page 4
  624.  
  625.  
  626.  
  627.  
  628.  
  629.                 -= Celerity v2.0 Operations Manual =-
  630.   -----------------------------------------------------------------
  631.  
  632. (> Celerity has been tested extensively under DesqView, DesqView/X, Windows 3.x,
  633. Windows 4.x (Chicago), and OS/2 for multiple nodes on a single machine. In
  634. addition, enhanced multitasking abilities including intelligent time slice
  635. management have been tested under DesqView, Windows, and OS/2.
  636.  
  637. (> Celerity works like a charm under Novell Netware, Netware Lite, and PowerLAN.
  638. Even under the fickle LanTastic, Celerity can run multiple nodes.
  639.  
  640. (> Fully functional multinode chat to allow users to talk to each other directly
  641. or split-screen chat supporting up to 8      simultaneous users with a self-
  642. adjusting display: 25 line users get 25 lines, 43 line users get 43, and 50 line
  643. users get 50.
  644.  
  645. (> EGA/VGA card support. Celerity has full support for a 43 line (EGA) or 50
  646. line (VGA) screen for the local display.
  647.  
  648. (> Sound Card Support.  Celerity can use sound cards to use much more extensive
  649. chat calls.  Celerity will even support a unique chat for each and every
  650. individual user.
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.   -----------------------------------------------------------------
  682.     Celerity v2.0                                         Page 5
  683.  
  684.  
  685.  
  686.  
  687.  
  688.                 -= Celerity v2.0 Operations Manual =-
  689.   -----------------------------------------------------------------
  690.  
  691. Hardware Requirements
  692. ---------------------
  693.  
  694. Celerity requires the following for operation:
  695.  
  696. (> IBM AT compatible computer (286 through Pentium)
  697.  
  698. (> Non-IBM compatible computer with MS-DOS emulation (NeXT/Macintosh/Windows
  699. NT/UNIX system with SoftPC) *no guaranty about functionality - try it*
  700.  
  701. (> XT support with the 8088/8086 supplement.
  702.  
  703. (> Hard disk drive with at least 5 megs free, 10+ recommended.  A large BBS
  704. should have hundreds of megabytes at its disposal.
  705.  
  706. (> Although some systems may run with as little as 320K, 640k RAM is recommended
  707. with AT LEAST 1024k EMS.  The more memory Celerity has available, the greater
  708. its performance will be.
  709.  
  710.  
  711. Required Extras
  712. ---------------
  713.  
  714. Celerity requires the use of a few other Shareware programs, or 
  715. their equivalent. These are listed below:
  716.  
  717. (> An archive utility. Celerity will allow the use of any of the standard
  718. Archive programs such as PKZIP, LHA, ARJ, PAK, DDD, ZOO, ARC, and Teledisk.
  719. These files can be obtained on most BBSes.
  720.  
  721. (> DSZ.COM (or a DSZ-compatible protocol) is required for basic upload/download
  722. transfers.  HS/Link is required for bidirectional transfers.
  723.  
  724. (> Q-Edit is the external editor of choice for Celerity, although any external
  725. text editor may be used with equal compatibility, such as DOS 6's EDIT, or even
  726. (GASP!) EDLIN.
  727.  
  728. (> For the ANSI editor, We recommend TheDraw, which is an excellent tool for the
  729. creation and editing of nice single page ANSI screens. For Multi-page designs,
  730. you might try "The Laughing Dog" utilities.
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.   -----------------------------------------------------------------
  741.     Celerity v2.0                                         Page 6
  742.  
  743.  
  744.  
  745.  
  746.  
  747.                 -= Celerity v2.0 Operations Manual =-
  748.   -----------------------------------------------------------------
  749.  
  750. Section 2: Setting Up Celerity
  751. ==============================
  752.  
  753. Sysops setting up Celerity for the first time should read this file IN ITS
  754. ENTIRETY, as they will find it answers a lot of their questions. The
  755. documentation file(s) give you all the needed information.
  756.  
  757. If you have run a BBS before, you will find that Celerity has it's own unique
  758. feel, but you should pick up the commands and structure quite easily.
  759.  
  760. If you have never run a BBS, I would recommend that you start out slowly.
  761. Celerity is highly automated and easy for an experienced sysop to run, but it is
  762. NOT a simple piece of software, and can cause great frustration to inexperienced
  763. sysops if they set up too much too soon.
  764.  
  765.  
  766. Initial Setup
  767. -------------
  768.  
  769. Celerity version 2.02 may be found in two distribution formats. The first is the
  770. preferred format called CEL202R.ZIP, and is designed for high speed electronic
  771. transfer or 1440k diskette distribution. The second distribution format consists
  772. of the five sub-archives included in CEL202R.ZIP, which are more appropriately
  773. sized for low-speed electronic transmission or 360k diskette distribution. The
  774. first format is simply a re-packaging of the second format archives. The main
  775. distribution archive consists of the following files:
  776.  
  777. CEL202-1.ZIP  :  Main Celerity BBS v2.00 Program Files.
  778. CEL202-2.ZIP  :  Support files including CELSETUP.EXE and
  779.                  CelerityText files.
  780. CEL202-3.ZIP  :  Celerity BBS v2.00 Documentation.
  781. CEL202-4.ZIP  :  Selected third-party utilities for Celerity v2.00.
  782. CEL202-5.ZIP  :  Additional files needed for Celerity BBS
  783.                  demonstration.
  784. INSTALL .EXE  :  Menu-driven installation program for Celerity
  785.                  BBS v2.02.
  786. File_ID .DIZ  :  Description for BBS importation.
  787. REGISTER.DOC  :  Celerity BBS Registration information.
  788. READ    .ME   :  Installation and distribution notes.
  789.  
  790. Celerity BBS releases, updates, utilities, CelerityText, etc. may be obtained
  791. from the Celerity BBS support system:
  792.  
  793. United States:                
  794. Terrapin Station              
  795. 310-693-9405                  
  796. 2400-21,600 bps HST/v.32b/v.32ter
  797.  
  798.  
  799.   -----------------------------------------------------------------
  800.     Celerity v2.0                                         Page 7
  801.  
  802.  
  803.  
  804.  
  805.  
  806.                 -= Celerity v2.0 Operations Manual =-
  807.   -----------------------------------------------------------------
  808.  
  809. Preparation
  810. -----------
  811.  
  812. Before you begin, you should locate the following programs and utilities (all
  813. are recommended but not essential):
  814.  
  815. PKZIP.EXE, PKUNZIP.EXE, ARJ.EXE, LHA.EXE, DSZ.COM/DSZ.EXE/GSZ.EXE, and HSlink.
  816. Place these files in your BBS directory (as specified in the celsetup program).
  817. If you do not have registered copies of these programs, please acquire copies
  818. from most any BBS and register them.
  819.  
  820.  
  821. Demo Installation
  822. -----------------
  823. Release versions of Celerity BBS are always packaged with a demonstration
  824. version so that perspective sysops can set up the software and get a feel for it
  825. before they buy. The only differences between a registered and a non-registered
  826. version are that a non-registered system has a nasty Nag screen system (The
  827. USERS see the Nag Screen!)
  828.  
  829. To install the demo, run INSTALL.EXE and select "Demo Install" from the menu.
  830. Installation of the demonstration version requires approximately two megabytes
  831. of free space. Select one of the menu sets from the list when prompted. At the
  832. current time, the demo can only be installed correctly to the C:\CELERITY path.
  833. If you install the demo to a path other than c:\celerity, you will have to
  834. change the pathnames in CELSETUP.EXE for the demo to function properly.
  835.  
  836. Once you have completed the installation, you should exit and switch to the demo
  837. directory. There, type "MAIN" to run the BBS. In a moment you should be
  838. presented with the wait for call (or WFC) screen. Pressing F10 will initiate a
  839. local log on. The demo initially has the lightbar logon shell selected, so you
  840. should now look through the available options (the arrow keys may be used to
  841. move from option to option, and [ENTER] to select) and choose the "Logon to
  842. Celerity Demo". 
  843.  
  844. After the introduction screen, type "Sysop" as the user name. After a moment, a
  845. prompt for your password will come up. Also appearing on the local screen will
  846. be a blow up box telling who the user is and what their password is - so you can
  847. tell easily what password to use. Type it in, and you are on the system!
  848.  
  849. The first time you logon with the new account, you will be prompted for your
  850. real name, birth date, age, sex, and phone number. You will then get to fill out
  851. an information script, and also asked for a permanent password.  It is vital
  852. that you select a password which nobody else knows (ie: do not use one you use
  853. on other bulletin boards) or one which is easy to guess (such as your phone
  854. number, any personal names, or any computer-related terms).  The best password
  855. would be a meaningless collection of letters, numbers, and punctuation. 
  856. Remember that your password will be displayed to you at the local console, so
  857.  
  858.   -----------------------------------------------------------------
  859.     Celerity v2.0                                         Page 8
  860.  
  861.  
  862.  
  863.  
  864.  
  865.                 -= Celerity v2.0 Operations Manual =-
  866.   -----------------------------------------------------------------
  867.  
  868. you are in no danger of being locked out of your system by losing your password. 
  869. Anyone who can log into the BBS with sysop access has the potential to cause
  870. great harm to your system, and there are people out there who thrive on such
  871. challenges, so don't tempt them with an easy-to-hack password.
  872.  
  873. Now you will be in the system proper. Feel free to move around and experiment.
  874. You will find some email waiting to be read, a few messages in the message
  875. section, some artwork and some files in the transfer area. Press Alt-H to get a
  876. list of local console commands  (see the section below on "Customizing Console
  877. Commands).  Any of these can be used while you or a user is online. The demo BBS
  878. is rather sparse, of course, because it lacks the activity and fullness of a
  879. completely set up system.
  880.  
  881. Once you become somewhat familiar with the options and various sections of the
  882. system, exit the software and run the CELSETUP.EXE utility, and begin modifying
  883. some of the options. Don't change too many things without first viewing their
  884. effects. Set up your serial and modem information in CELSETUP.EXE, and have a
  885. friend or two call your system to check it out. If you like what you see, re-run
  886. CELSETUP.EXE and fill out the registration form.
  887.  
  888. If you would like to see a high volume system running Celerity, feel free to
  889. call the Celerity support BBS at 310-693-9405 (2400 v.22, 9600-14.4kbps v.32,
  890. 9600-16.8kbps HST, 16.8k-21.6k v.32ter). First-time users can access most of the
  891. features which are enabled  on this BBS.
  892.  
  893.  
  894. Registering Celerity
  895. --------------------
  896. To run a registered copy of Celerity, you must obtain a Celerity registration
  897. key.  Read the REGISTER.DOC file packaged in the Celerity distribution archive
  898. for details on pricing and where to obtain this key from.
  899.  
  900. Once you obtain your CELERITY.KEY file, you should copy it to the Celerity BBS
  901. "node" directory.  You must have a copy of the key in the home directory for
  902. each node of the BBS.  Do not edit your CELERITY.KEY file, or it may not
  903. function properly.  Please make a safe backup of your registration key.
  904.  
  905.  
  906. New System Installation
  907. -----------------------
  908.  
  909. Once you have looked the demo over, you will probably want to start customizing
  910. the system to reflect your vision of what a bulletin board would be.  We
  911. recommend you start with a previously installed demo version, and work from
  912. there.
  913.  
  914. Run the CELSETUP.EXE utility, and set up all the options you desire to change. 
  915. Start with a few items, and work up to more complex settings.  Please refer to
  916.  
  917.   -----------------------------------------------------------------
  918.     Celerity v2.0                                         Page 9
  919.  
  920.  
  921.  
  922.  
  923.  
  924.                 -= Celerity v2.0 Operations Manual =-
  925.   -----------------------------------------------------------------
  926.  
  927. this document if you have questions about what specific options do.  Exit
  928. CELSETUP.EXE and run MAIN.BAT to  start the BBS.
  929.  
  930. When you run MAIN.BAT the first time, Celerity will probably create a few
  931. directories which did not exist. If you run into problems here, enter
  932. CELSETUP.EXE again and verify all directory locations. 
  933.  
  934. When the "wait for call" (WFC) screen appears, type F10 to log on locally. A
  935. default sysop account will be created for you, but it probably will not be set
  936. up with the access and preferences you desire. Once you log on, you will be
  937. prompted for your real name, sex, phone number, age, birthdate, and a password.
  938. You will also be asked to fill out any information scripts you have defined.
  939. Once these tasks have been completed, log into the BBS and get to the main
  940. menu/main level prompt.  Select the command to give yourself temporary sysop
  941. access (Alt-S with the basic keyboard setup), and enter the sysop section (the
  942. "%" command).  "U" enters the user editor, and "E" will edit your account.  Set
  943. your access level to 100, and turn on all sysop access flags, and quit the user
  944. editor.
  945.  
  946. The next step is to enter the user configuration section (Normally "K" from the
  947. main menu). Select your display preferences, option toggles, and the like. Once
  948. you complete this, you should set up your sub boards and transfer sections so
  949. your system has something for users to do.
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.   -----------------------------------------------------------------
  977.     Celerity v2.0                                         Page 10
  978.  
  979.  
  980.  
  981.  
  982.  
  983.                 -= Celerity v2.0 Operations Manual =-
  984.   -----------------------------------------------------------------
  985.  
  986. Upgrading
  987. ---------
  988.  
  989. Celerity BBS is designed to be easily upgradable from version to version, but
  990. there are sometimes some extra procedures which must be performed for a clean
  991. upgrade.  Please refer to the UPGRADE.DOC file (in the Celerity documentation
  992. directory if you installed via INSTALL.EXE, in CEL20?-3.ZIP if you install
  993. manually) for detailed instructions for the particular version you are using.
  994.  
  995. Upgrading from Celerity BBS v1.42 or Alacrity v1.42:
  996. ----------------------------------------------------
  997.  
  998. Because Celerity v2.0 is a major departure from versions 1.4x in many ways, the
  999. upgrade path is not so simple as is usually the case.  It is recommended that
  1000. you set up a demonstration v2.0 system and get it running, then import your data
  1001. files one by one to keep the upgrade as simple as possible.
  1002.  
  1003. By all means MAKE A BACKUP of all your BBS program and data files before you
  1004. upgrade!
  1005.  
  1006. Once you get your demonstration system running, you can copy your USERS file
  1007. from your old BBS directory to the new BBS directory, and run the board again. 
  1008. Celerity v2.00 will automatically convert the user list to the new format.
  1009.  
  1010. You can copy your old SETUP.DAT from your old NODE directories to your new NODE
  1011. directories, but if you do this make sure you go through and check each and
  1012. every option to make sure it is correct, as there have been a number of setup
  1013. changes.
  1014.  
  1015. All message areas and structure will be lost.  You will need to create new
  1016. message bases and conferences with version 2.00.
  1017.  
  1018. File transfer areas can be converted from v1.42 to v2.0, as can file areas, but
  1019. it is not a simple task.  Your first step should be to run the v2.0 system and
  1020. create a transfer conference.  Create as many file sections (the equivalent of
  1021. an old file conference) as you had old conferences, and write down the data
  1022. names assigned to each one (the extension will be .XFR).  Exit the BBS, and
  1023. locate your old AREADIR.x files in your v1.42 DATA directory (the x being
  1024. a number from 1 to 5, for conferences #1 through #5).  Copy these files to your
  1025. new v2.0 CONFERENCE directory, and copy them over the newly created *.XFR files.
  1026. Run the v2.0 BBS again and make sure that the area attributes for all of your
  1027. imported file areas are accurate. You can use the FIXFILE.EXE utility to help
  1028. facilitate this task. You may want to change the data pathnames of each area to
  1029. correspond to your new directory structure and manually move the *.DIR files
  1030. from your old DATA directory to the new v2.0 DATA directory.
  1031.  
  1032. The next step is to convert all of your file data.  You may have noticed that
  1033. you can list files, but there are no descriptions and they may have funny
  1034.  
  1035.   -----------------------------------------------------------------
  1036.     Celerity v2.0                                         Page 11
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.                 -= Celerity v2.0 Operations Manual =-
  1043.   -----------------------------------------------------------------
  1044.  
  1045. attributes on them.  To fix this, you need to go to the directory where your
  1046. file area .DIR files are and run the CONVFILE.EXE program. CONVFILE.EXE will
  1047. convert your old v1.42 .DIR files to the new v2.0 .DIR/.DES files.
  1048.  
  1049. Your BBS List may be preserved if you use the BBS conversion utility written by
  1050. Steve Rosin.  It is available on the support BBS.
  1051.  
  1052. Your Art Gallery may be preserved by copying the GALLERY.DAT file from your
  1053. v1.42 BBS directory to GALLERY.ART in your v2.0 CONFERENCE directory.  The
  1054. converted file may show some quirks (in the # of times viewed and the art type)
  1055. as it is not fully compatible with v2.0.
  1056.  
  1057. Your Doors section will be lost.  Copy down the pertinent information from your
  1058. v1.42 Doors section and re-enter it in v2.0.
  1059.  
  1060. Celerity v1.42 infoforms are incompatible with v2.0 information scripts, and
  1061. will have to be replaced.  See the section on "Information Scripts" for details.
  1062.  
  1063. Your electronic mail will be lost when you convert to v2.0. Your oneliners,
  1064. history, and top ten status can be preserved by copying the following files from
  1065. your old BBS directory to the new DATA directory: HISTORY.DAT, ONELINER.DAT,
  1066. TOPTEN.DAT
  1067.  
  1068. *****     By all means MAKE A BACKUP of all your BBS   *****
  1069. *****     program and data files before you upgrade!   *****
  1070.  
  1071.  
  1072. Upgrading from Celerity BBS v2.00 or 2.01
  1073. -----------------------------------------
  1074. Upgrading from version 2.00 or v2.01 to 2.02 is quite easy, as most data files
  1075. are compatible with the previous versions.  You WILL have to delete all *.QS?
  1076. files from your CONFERENCE directory, and your users will have to reconfigure
  1077. their newscans the first time they log onto the new system.  Please see
  1078. UPGRADE.DOC for full details on upgrading.
  1079.  
  1080. Please keep in mind that you may need to upgrade your language and menu files
  1081. for full 2.02 compatibility.  If you have your own files to maintain, see the
  1082. TEXTCODE.NFO file in the CEL202LD.ZIP (Celerity v2.02 Language Development Kit)
  1083. supplement.  There will be v2.02- compliant language and menu files available on
  1084. the support BBS as well.
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.   -----------------------------------------------------------------
  1095.     Celerity v2.0                                         Page 12
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.                 -= Celerity v2.0 Operations Manual =-
  1102.   -----------------------------------------------------------------
  1103.  
  1104. Running CELSETUP.EXE
  1105. --------------------
  1106.  
  1107. The  CELSETUP.EXE program is used to set up all the information about your
  1108. system and BBS that Celerity needs.  It will allow you to enable and disable
  1109. eatures, adjust parameters, define your hardware, and more. This section covers
  1110. the basic set up and configuration of the Celerity BBS package.  Later sections
  1111. will cover other items of consideration when setting up a BBS, including
  1112. multinode operation, networking, message area creation, and transfer section
  1113. options.
  1114.  
  1115. When running the demonstration from C:\celerity, you should not need to run
  1116. Celsetup at all to run the demo.  After looking around in the demo, however, you
  1117. may want to look Celsetup over to get an idea of the flexibility you have with
  1118. Celerity.  If you install the demo in a directory other than c:\celerity, you
  1119. will have to edit pathnames in CELSETUP and in the BBS itself.
  1120.  
  1121. When CELSETUP is run, you will be presented with a desktop containing a menu bar
  1122. with two menus and a window containing a slew of buttons.
  1123.  
  1124. The first menu on the menu bar contains an "About" display.  The second menu
  1125. allows you to bring up the "Celerity Setup Topics" (the buttons).
  1126.  
  1127. The dialogs in  CELSETUP.EXE mimic those found in most graphical user interfaces
  1128. (GUI) in that they use pulldown menus, windows, buttons, radio buttons, and
  1129. more.  If you have a mouse, the setup will be much easier and quicker to use,
  1130. but you may still use the keyboard.  If you use the keyboard, use arrow keys or
  1131. tab/shift-tab to move from field to field, and return to select a field.
  1132.  
  1133. Check boxes are boxes which appear as "[ ]".  If you wish to enable that option,
  1134. select the box with the mouse or keyboard, and click (or press space) on it. 
  1135. The selected box will now appear as "[X]", meaning that option has been
  1136. selected.
  1137.  
  1138. Radio buttons are a series of buttons which appear as "( )".  With radio
  1139. buttons, only one option out of the cluster can be selected, and selecting a new
  1140. button will disable the others.  The button with your current configuration
  1141. choice will appear as "(*)".
  1142.  
  1143. Data Fields are boxes with an inverse background that allow you to enter text. 
  1144. Sometimes text may be longer than what is displayed on the screen, indicated by
  1145. a small arrow pointing to the left or right at the end of the field.  Home, End,
  1146. Insert, Delete, and arrow keys all function within text data fields.
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.   -----------------------------------------------------------------
  1154.     Celerity v2.0                                         Page 13
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.                 -= Celerity v2.0 Operations Manual =-
  1161.   -----------------------------------------------------------------
  1162.  
  1163. System Info
  1164. -----------
  1165.  
  1166. This data screen has fields requesting general information about your BBS.
  1167.  
  1168.  - Sysop:  Your Name or Handle (as requested on your Registration form)
  1169.  
  1170.  - Full:  This is the complete name of your BBS (ie: Terrapin Station). Consider
  1171. a limit of thirty characters or so.
  1172.  
  1173.  - Short:  Enter the name of your BBS again, in a shorter version if the real
  1174. name is excessively long (ie: Terrapin).  If the name is short and simple, it is
  1175. fine to enter the same name in both fields.  The limit should be about fifteen
  1176. characters.
  1177.  
  1178.  - Acronym:  This is a three character field that should be used to identify
  1179. your BBS in assorted downloadable files (such as a BBS policy file, master
  1180. lists, off-line reader data packets, and the like). Examples include CEL, BME,
  1181. and ARC for The Celerity Support Board, Bald Mountain Enterprises, and The
  1182. Archives, respectively.
  1183.  
  1184.  - City:  The city where the BBS is located.  This information is only to
  1185. satisfy user interest, and does not affect the operation of the BBS in any way.
  1186.  
  1187.  - State:  Like the city above, this information is inert.
  1188.  
  1189.  - BBS Phone Number:  Enter the number in the format: 310-693-9405 or
  1190. +61-554-2321. This information will be used to determine the locality of
  1191. potential users for the Local User Lockout and for generating statistics.
  1192.  
  1193.  - System Two Name:  If you wish to use a second "system" accessible when a
  1194. caller first connects, you can enter the name shown on the menu here. For more
  1195. information about additional systems, see the section on "Login Commands".
  1196.  
  1197.  - System Three Name:  See "System 2 Name" above.
  1198.  
  1199.  
  1200.  
  1201.  
  1202. System Options
  1203. --------------
  1204.  
  1205. The System Options menu contains vital information regarding certain functions,
  1206. type of BBS you run, type of machine it is running on, multinode information,
  1207. and more.
  1208.  
  1209.  
  1210.  
  1211.  
  1212.   -----------------------------------------------------------------
  1213.     Celerity v2.0                                         Page 14
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.                 -= Celerity v2.0 Operations Manual =-
  1220.   -----------------------------------------------------------------
  1221.  
  1222. System Toggles:  This section contains a set of check boxes relating to various
  1223. features and functions.  Placing a dot in the box will enable that option,
  1224. placing a space in it will disable it. These options are as follows:
  1225.  
  1226.  - Allow Doors:  Will your system allow the use of external programs (doors)
  1227. such as on-line games?  See the section on "Doors" below.
  1228.  
  1229.  - Allow FAT Move:  This toggle will allow Celerity to move files around on your
  1230. hard drive by directly reading and writing to the disk's directory structure. 
  1231. This results in a much quicker move of the file when compared with the non-FAT
  1232. move, which involves copying. Consider reading/editing/writing about 512 bytes
  1233. as opposed to reading/writing over a million bytes (for a 1 meg file). If you
  1234. have a very delicate file system (ie: not standard MS-DOS), use various device
  1235. drivers, or networking, you may need to disable this function.
  1236.  
  1237.  - Strict Phone:  Forces users to enter their phone numbers in the proper format
  1238. (i.e. for US Callers :xxx-xxx-xxxx or, for international users: +xx-xxx-xxxx).
  1239.  
  1240.  - External Chat Call:  Celerity will execute a file in the AUDIO directory
  1241. called CHAT.BAT.  It will first check to see if there is a .VUS file (a
  1242. digitized file for an individual user - his user ID with a .VUS extension..
  1243. 234.VUS, for example) for the user currently logged on. If so, this file will be
  1244. passed as a parameter.  If there is no .VUS for the particular user, a .VOC
  1245. file will be chosen at random from the AUDIO directory.
  1246.  
  1247. The sysop should set up the CHAT.BAT file in his AUDIO directory to call a
  1248. utility which will play the digitized sound on his hardware, or REPLAY.EXE for a
  1249. system with only a PC speaker.  Alternatively, a sysop can do anything he wants
  1250. in that CHAT.BAT file, such as starting a MIDI player, using some PC-speaker
  1251. music (examples are available on Terrapin Station), and so forth.
  1252.  
  1253.  - Hang Up on exit:  Will allow the system to NOT hang up when the user logs
  1254. off.  This is handy if you run Celerity as a door from another BBS, or if you
  1255. have multiple BBSes available from one login shell and wish for users to be able
  1256. to return to an alternate process upon exiting Celerity.
  1257.  
  1258.  - SysOp Auto Login:  If selected, the Sysop will be automatically logged in
  1259. when F10 is pressed from the WFC Screen. Alt-F10 overrides this Toggle, always
  1260. "auto logging" the sysop in. F4 will take the Sysop Directly to the main menu
  1261. without any of the normal Login processing (Mail check, NUV processing, etc...).
  1262.  
  1263.  - Secure Console:  The secure console option will disable all keyboard-based
  1264. sysop functions so that the BBS can be used by multiple local users without
  1265. (much) fear of an integrity breach.
  1266.  
  1267.  - System Type:  This box contains a set of radio buttons to indicate which type
  1268. of on-line system you are running.  You may select only one of the four types,
  1269.  
  1270.  
  1271.   -----------------------------------------------------------------
  1272.     Celerity v2.0                                         Page 15
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.                 -= Celerity v2.0 Operations Manual =-
  1279.   -----------------------------------------------------------------
  1280.  
  1281. and it must be an option your registration utility supports.  The various
  1282. options are as follows:
  1283.  
  1284.  - Celerity BBS :The standard full-fledged Celerity BBS
  1285.  - CAE          :A no-user-record transfer system
  1286.  - CAE/TAC      :A transfer-only system with accounts
  1287.  - Alacrity BBS :This option superseded by the Alacrity structure
  1288.  
  1289.  - CPU Type:  More radio buttons.  Indicate the type of system that you have. 
  1290. If you have a system based on (or emulating) an Intel (or other) 8088, 8086, or
  1291. NEC V-20 processor, select 8088. If you have a 286 machine, indicate 80286. If
  1292. you use a 386sx, 386sl, 386dx or compatible, indicate 80386.  If you have an
  1293. i486sx, or i486dx, or compatible, indicate 80486. If you have a Pentium class
  1294. processor (Pentium, Pentium 54C, Cyrix M1, AMD K5, Nexgen NX586),  select the
  1295. Pentium option.  Note that the system WILL function under the incorrect
  1296. processor setting, but Celerity will not be able to optimize its performance for
  1297. your processor.
  1298.  
  1299.  - Hangup Timeout:  You can determine how many minutes Celerity will allow a
  1300. user to sit at a prompt without doing anything.  Once this time is passed,
  1301. Celerity will hang up on the user to allow someone else to call.
  1302.  
  1303.  - Print Log: This option will echo system log activity to a printer attached to
  1304. PRN.  Do NOT enable it if you have no printer on your system or if you do not
  1305. intend to leave the printer on for continuous logging.  The print option has 4
  1306. settings:
  1307.      Off:     Disable Printer Logging.
  1308.      Brief:   Will only show basic events, such as log in and log out.
  1309.      Normal:  Will show more details than brief mode, including log in,  log
  1310.          out, E-Mail activity, message base activity, and transfer activity.
  1311.      Verbose: Print everything that appears in the System Log.
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.   -----------------------------------------------------------------
  1331.     Celerity v2.0                                         Page 16
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.                 -= Celerity v2.0 Operations Manual =-
  1338.   -----------------------------------------------------------------
  1339.  
  1340. Look and Feel Settings
  1341. ----------------------
  1342.  
  1343. The Look and Feel Toggles control some display options within Celerity.
  1344.  
  1345.  - User Disable Top 5: Allow the user to set a toggle in his configuration files
  1346. to bypass the Top 5 Poster, Uploader, and Downloader lists.
  1347.  
  1348.  - Use Top 5 User List: Allows the Sysop to turn off the Top 5 Poster, Uploader,
  1349. and Downloader lists. 
  1350.  
  1351.  - Use One-Liners: Allow the users to enter "one Liner Comments" that are
  1352. displayed on the bottom of the screen during BBS operations
  1353.  
  1354.  - Use Key Flash Monitor:  The Key Flash Monitor will cycle the NumLock,
  1355. ScrollLock, and CapsLock keys when the system is in the WFC (Wait for Call)
  1356. mode.  This can be used as an indicator that the system is active when a user is
  1357. not on-line and your Screen is off. Do not use this if you are under a
  1358. multitasking system or sharing a keyboard with multiple computers.
  1359.  
  1360.  - Enable "Leech Week": When on, the File-Point System is disabled.  This can be
  1361. used to "Reward" your users once in a while.
  1362.  
  1363.  - Use Alacrity Structure:  This is an alternate menu structure.  The major
  1364. change in this over regular Celerity is the division of the main menu into a
  1365. main level menu and a miscellaneous menu. The Alacrity structure was designed to
  1366. be more intuitive and logical while the older structure has been retained for
  1367. those who are slow to adapt.
  1368.  
  1369.  - Allow Masterfiles: Allow the users to generate a comprehensive list of all
  1370. files on the BBS (That the user has access to)
  1371.  
  1372.  - Use Sound: Celerity will make sounds every once in a while.
  1373.  
  1374.  - User Edit Usernote: Allow the User to change his own User Note
  1375.  
  1376.  - Allow User Handles: Should Handles be allowed on the System, or just real
  1377. names.
  1378.  
  1379.  - Use NUA/VMB in BBS List: VMB=Voice Mailboxes, NUA= Network Address.
  1380.  
  1381.  - Recycle BBS on Exit: (Not used, set to OFF)
  1382.  
  1383.  - Allow Mail Attachments: Allow Files to be "Attached" to email messages.
  1384.  
  1385.  - User Wait Text:  Text displayed when the sysop does a local drop-to-dos or
  1386. other local console commands.
  1387.  
  1388.  
  1389.   -----------------------------------------------------------------
  1390.     Celerity v2.0                                         Page 17
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.                 -= Celerity v2.0 Operations Manual =-
  1397.   -----------------------------------------------------------------
  1398.  
  1399.  - Anonymous String: The "Name" to use when someone posts "anonymously"
  1400.  
  1401.  - Pause String: Text displayed to the user to hit return to continue.
  1402.  
  1403.  - Mask Input Character: The character echoed when the user is typing a password
  1404. or other sensitive data which should not be displayed.
  1405.  
  1406.  - Default Help Level: The help level to set for all new users(1-4).  These are:
  1407.  
  1408.   1:  Expert: users who are intimately familiar with Celerity BBS
  1409.   2:  Intermediate: most users who are familiar with BBSes in general.
  1410.   3:  Novice: novice users who need a list of valid keys at every prompt.
  1411.   4:  Beginner: absolute beginners who need full menus to be displayed
  1412. automatically at every prompt.
  1413.  
  1414. We recommend a setting of 2 for most systems as the default.  Individual users
  1415. can select their own setting, of course.
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.   -----------------------------------------------------------------
  1449.     Celerity v2.0                                         Page 18
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.                 -= Celerity v2.0 Operations Manual =-
  1456.   -----------------------------------------------------------------
  1457.  
  1458. Serial Port Setup
  1459. -----------------
  1460.  
  1461. It is imperative that this section is set correctly, or Celerity will not
  1462. function (or not function completely) with your modem.  It should be noted that
  1463. the COM2 handling on some machines is not fully standard, and thus some people
  1464. have problems using COM2 with Celerity.
  1465.  
  1466.  - COM Port:  This box contains five radio buttons.  The first two correspond to
  1467. the IBM standard IRQ, Address, and interrupt values for COM1 and COM2.  The
  1468. second two correspond to the industry standard values (note that these industry
  1469. standards are NOT supported by IBM PS/2 machines) for COM3 and COM4.  The fifth
  1470. button will allow you to use the Custom COM Port settings (see below) so that
  1471. you can set Celerity up to a specific format.
  1472.  
  1473.  - Custom COM Port:  Allows you to specify the IRQ, interrupt, base address, and
  1474. COM port to use for Celerity.  Use this if you have a non-standard setup.  The
  1475. interrupt is usually the IRQ plus 8.
  1476.  
  1477.  - Enable UART Buffering:  If you have a high speed serial UART, let Celerity
  1478. enable its buffering!  A 16550AFN UART provides a buffer so that data can be
  1479. moved quicker, and is very helpful when running on a system with a lot of
  1480. overhead (excessive use of interrupts by some programs, or multitasking). See
  1481. Appendix A for more info on SIO Chips.
  1482.  
  1483.  - Input Buffer:  Allows you to specify the size of Celerity's internal input
  1484. buffer. The minimum recommended value here is 128 bytes.
  1485.  
  1486.  - Output Buffer:  Allows you to specify the size of the output buffer.  The
  1487. minimum value here is 32 bytes, but 512 or 1024 is recommended) It can be
  1488. increased as circumstances warrant (ie: users complain of garbled ANSI
  1489. displays).
  1490.  
  1491.  - Serial Type: If you set it to DigiBoard, only the DigiBoard main program
  1492. files will work.  If you set it to FOSSIL, only the FOSSIL version will work. 
  1493. This switch is a configuration precaution only - you still must obtain the
  1494. Digiboard or FOSSIL supplement for these modes of operation.
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.   -----------------------------------------------------------------
  1508.     Celerity v2.0                                         Page 19
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.                 -= Celerity v2.0 Operations Manual =-
  1515.   -----------------------------------------------------------------
  1516.  
  1517. Modem Setup
  1518. -----------
  1519.  
  1520. The Modem Setup dialog is where you tell Celerity all about your modem. Celerity
  1521. ships with a number of setup objects for common modems.
  1522.  
  1523.  - Modem Type:  This is a list box containing a database of modem types which
  1524. have been tested with Celerity.  To load the settings for a particular modem,
  1525. you must select it in this box then click on the "Apply Modem Settings" button. 
  1526. Selecting the modem alone is not sufficient to load the modem's default
  1527. settings.
  1528.  
  1529.  - Offhook During Local:  This is a check box which will make Celerity take the
  1530. phone off the hook when someone logs onto the system locally.  The value of this
  1531. is that users will get a busy signal instead of a ring when they call while a
  1532. user is on the system locally.
  1533.  
  1534.  - Answer on Ring:  This tells Celerity how many rings to wait for before it
  1535. answers the line.  If you specify 0, Celerity will read your serial port
  1536. directly waiting for a ring, and is the strongly recommended setting.  If you
  1537. specify a value other than 1, Celerity will add "ATS0=n", where n is your
  1538. specified value.  In this case,  Celerity will wait until the serial port
  1539. reports the existence of a carrier, requiring the modem to initiate the answer
  1540. process. (Under some hardware and software configurations, the ring 0 may not
  1541. function correctly.  The virutalized UART in OS/2, for example, precludes the
  1542. use of this option and sysops running under OS/2 must select a ring # of 1 or
  1543. more).  Some modems, serial hardware, or serial cables do not support the ring
  1544. detect line correctly and may continuously tell Celerity that the phone is
  1545. ringing.  In this case, select a ring # greater than 0.
  1546.  
  1547.  - Hangup String:  This is the AT command which should hang up your modem if the
  1548. preferred method of dropping the DTR line does not succeed. Note that a pipe (|)
  1549. character indicates a carriage return and a tilde (~) indicates a 1-second
  1550. delay.
  1551.  
  1552.  - Dial Prefix:  The command needed to force the modem to dial should be entered
  1553. here.  Generally, it would be "ATDT".  Some phone systems require adding
  1554. additional digits.
  1555.  
  1556.  - Dial Suffix:  The suffix of the dial command is usually just a carriage
  1557. return (|), but some phone systems may require other digits for full
  1558. functionality.
  1559.  
  1560.  - Apply Settings:  Loads the defaults for the currently selected modem type. 
  1561. See the "Modem Type" above.
  1562.  
  1563. - Supported BPS rates:  Many sysops will want to limit access to the board to
  1564. certain connection rates.  The Supported BPS rates is a sub-dialog of the modem
  1565.  
  1566.   -----------------------------------------------------------------
  1567.     Celerity v2.0                                         Page 20
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.                 -= Celerity v2.0 Operations Manual =-
  1574.   -----------------------------------------------------------------
  1575.  
  1576. setup options which will let the sysop enable or disable any single connect
  1577. rate, from 300bps up to connection rates of v.32ter, v.34/v.fast, or even ISDN
  1578. connections.
  1579.  
  1580.  Note that if a "Low Speed Lockout" password is defined (see "System Passwords"
  1581. below), a user at an unsupported rate will be given the opportunity to enter
  1582. this password and log on despite this restriction.
  1583.  
  1584.  - Add Modem:  If you develop a reliable setup string for a Modem that is not
  1585. listed, you can name the Data strings and add them to the MODEMLST.DAT file. If
  1586. the Setup works well, pass on the information to the Celerity support BBS for
  1587. inclusion in future versions of Celerity.  Note that after you add a modem
  1588. object to the list, you will need to exit CelSetup and re-run it for it to be
  1589. visible in the listing.
  1590.  
  1591.  - Connect Strings:  This will bring up a dialog enabling you to tailor the
  1592. strings which Celerity expects from your modem.  By default, it expects CONNECT
  1593. followed by the speed of the connection, such as "CONNECT 14400" for a 14.4kbps
  1594. connection. Most modems follow this pattern, but if yours does not, Celerity can
  1595. be modified to support what your modem does use.  Celerity will use the highest
  1596. rate matched, so if you have "CONNECT ISDN" for both a 57600 and a 64000 ISDN
  1597. rate, Celerity will interpret the call as being at 64000.
  1598.  
  1599.  - Edit Settings:  Pressing this button will bring up another window. This
  1600. window will allow you to alter the standard settings for your selected modem
  1601. type as follows:
  1602.  
  1603.  - DTE Rate:  Radio buttons specify at what speed data should be sent to the
  1604. modem.  Most high speed modems allow a DTE rate of 19200, 38400, 57,600 or even
  1605. 115,200 bps.  A fixed speed modem (normal non-V.42, non-MNP 2400, 1200, 300)
  1606. should use its maximum rated speed.
  1607.  
  1608. Note: You can easily set this rate higher than your computer and/or serial
  1609. hardware will support reliably.  If your users lose characters or get download
  1610. errors, try a reduced DTE rate.  38400 is sufficient for maximum speed transfers
  1611. of archived files up to 28.8kbps (although non-compressed data will go faster at
  1612. a higher DTE rate).  In general, if your users do a lot of transferring of
  1613. uncompressed files (text files, program listings), set your DTE rate to twice
  1614. your top connect rate (38400 for up to 19200bps, 57600 or 115200 for 28.8k).
  1615.  
  1616.  - Lock DTE:  High speed modems can lock their operating speed at a higher DTE
  1617. rate than the connect rate is.  If this check box is NOT checked, Celerity will
  1618. begin communicating at the established speed upon connection (ie: Celerity will
  1619. talk to the modem at 2400bps if a 2400bps call is detected).  If your modem will
  1620. support a locked DTE rate, it will give better performance than a modem which
  1621. does not.
  1622.  
  1623.  
  1624.  
  1625.   -----------------------------------------------------------------
  1626.     Celerity v2.0                                         Page 21
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.                 -= Celerity v2.0 Operations Manual =-
  1633.   -----------------------------------------------------------------
  1634.  
  1635.  - Connect Delay:  After the command to answer is given, Celerity will wait this
  1636. length of time (in 1/10th seconds) until it attempts to determine the connection
  1637. information.  If the modem responds to a carrier very quickly, this can be
  1638. short.  If the modem takes a long time to determine the connection results, such
  1639. as many V.32 modems, this should be longer.  If you get calls coming in which
  1640. Celerity cannot identify, this value should be increased.
  1641.  
  1642.  - Modem String:  This is the actual command string sent to the modem to prepare
  1643. for a call.  Under most circumstances, you should use the recommended string, or
  1644. some modification of it.  If you have an unsupported modem, you can custom
  1645. tailor it here.
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.   -----------------------------------------------------------------
  1685.     Celerity v2.0                                         Page 22
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.                 -= Celerity v2.0 Operations Manual =-
  1692.   -----------------------------------------------------------------
  1693.  
  1694. Custom Modem Strings
  1695. --------------------
  1696. If you have a modem which is NOT listed in the list box, you should try the
  1697. following steps:
  1698.  
  1699.   1: Select a different modem by the same manufacturer and see if the setup for
  1700. this alternate modem works.
  1701.   2: Call the Celerity support BBS and see if a modem object has been created by
  1702. another sysop for your modem.
  1703.   3: Try a "generic" modem setup (ie: "Generic 2400" for a 2400bps modem,
  1704. "Generic 9600" or "Generic 14400" for a v.32 or v.32bis modem).
  1705.   4: Try setups for similar modems from different manufacturers.
  1706.   5: With the assistance of your manual or technical support of your modem
  1707. manufacturer, create your own setup object.  This option will provide the best
  1708. performance from your modem, but requires that you are somewhat knowledgeable
  1709. about modem operation, or have a technician's assistance.
  1710.  
  1711.  
  1712. Important information you will need to know to proceed:
  1713.  
  1714.      a: Celerity expects verbal result codes in the following format: 
  1715. "CONNECT <bpsrate>[/protocol]"
  1716.  
  1717. It does not read a DTE rate value.  If a protocol is specified, it should be on
  1718. the same connect line. Example:
  1719.  
  1720.              "CONNECT 14400/V32BIS/LAPM" is acceptible.
  1721.  
  1722.              "CONNECT 38400
  1723.               CARRIER 14400
  1724.               PROTOCOL: LAPM" is not.
  1725.  
  1726.      b:  Celerity uses RTS/CTS handshaking. The modem can be set up to respond
  1727. to BOTH hardware and software handshaking for compatibility with some transfer
  1728. protocols and doors.
  1729.      c:  High speed modems should use a locked DTE rate, which should match that
  1730. in the Celerity setup.
  1731.      d:  Celerity uses the DCD line (carrier detect) to tell if a caller is
  1732. connected or has hung up.  The modem should NOT force this line true.  Usually,
  1733. "&C1&D2" in the modem setup should ensure correct DCD operation.
  1734.      e:  Celerity (when set to answer on ring 0) monitors the RI (ring detect)
  1735. line to tell if the phone is ringing, and then sends an "ATA" to the modem to
  1736. tell it to answer.  The RI line should not be left on after a ring comes in.
  1737.  
  1738. Some modems may have a problem with this, and may keep the RI line high, causing
  1739. Celerity to continually report that the phone is ringing in the wait for call
  1740. screen.  In a cases like this, set the modem to answer on ring #1.
  1741.  
  1742.  
  1743.   -----------------------------------------------------------------
  1744.     Celerity v2.0                                         Page 23
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.                 -= Celerity v2.0 Operations Manual =-
  1751.   -----------------------------------------------------------------
  1752.  
  1753. Video Options
  1754. -------------
  1755.  
  1756. The Video Options dialog contains five check boxes for various aspects affecting
  1757. the actual video display.
  1758.  
  1759.  - Monochrome:  If you are running on a greyscale VGA or monochrome system,
  1760. checking this option will emphasize all low intensity characters on the local
  1761. end, making text easier to read.
  1762.  
  1763.  - 43/50 Lines:  If you have an EGA or VGA display, Celerity can operate in a
  1764. high resolution text mode.  EGA will provide an 80x43 display, and VGA will give
  1765. you 80x50.
  1766.  
  1767.  - Celerity ANSI:  This enables the internal ANSI interpreter, which is about
  1768. 65% faster than the fastest DOS-based driver we could find.  In addition, use of
  1769. the Celerity ANSI filter will convert all ANSI codes to Avatar codes for users
  1770. who select Avatar terminal emulation, resulting in a considerable on-line speed
  1771. increase as well. The ONLY reason you would have for disabling CelerityANSI
  1772. would be in the case where you required all text to pass through DOS interrupts
  1773. for devices such as Braille terminals etc.
  1774.  
  1775.  - Wait-Call Screen Saver:  This toggle will allow Celerity to blank the screen
  1776. while it is waiting for a call.  It is an old throwback to the Days of the
  1777. Monochrome monitors, which experienced "Burn-in" problems. Nowadays, It's just
  1778. "Pretty"
  1779.  
  1780.  - Auto-size Display:  This option will automatically adjust the local display
  1781. mode to mimic the user's display mode. If the user uses 25 lines, the local
  1782. display will be 25 lines. If the user uses 43/50 lines, the local display will
  1783. be 43/50 lines.
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.   -----------------------------------------------------------------
  1803.     Celerity v2.0                                         Page 24
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.                 -= Celerity v2.0 Operations Manual =-
  1810.   -----------------------------------------------------------------
  1811.  
  1812. Login Sequence
  1813. --------------
  1814.  
  1815. With a simple change in the setup program, the SysOp can change the sequence of
  1816. events a user performs when he enters the system. Not only can events be
  1817. arranged in new and unique sequences, but they can also have certain attributes
  1818. set on them.
  1819.  
  1820. The SysOp can decide if an event should always be viewed, or if it should be
  1821. abortable via a quick-login, if the screen should be cleared before the event,
  1822. if the system should pause for user input afterwards, or even if it should be
  1823. executed at all.  The P)ause, C)LS, and S)kip boxes control these options.
  1824.  
  1825. Also, up to three additional events can be defined which display external text
  1826. or ANSI files containing any image or information the SysOp wishes to include. 
  1827. These events can also be inserted anywhere in the login sequence, and have the
  1828. three attributes (skip w/quick login, clear screen, pause) adjusted.  These
  1829. files should reside in your DISPLAY directory.
  1830.  
  1831. Celerity's configurable login sequence also allows a SysOp to define two
  1832. EXTERNAL PROGRAMS to be run as the user logs in (such as Caller ID info, an
  1833. online game contest, or writing your own BBS modules).  Any program which can be
  1834. run as a door (or DOS program w/Doorway) can be executed as a login sequence
  1835. door, and the user won't be able to tell that he's not in Celerity.  These
  1836. external programs must be in your main BBS directory.
  1837.  
  1838. The login sequence can contain as many or as few events as you desire. You have
  1839. a wide range to choose from, including:
  1840.  
  1841.  - Welcome Message:  This event displays one of several welcome screens at
  1842. random, depending on the user's terminal emulation.   
  1843.   *.WEL : These are ANSI welcome screens.
  1844.   *.WAS : These are ASCII welcome screens (no color, cursor
  1845.           positioning).
  1846.   *.WTX : These are 7-bit text welcome screens for users who do not
  1847.           have IBM-compatible displays.
  1848.   *.WNA : These are NAPLPS graphics frames.
  1849.   *.WNR : These screens are for those with RIP graphic terminals.
  1850.  
  1851.  - Account Status:  The user's account status screen is displayed with this
  1852. event.  An external configurable status screen LOGNSTAT may be used here
  1853.  
  1854.  - Account Verification:  This event checks the user's account to see if he has
  1855. been deleted or if his account has expired.  This should be included in all
  1856. login sequence setups, and NOT be skippable.
  1857.  
  1858.  - System News:  If there are new news bulletins which have not been read, they
  1859. will be displayed by this dialog.
  1860.  
  1861.   -----------------------------------------------------------------
  1862.     Celerity v2.0                                         Page 25
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.                 -= Celerity v2.0 Operations Manual =-
  1869.   -----------------------------------------------------------------
  1870.  
  1871.  - Network News: This function is no longer used.
  1872.  
  1873.  - Auto-Message:  If an auto-message exists, it will be displayed by this event.
  1874.  
  1875.  - Display Art:  This event will choose a random work of ANSI art from the Art
  1876. Gallery and display it to the user.
  1877.  
  1878.  - Voting:  If you wish your users to be forced into the voting section of your
  1879. BBS, this event will do so.  Users will be prompted to vote on topics they have
  1880. not yet voted on.
  1881.  
  1882.  - New User Voting:  If you use the New User Voting (NUV) section, users with
  1883. sufficient access will be asked to vote on pending new users.
  1884.  
  1885.  - Electronic Mail:  When this event is active, users with new mail waiting to
  1886. be read will be sent into the Electronic Mail section to read it.
  1887.  
  1888.  - Multi-Node Status:  If you run a multinode BBS and select this event, users
  1889. will be shown a list of other users on other nodes.
  1890.  
  1891.  - Door 1 & 2:  There are two door events.  When one of these events is called,
  1892. Celerity will execute the specified filename residing in the BBS directory, just
  1893. like a door. These events can be Caller ID programs, special message mailers,
  1894. doors, or other types of modem-aware (or Doorway-style redirected) programs.
  1895.  
  1896.  - Display 1, 2, & 3:  These events also require a filename, like the shell
  1897. commands. They may be special notices, disclaimers, system policy notices,
  1898. additional ANSI files, or whatever the SysOp so chooses.  They must be in the
  1899. display directory.
  1900.  
  1901. Through the use of the configurable Login Sequence commands, a SysOp can make
  1902. his system appear considerably differently from other Celerity systems.  The
  1903. capability to shell to doors when users log in allow SysOps to add additional
  1904. features or utilities to provide even greater flexibility for system
  1905. configuration and system motif.
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.   -----------------------------------------------------------------
  1921.     Celerity v2.0                                         Page 26
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.                 -= Celerity v2.0 Operations Manual =-
  1928.   -----------------------------------------------------------------
  1929.  
  1930. Transfer Options
  1931. ----------------
  1932.  
  1933. These options alter the way your transfer section looks and behaves. Note that
  1934. for the Use File Point System, Upload Factor, Point Value, and Commission
  1935. options, the transfer policy is explained to users whenever they enter the
  1936. transfer section.
  1937.  
  1938. Upload Descriptions:  Celerity allows for much more complete information to be
  1939. stored regarding an upload than most bulletin board programs. Users can select
  1940. which information they wish to view, as only so much can be displayed on an
  1941. 80-character screen.
  1942.  
  1943.  - Allow Extended Descriptions:  Although unused with version 2.00, Extended
  1944. Descriptions will ultimately allow users to enter a full-page description about
  1945. an upload which may be viewed with the I)nformation command from within the BBS. 
  1946. This toggle will enable you to turn it on or off.
  1947.  
  1948.  - Picky Descriptions: Unused with v2.02.
  1949.  
  1950.  - Use Disk Numbers: Unused with v2.02.
  1951.  
  1952.  
  1953. Transfer Toggles: 
  1954.  
  1955.  - User Defined Point Modifier:  User-defined point values allow the uploading
  1956. user, in a file point system, to determine to an extent how valuable a certain
  1957. file is, and thus how much it costs. The user can specify if the file should be
  1958. free, one point, quarter, half, normal, or double the standard cost for a file
  1959. of its size.  Note that for this option to have any meaning, the "Auto-Validate"
  1960. and "Use FPS" toggles must be checked as well.
  1961.  
  1962.  - Use File Point System:  This toggles the use of a file point system for your
  1963. transfer sections.  If you use a file point system, users must "pay" for their
  1964. downloads with transfer credits. Transfer credits may be earned by uploading
  1965. files, having their uploads downloaded by other users (see "Commission"), or
  1966. granted by the SysOp.
  1967.  
  1968.  - Auto-Validate Uploads:  If this option is checked, new uploads will
  1969. immediately be posted for general download.  If this box is not checked, the
  1970. SysOp or coSysOp must manually validate each file and determine its point cost
  1971. (if a file point system is used).
  1972.  
  1973.  - Auto-Comment Uploads:  This box dictates whether Celerity should execute a
  1974. file called COMMENT.BAT from your BBS directory.  This COMMENT.BAT file is
  1975. normally used for running CelTest, ZipLab+, TranScan or some other third party
  1976. program.  COMMENT.BAT will be passed the filename and path as %1 and the
  1977.  
  1978.  
  1979.   -----------------------------------------------------------------
  1980.     Celerity v2.0                                         Page 27
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.                 -= Celerity v2.0 Operations Manual =-
  1987.   -----------------------------------------------------------------
  1988.  
  1989. extension as %2, and the path to a .DIR file with the current record of the file
  1990. being tested as %3.
  1991.  
  1992.  - Use Backup Directories:  This option allows the sysop to bulk move lots of
  1993. old file entries to a .BCK directory for archival purposes.
  1994.  
  1995.  - Allow User File Requests:  When a user attempts to download a file entry
  1996. which is not found on your hard drive, they will be told "that file isn't here". 
  1997. If you turn this switch on, the user will be asked if he or she wishes to leave
  1998. feedback to the SysOp requesting the file. (This way, you can store mass
  1999. quantities of files "Off-line" (on a tape backup or CD-ROM) and move files
  2000. online only if they are requested)
  2001.  
  2002.  - User File Passwords:  If you enable this option, users will be allowed to
  2003. attach passwords to their uploads.  Other users must then enter this password
  2004. before they can download the file.
  2005.  
  2006.  - Allow Private Files: If you allow this, Users will be able to "Reserve" an
  2007. upload for a particular User. Only that User could Download it.
  2008.  
  2009.  - Spool Uploads: If this is selected, an external upload spooler will be called
  2010. to process files uploaded. Please refer to the Documentation for UpSpool for
  2011. details on it's operation.
  2012.  
  2013. There are also several Values that need to be set to determine the transfer
  2014. systems attributes. they are:
  2015.  
  2016.  - Upload Factor:  If your system uses a file point system, and you wish to give
  2017. users download credit for their uploads, you may enter a multiplier in this box. 
  2018. The user will be granted (value_of_upload * Upload_Factor) points.  For example,
  2019. a user uploads a file which the BBS determines is worth four points. With an
  2020. upload factor of 3, the user is granted twelve points.  An upload factor of 1
  2021. provides four points, and 0 provides nothing. The value of the upload is
  2022. determined by the SysOp if the system does not automatically validate uploads,
  2023. or by the "Point Value" below if uploads are immediately posted.  Note that if
  2024. you enable the "User Defined Point Value" (see above), the upload restitution
  2025. is granted before the user chooses the new value. (This prevents a user from
  2026. giving himself "Mega-points") 
  2027.  
  2028.  - Point Value:  This variable determines the standard number of kilobytes that
  2029. 1 point can download in a system using the File Point System, rounded down.  For
  2030. example, a 118k file would be worth 2 points if the point value was 50 (118 / 50
  2031. rounds down to 2).  The same file would be worth 1 point if the point value was
  2032. 1, or 11 points if the point value was 10.  This value is used to determine the
  2033. cost if the file is auto-validated (see above), or used as the default
  2034. suggestion when a SysOp manually validates the file.
  2035.  
  2036.  
  2037.  
  2038.   -----------------------------------------------------------------
  2039.     Celerity v2.0                                         Page 28
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.                 -= Celerity v2.0 Operations Manual =-
  2046.   -----------------------------------------------------------------
  2047.  
  2048.  - Maximum File Point Loan:  Celerity allows users of a certain level to take
  2049. out a file point loan, allowing them to download something they do not have
  2050. enough points for, in faith that they will repay the loan in the future.  Alas,
  2051. some users would abuse this feature if there was no limit to the credit
  2052. extended, thus the necessity for this option exists. The recommended loan limit
  2053. is 500 divided by the point value (ie: enough to download about 500k), but
  2054. any value (including 0 to disable all file point loans) is acceptable.
  2055.  
  2056.  - Commission Credit:  One of the revolutionary concepts introduced by Celerity
  2057. is the system of file point commissions.  This system rewards users who upload
  2058. quality data and describe their uploads well, and provides unequal treatment for
  2059. those who upload junk. The commission system works as follows:
  2060.  
  2061. User #A uploads a file and establishes its value as 22 points. When user #B
  2062. downloads the file, user #A is credited with a commission.  If a dozen users
  2063. download a popular program, user #A gets rich in return for his or her effort.
  2064. If nobody downloads the program, user #A is not rewarded as much. The commission
  2065. value determines what percentage of the file's cost is given to user #A.
  2066.  
  2067. With a 0% commission, user #A gets nothing when his files are downloaded (and
  2068. thus must rely on the points granted by the upload factor above).
  2069.  
  2070. With a 50% commission, user #A gets half of the points successive users spend
  2071. downloading (with our example, user #A would get 11 points when #B downloads the
  2072. file, and 11 points when #C downloads, etc.).
  2073.  
  2074. With a 100% commission, the uploader gets all of the points spent by users
  2075. downloading. This high percentage works particularly well when the upload factor
  2076. is 0, so the user gets points only when his uploads are downloaded, and thus
  2077. people are encouraged to upload only useful data which other people will want,
  2078. and users waste their time when they upload junk.
  2079.  
  2080.  - Upload Time Returned:  When a user spends time uploading, some amount of that
  2081. time can be given back to the user so he has more time on your system that day.
  2082. The upload time box contains a percentage value for this awarded time.  With an
  2083. upload time factor of 200%, a user who spends 5 minutes uploading will receive
  2084. 10 more minutes of on-line time. A 100% upload time factor would return 5
  2085. minutes, and a 50% factor would return about 2 and a half minutes.  The download
  2086. k limit for the current call is also increased by this same ratio. If the user
  2087. uploads a 100k file, and there is a 200% upload time factor, the user's daily
  2088. download limit will be extended by 200k (for the current call only)
  2089.  
  2090.  - Space to U/L:  The minimum space on the upload drive required to allow an
  2091. upload. If free space falls below this value, users will not be able to upload.
  2092.  
  2093.  - Transfer Processing: The transfer processing section has 5 options:
  2094.  
  2095. Verify U/L   - integrity verification of a ZIP, ARJ, or LHA/LHZ Archive.
  2096.  
  2097.   -----------------------------------------------------------------
  2098.     Celerity v2.0                                         Page 29
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.                 -= Celerity v2.0 Operations Manual =-
  2105.   -----------------------------------------------------------------
  2106.  
  2107. Virus Scan   - Will Use the path specified in "Tool Paths" to Scan Uploads for
  2108. Nasty Bugs.
  2109. Comment U/L  - add a ZIP, ARJ, or LHA comment to the file from COMMENT.ASC in
  2110. the BBS Directory.  Note that ARJ comments can only be 25 lines long.
  2111. Clean U/L    - Delete all ads from the U/L by removing any files that match ones
  2112. listed in DELETE.ADS in the Main BBS Directory.
  2113.  
  2114.  - Download Rates:  SysOps do not like slower users spending an inordinate
  2115. amount of time downloading from their transfer sections, but may recognize their
  2116. value in the message bases.  Celerity allows a SysOp to determine which bps
  2117. rates may download from the BBS and which may not This way, a slow user could be
  2118. allowed to log onto your system, but only to use the non-transfer sections of
  2119. the BBS.
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.   -----------------------------------------------------------------
  2157.     Celerity v2.0                                         Page 30
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.                 -= Celerity v2.0 Operations Manual =-
  2164.   -----------------------------------------------------------------
  2165.  
  2166. Color Settings
  2167. --------------
  2168.  
  2169. Color Setup:  This section has an impact on the appearance of your system,
  2170. particularly the default user colors.  Although users can and do change their
  2171. colors, many people get a first impression from the look of the default color
  2172. set.  Note that language files (See "The CelerityText Display System" in Section
  2173. 4 below) may have default colors with them which will be loaded when a user
  2174. selects it.
  2175.  
  2176. The color setup dialog in  CELSETUP.EXE is a bit different from other menus.  It
  2177. contains two scroll boxes, two color boxes, a window with an example, and the
  2178. normal OK and CANCEL buttons.  To operate the color selector, select the general
  2179. color set in the left box.  The color sets include "BBS Colors", "SysOp Tools",
  2180. and "Status Line". Moving over to the middle box, you can select which specific
  2181. color within the set you wish to edit.  The two boxes to the far right specify
  2182. the foreground and background choices for that particular color.
  2183.  
  2184.  - BBS Colors:  These are the eight colors for the BBS that new users will be
  2185. set up with when they apply.  These colors can be changed to suit the user's
  2186. particular tastes.  Note that when you define color #8, it must have a
  2187. background that is different from the others.
  2188.  
  2189.  - SysOp Tools:  These two colors are used to determine the color format of the
  2190. on-line SysOp Tool kit.
  2191.  
  2192.  - Status Line:  This defines the color of the status bar at the bottom of the
  2193. SysOp's screen.
  2194.  
  2195.  - Wait For Call:  This is a set of about six foreground colors and one
  2196. background color for the wait for call screen.
  2197.  
  2198.  - Error Warnings:  When certain errors occur, Celerity will show a box warning
  2199. the SysOp about it.  You can determine the color of that box here.
  2200.  
  2201.  - Lightbar Shell:  If you use the Lightbar shell, you can determine the color
  2202. of the bar here.
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.   -----------------------------------------------------------------
  2216.     Celerity v2.0                                         Page 31
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.                 -= Celerity v2.0 Operations Manual =-
  2223.   -----------------------------------------------------------------
  2224.  
  2225. Pathnames
  2226. ---------
  2227.  
  2228. The pathnames dialog contains information regarding the location of various data
  2229. files for Celerity's use.  The default directories are recommended, but they can
  2230. be custom tailored, of course.
  2231.  
  2232.  - BBS Directory:  This is the main directory where assorted data files are
  2233. kept, including user lists, comment batch files, and the majority of other
  2234. files. Note that in a multinode system, this directory should be the same for
  2235. all nodes.
  2236.  
  2237.  - Temp Directory:  This is a directory for temporary file creation. It should
  2238. have no subdirectories, nor should it contain anything you wish to keep.  This
  2239. directory should be independent for each node.
  2240.  
  2241.  - Node Directory:  The directory where node-specific files are stored. The
  2242. main.bat, celerity.*, and setup.* files should be here, and other files may be
  2243. created and stored here by Celerity. On a single node system, this may be the
  2244. same as the BBS directory. On a multinode system, this must be separate for each
  2245. node.  If you have a registered system, your CELERITY.KEY file should be here
  2246. too.
  2247.  
  2248.  - MultiNode Directory:  If you have a multinode BBS, this directory will be
  2249. used for multinode chat and line status information.  It is recommended that
  2250. this be located in a RAMdisk if you use one.
  2251.  
  2252.  - Conference Directory:  When Celerity creates message storage files, they will
  2253. be kept here.  Note that these files can become quite large.
  2254.  
  2255.  - Data files:  Information regarding your transfer section configuration will
  2256. be stored here. Directory files (*.DIR) containing the file records for your
  2257. transfer section are also stored in this directory. Moving this to a large
  2258. RAMdisk can increase the speed of the system substantially, but be sure to
  2259. update the files on the hard drive after each call (see "Running Celerity with a
  2260. RAMdisk" below). 
  2261.  
  2262.  - Display Files:  SysOp-defined display files (see "Customizing Celerity"
  2263. below) and information script files are stored here. 
  2264.  
  2265.  - Network Files:  If you use CelerityNet, HermesNet, or FidoNet, this directory
  2266. will be used for networking files.
  2267.  
  2268.  - Door Files:  Door.Bat data files may be stored here.  See the section on
  2269. "Setting up Doors."
  2270.  
  2271.  - Sound Files:  If you use the digitized chat call, place all of your .VOC
  2272. files in this directory.
  2273.  
  2274.   -----------------------------------------------------------------
  2275.     Celerity v2.0                                         Page 32
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.                 -= Celerity v2.0 Operations Manual =-
  2282.   -----------------------------------------------------------------
  2283.  
  2284.  - New User Uploads:  If you use a validation upload system (see "New User
  2285. Options"), this directory will be used to store the archive listing of the
  2286. user's upload, as well as the uploaded file. 
  2287.  
  2288.  - ANSI Art Files:  The art files for the Art Gallery are stored here. They can
  2289. be ASCII, ANSI, RIP, or NAPLPS format.
  2290.  
  2291.  - Language (CelerityText) files:  They have extensions of .LNI and .LNG, and
  2292. contain sets of text for the BBS use.  There is a single .LNI and .LNG file for
  2293. each language profile.  The extensions will be .DSI and .DSP (for display menu
  2294. index, and display menu data). Users will select different menu sets based on
  2295. their term emulation (TTY, VT100, ANSI, Avatar, NAPLPS, RIP, etc.) These files
  2296. are also kept in the Language File Directory.  See the section on "The
  2297. CelerityText Display System" in section 4 for full details.
  2298.  
  2299.  - Email Uploads:  Electronic mail data, files attached to electronic mail, and
  2300. user notes will be stored here.
  2301.  
  2302.  - Swap Files:  Where data will be swapped to when celerity needs to shell out.
  2303. A RAMdisk with about 600k in it is best for this.
  2304.  
  2305.  - Directory for Archive: Temporary directory to be used by the archive
  2306. processor.  Do not store anything in this directory, or make subdirectories off
  2307. this directory, as they will be deleted.
  2308.  
  2309.  - Directory for Slow Files: If a user downloads from a transfer area marked as
  2310. a "slow volume", such as near-line storage (tape on a network), CD-ROM, optical
  2311. storage, jukebox, floppy, etc., files will be copied to this temporary directory
  2312. before the user downloads them.  This directory should be on a hard drive with
  2313. sufficient space for the largest possible download from the slow volume.
  2314.  
  2315. If you have the storage space, it is recommended that you reserve a dedicated
  2316. partition for Celerity temporary use.  Put all of your TEMP, ARCHIVE, SLOW, and
  2317. NETWORK directories here (for all nodes). This way, if the drive where the BBS'
  2318. main files are fills up, users will still be able to download slow files, your
  2319. network can continue to function, and so forth.  A 40 megabyte partition is
  2320. probably the largest this partition would ever need to be even on a large
  2321. multi-line board.  It should be big enough to store all network data at its
  2322. largest, plus big enough to store the biggest upload a user might make, plus an
  2323. extra 1.5 megabytes or so. 
  2324.  
  2325.  - WFC scan Drives: This allows you to specify up to 4 drives which will be
  2326. shown in the WFC storage statistics. Example: CDFG will display the Storage
  2327. statistics for Drives C, D, F, and G  (This prevents "virtual drives" like
  2328. stacker drives from being counted twice).
  2329.  
  2330. A detailed list of all files which should appear in these paths, and what data
  2331. they contain, can be found in Appendix C.
  2332.  
  2333.   -----------------------------------------------------------------
  2334.     Celerity v2.0                                         Page 33
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.                 -= Celerity v2.0 Operations Manual =-
  2341.   -----------------------------------------------------------------
  2342.  
  2343. Tool Paths
  2344. ----------
  2345.  
  2346. The tool pathnames subdialog contains information regarding the location of
  2347. various utilities for Celerity's use.  If you have any of these utilities, enter
  2348. the full path to them. (Just the Path, not the actual filename!)
  2349.  
  2350. If you do not have a utility, leave the entry blank.
  2351.  
  2352. The first 8 paths are for archive manipulations.
  2353.  
  2354. The GIF Viewer path is for a General Picture Viewer (VuImage Pro or Vpic are
  2355. recommended).
  2356.  
  2357. The Virus Scan Path is used by the internal Upload processor to assist in
  2358. examining uploads.
  2359.  
  2360. The Virus Scan Command consists of both the program you wish to use (SCAN, NCAV,
  2361. etc) and the Flags you wish added to the commandline.
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.   -----------------------------------------------------------------
  2393.     Celerity v2.0                                         Page 34
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.                 -= Celerity v2.0 Operations Manual =-
  2400.   -----------------------------------------------------------------
  2401.  
  2402. Multinode Options
  2403. -----------------
  2404.  
  2405. This dialog is used to set up an individual node on a BBS running multiple
  2406. nodes. (For details on multinode operations, please see the chapter on
  2407. Multi-Node Operation below)
  2408.  
  2409.  - Allow Multiple Logins: Should a user be allowed to log-in to multiple nodes
  2410. simultaneously?  Some users who have more than one phone line and multiple
  2411. modems may wish to use multiple lines of your BBS simultaneously, but you may
  2412. not wish for one user to tie up so many resources at once.
  2413.  
  2414.  - Use Direct Chat:  Celerity BBS supports a full-screen character- by-character
  2415. chat mode featuring a seperate dynamically-sized window  for each node of the
  2416. BBS.  It works quite well under a well-behaved environment, but can be draining
  2417. on resources, and may not function well under some multitasking environments or
  2418. network setups.  If it does not work well on your system, or you do not want to
  2419. use it, do not select this box.
  2420.  
  2421.  - Node Name: This node "identifier" may be shown in the node list to identify
  2422. the this node by name.  Commonly the phone number would be used on a system
  2423. which does not have number hunting.
  2424.  
  2425.  - BBS Node Number: Each node must have a separate BBS node number, starting at
  2426. 1 and working upwards.
  2427.  
  2428.  - Maximum Users In Chat: If you want to limit the multinode chat to a certain
  2429. number of users, you can limit it here.  Setting it to 0 will effectively
  2430. disable multinode chat.
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.   -----------------------------------------------------------------
  2452.     Celerity v2.0                                         Page 35
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.                 -= Celerity v2.0 Operations Manual =-
  2459.   -----------------------------------------------------------------
  2460.  
  2461. Chat Options
  2462. ------------
  2463. Various text messages will be displayed regarding the availability of the SysOp
  2464. to chat and upon initiation and ending of a chatting session.
  2465.  
  2466.  - SysOp Available:  When the user logs on, if the SysOp is available to chat,
  2467. this message will be displayed.
  2468.  
  2469.  - SysOp Not Available:  If the SysOp is not available, this message will be
  2470. displayed.
  2471.  
  2472.  - Chat Welcome:  When the SysOps enters chat, this line is displayed.
  2473.  
  2474.  - Chat Goodbye:  When the SysOp exits chat, this is displayed.
  2475.  
  2476.  - Obnoxious Chat:  This check box will make the chat call loud and obnoxious,
  2477. ensuring that the SysOp hears it.
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.   -----------------------------------------------------------------
  2511.     Celerity v2.0                                         Page 36
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.                 -= Celerity v2.0 Operations Manual =-
  2518.   -----------------------------------------------------------------
  2519.  
  2520. System Passwords
  2521. ----------------
  2522. Various access aspects of Celerity are password protected.  If you wish
  2523. passwords to be required, define them here.
  2524.  
  2525.  - Security Password:  When a user with SysOp access logs on, he or she will be
  2526. required to enter the security password to access SysOp options.
  2527.  
  2528.  - System 1 Password:  If you use a login shell, you can define passwords a user
  2529. will be required to enter before accessing the system.  System 1 password is for
  2530. the main BBS.
  2531.  
  2532.  - System 2 Password:  See System 1 Password above.  For external system #2.
  2533.  
  2534.  - System 3 Password:  See System 1 Password above.  For external system #3.
  2535.  
  2536.  - Emergency Chat:  Users who know the emergency chat password can force the
  2537. system to make a cacophony of obnoxious sound, guaranteed to get your attention
  2538. if you are within a square mile of the BBS computer. This command is accessed by
  2539. typing "/page" at any BBS prompt.
  2540.  
  2541.  - Low Speed Lockout:  If you define a password here, a user calling at an
  2542. unsupported bps rate(see Modem setup, above) can enter it to bypass the low
  2543. speed restriction.
  2544.  
  2545.  - New User Password:  If a password is defined in this field, new users will be
  2546. required to enter it before applying for access.
  2547.  
  2548.  - Shell CAE Password: If you setup a CAE from your login shell (ie: a
  2549. generally-accessible transfer section which does not require a user account),
  2550. you can protect it with the CAE password.
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.   -----------------------------------------------------------------
  2570.     Celerity v2.0                                         Page 37
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.                 -= Celerity v2.0 Operations Manual =-
  2577.   -----------------------------------------------------------------
  2578.  
  2579. Timed Events
  2580. ------------
  2581.  
  2582. Celerity can be configured to perform certain functions at specific times of the
  2583. day. To disable an event, clear out the start and end times.
  2584.  
  2585.  - Restricted Hours:  A system may be set up to allow only users of a certain
  2586. level on during a period of time.  The "begin" and "end" fields here allow you
  2587. to specify the period.  See "Required Access Levels" below to determine the
  2588. access level required to access the system during this time. Please use 24-hour
  2589. format.
  2590.  
  2591.  - SysOp Available:  If you set the SysOp availability flag to "By Time" at the
  2592. WFC Screen, the SysOp chat availability will be determined by the time specified
  2593. here. Please use 24-hour format.
  2594.  
  2595.  - Batch Event:  Celerity can have one external batch file executed at a certain
  2596. time.  Define that time and batch file name here.  This file can be used to run
  2597. door maintenance files and the like.  Please use 24-hour format.
  2598.  
  2599.  - Time to Backup:  At this time, a file called "BACKUP.BAT" will be executed.
  2600. This file should be used to make a daily backup of important information such as
  2601. user lists, file directories, and possibly message bases.  Note that this file
  2602. can copy files to a floppy, to another hard drive, or even execute a tape backup
  2603. program.  Please use 24-hour format.
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.   -----------------------------------------------------------------
  2629.     Celerity v2.0                                         Page 38
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.                 -= Celerity v2.0 Operations Manual =-
  2636.   -----------------------------------------------------------------
  2637.  
  2638. Access Levels
  2639. -------------
  2640.  
  2641. A user's access level can determine which BBS functions he or she may or may not
  2642. perform.  These functions are determined below.
  2643.  
  2644.  - Access BBS:  Users at and above this level will be permitted to log onto the
  2645. system.  Users below this level will get a "You are not yet validated" message.
  2646. This value Must be set higher then the new user access level set above if you
  2647. want them to receive an approval status display.
  2648.  
  2649.  - CoSysOp Activities:  Users of this level and above may access SysOp menus.
  2650.  
  2651.  - Post Anonymous:  If a sub-board supports anonymous posting, a user of this
  2652. level may make a post anonymously.
  2653.  
  2654.  - Post a Message: This level is required to write or upload a message to a
  2655. message base.
  2656.  
  2657.  - Leave Automessage:  This level is required for a user to leave an automessage
  2658. for future callers to read.
  2659.  
  2660.  - Login During Restricted Hours:  This is the access level required for the
  2661. restricted hours.  See "Timed Events" for more details.
  2662.  
  2663.  - Show Anonymous Name:  Users of this level and above may see who really posted
  2664. a message anonymously.
  2665.  
  2666.  - List Users:  A user with this level can see the userlist from the main menu.
  2667.  
  2668.  - List Recent Callers:  A user with this level can show a list of recent
  2669. callers.
  2670.  
  2671.  - List Xfer Activity:  Users with this level may list recent upload and
  2672. download activity.
  2673.  
  2674.  - Show System Status:  To see the storage statistics, a user must have this
  2675. level.
  2676.  
  2677.  - Show System History:  Users who have this level may view the system history
  2678. records.
  2679.  
  2680.  - Top Ten Exemption:  Users with this level and above will not be counted in
  2681. the calculation of the top ten posters, leeches, and uploaders.  Useful if you
  2682. do not wish sysops or cosysops to appear on these lists.
  2683.  
  2684.  - File Point Loan:  Users must have this level to take out a file point loan.
  2685.  
  2686.  
  2687.   -----------------------------------------------------------------
  2688.     Celerity v2.0                                         Page 39
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.                 -= Celerity v2.0 Operations Manual =-
  2695.   -----------------------------------------------------------------
  2696.  
  2697.  - Upload to Art Gallery: Need this level to upload to the Art Gallery.
  2698.  
  2699.  - Make a QWK Pack: Need this level to make a QWK pack.
  2700.  
  2701.  - Expired Security Level: Unused with v2.02 (superceded by access templates).
  2702.  
  2703.  - Expired Transfer Level: Unused with v2.02.
  2704.  
  2705.  - User Time Per Day:  This array of fields defines the amount of time per day
  2706. users will get on your system as a default.  If there is an access template for
  2707. a user's access level, the template's time will be used.  If the user has a time
  2708. set individually, that time will take precedence.
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.   -----------------------------------------------------------------
  2747.     Celerity v2.0                                         Page 40
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.                 -= Celerity v2.0 Operations Manual =-
  2754.   -----------------------------------------------------------------
  2755.  
  2756. Login Shell
  2757. -----------
  2758.  
  2759. When a caller first connects to Celerity, the system can display a connection
  2760. header, and detect terminal emulation.  The user may then be presented with a
  2761. logon shell or command menu, if you choose to use one as many boards do these
  2762. days.  Usage of a logon shell allows you to insolate the new user process from
  2763. the main board itself, and to protect the system from unwanted callers. A user
  2764. who enters the shell will be presented with a menu of choices, which
  2765. have static operations but can have their command keywords customized (see
  2766. "Login Commands" below). 
  2767.  
  2768.  - Connect Header:  When the user first connects, they will be presented with a
  2769. connection status message (eg: CONNECT 14400/ARQ/HST) unless there is a message
  2770. in this field, in which case that message will be displayed.
  2771.  
  2772.  - Terminal Detection:  If you mark this check box, Celerity will attempt to
  2773. determine the user's terminal emulation.  It can differentiate between TTY,
  2774. VT-100, ANSI, and Avatar.  Note that Celerity cannot detect Avatar emulation
  2775. from the DOS Telix program because of the incomplete Avatar support in Telix. If
  2776. this box is not checked, Celerity will assume VT100/ANSI emulation for all
  2777. users.  Note that if you have this box checked and users do not get thier
  2778. emulation detected, you may need to increase the "Connect Delay" in the modem
  2779. setup dialog.
  2780.  
  2781.  - Login Shell Type:  Celerity supports five separate shell types:
  2782.  
  2783. No Shell:  The user will be dropped directly into the BBS (username prompt).
  2784.  
  2785. Menu Shell:  The menu shell gives the configurable command line. Hitting a '?'
  2786. or typing 'help' provides the user with a list of supported commands. If you
  2787. wish to have a custom shell menu, you can make a file called SHELL.1 in your
  2788. menu directory that will be displayed when the '?' is hit.  Be sure that it has
  2789. all the commands the user may select. (See the "Login Commands" section
  2790. below).
  2791.  
  2792. DOS Emulator:  The DOS simulator shell will place the caller into a DOS
  2793. simulator, where they will run separate "programs" corresponding to the shell
  2794. commands.  The shell commands (see "Login Commands" below for definition) will
  2795. be converted to DOS filenames in the form of .EXE, .COM, or .BAT files (ie: if
  2796. you choose "Login" as the command to enter the main BBS, the DOS name will be
  2797. "LOGIN.EXE").  If the user types DIR, they will be presented with a "directory"
  2798. listing of the commands, or else the optional SHELL.2 file from the DISPLAY
  2799. directory.
  2800.  
  2801. VMS Shell:  The VMS simulator simulates a Digital Equipment Corp machine running
  2802. VMS.  While this shell is functional, few sysops will have use of it as most
  2803.  
  2804.  
  2805.   -----------------------------------------------------------------
  2806.     Celerity v2.0                                         Page 41
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.                 -= Celerity v2.0 Operations Manual =-
  2813.   -----------------------------------------------------------------
  2814.  
  2815. users are not familiar with VMS. UNIX Shell:  The UNIX shell provides a login
  2816. shell for those who are familiar with the UNIX operating system.
  2817.  
  2818. Lightbar:  A list of the available options is presented on a lightbar menu.
  2819. Users may select which option they wish by typing the corresponding number, or
  2820. by selecting the option with the bar and pressing enter.  The user must have
  2821. ANSI, VT100, or Avatar emulation to use this.  If the caller does not have one
  2822. of these terminal emulations, s/he will get the menu shell.
  2823.  
  2824. CelerityText Shell:  This shell operates similar to the LightBar shell, except
  2825. all entries are defined as CelerityText.  This enables the sysop to create his
  2826. own interactive shell.  As the shell is fully configurable, you can make
  2827. Celerity look like some other type of system.  Have it mimic a mainframe or mini
  2828. if you want to conceal the fact that it is a private bulletin board system.
  2829. Using the connect string, the SHELL.1 help screen, and the definable shell 
  2830. commands, you can make the shell look like anything you like.  The CelerityText
  2831. shell can also support full screen animated login shells.
  2832.  
  2833. External Shell:  If you are a programmer and wish to write your own shell
  2834. routines called EXTERN.EXE, select this option and Celerity will call it.
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.   -----------------------------------------------------------------
  2865.     Celerity v2.0                                         Page 42
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.                 -= Celerity v2.0 Operations Manual =-
  2872.   -----------------------------------------------------------------
  2873.  
  2874. Login Commands
  2875. --------------
  2876. To make each system's login shell a little more unique, Celerity allows sysops
  2877. to define the commands used to perform various shell functions. Users will be
  2878. required to enter these command words in the Menu, DOS, and VMS shells.  An
  2879. option menu will be displayed on the menu when users type '?', 'dir', or 'ls'
  2880. for the Menu, DOS, and VMS shells respectively unless the SHELL.1, SHELL.2,
  2881. SHELL.3 SHELL.4, or SHELL.5 files exist in the menu directory, in which case
  2882. they will be displayed instead.  Note that the lightbar shell does not require
  2883. users to enter keywords.  To disable an option, simply clear its respective
  2884. command field, and that option will not be offered to the user.
  2885.  
  2886. Login Shell Commands:  There are three login shell commands, one for each
  2887. virtual system.  The first is for your main BBS, while #2 and #3 are for
  2888. external BBS programs.
  2889.  
  2890. Apply For Access:  This command is what a new user must enter to apply for
  2891. access to the main system.  A user must give a new user pass if it is required
  2892. (see "System Passwords"), and fill out any information forms the SysOp has
  2893. defined.  See "The New User Process" for more.
  2894.  
  2895. Check:  This command allows a new user to check on the status of his or her
  2896. application in the main system.  If the user has been validated, he or she will
  2897. be given the password to system 1, and be allowed to enter. If the new user
  2898. voting system is enabled, the user will be informed as to the up-to-the-minute
  2899. results of the voting.
  2900.  
  2901. Feedback:  This option allows users to leave feedback to the SysOp from the
  2902. shell.
  2903.  
  2904. Chat:  If a user enters this keyword, and the SysOp is available, the SysOp will
  2905. be paged for a chat.
  2906.  
  2907. Log Off:  This command will log the user off the system, hanging up the modem
  2908. and returning to the Wait for Call screen or DOS.
  2909.  
  2910. CAE:  If you set up a CAE section from your login shell, users can access it
  2911. with this command.  See the "Modes of Operation - CAE Mode" section below for
  2912. more details.
  2913.  
  2914. Command Prompt:  The prompt line for the logon shell (for the Menu shell only)
  2915. may be defined to add an additional flair of originality to the BBS. Common
  2916. prompt lines include "[Command/?]" and "Login:".
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.   -----------------------------------------------------------------
  2924.     Celerity v2.0                                         Page 43
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.                 -= Celerity v2.0 Operations Manual =-
  2931.   -----------------------------------------------------------------
  2932.  
  2933. Information Scripts
  2934. -------------------
  2935.  
  2936. The Information Script Section is used to define which Pre-defined Infoforms
  2937. will be used by your system. (For directions on creating information scripts,
  2938. see section 4 below for detailed directions)
  2939.  
  2940.  - Form Title: The name of the information script.  There are a couple of
  2941. "Special" information script locations that you need to be aware of:
  2942.  
  2943. Script #1: This is traditionally defined as the Sysop's Information  Form. The
  2944. filled out form is displayed to the Sysop when in the New User Voting (NUV)
  2945. Section.
  2946.  
  2947. Script #5: This is coded as the New User Application. This form, when filled
  2948. out, will be displayed to all the users who are members of the New User Voting
  2949. Committee if you use the NUV system. 
  2950.  
  2951.  - Force Use: When checked, all users MUST fill this form out before they can
  2952. gain access to the BBS.
  2953.  
  2954.  - Min Level: Users must have a level >= to this before they are allowed to fill
  2955. out the form.
  2956.  
  2957.  - Max Level: Users must have a level <= to this before they are allowed to fill
  2958. out the form.
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.   -----------------------------------------------------------------
  2983.     Celerity v2.0                                         Page 44
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.                 -= Celerity v2.0 Operations Manual =-
  2990.   -----------------------------------------------------------------
  2991.  
  2992. New User Options
  2993. ----------------
  2994.  
  2995. The following options all relate to how new users are handled by your system. 
  2996. New users will normally be asked to fill out information scripts, and on some
  2997. systems will be subjected to the New User Voting section.  Other functions
  2998. related to the new user process include the new user password, Local User
  2999. Lockout, and Quick Validate.
  3000.  
  3001.  - New User Toggles:  This cluster contains check boxes to enable or disable
  3002. various features of the new user section. 
  3003.  
  3004.  - Refuse New Users:  If this box is marked, someone who applies as a new user
  3005. will have the PRIVATE.BBS file (from the display directory) displayed, and will
  3006. not be permitted to apply.
  3007.  
  3008.  - Hang Up after application:  Checking this box will make Celerity hang up on
  3009. new users after they finish their application.
  3010.  
  3011.  - Require New User Upload:  Checking this box will enable a unique Celerity
  3012. feature: the validation upload.  New users who call will be asked to upload a
  3013. new file for examination by the SysOp and the new user voting panel.  The text
  3014. the user is presented with may be tailored to your system by creating a file
  3015. called VALIDUD.BBS in your menu directory.  Note that the upload must be in the
  3016. ZIP format.
  3017.  
  3018.  - Save New User Uploads:  If the SysOp wishes to keep the uploaded file, he
  3019. must check this box.  If this box is not checked, only a record of the upload (a
  3020. zip listing) will be saved.  These files will be stored in the new user upload
  3021. directory.
  3022.  
  3023.  - Require Feedback:  If this box is checked, new users will be asked to leave a
  3024. letter requesting access to the system staff.
  3025.  
  3026.  - Ask for User Address:  Checking this box will ask new users for their
  3027. complete mailing address.
  3028.  
  3029.  - New User Note:  Every user has a special user note which can tell the name of
  3030. his or her bbs, an organization he or she belongs to, or a comment about the
  3031. user's access level.  There is a toggle in the look at feel section which will
  3032. allow users to define their own note.  For new users, you can determine the
  3033. default note that they will be given here.
  3034.  
  3035.  - Send New User Feedback To:  This field allows you to specify the name of the
  3036. cosysop who should receive new user feedback (Useful if you have a high volume
  3037. system, requiring a person (a cosysop) who is dedicated to the task of
  3038. validating new users) 
  3039.  
  3040.  
  3041.   -----------------------------------------------------------------
  3042.     Celerity v2.0                                         Page 45
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.                 -= Celerity v2.0 Operations Manual =-
  3049.   -----------------------------------------------------------------
  3050.  
  3051.  - New User Access Level:  New users will be granted this access level. Note
  3052. that if this level is under the level required to access the BBS, the user will
  3053. not be permitted to access the system until validated.
  3054.  
  3055.  - New User Xfer Points:  If you use a file point system, this field can be used
  3056. to give new users a few points to get started with.
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.   -----------------------------------------------------------------
  3101.     Celerity v2.0                                         Page 46
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.                 -= Celerity v2.0 Operations Manual =-
  3108.   -----------------------------------------------------------------
  3109.  
  3110. New User Voting
  3111. ---------------
  3112.  
  3113. The purpose of the New User Voting (abbreviated NUV) system is to allow the
  3114. users of a system have a say in who gets access and who doesn't to the system.
  3115. There are five data options in the setup relating to the New User Voting.
  3116.  
  3117.  - Enable New User Voting:  This turns the section on and off.  If it is off, no
  3118. other NUV options will be used.
  3119.  
  3120.  - Automatically Validate and Delete:  If this check box is marked, a new user
  3121. will be validated or deleted when they gain the required number of votes for
  3122. either category.  If this is turned off, a user with NUV SysOp access must
  3123. manually P)rocess those applicants who are pending validation or denial.
  3124.  
  3125.  - Yes Votes:  This is the number of yea votes a new user will be required to
  3126. get before being validated.
  3127.  
  3128.  - No Votes:  This is the number of nay votes a user can garner before being
  3129. denied access to the system.
  3130.  
  3131.  - Level to Use NUV:  Users must have this level to enter the new user voting
  3132. section from the main menu. Set this higher then the New user security level to
  3133. prevent a user from voting on himself!
  3134.  
  3135.  - Level to Force NUV:  If a user has this level, he or she will automatically
  3136. be dropped into the NUV system when they log onto the system if there are new
  3137. users to vote on.  This is a handy way of making your high access users do
  3138. something with their access.
  3139.  
  3140. The process works like this.  When a new user logs on, the applicant will enter
  3141. all their normal information, plus Information Script #5, which is reserved for
  3142. the New User Voting section. The applicant will be given 0 Yes and 0 No votes.
  3143. When other users call, they may enter the New User Voting section and view the
  3144. existing  applicants awaiting a decision.  They may scan for applicants they 
  3145. have not voted on, and be given the option to view the special fifth Information
  3146. Script,(Sysops can also View Information Script #1, the Sysop Application
  3147. Information Script) and make a judgement (yes, no, or abstain) on the applicant. 
  3148. Users may change their vote at any time before the Yea or Nay threshold has been
  3149. reached.  Voting users may enter a 50-character comment regarding the user.
  3150. Sysops have 2 additional Choices: Veto Validate and Veto Delete which overrides
  3151. the voting statistics for the Applicant. When the new user attempts to log on
  3152. again, he or she will be given an up-to-date status report on how the voting is
  3153. going.
  3154.  
  3155.  
  3156. If enough YES votes are cast, the new user will be auto-validated (as per the
  3157. quick validate parameters set by the SysOp - create a template with the name
  3158.  
  3159.   -----------------------------------------------------------------
  3160.     Celerity v2.0                                         Page 47
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.                 -= Celerity v2.0 Operations Manual =-
  3167.   -----------------------------------------------------------------
  3168.  
  3169. "New User Voting") if the auto-validate option above is set.  Otherwise, the new
  3170. user votes must be P)rocessed by the Sysop to finally validate or delete the
  3171. users.
  3172.  
  3173. If enough NO votes are cast, the user will be given an access level of -5, which
  3174. will give the user a message saying "Your application has been denied by the
  3175. user voting panel", and the users record will be deleted when he/she logs on
  3176. again.  The text file "DENIED.BBS" will be displayed to users who have been
  3177. turned down. If the automated NUV option is turned off, the SysOp must manually
  3178. decide on each of the users before this action is taken.
  3179.  
  3180. Some new users will never call back, and in this case, the SysOp can simply scan
  3181. for users with -5 access who have not called in a week or so and delete them.
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.   -----------------------------------------------------------------
  3219.     Celerity v2.0                                         Page 48
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.                 -= Celerity v2.0 Operations Manual =-
  3226.   -----------------------------------------------------------------
  3227.  
  3228. Local User Options
  3229. ------------------
  3230.  
  3231. To many sysops, local users can be valued members of their system.  To others,
  3232. however, they can be the bane of quality.  The assumption that "good users will
  3233. call long distance to find good boards" is often found to be true.  If your
  3234. objective is to have the largest base of users as possible, you would not want
  3235. to restrict local users.  If, however, you want an intimate system specializing
  3236. in users from locations from all over the world, you would want to consider
  3237. limiting local access.  Thus, Celerity offers the Local User Lockout
  3238. (abbreviated as LUL) system to limit the number of locals permitted on the
  3239. system.  A local user is considered by Celerity to be one calling from the same
  3240. area code or set of local area codes as that of the BBS.  
  3241.  
  3242.  - Use Local User Lockout:  This simply enables the LUL system.
  3243.  
  3244.  - Local User Percentage:  This is the percentage of local users allowed on the
  3245. system.  Thus, as the system gets larger, the ratio of locals to non-locals
  3246. remains consistent.  Some boards set this value as low as 5 or 10%.  Note that
  3247. if additional local users are added manually by the SysOp, or if non-local users
  3248. are deleted from the system, or if this number is lowered, the actual percentage
  3249. of local users may be higher than this value.  Until the percentage falls below
  3250. this defined value, no additional local users will be accepted.
  3251.  
  3252.  - Lockout Message:  This is a single-line message which will be displayed to a
  3253. user who has been locked out by the LUL.
  3254.  
  3255.  - Local Area Codes: The Area Codes entered here will be considered as "Local"
  3256. when implementing the Local User System (Useful for Large Metropolitan areas
  3257. that have several area codes). To use, simply enter the Area Codes, Separated by
  3258. Semi-colons. Example: The Los Angeles/Orange/San Bernardino/Riverside
  3259. quad-county area in Southern California would have a Local Area Codes listing
  3260. like this: 213;310;818;714;909
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.   -----------------------------------------------------------------
  3278.     Celerity v2.0                                         Page 49
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.                 -= Celerity v2.0 Operations Manual =-
  3285.   -----------------------------------------------------------------
  3286.  
  3287. User Ratios
  3288. -----------
  3289.  
  3290. User ratios are an effective means of measuring performance by users, and can be
  3291. used with the same degree of fairness for both new users and veterans of your
  3292. system.  Celerity has three different ratios which can be used to restrict a
  3293. user from downloading.  These are outlined below. In each case, there are two
  3294. values to be set in CELSETUP.  The first is the ratio you wish to require, and
  3295. the second is an access level a user may have to be exempt from that ratio. 
  3296. Also note that the user exemption flags can exempt a user from ratios as well,
  3297. despite his or her access level.
  3298.  
  3299. Please see the "Access Templates" section below for details on how multiple
  3300. ratio setups can be established for different access levels.
  3301.  
  3302.  - Post/Call Ratio:  Also known as a PCR, this is a number which considers the
  3303. number of posts a user has made against the number of calls made. If a user has
  3304. made 75 posts and 100 calls, his ratio would be (75 / 100) .75, or 75%. 
  3305. Although quality users find it easy to maintain ratios of 200% or 300%, many
  3306. users will find the ratio excessively binding if it is over 50% (one post per
  3307. two calls).
  3308.  
  3309.  - Upload/Download Ratio:  Known as a UDR, this ratio calculates the number of
  3310. uploaded files divided by the number of downloads (a separate kbytes uploaded vs
  3311. kbytes downloaded ratio is also maintained).  If the user downloads excessively,
  3312. this ratio can be used to cajole him or her into uploading occasionally to
  3313. maintain his or her ratio.
  3314.  
  3315.  - General Ratio:  This ratio is a composite of the PCR and UDR. If you choose
  3316. to make this the main restriction, users can specialize in either subs or
  3317. transfers and not be penalized for it. Users who have an extremely good UDR but
  3318. don't post often won't find themselves restricted, and vice versa.  This can be
  3319. a happy medium for SysOps who wish their users to contribute to the subs,
  3320. but don't want to exclude users who are poor posters yet good uploaders.
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.   -----------------------------------------------------------------
  3337.     Celerity v2.0                                         Page 50
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.                 -= Celerity v2.0 Operations Manual =-
  3344.   -----------------------------------------------------------------
  3345.  
  3346. Access Templates
  3347. ----------------
  3348.  
  3349. The access template system allows the sysop to set up a number of ratio, daily
  3350. time, and daily download limits which are indexed by the user's access level
  3351. without setting each user's options individually.
  3352.  
  3353. When you select the Access Template dialog, you will see a list box containing a
  3354. list of all defined access templates.  This list will contain a brief
  3355. description, and the level range the template will affect.  Five buttons at the
  3356. bottom of the dialog allow you to A)dd a new template, E)dit an existing
  3357. template, R)emove an existing template, S)ave the template list, or C)ancel all
  3358. your changes. 
  3359.  
  3360. If you A)dd a new template (or edit an existing template), you will be presented
  3361. with a detailed dialog which will prompt you for the following:
  3362.  
  3363. Template Description:  This describes the access template.  You might name it
  3364. "New Users" or "Basic Access" or "Valued Users" or "The BBS Staff".  
  3365.  
  3366. Access Range:  The access range specifies what the lowest level of user affected
  3367. by the template is, and what the highest level should be. Make sure that the low
  3368. level is less than the high level, and do not let levels overlap: two access
  3369. templates should not overlap the same level (ie: do not have one template for
  3370. access levels 10 to 20, and another one for 20 to 30 - the second one should be
  3371. 21 - 30). 
  3372.  
  3373. Required Ratios:  This allows you to set the default ratios that a user of the
  3374. specified access level will get.  You can set the Post/Call ratio,
  3375. Upload/Download ratio, and General Ratio independently.  Please see the section
  3376. on "User Ratios" above for details.
  3377.  
  3378. Daily Limits:  These fields allow you to specify the number of minutes a user
  3379. will receive every day on your BBS, and the daily download limit (in kilobytes)
  3380. that they can download.  Note that if you have the system set to credit upload
  3381. time (see "Transfer Options" above), these limits can be extended during a call.
  3382.  
  3383. Expired Level:  If the user's account expiration date passes, the user would be
  3384. lowered to the access level specified here.  The "expired extension" is the
  3385. number of days that his new expiration date will be extended, so you can set up
  3386. a system where a user with "premium" access could be set to "favored" access for
  3387. 30 days before lowering him further.
  3388.  
  3389. Note that if a user has a daily download limit, daily time limit, or ratio
  3390. defined in his or her user account OTHER THAN 0, the user's setting will
  3391. OVERRIDE any settings from the access template.  If you wish to set everyone to
  3392. template standards, look for the "RESET.EXE" utility which can reset this data
  3393. for you.
  3394.  
  3395.   -----------------------------------------------------------------
  3396.     Celerity v2.0                                         Page 51
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.                 -= Celerity v2.0 Operations Manual =-
  3403.   -----------------------------------------------------------------
  3404.  
  3405. Quick Validation Templates
  3406. --------------------------
  3407.  
  3408. The Quick-Validation templates use a setup similar to that of the access
  3409. templates, and are designed to compliment the access templates.  The
  3410. Quick-Validation templates will allow a sysop to validate a new user with a
  3411. simple keypress, and be able to select from a list of different access
  3412. conditions to set with that one keypress rather than editing the user's access
  3413. details individually (use of the Quick Validation templates do NOT preclude
  3414. individual access tailoring, of course).
  3415.  
  3416. The initial dialog in Quick Validate Template displays a list box of all
  3417. previously defined quick validation templates.  There are five buttons at the
  3418. bottom, which allow you to A)dd a new template, E)dit an existing template,
  3419. R)emove an existing template, S)ave the set of templates, or C)ancel your
  3420. changes and exit.  
  3421.  
  3422. If you A)dd a new template or E)dit an existing template, you will be presented
  3423. with a detailed dialog which allows you to define the details of the template
  3424. with the following options:
  3425.  
  3426. Template Name:  This is a name which you can give to the template for easy
  3427. recognition of the access conditions the template describes.  Names could be
  3428. "Basic Access", "Preferred Access", "Premium Access", and "Celerity Developer
  3429. Access".
  3430.  
  3431. Access Levels:  The template allows you to define the security level and the
  3432. transfer access level (usually unused).  This level can correspond to an Access
  3433. Template defined elsewhere (see "Access Templates" above).
  3434.  
  3435. Exemption Flags:  This allows you to set individual access exemption flags #1
  3436. through #5.  Flag #1 will exempt the user from any post/call ratio, #2 exempts
  3437. the user from an upload/download ratio, #3 specifies exemption from any General
  3438. ratio, and #5 will make the user exempt from file points (ie: free transfers). 
  3439. Flag #4 is not used.
  3440.  
  3441. User Access Flags: This allows you to set any of the 32 user access flags which
  3442. Celerity uses.  See the section on "Celerity Access Conditions" below.
  3443.  
  3444. User Note:  Every user has a user "note" which can describe his or her access
  3445. level to other users.  It will appear in the user listing and may appear in the
  3446. message header the user posted.  Optionally, users may be able to define thier
  3447. own user notes (see "System Options" and "New User Options" above).
  3448.  
  3449. To use the quick validation templates, an entry must be made in the console
  3450. keyboard definition (see "Customizing Console Commands" below) for the quick
  3451. validate.  By default, this is Alt-V.  When you activate this command, a list of
  3452.  
  3453.  
  3454.   -----------------------------------------------------------------
  3455.     Celerity v2.0                                         Page 52
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.                 -= Celerity v2.0 Operations Manual =-
  3462.   -----------------------------------------------------------------
  3463.  
  3464. the currently defined quick validate templates will be brought up and you may
  3465. select any one of them.  
  3466.  
  3467. You should also define a special template called "New User Voting" which will be
  3468. used to validate users who were validated through the New User Voting section. 
  3469. If you do not have this template, users validated in the new user voting section
  3470. will keep the access defined for new users in CELSETUP, which is usually not
  3471. sufficient.
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.   -----------------------------------------------------------------
  3514.     Celerity v2.0                                         Page 53
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.                 -= Celerity v2.0 Operations Manual =-
  3521.   -----------------------------------------------------------------
  3522.  
  3523. Running Multiple Bulletin Board Systems
  3524. ---------------------------------------
  3525.  
  3526. Through the logon shell, Celerity can be configured to give users a selection of
  3527. up to three different BBS' to enter when they connect. These separate BBS' can
  3528. be entirely independent, run different software, have different file and message
  3529. areas, and even have radically different purposes. Some systems have used the
  3530. second or third system slots for another BBS program (particularly to give
  3531. users a period of transition where they can call either), run a company support
  3532. board or shareware support board in addition to their hobby system, run an
  3533. online game environment (such as The Time of Chaos), or run a Remote Access /
  3534. Carbon Copy / PC Anywhere link to enable the sysop to take remote control of the
  3535. BBS computer.
  3536.  
  3537. To set up such an additional system, you should install the BBS/gaming
  3538. environment/door/remote link/whatever,  in the normal manner. Then check your
  3539. MAIN.BAT file in your node directory, and ensure that there are errorlevel hooks
  3540. for 122 or 123. These hooks should call a batch file (the default is sys2.bat
  3541. for the 122 error and sys3.bat for the 123 error) which will change to the other
  3542. program's directory, run the program, switch back to the node directory, and run
  3543. main.bat again.
  3544.  
  3545. The other software should be set to connect when it detects a carrier and NOT
  3546. wait for an incoming call (because a user will already be online when it is
  3547. run), and to exit back to dos when the session ends. If you use a high speed
  3548. modem with a locked DTE rate, you should set the other software up to expect a
  3549. connection AT THAT DTE rate.
  3550.  
  3551. If you run Celerity as a second or third system, an example sys2.bat batch file
  3552. would look like:
  3553.  
  3554. c:
  3555. cd \system2
  3556. celerity.exe EXIT
  3557. cd \celerity\node1
  3558. main
  3559.  
  3560. The "EXIT" command line parameter for Celerity.exe instructs the program to exit
  3561. back to dos if there is no carrier present when it starts, thus if a user drops
  3562. carrier while the second system is loading, it won't sit in the WFC screen
  3563. waiting for callers there.
  3564.  
  3565. The last step is to run  CELSETUP.EXE, and define a description for the second
  3566. and third systems in the system options and then go to the login commands
  3567. section to enter the Logon commands for the additional systems. Note that if you
  3568. do not use the lightbar logon shell, you can "hide" the commands for the
  3569. additional systems by writing alternate shell menu files "Shell.?" The most
  3570. common problem people have is that the second system does not identify the
  3571.  
  3572.   -----------------------------------------------------------------
  3573.     Celerity v2.0                                         Page 54
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.                 -= Celerity v2.0 Operations Manual =-
  3580.   -----------------------------------------------------------------
  3581.  
  3582. incoming call correctly. Usually this is because the DTE rate is not matched by
  3583. the second system. For example, Celerity is set up to use a modem with a DTE
  3584. rate of 38400 bps. The second system, however, is configured to expect a DTE
  3585. rate of 19200 Kbps, and thus gives the user garbage.
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.   -----------------------------------------------------------------
  3632.     Celerity v2.0                                         Page 55
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.                 -= Celerity v2.0 Operations Manual =-
  3639.   -----------------------------------------------------------------
  3640.  
  3641. Multi-node Operation
  3642. --------------------
  3643.  
  3644. Celerity includes provisions for running a multiple node BBS.  Each node runs as
  3645. a separate task under a multitasking operating environment such as DesqView,
  3646. Windows, PC-MOS, VM/386, Chicago, or OS/2 2.0's DOS compatibility box. You may
  3647. also use a local area network (LAN) and use a separate computer for each node. 
  3648. Hybrid setups using multiple computers on a network running multiple nodes under
  3649. a multitasking environment are quite practical.
  3650.  
  3651. There are some concerns which must be addressed when using multiple nodes on a
  3652. single CPU under Windows, DesqView, or OS/2.  Simply put, interrupt-driven I/O
  3653. (a normal serial card) is very time consuming for a computer, and if you have
  3654. more than two or three nodes using standard serial connections, the system can
  3655. bog down considerably.  This isn't to say that it cannot be done, and you should
  3656. be able to run up to 8 low-speed modems on a fast CPU.  If you have high speed
  3657. (9600+) connections, interrupt-driven I/O (serial cards) are not recommended,
  3658. but can be used.  There are Celerity systems running four 28.8k nodes on single
  3659. 50 or 66MHz 486 systems with a 115200bps DTE rates and 3500+ cps transfer rates
  3660. under DesqView and OS/2.  In all cases, you should ensure that you have buffered
  3661. serial controller chips (UART) such as an a 16550AFN (See Appendix A for details
  3662. on SIO/UART chips).
  3663.  
  3664. Please also note that on ISA and VL-BUS machines, each serial port must have its
  3665. own independent IRQ.  COM1 and COM2 are usually standardized as using IRQ 4 and
  3666. 3 respectively, but in general practice, COM3 and COM4 will also use IRQs 4 and
  3667. 3.  Therefore, you will have a conflict.  Acquire a serial card which will allow 
  3668. you to set the IRQ independently for each COM port. Some companies such as GTek
  3669. and Boca make multi-UART serial cards with this kind of flexibility.  Note that
  3670. you CAN share IRQs on an IBM PS/2 machine with Microchannel (MCA), or on an EISA
  3671. machine running OS/2. Also note that if you create a local-only node, you can
  3672. set it to COM0 which does not require an IRQ.
  3673.  
  3674. If you wish to run multiple nodes on one machine, but wish to minimize the
  3675. performance drop, you should consider the purchase of an intelligent serial I/O
  3676. card.  DigiBoard intelligent boards are directly supported by Celerity BBS (with
  3677. the DigiBoard supplement), and other boards (such as the GTek intelligent
  3678. boards) may be used with the FOSSIL supplement if they support a FOSSIL driver. 
  3679. Using intelligent boards, up to 16 (possibly even more) high speed nodes
  3680. can be run off one CPU. 
  3681.  
  3682. To add an additional node to a system set up for one node, you must make as many
  3683. additional node directories as you require, one for each additional node.  In
  3684. this directory, you must copy the following files:
  3685.  
  3686. CELERITY.EXE
  3687. CELERITY.OVR
  3688. CELSETUP.EXE
  3689.  
  3690.   -----------------------------------------------------------------
  3691.     Celerity v2.0                                         Page 56
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.                 -= Celerity v2.0 Operations Manual =-
  3698.   -----------------------------------------------------------------
  3699.  
  3700. SETUP.DAT
  3701. MODEMLST.DAT
  3702. MAIN.BAT
  3703.  
  3704. Go into the NODE1 directory, and run CELSETUP. Change the "Specific Node
  3705. Directory" to your new NODE1 directory.  Be sure you have a "Common Node
  3706. Directory" set correctly.  Celerity will use this to keep track of what is going
  3707. on with the other node, and for multinode chat. Be sure all the COM port
  3708. parameters are set correctly for your COM1 port. Go to BBS Node number and
  3709. change it to 1, for node 1.  Now save and exit. Change to your NODE2 directory,
  3710. and run the CELSETUP there.  Change the Specific Node Directory to the NODE2
  3711. path.  Change the COM port settings to your COM2 port. Change the BBS node
  3712. number to 2 for node 2. 
  3713.  
  3714. Now create two batch files in place of your old Celerity startup batch (commonly
  3715. MAIN.BAT) file. Copy your old startup Batch file to a file called NODE1.BAT and
  3716. also to NODE2.BAT.  Go into each batch file and have it change the directory to
  3717. your NODE1 directory and your NODE2 directory, respectively. Change any other
  3718. applicable directory settings. Also add a line to the beginning of the batch
  3719. files that changes the DSZ log to a node specific file. SET DSZLOG=DSZNODE1.LOG
  3720. is an easy way. That way both nodes have their own log file so when two
  3721. transfers are in progress one log won't be overwritten by the other node.
  3722.  
  3723. When you put the system up, switch to the node directory and run the NODE1.BAT
  3724. file (which may need some modification if you are using pathnames in it).
  3725.  
  3726. Run each node as a single task to verify that it is set up correctly and
  3727. communicating with your modem.
  3728.  
  3729. Alter your CONFIG.SYS and make sure you have plenty of FILES available, by
  3730. adding or modifying the line "FILES=xx" line in your config sys.  A general
  3731. suggestion would be to set 20 files, plus 6 additional files for each additional
  3732. node.
  3733.  
  3734. It is advisable that you use a disk cache, such as NCache or SpeedCache (from
  3735. Symantec), PCKwik, PC Tools' cache, or even (as a last measure) Microsoft's
  3736. SmartDrive.  Use of a disk cache will improve performance considerably.
  3737.  
  3738. You should also consider loading SHARE.EXE before running the BBS. Under certain
  3739. networking configurations, however, SHARE.EXE may not be compatible.  Some
  3740. third-party doors and utilities may not like the presence of SHARE either.  If
  3741. you have problems where only one user can enter a transfer section at one time,
  3742. try removing (or adding) SHARE.EXE.
  3743.  
  3744. When you have all of your nodes set up, load up your multitasking environment or
  3745. LAN.  Start a separate task (or separate machine on a LAN) for each node on the
  3746. BBS, switch to its NODE directory, and run the MAIN.BAT.  The system should now
  3747. be up and running in a multi-nodal format.
  3748.  
  3749.   -----------------------------------------------------------------
  3750.     Celerity v2.0                                         Page 57
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.                 -= Celerity v2.0 Operations Manual =-
  3757.   -----------------------------------------------------------------
  3758.  
  3759. On a multi-node system, users can enter the multinode chat and talk to other
  3760. users who may be on other nodes at the time.  Up to 8 users may use the chat at
  3761. a time.
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.  
  3782.  
  3783.  
  3784.  
  3785.  
  3786.  
  3787.  
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.   -----------------------------------------------------------------
  3809.     Celerity v2.0                                         Page 58
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.                 -= Celerity v2.0 Operations Manual =-
  3816.   -----------------------------------------------------------------
  3817.  
  3818. Celerity Under DesqView
  3819. -----------------------
  3820.  
  3821. Celerity is designed to run with optimum performance under the DesqView or
  3822. DesqView/X multitasking environments from Quarterdeck Office Systems.
  3823.  
  3824. To set up your BBS under DesqView, please follow the initial steps above to
  3825. install the different nodes of your BBS.  Once you set all nodes up, ensure that
  3826. they are communicating with their modems correctly and have accurate pathnames
  3827. and access to third-party utilities (DSZ, PKZIP, etc.), load up DesqView or
  3828. DesqView-X. 
  3829.  
  3830. With DesqView (DesqView-X uses similar procedures), you may set up a separate
  3831. menu item for each node of the BBS.  Add a new entry for your first node by
  3832. selecting O)pen Window from the main menu, then AP (for A)dd P)rogram). 
  3833. DesqView will give you a list of applications it has information on.  Choose the
  3834. O)ther option, because Celerity is not in its list of recognized programs.  Fill
  3835. out the DesqView information boxes as per the instructions included in your
  3836. DesqView manual.  See the example below:
  3837.  
  3838.  
  3839. +---Change-a-Program--------------------------------------------------------+
  3840. |                             Standard Options                              |
  3841. |                                                                           |
  3842. | Program Name..........: Celerity Node #1                                  |
  3843. |                                                                           |
  3844. | Keys to Use on Open Menu: C1                      Memory Size (in K): 320 |
  3845. |---------------------------------------------------------------------------|
  3846. | Program...: c:\celerity\node1\MAIN.BAT                                    |
  3847. |                                                                           |
  3848. | Parameters:                                                               |
  3849. |                                                                           |
  3850. | Directory.: c:\celerity\node1                                             |
  3851. |---------------------------------------------------------------------------|
  3852. | Options:                                                                  |
  3853. |                Writes text directly to screen.......: [N]                 |
  3854. |                Displays graphics information........: [N]                 |
  3855. |                Virtualize text/graphics (Y,N,T).....: [N]                 |
  3856. |                Uses serial ports (Y,N,1,2)..........: [N]                 |
  3857. |                Requires floppy diskette.............: [N]                 |
  3858. |                                                                           |
  3859. |    F1 for Help          F10 for Advanced Options         -+ when Done     |
  3860. +---------------------------------------------------------------------------+
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.   -----------------------------------------------------------------
  3868.     Celerity v2.0                                         Page 59
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.                 -= Celerity v2.0 Operations Manual =-
  3875.   -----------------------------------------------------------------
  3876.  
  3877.  
  3878. Next, enter the Advanced Options by hitting F10.
  3879.  
  3880. +---Change-a-Program--------------------------------------------------------+
  3881. |                            Advanced Options                               |
  3882. |                                                                           |
  3883. | System Memory (in K)......:  0    Maximum Program Memory Size (in K):     |
  3884. |                                                                           |
  3885. | Script Buffer Size......: 1000    Maximum EMS/XMS/VCPI/DPMI (in K):  1024 |
  3886. |                                                                           |
  3887. | Text Pages: 1             Graphics Pages: 0        Initial Video Mode:    |
  3888. |---------------------------------------------------------------------------|
  3889. | Window Position:                                                          |
  3890. |    Maximum Height:  25     Starting Height:  25      Starting Row...:   1 |
  3891. |    Maximum Width.:  80     Starting Width.:  25      Starting Column:   1 |
  3892. |---------------------------------------------------------------------------|
  3893. |                             Shared Program                                |
  3894. | Pathname..:                                                               |
  3895. | Data......:                                                               |
  3896. |---------------------------------------------------------------------------|
  3897. | Close on exit (Y,N,blank)...: [Y]  Uses its own colors..............: [Y] |
  3898. | Allow Close Window command..: [Y]  Runs in background (Y,N,blank)...: [Y] |
  3899. | Uses math coprocessor.......: [N]  Keyboard conflict (0-F)..........: [0] |
  3900. | Share CPU when foreground...: [Y]  Share EGA when foreground/zoomed.: [Y] |
  3901. | Can be swapped out (Y,N,blk): [N]  Protection level (0-3)...........: [0] |
  3902. |                                                                           |
  3903. |     F1 for Help        F10 for Standard Options          -+ when Done     |
  3904. +---------------------------------------------------------------------------+
  3905.  
  3906. This must be done separately for each and every node you wish to run under
  3907. DesqView.  You may make deviations from the above recommendations based on your
  3908. system requirements.
  3909.  
  3910. Please allocate as much conventional memory to Celerity as possible on the first
  3911. screen.  320k is the absolute minimum that Celerity requires, and every extra
  3912. bit of available conventional memory will enhance Celerity's speed and
  3913. effectiveness.
  3914.  
  3915. You can have Desqview load the BBS nodes automatically upon startup by creating
  3916. a script macro as per the instructions in your DesqView manual. Provide the
  3917. script with a name beginning with an !, and the script will be executed every
  3918. time DesqView is started.
  3919.  
  3920. You will probably want to tune DesqView's performance options to ensure that
  3921. maximum performance is achieved.  The optimum settings will vary between
  3922. different hardware platforms, so the best rule is to "experiment", and check
  3923. your DesqView manual for details.  When adjusting time slice allocations, it is
  3924. generally found that the lower the time slice (ie: 1 foreground/1 background,
  3925.  
  3926.   -----------------------------------------------------------------
  3927.     Celerity v2.0                                         Page 60
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.                 -= Celerity v2.0 Operations Manual =-
  3934.   -----------------------------------------------------------------
  3935.  
  3936. 2/2, 3/3) often creates a smoother BBS, while larger time slices (9/9, 12/12)
  3937. create a faster but jerkier BBS.
  3938.  
  3939. When running under DesqView, Celerity will operate somewhat differently than
  3940. when under a single-task DOS environment.  Most obviously, the Wait for Call
  3941. screen will not be animated in the same way, and will seem to run much slower. 
  3942. Additionally, other functions of the BBS may run slower than they do under a DOS
  3943. environment.  The reason for this is Celerity's intelligent time slice control,
  3944. which will "release" CPU cycles to other tasks when the BBS is performing a
  3945. non-speed-dependent task (such as the wait for call screen or waiting for user
  3946. input), so other background tasks will run quicker.  On CPU-intensive tasks,
  3947. Celerity will not release the cycles.
  3948.  
  3949. In a few places, certain local displays may "bleed" through other windows
  3950. (specifically, the password box when a user logs in, the F5 menu, and the Alt-H
  3951. sysop help menus and background editor).  Under most circumstances, these should
  3952. not present much of a problem, but if it really bugs you (enough to take a
  3953. performance hit), you may enter a "T" in the "Virtualize Text/Graphics" box.
  3954.  
  3955. When setting up under DesqView-X, the setup will be similar to that of regular
  3956. DesqView, although the commands may be somewhat different (ie: Customize Menu /
  3957. Add instead of Add Program, etc.). Most operational details will be the same.
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.   -----------------------------------------------------------------
  3986.     Celerity v2.0                                         Page 61
  3987.  
  3988.  
  3989.  
  3990.  
  3991.  
  3992.                 -= Celerity v2.0 Operations Manual =-
  3993.   -----------------------------------------------------------------
  3994.  
  3995. Celerity under Windows
  3996. ----------------------
  3997.  
  3998. Celerity BBS is also enhanced when running under the Windows 3.x environment,
  3999. although Windows is not known for its communications efficiency.  To set up a
  4000. multi-node BBS under Windows, you should follow the initial steps above and
  4001. ensure all of your BBS nodes are running correctly under DOS.  Make sure Windows
  4002. is installed correctly with the 386 enhanced options enabled.
  4003.  
  4004. The next step will be to open Windows' PIF editor and create an entry for
  4005. Celerity BBS.  A Windows 3.1 example follows:
  4006.  
  4007. +---------------------------------------------------------------------+
  4008. |                                                                     |
  4009. |  Program Filename:                 c:\celerity\node1\main.bat       |
  4010. |   Window Title:                     Celerity BBS Node 1             |
  4011. |   Optional Parameters:                                              |
  4012. |   Start-Up Directory:               c:\celerity\node1               |
  4013. |   Video Memory:     [X] Text     [] Low Graphics  [] Hi Graphics    |
  4014. |   Memory Requirements:    KB Required: 550    KB Desired: 640       |
  4015. |   EMS Memory              KB Required: 0      KB Limit  : 1280      |
  4016. |   XMS Memory              KB Required: 0      KB Limit  : 0         |
  4017. |   Display Usage:    [ ] Full Screen    Execution:   [X] Background  |
  4018. |                     [X] Windowed                    [ ] Exclusive   |
  4019. |   [X] Close Window on Exit                                          |
  4020. +---------------------------------------------------------------------+
  4021.  
  4022. And the advanced options..
  4023.  
  4024. +---------------------------------------------------------------------+
  4025. |                                                                     |
  4026. |  Background Priority: 50     Foreground Priority: 100               |
  4027. |                       [X] Detect Idle Time                          |
  4028. |                                                                     |
  4029. |  Memory Options:                                                    |
  4030. |  [ ] EMS Memory Locked             [ ] XMS Memory Locked            |
  4031. |  [X] Uses High Memory Area         [ ] Lock Application Memory      |
  4032. |                                                                     |
  4033. |  Display Options:                                                   |
  4034. |  Monitor Ports:   [ ]  Text    [ ] Low Graphics  [ ] High Graphics  |
  4035. |                   [X] Emulate Text Mode   [ ] Retain Video Memory   |
  4036. |                                                                     |
  4037. |  Other Options                                                      |
  4038. |  [X] Allow Fast Paste              [X] Allow Close When Active      |
  4039. |                                                                     |
  4040. +---------------------------------------------------------------------+
  4041.  
  4042.  
  4043.  
  4044.   -----------------------------------------------------------------
  4045.     Celerity v2.0                                         Page 62
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.                 -= Celerity v2.0 Operations Manual =-
  4052.   -----------------------------------------------------------------
  4053.  
  4054. If you are familiar with customizing Windows, these details may be adjusted to
  4055. your particular preferences.  Please see your Windows operations manual for
  4056. details.
  4057.  
  4058. Once you have created a PIF for each node (the same one can be edited and
  4059. re-saved for subsequent nodes), create a new program group for your bulletin
  4060. board.  Then, within that group create a new program item.  Have this item point
  4061. to the first PIF file.
  4062.  
  4063. +-----------------------------------------------------------------+
  4064. |                                                                 |
  4065. |  Description:        Celerity Node 1              [OK]          |
  4066. |  Command Line:       c:\celerity\node1\cel1.pif   [Cancel]      |
  4067. |  Working Directory:  c:\celerity\node1            [Browse]      |
  4068. |                      [X] Run Minimized            [Change Icon] |
  4069. |                                                   [Help]        |
  4070. |                                                                 |
  4071. +-----------------------------------------------------------------+
  4072.  
  4073. You may select an alternate icon for Celerity if you wish.  The "run minimized"
  4074. box should be checked if you do not want your BBS nodes to be visible on the
  4075. desktop, but be iconified in the corner. The BBS will run slightly faster if
  4076. iconified.
  4077.  
  4078. Once you have created the new program item, and Windows has checked the paths
  4079. for accuracy, click on the icon to test it to make sure the BBS will come up
  4080. under Windows.  Once this is successfully attained, go back and create
  4081. additional program items for each additional BBS node.
  4082.  
  4083. ** Note ** Ensure that each window is set up for background operation and not
  4084. for exclusive operation.  If you do not, only one node will function at a time.
  4085.  
  4086. You may adjust the window font sizes, windowed/full screen operation, and time
  4087. slice settings to tailor your performance under Windows.  You may also wish to
  4088. check the 386 Enhanced options in the Windows control panel when tailoring
  4089. performance.
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.  
  4102.  
  4103.   -----------------------------------------------------------------
  4104.     Celerity v2.0                                         Page 63
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.                 -= Celerity v2.0 Operations Manual =-
  4111.   -----------------------------------------------------------------
  4112.  
  4113. When communicating under Windows, you should also make some changes to the
  4114. SYSTEM.INI file to ensure that Windows does as little to hinder communications
  4115. as possible.  Under the [386Enh] heading, you should set:
  4116.  
  4117. Com1AutoAssign=0
  4118. Com1Base=3f8h
  4119. ComIrqSharing=1
  4120. ComBoostTime=10
  4121. Com1Buffer=1024
  4122.  
  4123. etc.. for each COM port which will be used by a Celerity node under Windows. 
  4124. Alter the above command accordingly depending on what your serial settings are. 
  4125. You need include entries only for those COM ports being used by Celerity BBS
  4126. under Windows.  Read your Windows documentation for additional details relating
  4127. to Windows communication.
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.  
  4159.  
  4160.  
  4161.  
  4162.   -----------------------------------------------------------------
  4163.     Celerity v2.0                                         Page 64
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.                 -= Celerity v2.0 Operations Manual =-
  4170.   -----------------------------------------------------------------
  4171.  
  4172. Celerity under Windows 4.0 "Chicago"
  4173. ------------------------------------
  4174.  
  4175. Celerity has been tested under a beta version of Microsoft's "Chicago" (or
  4176. Windows 4.0 / DOS 7.0).  Chicago is a considerably more robust multitasking
  4177. environment than Windows 3.1x, and provides performance similar to that of OS/2
  4178. 2.0.  
  4179.  
  4180. Setup under Chicago will be similar to that of Windows 3.1x, but we cannot
  4181. provide exact details until Windows 4.0 has been released.
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.   -----------------------------------------------------------------
  4222.     Celerity v2.0                                         Page 65
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.                 -= Celerity v2.0 Operations Manual =-
  4229.   -----------------------------------------------------------------
  4230.  
  4231. Celerity under OS/2
  4232. -------------------
  4233.  
  4234. OS/2 v2.x is probably the optimum multitasking environment for Celerity BBS, if
  4235. your machine has the resources to run it (those with lesser setups should
  4236. probably go with DesqView or Windows).  Celerity has been optimized for
  4237. efficiency under OS/2 2.x, and works quite well in this environment.  There are
  4238. a few details you should pay attention to to ensure smooth operation:
  4239.  
  4240. Under OS/2 MDVM's (Multiple Dos Virtual Machines) some communications programs
  4241. have trouble detecting the serial port's RING INDICATOR.  This is the default
  4242. method that Celerity uses to detect and answer an incoming call.  The
  4243. alternative to answering on Ring Detect is to answer on carrier Detect (see
  4244. "Modem Setup" above). 
  4245.  
  4246. Normally Celerity does not enable the AUTO ANSWER mode of your modem. The
  4247. primary advantage to this method (and the reason it is the default) is that the
  4248. modem never answers the call unless the BBS program is up and running.  Once the
  4249. modem's Auto Answer mode is turned on, your modem will automatically send an
  4250. answer carrier when the modem detects a ring. Once a carrier is established,
  4251. Celerity will detect that the modem has connected, and bring up the login
  4252. screen.
  4253.  
  4254. Turning on the Auto Answer is very simple.  Follow these four steps:
  4255.         1) Run Setup.
  4256.         2) Select "Modem Setup"
  4257.         3) Change the "Answer on Ring #" field from 0 (Zero) to
  4258.            1 (one).
  4259.         4) Save the new settings.
  4260.  
  4261. Celerity will automatically send an inititialization string to put the modem in
  4262. Auto Answer mode.  If you have an external modem, you will see that the Auto
  4263. Answer indicator is ON.
  4264.  
  4265. Ray Gwinn produces a replacement set of serial drivers for OS/2 2.x and markets
  4266. them via shareware.  Current versions of Gwinn's SIO drivers can be found on the
  4267. Celerity technical support board, and will provide better performance under
  4268. OS/2.
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.   -----------------------------------------------------------------
  4281.     Celerity v2.0                                         Page 66
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.                 -= Celerity v2.0 Operations Manual =-
  4288.   -----------------------------------------------------------------
  4289.  
  4290. Setting up your Celerity DOS Session under OS/2
  4291. -----------------------------------------------
  4292.  
  4293. It is recommended that you create a new icon for the DOS session that will run
  4294. Celerity.  It is suggested that you use the following settings:
  4295.  
  4296. Path and file name: *               - Run the default command
  4297.                                       interpreter.
  4298. Optional Parameters: /K
  4299. MAIN.BAT                            - Start the MAIN batch file.
  4300. Optional Working Dir C:\CELERITY    - Or whatever path you use.
  4301.  
  4302. Using these settings OS/2 will start Command.Com and then run the Celerity
  4303. MAIN.BAT file.  Be sure to provide the path to the Celerity directory in the
  4304. Working Directory field.
  4305.  
  4306. OS/2 gives the user a lot of options for customizing the way a DOS program runs. 
  4307. The Dos Settings option for each DOS session has long list of these options. 
  4308. For better results, consider the suggested changes to the settings listed below. 
  4309. Please note that these are only suggestions, and can changed to suit your needs
  4310. and preferences.
  4311.  
  4312. COM_DIRECT_ACCESS       OFF
  4313. COM_HOLD                On.    This setting will protect the serial port.
  4314. COM_SELECT              1      Or whatever com port you're using.
  4315. DOS_HIGH                ON
  4316. DOS_UMB                 ON
  4317. EMS_MEMORY_LIMIT        1024K  Celerity can use some EMS memory.
  4318. IDLE_SECONDS            Zero
  4319. IDLE_SENSITIVITY        100
  4320. HW_ROM_TO_RAM           ON
  4321. HW_TIMER                ON
  4322. INT_DURING_IO           ON
  4323. XMS_MEMORY_LIMIT        64
  4324.  
  4325. Also keep in mind that a "Windowed" DOS session does not perform as well as a
  4326. full screen session.  It is best that you configure each Celerity session to run
  4327. in full screen mode, or minimize them on the desktop when you aren't watching
  4328. them if you prefer windows. 
  4329.  
  4330. It has been recommended that Celerity be installed on an HPFS volume for optimum
  4331. performance.
  4332.  
  4333. System Example:  On one installation, four nodes of Celerity BBS were running
  4334. with little performance degradation on a 16mb EISA 50MHz 486.  Three high speed
  4335. nodes could transfer at full speed with a fourth local node.  This was under
  4336. OS/2 version 2.0.
  4337.  
  4338.  
  4339.   -----------------------------------------------------------------
  4340.     Celerity v2.0                                         Page 67
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.                 -= Celerity v2.0 Operations Manual =-
  4347.   -----------------------------------------------------------------
  4348.  
  4349. Setting up your Celerity OS/2 Session under OS/2
  4350. ------------------------------------------------
  4351.  
  4352. Celerity can also be run from an OS/2 native OS/2 session.  The advantages of
  4353. running Celerity in this manner is that you can run OS/2 programs from the
  4354. MAIN.BAT, or create a REXX script to replace your MAIN.BAT.
  4355.  
  4356. To do this, it is recommended that you create a new icon for the OS/2 session
  4357. that will run Celerity.  It is suggested that you use the following settings:
  4358.  
  4359. Path and file name:     *            - Run the default command
  4360.                                        interpreter.
  4361. Optional Parameters:    /K
  4362. MAIN.BAT                             - Start the MAIN batch file.
  4363. Optional Working Dir    C:\CELERITY  - Or whatever path you are
  4364.                                        using.
  4365.  
  4366. Using these settings OS/2 will start Command.Com and then run the Celerity
  4367. MAIN.BAT file.  Be sure to provide the path to the Celerity directory in the
  4368. Working Directory field.
  4369.  
  4370. Now in the Sessions select  "OS/2 FULL SCREEN" and Celerity will run in a OS/2
  4371. full screen session.  No settings needed.  I have found this to be the best way
  4372. to run Celerity in OS/2.
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.  
  4379.  
  4380.  
  4381.  
  4382.  
  4383.  
  4384.  
  4385.  
  4386.  
  4387.  
  4388.  
  4389.  
  4390.  
  4391.  
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.   -----------------------------------------------------------------
  4399.     Celerity v2.0                                         Page 68
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.                 -= Celerity v2.0 Operations Manual =-
  4406.   -----------------------------------------------------------------
  4407.  
  4408. Setting up your OS/2 CONFIG.SYS for running Celerity
  4409. ----------------------------------------------------
  4410.  
  4411. The OS/2 CONFIG.SYS is very complex, and you should know what you are doing
  4412. before modifying this file.  Below is a sample CONFIG.SYS which may give you
  4413. some hints, but DO NOT COPY THIS CONFIG.SYS directly to your OS/2 setup or you
  4414. will most likely have problems.
  4415.  
  4416. IFS=C:\OS2\HPFS.IFS  /CACHE:64 /CRECL:4
  4417. PROTSHELL=C:\OS2\PMSHELL.EXE
  4418. * SET RESTARTOBJECTS=STARTUPFOLDERSONLY
  4419. SET USER_INI=C:\OS2\OS2.INI
  4420. SET SYSTEM_INI=C:\OS2\OS2SYS.INI
  4421. SET OS2_SHELL=C:\OS2\CMD.EXE
  4422. SET AUTOSTART=PROGRAMS,TASKLIST,FOLDERS
  4423. SET RUNWORKPLACE=C:\OS2\PMSHELL.EXE
  4424. SET COMSPEC=C:\OS2\CMD.EXE
  4425. LIBPATH=.;C:\OS2\DLL;C:\OS2\MDOS;C:\;C:\OS2\APPS\DLL;C:\EZTAPE; SET
  4426. PATH=D:\GAMMA32;C:\OS2;C:\OS2\SYSTEM;C:\OS2\MDOS\WINOS2;C:\OS2\INST
  4427. ALL;C:\OS2\MDOS;C:\OS2\APPS;C:\; SET
  4428. DPATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\MDOS\WINOS2;C:\OS2\INSTALL;C:\;C:
  4429. \OS2\BITMAP;C:\OS2\MDOS;C:\OS2\APPS; SET
  4430. PROMPT=$p$_$t$h$h$h$h$h$h$g
  4431. SET HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;
  4432. SET GLOSSARY=C:\OS2\HELP\GLOSS;
  4433. * PRIORITY_DISK_IO=NO
  4434. * AUTOFAIL=YES
  4435. DEVICE=C:\OS2\TESTCFG.SYS
  4436. DEVICE=C:\OS2\DOS.SYS
  4437. DEVICE=C:\OS2\PMDD.SYS
  4438. DEVICE=C:\OS2\VDISK.SYS 4096 128 64
  4439. * BUFFERS=30
  4440. IOPL=YES
  4441. * DISKCACHE=1024,32,LW,AC:CDE
  4442. * MAXWAIT=1
  4443. MEMMAN=SWAP,PROTECT
  4444. SWAPPATH=C:\OS2\SYSTEM 1024 1024
  4445. BREAK=OFF
  4446. * THREADS=512
  4447. PRINTMONBUFSIZE=134,134,134
  4448. COUNTRY=001,C:\OS2\SYSTEM\COUNTRY.SYS
  4449. SET KEYS=ON
  4450. REM SET DELDIR=C:\DELETE,512;D:\DELETE,512;E:\DELETE,512;
  4451. BASEDEV=PRINT01.SYS
  4452. BASEDEV=IBM1FLPY.ADD
  4453. BASEDEV=IBMINT13.I13
  4454. BASEDEV=OS2DASD.DMD
  4455. SET BOOKSHELF=D:\GAMMA32;C:\GAMMA32;C:\OS2\BOOK
  4456.  
  4457.   -----------------------------------------------------------------
  4458.     Celerity v2.0                                         Page 69
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.                 -= Celerity v2.0 Operations Manual =-
  4465.   -----------------------------------------------------------------
  4466.  
  4467. SET EPATH=C:\OS2\APPS
  4468. PROTECTONLY=NO
  4469. * SHELL=C:\OS2\MDOS\COMMAND.COM C:\OS2\MDOS /E:1024 /P
  4470. FCBS=16,8
  4471. RMSIZE=640
  4472. DEVICE=C:\OS2\MDOS\VEMM.SYS
  4473. * DOS=HIGH,UMB
  4474. DEVICE=C:\OS2\MDOS\VDPX.SYS
  4475. DEVICE=C:\OS2\MDOS\VXMS.SYS /UMB
  4476. DEVICE=C:\OS2\MDOS\VDPMI.SYS
  4477. DEVICE=C:\OS2\MDOS\VCDROM.SYS
  4478. * DEVICE=C:\OS2\MDOS\ANSI.SYS
  4479. SET VIDEO_DEVICES=VIO_SVGA
  4480. SET VIO_VGA=DEVICE(BVHVGA,BVHSVGA)
  4481. DEVICE=C:\OS2\MDOS\VSVGA.SYS
  4482. CODEPAGE=437,850
  4483. DEVINFO=KBD,US,C:\OS2\KEYBOARD.DCP
  4484. SET VIO_SVGA=DEVICE(BVHVGA,BVHSVGA)
  4485. DEVICE=C:\OS2\MDOS\VMOUSE.SYS
  4486. DEVICE=C:\OS2\POINTDD.SYS
  4487. DEVICE=C:\OS2\MOUSE.SYS
  4488. * rem DEVICE=C:\OS2\COM.SYS
  4489. * rem DEVICE=C:\OS2\MDOS\VCOM.SYS
  4490. * DEVICE=C:\SIO.SYS
  4491. * DEVICE=C:\VSIO.SYS
  4492.  
  4493. Change or add the ones marked with a "*".
  4494.  
  4495. The final two lines refer to Ray Gwinn's shareware SIO serial drivers (which are
  4496. available on the technical support board). These drivers are far superior to the
  4497. IBM serial drivers.
  4498.  
  4499. One final note:  Get a 16550 UART (or other buffering UART) Multitasking
  4500. operating systems such as OS/2 can really benefit from a buffered UART. OS/2
  4501. will detect and make full use of your 16550. (See Appendix Afor a complete
  4502. discussion of SIO Cards)
  4503.  
  4504.  
  4505.  
  4506.  
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.   -----------------------------------------------------------------
  4517.     Celerity v2.0                                         Page 70
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.                 -= Celerity v2.0 Operations Manual =-
  4524.   -----------------------------------------------------------------
  4525.  
  4526. Celerity under a Local Area Network
  4527. -----------------------------------
  4528.  
  4529. The most effective multi-node installations of Celerity BBS are run on local
  4530. area networks, such as Novell Netware 3.1x and Netware 4.0 (requiring a
  4531. dedicated network server), Netware Lite v1.0, Artisoft LANTastic, and PowerLAN
  4532. (peer-to-peer).
  4533.  
  4534. ** SET UP YOUR NETWORK AND ENSURE THAT IT OPERATES CORRECTLY BEFORE SETTING UP
  4535. CELERITY ON THE NETWORK!
  4536.  
  4537. It is best if all systems on the network map their drives consistently (ie:
  4538. drive F: is the same on all systems, drive G: is the same on all systems, and so
  4539. forth).  Any decent network will let you establish these drive mappings so that
  4540. you do not have to refer to a drive as C: on one machine and Q: on another.
  4541.  
  4542. Ensure that your network hardware does not use an IRQ or port address being used
  4543. by your communication hardware, or you may find your network suddenly crashing
  4544. when Celerity tries to open the serial port.
  4545.  
  4546. Set up all BBS nodes as per the instructions at the beginning of this section. 
  4547. Ensure that each node will work independently before attempting to run all nodes
  4548. simultaneously.  Refer to your network documentation for details on how the
  4549. network handles file sharing, and make sure you take the appropriate steps to
  4550. ensure that files can be opened by multiple tasks.  With Novell Netware, you
  4551. should flag all Celerity data files as sharable.  Under 3.1x, you should
  4552. type the command "flag *.* +s" in each Celerity directory.  Under Netware v4.xx,
  4553. you should use "flag *.* +sh". 
  4554.  
  4555. After flagging all files as sharable, bring up each node on the network and
  4556. verify its functionality.  
  4557.  
  4558. With some networks, you may need to load SHARE.EXE.  With others, you should NOT
  4559. load SHARE.EXE.  With some versions of LanTastic, for example, SHARE.EXE will
  4560. cause problems.  Disable all internal file sharing support that LanTastic
  4561. provides to preserve your sanity.
  4562.  
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.  
  4575.   -----------------------------------------------------------------
  4576.     Celerity v2.0                                         Page 71
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.                 -= Celerity v2.0 Operations Manual =-
  4583.   -----------------------------------------------------------------
  4584.  
  4585. Running Celerity from a RAMdisk
  4586. -------------------------------
  4587.  
  4588. Celerity is quick, but can be made even quicker if parts of it are contained on
  4589. a RAMdisk. Observe the following list of Celerity directories which can be run
  4590. from a RAMdisk, and the APPROXIMATE requirements for each directory.  Note that
  4591. some directories will grow in size over time, so keep an eye on how much free
  4592. space you have:
  4593.  
  4594.  - Node Directory: (Requires 800-1000k) Having a node directory on a RAMdisk
  4595. makes the loading of the board and it's segments (which are loaded from the
  4596. overlay file) much quicker. This will permit maximum speed when switching from
  4597. section to section. The size can be reduced by not copying the celsetup.exe or
  4598. documentation files.
  4599.  
  4600.  - BBS Directory: (Requires 2000-4000k) This directory will greatly increase the
  4601. speed at which users are looked up when sending email, logging on, or when
  4602. awarding download commissions. Post-downloading accounting is also sped up.
  4603.  
  4604.  - Language Directory: (Requires 500k to 1500k) Placing the files from this
  4605. directory in a RAMdisk results in quicker menu display and text lookup speed.
  4606. Therefore, this will result in the biggest single speed increase of all!
  4607.  
  4608.  - Data Directory: (Requires 500k to 3 megs) The requirements of the data
  4609. directory will vary depending on the number of transfer areas you have, the
  4610. number of files in each area, and the number of subs you have. Buffering this
  4611. directory from a RAMdisk will provide the most noticeable speed increase when
  4612. people list files, read posts, upload or download, read or send mail.
  4613.  
  4614.  - Display Directory: (Requires 10k to 50k+) This will slightly increase the
  4615. speed at which canned text files (new user messages, info-scripts, etc.)
  4616. display.
  4617.  
  4618.  - Conference Directory: (Requires 5 to 15 megs) Putting this directory on a
  4619. RAMdisk will result in great performance increases in the message bases,
  4620. newscanning, and conference navigation.  Only the greatest RAMdisks can handle
  4621. this directory!
  4622.  
  4623.  - Temporary Directory: (Do Not Buffer)  The temporary directory must have
  4624. enough room to store the largest batch upload a user will ever make - plus
  4625. additional space as large as the largest file uploaded. If the largest batch
  4626. upload were ten 100k files, an 1100k directory would be sufficient, but that is
  4627. unrealistic. When a user attempts to upload six 1 meg files to a 1100k RAMdisk,
  4628. he is bound to be angry. (Of course, if you own a Pentium and have 4 Terabytes
  4629. of RAM, be my guest!)
  4630.  
  4631. When using a RAMdisk, particularly for directories which will be updated from
  4632. time to time, it is imperative to have the files automatically backed up to a
  4633.  
  4634.   -----------------------------------------------------------------
  4635.     Celerity v2.0                                         Page 72
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.                 -= Celerity v2.0 Operations Manual =-
  4642.   -----------------------------------------------------------------
  4643.  
  4644. hard drive between calls. An easy way to do this is to add a line in your
  4645. main.bat file:
  4646.  
  4647. xcopy f:\celerity\*.* c:\celerity /s /m
  4648.  
  4649. Assuming your BBS is in the c:\celerity directory, and your ramdrive is drive
  4650. F:, this will copy all files from a RAMdisk (f:) to a hard drive (c:) in the
  4651. "celerity" directory. The /s parameter tells Xcopy to copy all subdirectories
  4652. (celerity\data, celerity\menus, etc.), and /m checks for archive bits to be set.
  4653. If you xcopy all the files you wish to buffer to the RAMdisk, the archive bits
  4654. will be cleared, and thus all the files would be automatically copied back to
  4655. the hard drive when main.bat is first run. On subsequent runs, such as when the
  4656. board is put back up after a user has logged off, only the files which have been
  4657. changed will be copied. Do not trust a RAMdisk to hold data for weeks at a
  4658. time, backing up after every call is generally a safe bet. Lastly, keep an eye
  4659. on the space free on your RAMdisk (Put it in your WFC Drive Scan String). Any of
  4660. the directories above shouldn't change size rapidly, but may eventually get
  4661. larger and cause problems if they fill up the RAMdisk.
  4662.  
  4663. System Example: There is one 4-node Celerity BBS running on DesqView on a 66MHz
  4664. machine with 32 megs of RAM.  25 megabytes were reserved for a RAMdisk, which
  4665. was stacked with Stacker, providing a RAMdisk of about 50 megabytes of storage. 
  4666. Needless to say, the BBS was quite quick!
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.   -----------------------------------------------------------------
  4694.     Celerity v2.0                                         Page 73
  4695.  
  4696.  
  4697.  
  4698.  
  4699.  
  4700.                 -= Celerity v2.0 Operations Manual =-
  4701.   -----------------------------------------------------------------
  4702.  
  4703. Modes of Operation
  4704. ------------------
  4705.  
  4706. Celerity BBS has three basic modes of operation:
  4707.  
  4708. 1: Celerity BBS - The full featured bulletin board system.
  4709. 2: CAE          - A transfer-only system (like a term program host
  4710.                   mode).
  4711. 3: CAE/TAC      - The CAE transfer-only system, but with user
  4712.                   accounts.
  4713. 4: Alacrity BBS - Alacrity BBS was a special version of Celerity with
  4714.                an alternative menu structure.  With version 2.00,
  4715.                Alacrity modes were integrated into the mainstream
  4716.                BBS and Alacrity mode was discontinued.
  4717.  
  4718. The CAE and CAE/TAC modes will be discussed below.
  4719.  
  4720.  
  4721. CAE Mode
  4722. --------
  4723.  
  4724. The CAE (Celerity "ASCII Express") was inspired by an old terminal program for
  4725. the Apple ][ called ASCII Express.  ASCII Express had a special host mode where
  4726. any user could call in (some systems required a password) and transfer files. 
  4727. There were no message bases, no user accounts, no email, no file ratios, or
  4728. other conventional bulletin board features.  All callers were given the same
  4729. access and the same amount of time online.
  4730.  
  4731. The CAE is basically like a terminal program's host mode, except it affords the
  4732. full power and flexibility of the Celerity file system.
  4733.  
  4734. The CAE will ask for a user's handle and area code upon login, but this
  4735. information is kept only in the system logs, and no user account information is
  4736. saved.  Once this information is established, the user is given complete
  4737. homogenous access to the transfer areas, being able to download whatever he or
  4738. she pleases, with no obligation to upload.
  4739.  
  4740. What's the purpose? There could be several reasons for running a CAE. File
  4741. distribution is one.  Users uploading to a CAE system may get the file
  4742. downloaded freely by callers and spread across the nation in a few days,
  4743. spreading it much more quickly than via conventional channels. Or, if you run a
  4744. BBS for your business or wish to distribute files free of charge, the CAE mode
  4745. would be ideal.
  4746.  
  4747. The CAE is an open access system, meaning anyone can get on at any time. One way
  4748. to limit access from anyone with your number is to enable the System 1 password
  4749. (or the CAE password if you do not want to run a full CAE system) in CELSETUP. 
  4750. After connection, the user will first be prompted for the password, then normal
  4751.  
  4752.   -----------------------------------------------------------------
  4753.     Celerity v2.0                                         Page 74
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.                 -= Celerity v2.0 Operations Manual =-
  4760.   -----------------------------------------------------------------
  4761.  
  4762. logon procedures occur,  thereby limiting access to the specific users who you
  4763. wish to have access to your system.
  4764.  
  4765. The transfer area structure is the same as in normal Celerity operation, except
  4766. that users cannot send mail or have access to non-conference items.
  4767.  
  4768. A CAE would traditionally only contain transfer areas, but with the Celerity
  4769. v2.0 CAE, you can place any conference item in the CAE tree.
  4770.  
  4771. Use the CAEINTRO.ANS file to pass information along to users after login.
  4772.  
  4773.  
  4774. CAE/TAC Mode
  4775. ------------
  4776. The CAE/TAC (Total Access Control) mode is related to the CAE mode but with one
  4777. major difference - it has individual user accounts. This allows more control by
  4778. the SysOp over who gets access (and what type of access) to the system.
  4779.  
  4780. The CAE/TAC system looks like a CAE system from the users' point of view, and a
  4781. normal BBS from the SysOp's, since the SysOp must have access to the SysOp menu
  4782. in order to edit user accounts.  All functions are similar to the CAE mode, with
  4783. the following exceptions:
  4784.  
  4785. Since user accounts exist, the Top Ten function can be enabled in CELSETUP. 
  4786. Users must login in as new on the first call, so information scripts may be
  4787. present, and the new user feedback option can also be enabled.  The system can
  4788. have a co-SysOp, since a specific user's access can be adjusted. Any user with
  4789. co-SysOp level privileges logs onto the normal main board like the SysOp (as
  4790. opposed to the transfer area restriction placed on all other users).
  4791.  
  4792. The CAE/TAC system utilizes the message bases and email as well. Email to users
  4793. is allowed in this mode - if mail exists for the user, the user is first placed
  4794. into the email section, and then, upon exit, the user enters into the CAE
  4795. system's transfer area. 
  4796.  
  4797. Since you control access levels, you control what the user can do. The amount of
  4798. online time each user has per day is controlled via the general access level,
  4799. while the specific file areas each user has access to is controlled via the xfer
  4800. access level.  This is helpful to separate the major contributors from the
  4801. average users, or to limit access to certain file areas.
  4802.  
  4803. Because a new user must apply for access, it is a good idea to activate a login
  4804. shell, such as the lightbar menu shell.  This way, a new user can find he or her
  4805. way easily enough.  You can also enable other login shell functions, such as
  4806. feedback and chat, so users can contact you.
  4807.  
  4808.  
  4809.  
  4810.  
  4811.   -----------------------------------------------------------------
  4812.     Celerity v2.0                                         Page 75
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.                 -= Celerity v2.0 Operations Manual =-
  4819.   -----------------------------------------------------------------
  4820.  
  4821. Since the whole board is actually utilized, install any of the wide variety of
  4822. menus available for Celerity, then install the CAE/TAC menus over them.  This
  4823. way, you have your menus, and the users have theirs.
  4824.  
  4825. With TAC mode, you completely control what users can access the system. Use the
  4826. information scripts and new user feedback to gather complete information on an
  4827. applicant if this precaution is warranted.
  4828.  
  4829. It is recommended you create your own statistics files because Celerity's
  4830. internal displays contain information that the user doesn't need, such as new
  4831. posts.  Since the system is still basically a CAE, this information is
  4832. meaningless and can only confuse new users.  Note, however, that file points,
  4833. commissions, and ratios CAN be enabled for a CAE/TAC.
  4834.  
  4835. See "customizing your BBS" for more details.
  4836.  
  4837. The WELCOME.1 file is an excellent way to communicate policies and to pass on
  4838. information to your users.  PRELOGIN.BBS is also helpful (when the login shell
  4839. is enabled), but can be viewed by anyone calling in, not just validated users. 
  4840. Automessages and news bulletins are not viewed by the users.
  4841.  
  4842.  
  4843.  
  4844.  
  4845.  
  4846.  
  4847.  
  4848.  
  4849.  
  4850.  
  4851.  
  4852.  
  4853.  
  4854.  
  4855.  
  4856.  
  4857.  
  4858.  
  4859.  
  4860.  
  4861.  
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.   -----------------------------------------------------------------
  4871.     Celerity v2.0                                         Page 76
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.                 -= Celerity v2.0 Operations Manual =-
  4878.   -----------------------------------------------------------------
  4879.  
  4880. MAIN.BAT Operational Details
  4881. ----------------------------
  4882.  
  4883. Celerity is run from a batch file.  This batch file should loop on itself to
  4884. keep the system running if it is the only system.  See the example "main.bat"
  4885. file for an example.  Celerity will return with the following errorlevels for
  4886. certain conditions: 
  4887.  
  4888. 127:  FAX connect detected - run FAX software
  4889. 125:  Run terminal program
  4890. 124:  Run SysOp-defined event (Sysop hit F6 from WFC)
  4891. 123:  Run system 3
  4892. 122:  Run system 2
  4893. 100:  Exit bbs (don't re-run batch file)
  4894.  67:  Run the  CELSETUP.EXE program
  4895.  50:  Exit BBS
  4896.   3:  Used to operate nightly events
  4897.  
  4898.  
  4899. Command Line Parameters
  4900. -----------------------
  4901.  
  4902. A number of Celerity functions can be called from the DOS command line, to
  4903. facilitate using its features from another program which calls Celerity. The
  4904. commands refer to the first parameter, although some may take additional
  4905. parameters. 
  4906.  
  4907. Celerity exit : This command will cause Celerity to exit if there is no carrier
  4908. present, rather than go to the WFC.  This option would be used if you use a
  4909. front-end program.
  4910. Celerity link d b : Load up Celerity at DTE rate d and bps rate b
  4911. Celerity load d u : Load up Celerity at DTE rate d and load user #u
  4912. Celerity noverify : Load Celerity, but skip some on-load error checks
  4913. Celerity speed    : Do a simple benchmark on your system
  4914.  
  4915.  
  4916. Running MAIN.BAT For The First Time
  4917. -----------------------------------
  4918.  
  4919. When you run MAIN.BAT the first time, Celerity will probably create a few
  4920. directories which didn't exist.  If you run into problems here, enter
  4921. CELSETUP.EXE again and verify your directory locations. If you are running under
  4922. certain operating system conditions, you may have to create the directories
  4923. manually.
  4924.  
  4925. When the WFC (wait for call) screen appears, type F10 to log on locally. apply
  4926. as new, then log in with this new account.  Make sure that you set up the "new
  4927. user level" to be higher than the "login level" in your celsetup, or you will be
  4928.  
  4929.   -----------------------------------------------------------------
  4930.     Celerity v2.0                                         Page 77
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.                 -= Celerity v2.0 Operations Manual =-
  4937.   -----------------------------------------------------------------
  4938.  
  4939. unable to get into the system with your newly created account.  Once you are in,
  4940. Type Alt-S (or whatever you have the sysop access key defined to in  your
  4941. keyboard definition file - see "Customizing the Keyboard" below) to give
  4942. yourself sysop access, and go into the user custodian and set all the sysop
  4943. flags on the account, change your access level, etc.
  4944.  
  4945. The next step is to enter the user configuration section normally "K" from the
  4946. main menu.  Select your display preferences, option toggles, and the like.  Be
  4947. sure you also change your password to something that you don't use elsewhere, as
  4948. it is imperative that you do not allow anyone else to enter the BBS using your
  4949. SysOp account.
  4950.  
  4951. After you've finished playing with the defaults and password, you'll need to set
  4952. up the file areas, and message bases.  The following sections will explain how.
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.   -----------------------------------------------------------------
  4989.     Celerity v2.0                                         Page 78
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.                 -= Celerity v2.0 Operations Manual =-
  4996.   -----------------------------------------------------------------
  4997.  
  4998. Celerity Access Conditions
  4999. --------------------------
  5000.  
  5001. With version 2.x, Celerity supports an extensive system of access control for
  5002. message bases, file areas, menu commands, and more. There are a number of access
  5003. conditions which can be checked, and a user must pass all of them to gain access
  5004. to the particular area or command.  The conditions are not case-sensitive, and
  5005. must be followed by an equals (=) sign and the value to compare.  The following
  5006. conditions are currently supported:
  5007.  
  5008. SF=    Sysop flag number.
  5009. UF=    User flag number.
  5010. SL=    User's security level.
  5011. XL=    User's xfer level.
  5012. AGE=   User's age.
  5013. BAUD=  User's connect rate.
  5014. TL=    Time left online today.
  5015. AC=    User's area code.
  5016. NODE=  BBS node.
  5017.  
  5018. For example,
  5019. SF=11 UF=4 SL=50 AGE=30 NODE=2
  5020.  
  5021. Will only allow a user who meets the following conditions:
  5022.  
  5023. 1:  Has sysop flag #11 set (SF=11)
  5024. 2:  Has user access flag #4 set (UF=4)
  5025. 3:  Has a security level of 50 (SL=50) or more
  5026. 4:  Is at least 30 years old (AGE=30)
  5027. 5:  Is logged onto node #2 of the BBS (NODE=2)
  5028.  
  5029. Note that very few commands would have such an extensive list of qualifiers, but
  5030. we wish to give our sysops as much flexibility as possible.
  5031.  
  5032. Each user has 32 User Access Flags which may be defined by the sysop.  Usually a
  5033. system may use separate flags to grant access to different sections of the BBS,
  5034. such as tagging access flag #1 for access to an Adult section, access flag #2
  5035. for a subscriber section, access flag #3 for a software developers conference,
  5036. and so forth.  User access flags have no inherent definition, and can therefore
  5037. be used with impunity by a sysop.  Consider that each user will have to be
  5038. edited and have a certain flag turned on, as all users are initially created
  5039. with no access flags set. 
  5040.  
  5041. Each user also has 32 Sysop Access Flags.  Unlike the user access flags
  5042. discussed above, Sysop Access Flags DO have inherent definitions which
  5043. correspond to various forms of sysop access around the system.  With this
  5044. system, a Celerity sysop can give specific privileges to cosysops without giving
  5045. them total control over the system or unrelated sections.
  5046.  
  5047.   -----------------------------------------------------------------
  5048.     Celerity v2.0                                         Page 79
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.                 -= Celerity v2.0 Operations Manual =-
  5055.   -----------------------------------------------------------------
  5056.  
  5057. The definitions of the Sysop Access Flags are as follows:
  5058.  
  5059. 1  : Unlimited time
  5060. 2  : Can transfer to other users
  5061. 3  : Get extended information
  5062. 4  : Allow system parameter manipulation
  5063. 5  : View anonymous mail
  5064. 6  : Sensitive transfer activity
  5065. 7  : Exempt from Auto-Timeout
  5066. 8  : Appears In Feedback Listing
  5067. 9  : Excluded from caller Log
  5068. 10 : Art gallery sysop
  5069. 11 : BBS list sysop
  5070. 12 : New User Voting sysop
  5071. 13 : Oneliner section sysop
  5072. 14 : Sysop menu access
  5073. 15 : User custodian
  5074. 16 : Door section sysop
  5075. 17 : Electronic Mail sysop
  5076. 18 : Voting Section sysop
  5077. 19 : May download private files
  5078. 20 : System Configuration (conference editing)
  5079. 21 : Message Sysop
  5080. 22 : Transfer Sysop
  5081. 23 : News / Bulletin Sysop
  5082. 24 : Can use Remote DOS Session
  5083. 25 : Can override multiple login restriction
  5084. 26 : In Quick Local Login list
  5085. 27 : (unused)
  5086. 28 : (unused)
  5087. 29 : (unused)
  5088. 30 : (unused)
  5089.  
  5090. Note that "local" sysop access (for a subconference) can be set with the
  5091. "administration" access code in the conference system. This enables a sysop to
  5092. give cosysops control over a single message area or subconference without giving
  5093. them the global powers associated with Flag 21 or Flag 22.
  5094.  
  5095.  
  5096.  
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103.  
  5104.  
  5105.  
  5106.   -----------------------------------------------------------------
  5107.     Celerity v2.0                                         Page 80
  5108.  
  5109.  
  5110.  
  5111.  
  5112.  
  5113.                 -= Celerity v2.0 Operations Manual =-
  5114.   -----------------------------------------------------------------
  5115.  
  5116. Celerity Conference System
  5117. --------------------------
  5118.  
  5119. Celerity 2.0 introduces an entirely new conferencing system to bulletin boards. 
  5120. To use a metaphor, Celerity BBS is like a "grove" with a number of trees growing
  5121. in it.  One of them is the message tree, one of them is the transfer tree, and
  5122. there are a few other trees as well.  Each tree can have an unlimited number of
  5123. branches, and each branch can have an unlimited number of branches as well. On
  5124. the trunk or on branches there can be an unlimited number of pieces of "fruit". 
  5125. With Celerity v2.0, the "fruit" can be a message base, a set of transfer areas,
  5126. an online doors section, an art gallery, a BBS list, a bulletin section, and
  5127. more. It is up to you as a sysop to design your trees and decide where to put
  5128. branches and where to put fruit.  Unlike real trees, branches, and fruit,
  5129. Celerity's conferencing system will allow a single branch to be accessible from
  5130. multiple trees, a piece of fruit accessible from multiple branches, and even
  5131. make entire trees into branches of another tree.
  5132.  
  5133. Celerity achieves this through its new conferencing system which is made up of
  5134. .CNF files for trees and branches, and through .BSE, .XFR, .DOR, .LST, .ART,
  5135. .BUL, etc. files which represent different types of fruit. All of these files
  5136. are created when you create conferences and areas, so you need not concern
  5137. yourself with file extensions much.
  5138.  
  5139.  
  5140. Conference Structure
  5141. --------------------
  5142.  
  5143. The main tree trunks in a Celerity 2.0 system are the Message Tree (MAIN.CNF),
  5144. the Transfer Tree (XFER.CNF), the General interest Tree (GFILE.CNF) and the
  5145. Private Tree (PRIVATE.CNF).  These trunks are accessed via commands at the
  5146. Celerity main menu (B/M, T/X, P, and Z). Although these trees have nominal
  5147. names, they can be used for any conference makeup you like, and do not have to
  5148. be messages, transfers, etc.  The Global Newscan will scan MAIN.CNF, XFER.CNF,
  5149. GFILE.CNF and PRIVATE.CNF in that order.  If you have a CAE available from the
  5150. login shell, it will use CAE.CNF as its root conference. 
  5151.  
  5152. Users can navigate up and down the conference tree from the various conference
  5153. menus, or jump all the way back to the start with the "^" command.  Access
  5154. restrictions can be placed on individual conference items, or on entire
  5155. subconferences to provide security for whole sections of the BBS in a simple
  5156. manner. 
  5157.  
  5158. This structure provides an incredible amount of flexibility and potential for
  5159. large systems, but also retains a simple hierarchal interface.  Small systems
  5160. will probably opt for a conventional SIG model, such as figure A.  A larger
  5161. medium-sized system may prefer the conventional conference model shown in figure
  5162. B, while a large system may opt for a more diverse pattern such as figure C. 
  5163.  
  5164.  
  5165.   -----------------------------------------------------------------
  5166.     Celerity v2.0                                         Page 81
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.                 -= Celerity v2.0 Operations Manual =-
  5173.   -----------------------------------------------------------------
  5174.  
  5175. Please note that these are simply suggestions - it is entirely up to the sysop
  5176. to design exactly how he or she wants the system laid out.
  5177.  
  5178.  
  5179. Figure A: Simple Model
  5180.  
  5181.              !---- SUBA.BSE (message base)
  5182.              !
  5183.              !---- SUBB.BSE (message base)
  5184.              !
  5185. MAIN.CNF-----!---- SUBC.BSE (message base)
  5186.              !
  5187.              !---- SUBD.BSE (message base)
  5188.              !
  5189.              !---- SUBE.BSE (message base)
  5190.  
  5191.  
  5192. In figure A, we see a conference which has five message bases attached. This is
  5193. quite straightforward, and resembles a bulletin board selection system similar
  5194. to many other BBS programs like WildCat! or PCBoard.
  5195.  
  5196.  
  5197.  
  5198.  
  5199.  
  5200.  
  5201.  
  5202.  
  5203.  
  5204.  
  5205.  
  5206.  
  5207.  
  5208.  
  5209.  
  5210.  
  5211.  
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221.  
  5222.  
  5223.  
  5224.   -----------------------------------------------------------------
  5225.     Celerity v2.0                                         Page 82
  5226.  
  5227.  
  5228.  
  5229.  
  5230.  
  5231.                 -= Celerity v2.0 Operations Manual =-
  5232.   -----------------------------------------------------------------
  5233.  
  5234. Figure B: Conference Model
  5235.  
  5236.                !---- CONFA.CNF (conference)----!---- SUBA.BSE
  5237.                !                               !
  5238.                !---- CONFB.CNF (conference)    !---- SUBB.BSE
  5239.                !                               !
  5240. MAIN.CNF ------!---- CONFC.CNF (conference)    !---- SUBC.BSE
  5241.                !
  5242.                !---- CONFD.CNF (conference)
  5243.                !
  5244.                !---- CONFE.CNF (conference)
  5245.  
  5246. In figure B, we see that the message tree contains five branches, each of which
  5247. contain multiple message bases (detail is only shown on the first one).  This
  5248. system resembles a conference-oriented BBS like Celerity 1.xx.
  5249.  
  5250. Both Model A and Model B demonstrate fairly simple conference setups, but
  5251. Celerity BBS is by no means limited to such simple configurations. Gigantic
  5252. interlocking trees can be created, providing elaborate access setups and special
  5253. interest areas.
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274.  
  5275.  
  5276.  
  5277.  
  5278.  
  5279.  
  5280.  
  5281.  
  5282.  
  5283.   -----------------------------------------------------------------
  5284.     Celerity v2.0                                         Page 83
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.                 -= Celerity v2.0 Operations Manual =-
  5291.   -----------------------------------------------------------------
  5292.  
  5293. Figure C: Complex Model
  5294.  
  5295.                !---- CONFA.CNF (conference) ----!---- SUBA.BSE
  5296.                !                                !
  5297.                !---- CONFB.CNF (conference)     !---- SUBB.BSE
  5298.                !                                !
  5299. MAIN.CNF  -----!---- CONFC.CNF (conference) --! !---- CONFD.CNF
  5300.                !                              !
  5301.                !---- DOORA.DOR (door section) !-!---- XFERA.XFR
  5302.                !                                !    (xfer)
  5303.                !---- CONFE.CNF (conference) --! !---- XFERB.XFR
  5304.                                               ! !     (xfer)
  5305.                                               ! !---- XFER.CNF
  5306.                                               !       (conf)
  5307.                                               !-!---- ART1.ART
  5308.                                                 !     (art)
  5309.                                                 !---- ART2.ART
  5310.                                                 !     (art)
  5311.                                                 !---- SUBC.BSE
  5312.                                                       (message)
  5313.  
  5314. Figure C demonstrates a much more complex system, showing the main conference
  5315. which contains four sub-conferences (branches) and a doors section.  The first
  5316. branch contains two message bases and another conference.  The third conference
  5317. contains two transfer sections and a link to the XFER tree (XFER.CNF). The
  5318. fourth conference (CONFE.CNF) contains a pair of art galleries and a message
  5319. base (presumably for discussion of art).  Figure C represents the flexibility
  5320. and power of Celerity 2.0's conferencing system, which can approach the
  5321. complexity and expendability of large information services like Prodigy and
  5322. Compuserve.
  5323.  
  5324. With all conference systems, users can easily scan all areas they wish to scan
  5325. via the Global Newscan command, which will save up to ten seperate newscan
  5326. configurations.  With such ease of use, you could carry thousands of networked
  5327. special interest groups and users could scan only those which interested them on
  5328. a particular call.
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.   -----------------------------------------------------------------
  5343.     Celerity v2.0                                         Page 84
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.                 -= Celerity v2.0 Operations Manual =-
  5350.   -----------------------------------------------------------------
  5351.  
  5352. Creating Conference Trees
  5353. -------------------------
  5354.  
  5355. When a sysop account cleared for system modification (sysop flag #20 set) enters
  5356. a .CNF for the first time (ie: goes into the message bases, transfer section,
  5357. gfile section, or enters a sub-conference set up in one of the previously listed
  5358. main trees), Celerity will prompt the sysop to create a conference item.  If you
  5359. say yes, you will go into to conference item creation menu.  This full screen
  5360. display will appear as follows:
  5361.  
  5362.  [A]  Name             :
  5363.  [B]  Access Code      : 2
  5364.  [C]  Read Access      :
  5365.  [D]  Post Access      :
  5366.  [E]  Admin Access     : SF=100
  5367.  [F]  Password         :
  5368.  [G]  Menu Path        : c:\celerity\menu\
  5369.  [H]  Item Type        : Message Base
  5370.  [I]  Data Pathname    :
  5371.  [S]  Save Item
  5372.  [Q]  Quit without saving
  5373.  
  5374. The name will be displayed to users when they get a list of items in the
  5375. conference.
  5376.  
  5377. A numerical access code will be automatically assigned to the new conference
  5378. item, but you may easily change this to an alphanumeric access code if you like. 
  5379. This is the code the user must type in to enter the particular section.  Often
  5380. sysops will configure their systems to use numeric access codes for most areas
  5381. (ie: choose conference #1-5, choose sub #1-24), but others may opt for a more
  5382. unique format (ie: type IBM for the IBM conference, Amiga for the Amiga
  5383. conference, Paperweight for the Macintosh conference).
  5384.  
  5385. Read access is the access code needed for a user to enter the section in
  5386. question, or to even see it on a list.  If they do not meet the access
  5387. requirements of the item, they will have no idea it exists.  See the appendix on
  5388. access conditions.
  5389.  
  5390. Post access is similar to read access, but allows users to write to that
  5391. conference (ie: write messages).
  5392.  
  5393. Admin access allows you to determine who can have sysop powers within that
  5394. conference.  Define this carefully, as a user who has Admin access can cause a
  5395. lot of headaches for you if they don't know what they are doing.
  5396.  
  5397. The password field allows you to define a special password required to enter the
  5398. conference item.
  5399.  
  5400.  
  5401.   -----------------------------------------------------------------
  5402.     Celerity v2.0                                         Page 85
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.                 -= Celerity v2.0 Operations Manual =-
  5409.   -----------------------------------------------------------------
  5410.  
  5411. The menu path is the path to a text file which will be displayed when the user
  5412. enters the section.
  5413.  
  5414. Item type:  Pressing H will cycle through the various data types supported in
  5415. the Celerity v2.0 conferencing system. These include conferences, xfer sections,
  5416. message bases, online doors sections, art galleries, bulletin sections, bbs
  5417. listings, and more.  If you wish to create a subconference of message bases or
  5418. xfer sections or whatever, select "subconference" (.CNF).  Make sure you set 
  5419. this correctly.
  5420.  
  5421. Data pathname: specifies the data file associated with this object. The filename
  5422. will automatically be generated when you enter the area name, but you can edit
  5423. it here if you like. You should edit it here if you want a single conference
  5424. item to be accessible from multiple conferences.
  5425.  
  5426. Save and quit: Both self explanatory.
  5427.  
  5428. After you create a conference item, you will need to enter the conference item
  5429. to actually set up certain parameters for the area. If you enter a .BSE (message
  5430. base) item, it will ask for parameters for that message base.  If you enter an
  5431. .XFR (xfer section) item, you will be asked to define the first area in the xfer
  5432. section.  If you created a .CNF (subconference) item, you will be prompted for
  5433. the first item within this new subconference.  If you are setting up a new BBS
  5434. from scratch, it is suggested that you set up all of your conference items and
  5435. then do a global newscan to fill in all the data.  If you do not define the
  5436. individual areas, users will not be able to access them until you do.
  5437.  
  5438.  
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.  
  5445.  
  5446.  
  5447.  
  5448.  
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.   -----------------------------------------------------------------
  5461.     Celerity v2.0                                         Page 86
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.                 -= Celerity v2.0 Operations Manual =-
  5468.   -----------------------------------------------------------------
  5469.  
  5470. Creating Message Sub-Boards
  5471. ---------------------------
  5472.  
  5473. Message bases are the heart of the message system of Celerity BBS. After
  5474. creating a message base conference item, you will need to enter the message area
  5475. to actually build the message base. The first time the sysop account enters the
  5476. message base, you will be presented with the following menu options:
  5477.  
  5478.  [A] Name          : ABase
  5479.  [B] QWK Name      : NewBase
  5480.  [C] Data Pathname : c:\celerity\conf\abas.dat
  5481.  [D] QWK Conf #    : 12
  5482.  [E] Networks      :
  5483.  [F] Options       :
  5484.  [G] Base News     :
  5485.  [H] Origin Line   : A new sub-board!
  5486.  [S] Save and Quit
  5487.  [Q] Quit and abort
  5488.  
  5489. Name is the name which will appear at the top of every message as the user reads
  5490. the base.  It is almost always the same as the conference item name, although it
  5491. can differ if you need it to.
  5492.  
  5493. QWK Name is the name of the base which will be passed in QWK packets. There is a
  5494. separate entry for this because Celerity allows longer area names than QWK
  5495. readers will allow.  You may have a message base named "Celerity Computer
  5496. Communication" which would appear to a QWK reader as "Celerity Compu", which
  5497. obviously is not very enlightening.  Thus, you could set the QWK name to
  5498. "Celerity Comms".  Data pathname and Index pathname point to the index and data
  5499. files for the message base. Usually you will not need to mess with these.
  5500.  
  5501. Data Pathname:  This is the path of where the data for the message base will be
  5502. kept.  Four files will ultimately be created for each base, the .DAT file you
  5503. specify on this line, plus an index (.IDX), a base detail file (.BSE), and a
  5504. quickscan data file (.QSN). 
  5505.  
  5506. QWK Conference # specifies where this message base will be placed in a QWK
  5507. packet.  This _MUST_ be unique for every base on the system, or replies may get
  5508. sent to the wrong bases.
  5509.  
  5510. Options:  The options selection contains various parameters for the specific
  5511. base:
  5512.  
  5513.  - Full board limit:  specifies how many posts Celerity will allow to remain in
  5514. this message base.  If you set it to the default(100), Celerity will delete
  5515. messages when 100 messages exist on the board. If you set it to 20, only 20
  5516. messages will remain active at any time.  If you set it to 20000, a whole lot of
  5517.  
  5518.  
  5519.   -----------------------------------------------------------------
  5520.     Celerity v2.0                                         Page 87
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.                 -= Celerity v2.0 Operations Manual =-
  5527.   -----------------------------------------------------------------
  5528.  
  5529. messages will remain active.  When the limit is reached, Celerity will delete
  5530. the first message on the base to make room for new messages.
  5531.  
  5532.  - allow anonymous posts: If set, users who have a SL equal to or above the
  5533. level set in CELSETUP (see "Access Levels" above) have the ability to make
  5534. anonymous posts.
  5535.  
  5536.  - allow uploading: This option allows users to upload messages via a transfer
  5537. protocol.  It is recommended for ease of use.
  5538.  
  5539.  - allow post downloads: If set, users will be able to download a single message
  5540. as a text, ANSI, NAPLPS, or RIP file.
  5541.  
  5542.  - allow file attachments: If set, Users can attach a file to a message (you
  5543. could post an ad for a FIDO Network, and attach the application form). The
  5544. attach path is where these special files will be stored.
  5545.  
  5546.  - allow ANSI messages:  If this is set, all ANSI color and cursor commands will
  5547. be stripped from the message.  Some networks do not allow ANSI codes in thier
  5548. messages.
  5549.  
  5550.  - allow NAPLPS messages:  This setting will allow NAPLPS graphic messages to be
  5551. uploaded.
  5552.  
  5553.  - allow Personal messages:  This setting will set the base to support personal
  5554. messages only, as required by some networks.
  5555.  
  5556. Networks:  This provides information on setting up Fido Echomail networks and
  5557. QWK-based networks, which include the network type, the address of the system in
  5558. that particular network, the network echo name for the current base, and the
  5559. network identifier.
  5560.  
  5561.  - Base news: is the path to a text file which will be displayed when the
  5562. message base is entered.
  5563.  
  5564.  - Origin line: is a line of text which will appear at the bottom of all network
  5565. posts which originated on this particular message base.
  5566.  
  5567.  - Quit and Save are self-explanatory.
  5568.  
  5569. When you've finished with the sub, post the first message there. This message
  5570. should introduce the message base and indicate what it is to be used for.
  5571.  
  5572.  
  5573.  
  5574.  
  5575.  
  5576.  
  5577.  
  5578.   -----------------------------------------------------------------
  5579.     Celerity v2.0                                         Page 88
  5580.  
  5581.  
  5582.  
  5583.  
  5584.  
  5585.                 -= Celerity v2.0 Operations Manual =-
  5586.   -----------------------------------------------------------------
  5587.  
  5588. FidoNet Conferencing
  5589. --------------------
  5590.  
  5591. Please see the documentation with the CelToScn utility developed by Ted
  5592. Spaulding.
  5593.  
  5594.  
  5595. Using QWK Offline Readers
  5596. -------------------------
  5597.  
  5598. Celerity has the ability to create packets of messages which can be read with
  5599. any QWK-compatible offline reader. This allows users to quickly log on, create
  5600. and download a packet containing all their new messages, log off, and then read
  5601. the messages at their leisure without incurring phone costs. When the user
  5602. responds to messages, a REP response packet is created, and the user can upload
  5603. it to a Celerity board for processing.
  5604.  
  5605. Before the user can generate a QWK packet, he or she must define the bases he or
  5606. she wants to scan.  This is done via the normal configuration process of the
  5607. global quickscan.
  5608.  
  5609. When the SysOp sets up his system, there are a couple files that should be
  5610. created for the QWK function to work correctly.  These files include the
  5611. following (all are stored in the main BBS directory):
  5612.  
  5613.  - WELCOME.OFF - Displayed when a user enters the offline reader.
  5614.  - NEWS.OFF    - Displayed in the "News" option for most readers.
  5615.  - BYE.OFF     - Displayed when a user leaves the offline reader.
  5616.  - BLT-0.?     - Bulletin files.  First is BLT-0.1, second is
  5617.                  BLT-0.2, etc.
  5618.  
  5619. *-*-*-* Warning, PKZip 2.04c is not Compatible with the *-*-*-*
  5620. *-*-*-* QWK Sub-system. Use 2.04g or later!             *-*-*-*
  5621.  
  5622. Some recommended offline readers include Offline Express (OLX), Qmail Deluxe,
  5623. KingQWK, Silly Little Mail Reader, and Session Manager.
  5624.  
  5625.  
  5626.  
  5627.  
  5628.  
  5629.  
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.   -----------------------------------------------------------------
  5638.     Celerity v2.0                                         Page 89
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.                 -= Celerity v2.0 Operations Manual =-
  5645.   -----------------------------------------------------------------
  5646.  
  5647. Setting Up A Transfer Section
  5648. -----------------------------
  5649.  
  5650. Transfer area setup involves three stages.  The first was configuring your
  5651. transfer section options in CELSETUP.EXE to define the operation of the transfer
  5652. section as a whole, which was described previously (see "Transfer Options"
  5653. above).  The second stage is creating a transfer area conference item (see
  5654. "Creating Conference Trees" above).  The final step is to create the individual
  5655. file areas within the transfer section itself.
  5656.  
  5657.  
  5658. Creating Transfer File Areas
  5659. ----------------------------
  5660.  
  5661. After creating a transfer section conference item, you will need to enter the
  5662. section to actually build the first xfer area. The first time the sysop account
  5663. enters the section, you will be presented with the following menu options:
  5664.  
  5665.  [A] Area Name     : Newarea
  5666.  [B] Storage Path  : c:\
  5667.  [C] Data Pathname : c:\celerity\data\newarea.dir
  5668.  [D] Access Code   :
  5669.  [E] Options       :
  5670.  [S] Save and Quit
  5671.  [Q] Quit and abort
  5672.  
  5673. Name is the name of the file area you are creating (the first area of the entire
  5674. section when you first enter the section and create the first one).
  5675.  
  5676. Storage path points to a directory where uploads to this area will be stored. 
  5677. It is recommended that a separate DOS directory be specified for every transfer
  5678. area, but this is not essential.
  5679.  
  5680. Data pathname points to the .DIR and .DES files for this xfer area. This should
  5681. be unique for every area.  If it is not unique (ie: two areas point to the same
  5682. data path), the area will be "shared", and accessible in both areas.  It is
  5683. common for sysops to set up a sysop-only area named "Shared" or "Elevator" in
  5684. each transfer section with identical storage and data paths.  With this, a sysop
  5685. can move files into this area in one transfer section, then move them out in
  5686. another transfer section (thus the "elevator" metaphor).
  5687.  
  5688. Access code allows you to discriminate against users based on access (ie: you
  5689. would not want users under the age of 21 entering an adult area, for example). 
  5690. See the section on "Celerity Access Conditions" above for full details on
  5691. setting up access conditions.
  5692.  
  5693. The Options option contains various transfer area options which can
  5694. be modified on a base-by-base basis.  These include:
  5695.  
  5696.   -----------------------------------------------------------------
  5697.     Celerity v2.0                                         Page 90
  5698.  
  5699.  
  5700.  
  5701.  
  5702.  
  5703.                 -= Celerity v2.0 Operations Manual =-
  5704.   -----------------------------------------------------------------
  5705.  
  5706. Slow Drive - if data is stored on an optical drive, WORM, CD-ROM, tape drive
  5707. (with a DOS driver which allows instant access from DOS, such as TapeDisk), slow
  5708. network, or floppy, this option will speed up access.  Files will NOT be checked
  5709. for their existence when listing files, and they will be copied to a "fast"
  5710. drive (see "Directory for Slow Files" in the "Pathnames" setup above) before a
  5711. user downloads them.
  5712.  
  5713. Allow Uploads - allow uploading to this area.
  5714.  
  5715. Allow Downloads- allow downloading from this area.
  5716.  
  5717. Ratio Exempt - the area will ignore all ratio restrictions.
  5718.  
  5719. Free Area - the area will not charge any file points for downloads.
  5720.  
  5721. Scan Area - the area will be scanned for repeats when someone tries to upload.
  5722.  
  5723. Scan All Areas- if someone tries to upload to this area, should it scan all the
  5724. other areas with the  Scan Area option set.
  5725.  
  5726. Import FILE_ID.DIZ- if this option is set, Celerity will inspect an upload for a
  5727. FILE_ID.DIZ (or FILE_ID.CLR, or DESC.SDI) description and import it if it
  5728. exists.
  5729.  
  5730. Allow FILE_ID.DIZ Override - when this option is set, the user will be asked if
  5731. he or she wishes the FILE_ID.DIZ description to override his or her own.
  5732.  
  5733. Quit exits the area setup without saving changes.
  5734.  
  5735. Save exits the area and saves all changes to it.
  5736.  
  5737.  
  5738.  
  5739.  
  5740.  
  5741.  
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.  
  5750.  
  5751.  
  5752.  
  5753.  
  5754.  
  5755.   -----------------------------------------------------------------
  5756.     Celerity v2.0                                         Page 91
  5757.  
  5758.  
  5759.  
  5760.  
  5761.  
  5762.                 -= Celerity v2.0 Operations Manual =-
  5763.   -----------------------------------------------------------------
  5764.  
  5765. Setting Up Doors
  5766. ----------------
  5767.  
  5768. Celerity can support a wide array of "doors" such as online games, tape
  5769. retrieval systems, another BBS, online product ordering, and much more.  Doors
  5770. may be entire programs or simple utilities.
  5771.  
  5772. The BBS industry has a number of standard formats with which a BBS can transfer
  5773. information to a door which requires BBS information. The new standard which
  5774. most BBS programs now support is the DOOR.SYS standard. Other standards include
  5775. the RBBS/QBBS/Remote Access DORINFO.DEF format, and the WWIV-based CHAIN.TXT. 
  5776. Celerity supports all three of these formats, and when a door is run, DOOR.SYS,
  5777. DORINFO.DEF, and CHAIN.TXT are all created in the node directory.  It should be
  5778. noted that there are other formats (PCBOARD.SYS, CALLINFO.DAT, etc.) supported
  5779. by many doors which are not directly compatible with Celerity. (To use these
  5780. doors, use a door conversion program such as DOORWAY (shareware program
  5781. available on most BBS') to convert from one of the three supported formats to
  5782. the desired format. Nevertheless, over 95% of the BBS-supported doors can use
  5783. one of the Celerity supported formats.)
  5784.  
  5785. *Note that Celerity does NOT Re-read these files upon returning to celerity at
  5786. this time. Therefore, Time banks, Callback verification programs and the like
  5787. will not work.
  5788.  
  5789. To set up a BBS-supporting door (such as an online game - Global War and
  5790. Tradewars are two extremely popular examples), you should first unpack the game
  5791. and read all of its enclosed documentation. Look for sections supporting
  5792. DOOR.SYS, DORINFO.DEF, and CHAIN.TXT, and follow the instructions for setting up
  5793. with that configuration. If the door has configurable options for modem control,
  5794. make sure it reflects Celerity's modem settings.  If Celerity locks the COM
  5795. port at a specific DTE rate (as is the case with high speed modems), make sure
  5796. the door will do so as well.  Most doors will allow you to run in a local mode,
  5797. so you should try running it a few times locally to make sure everything is
  5798. working before you hook it up to Celerity.
  5799.  
  5800. Once the door is installed and configured, you can add access to it from
  5801. Celerity by entering a Door section (D from the main menu or as defined by you
  5802. in a conference tree). use the C)reate command to make a new door.  A display
  5803. will pop up, requesting the name / description of the door, required security
  5804. level to access it, the door type, and the file name to execute. If the file to
  5805. be executed is a batch file in the Doors Subdirectory, Set the Batch flag to
  5806. "YES"
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.   -----------------------------------------------------------------
  5815.     Celerity v2.0                                         Page 92
  5816.  
  5817.  
  5818.  
  5819.  
  5820.  
  5821.                 -= Celerity v2.0 Operations Manual =-
  5822.   -----------------------------------------------------------------
  5823.  
  5824. Door Example
  5825. ------------
  5826.  
  5827. An example batch file, "TRADEWAR", which I use for TradeWars is as follows:
  5828.  
  5829. copy \celerity\node1\door.sys \doors\tradewar
  5830. cd \doors\tradewar
  5831. tw2002 -door
  5832.  
  5833. The first line copies my DOOR.SYS to the door directory.
  5834.  
  5835. The second line switches to the Tradewar directory
  5836.  
  5837. The third line executes the door with the "-door" parameter - meaning "use
  5838. DOOR.SYS" to Tradewars.
  5839.  
  5840. Try running the door and see if the link works correctly.  If it does not, go
  5841. over all your filenames and make sure they are entered correctly.  Once it is
  5842. working locally (note that some doors cannot be run from within the BBS for
  5843. local callers, and will exit immediately if they do not find a carrier), have a
  5844. user call and try to use it.
  5845.  
  5846. Remember, if you like a door and decide to use it, you should support the
  5847. Shareware concept by registering it (given that it is a Shareware product, of
  5848. course).
  5849.  
  5850. Other doors can be created which do not support BBS' directly, although they
  5851. should have some kind of modem support if the calling user is expected to see
  5852. any displays or enter any input.  When running another BBS or remote control
  5853. program (Remote Access, Carbon Copy, PC Anywhere, and so on), communications
  5854. support is a given.  When running some other utility, however, it might not be
  5855. so easy. Some programs such as DOORWAY or DOS's CTTY can re-map all screen
  5856. output and console input over the modem, which may be necessary.  When running
  5857. extensive applications or utilities, however, it is recommended that one of the
  5858. above remote control programs be used.  
  5859.  
  5860. There is a freeware utility called REMOTE.EXE which comes with Celerity which
  5861. can be used to redirect input and output for many DOS programs.  You may run
  5862. this utility in your Door batch file to provide users with access to these
  5863. non-modem-aware doors. 
  5864.  
  5865.  
  5866.  
  5867.  
  5868.  
  5869.  
  5870.  
  5871.  
  5872.  
  5873.   -----------------------------------------------------------------
  5874.     Celerity v2.0                                         Page 93
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.                 -= Celerity v2.0 Operations Manual =-
  5881.   -----------------------------------------------------------------
  5882.  
  5883. Section 3: BBS Operations
  5884. =========================
  5885.  
  5886. Wait For Calls Screen
  5887.  
  5888. When the BBS is waiting for a call, you will get a complete display of various
  5889. statistics and the like. At the top left you will see the version number of
  5890. Celerity, followed by your board's name, followed by your personal serial
  5891. number.
  5892.  
  5893. Immediately below this is a glowing "thermometer" bar, which is an indication of
  5894. space used on the drive. If it is small, your drive(s) are nearly empty. If it
  5895. has grown large, then you may want to clean out some older files. This permits
  5896. the sysop to determine how much space is free at a glace, which can be quite
  5897. helpful for sysops who don't log onto their board every day, or those with
  5898. small hard drives. The box below that holds various system statistics, which are
  5899. pretty self-explanatory, so I won't insult your intelligence and describe them.
  5900. Every few seconds, the information box will scroll to display additional info.
  5901. On the left below the statistics box is a box which shows the last caller to the
  5902. BBS. 
  5903.  
  5904. At the lower right side of the screen is a statistic box showing the status of
  5905. timed events (CelerityNet call(Currently inactive), auto backup, and batch
  5906. event), the amount of free storage space, the time and date, chat status (This
  5907. can be toggled by ALT-A), and modem status.
  5908.  
  5909. At the Lower Left is the System Status Box. It contains information on the SIO
  5910. Chip in use, the Modem Driver in use (Internal, Fossil, or Digiboard) The
  5911. Operating Environment, The Name of the Registered Sysop, and any special
  5912. Warnings that the Sysop may not be aware of (Like a DANGEROUSLY small amount of
  5913. Free Space)
  5914.  
  5915. If you press Alt-H, this box will be replaced with the main command help screen.
  5916. If you press it again, the display will change to the multinode status screen
  5917. (on multinode systems) showing the current status of nodes 1 through 8.  
  5918.  
  5919. The commands that can be used from the WFC screen are as follows:
  5920.  
  5921.  - F2 exits from the BBS.
  5922.  
  5923.  - F3 will force the modem to send a carrier. It is suggested that you let
  5924. people connect by calling in, but if you need to send a carrier, this is how you
  5925. can do it.
  5926.  
  5927.  - F4 performs an "instant login" for the sysop. The sysop is immediately
  5928. deposited at the main command prompt without having to enter passwords, read
  5929. mail, and other time-consuming options.  Each sysop who appears in this list
  5930. must have the appropriate sysop flag set (see "Access Conditions" above).
  5931.  
  5932.   -----------------------------------------------------------------
  5933.     Celerity v2.0                                         Page 94
  5934.  
  5935.  
  5936.  
  5937.  
  5938.  
  5939.                 -= Celerity v2.0 Operations Manual =-
  5940.   -----------------------------------------------------------------
  5941.  
  5942.  - F5 will enter the Online Tools menu. A collection of Sysop- Definable
  5943. external utilities which will be discussed in the section on "External
  5944. Utilities" below.
  5945.  
  5946.  - F8 will take the phone off hook so users calling will get a busy signal. This
  5947. resets after a few minutes.
  5948.  
  5949.  - F9 brings you into the Wait For Call options menu. This allows a sysop to
  5950. read mail, edit users, view lists of recent calls, recent uploads, and recent
  5951. downloads, view the sysop and error logs, and more.
  5952.  
  5953.  - F10 logs on locally. If you've got the "Auto-login" option set in CONFIG,
  5954. then account #1 will automatically log on. If not, you will be thrown into the
  5955. shell or main menu, depending on whether or not you have a shell set up.
  5956.  
  5957. Not shown on the menu:
  5958.  
  5959.  - F6 will run a user-defined external program. This program is set up as a
  5960. batch file called DEFINE.BAT, although you can change this to anything you want.
  5961. Look in the MAIN.BAT file which manages the BBS under the label :userdefine for
  5962. the text to change. Put your word processor, virus scanner, or whatever you want
  5963. here.
  5964.  
  5965.  - F7 will run the user-defined terminal program. Similar to F6 above, this must
  5966. be set up in the MAIN.BAT file under the label :terminal.
  5967.  
  5968.  - Alt-F10 will automatically log the sysop in, regardless of the "Auto-login"
  5969. option setting.
  5970.  
  5971.  - Alt-D will drop into DOS. Typing EXIT returns to the WFC. (Note: If you load
  5972. a TSR While in the shell, you may lose the "hooks" into the Celerity session.
  5973. the only way to recover from this is by rebooting the system!)
  5974.  
  5975. Note that if the "Secure Console" option in "System Options" above is set, none
  5976. of these keyboard commands (other than F10) will function.
  5977.  
  5978.  
  5979. When the BBS is at the wait for calls screen, it will wait for various events
  5980. during the day.  The following events may be performed:
  5981.  
  5982. WFC Status Panel Cycle:  Approximately every 10 seconds, the WFC display panel
  5983. will cycle.
  5984. Multinode Status Refresh:  Every 3 seconds, the multinode status updates.
  5985. System Status:  The system status data is updated every 10 seconds.
  5986. Modem Initialize:  Every four minutes, the modem will be reinitialized.
  5987. End of Day:  At the end of the day, a brief history reconciliation will be
  5988. performed.
  5989. End of Month:  At the end of the month, Celerity will update the top ten files.
  5990.  
  5991.   -----------------------------------------------------------------
  5992.     Celerity v2.0                                         Page 95
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.                 -= Celerity v2.0 Operations Manual =-
  5999.   -----------------------------------------------------------------
  6000.  
  6001. Auto-Backup:  If you have it defined, the Auto-backup will be performed at the
  6002. specified time.  See "Timed Events" above.
  6003. Batch Event:  If you have it defined, the Batch Event will be performed at the
  6004. specified time.  See "Timed Events" above.
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013.  
  6014.  
  6015.  
  6016.  
  6017.  
  6018.  
  6019.  
  6020.  
  6021.  
  6022.  
  6023.  
  6024.  
  6025.  
  6026.  
  6027.  
  6028.  
  6029.  
  6030.  
  6031.  
  6032.  
  6033.  
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.  
  6041.  
  6042.  
  6043.  
  6044.  
  6045.  
  6046.  
  6047.  
  6048.  
  6049.  
  6050.   -----------------------------------------------------------------
  6051.     Celerity v2.0                                         Page 96
  6052.  
  6053.  
  6054.  
  6055.  
  6056.  
  6057.                 -= Celerity v2.0 Operations Manual =-
  6058.   -----------------------------------------------------------------
  6059.  
  6060. Online Commands
  6061. ---------------
  6062.  
  6063. There are a number of keys which can be used at the local console when a user is
  6064. online.  Note that if the "Secure Console" option in "System Options" above is
  6065. set, these keyboard commands will not function.
  6066.  
  6067. With version 2.02, all of these keys are definable by the system operator
  6068. through the use of the SYSTEM.KBD file.  Please see the section  on "Customizing
  6069. Console Commands" below for a full description of how to define these commands
  6070. and what their initial definition is with the SYSTEM.KBD which ships with
  6071. Celerity BBS.
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.  
  6080.  
  6081.  
  6082.  
  6083.  
  6084.  
  6085.  
  6086.  
  6087.  
  6088.  
  6089.  
  6090.  
  6091.  
  6092.  
  6093.  
  6094.  
  6095.  
  6096.  
  6097.  
  6098.  
  6099.  
  6100.  
  6101.  
  6102.  
  6103.  
  6104.  
  6105.  
  6106.  
  6107.  
  6108.  
  6109.   -----------------------------------------------------------------
  6110.     Celerity v2.0                                         Page 97
  6111.  
  6112.  
  6113.  
  6114.  
  6115.  
  6116.                 -= Celerity v2.0 Operations Manual =-
  6117.   -----------------------------------------------------------------
  6118.  
  6119. Inside the BBS
  6120. --------------
  6121.  
  6122. Once you log into the BBS, you can navigate throughout it and use commands like
  6123. any remote caller would.  Using a "?" at nearly any prompt will provide a menu
  6124. for that prompt.  Detailed explanations of every command in the BBS are not
  6125. documented in this file as of this writing, but should be with version 2.10. 
  6126. Generally, feel free to experiment with commands around the BBS.
  6127.  
  6128. At nearly every prompt of the BBS, there are additional "slash" commands which a
  6129. sysop or user may use.  Each of these special commands begins with a "/"
  6130. (slash).  They are as follows:
  6131.  
  6132. /HELP     : Present a list of supported slash commands.
  6133. /PAGE     : Perform an emergency chat page to the sysop. Requires a password
  6134. previously defined (see "System Passwords" above).  The emergency chat will be
  6135. called whatever the state of the "sysop availability" status (see "Customizing
  6136. Console Commands" below, and "Waiting for Call Screen" above).
  6137. /CHAT     : Request a normal chat.  This will be denied if the sysop is not
  6138. available (see "Customizing Console Commands" below, and "Waiting for Call
  6139. Screen" above).
  6140. /CACHE: Displays text cache statistics (see "What is CelerityText" below).
  6141. /LANG     : Display details of the currently select language file, and flush the
  6142. text cache.
  6143. /MENU     : Display the details of the current menu file and flush the text
  6144. cache.
  6145.      : Display a RIP graphics test screen./RIP
  6146. /NAPLPS:Display a NAPLPS graphics test screen.
  6147. /SETUP: If the user is a sysop, this command will re-load the Celerity setup
  6148. from disk.  This is handy if you drop to dos and run CelSetup and want to see
  6149. the differences immediately.
  6150. /VER : Display Celerity BBS version information.
  6151. /OFF : Log off the BBS instantly.
  6152. /O   : Same as /OFF.
  6153. /Mx  : Send an inter-node message to node #x.
  6154.      : List users on other nodes of the BBS./L
  6155. /ORIG : Load in the user who originally logged onto the BBS.  This is useful for
  6156. sysops who enter the user custodian and switch to another user to use the BBS.
  6157.  
  6158. Other commands may be added in the future.
  6159.  
  6160.  
  6161.  
  6162.  
  6163.  
  6164.  
  6165.  
  6166.  
  6167.  
  6168.   -----------------------------------------------------------------
  6169.     Celerity v2.0                                         Page 98
  6170.  
  6171.  
  6172.  
  6173.  
  6174.  
  6175.                 -= Celerity v2.0 Operations Manual =-
  6176.   -----------------------------------------------------------------
  6177.  
  6178. Section 4: Customizing Celerity
  6179. -------------------------------
  6180.  
  6181. Introduction
  6182. ------------
  6183.  
  6184. One of the specialties of Celerity is its ability to allow SysOps to change the
  6185. way it looks and feels.  A number of display screens and display features may be
  6186. altered or radically changed to suit the SysOp's desires.
  6187.  
  6188. Some of the factors affecting a user's display are changed in CelSetup, but will
  6189. be outlined here for your convenience.
  6190.  
  6191. Color Setup:  This section also has an impact on the appearance of your system,
  6192. particularly the default user colors.  Although users can and do change their
  6193. colors, many people get a first impression from the look of the default color
  6194. set.
  6195.  
  6196. CelerityText files: With version 2.0, Celerity now supports external
  6197. CelerityText files used to tailor each and every bit of textual data within the
  6198. BBS.  Although a few other BBS programs support external language files, none of
  6199. them have developed a system so flexible, comprehensive, or efficient as
  6200. Celerity has. See the section on "CelerityText" below for full details.
  6201.  
  6202.  
  6203. Color Codes
  6204. -----------
  6205.  
  6206. Celerity BBS allows sysops and users easy access to colors within the BBS.  You
  6207. need not learn arcane ANSI command sequences like Escape[42m; to define a color,
  6208. you can use simple two-character "pipe codes".  Pipe codes are always preceded
  6209. by a pipe character (|) and consist of a single digit.
  6210.  
  6211. Celerity pipe codes may be used in any user-viewable text within the BBS,
  6212. including setup-configured text, message titles, tag lines, file descriptions,
  6213. and more.  Note that if you are viewing this documentation file from within
  6214. Celerity, the pipe code examples in this file will be executed and your display
  6215. may look strange.  The following pipe commands are currently supported:
  6216.  
  6217. |1 - User defined color #1
  6218. |2 - User defined color #2
  6219. |3 - User defined color #3
  6220. |4 - User defined color #4
  6221. |5 - User defined color #5
  6222. |6 - User defined color #6
  6223. |7 - User defined color #7
  6224. |8 - User defined color #8
  6225. |9 - Carriage return
  6226.  
  6227.   -----------------------------------------------------------------
  6228.     Celerity v2.0                                         Page 99
  6229.  
  6230.  
  6231.  
  6232.  
  6233.  
  6234.                 -= Celerity v2.0 Operations Manual =-
  6235.   -----------------------------------------------------------------
  6236.  
  6237. |k = Low intensity black
  6238. |b - Low intensity blue
  6239. |g - Low intensity green
  6240. |c - Low intensity cyan
  6241. |r - Low intensity red
  6242. |m - Low intensity magenta
  6243. |y - Low intensity yellow (brown)
  6244. |w - Low intensity white
  6245. |d - High intensity black (dark gray)
  6246. |B - High intensity blue
  6247. |G - High intensity green
  6248. |C - High intensity cyan
  6249. |R - High intensity red
  6250. |M - High intensity magenta
  6251. |Y - High intensity yellow (yellow)
  6252. |W - High intensity white
  6253. |S - Swap foreground and background colors (to change background)
  6254. |P - Pause (ask user to hit enter)
  6255. |D - Display current date
  6256. |T - Display current time
  6257. |H - Home (clear screen)
  6258. |X - Blinking attribute on
  6259. |x - Blinking attribute off
  6260. |O - Cursor on
  6261. |o - Cursor off
  6262.  
  6263. For example, |W would set the text color to bright white.  |g sets the text to
  6264. low-intensity green.  |b|S|W would set the color to blue, switch the blue to the
  6265. background, and set the foreground color to white, this giving you white on
  6266. blue.  |1|S|1 would take the user's defined color #1 and reverse it.
  6267.  
  6268. Celerity pipe codes are the recommended method of changing colors within
  6269. CelerityText files (see "CelerityText" below).
  6270.  
  6271.  
  6272.  
  6273.  
  6274.  
  6275.  
  6276.  
  6277.  
  6278.  
  6279.  
  6280.  
  6281.  
  6282.  
  6283.  
  6284.  
  6285.  
  6286.   -----------------------------------------------------------------
  6287.     Celerity v2.0                                         Page 100
  6288.  
  6289.  
  6290.  
  6291.  
  6292.  
  6293.                 -= Celerity v2.0 Operations Manual =-
  6294.   -----------------------------------------------------------------
  6295.  
  6296. The CelerityText Display System
  6297. -------------------------------
  6298.  
  6299. What is CelerityText?
  6300. ---------------------
  6301.  
  6302. CelerityText is a set of command codes which can be imbedded in normal text to
  6303. allow Celerity to perform special operations when displaying files.  The
  6304. CelerityText system is also used to define nearly all displays in the BBS,
  6305. allowing the creative sysop to change the way his or her BBS appears and
  6306. operates.
  6307.  
  6308. CelerityText files consist of a pair of data files, and are used for BBS text
  6309. (as "language files") or BBS menus and prompts (as "menu files"). These are NOT
  6310. text-based files, and you should not edit them with a text editor or word
  6311. processor.
  6312.  
  6313. Implementation of the CelerityText files has freed up a considerable amount of
  6314. the conventional memory requirements of Celerity, which can now be used for the
  6315. overlay buffer with an overall result of INCREASING the speed of the software,
  6316. despite the necessity to load the language data from diskette as needed. The
  6317. files are supported by a multi-level intelligent cache to speed up performance.
  6318.  
  6319. CelerityText files will allow sysops to customize their BBS' much more than they
  6320. could in the past, and enable them to design a system with any motif they like.
  6321. CelerityText files include full support of pipe color commands, plus a powerful
  6322. and expansive list of command directives (see below) similar to those used by
  6323. PC-Board and WildCat! to allow the sysop much more flexibility in design.
  6324.  
  6325. The language editor will also allow you to import external files into your
  6326. CelerityText files, so you may design bits of text or entire screens with your
  6327. favorite text or ANSI editor (yes, ANSI is fully supported in CelerityText
  6328. files). Even NAPLPS and RIP graphics are supported, allowing a sysop to design a
  6329. completely graphical system around Celerity.  Want to build a full-screen ANSI
  6330. page to ask a user the name of a post?  No problem.  Best of all, entries in
  6331. Celerity's CelerityText files have NO LIMIT ON SIZE - if you wanted to have a
  6332. massive 500k ANSI animation depicting a postman delivering a letter (to tell a
  6333. user that an email message has been delivered), Celerity will have no problem
  6334. with it.  The possibilities are endless.  Celerity already has plans for
  6335. translation into foreign languages, another important benefit of CelerityText
  6336. files, particularly for our systems in Europe and Asia.
  6337.  
  6338. Nearly every display in Celerity has a corresponding language entry, many of
  6339. them will pass special parameters.  The best way to learn how to modify the
  6340. language files is to modify a currently existing one.
  6341.  
  6342.  
  6343.  
  6344.  
  6345.   -----------------------------------------------------------------
  6346.     Celerity v2.0                                         Page 101
  6347.  
  6348.  
  6349.  
  6350.  
  6351.  
  6352.                 -= Celerity v2.0 Operations Manual =-
  6353.   -----------------------------------------------------------------
  6354.  
  6355. Editing CelerityText files
  6356. --------------------------
  6357.  
  6358. CelerityText files may be edited with the EDITLANG language editor, or other
  6359. third-party language file editors which are forthcoming.
  6360.  
  6361. Please refer to the Doc file that came with your Editor for details on usage.
  6362.  
  6363. If you wish to edit CelerityText language and menu files with any enthusiasm
  6364. greater than browsing the file and changing a few entries, please obtain the LDK
  6365. (Language Development Kit, such as CEL202LD.ZIP) from a Celerity support BBS for
  6366. complete details on what every entry is used for.
  6367.  
  6368. Please note that language entries should be edited with consideration for their
  6369. context within the BBS.  Some entries are very length-dependent, and your
  6370. displays may look a bit skewed if the original length is not preserved and/or
  6371. you do not update other entries accordingly.  Some entries should have carriage
  6372. returns on the end, some should not.  Some entries require command parameters,
  6373. some do not.  We recommend that you test your entries as you make them within
  6374. your BBS itself.  This can easily be done while on-line, dropping to DOS to edit
  6375. an entry, exiting back to the BBS, and viewing the text.
  6376.  
  6377. Typing Alt-L (default definition - may be changed in the SYSTEM.KBD file) from
  6378. the local end will force Celerity to display the entry identification numbers
  6379. before each entry, which can be invaluable when debugging language entries.
  6380.  
  6381.  
  6382.  
  6383.  
  6384.  
  6385.  
  6386.  
  6387.  
  6388.  
  6389.  
  6390.  
  6391.  
  6392.  
  6393.  
  6394.  
  6395.  
  6396.  
  6397.  
  6398.  
  6399.  
  6400.  
  6401.  
  6402.  
  6403.  
  6404.   -----------------------------------------------------------------
  6405.     Celerity v2.0                                         Page 102
  6406.  
  6407.  
  6408.  
  6409.  
  6410.  
  6411.                 -= Celerity v2.0 Operations Manual =-
  6412.   -----------------------------------------------------------------
  6413.  
  6414. Command Directives
  6415. ------------------
  6416.  
  6417. In addition to the Celerity pipe codes which can be used in any user-viewable
  6418. text within Celerity, the CelerityText files support a number of special command
  6419. directives.  Command directives are commands enclosed in a pair of "@"
  6420. characters.  These will function ONLY for CelerityText files, and not within
  6421. posts.
  6422.  
  6423. At the request of a couple sysops, I have chosen to follow the general standard
  6424. (@ as the command identifier) set by PC-Board, Wildcat!, etc. and have adopted
  6425. some of their commands. Note that Celerity supports a much broader array of
  6426. command directives than other packages.  Note that the color codes follow the
  6427. PCB @Xbf@ rather than the WildCat @bf@ convention.
  6428.  
  6429. A complete and up-to-date listing of Command Directives can be found in the
  6430. Language Development Kit (LDK) documentation, but some of the more common ones
  6431. are listed here.
  6432.  
  6433. For an easy way to test a new command directive, make a file called "TEST.TXT"
  6434. in the main BBS directory.  From the main menu, pressing "=" will display this
  6435. file, decoding any CelerityText command directives it finds.  This can be used
  6436. as a quick and effective way of playing with new directives and learning how
  6437. they work.
  6438.  
  6439.  
  6440. Text Formatting
  6441. ---------------
  6442.  
  6443. Use of the CelerityText files allow a sysop or artist to design the system's
  6444. text in whichever way he or she desires, and with this comes the need for format
  6445. the text displays, particularly in the case of listings.  In addition to regular
  6446. ANSI codes for cursor positioning, Celerity provides a few simple yet very
  6447. powerful text formatting tools in the command directives which no other BBS can
  6448. match. 
  6449.  
  6450. @CEOL@ will clear everything right of the cursor on the current line.
  6451. @CLS@ will clear the screen.
  6452. @NAPON@ will put Celerity into NAPLPS graphics mode 
  6453.      and send "graphics on"
  6454. @NAPOFF@ will send the NAPLPS "graphics off" command
  6455. @POS=xx,yy@ will move the cursor to location xx,yy.  Both XX and YY 
  6456.      must be two-digit codes.
  6457. @REOL=x@ repeats character x to the end of the line (position 79)
  6458.  
  6459.  
  6460.  
  6461.  
  6462.  
  6463.   -----------------------------------------------------------------
  6464.     Celerity v2.0                                         Page 103
  6465.  
  6466.  
  6467.  
  6468.  
  6469.  
  6470.                 -= Celerity v2.0 Operations Manual =-
  6471.   -----------------------------------------------------------------
  6472.  
  6473. @Xbf@ will set the color to hex value bf. 'b' represents background value in
  6474. hex, 'f' represents the foreground.  A 'b' value greater than 7h will set the
  6475. "blink" bit.
  6476. @XPOS=xx@ will move the cursor to the x position, keeping current line
  6477. @YPOS=yy@ will move the cursor to the y position, retaining the column
  6478.  
  6479. Celerity will also let you format blocks of text displayed with the command
  6480. parameters.  The syntax of this is a colon (:) followed by the justification key
  6481. (R, L, or C) followed by a two-digit field size, an optional spacing character,
  6482. and finally null entries.   This is best explained by example:
  6483.  
  6484. @PARAM=1:L20@ will display the Param1 text, left justified in a 20-character
  6485. field. 
  6486. @SYSOP:R50@   will display the sysop's name, right justified in a 50-character
  6487. field.
  6488. @BBS:C79.@    will display the BBS name, centered in an 80-character field. Note
  6489. the dot following the :C80 - this indicates that Celerity should use a '.' for
  6490. the spacing, so this command directive would appear as:
  6491.  - ........................Terrapin Station........................
  6492. If no spacing character is given, a space ' ' is assumed.
  6493. @NAME:L13.  @ In this case, there are trailing spaces following the formatting
  6494. code and spacing character.  These spaces are ignored, and can be used to help
  6495. lay out the fields in your CelerityText files (ie: expand the command directive 
  6496. @xzxzxx@ to fill as many spaces as it will take when displayed on the BBS).
  6497.  
  6498. These formatting tools have been designed to be as flexible as possible, given
  6499. the need to keep them simple, efficient, and speedy.  Experiment to learn the
  6500. nuances of them.  Remember that the values must be two digits!
  6501.  
  6502.  
  6503. Other Command Directives
  6504. ------------------------
  6505.  
  6506. Below is a partial list of additional command directives.  New directives are
  6507. added with every version, so always check with the latest Language Development
  6508. Kit (LDK) for any changes.
  6509.  
  6510. As with the text formatting above, the best way to learn the details of these
  6511. entries is to look at examples in current language files, and to experiment with
  6512. them.
  6513.  
  6514. @@ will display a "@".
  6515. @ABORTOFF@ will disable the ability for a user to abort the text
  6516. @ABORTON@ will re-enable the keypress abort
  6517. @ACCESSLEVEL@ displays the user's access level.
  6518. @BBS@ shows the long BBS name
  6519. @BBSSHORT@ shows the short BBS name
  6520. @BBSACRO@ Shows the BBS' acronym
  6521.  
  6522.   -----------------------------------------------------------------
  6523.     Celerity v2.0                                         Page 104
  6524.  
  6525.  
  6526.  
  6527.  
  6528.  
  6529.                 -= Celerity v2.0 Operations Manual =-
  6530.   -----------------------------------------------------------------
  6531.  
  6532. @BBS2@ shows the name of the system 2
  6533. @BBS3@ shows the name of the system 3
  6534. @BOTTOMLINE@ will move the cursor to the bottom display line of the user's
  6535. screen.
  6536. @BOTTOMLINE2@ moves the cursor to the line second from the bottom.
  6537. @BOTTOMLINE3@ moves the cursor to the line third from the bottom.
  6538. @BOTTOMLINE4@ moves the cursor to the line fourth from the bottom,
  6539. @BYTESDN@ shows the number of bytes the user has downloaded.
  6540. @BYTESLEFT@ will display the user's remaining download Kbytes available
  6541.      (Note: This displays KBYTES, not BYTES as PCBoard does)
  6542. @BYTESUP@ shows the number of bytes the user has uploaded.
  6543. @COMMPOINTS@ displays how many points the user has gained from commissions.
  6544. @CPSRATE@ indicates the user's average cps download rate.
  6545. @CURCONF@ shows the name of the current conference.
  6546. @CURAREA@ shows the name of the current message/xfer area.
  6547. @DATAPHONE@ shows the user's modem number
  6548. @DATE@ will show the current date, like Pipe-D
  6549. @DELAY=xx@ will pause for xx tenths of a second (ie: delay=10 will delay
  6550. for one second).  This must be a two-digit code.
  6551. @DISP=xxxx@ Displays a different language file entry
  6552. @EXEC=<pathname>@ will execute a batch, .exe, or .com file specified by pathname
  6553. as a door.
  6554. @FAXPHONE@ shows the user's FAX number
  6555. @FILEPOINTS@ shows the user's file point balance.
  6556. @FIRST@ will display the user's handle (see @USER@, @NAME@)
  6557. @GENR@ displays the user's current general ratio
  6558. @HACKS@ shows the number of hack attempts since the user's last call.
  6559. @HANGUP@ will hang up on the user.
  6560.      Integer variables I0 to I9 are supported, with values of -32768 to 32767. @Ix@
  6561. Operations on them can include +, -, /, and * operations. They can be referred
  6562. to with the @POS=Ix,Ix@, @XPOS=Ix@, and @YPOS=Ix@ commands.
  6563. @Ix=n@ Sets integer variable x to value n
  6564. @Ix=++@ Increments variable x by 1
  6565. @Ix=--@ Decrements variable x by 1
  6566. @Ix=Iy+n@ Sets variable x to variable y + n.
  6567. @Ix=Iy+Iz@ Sets variable x to variable y + variable z.
  6568. @Ix=WHEREX@ Sets variable x to the current cursor X position.
  6569. @Ix=WHEREY@ Sets variable x to the current cursor Y position.
  6570. @KBYTESDN@ shows how many Kbytes the user has downloaded.
  6571. @KBYTESUP@ shows how many Kbytes the user has uploaded.
  6572. @KTODAY@ shows how many kbytes the user has downloaded today
  6573. @KPERDAY@ shows how many kbytes the user may download daily
  6574. @LASTCALLER@ displays the name/handle of the last caller.
  6575. @LASTOND@ Displays the date (Thus the trailing D) the user last called
  6576. @LASTONT@ displays the time of the user's last call.
  6577. @LASTONAD@ Displays the absolute date a user last called.  Good for editing
  6578. other users.  This will display the date the current user called last as well AS
  6579. SAVED IN THE USER RECORD, meaning the current date.
  6580.  
  6581.   -----------------------------------------------------------------
  6582.     Celerity v2.0                                         Page 105
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.                 -= Celerity v2.0 Operations Manual =-
  6589.   -----------------------------------------------------------------
  6590.  
  6591. @LASTONAT@ displays the time of the absolute last call.
  6592. @MAILCOUNT@ shows how much new mail is waiting for the user
  6593. @MONTHDNS@ shows the number of downloads made this month.
  6594. @MONTHKDN@ shows how many kbytes downloaded this month.
  6595. @MONTHKUP@ shows how many kbytes uploaded this month.
  6596. @MONTHPOSTS@ shows how many posts the user made this month.
  6597. @MONTHUPS@ shows the number of uploads made this month.
  6598. @NAME@ will display the user's handle (see @USER@, @FIRST@)
  6599. @NODE@ shows the node the user is currently on
  6600. @NOTE@ displays the user's public note
  6601. @NEWMESSAGES@ shows the number of new unread messages since last call
  6602. @NEWUPLOADS@ shows how many new uploads there were since last call
  6603. @NEWUSERS@ shows the number of new users pending in the new user voting
  6604. @NUMCALLS@ Displays the number of times this user has called the system.
  6605. @NUMDNS@ shows the total # of downloads the user has made.
  6606. @NUMPOSTS@ shows how many posts the user has made.
  6607. @NUMUPS@ will display the total # of uploads the user has made.
  6608. @PARAM=x@ will display system parameter #x.  These are defined on a case-by-case
  6609. basis by various functions throughout the BBS.  Uncertain results may occur if
  6610. you add parameters which have not been declared by the particular function - see
  6611. the definition list for parameter definitions.
  6612. @P=x@ is the functional equivilent of @PARAM=x@ above, but in shorthand.
  6613. @PASSWORD@ shows the user's password (use this with caution - some users call
  6614. from public places and don't want people peering over thier shoulder to see
  6615. this)
  6616. @PAUSE@ will wait for a user's keypress.
  6617. @PCR@ shows the user's post/call ratio.
  6618. @PHONENUM@ displays the user's voice phone #
  6619. @REALNAME@ displays the user's real name
  6620. @REQPCR@ shows the user's required PCR
  6621. @REQUDR@ shows the user's required UDR
  6622. @REQGENR@ shows the user's required general ratio
  6623. @SHOWFILE=pppp@ will recursively display a text file, with command directive
  6624. support.  "pppp" is the full path and filename of the text file to display, and
  6625. may be up to 71 characters long.  Be careful with these!  It is possible for a
  6626. file to display itself, resulting in a loop only breakable by hanging up.
  6627. @SOFTWARE@ displays the software name (Celerity, CAE, CAE/TAC, Alacrity)
  6628. @SPACE=xx@ inserts xx number of spaces
  6629. @SYSOP@ will display the sysop name.
  6630. @SYSAVAIL@ will display the current "Chat Availability" string from setup
  6631. @SYSOPNOTE@ displays the user's sysop note (note: This is intended to be 
  6632. private, although it can be used however you deem appropriate)
  6633. @TIME@ will show the current time, like Pipe-T
  6634. @TIMELEFT@ will show how many minutes the user has remaining.
  6635. @TIMEONLINE@ will display the number of minutes spent on this call
  6636. @TOTALTIME@ shows the total number of minutes the user has ever been on your
  6637. BBS.
  6638. @UDKRATIO@ shows the user's upload/downloaded kbyte ratio.
  6639.  
  6640.   -----------------------------------------------------------------
  6641.     Celerity v2.0                                         Page 106
  6642.  
  6643.  
  6644.  
  6645.  
  6646.  
  6647.                 -= Celerity v2.0 Operations Manual =-
  6648.   -----------------------------------------------------------------
  6649.  
  6650. @UDR@ shows the user's upload/download ratio.
  6651. @USER@ will display the user's handle (see @FIRST@, @NAME@)
  6652. @USERNOTE@ will display the user's public "note"
  6653. @VALPOINTS@ shows how many points the user has gained from file validations.
  6654. @VERSION@ displays the Celerity version number.
  6655. @XFERLEVEL@ shows the user's transfer access level.
  6656.  
  6657. Again, serious users of CelerityText should download the LDK for more details on
  6658. how to best use these directives.  Please refer to the documentation with the
  6659. Language Editor as well.
  6660.  
  6661.  
  6662.  
  6663.  
  6664.  
  6665.  
  6666.  
  6667.  
  6668.  
  6669.  
  6670.  
  6671.  
  6672.  
  6673.  
  6674.  
  6675.  
  6676.  
  6677.  
  6678.  
  6679.  
  6680.  
  6681.  
  6682.  
  6683.  
  6684.  
  6685.  
  6686.  
  6687.  
  6688.  
  6689.  
  6690.  
  6691.  
  6692.  
  6693.  
  6694.  
  6695.  
  6696.  
  6697.  
  6698.  
  6699.   -----------------------------------------------------------------
  6700.     Celerity v2.0                                         Page 107
  6701.  
  6702.  
  6703.  
  6704.  
  6705.  
  6706.                 -= Celerity v2.0 Operations Manual =-
  6707.   -----------------------------------------------------------------
  6708.  
  6709. Information Scripts
  6710. -------------------
  6711.  
  6712. Celerity Information Scripts are designed to allow a sysop to create
  6713. informational questionnaires for users to fill out to request access to the BBS
  6714. or specific sections, or to gather general data about the users. They are
  6715. powerful, and therefore can be very complex.  You may wish to look at some
  6716. example scripts before attempting to create your own.
  6717.  
  6718. File Formats
  6719.  
  6720. There are three primary files used: *.INF, *.ANW, and *.IDF. The INF contains
  6721. both questions and commands for how to process them.  The ANW file contains
  6722. answers to the questions for filled-out scripts, and the IDF file (InfoScript
  6723. Display File) is an optional file used to display the answer data when the
  6724. script answers are viewed. INF and ANW files are straight text, where an IDF
  6725. file may contain ANSI.  All three file types reside in the DISPLAY directory.
  6726.  
  6727. Celerity BBS supports up to five main scripts, as defined in the "Information
  6728. Scripts" setup above.  The data files should reside in your DISPLAY directory,
  6729. and be named INFOx.IDF, INFOx.ANW, and INFOx.INF, where x is a number from 1 to
  6730. 5.  The .ANW file will be automatically created when the script is filled out,
  6731. so you need not be concerned about creating this file.
  6732.  
  6733.  
  6734. The Infoscript Display File
  6735. ---------------------------
  6736.  
  6737. The display file (INFOx.IDF) will display anything you want except a backward
  6738. quote (`). When this character is first encountered, Celerity will grab the
  6739. first line of data from the associated .ANW file and display it on the screen,
  6740. similar to how the asterisk (*) functioned in the 1.42 infoforms, and so on
  6741. until all of the display file has been shown.  Thus, you can create pretty ANSI
  6742. files and simply place a ` character wherever you want infoscript answer data to
  6743. be displayed.  Note that if the display file contains MORE ` characters than
  6744. there are data entries, it will NOT wrap to the next user, but will simply start
  6745. displaying the ` characters.  Because Celerity will display the whole line from
  6746. the answer file, you should probably set up your script to write the data to the
  6747. answer file without a label.
  6748.  
  6749. eg:  `IN=2<>`
  6750.  
  6751. Otherwise, you may get fields in your answer file with "Answer:32" in them.
  6752.  
  6753. Please examine some of the examples on the Celerity support board for ideas on
  6754. making information script display files.
  6755.  
  6756.  
  6757.  
  6758.   -----------------------------------------------------------------
  6759.     Celerity v2.0                                         Page 108
  6760.  
  6761.  
  6762.  
  6763.  
  6764.  
  6765.                 -= Celerity v2.0 Operations Manual =-
  6766.   -----------------------------------------------------------------
  6767.  
  6768. The Infoscript Answer File
  6769. --------------------------
  6770.  
  6771. The infoscript answer file (INFOx.ANW) contains all of the answers for all users
  6772. who have filled out the script.  It is in standard ASCII text format, so feel
  6773. free to browse it with a text editor if you like.  The entry for each user will
  6774. look like the following:
  6775.  
  6776. <*USERNAME=Extreme A.I.*>
  6777. Your Name : Blah
  6778. Your Voice # : Blah
  6779. <*EOF*>
  6780.  
  6781. The <*USERNAME=*> entry specifies the beginning of a script record, and the
  6782. <*EOF*> entry specifies the end.
  6783.  
  6784.  
  6785. Infoscript Command File
  6786. -----------------------
  6787.  
  6788. The infoscript command files (INFOx.INF) contain the commands to be executed and
  6789. questions to ask of the users.  There are four types of commands which can be
  6790. used: Input commands, file handling commands, if..then loop commands, and
  6791. general purpose commands.
  6792.  
  6793. What is a Command:    A Command is an instruction or set of instructions that
  6794. tell the script processor how to behave. They govern inputing, outputing,
  6795. displaying textfiles, beeping at the user, etc.
  6796.  
  6797. How to Use a Command:    To tell the script processor that a group of characters
  6798. is a command, it must be placed within backquotes ("`") on most keyboards this
  6799. character is to the left of your "1" key. Simply begin the command with a ` and
  6800. end it with a `. There can be NO spaces within commands EXCEPT within text
  6801. strings. (Such as answer labels, or strings to write to the answer file.)
  6802.  
  6803. When Should I Use a Command:    Whenever you wish to get input from the user,
  6804. process this input, or do any of the other functions a command can do. Remember
  6805. that there are commands to make your script respond to the answers of users in
  6806. different ways so you may make your scripts seem intelligent.
  6807.  
  6808.  
  6809.  
  6810.  
  6811.  
  6812.  
  6813.  
  6814.  
  6815.  
  6816.  
  6817.   -----------------------------------------------------------------
  6818.     Celerity v2.0                                         Page 109
  6819.  
  6820.  
  6821.  
  6822.  
  6823.  
  6824.                 -= Celerity v2.0 Operations Manual =-
  6825.   -----------------------------------------------------------------
  6826.  
  6827. Input Commands
  6828. --------------
  6829.  
  6830. How to Use Input Commands:    Simply place the input command wherever you wish
  6831. to have the user answer a question. There are several formatters that will
  6832. increase the power of the commands. To use these simple place them next to the
  6833. input command within the required backquotes (for ease of reading they have been
  6834. excluded from the command list. REMEMBER to add these!) Remember that there
  6835. can be no spaces. These formatters are listed following the commands.
  6836.  
  6837. The Input Commands:
  6838. IA   ; Input Any - Any character that can be sent over the modem will work.
  6839. IAC  ; Input Any Caps - same as above, but all text will be capitalized.
  6840. IAP  ; Input Any Proper - Same As above but the first letter of every word will
  6841. be caped, the rest lowercase.
  6842. IT   ; Input Text - Only letters will accepted.
  6843. INT  ; Input Numeric/Text - Numbers or letters ONLY.
  6844. IN   ; Input Numerical - only numbers will be accepted.
  6845. IYN  ; Input Yes/No. Gives a nifty celerity yn prompt. YES default.
  6846. IYNN ; Input Yes/No, default to NO.
  6847.  
  6848. Input Formatters:    Remember that to use these just tack them on to the end of
  6849. your input command.
  6850.  
  6851. Length Limiter:    By appending an "=XX" after a command, where XX equals the
  6852. maximum length of the input, you can restrict the length of the input. Once the
  6853. maximum length is reached, only a Return, or a backspace will be excepted.
  6854.  
  6855. Example:    To Limit an age query to 2 digits change `IN` to `IN=2`.
  6856.  
  6857. Answer File Labels:    If you do not use an answer label the answers from user
  6858. input written to the answer file will be listed as "ANSWER : Input". By using an
  6859. answer label you can tell the script processor to instead write the text you
  6860. specify before the answer. To do this Simply add set of <>'s to your command,
  6861. and specify what you want written between them (Spaces are acceptable.).
  6862.  
  6863.  
  6864. Example:    To further expand on the age input command above we can change the
  6865. command to `IN=2<Users Age>`. Now when the answer is placed in the answer file,
  6866. it will appear as
  6867.  
  6868. Users Age : 22
  6869. instead of
  6870. ANSWER : 22.
  6871.  
  6872. Preventing an Answer From Being Written:    Why would we want to do this? Well
  6873. for instance if you placed a question at the beginning of the script asking the
  6874. user if he wants to answer this script or not.  Another use would be in making
  6875.  
  6876.   -----------------------------------------------------------------
  6877.     Celerity v2.0                                         Page 110
  6878.  
  6879.  
  6880.  
  6881.  
  6882.  
  6883.                 -= Celerity v2.0 Operations Manual =-
  6884.   -----------------------------------------------------------------
  6885.  
  6886. scripts that aren't questionnaires, but instead menus and help files. You don't
  6887. want to have an answer file for this do you?  To supress the answer, simply
  6888. append a "!" as the LAST character of your command.
  6889.  
  6890.  
  6891.  
  6892.  
  6893.  
  6894.  
  6895.  
  6896.  
  6897.  
  6898.  
  6899.  
  6900.  
  6901.  
  6902.  
  6903.  
  6904.  
  6905.  
  6906.  
  6907.  
  6908.  
  6909.  
  6910.  
  6911.  
  6912.  
  6913.  
  6914.  
  6915.  
  6916.  
  6917.  
  6918.  
  6919.  
  6920.  
  6921.  
  6922.  
  6923.  
  6924.  
  6925.  
  6926.  
  6927.  
  6928.  
  6929.  
  6930.  
  6931.  
  6932.  
  6933.  
  6934.  
  6935.   -----------------------------------------------------------------
  6936.     Celerity v2.0                                         Page 111
  6937.  
  6938.  
  6939.  
  6940.  
  6941.  
  6942.                 -= Celerity v2.0 Operations Manual =-
  6943.   -----------------------------------------------------------------
  6944.  
  6945. File Handling Commands
  6946. ----------------------
  6947.  
  6948. How To Use File Handling Commands:    To use these insert them in your script
  6949. file just like any other command. Certain commands MUST be paired though to they
  6950. will not work. For example a Goto or Gosub MUST have a label to goto!
  6951.  
  6952. The File Handling Commands:
  6953. FQUIT      ; This tells the script processor the session is over. This isn't
  6954. required if the script ends at the end of the file, but if you wish to end it
  6955. before then, use this.
  6956. FWA="XX"   ; Write the comment XX to the answer file. Spaces are allowed.
  6957. LABEL<XXX> ; One of the most important commands. This works in conjunction with
  6958. the GO commands. Using these you can have the script processor jump around the
  6959. script answering questions depending on the answers of other questions. MAKE
  6960. SURE that the string in the <>'s CONTAIN NO SPACES! And make sure it matches the
  6961. string used in the GO command!
  6962. GOTO=xxxx  ; This causes the script processor to stop what its doing, go to the
  6963. label xxxx (defined as above) and start processing again. You cannot return to
  6964. where you left the main stream with a goto.
  6965. GOSUB=xxx  ; This causes the script processor the save the current position of
  6966. the script on the stack and jump to a label defined as xxx. When you are done
  6967. you simply call the return command and it continues as if nothing ever happened.
  6968. The stack will hold up to 20 GOSUB commands.
  6969. RETURN     ; This causes the Script processor to return to the position
  6970. immediately following the LAST gosub command it encountered. Each consecutive
  6971. RETURN jumps back one more gosub. (Be careful not to have more returns than you
  6972. have GOSUBS'!)
  6973.  
  6974.  
  6975.  
  6976.  
  6977.  
  6978.  
  6979.  
  6980.  
  6981.  
  6982.  
  6983.  
  6984.  
  6985.  
  6986.  
  6987.  
  6988.  
  6989.  
  6990.  
  6991.  
  6992.  
  6993.  
  6994.   -----------------------------------------------------------------
  6995.     Celerity v2.0                                         Page 112
  6996.  
  6997.  
  6998.  
  6999.  
  7000.  
  7001.                 -= Celerity v2.0 Operations Manual =-
  7002.   -----------------------------------------------------------------
  7003.  
  7004. "If...Then" Answer Handling Commands
  7005. ------------------------------------
  7006.  
  7007. What is the Purpose of the Answer Handling Commands:  The purpose of these
  7008. commands is to allow you to do various things in RESPONSE to the answers given
  7009. by the user. Perhaps display a text file, perhaps activate a gosub to another
  7010. group of questions. Its all up to you.
  7011.  
  7012. How to Use the Answer Handling Commands:  These are used like the other commands
  7013. with one exception. They hold one (or more) other commands with the same set of
  7014. backquotes. The first command is the answer handler. If the users last answer
  7015. equals the value specified then it will process the second command, which may be
  7016. another answer handler (for example : if more than 15 then if less than 20) or
  7017. or another command (gosub, input, etc).  Remember that the first backquote must
  7018. be before the answer handler and the last one must follow the final command
  7019. (which cannot be an answer handler.
  7020.  
  7021.  
  7022. The Answer Handling Commands:
  7023.  
  7024. IFY->xxx   ; If last answer was "yes" then do xxx
  7025. IFN->xxx   ; if last answer as "no" then do xxx
  7026. IFGT(xx)-> ; if last answer was numerical and greater than xx then do command
  7027. IFLT(xx)-> ; If last answer was numerical and less than xx then do command
  7028. IFNS(xx)-> ; Compare the string xx to the last answer. Not Case Sensitive.(i.e.
  7029. "hi" is the same this as "hI")
  7030. IFCS(xx)-> ; Compare the string xx to the last answer, but this time is IS case
  7031. sensitive. hi IS NOT the same thing as hI!!
  7032.  
  7033.  
  7034. Example:    Lets continue our Age example. We wanted to ask the user for his
  7035. age, and if he's 21 or older ask him if he wishes access to our adult areas. So
  7036. now lets write out our question so far.
  7037.  
  7038.     What is your age? `IN=2!`
  7039.  
  7040. Now using all the commands we have covered so far, we can expand our example to
  7041. compare the users age to our restriction of 21 and older, and if so go ask him
  7042. if he wants access.
  7043.  
  7044.     What is your age? `IN=2!` `IFGT(20)->GOSUB=ISADULT`
  7045.     Thank you for answering this script.
  7046.     `FQUIT`
  7047.     `LABEL<ISADULT>`Do you want access to our adult areas of the bbs?
  7048.     `IYN<User Wants Adult Access>`
  7049.     `RETURN`
  7050.  
  7051.  
  7052.  
  7053.   -----------------------------------------------------------------
  7054.     Celerity v2.0                                         Page 113
  7055.  
  7056.  
  7057.  
  7058.  
  7059.  
  7060.                 -= Celerity v2.0 Operations Manual =-
  7061.   -----------------------------------------------------------------
  7062.  
  7063.     What it will do now is if the users age (answers in IN=2!) is over 20 (our
  7064. requirement of 21 and up) then Gosub to the label IsAdult. If not we print a
  7065. little string saying thanks and quit this script file. If he is, we go to the
  7066. label ISADULT. Here we ask him if he wants access, and write his answer using
  7067. the answer label "User Wants Adult Access". Once he's answered, we return to
  7068. were we left off, which will display the little thank you note, and then quit
  7069. this script.
  7070.  
  7071.  
  7072.  
  7073.  
  7074.  
  7075.  
  7076.  
  7077.  
  7078.  
  7079.  
  7080.  
  7081.  
  7082.  
  7083.  
  7084.  
  7085.  
  7086.  
  7087.  
  7088.  
  7089.  
  7090.  
  7091.  
  7092.  
  7093.  
  7094.  
  7095.  
  7096.  
  7097.  
  7098.  
  7099.  
  7100.  
  7101.  
  7102.  
  7103.  
  7104.  
  7105.  
  7106.  
  7107.  
  7108.  
  7109.  
  7110.  
  7111.  
  7112.   -----------------------------------------------------------------
  7113.     Celerity v2.0                                         Page 114
  7114.  
  7115.  
  7116.  
  7117.  
  7118.  
  7119.                 -= Celerity v2.0 Operations Manual =-
  7120.   -----------------------------------------------------------------
  7121.  
  7122. General Purpose Commands
  7123. ------------------------
  7124.  
  7125. What are General Purpose Commands Used For:
  7126.  
  7127. These are used for various things such as beeping the user or sysop, or pausing
  7128. the display
  7129.  
  7130. The General Purpose Commands:
  7131. CR                       ; Prompt for a return before continuing.
  7132. DISPLAY=XX               ; display the textfile xx. All celerity @ and |
  7133. commands can be used in this file for formatting.
  7134. BEEP                     ; beep on the users side.
  7135. SYSBEEP                  ; beep on the sysops side..
  7136. DOWNLOAD<filename>       ; sends the file filename to user.
  7137. UPLOAD<filename>         ; the user uploads filename.
  7138. EXECUTE<filename+params> ; Full path and filename to a EXE, Com or BAT to
  7139. execute. EVERYTHING included within the <>'s is used so include parameters
  7140. there.
  7141. POS=XX,YY                ; Position the cursor at XX,YY
  7142. XPOS=XX                  ; Position the cursor at XX
  7143. YPOS=YY                  ; Position the cursor at YY
  7144. CLS                      ; Clear the screen
  7145.  
  7146. Example:     We will now finish up our example. We will cause the system to beep
  7147. at the user, display our rules about adult materials and wait for a return
  7148. before asking the user if he wants he wants access to our adult sections.
  7149.  
  7150.  What is your age? `IN=2!`
  7151.  `IFGT(20)->GOSUB=ISADULT`
  7152.  Thank you for answering this script.
  7153.  `FQUIT`
  7154.  `LABEL<ISADULT>` `BEEP` `BEEP` `BEEP`
  7155. `DISPLAY=C:\BBS\ADLTRULE.TXT` `CR`
  7156. Do you want access to our adult areas of the bbs?
  7157. `IYN<User Wants Access>`
  7158. `RETURN`
  7159.  
  7160. The three beep commands cause three ^G's to be sent to the user, then
  7161. C:\BBS\ADLTRULE.TXT will be shown to him and then it will wait for a return
  7162. before continuing.
  7163.  
  7164.  
  7165.  
  7166.  
  7167.  
  7168.  
  7169.  
  7170.  
  7171.   -----------------------------------------------------------------
  7172.     Celerity v2.0                                         Page 115
  7173.  
  7174.  
  7175.  
  7176.  
  7177.  
  7178.                 -= Celerity v2.0 Operations Manual =-
  7179.   -----------------------------------------------------------------
  7180.  
  7181. Example Infoscript
  7182. ------------------
  7183.  
  7184. ABOUT OUR EXAMPLE INFOSCRIPT:
  7185.  
  7186. This script asks the user for some general information, if he is a sysop,
  7187. prompts for his bbs name, and if 21 or over, asks him for access to the adult
  7188. sections of the bbs.
  7189.  
  7190. THE EXAMPLE INFOSCRIPT:
  7191.  
  7192. -------------------------------------------------------------------
  7193.  
  7194. Welcome to our BBS newuser! We will need to find out some information about you
  7195. for determination of your access level. You are free to abstain from answering
  7196. any of the following questions, but remember we can only grant access upon what
  7197. we know of you. (We can't give you access to the adult sections if we don't know
  7198. if your 21 or not!)
  7199.  
  7200. What is your age? `IN=2<Users Age>`
  7201. `IFGT(20)->GOSUB=ISADULT`
  7202. Are You A BBS Sysop?
  7203. `IYN<Is A SysOp>`
  7204. `IFY->GOSUB=ISSYSOP`
  7205. What is your Reason for calling This BBS? (5 Lines)
  7206. `FWA="Reason for Calling This BBS Is"`
  7207. #1> `IA<#1>`
  7208. #2> `IA<#2>`
  7209. #3> `IA<#3>`
  7210. #4> `IA<#4>`
  7211. #5> `IA<#5>`
  7212.  
  7213. Thank you for filling out this questionnaire.
  7214. `FQUIT`
  7215.  
  7216. `LABEL<ISSYSOP>`
  7217. Do you want us to know your BBS information? `IYN!`
  7218. `IFN->RETURN`
  7219. What is your BBS Name? `IA<BBS Name>`
  7220. What is your BBS Number `IA=<BBS Phone Number>`
  7221. `RETURN`
  7222. `LABEL<ISADULT>` `BEEP` `BEEP` `BEEP` `DISPLAY=C:\BBS\ADLTRULE.TXT`
  7223. `CR` Do you want access to our adult areas of the bbs? `IYN<User
  7224. Wants 21+ Access>`
  7225. `RETURN`
  7226.  
  7227. -------------------------------------------------------------------
  7228.  
  7229.  
  7230.   -----------------------------------------------------------------
  7231.     Celerity v2.0                                         Page 116
  7232.  
  7233.  
  7234.  
  7235.  
  7236.  
  7237.                 -= Celerity v2.0 Operations Manual =-
  7238.   -----------------------------------------------------------------
  7239.  
  7240. Additional example information scripts can be downloaded from the Celerity
  7241. Support BBS at 310-693-9405.  Many of these include full support for .IDF
  7242. display files as well.
  7243.  
  7244.  
  7245.  
  7246.  
  7247.  
  7248.  
  7249.  
  7250.  
  7251.  
  7252.  
  7253.  
  7254.  
  7255.  
  7256.  
  7257.  
  7258.  
  7259.  
  7260.  
  7261.  
  7262.  
  7263.  
  7264.  
  7265.  
  7266.  
  7267.  
  7268.  
  7269.  
  7270.  
  7271.  
  7272.  
  7273.  
  7274.  
  7275.  
  7276.  
  7277.  
  7278.  
  7279.  
  7280.  
  7281.  
  7282.  
  7283.  
  7284.  
  7285.  
  7286.  
  7287.  
  7288.  
  7289.   -----------------------------------------------------------------
  7290.     Celerity v2.0                                         Page 117
  7291.  
  7292.  
  7293.  
  7294.  
  7295.  
  7296.                 -= Celerity v2.0 Operations Manual =-
  7297.   -----------------------------------------------------------------
  7298.  
  7299. Customizing Text Files
  7300. ----------------------
  7301.  
  7302. Celerity includes opportunities for the SysOp to individualize his system by
  7303. writing his own messages, creating his own status screens, etc., that will be
  7304. displayed to users at various points in the program. These can be created with
  7305. an ANSI editor like TheDraw to use color and ANSI graphics, or done with a
  7306. standard text editor with support for CelerityText pipe codes and command
  7307. directives.  See Appendix C for a complete list of the files used by Celerity,
  7308. and what each one is used for.
  7309.  
  7310.  
  7311.  
  7312.  
  7313.  
  7314.  
  7315.  
  7316.  
  7317.  
  7318.  
  7319.  
  7320.  
  7321.  
  7322.  
  7323.  
  7324.  
  7325.  
  7326.  
  7327.  
  7328.  
  7329.  
  7330.  
  7331.  
  7332.  
  7333.  
  7334.  
  7335.  
  7336.  
  7337.  
  7338.  
  7339.  
  7340.  
  7341.  
  7342.  
  7343.  
  7344.  
  7345.  
  7346.  
  7347.  
  7348.   -----------------------------------------------------------------
  7349.     Celerity v2.0                                         Page 118
  7350.  
  7351.  
  7352.  
  7353.  
  7354.  
  7355.                 -= Celerity v2.0 Operations Manual =-
  7356.   -----------------------------------------------------------------
  7357.  
  7358. Customizing Console Commands
  7359. ----------------------------
  7360.  
  7361. How to Customize the Keyboard
  7362. -----------------------------
  7363.  
  7364. One of the new features which came with Celerity v2.02 was the ability to define
  7365. console keyboard commands externally, through the editing of a file called
  7366. SYSTEM.KBD which resides in the main BBS directory.
  7367.  
  7368. It is recommended that you use the SYSTEM.KBD which ships with Celerity BBS, and
  7369. modify it to your liking rather than build a new one from scratch.  The default
  7370. file contains some brief details on modifying the file.
  7371.  
  7372. A console key can be defined for any key which is NOT normally transmitted over
  7373. the modem without special terminal support.  This includes all Alt keys,
  7374. function keys, cursor control keys, and control or shift combinations for
  7375. function keys.  Valid keys follow:
  7376.  
  7377.  
  7378. F1,F2..F12: Function keys F1 through F12 (F11,F12 may not function)
  7379. A..Z = Letters A to Z  (Alt only)
  7380. Equ  = = (equals)      (Alt only)
  7381. Min  = - (Minus)       (Alt only)
  7382. 0..9 = Numbers 0 to 9  (Alt only)
  7383. Ins  = Insert          (Ins only)
  7384. Del  = Delete          (Del only)
  7385. Home = Home            (Home, ^Home only)
  7386. End  = End             (End, ^End only)
  7387. PgUp = Page Up         (PgUp, ^PgUp only)
  7388. PgDn = Page Down       (PgDn, ^PgDn only)
  7389. Pscr = Print Screen    (^Pscr only)
  7390. <-   = Right Arrow     (<-, ^<- only)
  7391. ->   = Left Arrow      (->, ^-> only)
  7392. Up   = Up Arrow        (Up only)
  7393. Dn   = Down Arrow      (Dn only)
  7394. Brk  = Break           (^Brk only)
  7395.  
  7396. In the SYSTEM.KBD, you can define four types of commands:
  7397.  
  7398. 1: Command keys.  These correspond to one of the 40+ console commands which are
  7399. internally supported by Celerity.  A detailed list follows.
  7400. 2: Execution keys.  These will allow you to execute a DOS shell or DOS program.
  7401. 3: Macro keys.  You can create macros to sign your name, navigate through menus,
  7402. delete a file, and more.
  7403. 4: Translation key.  You may use the translation key to assign a standard
  7404. keypress to a special 8-bit ASCII character which may not be easily typable.
  7405.  
  7406.  
  7407.   -----------------------------------------------------------------
  7408.     Celerity v2.0                                         Page 119
  7409.  
  7410.  
  7411.  
  7412.  
  7413.  
  7414.                 -= Celerity v2.0 Operations Manual =-
  7415.   -----------------------------------------------------------------
  7416.  
  7417. Full details on defining keys for the SYSTEM.KBD file are included in
  7418. the SYSTEM.KBD file itself.
  7419.  
  7420. Internally Supported Commands
  7421. -----------------------------
  7422.  
  7423. There are over 40 internally supported commands which you can define via the
  7424. SYSTEM.KBD file (see above).  Few systems will have the need to define them all. 
  7425. Included is the default key (if any) used in the standard SYSTEM.KBD file. 
  7426. Please note that if the "Secure Console" toggle is selected (see "System
  7427. Options" above), these local commands will not function.
  7428.  
  7429.  
  7430. #1 : Enter split screen chat.  This chat mode places two boxes on the screen,
  7431. one for the local user and one for the remote user.  Users can type
  7432. simultaneously, with thier keypresses appearing in thier respective boxes.  The
  7433. main drawbacks of the split screen chat is that it can be slow for low-speed
  7434. users, and it does not function with most scrollback functions in terminal
  7435. programs.  In the standard setup, F1 will enter split screen chat.
  7436.  
  7437. #2 : This enters the Alacrity smart chat.  It is undocumented.
  7438.  
  7439. #3 : Enter line chat.  The line chat is a much more conventional chat mode,
  7440. where local and remote user take turns typing to one another. The line chat
  7441. works well with scrollback.  Local keypresses and remote keypresses will appear
  7442. in different colors.  Alt-F1 will enter line chat in a standard setup.
  7443.  
  7444. #4 : Beep at the remote user for attention.  
  7445.  
  7446. #5 : Toggle sysop chat availability status.  Normally Alt-A.
  7447.  
  7448. #6 : Restrict all input from modem (user can't type anything).  Alt-I.
  7449.  
  7450. #7 : Restrict all output to modem (user can't see anything).  Alt-O.
  7451.  
  7452. #8 : Echo output to printer, if it is connected.  ^Pscr normally.
  7453.  
  7454. #9 : Echo all output to text file (node#.cap in shared dir).  Alt-E.
  7455.  
  7456. #10: Turn snoop buffer on (secondary text capture).  Alt-F.
  7457.  
  7458. #11: Lock user's time at current value for this call.  F8.
  7459.  
  7460. #12: Set user's time to 0.  Alt-F8 or Alt-K in the standard setup.
  7461.  
  7462. #13: Add 1 minute of user time.  F10 in the standard setup.
  7463.  
  7464. #14: Subtract 1 minute of user time, usually F9.
  7465.  
  7466.   -----------------------------------------------------------------
  7467.     Celerity v2.0                                         Page 120
  7468.  
  7469.  
  7470.  
  7471.  
  7472.  
  7473.                 -= Celerity v2.0 Operations Manual =-
  7474.   -----------------------------------------------------------------
  7475.  
  7476. #15: Add 10 minutes of user time.  Alt-F10 normally.
  7477.  
  7478. #16: Subtract 10 minutes of user time.  Alt-F9.
  7479.  
  7480. #17: Cycle bottom status bar.  Alt-B in standard setup.
  7481.  
  7482. #18: Show users statistics / Background editor.
  7483.  
  7484. #19: Give user 1 xfer point.  Good if you use file points.
  7485.  
  7486. #20: Subtract 1 xfer point from the online user.
  7487.  
  7488. #21: Give 10 xfer points.
  7489.  
  7490. #22: Subtract 10 xfer points.
  7491.  
  7492. #23: Raise access level by 1
  7493.  
  7494. #24: Subtract access level by one
  7495.  
  7496. #25: Raise access level by 10
  7497.  
  7498. #26: Lower access level by 10
  7499.  
  7500. #27: Raise xfer access level (unused) by 1
  7501.  
  7502. #28: Lower xfer access level (unused) by 1
  7503.  
  7504. #29: Raise xfer access level by 10
  7505.  
  7506. #30: Lower xfer access level by 10
  7507.  
  7508. #31: Toggle display of Fido kludge lines in messages.  Useful if you are setting
  7509. up a fido network, but usually not needed.  Alt-J.
  7510.  
  7511. #32: Toggle display of language entry #'s.  Very handy if you are working on
  7512. your language file.  Alt-L.
  7513.  
  7514. #33: Toggle Geek Speak feature.  This option is used for comic relief.  If
  7515. you've been up for hours & an annoying user is in a message section, hit this &
  7516. watch the fun.  Alt-G normally turns the Geek Speak on and off.
  7517.  
  7518. #34: Kick the user off the system (hang up on them - does not delete the user
  7519. permanently).  Usually F3.
  7520.  
  7521. #35: Enter the online tools,  See the section on "Online Tools" below.  Def. F5.
  7522.  
  7523.  
  7524.  
  7525.   -----------------------------------------------------------------
  7526.     Celerity v2.0                                         Page 121
  7527.  
  7528.  
  7529.  
  7530.  
  7531.  
  7532.                 -= Celerity v2.0 Operations Manual =-
  7533.   -----------------------------------------------------------------
  7534.  
  7535. #36: Grant temporary sysop access.  This is useful when a user is online and you
  7536. want to quickly make a change to a conference setup or file section or add a
  7537. file to a transfer section for the user to download, but don't want to wait for
  7538. the user to log off.  His or her normal access will be restored when he or she
  7539. logs off or begins a transfer.  This is normally achieved with the Alt-S key.  
  7540.  
  7541. #37: Reserve system for sysop.  When you hit this, the system will not reset
  7542. when the user logs off, but will halt operation and exit to DOS. Using this
  7543. command, a patient sysop can reserve the system without kicking a user off.
  7544. Celerity will make some noise when the system is free.  Normally Alt-R.
  7545.  
  7546. #38: This option will display one, two, or three help screens which show the
  7547. definitions of all defined local console commands.  If a remote user is using
  7548. the board, he or she can continue BBS usage while the help screen is being
  7549. viewed, but if a door is run, a transfer started, or the user logs off, the
  7550. screen will reset.  It is normally Alt-H.
  7551.  
  7552. #39: Drop to DOS.  This command can be used at almost any time to give you a DOS
  7553. prompt.  A user can NOT continue to use the system while you are in DOS.  Alt-D
  7554. is the standard command key. 
  7555.  
  7556. #40: Break out from Celerity and exit to DOS.  There is rarely a need to do
  7557. this, but if you wish to exit the BBS without the user logging off, you may
  7558. select this option.  In the default SYSTEM.KBD, ^Brk is used.
  7559.  
  7560. #41: Toggle screen output on/off.  This is handy if you are running the BBS in a
  7561. multitasking environment and wish to improve performance.  Users may notice some
  7562. minor display glitches when the screen output is off. 
  7563.  
  7564. #42: Scroll backwards in the local screen scrollback.  Normally Up.
  7565.  
  7566. #43: Scroll forwards in the local screen scrollback.  Normally Dn.
  7567.  
  7568. #44: Exit or enter the scrollback.  Normally -> and <-.
  7569.  
  7570. New commands may be added in future versions of Celerity.  You may define
  7571. multiple command keys for a single function (ie: -> and <- for the Scrollback
  7572. enter/exit).
  7573.  
  7574.  
  7575.  
  7576.  
  7577.  
  7578.  
  7579.  
  7580.  
  7581.  
  7582.  
  7583.  
  7584.   -----------------------------------------------------------------
  7585.     Celerity v2.0                                         Page 122
  7586.  
  7587.  
  7588.  
  7589.  
  7590.  
  7591.                 -= Celerity v2.0 Operations Manual =-
  7592.   -----------------------------------------------------------------
  7593.  
  7594. Online Tools
  7595. ------------
  7596.  
  7597. Celerity allows a sysop to define a menu of online tools which can be accessed
  7598. at the press of a (local) keypress (refer to SYSTEM.KBD key #35 above).  This
  7599. menu is completely sysop definable through  modification of the EXTERN.KBD file
  7600. which resides in the main BBS directory.
  7601.  
  7602.  
  7603. The EXTERN.KBD (or EXTERN.DAT in some versions) is defined in the following
  7604. manner:
  7605.  
  7606. Menu Title,Command Line,Parameters
  7607.  
  7608. The menu title is what appears on the Online Tools menu.  At your discretion, it
  7609. may contain a tilde (~) character preceding a letter you wish to define as a hot
  7610. key for that item.  If no tilde is defined, there will be no hot key defined for
  7611. that item.
  7612.  
  7613. The command line should specify the path/name of the program to run when
  7614. selected.  If the commandline is followed by an asterisk (*), Celerity will
  7615. change to the directory specified by Commandline before executing. Otherwise, it
  7616. will be executed from the BBS Node Directory.  Some programs require that the
  7617. current directory be selected before running. 
  7618.  
  7619. The parameters entry may be excluded if there are no command-line  parameters,
  7620. or you may enter a '?' to have Celerity ask for the parameters when it is run. 
  7621. There are also some special characters which can tell Celerity to pass certain
  7622. bits of data:  
  7623. A parameter of '%S' will pass the path and filename of the setup.dat
  7624. A parameter of '%N' will pass the current BBS node #
  7625. A parameter of '%U' will pass the current user's UserID
  7626.  
  7627. Lines beginning with a semicolon are ignored, as are blank lines.
  7628.  
  7629. Some examples, as can be found in the EXTERN.KBD file which ships with Celerity,
  7630. are as follows:
  7631.  
  7632. ; This calls Sicko's Edituser user editor, passing the user's ID.
  7633. Edit User Online,c:\celerity\util\uedit\edituser.exe,%S %U
  7634.  
  7635. ; This shells to DOS.
  7636. ~DOS Shell,c:\command.com
  7637.  
  7638. ; This also loads Sicko's Edituser editor, but for general editing.
  7639. Edit ~Users,c:\celerity\util\uedit\edituser.exe,%S
  7640.  
  7641.  
  7642.  
  7643.   -----------------------------------------------------------------
  7644.     Celerity v2.0                                         Page 123
  7645.  
  7646.  
  7647.  
  7648.  
  7649.  
  7650.                 -= Celerity v2.0 Operations Manual =-
  7651.   -----------------------------------------------------------------
  7652.  
  7653. ; Loads your favorite text editor
  7654. ~Qedit,c:\com\q.exe,?
  7655.  
  7656. ; The following will load up Sicko's CMT file management tools
  7657. File Management ~Tools,c:\celerity\util\cmt\cmt.exe,c:\celerity\util\cmt
  7658. ; This line will run DOS' edit program
  7659. DOS ~Edit,c:\dos\edit.com
  7660.  
  7661. ; This will execute PKZIP.EXE, and ask for parameters.
  7662. PkZip,c:\com\pkzip.exe,?
  7663.  
  7664. ; Use this to unzip a file, and ask for parameters
  7665. PkUnzip,c:\com\pkunzip.exe,?
  7666.  
  7667. ; Load the CelerityText editor
  7668. CelText Editor,c:\celerity\util\ledit\editlang.exe,c:\celerity\util\ledit
  7669.  
  7670. ; Run Celerity's system editor
  7671. Celerity ~Setup,celsetup.exe
  7672.  
  7673.  
  7674. EXTERN.KBD will support up to 29 external utilities.  Please note that the
  7675. default EXTERN.KBD may need some modification of pathnames to fully work with
  7676. your system, depending on where you have the various utilities installed.
  7677.  
  7678.  
  7679.  
  7680.  
  7681.  
  7682.  
  7683.  
  7684.  
  7685.  
  7686.  
  7687.  
  7688.  
  7689.  
  7690.  
  7691.  
  7692.  
  7693.  
  7694.  
  7695.  
  7696.  
  7697.  
  7698.  
  7699.  
  7700.  
  7701.  
  7702.   -----------------------------------------------------------------
  7703.     Celerity v2.0                                         Page 124
  7704.  
  7705.  
  7706.  
  7707.  
  7708.  
  7709.                 -= Celerity v2.0 Operations Manual =-
  7710.   -----------------------------------------------------------------
  7711.  
  7712. Section 5: Strategies for Running a Good Board
  7713. ==============================================
  7714.  
  7715. Introduction
  7716. ------------
  7717.  
  7718. Running a BBS is not an easy job, no matter how self-sufficient and capable the
  7719. BBS software is.  Running a high quality board which commands respect is
  7720. downright difficult.  Here are a couple of suggestions to help you run a quality
  7721. system.
  7722.  
  7723.  
  7724. Policies
  7725. --------
  7726.  
  7727. Sit down and determine the policies your board will have.  If you have concrete
  7728. policies that the users can be aware of, they will be much more cooperative and
  7729. your system will appear to be much more stable and well run.  Some policies
  7730. which you should consider:
  7731.  
  7732. Local callers
  7733. -------------
  7734.  
  7735. Local callers have often been called the bane of a quality BBS because of the
  7736. assumption that "good users will call long distance for good boards.  Local
  7737. callers will take whatever they can find". In many cases, this has been proven
  7738. to be true.  In general, users who call long distance are of a higher quality
  7739. than those who only call local systems. However, there may be high quality local
  7740. users you will miss out on if you flat out refuse all locals.
  7741.  
  7742. Different policies you may take would be:
  7743.  
  7744. a.  Acceptance of all users, local or not.
  7745. b.  Acceptance of local users providing they call out-of-state boards
  7746. c.  Acceptance of only a few local users.  Use of the LUL (Local User Lockout)
  7747. feature of Celerity will allow you to set a percentage of local users who are
  7748. allowed on the system.
  7749. d.  Flat out refusal of all locals.
  7750. e.  Acceptance of local users if they have a password found only on out-of-state
  7751. systems.
  7752.  
  7753. Decide what your policy is going to be, and stick to it.  Do not change it every
  7754. day, and let your users know when you are changing it.
  7755.  
  7756.  
  7757.  
  7758.  
  7759.  
  7760.  
  7761.   -----------------------------------------------------------------
  7762.     Celerity v2.0                                         Page 125
  7763.  
  7764.  
  7765.  
  7766.  
  7767.  
  7768.                 -= Celerity v2.0 Operations Manual =-
  7769.   -----------------------------------------------------------------
  7770.  
  7771. Slow Callers
  7772. ------------
  7773.  
  7774. Nobody can argue that 300 bps users should be permitted to have full access to
  7775. any bulletin board system, but in recent years, with the advent of high   speed
  7776. modems, these restrictions have been extended to 1200, 2400, and even 9600bps
  7777. users as well.  In general, a slow user can contribute just as much to sub-board 
  7778. activity as a high speed user can, but will not be able to transfer nearly as
  7779. much data in the transfer sections without taking up much larger amounts of
  7780. time.
  7781.  
  7782. High Speed/9600+ Only systems: In late 1989, I put up a bulletin board and
  7783. restricted it to 9600/14400bps connections only, and ran the first BBS in the
  7784. United States with this restriction as far as I know.  Many users said I was
  7785. crazy to exclude the slower users, but the BBS became quite popular with plenty
  7786. of high speed users. Today, with v.32bis modems available at rock-bottom prices,
  7787. and 28.8k modems becoming widespread, more and more systems are adopting this
  7788. policy with considerable success.
  7789.  
  7790. Some policies you might consider would include:
  7791.  
  7792.   a.  Accepting all 1200/2400 users.
  7793.   b.  Accepting only the highest quality slow users.
  7794.   c.  Accepting slow users for only a certain period of time, such as when the
  7795. board first opens.
  7796.   d.  Accepting only out-of-state slow users.
  7797.   e.  Accepting only a small percentage of slow users.
  7798.   f.  Accepting slow users if they give a donation.
  7799.   g.  Accepting slow users, but deny transfer privileges.
  7800.   h.  Turning down all slow users, regardless of qualifications.
  7801.  
  7802. Selecting your low speed policy can be difficult.  If it is too restrictive if
  7803. can hinder early development of the system.  If it is too liberal, it can make
  7804. your system far too busy to get the attention of high speed users and reduce the
  7805. amount of new programs uploaded.
  7806.  
  7807.  
  7808.  
  7809.  
  7810.  
  7811.  
  7812.  
  7813.  
  7814.  
  7815.  
  7816.  
  7817.  
  7818.  
  7819.  
  7820.   -----------------------------------------------------------------
  7821.     Celerity v2.0                                         Page 126
  7822.  
  7823.  
  7824.  
  7825.  
  7826.  
  7827.                 -= Celerity v2.0 Operations Manual =-
  7828.   -----------------------------------------------------------------
  7829.  
  7830. Access requirements
  7831. -------------------
  7832.  
  7833. Many boards will accept anyone who calls.  Others are more selective as to whom
  7834. they validate.  This policy can be a key factor in determining the quality of
  7835. your system.  Some factors many systems consider when deciding to accept or deny
  7836. a user include the following:
  7837.  
  7838. a.  Speed and location factors, as determined by the above policies.
  7839. b.  How soon does the user get new programs.  You may make a distinction between
  7840. games and utilities/applications users.
  7841. c.  Is the user willing to donate funds/hardware for the upkeep and the
  7842. improvement of the BBS?
  7843. d.  Will the user bring a certain amount of respect to the system (ie: is the
  7844. user a major figure in the BBS community?  A shareware author who will upload
  7845. new releases?)
  7846. e.  Is the user on other quality systems around the nation?
  7847. f.  Does the user have good references?
  7848. g.  Is the user mature, or will he/she engage in unwanted flame wars?
  7849.  
  7850. One highly effective way of keeping poor users off your system is to get a group
  7851. of highly selective individuals as your new user voting panel (ie: users with a
  7852. high enough level to vote), and have them determine whether or not to accept a
  7853. user.  When you have a number of users voting, the chances of some of them
  7854. knowing a user you may not know are improved greatly.
  7855.  
  7856.  
  7857. Rules of Conduct
  7858. ----------------
  7859.  
  7860. Rules of conduct are usually very important in determining the quality of a BBS. 
  7861. Do you want to allow "rag wars" on your system? They will appeal to a younger
  7862. audience, but will turn off your more mature users. Do you care if users post on
  7863. the wrong subs?  How old can a program be and still be a wanted upload?  Do you
  7864. have certain restrictions for upload content?
  7865.  
  7866. There are a number of small aspects you will want to define and usually post so
  7867. users are aware of them.  If you enforce them, your good users will abide by
  7868. them and help enforce them themselves.
  7869.  
  7870.  
  7871. Voice Validation
  7872. ----------------
  7873.  
  7874. If you are going to voice validate users, you should let them know that you may
  7875. do so. Many SysOps will ask, in an information script, whether a user will
  7876. accept a collect phone call, and the best time to call. Voice-validating is a
  7877.  
  7878.  
  7879.   -----------------------------------------------------------------
  7880.     Celerity v2.0                                         Page 127
  7881.  
  7882.  
  7883.  
  7884.  
  7885.  
  7886.                 -= Celerity v2.0 Operations Manual =-
  7887.   -----------------------------------------------------------------
  7888.  
  7889. good way to know that you have SOME accurate information about a user, and
  7890. he/she can be contacted if necessary.
  7891.  
  7892.  
  7893. Access Levels
  7894. -------------
  7895.  
  7896. Be consistent with your access granting.  Grant new users a certain level, and
  7897. upgrade their access when they prove to be good users. Be very careful when
  7898. making a coSysOp, and be sure you know that user well. Many boards have gone
  7899. down because of sabotage done by a coSysOp, and many MANY boards have had their
  7900. security compromised when a coSysOp downloaded the userlist and passwords.
  7901.  
  7902. Do not give ridiculous access levels.  Celerity supports access levels of -5 to
  7903. 100.  A negative access level will delete the user the next time they call.
  7904.  
  7905. -1  Deletes the user.
  7906. -2  Gives the user the system 2 password and deletes him.
  7907. -3  Gives the user the system 3 password and deletes him.
  7908. -4  Tells the user he was deleted under "special circumstances"
  7909. -5  Tells the user what the results of the new user voting on him were, and
  7910. deletes the user.
  7911.  
  7912. Level 100 is the SysOp level.  Do not make levels over 100.
  7913.  
  7914.  
  7915. Advertising
  7916. -----------
  7917.  
  7918. Advertising is a sticky subject.  A couple points to remember are:
  7919.  
  7920. 1:  Advertise to your proposed audience.  If you don't want any locals, don't
  7921. post ads on local boards, and advertise only on out of state systems.  The
  7922. locals who may be quality users will eventually find out by calling those other
  7923. systems.  If you don't want slow users, don't post on boards which cater to
  7924. them.  Posting only on "High Speed Only" boards is quite feasible in this day
  7925. and age.  Post only on boards which have users of the quality you would like.
  7926.  
  7927. 2:  Do not over-advertise.  Nobody will call a board which makes them sick with
  7928. too many ads.  Don't always use the same ad either, but vary the ads and use new
  7929. ones from time to time.  Users will abort any ad they recognize.
  7930.  
  7931. 3:  Never, NEVER, send mass-mail advertising your system.  Doing so will most
  7932. likely piss off the SysOp of the board you are on, and in addition, no decent
  7933. user will call a board he has gotten a mass mail invitation to.  If there are a
  7934. few users you would like, you can try sending them each a piece of individual
  7935. mail, but mass mail is sure trouble.
  7936.  
  7937.  
  7938.   -----------------------------------------------------------------
  7939.     Celerity v2.0                                         Page 128
  7940.  
  7941.  
  7942.  
  7943.  
  7944.  
  7945.                 -= Celerity v2.0 Operations Manual =-
  7946.   -----------------------------------------------------------------
  7947.  
  7948. 4:  Make a nice looking ANSI ad. There are a few ANSI specialist groups, such as
  7949. ACiD and A.A.A. who will design ads for people (like myself) who have absolutely
  7950. no ANSI talent.  Some bulletin boards require that ANSI screens be saved in a
  7951. 79-column mode rather than "unlimited length".
  7952.  
  7953. 5:  Archive commenting.  Archive COMMENTING is generally acceptible advertising,
  7954. and most boards do it.  ADDING an ad file to an archive, on the other hand, is
  7955. generally considered to be very boorish and  immature.  Nobody will call a board
  7956. who litters thier transfers with stupid ads imbedded in the archives.
  7957.  
  7958.  
  7959.  
  7960.  
  7961.  
  7962.  
  7963.  
  7964.  
  7965.  
  7966.  
  7967.  
  7968.  
  7969.  
  7970.  
  7971.  
  7972.  
  7973.  
  7974.  
  7975.  
  7976.  
  7977.  
  7978.  
  7979.  
  7980.  
  7981.  
  7982.  
  7983.  
  7984.  
  7985.  
  7986.  
  7987.  
  7988.  
  7989.  
  7990.  
  7991.  
  7992.  
  7993.  
  7994.  
  7995.  
  7996.  
  7997.   -----------------------------------------------------------------
  7998.     Celerity v2.0                                         Page 129
  7999.  
  8000.  
  8001.  
  8002.  
  8003.  
  8004.                 -= Celerity v2.0 Operations Manual =-
  8005.   -----------------------------------------------------------------
  8006.  
  8007. Appendices
  8008. ==========
  8009.  
  8010. Appendix A, Serial I/O Chips
  8011. ----------------------------
  8012.  
  8013. A very good reference book that I use is available from National Semiconductor
  8014. Corporation.  It covers most of the SIO devices (also called UARTs) that you
  8015. will find in all PCs and clones. The title of the book is Microcommunications
  8016. Elements Databook. The publication number (manual number) is 400066. I am not
  8017. sure that the book can be ordered directly from National semi-conductor. They
  8018. may require that you get it from a distributor. In any case, the address on the
  8019. back of the manual is:
  8020.  
  8021.  National Semiconductor Corporation
  8022.  2900 Semiconductor Drive
  8023.  P.O. Box 58090
  8024.  Santa Clara, CA 95052-8090
  8025.  
  8026.  Tel:(408)721-5000
  8027.  TWX:(910)339-9240
  8028.  
  8029. 8250
  8030.  
  8031. As best that I know, the 8250 was the first SIO chip (integrated circuit) that
  8032. was used by the IBM PC and many clones.  In my opinion, it was a poor choice on
  8033. the part of IBM.  I feel many superior devices, at comparable prices, were
  8034. readily available. At that time, I feel the 8251A or the 8530 would have been
  8035. better choices.  I feel IBM used the 8250 to insure the PC would not have
  8036. synchronous communications capability in  a standard configuration.
  8037.  
  8038. From a hardware standpoint the 8250 is a relatively slow device. It is advisable
  8039. that programmers not perform successive inputs or outputs to this device. It
  8040. seems that software programs can load the various registers of the 8250 faster
  8041. than it can process the information. The 8250 had a total of 7 registers. The
  8042. specifications state that 56kb is the maximum baud rate.
  8043.  
  8044. 8250A
  8045.  
  8046. I believe the 8250A is the 8250 with some bug fixes. I have no idea what the
  8047. bugs may have been.  A quick glance at the specifications shows the speed of the
  8048. 8250 and 8250A to be much the same.  The 8250A added an 8th register.  This
  8049. additional register enables software to detect if an 8250 is installed. The
  8050. specifications state that 56kb is the maximum baud rate.
  8051.  
  8052. 16450
  8053.  
  8054.  
  8055.  
  8056.   -----------------------------------------------------------------
  8057.     Celerity v2.0                                         Page 130
  8058.  
  8059.  
  8060.  
  8061.  
  8062.  
  8063.                 -= Celerity v2.0 Operations Manual =-
  8064.   -----------------------------------------------------------------
  8065.  
  8066. The 16450 seems to be a sped up version of the 8250A. There is no direct way
  8067. (that I know of) for software to detect the difference between an 8250A and a
  8068. 16450. I believe the 16450 was developed to eliminate the need for software to
  8069. insert delays between successive accesses to the device.  The specifications
  8070. indicate the 16450 is a much faster device than its predecessors. The additional
  8071. speed is only the speed at which the processor can access the device. The
  8072. maximum baud rate for the 16450 is still stated at 56kb. However, I have been
  8073. told by some people that they have run the 16450 successfully at much higher
  8074. speeds. I do not believe there was ever a 16450A.
  8075.  
  8076. 16C451
  8077.  
  8078. The 16C451 is a CMOS version of the 16450. CMOS is a term for the material and
  8079. manufacturing process used to make the part. CMOS typically uses less power than
  8080. other technologies. If you are not designing hardware, you should view the
  8081. 16C451 as a 16450.
  8082.  
  8083. 16550 Non A
  8084.  
  8085. It is hard to find a 16550 (Non A). I was told by National Semiconductor that
  8086. they did everything they could to get all 16550s back. X00 (and XU) will detect
  8087. a 16550 and tell you if you have one. I am told that the 16550 was installed in
  8088. early PS/2 systems.
  8089.  
  8090. The 16550 was the first shot at a FIFOed version of the 8250 family from
  8091. National semiconductor. However, I was told by National Semiconductor that the
  8092. FIFOs of the 16550 are not reliable and they should not be enabled. X00 will
  8093. treat a 16550 like a 16450. In this mode, they are reliable. National
  8094. Semiconductor would not provide me with a specification for the 16550. However,
  8095. I suspect its maximum baud rate is the same as the 16550A which is 256kb.
  8096.  
  8097. 16550A, 16550AF and 16550AFN
  8098.  
  8099. In the manuals that I have, National Semiconductor does not explain the
  8100. differences between the 16550A and the 16550AF. I suspect the AF part may have a
  8101. few bug fixes. I believe the N in AFN describes packaging, ceramic versus
  8102. plastic, DIP versus surface mount etc.
  8103.  
  8104. In the opinion of the author, there is no substitute for the 16550A (and its
  8105. successors) in the 8250 type series. The 16550A is compatible with software
  8106. written for the entire family of 8250 type devices. Programs that are 16550A
  8107. aware can provide much improved performance over previous devices.
  8108.  
  8109. The maximum baud rate for the 16550A is specified at 256kb. However, due to the
  8110. hardware design of the PC et al, 115kb is the maximum baud rate that can be
  8111. programmed.
  8112.  
  8113. The 16550A can be plugged into the same socket that contains an
  8114.  
  8115.   -----------------------------------------------------------------
  8116.     Celerity v2.0                                         Page 131
  8117.  
  8118.  
  8119.  
  8120.  
  8121.  
  8122.                 -= Celerity v2.0 Operations Manual =-
  8123.   -----------------------------------------------------------------
  8124.  
  8125. 8250, 8250A or 16450. If your SIO expansion board has the SIO chips in sockets,
  8126. you can upgrade to the 16550A by simply removing the old chips and replacing
  8127. them with 16550As. 
  8128.  
  8129. The key to the performance increase of the 16550A is its FIFO buffers (first-in
  8130. first-out). It has 16 byte FIFOs for both transmit and receive data.
  8131.  
  8132. 16550s Made by Western Digital
  8133.  
  8134. I have been told, but I have not verified for myself, that 16550s made by
  8135. Western Digital have a problem with their FIFOs when working at 2400 baud or
  8136. below.
  8137.  
  8138. 16C551
  8139.  
  8140. The 16C551 is a CMOS version of the 16550AF. See the above description of the
  8141. 16C451 for a discussion of CMOS. Do not feel you need to upgrade from a 16550A
  8142. or AF to a 16C551. There is no gain from an existing users point of view.
  8143.  
  8144. 16C552
  8145.  
  8146. The 16C552 is two 16C551s on a single chip. These devices will start showing up
  8147. on multi-port serial I/O cards.
  8148.  
  8149. 16C552CJ
  8150.  
  8151. Another variant of the 16C552.
  8152.  
  8153. 82510
  8154.  
  8155. I believe Intel is the only company that manufactures the 82510. The 82510 is
  8156. feature rich with several modes of operation. Its default mode is to operate as
  8157. a 16450. The 82510 has a 4 byte FIFO for both transmit and receive data. A 4
  8158. byte FIFO is sufficient to provide significant performance over a basic 16450.
  8159. The 82510 is small in size. Therefore, it is found in many lap tops.
  8160.  
  8161. The 82510 is somewhat of a sleeper. I believe it would be much more widely used
  8162. if Intel had promoted it more. However, given a choice between the 82510 and the
  8163. 16550A, I would select the 16550A.
  8164.  
  8165.  
  8166.  
  8167.  
  8168.  
  8169.  
  8170.  
  8171.  
  8172.  
  8173.  
  8174.   -----------------------------------------------------------------
  8175.     Celerity v2.0                                         Page 132
  8176.  
  8177.  
  8178.  
  8179.  
  8180.  
  8181.                 -= Celerity v2.0 Operations Manual =-
  8182.   -----------------------------------------------------------------
  8183.  
  8184. Appendix B: An Introductory Lesson in High-Speed Modems
  8185.  
  8186. A Modem Story
  8187. -------------
  8188.  
  8189. Jim, an avid bulletin board caller, wanted to upgrade from his 2400 baud modem
  8190. to a high-speed modem. He went to his computer dealer and asked for the best
  8191. 9600 baud modem, and purchased a Hayes V-series Ultra Smartmodem 96, which is
  8192. indeed one of the best on the market. Jim felt that getting the best justified
  8193. spending $800 on the modem. However, when Jim got his new modem home and set it
  8194. up, he found that all of his connections were still at 2400 baud. Many of the
  8195. sysops who ran the bulletin boards Jim called were as confused as he, but one of
  8196. them targeted the problem. While Jim's modem was an excellent V.32 modem, the
  8197. bulletin boards were using HST modems. Jim wasn't quite sure what this meant,
  8198. but returned to his computer dealer and explained the problem. His vendor made
  8199. him a fair compromise offer: for returning the Hayes and $100, he sold Jim a
  8200. U.S. Robotics Dual Standard, which, although more expensive than the Hayes
  8201. Ultra, can connect to both V.32 and HST modems at high speed. Jim was very happy
  8202. with his new modem. However, he was not so happy when he saw a V.42bis modem
  8203. priced at $49, much less than he had paid for his V.32. Jim called the sysop who
  8204. had understood his first problem and was told that this time he had no problem,
  8205. because a V.42bis modem with no other designation was a 2400 baud modem, no
  8206. faster than Jim's older 2400 baud.
  8207.  
  8208. Although the name was changed, Jim's story is true, and illustrates one of the
  8209. most common areas of confusion in today's telecommunication field. Jim faced
  8210. several sources of confusion. The designations V.32, V.42bis and HST indicate
  8211. the modem's abilities, but do not describe them to the uninitiated. Jim was also
  8212. using the word "baud" imprecisely without knowing it. If a modem buyer doesn't
  8213. understand the jargon of modem descriptions, it is easy to spend a large amount
  8214. of money and purchase a modem that doesn't function with any more efficiency
  8215. than a $79 modem from a warehouse store.
  8216.  
  8217.  
  8218. What makes two modems compatible?
  8219. ---------------------------------
  8220.  
  8221. Modems speak to other modems. In order to do so, the two modems in question must
  8222. speak the same "language", otherwise they cannot communicate. In the early days
  8223. of modems, the "language" used by the Hayes Microcomputer Products company was
  8224. taken as a standard by most modem manufacturers. For medium speed modems (1200
  8225. and 2400 bits per second, or bps), this is still the case. Most of these modems
  8226. use the Hayes "AT" command set and speak freely to one another.
  8227.  
  8228.  
  8229. When manufacturers first began making high speed modems (9600 bps and above), no
  8230. clear standard evolved. Several manufacturers developed proprietary protocols
  8231. such as HST and PEP (see below).
  8232.  
  8233.   -----------------------------------------------------------------
  8234.     Celerity v2.0                                         Page 133
  8235.  
  8236.  
  8237.  
  8238.  
  8239.  
  8240.                 -= Celerity v2.0 Operations Manual =-
  8241.   -----------------------------------------------------------------
  8242.  
  8243. Proprietary protocols are owned by the company which developed them, and thus
  8244. none of these modems could communicate with any of the other types at 9600 bps,
  8245. because none of them spoke the same "language."
  8246.  
  8247.  
  8248. CCITT and ITU: International Standards
  8249. --------------------------------------
  8250.  
  8251. The United Nations, through the Comite Consultatif International de Telegraphie
  8252. et Telephonie (originally known as the CCITT but recently changed to ITU-T), is
  8253. charged with establishing a recognized standard for high speed
  8254. telecommunication. The ITU-T, based in Geneva, has defined many
  8255. telecommunication standards, some relating to modems, others to facsimile
  8256. transmission, and still others to packet-switching and other telecommunications.
  8257. All of the ITU-T standards pertinent to modems are recognizable by their "V.nn"
  8258. designation. One thing to keep in mind as you are reading is that the "V-dot"
  8259. protocols such as V.32, V.42, and V.42bis are totally different standards,
  8260. although they are commonly confused. Additionally, there are some industry
  8261. standards (v.32ter, v.FC) which are _NOT_ ITU-T standards, yet use the v.nn
  8262. designation.
  8263.  
  8264. The -bis or -ter suffix can also cause confusion. It is easiest to  think of
  8265. -bis as meaning "second implementation" and -ter as being the "third
  8266. implementation". 
  8267.  
  8268. Baud and bps: Are they the same?
  8269. --------------------------------
  8270.  
  8271. Before beginning, you should know that "baud" does not technically refer to the
  8272. speed of a modem, but to an aspect of how the transmission occurs (more
  8273. precisely, the number of changes of state in the communication line per second).
  8274. The smallest unit of binary data (0 or 1) is called a "bit", short for BInary
  8275. digiT. A 300 baud modem utilizing a method known as frequency shift keying sends
  8276. one bit per baud and is therefore also a 300 bps modem. A 1200 bps modem is
  8277. usually a 300 baud modem using a different method in order to transmit four bits
  8278. per baud. Confused? Just forget you ever heard the word "baud" and use the
  8279. initials "bps". Another term used in modem descriptions is "duplex". This term,
  8280. when used in reference to a modem, indicates whether or not data is transmitted
  8281. out and received in simultaneously at the designated speed. Modems using full
  8282. duplex protocols can transfer data both directions simultaneously at their rated
  8283. speed. Half duplex protocols allow data to be sent in only one direction at a
  8284. time. A signal on the end of the information tells the receiving modem that it
  8285. is now free to transmit. "Asymmetrical" duplex indicates that information flows
  8286. in both directions simultaneously, but at different speeds. "Adaptive" duplex
  8287. means that the modems may transmit anything from full to half duplex, depending
  8288. on the situation. 
  8289.  
  8290.  
  8291.  
  8292.   -----------------------------------------------------------------
  8293.     Celerity v2.0                                         Page 134
  8294.  
  8295.  
  8296.  
  8297.  
  8298.  
  8299.                 -= Celerity v2.0 Operations Manual =-
  8300.   -----------------------------------------------------------------
  8301.  
  8302. Data Transmission Protocols ("Speed")
  8303. -------------------------------------
  8304.  
  8305. A data transmission protocol specifies the "modulation technique", or method
  8306. used to transfer the data. It therefore dictates the fastest speed at which
  8307. information can be transferred. Thus, data transmission protocols are often
  8308. called "speed" protocols. In addition to the rate of the character stream, data
  8309. transmission protocols define such things as methods used to limit the effect of
  8310. telephone line noise, so they are not technically just "speed" protocols.
  8311.  
  8312. The ITU-T standards are, by definition, world-wide and non-proprietary.  Bell
  8313. standard are usually only applicable in North America.  There are additional
  8314. data transmission protocols which may be either proprietary (HST, DIS, PEP, etc)
  8315. or interim (v.32 Turbo, v.32ter (v.32terbo), V.FC) which are not official
  8316. standards.
  8317.  
  8318. Proprietary high speed data transmission protocols are owned by the companies
  8319. which developed them and cannot be used by anyone else without a license. The
  8320. cardinal rule to remember about data transmission protocols is that two modems
  8321. with different high speed protocols will not be able to communicate with each
  8322. other at high speed. However, since all these modems have a standard 2400 bps
  8323. protocol as a "fall-back" protocol, these modems will be able to connect in most
  8324. cases and communicate at 2400 bps.
  8325.  
  8326.  
  8327. Bell 103
  8328.  
  8329. Old 110 and 300 baud modems manufactured in North America used the Bell 103
  8330. protocol for communications.  It uses Frequency Shift Keying (FSK) which varies
  8331. of the tone frequency to communicate data, and is the most primitive form of
  8332. communication. It is rare to find a bulletin board using a Bell 103 modem
  8333. anymore.
  8334.  
  8335. Bell 202
  8336.  
  8337. The Bell 202 protocol was a format for half-duplex, 1200bps communication.  It
  8338. was used in the popular "AppleCat" modem for Apple II computers in the early
  8339. 80's.
  8340.  
  8341. Bell 212A
  8342.  
  8343. The Bell 212A protocol specifies full-duplex 1200bps communication.  These were
  8344. the luxury-speed $600 modems of the early 80's.  It uses a method called
  8345. Differential Phase Shift Keying (DPSK) for data transmission.
  8346.  
  8347.  
  8348.  
  8349.  
  8350.  
  8351.   -----------------------------------------------------------------
  8352.     Celerity v2.0                                         Page 135
  8353.  
  8354.  
  8355.  
  8356.  
  8357.  
  8358.                 -= Celerity v2.0 Operations Manual =-
  8359.   -----------------------------------------------------------------
  8360.  
  8361. V.21
  8362.  
  8363. This is an ITU-T FSK standard for 300bps data and FAX communications. Most North
  8364. American (United States and Canada) modems do not use V.21, but rather follow
  8365. the Bell 103 standard. 
  8366.  
  8367. V.22
  8368.  
  8369. You may rarely see a reference to the ITU-T V.22 protocol. Modems using V.22 are
  8370. almost universally called "1200 baud" modems rather than V.22 modems.  This is a
  8371. 1200 bps data transmission protocol, which is compatible with the North American
  8372. Bell 212A standard (but not Bell 202).
  8373.  
  8374.  
  8375. V.22bis
  8376.  
  8377. V.22bis is the data transmission protocol recommended by the ITU-T for 2400 bps
  8378. modems.  The modulation technique used by V.22bis modems is called Quadrature
  8379. Amplitude Modulation (or QAM) which transmits four bits per baud, and these
  8380. modems typically are 600 baud modems. Four bits per baud at 600 baud is the same
  8381. as 2400 bps. These modems are usually called 2400 baud modems, which is
  8382. technically incorrect. From the consumer's standpoint, it doesn't matter if your
  8383. modem is a 600 baud modem transmitting four bits per baud, or a 2400 baud modem
  8384. transmitting one bit per baud. Both have a "speed" of 2400 bps. V.22bis is a
  8385. full duplex protocol.
  8386.  
  8387. V.23
  8388.  
  8389. This ITU-T FSK format is used in the United Kingdom for 1200bps communications
  8390. with a 75bps back channel.
  8391.  
  8392. V.32
  8393.  
  8394. ITU-T V.32 is also a data transmission protocol.  It was adopted by the CCITT
  8395. (now ITU-T) in 1988. It is a 4800 bps and 9600 bps standard employing a method
  8396. called trellis coded modulation (TCM) at 2400 baud. TCM encodes 2 or 4 bits per
  8397. baud and is a full duplex protocol.  Until the advent of V.32bis, V.32 was
  8398. considered to be the standard for high-speed modems.  However, it was introduced
  8399. only after certain proprietary transmission protocols had become well
  8400. established, and thus has shared, but not dominated the high speed data
  8401. transmission market.
  8402.  
  8403.  
  8404.  
  8405. V.32 Turbo
  8406.  
  8407. V.32 Turbo (with a "u") was an interim protocol adopted by a few companies in
  8408. 1990/1991.  This protocol extended V.32 to a connect rate of 12000bps.
  8409.  
  8410.   -----------------------------------------------------------------
  8411.     Celerity v2.0                                         Page 136
  8412.  
  8413.  
  8414.  
  8415.  
  8416.  
  8417.                 -= Celerity v2.0 Operations Manual =-
  8418.   -----------------------------------------------------------------
  8419.  
  8420.  
  8421. V.32bis
  8422.  
  8423. V.32bis is the current high speed data transmission protocol from the
  8424. ITU-T/CCITT, approved in 1991.  V.32bis extends the connection range of v.32 to
  8425. include 12000 and 14400bps in a full duplex TCM protocol, encoding 6 bits per
  8426. baud at 2400 baud. At 4800bps, V.32bis uses QAM.
  8427.  
  8428. V.32Ter
  8429.  
  8430. V.32ter (or V.32Terbo with an "e") is an interim industry standard developed by
  8431. AT&T being advanced by USRobotics, DigiCom, ATI, and other major manufacturers. 
  8432. V.32terbo boasts a 19200kbps data transmission rate, and should be able to reach
  8433. a theoretical maximum of 2400cps.  Technically, it is a version of V.32bis which
  8434. encodes 8 bits of data per baud.  It is NOT an ITU-T-recognized standard.
  8435. USRobotics extended the V.32ter in thier modems to reach a data transmission
  8436. speed of 21.6kbps.
  8437.  
  8438. V.FC
  8439.  
  8440. V.FC stands for "V.Fast Class", which is another interim industry standard
  8441. developed by Rockwell International, and being promoted by Hayes, Zoom
  8442. Technology, MicroCom, and other major manufacturers.  V.FC uses line probing
  8443. techniques to optimize the configuration of the modem to achieve maximum
  8444. throughput on the particular connection.  V.FC implementations support 14.4,
  8445. 16.8, 19.2, 21.6, 24.0, 26.6, and 28.8 kbps data transfer rates, offering
  8446. theoretical maximum throughput of 3600cps. V.FC modems are based on technology
  8447. similar to that which was be adopted by ITU-T for V.34, but V.FC is not
  8448. officially recognized by the ITU-T.
  8449.  
  8450. V.Fast
  8451.  
  8452. V.Fast is the working name for V.34.
  8453.  
  8454. V.34
  8455.  
  8456. V.34 is the latest standard approved by the ITU-T, ratified in July 1994.  V.34
  8457. supports line probing and a 28.8kbps data transfer rate, and is very similar
  8458. (but not compatible with) V.FC.  Supposedly, V.34 modems based on the Rockwell
  8459. V.34 chipset will be backwards compatible with V.FC modems.  There are already
  8460. rumors of a V.34bis which will raise the stakes to 31.2kbps.
  8461.  
  8462. HST
  8463.  
  8464. The HST (High Speed Transmission) modulation was introduced by USRobotics in
  8465. early 1987 as one of the first high speed (9600bps) modems for dial-up lines. 
  8466. Their aggressive sysop program quicky made the HST the de-facto "standard" among
  8467. bulletin boards. At this time, there was no industry standard to contend with.
  8468.  
  8469.   -----------------------------------------------------------------
  8470.     Celerity v2.0                                         Page 137
  8471.  
  8472.  
  8473.  
  8474.  
  8475.  
  8476.                 -= Celerity v2.0 Operations Manual =-
  8477.   -----------------------------------------------------------------
  8478.  
  8479. In 1988, USRobotics extended the HST protocol to support 12000/14400bps
  8480. connection rates, then in 1992 it was extended again to support 16800bps. The
  8481. HST protocol is similar to V.32 in the fact it uses a trellis coded quadrature
  8482. amplitude modulation (TCQAM) technique. It is an "asymmetrical duplex" protocol,
  8483. meaning that does not send data at the same speed in both directions, but does
  8484. have a continuous connection both ways.  The main data channel runs at high
  8485. speed (9600bps originally, but extended to 14.4k and 16.8k later) in one
  8486. direction, and 300 bps (450bps later) in the other, somewhat similar to the
  8487. ITU-T V.23 protocol.  The main TCQAM channel encodes up to 5 (7 or 8 later) bits
  8488. per baud, at 2400 baud, with one bit used as parity, for the theoretical maximum
  8489. of 9600 (later 14400, 16800) bps in one direction.  The HST protocol monitors
  8490. the data flow, and will switch the direction of the channels to allow the side
  8491. sending the most data access to the high speed channel, making it just as quick
  8492. as full duplex protocols for file transfers. 
  8493.  
  8494. The HST protocol is proprietary to U.S. Robotics (USR).  The meanings of the
  8495. initials USR and HST are often confused. All HST modems are made by USR, but USR
  8496. makes other modems which do not use the company's proprietary protocol.  For
  8497. instance, USR makes a modem which uses only their proprietary HST protocol, the
  8498. USR Courier HST.  However, they also make a high speed modem that conforms to
  8499. the ITU-T standard only, the USR Courier V.32 (later v.32bis).
  8500.  
  8501. A third, and very popular, modem marketed by USR includes both the ITU-T V.32
  8502. (later v.32bis) protocol and the proprietary HST protocol.  This modem, the USR
  8503. HST Dual Standard HST V.32, will connect at high speed to an HST only modem or
  8504. to a modem that has V.32/V.32bis only, thus the name Dual Standard. The logic
  8505. for both protocols actually exists side-by-side in the Dual Standard modems.
  8506.  
  8507. In 1992, USRobotics upgraded its HST and Dual Standard lines to include   a
  8508. 16800bps HST mode capable of a theoretical 2100cps transmission rate. The new
  8509. modems were 60% of the size of the older modems, and dubbed "v.small".  These
  8510. modems featured a field-upgradable architecture for future enhancements,
  8511. including v.32ter, v.FC, and V.34.
  8512.  
  8513. In late 1993, USRobotics upgraded their Courier V.32 and Courier HST Dual
  8514. Standard lines to support V.32Terbo, capable of a 19200bps transmission rate. 
  8515. These modems also include ASL to boost the USR-to-USR connection rate to
  8516. 21600bps.  As with the 16800 HST dual standards, these modems may be upgraded to
  8517. with future daughterboards (v.34 and V.FC).
  8518.  
  8519. In June, 1994, USRobotics expanded thier line with a dual standard modem dubbed
  8520. "v.Everything", which is compatible with all v.32, v.32bis, v.32ter, HST, and
  8521. lower speeds, plus the V.FC industry standard.  Additionally, these modems were
  8522. designed with flash RAM so that they could be upgraded to new standards via
  8523. software.  In August, 1994, USR released a preliminary upgrade to support V.34.
  8524.  
  8525.  
  8526.  
  8527.  
  8528.   -----------------------------------------------------------------
  8529.     Celerity v2.0                                         Page 138
  8530.  
  8531.  
  8532.  
  8533.  
  8534.  
  8535.                 -= Celerity v2.0 Operations Manual =-
  8536.   -----------------------------------------------------------------
  8537.  
  8538. ASL
  8539.  
  8540. The ASL (Adaptive Speed Leveling) protocol is also a USRobotics proprietary
  8541. protocol which allows USRobotics modems to dynamically adjust the data transfer
  8542. rate.  In conjunction with v.32Terbo, the USRobotics ASL technology increases
  8543. data throughput to 21600bps.
  8544.  
  8545. HST Cellular
  8546.  
  8547. The HST Cellular protocol is a proprietary USRobotics protocol  designed for
  8548. cellular data transmission.  It is quicker and more stable than MNP 10.
  8549.  
  8550. DIS
  8551.  
  8552. The DIS protocol, like the V.32, V.32bis and HST protocols, uses quadrature
  8553. amplitude modulation to achieve a data transmission rate of 9600 bps. The major
  8554. difference between DIS modems and others, however, is the method used to control
  8555. "noise", or unwanted signals on the telephone line. A "noisy" telephone line can
  8556. cause errors in data transmission or even cause loss of carrier before the
  8557. transmission is finished. The ITU-T standards call for use of echo cancellation
  8558. to filter out unwanted line noise. Echo cancellation requires a digital signal
  8559. processor, which greatly increases the cost of the modem. DIS uses a method of
  8560. improving the signal-to-noise ratio which does not require the processor. Thus,
  8561. modems using the DIS protocol are significantly less expensive than V.32,
  8562. V.32bis, or HST modems. DIS is a proprietary product of CompuCom Corporation.
  8563.  
  8564. PEP
  8565.  
  8566. The PEP (Packetized Ensemble Protocol) modulation technique, which is a
  8567. proprietary product of the Telebit Corporation, is totally dissimilar to the
  8568. protocols described above. It uses a method called dynamic adaptive quadrature
  8569. amplitude modulation (DAQAM). Effectively, it splits the phone line into 511
  8570. sections and puts a 34 baud carrier on each section. By encoding up to 4
  8571. bits per baud, PEP achieves maximum speeds of 18000 bps (uncompressed). Each
  8572. channel can be going only one direction, so full duplex operation can be had at
  8573. 9000 bps. PEP also utilizes adaptive duplex, which means that the speed over the
  8574. various channels will be determined by the data being sent. If data is being
  8575. sent in only one direction, it will transmit at 18000 bps in that direction.
  8576. However, if full duplex is needed, data will be sent at 9000 bps in both
  8577. directions. If traffic is heavier in one direction than the other, the PEP
  8578. protocol adjusts to ensure a maximum data transmission rate. Modems using the
  8579. PEP protocol are common in systems using the UNIX operating system.  PEP was
  8580. recently extended to include TPEP (turbo-PEP) which was a bit faster.
  8581.  
  8582.  
  8583.  
  8584.  
  8585.  
  8586.  
  8587.   -----------------------------------------------------------------
  8588.     Celerity v2.0                                         Page 139
  8589.  
  8590.  
  8591.  
  8592.  
  8593.  
  8594.                 -= Celerity v2.0 Operations Manual =-
  8595.   -----------------------------------------------------------------
  8596.  
  8597. ZYX
  8598.  
  8599. Zyxel corporation has added extended capabilities to their modems permitting
  8600. proprietary 16.8kbps and 19.2kbps connections when connected to other Zyxel
  8601. modems.
  8602.  
  8603. The following ITU-T protocols are for FAX data transmission.  They are only
  8604. included here because some modems are advertised as being compatible with these
  8605. protocols, and some confusion may exist.
  8606.  
  8607. V.17
  8608.  
  8609. V.17 is a 14.4kbps/12.0kbps FAX standard used by many FAX modems.
  8610.  
  8611. V.27ter
  8612.  
  8613. This is an ITU-T standard for 4800/2400bps FAX transmission.
  8614.  
  8615. V.29
  8616.  
  8617. V.29 is the ITU-T FAX standard for 9600/7200bps FAX.
  8618.  
  8619. Some newer modems support 19.2kbps FAX transmissions as well, and 28.8k FAX
  8620. transmissions are ultimately expected with V.34 modems.
  8621.  
  8622.  
  8623.  
  8624.  
  8625.  
  8626.  
  8627.  
  8628.  
  8629.  
  8630.  
  8631.  
  8632.  
  8633.  
  8634.  
  8635.  
  8636.  
  8637.  
  8638.  
  8639.  
  8640.  
  8641.  
  8642.  
  8643.  
  8644.  
  8645.  
  8646.   -----------------------------------------------------------------
  8647.     Celerity v2.0                                         Page 140
  8648.  
  8649.  
  8650.  
  8651.  
  8652.  
  8653.                 -= Celerity v2.0 Operations Manual =-
  8654.   -----------------------------------------------------------------
  8655.  
  8656. Error Correction and Data Compression Protocols
  8657. -----------------------------------------------
  8658.  
  8659. With high speed communications, connections can be much more susceptible to line
  8660. noise than older low-speed connections.  In the old days, line noise was
  8661. corrected by transfer protocols (such as Xmodem / the Christensen protocol,
  8662. etc.) during file transfers, but was ignored during all other activity, so you
  8663. would often see extraneous characters appear in messages and other parts of the
  8664. BBS.  With newer modems, various error correction protocols have been designed
  8665. which work internally with the modem, so the two modems in a connection isolate
  8666. all errors to ensure error-free data transmission. As with data transmission
  8667. protocols, there are a number of competing error control protocols as well.
  8668.  
  8669.  
  8670. MNP
  8671.  
  8672. MNP stands for "Microcom Networking Protocol", which was the first widely
  8673. accepted standard for error control after it was donated to the public domain by
  8674. Microcom, Inc.  MNP is divided into a number of "levels", which are basically
  8675. like separate standards. 
  8676.  
  8677. MNP error correction divides transmitted data into blocks and uses cyclic
  8678. redundancy checking (CRC) to detect garbled data, and re-transmits data blocks
  8679. which were not received correctly.  By dividing data up into blocks, a drop in
  8680. throughput may be observed due to the block overhead.
  8681.  
  8682. Level 1
  8683. This is a half-duplex block mode used by terminals, and is rarely used anymore.
  8684.  
  8685. Level 2
  8686. This is a full-duplex "stream mode" error correction protocol.  Level 2
  8687. throughput is approximately 84% of a no-error-control connection.
  8688.  
  8689. Level 3
  8690. Level three improves on level 2 by stripping the start and stop bits from the
  8691. data before they are sent, and re-adds them when a character has been received. 
  8692. This process increases the throughput, and offsets the penalty of level 2's
  8693. block mode.  The performance averages about 108% of that of a no-error-control
  8694. connection.
  8695.  
  8696. Level 4
  8697. Level 4 streamlines the block headers and makes the data blocks larger. 
  8698. Depending on how bad (or how long-distance) the connection is, a performance
  8699. gain of 5 to 50% over that of level 3 (usually about 5%).
  8700.  
  8701. Level 5
  8702. Level 5 is not an error correction protocol, but rather a compression protocol. 
  8703. As the data is already being divided up into blocks, MNP level 5 compresses data
  8704.  
  8705.   -----------------------------------------------------------------
  8706.     Celerity v2.0                                         Page 141
  8707.  
  8708.  
  8709.  
  8710.  
  8711.  
  8712.                 -= Celerity v2.0 Operations Manual =-
  8713.   -----------------------------------------------------------------
  8714.  
  8715. as it packs them into blocks, and decompresses them after transmission, thereby
  8716. allowing more data to be transmitted.  This sounds like a great boon for
  8717. communications, but there are some problems with it.  In file transfers, most
  8718. files have already been compressed before they are transmitted, usually so that
  8719. they can be stored in less space on a hard disk or floppy disk. This process, 
  8720. commonly called "archiving", uses one of a variety of proprietary or public
  8721. domain compression techniques. DOS files that have been compressed usually have
  8722. extensions such as .ZIP, .LZH, .ARC, .ARJ, .ZOO, or .GIF which identify the
  8723. compression technique used. If a modem tries to further compress a file with MNP
  8724. that has already been compressed by another method, it actually increases the
  8725. time needed for transmission.  For this reason, MNP level 5 should not be used
  8726. if you are going to transmit archived files.
  8727.  
  8728. V.42
  8729. V.42 is an ITU-T error correction protocol.  V.42 incorporates MNP levels 2
  8730. through 4.  V.42 uses a method known as link access protocol for modems, or
  8731. LAP-M.  It helps to ensure that transmission of data is done without error.
  8732. Unlike the data transmission protocols discussed above, V.42 does not relate to
  8733. the speed of data transmission, only to its correctness.  V.42 can decrease the
  8734. actual time for transmission at a given transmission speed.
  8735.  
  8736. This requires a little more explanation. One way of measuring the speed of data
  8737. transmission is by characters per second, or cps. Each character consists of 10
  8738. bits, thus a 2400 bps modem has a theoretical character rate of 240 cps (the
  8739. number of bits per second divided by the number of bits in a character). In
  8740. reality, this figure is closer to 235 cps, because no transmission is totally
  8741. efficient.  This rate is commonly referred to as the "throughput" because it
  8742. indicates how many characters the modem can "put through" in a given time.  The
  8743. 10 bits in each character include 8 bits of data plus a "start" bit and a "stop"
  8744. bit. The V.42 error correction protocol strips off the excess start and stop
  8745. bits and thus reduces the data load by 20%. The actual throughput increase is
  8746. less, due to protocol overhead, but is about 15% (270 cps at 2400 bps with
  8747. excess bits stripped off compared to 235 cps at 2400 bps without).
  8748.  
  8749. V.42bis
  8750. V.42bis is a data compression standard. Data compression is commonly used to
  8751. reduce the size of a file for storage or transmission. Smaller files naturally
  8752. take less time to transmit. V.42bis uses a method of compression called
  8753. Limpel-Ziv encoding, which typically can achieve as much as a 4:1 compression
  8754. ratio on an uncompressed ASCII text file, meaning four times as much data can be
  8755. sent in a given time at a given transmission rate.  With V.42bis compression, a
  8756. V.32 (9600 bps) modem can achieve an effective transfer rate of 19200 bps on
  8757. compressable data.  Unlike MNP 5, the V.42bis standard includes the ability to
  8758. "sense" pre-compressed files and disable the V.42bis compression for such files.
  8759.  
  8760. V.42 and V.42bis are commonly confused with the other V-dot protocols. Unlike
  8761. V.22, V.22bis, V.32 and V.32bis, all of which define a data transmission speed,
  8762. V.42 and V.42bis have no effect on speed, but are, respectively, error
  8763.  
  8764.   -----------------------------------------------------------------
  8765.     Celerity v2.0                                         Page 142
  8766.  
  8767.  
  8768.  
  8769.  
  8770.  
  8771.                 -= Celerity v2.0 Operations Manual =-
  8772.   -----------------------------------------------------------------
  8773.  
  8774. correction and data compression protocols. The modem Jim saw advertised for $29
  8775. was a 2400 bps modem with V.42bis data compression ability.
  8776.  
  8777.  
  8778. Other error correction and data compression protocols
  8779. -----------------------------------------------------
  8780.  
  8781. The most common non-ITU-T error correction and data compression protocols are
  8782. those developed by Microcom, Inc. These are all indicated by the letters MNP
  8783. (Microcom Network Protocol) and a number which differentiates between the
  8784. various MNP protocols. 
  8785.  
  8786. MNP levels 2-4 (error correction) and MNP level 5 (data compression) are in
  8787. widespread use and are found on most high speed modems, including those that
  8788. meet ITU-T standards.
  8789.  
  8790. The reason for this is that both the V.42 standard and the V.42bis standard
  8791. include an annex which requires that MNP levels 2-4 (for V.42) or MNP level 5
  8792. (for V.42bis) be available as "fall-back" protocols. In the case of error
  8793. correction, this ensures that if both modems are not V.42 compliant, at least
  8794. MNP level 4 error correction will be used. MNP level 4 is similar to V.42 in
  8795. that it strips the start and stop bits from each 10-bit character, thus
  8796. increasing throughput by about 15%. The MNP level 4 protocol includes MNP levels
  8797. 2 and 3, which are also error correction protocols.
  8798.  
  8799. Note that some 2400 bps modems do not have any error correction or data
  8800. compression ability. These are often referred to as "non-MNP" or "non-error
  8801. correcting" modems. When such modems are used for data transmission, software
  8802. (such as the Zmodem file transfer protocol) is used to provide error correction.
  8803. Modems which have at least MNP level 4 error correction or V.42 error correction
  8804. (which includes MNP level 4 as a fall-back protocol) can instead use a file
  8805. transfer protocol such as Ymodem-G, which is faster because it sends the data in
  8806. a stream with no software-controlled error correction.
  8807.  
  8808. MNP level 5 is the most commonly seen non-ITU-T data compression protocol, and
  8809. is included in the ITU-T V.42bis standard as a fall-back protocol. MNP level 5
  8810. differs from V.42bis in two important ways. First, while V.42bis uses a 4:1 data
  8811. compression protocol, MNP level 5 uses a method called run length encoding,
  8812. which is only a 2:1 data compression protocol. Microcom did develop a 4:1
  8813. compression protocol (MNP level 9) but that did not provide much of a challenge
  8814. to V.42bis.The second difference between V.42bis and MNP level 5 is that, while
  8815. V.42bis can "sense" previously compressed files and disable V.42bis compression,
  8816. MNP level 5 does not have this capability. Attempting to further compress an
  8817. already compressed file slows transmission.
  8818.  
  8819. Therefore, if a modem with MNP level 5 (but not V.42bis) capabilities is used
  8820. mostly for previously compressed files, as is the case with most bulletin board
  8821. file transfers, MNP level 5 should be disabled on that modem, usually by
  8822.  
  8823.   -----------------------------------------------------------------
  8824.     Celerity v2.0                                         Page 143
  8825.  
  8826.  
  8827.  
  8828.  
  8829.  
  8830.                 -= Celerity v2.0 Operations Manual =-
  8831.   -----------------------------------------------------------------
  8832.  
  8833. toggling a DIP switch or changing a software setting. If the modem is used for
  8834. uncompressed text file transfers, MNP level 5 should remain enabled.
  8835.  
  8836. MNP level 5 is often erroneously referred to as an error correction protocol.
  8837. This is partially because modems tend to be referred to by their most
  8838. sophisticated feature. Thus, an "MNP 5 modem" is considered better than an "MNP
  8839. 4 modem". In fact, this is true, because the MNP level 5 modems always include
  8840. MNP levels 2-4.  However, it is imprecise to refer to a modem as an "MNP 5 error
  8841. correcting modem". In such a modem, only MNP levels 2-4 have anything to do with
  8842. error correction, while MNP level 5 is strictly a data compression protocol. It
  8843. is more precise to describe such a modem as an "error correcting modem with MNP
  8844. level 5 compression".
  8845.  
  8846. CSP
  8847. A non ITU-T, non-Microcom error correction and data compression protocol called
  8848. CSP (Compucom Speed Protocol) is used with modems employing the DIS data
  8849. transmission protocol. These same modems offer MNP levels 2-5 as fall-back
  8850. routines for times when the DIS modem connects to a non-DIS modem (at 2400 bps,
  8851. as DIS is a proprietary protocol). CSP offers compression of up to 4:1 on
  8852. noncompressed files without apparent degradation of file transfers on
  8853. precompressed files. It is a proprietary technology of CompuCom Corporation.
  8854.  
  8855. V.25
  8856. V.25 is a standard not for transmission, but for an answer tone. Many North
  8857. American modems use the Bell answer tones.
  8858.  
  8859. V.25bis
  8860. V.25 is not a connect protocol, but rather a protocol for synchronous dialing.
  8861.  
  8862. Proprietary error correction and data compression protocols in use today include
  8863. MNP level 6 and higher and CSP.
  8864.  
  8865.  
  8866.  
  8867.  
  8868.  
  8869.  
  8870.  
  8871.  
  8872.  
  8873.  
  8874.  
  8875.  
  8876.  
  8877.  
  8878.  
  8879.  
  8880.  
  8881.  
  8882.   -----------------------------------------------------------------
  8883.     Celerity v2.0                                         Page 144
  8884.  
  8885.  
  8886.  
  8887.  
  8888.  
  8889.                 -= Celerity v2.0 Operations Manual =-
  8890.   -----------------------------------------------------------------
  8891.  
  8892. Summing Up Modems
  8893. -----------------
  8894.  
  8895. Modem protocols can dictate the data transmission characteristics such as speed
  8896. and telephone line noise reduction. Examples of this type of protocol include
  8897. V.22, V.22bis, V.32, V.32bis, HST, DIS and PEP.
  8898.  
  8899. Modem protocols can also provide error correction, at the same time increasing
  8900. throughput by about 15%. Examples of this type of protocol include V.42 and MNP
  8901. levels 2-4.
  8902.  
  8903. Finally, modem protocols can compress data that has not been previously
  8904. compressed, which shortens transmission time by decreasing file size. Examples
  8905. of this type of protocol are V.42bis and MNP level 5. The CSP protocol handles
  8906. both error correction and data compression for modems using the DIS data
  8907. transfer protocol.
  8908.  
  8909.  
  8910.  
  8911.  
  8912.  
  8913.  
  8914.  
  8915.  
  8916.  
  8917.  
  8918.  
  8919.  
  8920.  
  8921.  
  8922.  
  8923.  
  8924.  
  8925.  
  8926.  
  8927.  
  8928.  
  8929.  
  8930.  
  8931.  
  8932.  
  8933.  
  8934.  
  8935.  
  8936.  
  8937.  
  8938.  
  8939.  
  8940.  
  8941.   -----------------------------------------------------------------
  8942.     Celerity v2.0                                         Page 145
  8943.  
  8944.  
  8945.  
  8946.  
  8947.  
  8948.                 -= Celerity v2.0 Operations Manual =-
  8949.   -----------------------------------------------------------------
  8950.  
  8951. Appendix C: Index Of Files Used By Celerity BBS
  8952. ===============================================
  8953.  
  8954. The following appendix is a comprehensive list of all Celerity-related files by
  8955. directory.  There is some technical information included with some files,
  8956. including the type format for programmers.  See the SDK (Software Developers
  8957. Kit) for details on these.
  8958.  
  8959.  
  8960. Conference Directory:
  8961.  
  8962. BSE:  Message base file - contains configuration for an individual message base.
  8963. Type: MsgBaseRec.
  8964.  
  8965. XFR:  Transfer Conference file - contains information area configurations for an
  8966. entire transfer section.
  8967. Type: AreaRec.
  8968.  
  8969. CNF:  Conference file - contains information on the conference tree structure.
  8970. Type: ConferenceRec.
  8971.  
  8972. DOR:  Door area file - contains a list of doors.
  8973. Type: DoorRec.
  8974.  
  8975. BUL:  Bulletin section - contains news/bulletins.
  8976. Type: NewsRecord.
  8977.  
  8978. ART:  Art Gallery - contains lists of art files.
  8979. Type: ArtRecord.
  8980.  
  8981. LST:  BBS Listing - contains a full BBS listing.
  8982. Type: NewBBSRec.
  8983.  
  8984. VOT:  Voting booth - contains voting ballot information.
  8985. Type: VoteRec.
  8986.  
  8987. UNU:  Unused.  No type.
  8988.  
  8989. IDX:  Message index file used by message base, associated with a .BSE of the
  8990. same prefix.
  8991. Type: MsgIndexRec.
  8992.  
  8993. DAT:  Message raw data used by message base, associated with a .BSE of the same
  8994. prefix.
  8995. Untyped.
  8996.  
  8997. QSN:  Message quickscan data, associated with a .BSE of the same prefix.
  8998. Type: QscanRec.
  8999.  
  9000.   -----------------------------------------------------------------
  9001.     Celerity v2.0                                         Page 146
  9002.  
  9003.  
  9004.  
  9005.  
  9006.  
  9007.                 -= Celerity v2.0 Operations Manual =-
  9008.   -----------------------------------------------------------------
  9009.  
  9010. QSX:  Xfer area quickscan data, associated with an .XFR of the same prefix.
  9011. Type: QscanRec.
  9012.  
  9013. QSC:  Conference quickscan data, associated with a .CNF of the same prefix.
  9014. Type: QscanRec.
  9015.  
  9016. NOTE: The QscanRec format used by QSN, QSX, and QSC files changed with the
  9017. release with v2.02.  Version 2.00/2.01 QS? files should be deleted upon
  9018. upgrading.
  9019.  
  9020. CAL:  Conference Area List, associated with a .CNF of the same prefix. This file
  9021. will be displayed rather than an internal listing of the conference items if it
  9022. exits.
  9023. Type: Text.
  9024.  
  9025. XAL:  Xfer area list, associated with an .XFR of the same prefix. This will be
  9026. displayed as an area listing for the corresponding XFR file to override the
  9027. created area listing.
  9028. Type: Text.
  9029.  
  9030. XAU:  Like the XAL area list above, but for upload-only areas.
  9031. Type: ASCII/ANSI
  9032.  
  9033.  
  9034.  
  9035.  
  9036.  
  9037.  
  9038.  
  9039.  
  9040.  
  9041.  
  9042.  
  9043.  
  9044.  
  9045.  
  9046.  
  9047.  
  9048.  
  9049.  
  9050.  
  9051.  
  9052.  
  9053.  
  9054.  
  9055.  
  9056.  
  9057.  
  9058.  
  9059.   -----------------------------------------------------------------
  9060.     Celerity v2.0                                         Page 147
  9061.  
  9062.  
  9063.  
  9064.  
  9065.  
  9066.                 -= Celerity v2.0 Operations Manual =-
  9067.   -----------------------------------------------------------------
  9068.  
  9069. Multinode Directory:
  9070.  
  9071. NODELIST.NOD: A continually updated list of all nodes on the BBS.  Contains
  9072. information about where in the BBS a user is, what he is doing, and so forth.
  9073. Type: NodeIDRec.
  9074.  
  9075. SPOOL   .UP : A LIFO buffer of spooled uploads waiting for UpSpool to process
  9076. them.
  9077. Type: UploadSpoolREc.
  9078.  
  9079. CHATROOM.?  : An information file about a multinode chat session.
  9080.  
  9081. DCHT?   .?  : Direct chat data for multinode chat.
  9082.  
  9083. SCROLL  .?  : Scrollback data for individual nodes.
  9084.  
  9085. CAPTURE .?  : Text capture data for individual nodes.
  9086.  
  9087.  
  9088.  
  9089.  
  9090.  
  9091.  
  9092.  
  9093.  
  9094.  
  9095.  
  9096.  
  9097.  
  9098.  
  9099.  
  9100.  
  9101.  
  9102.  
  9103.  
  9104.  
  9105.  
  9106.  
  9107.  
  9108.  
  9109.  
  9110.  
  9111.  
  9112.  
  9113.  
  9114.  
  9115.  
  9116.  
  9117.  
  9118.   -----------------------------------------------------------------
  9119.     Celerity v2.0                                         Page 148
  9120.  
  9121.  
  9122.  
  9123.  
  9124.  
  9125.                 -= Celerity v2.0 Operations Manual =-
  9126.   -----------------------------------------------------------------
  9127.  
  9128. Electronic Mail Directory:
  9129.  
  9130. MAIL.DAT: E-Mail raw data.
  9131. Untyped.
  9132.  
  9133. MAIL.IDX: E-Mail index file.  Same format as all message base .IDX files.
  9134. Type: MsgIndexRec.
  9135.  
  9136. *   .NOT: User Notes.  These files are named based on the UserID of the user
  9137. they are intended for in the prefix.  They are text-based, but some important
  9138. actions may be taken by them by defining the first character in the line.
  9139.  
  9140. The FIRST character of each line of the .NOT file contains the command code for
  9141. the entry.  The ordinal values of valid commands are as follows:
  9142.  
  9143.           #01: Add uploaded bytes to account
  9144.           #02: Subtract uploaded bytes from account
  9145.           #03: Add file points to account
  9146.           #04: Subtract file points from account
  9147.           #05: Add commission points to account
  9148.           #06: Provide "Someone downloaded your upload" information
  9149.           #07: Receipt of a received no-carrier upload
  9150.           #08: Receipt of a file having been validated
  9151.           #09: Receipt of a file which was deleted
  9152.           #10: Receipt of a file processed by the upload spooler
  9153.  
  9154. Data for these entries is text-oriented, beginning on the second character of
  9155. each line.  Using this format, we will be able to not only allow sysops language
  9156. file flexibility with these entries, but we will also be able to give users a
  9157. more detailed description of where they are getting points (ie: validation
  9158. points) and where they are losing them (when a bad upload is deleted, etc.).
  9159. This will also provide an easy way for third party utilities to add entries to
  9160. an offline user which will be addressed when the user logs on. If you are
  9161. working on a utility and see the need for another entry, let me know and I will
  9162. add it.  Another advantage of this is improved online speed when doing certain
  9163. tasks (such as upload processing (see below for something exciting), deleting
  9164. files, doing commissions etc.) as they are now done when the user logs on. Note
  9165. that validation credit and commission credit are no longer useful.  If the first
  9166. character is NOT in the above list, the whole line will be displayed.
  9167.  
  9168. Any other files in the Electronic Mail directory are probably file attachments.
  9169.  
  9170.  
  9171.  
  9172.  
  9173.  
  9174.  
  9175.  
  9176.  
  9177.   -----------------------------------------------------------------
  9178.     Celerity v2.0                                         Page 149
  9179.  
  9180.  
  9181.  
  9182.  
  9183.  
  9184.                 -= Celerity v2.0 Operations Manual =-
  9185.   -----------------------------------------------------------------
  9186.  
  9187. Language Directory:
  9188.  
  9189. LANGFILE.DAT: This file contains the information on all of your language and
  9190. menu files.  A file must have an entry in here for Celerity to recognize it. 
  9191. This file may be edited with the EdLang.exe utility or with Greg DeCicco's
  9192. Language Editor.  
  9193. Type: LangRec. 
  9194.  
  9195. LANGUAGE.BBS: If this file exists, it will be displayed to users instead of the
  9196. internally generated list of language files.
  9197.  
  9198. MENUS.BBS: If this file exists, it will be displayed to users instead of the
  9199. internally generated list of menu files.
  9200.  
  9201. LNG:  Language file data
  9202. LNI:  Language file index
  9203. DSP:  Display file data
  9204. DSI:  Display file index
  9205.  
  9206.  
  9207.  
  9208.  
  9209.  
  9210.  
  9211.  
  9212.  
  9213.  
  9214.  
  9215.  
  9216.  
  9217.  
  9218.  
  9219.  
  9220.  
  9221.  
  9222.  
  9223.  
  9224.  
  9225.  
  9226.  
  9227.  
  9228.  
  9229.  
  9230.  
  9231.  
  9232.  
  9233.  
  9234.  
  9235.  
  9236.   -----------------------------------------------------------------
  9237.     Celerity v2.0                                         Page 150
  9238.  
  9239.  
  9240.  
  9241.  
  9242.  
  9243.                 -= Celerity v2.0 Operations Manual =-
  9244.   -----------------------------------------------------------------
  9245.  
  9246. Data Directory:
  9247.  
  9248. SYSLOG  .?  : These are the system log files for each node of your BBS.
  9249. Type: LogRec.
  9250.  
  9251. PROTOCOL.DAT: This file contains information on file download protocols. It may
  9252. be edited with Steffan Surdek's PROTEDIT.EXE utility.  When new transfer
  9253. protocols are added to your BBS, you need to add them here.
  9254. Type: ProtoRec.
  9255.  
  9256. ONELINER.DAT: This file contains all of your BBS OneLiners, as defined by the
  9257. OneLiners section within Celerity.  It may be edited with Steve Rosin's
  9258. OLEDIT.EXE utility.
  9259. Type: OneLinerRec.
  9260.  
  9261. TOPTEN  .DAT: This file contains a collection of the top ten uploaders,
  9262. downloaders, posters, callers, etc.  It is used by Celerity to create the top
  9263. user lists.
  9264. Type: TopTenRec.
  9265.  
  9266. HISTORY .DAT: This is the Celerity history file.  It keeps track of the BBS'
  9267. activity over the course of weeks, months, and years. It can be viewed from
  9268. within the Celerity statistics area.
  9269. Type: HistoryRec.
  9270.  
  9271. XFERLIST.*  : The XFERLIST.UPL and XFERLIST.DNL are files which contain a log of
  9272. the most recent 500 uploads or downloads from the system.  These may be viewed
  9273. from the Statistics area within Celerity.
  9274. Type: XferListRec.
  9275.  
  9276. CALLER  .LOG: This file contains a list of the most recent 500 callers to the
  9277. BBS.  It can be viewed from the Statistics area within Celerity.
  9278. Type: CallerLogRec.
  9279.  
  9280. MODEM   .LOG: This file (disabled in release versions) contains copies of the
  9281. answer string detected from the modem.  It is used for debugging, and should be
  9282. deleted if you have one.
  9283. Type: Text.
  9284.  
  9285. ERROR   .LOG: This file contains a list of errors that the BBS has encountered.
  9286. It will be viewed when a sysop logs in.  It may be deleted without any
  9287. repercussions on system operation.
  9288. Type: Text.
  9289.  
  9290. AUTO    .MSG: This file can be created or uploaded by a user in the Auto Message
  9291. section of the BBS.  It will be automatically displayed to all users when they
  9292. log in (provided that Auto Message is included in your login sequence).  It may
  9293. be edited outside the BBS.  Type: Text.
  9294.  
  9295.   -----------------------------------------------------------------
  9296.     Celerity v2.0                                         Page 151
  9297.  
  9298.  
  9299.  
  9300.  
  9301.  
  9302.                 -= Celerity v2.0 Operations Manual =-
  9303.   -----------------------------------------------------------------
  9304.  
  9305. DELETE  .ADS: This file can contain a list of BBS ads you wish to remove from
  9306. uploads via the "clean upload" option in Celsetup. 
  9307. Type: Text.
  9308.  
  9309. SECURITY.DAT: If this file exists, it should contain directories which the sysop
  9310. wishes to prevent cosysops from accessing.  For example, if the sysop wishes to
  9311. keep cosysops from accessing files in his source code programming directory, he
  9312. could add the line:
  9313.  
  9314. c:\bp\celerity\20src\
  9315.  
  9316. to the SECURITY.DAT file and the cosysop would not be able to access files in
  9317. it.  Adding a "+" (plus) as the last character will include all subdirectories
  9318. in the restriction (ie: c:\bp\+ would keep cosysops out of C:\bp and all of its
  9319. subdirectories).
  9320.  
  9321. SECURITY.DAT should be used on systems with cosysops where parts of the
  9322. accessible drive space are not related to the BBS.
  9323.  
  9324. DIR:  Transfer area file information.  .DIR files contain nearly all of the
  9325. pertinent information about files available in your transfer sections. Each
  9326. individual transfer area has its own .DIR file.
  9327. Type: FileRec;
  9328.  
  9329. DES:  Transfer area descriptions, associated with a .DIR of the same name.
  9330. Type: Untyped.
  9331.  
  9332. BCK:  A file with a .BCK extension is a file area "backup" file. Old offline
  9333. files may be moved to backup directories to retain the information on them, but
  9334. not have them listed in your file areas.
  9335. Type: FileRec.
  9336.  
  9337. BDS:  Description file associated with .BCK files.
  9338. Type: Untyped.
  9339.  
  9340.  
  9341.  
  9342.  
  9343.  
  9344.  
  9345.  
  9346.  
  9347.  
  9348.  
  9349.  
  9350.  
  9351.  
  9352.  
  9353.  
  9354.   -----------------------------------------------------------------
  9355.     Celerity v2.0                                         Page 152
  9356.  
  9357.  
  9358.  
  9359.  
  9360.  
  9361.                 -= Celerity v2.0 Operations Manual =-
  9362.   -----------------------------------------------------------------
  9363.  
  9364. Node Directory:
  9365.  
  9366. SETUPCOL.CFG: This file contains the color choice preferences for the Celsetup
  9367. utility.  If you wish to return to the default color choices, you may delete
  9368. this file.
  9369.  
  9370. MODEMLST.DAT: This contains a list of all the modems directly supported by
  9371. Celerity BBS and listed in CELSETUP.  Additional modems may be added through
  9372. CELSETUP or by directly modifying this file.
  9373. Type: Text.
  9374.  
  9375. SETUP   .DAT: The Celerity setup data as defined by CELSETUP.EXE.
  9376. Type: SetupRec.
  9377.  
  9378. KAU     .DAT: This is a special memory dump of Celerity variables which is made
  9379. when a door is opened, and re-read back into memory when the door closes.
  9380.  
  9381. DORINFO1.DEF: This is an RBBS-type door drop file.  It is created whenever a
  9382. door is opened.
  9383. Type: Text.
  9384.  
  9385. DOOR    .SYS: This is an industry standard door drop file.  It is created
  9386. whenever a door is opened.
  9387.  
  9388. CHAIN   .TXT: This is a WWIV-type door drop file.  It is created whenever a door
  9389. is opened.
  9390. Type: Text.
  9391.  
  9392. MSGTMP  .   : This file is an editor drop file.  It is temporarily used by
  9393. Celerity when users write messages.
  9394. Type: Text.
  9395.  
  9396. FILE    .LST: This file is a file listing drop file.  It is temporarily used
  9397. when used do an archive listing of a file.
  9398. Type: Text.
  9399.  
  9400. CALLER  .LST: This file contains information about the last caller to connect to
  9401. the BBS.  It is text-based, with every entry being on a separate line. The
  9402. format follows:
  9403.  
  9404.               User Name
  9405.               User ID
  9406.               BBS Node
  9407.               Connect Rate
  9408.               Date of call
  9409.               Time of call
  9410.               Connect Result
  9411.  
  9412.  
  9413.   -----------------------------------------------------------------
  9414.     Celerity v2.0                                         Page 153
  9415.  
  9416.  
  9417.  
  9418.  
  9419.  
  9420.                 -= Celerity v2.0 Operations Manual =-
  9421.   -----------------------------------------------------------------
  9422.  
  9423. The connect result is the true connect string from the modem.  This can be used
  9424. by caller id utilities or something or for generating statistics or whatever.
  9425. Type: Text.
  9426.  
  9427. CELERITY.EXE: This is the main executable for Celerity BBS.
  9428.  
  9429. CELERITY.OVR: This is a required overlay file for Celerity BBS. The use of an
  9430. overlay permits Celerity to run in less conventional memory than would otherwise
  9431. be required.
  9432.  
  9433. CELERITY.KEY: This is your registration key for Celerity BBS.
  9434.  
  9435. MAIN    .BAT: This is the main batch file used to operate Celerity BBS.
  9436.  
  9437.  
  9438.  
  9439.  
  9440.  
  9441.  
  9442.  
  9443.  
  9444.  
  9445.  
  9446.  
  9447.  
  9448.  
  9449.  
  9450.  
  9451.  
  9452.  
  9453.  
  9454.  
  9455.  
  9456.  
  9457.  
  9458.  
  9459.  
  9460.  
  9461.  
  9462.  
  9463.  
  9464.  
  9465.  
  9466.  
  9467.  
  9468.  
  9469.  
  9470.  
  9471.  
  9472.   -----------------------------------------------------------------
  9473.     Celerity v2.0                                         Page 154
  9474.  
  9475.  
  9476.  
  9477.  
  9478.  
  9479.                 -= Celerity v2.0 Operations Manual =-
  9480.   -----------------------------------------------------------------
  9481.  
  9482. Main BBS Directory:
  9483.  
  9484. STATUS  .DAT: This file contains information about how long the BBS has been
  9485. running, how many calls it has received, and so forth.
  9486. Type: SystemCallsRec.
  9487.  
  9488. SYSTEM  .KBD: This file defines which keys do what on the system console.  It
  9489. was introduced with version 2.02, and is discussed in detail in the section
  9490. above on "Customizing Console Commands" above.
  9491.  
  9492. COMMENT .ASC: When using the internal upload processor, the contents of this
  9493. file can be added as a ZIP/ARJ/LHA archive comment.
  9494. Type: Text.
  9495.  
  9496. USERS   .   : This file contains all the information about your BBS' user base.
  9497. It should be backed up often to ensure that you do not lose this data.
  9498. Type: UserRec.
  9499.  
  9500. EXTERN  .KBD: (or EXTERN.DAT in versions prior to v2.02)  This file  defines the
  9501. external utilities accessible from the Online Tools menu from within Celerity
  9502. BBS.  See the EXTERN.DAT included with the demo for details on its
  9503. configuration, as well as the section on "Online Tools" above.
  9504. Type: Text.
  9505.  
  9506. COMMENT .BAT: This batch file can be executed on an upload if the "process
  9507. uploads" check box is marked in CelSetup.  It is usually used in cases where
  9508. sysops wish to use TranScan or ZipLab instead of the internal archive
  9509. processing.
  9510.  
  9511. DIZCLEAN.EXE: This is a Celerity utility which will attempt to "clean" a file
  9512. description (file_id.diz, file_id.clr, desc.sdi) of extraneous fluff. See the
  9513. separate documentation supplied with this utility for details.
  9514.  
  9515. LOGSHELL.EXE: This file is an external shell for Celerity BBS.  No external
  9516. shells currently exist, but if they did, this would be their name.
  9517.  
  9518. REMOTE  .EXE: This is a utility included with Celerity BBS which will allow a
  9519. remote sysop to "drop to DOS" on the BBS.  See the separate documentation for
  9520. this utility for details.
  9521.  
  9522. ???_DOCS.ZIP: This file is named with the first three letters of the BBS'
  9523. acronym, as defined in CelSetup.  If this file exists, new users will be asked
  9524. if they wish to download it when they apply for access.  It may contain
  9525. important access information, registration forms, and so forth.
  9526.  
  9527.  
  9528.  
  9529.  
  9530.  
  9531.   -----------------------------------------------------------------
  9532.     Celerity v2.0                                         Page 155
  9533.  
  9534.  
  9535.  
  9536.  
  9537.  
  9538.                 -= Celerity v2.0 Operations Manual =-
  9539.   -----------------------------------------------------------------
  9540.  
  9541. Display Directory:
  9542.  
  9543. INF:  INF files are information script scripts.  See the section on information
  9544. scripts for full details.
  9545. Type: Text.
  9546.  
  9547. IDF:  Information script display files.  These are used to format information
  9548. script data when a user views it.  See the information script section.
  9549. Type: Text/ANSI.
  9550.  
  9551. ANW:  Information script answer file.  This contains the actual answers given by
  9552. users in their information scripts.  See the information script section for full
  9553. details.
  9554. Type: Text.
  9555.  
  9556. QUOTE   .FMT: This file allows you to customize the text inserted into a message
  9557. around a quote.  It consists of three lines, a header, line, and a trailer.
  9558.  
  9559. The header line will be inserted into the quoted text at the beginning. The
  9560. "line" line will be inserted at the beginning of each line of quoted text.  The
  9561. trailer line will be inserted at the end of the block of text.  With version
  9562. 2.01+, a "%1" may be placed in the first line to refer to the poster's name, and
  9563. a "%2" may be placed in the second line for his initials.
  9564.  
  9565.       Example QUOTE.FMT:
  9566.       |1Quote from a previous message by %1
  9567.       |2>%2>|3
  9568.       |1That's it!|4
  9569.  
  9570.       This would make a quote of the above:
  9571.  
  9572.       |1Quote from a previous message by Bob Brown
  9573.       |2>BB>|3The header line will be inserted...
  9574.       |2>BB>|3The "line" line will be inserted...
  9575.       |2>BB>|3quoted text.  The trailer line...
  9576.       |1That's it!|4
  9577.  
  9578. Type: Text.
  9579.  
  9580. RIPINTRO.RIP: This file will be displayed upon verification of a RIP terminal
  9581. being used by the caller.
  9582. Type: RIP.
  9583.  
  9584. PAUSE   .NAP: This file can be used to pause at the end of a NAPLPS graphic
  9585. page.
  9586. Type: NAPLPS.
  9587.  
  9588. NODESC  .BBS: When using Celerity's internal upload processing, if
  9589.  
  9590.   -----------------------------------------------------------------
  9591.     Celerity v2.0                                         Page 156
  9592.  
  9593.  
  9594.  
  9595.  
  9596.  
  9597.                 -= Celerity v2.0 Operations Manual =-
  9598.   -----------------------------------------------------------------
  9599.  
  9600. a file is found which does not have a file_id.diz description, or a description
  9601. is not entered by the user, this alternate description will be imported.  It
  9602. should say "No Description" or "Uploader Please Describe" or something to that
  9603. effect.
  9604.  
  9605. SYSOP   .LST: This is an optional list of feedback recipients displayed when a
  9606. user attempts to send feedback.  It can be used to direct users to send their
  9607. feedback to certain sysops.
  9608. Type: Text.
  9609.  
  9610. PROT?   .BBS: These are alternate protocol display files, the ? being replaced
  9611. with the protocol class #.  They will be displayed instead of the conventional
  9612. protocol list if the file exists.
  9613. Type: Text.
  9614.  
  9615. DONATION.   : No extension.  This file is displayed when the user types the "$"
  9616. command from the main menu.  Usually contains the BBS' donation policy.
  9617.  
  9618. GOODBYE .   : No extension.  This is displayed to all users upon logging off the
  9619. system.  Often contains a list of other BBS' supported by your system.
  9620.  
  9621. NEWUSER .   : When new users log on, this file will be displayed. It usually
  9622. will tell a bit about the system and access requirements.
  9623.  
  9624. NEWUSER .BYE: If the system is set up to hang up on new users (see the option in
  9625. new user options of Celsetup), this file will be displayed before the system
  9626. hangs up.
  9627.  
  9628. NICETRY  .  : A message displayed to users who fail to enter their password an
  9629. three times.  It usually contains a message to the effect of "If you were a new
  9630. user, you aren't wanted here.  If you're a hacker, get lost."  Not that a nasty
  9631. message will stop a hacker.
  9632.  
  9633. SUMMON  .   : No extension.  This text is displayed to the SysOp when the chat
  9634. call is activated.  Something short is sufficient. PRESHELL.BBS: A file which is
  9635. displayed before the shell is entered.
  9636.  
  9637. CAEINTRO.BBS: Text to be displayed when a caller connects to a CAE.
  9638.  
  9639. FEEDBACK.BBS: Message a new user gets indicating them to leave feedback to the
  9640. SysOp after applying for access.
  9641.  
  9642. PRELOGON.BBS : A "system identification" message displayed before a caller
  9643. enters his or her user name and password.  This is displayed after the first
  9644. system is entered from the shell if a shell is used, or immediately if a shell
  9645. is not used.
  9646.  
  9647. CHANGES .BBS : Quick "news brief" displayed AFTER PRELOGON.BBS, and
  9648.  
  9649.   -----------------------------------------------------------------
  9650.     Celerity v2.0                                         Page 157
  9651.  
  9652.  
  9653.  
  9654.  
  9655.  
  9656.                 -= Celerity v2.0 Operations Manual =-
  9657.   -----------------------------------------------------------------
  9658.  
  9659. before the user enters his/her handle/password etc.  This should not be more
  9660. than one line, and may be omitted altogether if there is no special news
  9661. (appropriate news would be "Please fill out the first infoform. Skip the rest.". 
  9662. Inappropriate news would be "Hard disk crash. Userlist lost.  Log on new."
  9663. (Because of Celerity's Auto-backup feature (see "Auto-Backup" above), there is
  9664. NEVER any excuse for loosing a userlist.))
  9665.  
  9666. AD      .BBS : Displayed when a user hits "&" from the main menu. It can be an
  9667. ad for the software, or changed to something more appropriate for your system.
  9668.  
  9669. BLACKLST.BBS : Displayed to a user who attempts to apply and has his name in the
  9670. blacklist file.
  9671.  
  9672. Blacklst.    : This file has no extension.  It contains a list of handles which
  9673. you do not want admitted to your system.  If a user is listed here, they will be
  9674. displayed the Blacklst.BBS (see above) file when they log on new.
  9675.  
  9676. SYSOP   .LST:  Displayed to a user leaving feedback.  This should list the
  9677. various SysOps and who is responsible for what.  If this file does not exist, a
  9678. list of all users with SysOp flag #8 set is printed.
  9679.  
  9680. Shell   .?  :  These are alternate "menus" displayed in the logon shell when
  9681. users request help.  Shell.1 replaces the menu shell's help, Shell.2 is
  9682. displayed when a user types "dir" in the DOS shell, Shell.3 is displayed in the
  9683. VMS shell, and so on.
  9684.  
  9685. *All news and bulletin files should also be in this directory.
  9686.  
  9687.  
  9688.  
  9689.  
  9690.  
  9691.  
  9692.  
  9693.  
  9694.  
  9695.  
  9696.  
  9697.  
  9698.  
  9699.  
  9700.  
  9701.  
  9702.  
  9703.  
  9704.  
  9705.  
  9706.  
  9707.  
  9708.   -----------------------------------------------------------------
  9709.     Celerity v2.0                                         Page 158
  9710.  
  9711.  
  9712.  
  9713.  
  9714.  
  9715.                 -= Celerity v2.0 Operations Manual =-
  9716.   -----------------------------------------------------------------
  9717.  
  9718. Appendix D: References
  9719. ----------------------
  9720.  
  9721. The following references may be valuable in your efforts to set up and run a
  9722. successful BBS:
  9723.  
  9724.  
  9725. Artisoft (LanTastic local area network software)
  9726. 602-293-6363 Voice
  9727. 602-293-0065 BBS
  9728.  
  9729. ATI Technologies (internal and external modems)
  9730. 416-756-0718 Voice
  9731. 416-756-0711 Technical Support
  9732. 416-756-4591 BBS
  9733.  
  9734. Boca Research (internal and external modems, intelligent and non-intelligent i/o
  9735. boards)
  9736. 407-997-6227 Voice
  9737. 407-241-8088 Technical Support
  9738. 407-241-1601 BBS
  9739.  
  9740. Digiboard (intelligent and non-intelligent i/o solutions)
  9741. 612-943-9020 Voice
  9742. 800-344-4273 Voice
  9743. 612-943-0812 BBS
  9744.  
  9745. DigiCom Systems (internal and external DSP-based modems)
  9746. 408-262-1277 Voice
  9747. 800-833-8900 Voice
  9748. 800-833-8900 Technical Support
  9749.  
  9750. Hayes Microcomputer Products (internal and external modems, ISDN adapters)
  9751. 404-840-9200 Voice
  9752. 404-441-1617 Technical Support
  9753. 800-874-2937 BBS
  9754.  
  9755. IBM Corporation (OS/2 Operating System, PC-DOS Operating System)
  9756.  
  9757. Intel (internal and external modems)
  9758. 503-629-7354 Voice
  9759. 800-538-3373 Voice
  9760. 503-629-7000 Technical Support
  9761. 503-645-6275 BBS
  9762.  
  9763.  
  9764.  
  9765.  
  9766.  
  9767.   -----------------------------------------------------------------
  9768.     Celerity v2.0                                         Page 159
  9769.  
  9770.  
  9771.  
  9772.  
  9773.  
  9774.                 -= Celerity v2.0 Operations Manual =-
  9775.   -----------------------------------------------------------------
  9776.  
  9777. Microcom (internal and external modems)
  9778. 617-551-1000 Voice
  9779. 800-822-8224 Voice
  9780. 617-762-5134 BBS
  9781.  
  9782. Microsoft Corp. (Windows, Windows for Workgroups operating environments, Windows
  9783. NT, Windows 4.0 "Chicago" operating systems)
  9784. 206-882-8080 Voice
  9785. 800-227-4679 Voice
  9786. 206-454-2030 Technical Support
  9787. 206-936-6735 BBS
  9788.  
  9789. Novell Inc. (Netware 3.1x, Netware 4.x, Netware Lite, Personal Netware local
  9790. area networking software, UNIXWare operating system)
  9791. 801-429-7000 Voice
  9792. 800-453-1267 Voice
  9793. 800-221-6402 Technical Support
  9794. 801-429-3030 BBS
  9795.  
  9796. Practical Peripherals (internal and external modems)
  9797. 805-497-4774 Voice
  9798. 800-442-4774 Voice
  9799. 805-496-7707 Technical Support
  9800. 805-496-4445 BBS
  9801.  
  9802. Quarterdeck Office Systems (QEMM memory management software, DesqView,
  9803. DesqView/X multitasking environments)
  9804. 310-392-9851 Voice
  9805. 310-392-9701 Technical Support
  9806. 310-341-3227 BBS
  9807.  
  9808. Supra Corp (internal and external modems)
  9809. 503-967-2410 Voice
  9810. 800-727-8772 Voice
  9811. 503-967-2440 Technical Support
  9812. 503-967-2444 BBS
  9813.  
  9814. Telebit (internal and external modems)
  9815. 408-734-4333 Voice
  9816. 800-835-3248 Voice
  9817. 800-835-3248 Technical Support
  9818. 408-745-3803 BBS
  9819.  
  9820. U.S. Robotics Inc. (internal and external modems)
  9821. 708-982-5001 Voice
  9822. 800-342-5877 Voice
  9823. 800-982-5151 Technical Support
  9824. 708-982-5274 BBS
  9825.  
  9826.   -----------------------------------------------------------------
  9827.     Celerity v2.0                                         Page 160
  9828.  
  9829.  
  9830.  
  9831.  
  9832.  
  9833.                 -= Celerity v2.0 Operations Manual =-
  9834.   -----------------------------------------------------------------
  9835.  
  9836. Zoom Telephonics (internal and external modems)
  9837. 617-423-1072 Voice
  9838. 800-666-6191 Voice
  9839. 617-423-1076 Technical Support
  9840. 617-451-5284 BBS
  9841.  
  9842. Zyxel USA (internal and external modems)
  9843. 714-693-0808 Voice
  9844. 800-255-4101 Voice
  9845. 714-693-0762 BBS
  9846.  
  9847.  
  9848.  
  9849.  
  9850.  
  9851.  
  9852.  
  9853.  
  9854.  
  9855.  
  9856.  
  9857.  
  9858.  
  9859.  
  9860.  
  9861.  
  9862.  
  9863.  
  9864.  
  9865.  
  9866.  
  9867.  
  9868.  
  9869.  
  9870.  
  9871.  
  9872.  
  9873.  
  9874.  
  9875.  
  9876.  
  9877.  
  9878.  
  9879.  
  9880.  
  9881.  
  9882.  
  9883.  
  9884.  
  9885.   -----------------------------------------------------------------
  9886.     Celerity v2.0                                         Page 161
  9887.  
  9888.  
  9889.  
  9890.  
  9891.  
  9892.                 -= Celerity v2.0 Operations Manual =-
  9893.   -----------------------------------------------------------------
  9894.  
  9895. Trademark Information
  9896. =====================
  9897.  
  9898. "DesqView" and "DesqView-X" are trademarks of Quarterdeck Office Systems.
  9899.  
  9900. "OS/2", "IBM PC", "IBM XT", "IBM AT" are trademarks of IBM Corp. 
  9901.  
  9902. "Pentium" is a trademark of Intel corp.
  9903.  
  9904. "Dynamic Impedance Stabilization", "DIS", "CompuCom Speed Protocol", and "CSP"
  9905. are trademarks of CompuCom Corporation.
  9906.  
  9907. "Hayes V-series" is a registered trademark of Hayes Microcomputer Products, Inc.
  9908.  
  9909. "ULTRA Smartmodem 9600", "Ultra" and "Smartmodem" are trademarks of Hayes
  9910. Microcomputer Products, Inc.
  9911.  
  9912. "Microcom Networking Protocol" and "MNP" are registered trademarks of Microcom,
  9913. Inc.
  9914.  
  9915. "Netware", "Netware Lite", and "Personal Netware" are trademarks of Novell Inc.
  9916.  
  9917. "UNIX" is a registered trademark of American Telephone & Telegraph and/or Novell
  9918. Inc.
  9919.  
  9920. "MS-DOS" is a registered trademark of Microsoft Corporation. "PEP" and
  9921. "Packetized Ensemble Protocol" are trademarks of Telebit Corporation.
  9922.  
  9923. "USRobotics" is a registered trademark of U.S. Robotics, Inc.
  9924.  
  9925. "Courier", "HST", and "Dual Standard" are trademarks of U.S. Robotics, Inc.
  9926.  
  9927.  
  9928. There are probably a number of other trademarks used in this documentation as
  9929. well.
  9930.  
  9931.  
  9932.  
  9933.  
  9934.  
  9935.  
  9936.  
  9937.  
  9938.  
  9939.  
  9940.  
  9941.  
  9942.  
  9943.  
  9944.   -----------------------------------------------------------------
  9945.     Celerity v2.0                                         Page 162
  9946.  
  9947.  
  9948.  
  9949.  
  9950.  
  9951.                 -= Celerity v2.0 Operations Manual =-
  9952.   -----------------------------------------------------------------
  9953.  
  9954. Credits and Acknowledgements
  9955. ============================
  9956.  
  9957. Celerity v2.02 manual written, adapted, and edited by Brendon Woirhaye.
  9958.  
  9959. Celerity v2.00 manual edited and written by Brendon Woirhaye and Pat "The
  9960. Silicon Sailor" McCarthy (Sysop of The Haltsys BBS and The Next Generation BBS).
  9961.  
  9962. Celerity 1.42 documentation (source for 2.00 documentation) revised, edited and
  9963. rewritten by "Wizard" and Kathy "Rogue" W., SysOps of The Underdark BBS.
  9964.  
  9965. CAE and CAE/TAC Mode: Written by Matthew "Holy Ward" E., SysOp of MidPoint Void
  9966. CAE/TAC.
  9967.  
  9968. An Introductory Lesson in High-Speed Modems: written by Nancy Hattaway, Sysop of
  9969. Sempervirens BBS.
  9970.  
  9971. The Infoscript processor and documentation was written by Robert Enquist
  9972. (Adapted to Celerity by Brendon Woirhaye).
  9973.  
  9974. Special thanks and recognition is given to the following developers of
  9975. third-party utilities for Celerity v2.0:
  9976.  
  9977. Greg Decicco: Celerity Management Tools (Xtree for Celerity), Celerity Language
  9978. Editor (for editing CelerityText files), Celerity User Editor, Celerity Mail
  9979. Reader, various statistical utilities.
  9980.  
  9981. Steve Rosin: Total Packer (Celerity data optimized), various editors, various
  9982. conversion utilities, last callers utility.
  9983.  
  9984. Robert Enquist: CFiler, recent callers list utility, top downloads list utility,
  9985. information scripting system.
  9986.  
  9987. Adrian Kwong: Celerity<-->TICK processor (file transfers over a fido network),
  9988. Canadian Celerity Support, Guest Account Maintenance utility.
  9989.  
  9990. David Hicks: CELSETUP Celerity Setup utility.
  9991.  
  9992. Ted Spaulding: CelToscn: Celerity<-->FIDO Bridge.
  9993.  
  9994. Steffan Surdek: FAE (file management utility), Celerity Protocol Editor. 
  9995.  
  9996. Robert Carrico: Celerity Multinode Chat.
  9997.  
  9998. InterMail Sales Inc: InterToss FIDO Tosser/Scanner with Celerity BBS support.
  9999.  
  10000. Additional thanks to Deanna Pugeot of Practical Peripherals for her
  10001. extensive work in developing optimum communications setups for
  10002.  
  10003.   -----------------------------------------------------------------
  10004.     Celerity v2.0                                         Page 163
  10005.  
  10006.  
  10007.  
  10008.  
  10009.  
  10010.                 -= Celerity v2.0 Operations Manual =-
  10011.   -----------------------------------------------------------------
  10012.  
  10013. Celerity BBS for the Practical Peripherals line of modems. Exceptional thanks
  10014. for their help and forbearance must be extended to all of the Celerity v2.0 Beta
  10015. Testing Team.
  10016.  
  10017. Alter Ego
  10018. Baby Bear
  10019. Blackjack
  10020. Byteman
  10021. Holy Ward
  10022. Jack Flash
  10023. Lenon
  10024. Sicko
  10025. The Silicon Sailor
  10026. Sledge Hammer
  10027. The Byter
  10028. Wacky Wabbit
  10029. Warlord
  10030. Wooly
  10031. Zygote
  10032. and all the others...
  10033.  
  10034. Additional Thanks to All of those who have created (Or are creating)
  10035. Celeritytext Menu Files, Celeritytext Language files, and Infoforms for
  10036. Celerity.
  10037.  
  10038.  
  10039.  
  10040.  
  10041.  
  10042.  
  10043.  
  10044.  
  10045.  
  10046.  
  10047.  
  10048.  
  10049.  
  10050.  
  10051.  
  10052.  
  10053.  
  10054.  
  10055.  
  10056.  
  10057.  
  10058.  
  10059.  
  10060.  
  10061.  
  10062.   -----------------------------------------------------------------
  10063.     Celerity v2.0                                         Page 164
  10064.  
  10065.  
  10066.  
  10067.  
  10068.  
  10069.                 -= Celerity v2.0 Operations Manual =-
  10070.   -----------------------------------------------------------------
  10071.  
  10072. AFTERWORD: The Tao of BBSing
  10073. ============================
  10074.  
  10075. There once was a Sysop who was attached to the court of the Warlord of Wu.  The
  10076. warlord asked the Sysop, "Which is easier to maintain:  a BBS package or an
  10077. operating system?"
  10078.  
  10079. "An operating system," replied the Sysop promptly.
  10080.  
  10081. The warlord uttered an exclamation of disbelief.  "Surely a BBS package is
  10082. trivial next to the complexity of an operating system," he said.
  10083.  
  10084. "Not so," said the Sysop, "when maintaining a BBS package, the Sysop operates as
  10085. a mediator between people having different ideas: how it must operate, how its
  10086. Menus must appear, and how it must conform to the laws set down by DOS and the
  10087. Phone Company.  By contrast, an operating system is not limited by outside
  10088. appearances.  When designing an operating system the programmer seeks the
  10089. simplest harmony between machine and ideas.  This is why an operating system is
  10090. easier to design."
  10091.  
  10092. The Warlord of Wu nodded and smiled.  "That is all well and good, but which is
  10093. easier to debug?"
  10094.  
  10095. The Sysop made no reply.
  10096.  
  10097. :)
  10098.  
  10099.  
  10100.  
  10101.  
  10102.  
  10103.  
  10104.  
  10105.  
  10106.  
  10107.  
  10108.  
  10109.  
  10110.  
  10111.  
  10112.  
  10113.  
  10114.  
  10115.  
  10116.  
  10117.  
  10118.  
  10119.  
  10120.  
  10121.   -----------------------------------------------------------------
  10122.     Celerity v2.0                                         Page 165
  10123.