home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / c / cel142.zip / CEL142A.ZIP / CELERITY.DOC < prev    next >
Text File  |  1992-12-14  |  137KB  |  3,123 lines
  1.  
  2.  
  3.  
  4.  
  5.                              C e l e r i t y
  6.  
  7.                                Version 1.42
  8.  
  9.                            Copyright 1990, 1992
  10.  
  11.                      The BBS of the Present - And Future
  12.  
  13.  
  14.  
  15.                   Written by Brendon Woirhaye and Dave Hicks
  16.  
  17.                               
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28. Celerity License Statement
  29.  
  30.  
  31.  
  32. This software and documentation are copyrighted products of Brendon Woirhaye
  33. and David Hicks, and are protected by the United States copyright law and
  34. International Treaty provisions.
  35.  
  36.  
  37. Copies of Celerity BBS may be freely given to other individuals for
  38. demonstration and distribution purposes only.  Any sysop who wishes
  39. to run Celerity BBS on their own system must receive a validation
  40. utility from the authors.
  41.  
  42.  
  43. Archival copies of the Celerity validation utility may be made by the
  44. owner of a Celerity license for his personal use and protection only.
  45. In no circumstances is a sysop to give a copy of his validation
  46. utility to someone else. If the sysop does willingly release his
  47. validation utility, or it gets out of his possession in any other way,
  48. he will lose all rights to support and future updates of Celerity BBS.
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Contents:
  55.  
  56. Section 1       What is Celerity?
  57.         1.1     General Description
  58.         1.2     List of major features
  59.         1.3     Distribution Policy
  60.         1.4     Hardware requirements
  61.         1.5     Required Extras
  62.  
  63. Section 2       Setting up Celerity            Note: Must-Read!
  64.         2.1     Initial Setup
  65.         2.2     Preparation
  66.         2.3     Demonstration installation
  67.         2.4     New system installation
  68.         2.5     Upgrading to a new version
  69.         2.6     Running the SETUP program
  70.         2.7     Running Celerity from a RAMdisk
  71.         2.8     Running multiple BBS' on one phone line
  72.  
  73. Section 3       Running the BBS
  74.         3.1     Setting up subs / gfiles / xfer sections
  75.         3.2     The waiting for call screen
  76.         3.3     Online commands
  77.         3.4     Background Access Editor
  78.         3.5     Online Editing Tools
  79.  
  80. Section 4       Strategies for running a good board
  81.         4.1     Policies
  82.         4.2     Access Levels
  83.         4.3     Conference Arrangement
  84.         4.4     Advertising
  85.  
  86. Section 5       Technical Details
  87.         5.1     Batch file operation and command line parameters
  88.  
  89.  
  90. Appendix A      Running CONVUSER - upgrading to new versions
  91.  
  92. Appendix B      Running PROTEDIT - editing xfer protocols
  93.  
  94. Appendix C      Running CONVFILE - Converting file areas
  95.  
  96. Appendix D      Setting up doors
  97.  
  98. Appendix E      Configurable Status Screens - what they are, how to make them.
  99.  
  100. Appendix F      CelerityNet conferencing - how to get it going.
  101.  
  102. Appendix G      FidoNet compatibility
  103.  
  104. Appendix H      Using a demonstration version of Celerity
  105.  
  106. Appendix I      Multinode operation
  107.  
  108. Appendix J      Sysop-definable text files
  109.  
  110. Appendix K      CAE and CAE/TAC Mode
  111.  
  112. Appendix M      QWK offline readers
  113.  
  114. Appendix N      Running Celerity under DesqView
  115.  
  116. Appendix O      Running Celerity under a Local Area Network
  117.  
  118. Appendix P      Running Celerity under OS/2 2.0
  119.  
  120. Appendix Q      Configurable menu scripting system
  121.  
  122. Appendix Z      Celerity Credits and Acknowledgements
  123.  
  124.  
  125.  
  126.  
  127. Section 1:  What Is Celerity?
  128. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  129.  
  130. General Description
  131. ~~~~~~~~~~~~~~~~~~~
  132. Celerity is a hobbyist-level BBS which attempts to combine the best
  133. features of other software, the newest innovations in BBS technology,
  134. introduce new and original concepts, and seamless integration of
  135. highly configurable options.  Celerity draws heavily from KauCom, an
  136. old Apple program I wrote a number of years ago.
  137.  
  138. Over sixty third-party utilities exist for celerity, and others will
  139. soon be released by various people who have been working on the Celerity
  140. project.  As they are finished and declaired bug- free, they will be
  141. distributed.
  142.  
  143.  
  144. List of features:
  145. ~~~~~~~~~~~~~~~~~
  146. -- Celerity is capable of hosting a wide array of message and transfer areas.
  147.    -- Celerity supports 5 message conferences, with up to 40 message sub-areas
  148.       in each conference, for a total of 200 message areas.
  149.    -- Celerity supports 5 transfer conferences, with up to 999 sub-areas in
  150.       each conference, for a total of 4995 file areas.
  151.  
  152. -- Celerity is optimized for speed.
  153.    -- It takes advantage of 286 / 386 / 486 processors if present for quick
  154.       memory access.
  155.    -- It fully supports the 16550 buffered UART for greater efficiency.
  156.    -- Celerity is designed with high speed modems in mind.  Particular support
  157.       has been given to 9600, 14400, 16800, and 22000 bps modems.
  158.    -- True high-speed DTE rates from 19200 to 115200bps.  Get the maximum
  159.       performance your modem and serial card can handle.
  160.    -- Complete support for v.42/v.42bis HST modems.
  161.     -- Support for v.32/v.32bis HST dual standards
  162.         -- Sustained ZIP transfer speeds as high as 2080 cps using Zmodem.
  163.    -- Extensive code rewriting for speed and efficiency has been done to
  164.       older code.
  165.    -- FAT file move for incredible file management speed.
  166.    -- ANSI/Avatar display enhancement.
  167.         -- Internal ANSI driver to end reliance on slow DOS ANSI drivers,
  168.            which other many other BBS programs use.
  169.         -- Full support of Avatar/0+ specification, including character
  170.            repitition, cursor positioning, and color support.
  171.         -- Translation of ANSI display screens to avatar for improved speed.
  172.         -- Ability to disable color for even greater speed.
  173.  
  174.  
  175. -- Celerity was designed with security in mind.
  176.    -- Users can be given or denied access to 5 xfer conferences and 5
  177.       message conferences.  Access can be given to all new users, as users
  178.       are quick-validated, or manually at any time thereafter.
  179.    -- Users can be given or denied access to individual sub-boards, transfer
  180.       sections, or most features of the BBS on the basis of security level
  181.       or transfer security level.
  182.    -- Access to individual sub-boards in the message section can be toggled
  183.       in an easy-to-use full-screen display.  Quickly grant and deny access
  184.       at the touch of a key.
  185.    -- With the menu scripting, access can further be discerned on the basis
  186.       of age, bps rate, xfer/message conference flags, sysop access flags,
  187.       security level, xfer level, and more.
  188.  
  189. -- Celerity is designed to make the sysop's life easy.
  190.    -- New users can be "Quick Validated" with one keystroke.  No need to edit
  191.       each access flag unless you desire to.
  192.    -- Fully automated new user voting section, to allow your users to decide
  193.       who gets access and who doesn't.  The sysop has veto power, of course.
  194.    -- The new user newscan quickly locates all new users awaiting validation.
  195.    -- New user voting section can be completely automated, at the sysop's
  196.       descretion.
  197.    -- New users can be required to upload an example of their newest software,
  198.       for examination by sysop and new user voting committee.
  199.    -- Complete user editing available while the user is online.
  200.    -- "Suggested Point Value" to make file validation quick and easy.  Sysop
  201.       definable, of course.
  202.    -- Automatic ZIP commenting if desired.
  203.    -- Auto-Validate allows the sysop to have all uploads automatically cleared
  204.       for downloading as soon as they are uploaded.
  205.    -- Easy-to-use setup program.
  206.    -- A multitude of sysop-configurable options.
  207.    -- Complete control over infoform access, requirements, and text.
  208.    -- The most advanced and easy-to-use online sysop tools of any Forum
  209.       clone.
  210.  
  211. -- Celerity is one of the most fully configurable BBS programs available
  212.    -- Fully configurable logon shell.  Shell commands can be added and removed
  213.       as the sysop desires, and each command is fully configurable.  The shell
  214.       can exist as either a conventional menu-type shell, a dos-simulator
  215.       shell, a UNIX-simulator, an interactive lightbar shell, or even an external
  216.       sysop-developed shell.  The shells are optional, of course, and can be disabled.
  217.    -- Configurable prompts.  Every Celerity system can have its own distinctive
  218.       prompt if the sysop desires.
  219.    -- Fully configurable file listings.  Each user can choose what file list
  220.       information he or she desires.
  221.    -- Configurable menu scripting.  Celerity allows the sysop to redefine
  222.       which keys do what on any particular menu.  Sysops can also change the
  223.       command descriptions, access requirements (including access
  224.       descrimination based on access levels, sysop access flags, age, bps
  225.       rate, and more), and even delete commands to tailor the BBS to his or
  226.       her particular needs.
  227.    -- Configurable login sequence, yet another Celerity first.  The sysop can
  228.       choose which events will be engaged for the user, and in which order they
  229.       will occur.  Celerity's login is no longer limited to internal static
  230.       events either - the login sequence can display external files and even
  231.       run external doors.
  232.  
  233. -- Celerity has the features you want and need.
  234.    -- Full conferencing.  Celerity supports up to five entirely independent
  235.       message bases and transfer sections, ideal for support of multiple
  236.       computer types.  Celerity conferences are more than just an access flag.
  237.       If you don't desire conferencing, it is a simple matter to turn it off.
  238.    -- Celerity will run on com ports 1-8, with fully configurable addresses,
  239.       inturrupts, and IRQ's.  More flexibility than any other Forum clone.
  240.    -- File commission system.  If the sysop desires, users will get file points
  241.       every time their upload is downloaded.  You can even have it set up so
  242.       a user gets NO points for uploading, and only gets points when people
  243.       download his file.  This way, users are not rewarded for uploading crap
  244.       that nobody wants, and users who upload good stuff are well rewarded for
  245.       their efforts.
  246.    -- CAE mode.  Celerity once again brings a new revolution (or a very old
  247.       one, if you were familiar with the old AE's and Catfurs in the Apple
  248.       community years ago) to the PC modem world.  See Appendix K for details.
  249.    -- QWK offline reader compatibility.  See Appendix L.
  250.    -- NAPLPS graphic support.  Celerity now supports NAPLPS graphics,
  251.       which are terminal-independent and resolution-independent.
  252.       Celerity currently allows NAPLPS welcome files, menus, and Art
  253.       Gallery submissions.
  254.  
  255. -- Celerity supports TRUE NETWORKING, not lame "Net-Mail" like early Forum
  256.    clones have.  CelerityNet was the net which inspired the networks of
  257.    LSD, Vision, Havok, Silicosis, and others.
  258.    -- ONE call per day from your system transfers data to and from the entire
  259.       net.
  260.    -- If you miss a day, the network will still send all your messages.
  261.    -- Average Net Call time is 2-3 minutes, so its cheap.  Extenders are
  262.       available.
  263.    -- Network Update service delivers recent Celerity updates to your system.
  264.       No need to call around and download them on your own time.
  265.    -- Many new and unique networking features to be added in the near future.
  266.    -- Dedicated network server.  No longer do net BBS' have to contend
  267.       with regular BBS callers to make their net calls.
  268.    -- CelerityNet is supported by the greatest number of Forum-based
  269.       software, including the popular Silicosis, Cypher, Faq, ADI, Vision-X,
  270.       Oblivion/2, and Havok packages.
  271.  
  272. -- Celerity is compatible with Fido-type networks
  273.  
  274. -- Celerity supports Multi-node operation.
  275.    -- Using network cards or a multitasking operating system, Celerity can
  276.       support up to eight seperate nodes, possibly more in the future.
  277.    -- Celerity has been used extensively under DesqView, Windows, and OS/2
  278.       for multiple nodes on a single machine.
  279.    -- Celerity works like a charm under Novell Netware, Netware Lite, and
  280.       PowerLAN.  Even under the fickle LanTastic, Celerity can run multiple
  281.       nodes.
  282.    -- Fully functional multinode chat to allow users to talk to each
  283.       other directly.
  284.  
  285. -- Celerity supports additional hardware for those who have it.
  286.    -- EGA/VGA card support.  Celerity has full support for a 43 line (EGA) or
  287.       50 line (VGA) screen for the local display.   Also works in the config.
  288.    -- SoundBlaster support.  Celerity will ring out a digitized chat call for
  289.       sysops who own a SoundBlaster card.  For those without SoundBlasters,
  290.       there is an option for digitized sound using the PC speaker, but it does
  291.       NOT sound too hot.
  292.    -- Mouse support.  If you have a mouse, you may use it for easy access to
  293.       commands.
  294.    -- 16550 UART buffering.
  295.  
  296. Celerity has most of the new features FIRST.  It has led the pack of
  297. modern Forum based clones such as LSD, Silicosis, Havok, Vision-X,
  298. Velocity, Vision, Magnum, ACS, and many others which have copied and
  299. adapted features found in Celerity first, and continues to bring new
  300. features for the others to copy.
  301.  
  302.  
  303. Distribution Policy:
  304. ~~~~~~~~~~~~~~~~~~~~
  305. Celerity is distributed via shareware, and requires a validation utility
  306. to fully utilize the system.  The validation utility can be acquired
  307. from the authors directly.  Please see the file called "SYSOP.REG" for
  308. information on acquiring a validation utility and the current
  309. registration fees.
  310.  
  311.  
  312. Hardware Requirements
  313. ~~~~~~~~~~~~~~~~~~~~~
  314. Celerity requires the following for operation:
  315.  
  316. IBM PC or AT compatible computer (XT through 486)
  317. Hard disk drive with at _least_ 5 megs free, 10+ for BBS recommended
  318. 320k RAM minimum*
  319. 640k RAM recommended w/512k EMS.
  320.  
  321. * External modules, such as pkzip and dsz, will NOT run in 280k.
  322.  
  323.  
  324.  
  325. Required Extras
  326. ~~~~~~~~~~~~~~~
  327. Celerity requires the use of a few other Shareware programs, or their
  328. equivilent.  These are listed below:
  329.  
  330. PKZIP and PKUNZIP archive utilities from PKWare.  Most of Celerity's
  331. archive manipulation is done in ZIP format because of its acceptance
  332. as the standard archive format.  These files can be obtained on most
  333. BBS'.
  334.  
  335. DSZ from Omen Technologies.  DSZ is an external transfer protocol
  336. program which supports a whole slew of transfer protocols, including
  337. Xmodem, Ymodem, YmodemG, and Zmodem.  Although other external protocols
  338. can be used, DSZ is recommended as the standard.  Feel free to add
  339. additional DSZ-Log compatible protocols like GSZ, TASY, SZModem,
  340. HS/Link, and Lynx.
  341.  
  342. HS/Link is required for bidirectional transfers.
  343.  
  344. Other archive programs like PAK, ARC, ZOO, ARJ, Teledisk, DDD, and
  345. LHARC are also supported (for archive viewing) by Celerity if the
  346. sysop owns these utilities.
  347.  
  348. QEDIT is the external editor of choice for Celerity, although any
  349. external text editor may be used with equal efficiency, such as DOS
  350. 5.0's EDIT, or even EDLIN.
  351.  
  352. For the ANSI editor, I recommend TheDraw, which is an excellent editor
  353. for the editing and creation of nice ANSI screens.
  354.  
  355.  
  356.  
  357.  
  358.                                                  
  359. Section 2: Setting Up Celerity
  360. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  361. Sysops setting up Celerity for the first time should read this file IN
  362. ITS ENTIRETY, and they will find a lot of their questions answered. When
  363. they configure the BBS via the SETUP.EXE utility, they should read the
  364. SETUP.DOC file.  As this is not commercial software, I should not be
  365. responsible to hold your hand through each step of the installation when
  366. the doc file gives you all the needed info.  It is important to read the
  367. appendices as well, as they contains a lot of useful information
  368. relating to specific topics.  The revision history (REVISION.DOC) is
  369. also a must-read and will explain many features of the BBS not covered
  370. here.
  371.  
  372. If you are moving up from another Forum-type system, such as Emulex,
  373. LSD, ACS, USSR, Oblivion/2, Havok, Vision, Vision-X, Cypher, Velocity,
  374. etc., you will find the overall feel to be much the same, and pick up
  375. the commands quite quickly.  If you are moving from a WWIV or Telegard,
  376. things will be little different from what you are used to.
  377.  
  378. If you have never run a BBS, I would recommend that you start out
  379. slowly. Celerity is highly automated and easy for an experienced sysop
  380. to run, but it is NOT a simple piece of software, and can cause great
  381. frustration to inexperienced sysops if they set up too much too soon.
  382.  
  383.  
  384.  
  385. Initial Setup
  386. ~~~~~~~~~~~~~
  387. With version 1.42, Celerity is shipped in multiple official distribution
  388. archives.  They will always be named "CELver??.ZIP" (or .LZH or .ARJ),
  389. where 'ver' is the version number (CEL142.ZIP is version 1.42, for
  390. example).
  391.  
  392. The main distribution archive contains the following files:
  393.  
  394. INSTALL .EXE - Menu driven installation program for Celerity
  395. CELverA .ZIP - New files for version upgrade
  396. CELverB .ZIP - Support files for new Celerity systems
  397. CELverD .ZIP - Files needed for the demonstration version.
  398. CELverx .ZIP - Menu set #x
  399. PACKING .LST - File containing information about other files in the zip.
  400. FEATURES.ANS - ANSI feature list for the current version
  401.  
  402. A complete and up-to-date listing of the archive's contents if found
  403. in the PACKING.LST file.
  404.  
  405. The INSTALL.EXE program should be run when you install a new Celerity
  406. system, install the demonstration, upgrade from the previous version,
  407. or if you change your menu set.  INSTALL.EXE expects to find
  408. PKUNZIP.EXE in your path.
  409.  
  410. There are other official Celerity distribution archives other than
  411. CELver.ZIP.  These include (but may not be limited to) the following:
  412.  
  413. CELverXT.ZIP:  Versions of Celerity .EXE and .OVR files for 8088/8086 machines.
  414. CELverFS.ZIP:  Version of Celerity BBS which uses a FOSSIL driver for i/o.
  415. CELverSP.ZIP:  Menu/sound/NAPLPS supplement containing additional menus.
  416. CELverUT.ZIP:  Utility package including converters, programmer's
  417.                toolkit, and many third-party Celerity utilities.
  418.  
  419. New and old users alike should read through the REVISION.DOC file to
  420. gain some familiarity with the timeline of Celerity's development, and
  421. discover some features which might not be covered in the manual.
  422. Upgrading users should read the README.ver file which includes any
  423. changes from the previous version. Everyone should be familiar with
  424. the documentation file.
  425.  
  426.  
  427. Preparation
  428. ~~~~~~~~~~~
  429. Before you begin, you should locate the following programs and
  430. utilities: PKZIP.EXE, PKUNZIP.EXE (both by PKWare), and DSZ.COM (by
  431. Omen Technologies).  Place these files in your BBS directory (specified
  432. in the setup program).  If you do not have registered copies of these
  433. programs, please acquire copies from most any BBS and register them.
  434.  
  435.  
  436. Demo Installation
  437. ~~~~~~~~~~~~~~~~~
  438. Release versions of Celerity BBS are always packaged with a
  439. demonstration version so that perspective sysops can set up the
  440. software and get a feel for it before they buy.  The only differences
  441. between a registered and a non-registered version are that a
  442. non-registered system has a limit of 10 users and forces a sysop
  443. name of "Abdul Clamwacker".
  444.  
  445. To install the demo, run INSTALL.EXE and select "Demo Install" from
  446. the menu. Installation of the demonstration version requires
  447. approximately two megabytes of free space.  Select one of the menu
  448. sets from the list when prompted.  At the current time, the demo can
  449. only be installed correctly to the C:\CELERITY path, although you can
  450. use the DOS SUBST or ASSIGN command to install it elsewhere. If you
  451. install the demo to a path other than c:\celerity, you will have to
  452. change the pathnames in SETUP.EXE for the demo to function properly.
  453.  
  454. Once you have completed the installation by INSTALL.EXE, you should
  455. exit and switch to the demo directory.  There, type "MAIN" to run the
  456. BBS.  In a moment you should be presented with the wait for call (or
  457. WFC) screen.  Pressing F10 will initiate a local log on.  The demo
  458. initially has the lightbar logon shell selected, so you should now
  459. look through the available options (the arrow keys may be used to
  460. move from option to option, and [ENTER] to select) and choose the
  461. "Logon to Celerity Demo".
  462.  
  463. After the introduction screen, type "Sysop" as the user name.  After a
  464. moment, a prompt for your password will come up.  Also appearing on
  465. the local screen will be a blow up box telling who the user is and
  466. what their password is - so you can tell easily what password to use -
  467. "HST" in this case.  Type it in, and you are on the system!
  468.  
  469. The first time you log on with the new account, you will be prompted
  470. for your real name, birth date, age, sex, and phone number.  You will
  471. then get to fill out an information script.  If any of these fields
  472. are blank, users will be required to fill them out on their next call.
  473. In the case of the default sysop password - "HST", you will also be
  474. asked for a permanent password.
  475.  
  476. Now you will be in the system proper.  Feel free to move around and
  477. experiment.  You will find some email waiting to be read, a few
  478. messages in the message section, and some files in the transfer area.
  479. Press Alt-H to get a list of local console commands.  Any of these can
  480. be used while you or a user is online.  The demo BBS is rather sparse,
  481. of course, because it lacks the activity and fullness of a completely
  482. set up system.
  483.  
  484. Once you become somewhat familiar with the options and various
  485. sections of the system, exit the software and run the SETUP.EXE
  486. utility, and begin modifying some of the options you find.  Don't
  487. change too many things without first viewing their effects.  Set up
  488. your serial and modem information in SETUP.EXE, and have a friend or
  489. two call your system to check it out.  If you like what you see, run
  490. SETUP.EXE and fill out the registration form!
  491.  
  492. If you would like to see a high volume system running Celerity, feel
  493. free to call the Celerity support BBS at 310-693-9405 (2400 v.22,
  494. 9600-14.4kbps v.32, 9600-16.8kbps HST).  First-time users can access
  495. most of the features which are enabled on this BBS, although it is set
  496. up as a stock Celerity system with many features under utilized.
  497.  
  498.  
  499. New System Installation
  500. ~~~~~~~~~~~~~~~~~~~~~~~
  501. If you have registered Celerity, or plan to do so, you can install a
  502. fresh copy of Celerity by selecting the "Install New System" option
  503. from the menu.  You will be prompted for the path to install to, and
  504. later for your desired menu set.  Once everything has been installed,
  505. exit the INSTALL.EXE and switch to your new Celerity node directory.
  506.  
  507. Run the SETUP.EXE utility, and set up all the options you need.  Read
  508. the SETUP.DOC file for detailed information on the various options and
  509. what they do.  If you have not yet gotten a validation utility
  510. (VALIDATE.EXE), insert "Abdul Clamwacker" as the sysop name to run
  511. Celerity in demo mode.  If you do have a validate.exe, enter your
  512. sysop handle exactly as you registered it as.  Exit SETUP.EXE.
  513.  
  514. When you run MAIN.BAT the first time, Celerity will probably create a
  515. few directories which don't exist.  If you run into problems here,
  516. enter SETUP.EXE again and verify your directory locations.
  517.  
  518. When the WFC (wait for call) screen appears, type F10 to log on
  519. locally.  A default sysop account will be created for you, but it
  520. won't be set up with the proper access and preferences you desire.
  521. Once you log on, you will be prompted for your real name, sex, phone
  522. number, age, birthdate, and a new password.  You will also be asked to
  523. fill out any information scripts you have defined.  Once these tasks
  524. have been completed, type F5 and enter the user editor.  Set all the
  525. sysop access flags and conference access flags and the like.
  526.  
  527. The next step is to enter the user configuration section - K from the
  528. main menu.  Select your display preferences, option toggles, and the
  529. like.  Once you complete this, you should set up your sub boards and
  530. transfer sections so your system has something for users to do.  See
  531. the section below on setting up these sections.
  532.  
  533.  
  534. Upgrading
  535. ~~~~~~~~~
  536. To upgrade to a newer version of Celerity, run the INSTALL.EXE program
  537. and select the upgrade option from the menu.  INSTALL will ask for
  538. the path to your BBS directory and will unpack the new files over the
  539. old ones.  If there are conversions which need to be done, you will be
  540. informed that they are taking place.
  541.  
  542. By all means MAKE A BACKUP of all your BBS program and data files
  543. before you upgrade!  The install program will not screw anything up,
  544. but user error often does.  Don't take the risk.
  545.  
  546.  
  547. Running SETUP.EXE
  548. ~~~~~~~~~~~~~~~~~
  549. The SETUP.EXE program is used to set up all the information about your
  550. system and BBS that Celerity needs.  It will allow you to enable and
  551. disable features, adjust parameters, define your hardware, and more.
  552. Please see the SETUP.DOC file for detailed information on each dialog
  553. of the setup process.
  554.  
  555.  
  556. Running Celerity from a RAMdisk
  557. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  558. Celerity is quick, but can be made even quicker if parts of it are
  559. contained on a RAMdisk.  Observe the following list of Celerity
  560. directories which can be run from a RAMdisk, and the APPROXIMATE
  561. requirements for each directory:
  562.  
  563. Node Directory   : Requires 800-1000k.  Having a node directory on a
  564.         RAMdisk makes the loading of the board and seperate segments
  565.         (which are loaded from the overlay file) much quicker.  This
  566.         will permit maximum speed when switching from section to
  567.         section, and make the activity log auditing nearly
  568.         instantaneous.  The size can be reduced by not copying the
  569.         setup.exe, documentation, and other files.
  570.  
  571. BBS Directory    : Requires 2000-3000k.  This directory will greatly
  572.         increase the speed at which users are looked up when sending
  573.         email, logging on, or when awarding download commissions.
  574.         Post-downloading accounting is also sped up.
  575.  
  576. Menu Directory   : Requires 50k to 150k.  The only use of placing the
  577.         files from this directory in a RAMdisk is quicker menu display
  578.         lookup and speed.  If you have no non-ANSI users, the .ASC
  579.         menus.
  580.  
  581. Data Directory   : Requires 500k to 3 megs.  The requirements of the
  582.         data directory will vary depending on the number of transfer
  583.         areas you have, the number of files in each area, and the
  584.         number of subs you have.  Buffering this directory from a
  585.         RAMdisk will provide the most noticable speed increase, found
  586.         when people list files, read posts, upload or download, read or
  587.         send mail, or just about anything.
  588.  
  589. Text Directory   : Requires 10k to 50k.  This will slightly increase
  590.         the speed at which canned text files (new user messages, info-
  591.         scripts, etc.).
  592.  
  593. Message Directory: Requires 5 to 15 megs.  Although this directory may
  594.         easily be buffered with a new system, the message data files
  595.         can grow to over 5 megabytes each, eating up a LOT of space.
  596.         In an upcoming version of the software, the storage methods
  597.         will be changed and ultimately save a lot of space, but at the
  598.         moment, only the greatest RAMdisks can handle this directory.
  599.  
  600. Temporary Directory: Do Not Buffer.  The temporary directory must have
  601.         enough room to store the largest batch upload a user will ever
  602.         make - plus additional space as large as the largest file
  603.         uploaded.  If the largest batch upload were ten 100k files,
  604.         an 1100k directory would be sufficient, but that is
  605.         unrealistic.  When a user uploads six 1 meg files to a 1100k
  606.         RAMdisk, he is bound to be angry.
  607.  
  608. Other directories may also be from a RAMdisk.
  609.  
  610. When using a RAMdisk, particularly directories which will be updated
  611. from time to time, it is a good idea to have the files automatically
  612. backed up to a hard drive between calls.  An easy way to do this is to
  613. add a line in your main.bat file:
  614.  
  615. xcopy f:\celerity\*.* c:\celerity /s /m
  616.  
  617. This will copy all files from a RAMdisk (f:) to a hard drive (c:) in
  618. the "celerity" directory.  The /s parameter tells Xcopy to copy all
  619. subdirectories (celerity\data, celerity\menus, etc.), and /m checks
  620. for archive bits to be set.  If you xcopy all the files to buffer to
  621. the RAMdisk, the archive bits will be cleared, and thus all the files
  622. would be automatically copied back to the hard drive when main.bat is
  623. first run.  On subsequent runs, such as when the board is put back up
  624. after a user has logged off, only the files which have been changed
  625. will be copied.  Do not trust a RAMdisk to hold data for weeks at a
  626. time, and backing up after every call is generally a safe bet.
  627. Lastly, keep an eye on the space free on your RAMdisk.  Any of the
  628. directories above shouldn't change size rapidly, but may eventually
  629. get larger and cause problems if they fill up.
  630.  
  631.  
  632. Running Multiple BBS'
  633. ~~~~~~~~~~~~~~~~~~~~~
  634. Through the logon shell, Celerity can be configured to give users a
  635. selection of up to three different BBS' to enter when they connect.
  636. These seperate BBS' can be entirely independent and run different
  637. software, have different file and message areas, and even have
  638. radically different purposes.  Some systems have used the second or
  639. third system slots for another BBS program (particularly to give users
  640. a period of transition where they can call either), run a company support
  641. board or shareware support board in addition to their hobby system,
  642. run an online game environment (such as The Time of Chaos) or smaller
  643. door, or run a Remote Access / Carbon Copy link to enable the sysop to
  644. take remote control of the BBS computer.
  645.  
  646. To set up such an additional system, you should install the bbs /
  647. gaming environment / door / remote link / whatever in the normal
  648. manner in a seperate subdirectory.  The next step is to check your
  649. MAIN.BAT file in your node directory, and ensure that there are
  650. errorlevel hooks for 122 or 123.  These hooks should call a batch file
  651. (the default is sys2.bat for the 122 error and sys3.bat for the 123
  652. error) which will change to the other program's directory, run the
  653. program, switch back to the node directory, and run main.bat again.
  654.  
  655. The other software should be set to connect when it detects a carrier
  656. and NOT wait for an incoming call (because a user will already be
  657. online when it is run), and to exit back to dos when the session ends.
  658. If you use a high speed modem with a locked DTE rate, you should set
  659. the other software up to expect a connection AT THAT DTE rate, or pass
  660. the DTE rate to it when run.
  661.  
  662. If you run Celerity as a second or third system, an example sys2.bat
  663. batch file would look like:
  664.  
  665. c:
  666. cd \system2
  667. celerity.exe EXIT
  668. cd \celerity\node1
  669. main
  670.  
  671. The "EXIT" command line parameter for Celerity.exe instructs the
  672. program to exit back to dos if there is no carrier present when it
  673. starts, thus if a user drops carrier while the second system is
  674. loading, it won't sit in the WFC screen waiting for callers there.
  675.  
  676. The last step is to run SETUP.EXE, and look in the system options
  677. dialog (to define a description for the second and third systems) and
  678. then go to the login commands section to enter the commands for the
  679. additional systems.  Note that if you do not use the lightbar logon
  680. shell, you can "hide" the commands for the additional systems by
  681. writing alternate shell menu files "Shell.?" (see Appendix J below).
  682.  
  683. The most common problem people have is that the second system does not
  684. identify the incoming call correctly.  Usually this is because the DTE
  685. rate is not matched by the second system.  For example, Celerity is
  686. set up to use a USRobotics Courier Dual Standard modem with a DTE rate
  687. of 38400 bps.  The second system, however, is configured to expect a
  688. DTE rate of 19800 bps, and thus gives the user garbage.
  689.  
  690.                                
  691.  
  692. Section 3:  Running the BBS itself
  693. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  694.   When you first put up the board, there will be a couple of things
  695. you will need to do after configuring to get everything ready for
  696. callers.  Go ahead and log on locally with the F10 key.  I suggest you
  697. set the "Sysop Auto-Login" prompt in the CONFIG to OFF for the
  698. duration, so you can get used to the Celerity shell and how it
  699. operates.  Log on to system 1 and enter '1' when prompted for a user
  700. #.  Your password is HST.  You will probably be asked to fill out your
  701. infoform, so go ahead and do that or skip it.  When you get to the
  702. main menu, press '+' to change your password.  Come up with something
  703. you don't use elsewhere, as it is imperative that you do not allow
  704. anyone else to enter the BBS using your password, as that can be very
  705. destructive.  After changing your password, hit 'K' to go to the user
  706. configuration section.  Set the board up as you would like it for your
  707. account.
  708.  
  709.   After you've finished playing with the defaults and password, you'll
  710. need to set up the file areas, and message bases.  Press 'M' from the
  711. main menu (or 'B' if you use the Alacrity structure) to get to the
  712. message bases.  You'll be asked for the conference to join, go ahead and
  713. say '1'.  Celerity will tell you that it can't find a message base, and
  714. would like to create one.  Go ahead and provide the information it
  715. wants.  You will set up your first sub here.
  716.  
  717. When setting up a sub-board, you will be asked for a bunch of data:
  718.  
  719. Board Name/Number:  This is what a user must type to enter the sub.  Usually
  720.                     you will use a number to access the sub, although you may
  721.                     decide to use a short name like TALK, SALE, or SOFTWARE in
  722.                     some cases.
  723. Board Name       :  This is the subs real name, such as "CelerityNet Talk", or
  724.                     "For Sale" or "General Access".
  725. Sponsor          :  The cosysop for the individual sub may be entered here.
  726.                     Usually the sysop himself will take this role, although you
  727.                     may appoint others to run a sub if you desire.
  728. Access Level     :  Users must be of this level or above to access the sub.  If
  729.                     you change their personal access flag, this may be circum-
  730.                     vented for special cases.
  731. Autodelete After :  This value is the total number of posts allowed on the sub.
  732.                     When this number is exceeded, the 2nd post on the sub will
  733.                     be removed to make room for new posts.
  734. CelerityNet ID   :  This is used for the CelerityNet network.  See Appendix H
  735.                     for details.  Enter a 0 for a local (non-networked) sub.
  736. FidoNet Path     :  This will be used for FidoNet compatibility.  Appendix G
  737. Anonymous Posts  :  Set this to YES if you would like to allow users to post
  738.                     without leaving their handle.  Be careful with this.
  739. Dataname Path    :  To be used in the future.
  740.  
  741.  
  742. The sub will then build all of its files and return you to the sub menu.
  743.  
  744. When you've finished with the first sub, say "A2" or "ASale" or whatever to go
  745. to the next sub you want in this conference.  Provide the information about
  746. each sub you wish to add.
  747.  
  748. When you have entered all the subs for conference #1, go on to the rest of the
  749. conferences (if any) and follow the above steps.
  750.  
  751.  
  752. The second task is to set up your xfer section.  Enter the xfers, and you will
  753. be prompted to create the first area of the conference.  A bit of information
  754. will be requested:
  755.  
  756. Area Name       What do you want the area to be called?  Uploads?  Doors?
  757. Access Level    What xfer level do users need to enter the volume
  758. Sponsor         Usually the sysop, but this can be used to allow a regular
  759.                 user sysop access for the individual section.
  760. Upload          Should users be allowed to upload to this area?
  761. Download        Should users be allowed to download from this area?
  762. Path            The pathname of the directory where uploaded files are to
  763.                 be stored
  764. Data File       This is the pathname of the data file.  It is suggested that
  765.                 you give it the full pathname of your data directory, plus a
  766.                 filename which will allow it to be easily recognized.  The
  767.                 automatic selection makes a filename called AREAn.x, where n
  768.                 is the area number, and x is the conference number.  This
  769.                 method can cause problems if you move areas around.
  770. Slow Drive      If the area is to be on an optical drive, network drive, or
  771.                 some other slow media, turning this toggle on will speed up
  772.                 use of the volume.
  773.  
  774.  
  775. Go through and add all of the sections for each conference. Once you
  776. have done that, run any conversion programs (see Appendix C below) if
  777. you are converting from other software.
  778.  
  779.  
  780. The next task is to set up your gfiles section.  Go in and create it,
  781. and use the % command to get into the Gfiles sysop area if you want to
  782. delete areas or sort them or whatever.  There is only one gfiles
  783. section, which spans all of the conferences, so you won't have a
  784. seperate section for each conference like you do with the xfers and
  785. message bases.  You can add additional sections in the same manner as
  786. in the xfer section, by logging the non-existant area.  The Gfiles
  787. section is otherwise identical to a transfer conference.
  788.  
  789. If you wish to create a doors section, see Appendix D below.
  790.  
  791.  
  792. Waiting Screen: When the BBS is waiting for a call, you will get a complete
  793.                 display of various statistics and the like.  At the top left
  794.                 you will see the version number of Celerity, followed by your
  795.                 board's name, followed by your personal serial number.
  796.  
  797.                 Immediately below this is a glowing "thermometer" bar,
  798.                 which is an indication of space used on the drive.  If it is
  799.                 small, your drive(s) are nearly empty.  If it has grown large,
  800.                 then you may want to clean out some older files.  This permits
  801.                 the sysop to determine how much space is free at a glace, which
  802.                 can be quite helpful for sysops who don't log onto their board
  803.                 every day, or those with small hard drives.
  804.  
  805.                 The box below that holds various system statistics, which are
  806.                 pretty self-explanatory, so I won't insult your intelligence and
  807.                 describe them.  Every few seconds, the information box
  808.                 will scroll to display additional info.
  809.  
  810.                 On the left below the statistics box is a box which shows the
  811.                 last caller to the BBS and help keys.
  812.  
  813.                 At the lower right side of the screen is a statistic box
  814.                 showing the status of timed events (CelerityNet call, auto-
  815.                 backup, and batch event), a clock, the amount of free
  816.                 storage space, chat status, and modem status.  If you press
  817.                 Alt-H, this box will be replaced with the main command box,
  818.                 or help screen.  The commands are as follows:
  819.  
  820.                 F1 will force a network call if you are on the CelerityNet
  821.                 network.  Be sure to have node # and node password before
  822.                 attempting to net.
  823.  
  824.                 Alt-F1 will process any posts in the network directory, and can
  825.                 be helpful if something goes wrong in the net.
  826.  
  827.                 F2 exits from the BBS.  Simple.
  828.  
  829.                 F3 will force the modem to send a carrier.  It is suggested that
  830.                 you let people connect by calling in, but if you need to send
  831.                 a carrier, this is how you can do it.
  832.  
  833.                 F4 performs an "instant login" for the sysop.  The sysop is
  834.                 immediately deposited at the main command prompt without having
  835.                 to enter passwords, read mail, and other time-consuming
  836.                 options.
  837.  
  838.                 F5 will enter the Online Editing Tools.  See section 3.4 for
  839.                 more information regarding these.
  840.  
  841.                 F6 will run a user-defined external program.  This program is
  842.                 set up as a batch file called DEFINE.BAT, although you can
  843.                 change this to anything you want.  Look in the MAIN.BAT file
  844.                 which manages the BBS under the label :userdefine for the text
  845.                 to change.  Put your word processor, viris scammer, or
  846.                 whatever you want here.
  847.  
  848.                 F7 will run the user-defined terminal program.  Similiar to F6
  849.                 above, this must be set up in the MAIN.BAT file under the label
  850.                 :terminal.
  851.  
  852.                 F8 will take the phone off hook so users calling will get a busy
  853.                 signal.  This resets after a few minutes.
  854.  
  855.                 F9 brings you into the Wait For Call options menu.  This allows
  856.                 a sysop to read mail, edit users, view lists of recent calls,
  857.                 recent uploads, and recent downloads, view the sysop and error
  858.                 logs, and more.
  859.  
  860.                 F10 logs on locally.  If you've got the "Auto-login" option set
  861.                 in CONFIG, then account #1 will automatically log on.  If not,
  862.                 you will be thrown into the shell or main menu, depending on
  863.                 whether or not you have a shell.
  864.  
  865.                 Alt-F10 will automatically log the sysop in, regardless of the
  866.                 "Auto-login" option setting.
  867.  
  868.                 Alt-A will toggle the sysop availability status.
  869.  
  870.                 Alt-H will toggle the help screen on and off.
  871.  
  872.                 Alt-D will drop into DOS.  Typing EXIT returns to the WFC.
  873.  
  874.                 On the left side below the last caller/free storage box is the
  875.                 system messages box.  The top lines specify the modem driver
  876.                 being used (internal or FOSSIL) and the UART type detected.
  877.  
  878.                 Further down in this box is the name of the sysop the copy of
  879.                 Celerity is registered to.  Again, to keep people from giving
  880.                 copies of this to everyone they know.
  881.  
  882.                 Occasionally a message will appear in this box explaining some
  883.                 problem or marginal situation which may need your attention.
  884.  
  885.                 Other messages which may appear include the detection of a
  886.                 mouse, a warning to upgrade to a new version of Celerity, or
  887.                 indication that you are running a beta version of the program.
  888.                                            
  889.  
  890.  
  891. Online Commands
  892. ~~~~~~~~~~~~~~~
  893. There are a number of keys which can be used when a user is online.  By
  894. pressing the Alt-H key, you can toggle through three help screens detailing
  895. every command.  Some which need some clarification are outlined below.
  896.  
  897. F1:  Enter split-screen chat mode.  This splits the screen horizontally,
  898.      giving the user the bottom ten lines and the sysop the top.  Many people
  899.      prefer this mode as both people can type at the same time, but it can be
  900.      slow for 2400 users, and most terminal scrollback functions will not work
  901.      with it.
  902.  
  903. F2:  This is not used for a Celerity function.  Refer to the Alacrity.doc
  904.  
  905. F3:  Hang up on user.  This drops the line on the user quickly and cleanly.
  906.  
  907. F4:  Enter line chat mode.  This is a "normal" chat.  Quick, speedy, and works
  908.      with terminal scrollback.
  909.  
  910. F5:  Enter the Online Tools.  See below.
  911.  
  912. F6:  Grant sysop access to user (temporarily).
  913.  
  914. F7:  When you hit this, the system will not reset when the user logs off.
  915.      Using this command, a patient sysop can reserve the system without
  916.      kicking a user off.  Celerity will make some noise when the system is
  917.      free.
  918.  
  919. F8:  Time lock.  User's time will not decrement.
  920.  
  921. F9:  Lock incoming data from modem.  The user will not be able to type.
  922.  
  923. F10: Lock outgoing data.  The user won't be able to see anything.
  924.  
  925. Alt-A: Toggles sysop availability.
  926. Alt-B: Refresh bottom of screen data display.
  927. Alt-D: Drop to DOS.
  928. Alt-H: Toggle through 3 help screens.  The user can continue to use the system
  929.        while you are using help.
  930. Alt-K: Take all time away from user (hang up saying "out of time").
  931. Alt-T: Give the user temporary sysop status.
  932. Alt-S: Display quick user status.
  933.  
  934.  
  935.  
  936. Background Access Editor
  937. ~~~~~~~~~~~~~~~~~~~~~~~~
  938. Alt =       : Alt-Equals enters the background access editor.  This
  939.               brings up a data screen and allows to adjust the access of
  940.               the online user while he continues to use the system,
  941.               oblivious of your actions.
  942.  
  943. Alt  F1-F5  : Give access to conferences #1 to #5.
  944. Alt  F6-F10 : Give access to xfer conference #1 to #5.
  945. Ctrl F1-F5  : Remove access to conferences #1 to #5.
  946. Ctrl F6-F10 : Remove access to xfer conferences #1 to #5.
  947.  
  948. The following commands can be augmented with the Ctrl key, which will give ten
  949. times the normal addition/subtraction (ie: Ctrl-Home gives ten file points).
  950.  
  951. Left Arrow  : Remove 1 minute of time.
  952. Right Arrow : Grant 1 minute of time.
  953. Home        : Give one file point.
  954. End         : Remove one file point.
  955. Insert      : Add one access level.
  956. Delete      : Remove one access level.
  957. Page Up     : Add one Xfer level.
  958. Page Down   : Remove one xfer level.
  959.  
  960.  
  961.  
  962. Online Editing Tools
  963. ~~~~~~~~~~~~~~~~~~~~
  964. The Online Editing Tools provide the sysop with a powerful set of utilities
  965. which may be used when a user or sysop is online, or from the WFC screen.
  966. When you press F5, the menu will appear.  You may select options from this
  967. menu in three ways: Moving the light bar with the cursor control keys and
  968. pressing [Enter] on the desired option, moving the light bar with your mouse
  969. and clicking on the desired option, or by pressing the highlighted key for the
  970. desired option.  Options currently available include the following:
  971.  
  972. User Editor:  Allows you to edit most of the statistics and access for the
  973. online user.  Move from option to option with the cursor keys or Enter key.
  974.  
  975. Delete User:  Provides for deletion of the online user if they turn out to be
  976. a real jerk or for whatever reason.
  977.  
  978. Hang Up: Log the currently online user off.
  979.  
  980. Run Setup: Links the Setup program to allow you to change functions of your
  981. system's setup.  This will not function if you are short on memory.
  982.  
  983. Text Editor: Links your external text editor, as set up in the config.  A good
  984. example is Qedit.
  985.  
  986. ANSI Editor:  Links another external editor, usually for the editing of ANSI
  987. files such as menus.  TheDraw is a good example of an ANSI editor.
  988.  
  989. Load another User: Loads in a user and allows the sysop to edit his/her
  990. statistics.  This command will bring up a pick list of all the available
  991. users, sorted alphabetically by name.  You can enter the user's name or
  992. number, or use the scroll bar to select.
  993.  
  994. Exit: Return to the point you were before calling the tools.
  995.  
  996.  
  997.  
  998.  
  999.  
  1000. Strategies for Running a Good Board       Section 4
  1001. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1002. Running a BBS is not an easy job, and running a high quality board
  1003. which commands respect is downright difficult.  Here are a couple of
  1004. suggestions to help you run a quality system.
  1005.  
  1006.  
  1007. [Policies]
  1008.  
  1009. Sit down and determine the policies your board will have.  If you have
  1010. concrete policies that the users can be aware of, they will be much
  1011. more cooperative and your system will appear to be much more stable
  1012. and well run.  Some policies which you should consider:
  1013.  
  1014. 1:  Local callers.
  1015.  
  1016.     Local callers have often been called the bane of a quality
  1017.     BBS because of the assumption that "good users will call long distance for
  1018.     good boards.  Local callers will take whatever they can find".  In many
  1019.     cases, this has been proven to be true.  In general, users who call long
  1020.     distance are of a higher quality than those who only call local systems.
  1021.     However, there may be high quality local users you will miss out on if you
  1022.     flat out refuse all locals.
  1023.  
  1024.     Different policies you may take would be:
  1025.  
  1026.     a.  Acceptance of all users, local or not.
  1027.     b.  Acceptance of local users providing they call out-of-state boards
  1028.     c.  Acceptance of only a few local users.  Use of the LUL (Local User
  1029.         Lockout) feature of Celerity will allow you to set a percentage of
  1030.         local users who are allowed on the system.
  1031.     d.  Flat out refusal of all locals.
  1032.     e.  Acceptance of local users if they have a password found only on out-
  1033.         of-state systems.
  1034.  
  1035.     Decide what your policy is going to be, and stick to it.  Do not change it
  1036.     every day, and let your users know when you are changing it.
  1037.  
  1038. 2:  Slow callers.
  1039.  
  1040.     Nobody can argue that 300 bps users should be permitted to have full access
  1041.     to any bulletin board system, but in recent years, with the advent of high
  1042.     speed modems, these restrictions have been extended to 1200 and 2400 users
  1043.     as well.  In general, a 1200 or 2400 bps user can contribute just as much
  1044.     to sub-board activity as a 9600 or 14.4k user can, but will not be able to
  1045.     transfer nearly as much data in the transfer sections.
  1046.  
  1047.     9600/14400/16800-Only systems: When I put up my IBM board for the first
  1048.     time, in late 1989, there were NO 9600 only boards in the United States,
  1049.     and many users said I was crazy to have such strict requirements of my
  1050.     callers.  I stuck with the 9600/14.4k only policy, and my board has become
  1051.     quite successful and currently has over 200 quality HST users, and many
  1052.     hundreds of HST users who had been denied access.  These days, more and
  1053.     more boards are following my system's lead (although many don't realize
  1054.     it) and establishing a high-speed-only policy.
  1055.  
  1056.     Some policies you might consider would include:
  1057.  
  1058.     a.  Accepting all 1200/2400 users.
  1059.     b.  Accepting only the highest quality slow users.
  1060.     c.  Accepting only slow users who are in pirate groups
  1061.     d.  Accepting only out-of-state slow users.
  1062.     e.  Accepting only a small percentage of slow users.
  1063.     f.  Accepting slow users if they give a donation.
  1064.     g.  Accepting slow users, but deny transfer privileges.
  1065.     h.  Turning down all slow users, regardless of qualifications.
  1066.     i.  Accepting slow users for only a certain period of time, such as when
  1067.         the board first opens.
  1068.  
  1069.     Selecting your low speed policy can be difficult.  If it is too restrictive
  1070.     if can hinder early development of the system.  If it is too liberal, it
  1071.     can make your system far too busy to get the attention of high speed users
  1072.     and reduce the amount of new programs uploaded.
  1073.  
  1074.     In the future, even "high speed" 9600bps may be considered slow with the
  1075.     wide availability of 14400, 16800, and greater modems.
  1076.  
  1077. 3:  Access requirements.
  1078.  
  1079.     Many boards will accept anyone who calls.  Others are more selective as to
  1080.     whom they validate.  This policy can be a key factor in determining the
  1081.     quality of your system.  Some factors many systems consider when deciding
  1082.     to accept or deny a user include the following:
  1083.  
  1084.     a.  Speed and location factors, as determined by the above policies.
  1085.     b.  How soon does the user get new programs.  You may make a distinction
  1086.         between games and utilities/applications users.
  1087.     c.  Is the user willing to donate funds/hardware for the upkeep and the
  1088.         improvement of the BBS?
  1089.     d.  Will the user bring a certain amount of respect to the system (ie: is
  1090.         the user a major figure in the BBS community)
  1091.     e.  Is the user on other quality systems around the nation?
  1092.     f.  Does the user have good references?
  1093.  
  1094.     One highly effective way of keeping poor users off your system is to get a
  1095.     group of highly selective individuals as your new user voting panel (ie:
  1096.     users with a high enough level to vote), and have them determine whether or
  1097.     not to accept a user.  When you have a number of users voting, the chances
  1098.     of some of them knowing a user you may not know are improved greatly.
  1099.  
  1100. 4:  Conduct.
  1101.  
  1102.     Rules of conduct are usually very important in determining the quality of
  1103.     a BBS.  Do you want to allow "rag wares" on your system?  They will appeal
  1104.     to a younger audience, but will turn off your more mature users.  Do you
  1105.     care if users post on the wrong subs?  How old can a program be and still
  1106.     be a wanted upload?  Do you accept non-game uploads?
  1107.  
  1108.     There are a number of small aspects you will want to define and usually
  1109.     post so users are aware of them.  If you enforce them, your good users will
  1110.     abide by them and help enforce them themselves.
  1111.  
  1112. 5:  Voice Validation.
  1113.  
  1114.     If you are going to voice validate users, you should let them know that you
  1115.     may do so.  Many sysops will ask, in an info-form, whether a user will
  1116.     accept a collect phone call, and the best time to call.  Voice-validating
  1117.     is a good way to know that you have SOME accurate information about a user,
  1118.     and he/she can be contacted if necessary.
  1119.  
  1120.  
  1121. [Access Levels]
  1122.  
  1123. Be consistant with your access granting.  Grant new users a certain level, and
  1124. upgrade their access when they prove to be good users.  Be very careful when
  1125. making a cosysop, and be sure you know that user well.  Many boards have gone
  1126. down because of sabotage done by a cosysop, and many MANY boards have had their
  1127. security compromised when a cosysop downloads the userlist and passwords.
  1128.  
  1129. Do not give rediculous access levels.  Celerity supports access levels of -5 to
  1130. 100.  A negative access level will delete the user the next time they call.
  1131.  
  1132. -1  Deletes the user.
  1133. -2  Gives the user the system 2 password and deletes him.
  1134. -3  Gives the user the system 3 password and deletes him.
  1135. -4  Tells the user he was deleted under "special circumstances" and displays
  1136.      the "SPECCIRC.BBS" file in the menu directory.
  1137. -5  Tells the user what the results of the new user voting on him were, and
  1138.     deletes the user.
  1139.  
  1140. Level 100 is sysop level.  Do not make levels over 100.
  1141.  
  1142.  
  1143. [Conference Arrangement]
  1144.  
  1145. As you may have read, Celerity supports up to five entirely seperate
  1146. conferences, each one is much like a BBS to itself, possessing an individual
  1147. transfer section and set of sub boards.  Sysops may use conferences for
  1148. different reasons, but most often they are used to restrict access on a very
  1149. general level.  Some setups I have seen include:
  1150.  
  1151. 1:  One conference is for general access.  All non-computer-specific data,
  1152.     such as subs on entertainment, music, politics, literature, and the like
  1153.     stay here.  The second conference is for IBM users, and contains all IBM-
  1154.     specific subs and transfers.  The third conference is for some other
  1155.     computer type.
  1156.  
  1157. 2:  The first conference is general subs and transfers.  The second is for
  1158.     out-of-state users, the third is for locals.
  1159.  
  1160. 3:  Add seperate conferences for certain groups your board may cater to.
  1161.  
  1162. The possibilities are endless.  Experiment and decide what you want
  1163. and need.
  1164.  
  1165.  
  1166.  
  1167. [Advertising]
  1168.  
  1169. Advertising is a sticky subject.  A couple points to remember are:
  1170.  
  1171. 1:  Advertise to your proposed audience.  If you don't want any locals, don't
  1172.     post ads on local boards, and advertise only on out of state systems.  The
  1173.     locals who may be quality users will eventually find out by calling those
  1174.     other systems.  If you don't want slow users, don't post on boards which
  1175.     cater to them.  Posting only on 9600 only boards is quite feasible in this
  1176.     day and age.  Post only on boards which have users of the quality you would
  1177.     like.
  1178.  
  1179. 2:  Do not over-advertise.  Nobody will call a board which makes them sick with
  1180.     too many ads.  Don't always use the same ad either, but vary the ads and
  1181.     use new ones from time to time.  Users will abort any ad they recognize.
  1182.  
  1183. 3:  Never, NEVER, send mass-mail advertising your system.  Doing so will most
  1184.     likely piss off the sysop of the board you are on, and in addition, no
  1185.     decent user will call a board he has gotten a mass mail invitation to.  If
  1186.     there are a few users you would like, you can try sending them each a peice
  1187.     of individual mail, but mass mail is sure trouble.
  1188.  
  1189. 4:  Make a nice looking ANSI ad.  There are a few ANSI specialist groups, such
  1190.     as ACiD and A.A.A. who will design ads for people (like myself) who have
  1191.     absolutely no ANSI talent.  When you post it on a forum clone system, be
  1192.     sure that you have it saved in 79-column mode, not unlimited length.
  1193.  
  1194. 5:  Dumb BBS ads in ZIPs.  Don't do it.  The proliferation of these ads has
  1195.     gotten way out of hand, and nobody looks at them anymore anyway.
  1196.  
  1197.  
  1198.  
  1199. Technical Details       Section 5
  1200. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1201. Various technical details not covered elsewhere will be covered here.
  1202.  
  1203. [Batch file operation]
  1204.  
  1205. Celerity is run from a batch file.  This batch file should loop in on itself
  1206. to keep the system running if it is the only system.  See the example
  1207. "main.bat" file for an example.  Celerity will return with the following
  1208. errorlevels for certain conditions:
  1209.  
  1210.  
  1211. 125:  Run terminal program
  1212. 124:  Run sysop-defined event
  1213. 123:  Run system 3
  1214. 122:  Run system 2
  1215. 100:  Exit bbs (don't re-run batch file)
  1216.  67:  Run the SETUP.EXE program
  1217.  66:  Run the PROTED.EXE program
  1218.  50:  Exit BBS
  1219.  
  1220.  
  1221. [Command Line Parameters]
  1222.  
  1223. A number of Celerity functions can be called from the DOS command line, to
  1224. facilitate using its features from another program which calls Celerity.
  1225. The commands refer to the first parameter, although some may take additional
  1226. parameters.
  1227.  
  1228. Celerity exit     ;  This command will cause Celerity to exit if there is no
  1229.                      carrier present, rather than go to the WFC.
  1230. Celerity net      ;  Make a CelerityNet call if such a call has not yet been
  1231.                      made today.
  1232. Celerity forcenet ;  Force a CelerityNet call, whether or not it has been made
  1233.                      that day.
  1234. Celerity toss     ;  Toss any non-local, non-sent .msg files in FidoNet
  1235.                      directories.
  1236. Celerity link d b ;  Load up Celerity at DTE rate d and bps rate b
  1237. Celerity load d u ;  Load up Celerity at DTE rate d and load user #u
  1238. Celerity Noverify ;  Load up Celerity without full system verification
  1239.  
  1240.  
  1241.  
  1242. Appendix A:  Running CONVUSER
  1243. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1244. All internal user conversions are handled by the install program.  If
  1245. you need to convert from another software package, examine the
  1246. contents of the CONVERT.ZIP in your utilities directory.
  1247.  
  1248.  
  1249.  
  1250. Appendix B:  Running PROTEDIT
  1251. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1252. PROTEDIT.EXE is a program which allows you to set up your protocol files in a
  1253. format that the BBS can read.  You will be prompted for the letter to use the
  1254. protocol, the protocol's file name (ie: dsz.com), a description of the protocol,
  1255. and a command line.  The command line can use four switches which are passed
  1256. from Celerity, which are as follows:
  1257.  
  1258. %1 - COM port number
  1259. %2 - COM speed value  (note: low-speed callers will still have data sent at the
  1260.      fixed DTE rate when using an HST)
  1261. %3 - The filename to be sent.  Precede with an AT sign (@) for batch
  1262. %4 - The average/estimated CPS, for time estimates
  1263.  
  1264. If you get a "Permission Denied" error when trying to download, that
  1265. is a result of a conflict between DSZ and DOS' SHARE command.  Don't
  1266. bother loading SHARE unless you have a network without any protection
  1267. going.
  1268.  
  1269. I don't pretend to be an expert on protocol setup, so if anyone comes
  1270. up with better strings, please post them on Terrapin's Celerity Sysop
  1271. sub.  Of course, substitute your own logfile name for what I use on
  1272. the Puma files above, and MAKE SURE it corresponds to the logfile
  1273. parameter you set up in your config. If someone wants to do strings
  1274. for Ymodem, Xmodem, Super8k, Jmodem, Cmodem, Whatevermodem, feel free
  1275. to post them on the Celerity Sysop sub.
  1276.  
  1277. There are a couple of protocol editors written by other folks which
  1278. can be found up on the support board.
  1279.  
  1280.  
  1281.  
  1282.  
  1283. Appendix C:  Running CONVFILE
  1284. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1285.         CONV????.EXE will convert file areas, and is covered under the heading
  1286. of CONVFILE.EXE (the name for the Celerity->Celerity file converter).
  1287. ???2CELR.EXE is the name of the user converter for other BBS packages, which
  1288. is covered under the CONVUSER.EXE header below (for the Celerity->Celerity
  1289. userlist converter).
  1290.  
  1291.         Be warned that none of these are polished programs.  They are ugly,
  1292. inefficient, slow, poorly documented, have an attrocious interface, and are
  1293. dangerous.  The up side is that they (usually) work.  MAKE BACKUPS before you
  1294. attempt to do any conversions.
  1295.  
  1296.         It is best to have a complete copy of Celerity set up before you do
  1297. any conversions.  Set up your board as you wish it to be (at least initially)
  1298. with all conferences and transfer areas set up (without files of course).
  1299. When you convert data areas, do them in a seperate temporary directory and
  1300. then copy them to the Celerity directory over the existing files.  User files
  1301. are easy to convert, file areas are not.  For file areas, you will have to
  1302. manually run the CONV????.EXE for each file area.
  1303.  
  1304. There are two types of CONVFILE programs.  One is to upgrade to a more recent
  1305. version of Celerity (such as Celerity 1.20 to 1.23), the other is to convert
  1306. file areas from another BBS program to Celerity.
  1307.  
  1308. CONVFILE.EXE  --- Upgrade Celerity (needed for 1.19 to 1.20, and 1.20 to 1.23)
  1309. CONVTCS .EXE  --- Convert from TCS 1.41/1.51
  1310. CONVLSD .EXE  --- Convert from LSD (1.28 to 1.35 tested)
  1311. CONVHAV .EXE  --- Convert from Havok, all versions
  1312. CONVEMU .EXE  --- Convert from Emulex 1.65/2.x
  1313. CONVVIS .EXE  --- Convert from Vision .82 (identical to LSD).  .83 untested.
  1314. CONVTG  .EXE  --- Convert from Telegard 2.5
  1315.  
  1316.  
  1317. CONVFILE.EXE is the version to upgrade to new Celerity versions.  Simply go
  1318. to your DATA directory, make a backup of the files, and run the CONVFILE
  1319. program.  It will update all your file areas and file records to the new format.
  1320.  
  1321.  
  1322. CONVxxx.EXE for TCS, LSD, Emulex, Havok, and Vision accepts two parameters:
  1323. the source file, and the target file.  You may use complete pathnames here if
  1324. you desire.  The file records for Celerity are stored in the DATA subdirectory
  1325. and always have a ".DIR" extension.  The individual names are defined when you
  1326. create the transfer areas from the xfer menu.  The source files from the above
  1327. software are usually named "AREA1", "AREA1.1", or something similar.
  1328.  
  1329. CONVTG.EXE accepts three parameters.  The first is the source file (the
  1330. Telegard .DIR file), the second is the target file (the Celerity .DIR file),
  1331. and the third is the full pathname of where the files are stored (ie:
  1332. C:\xfers\uploads\).  The file records for Celerity are stored in the DATA
  1333. subdirectory, and always have a ".DIR" extension.  The individual names are
  1334. defined when you create the transfer areas from the xfer menu.
  1335.  
  1336.  
  1337. Appendix D:  Doors
  1338. ~~~~~~~~~~~~~~~~~~
  1339. Celerity can support a wide array of "doors" such as online games,
  1340. tape retrieval systems, another BBS, and more.  Doors may be entire
  1341. programs or simple utilities.
  1342.  
  1343. The BBS industry has a number of standard formats with which a BBS can
  1344. transfer information to a door which requires BBS information.  The
  1345. new standard which most BBS programs now support is the DOOR.SYS
  1346. standard.  Other standards include the RBBS/QBBS/Remote Access
  1347. DORINFO.DEF format, and the WWIV-based CHAIN.TXT.  Celerity supports
  1348. all three of these formats, and when a door is run, DOOR.SYS,
  1349. DORINFO.DEF, and CHAIN.TXT are all created in the node directory.  It
  1350. should be noted that there are other formats (PCBOARD.SYS,
  1351. CALLINFO.DAT, etc.) supported by many doors which are not directly
  1352. compatible with Celerity.  To use these doors, use a door conversion
  1353. program such as DOORWAY (shareware program available on most BBS') to
  1354. convert from one of the three supported formats to the desired format.
  1355. Nevertheless, over 80% of the BBS-supported doors can use one of the
  1356. Celerity supported formats.
  1357.  
  1358. To set up a BBS-supporting door (such as an online game - Global War
  1359. and Tradewars are two examples), you should first unpack the game and
  1360. read all of its enclosed documentation.  Look for sections supporting
  1361. DOOR.SYS, DORINFO.DEF, and CHAIN.TXT in that order, and follow the
  1362. instructions for setting up with that configuration.  If the door has
  1363. configurable options for modem control, make sure it reflects
  1364. Celerity's modem settings.  If Celerity locks the COM port at a
  1365. specific DTE rate (as is the case with high speed modems), make sure
  1366. the door will do so as well.  Most doors will allow you to run in a
  1367. local mode, so you should try running it a few times locally to make
  1368. sure everything is working before you try hooking it up to Celerity.
  1369.  
  1370. Once the door is installed and configured, you can add access to it
  1371. from Celerity by entering the Doors section (D from the main menu).
  1372. If you have sysop access for the doors section, you may use the
  1373. C)reate command to make a new door.  A display will pop up, requesting
  1374. the name / description of the door, required security level to access
  1375. it, the door type, and the file name to execute.  Although it is
  1376. permissible to type an entire pathname to an .EXE or .COM file, it is
  1377. preferable to simply give a simple filename with no path.  In this
  1378. situation, Celerity will run a batch file with the specified filename,
  1379. and will expect to find it in the node directory.  This is
  1380. particularly helpful if the door requires different command parameters
  1381. for different nodes.
  1382.  
  1383. An example batch file, "TRADEWAR", which I use for TradeWars is as
  1384. follows:
  1385.  
  1386. copy \celerity\node1\door.sys \doors\tradewar
  1387. cd \doors\tradewar
  1388. tw2002 -door
  1389.  
  1390. The first line copies my DOOR.SYS to the door directory, as I never
  1391. figured out how to tell Tradewars where to find the door file.  The
  1392. second line switches to the Tradewar directory, and the third line
  1393. executes the door with the "-door" parameter - meaning "use DOOR.SYS"
  1394. to Tradewars.
  1395.  
  1396. Try running the door and see if the link works correctly.  If it does
  1397. not, go over all your filenames and make sure they are entered
  1398. correctly.  Once it is working locally (note that some doors cannot be
  1399. run from within the BBS for local callers, and will exit immediately
  1400. if they do not find a carrier), have a user call and try to use it.
  1401. Remember, if you like a door and decide to use it, you should support
  1402. the Shareware concept by registering it (given that its a Shareware
  1403. product, of course).
  1404.  
  1405. Other doors can be created which do not support BBS' directly,
  1406. although they should have some kind of modem support if the calling
  1407. user is expected to see any displays or enter any input.  When running
  1408. another BBS or remote control program (Remote Access, Carbon Copy, PC
  1409. Anywhere, and so on), communications support is a given.  When running
  1410. some other utility, however, it might not be so easy.  Some  programs
  1411. such as DOORWAY or DOS' CTTY can re-map all screen output and console
  1412. input over the modem, which may be necessary.  When running extensive
  1413. applications or utilities, however, it is recommended that one of the
  1414. above remote control programs be used.
  1415.  
  1416.  
  1417. Appendix E:  Configurable Status Screens
  1418. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1419. Ok.  A new feature Celerity has with 1.19 is the ability for the sysop to make
  1420. his or her own status screens, rather than use the ones hardcoded into
  1421. Celerity.
  1422.  
  1423. Three such screens can exist, and should be saved in the following files:
  1424.  
  1425. LOGNSTAT.    : This will be the stat screen displayed when the user first logs
  1426.                in to the system.
  1427. YOURSTAT.    : This replaces the main "Your Status" screen from the main menu.
  1428. XFERSTAT.    : This replaces the Xfer status screen and xfer policy box.
  1429. USERSTAT.    : This replaces the user status screen in the sysop's user edit
  1430.                section.
  1431.  
  1432. Make sure the files do not have a suffix.  If you wish to make different files
  1433. for different emulations, do so, but you MUST have one file with no suffix.
  1434. You can add .ANS and .ASC files if you desire.
  1435.  
  1436. Now, how the hell do you make a screen?  Easy.  You need to get into TheDraw or
  1437. whatever ANSI editor you use, and design your screen.  When you've got every-
  1438. thing designed the way you like it, jump into animation mode, and place the
  1439. display commands at the location you wish the data to appear.  The display
  1440. commands come in two types, @ commands and ` commands.
  1441.  
  1442. Here are the valid commands:
  1443.  
  1444. @A - Sysop Available / Sysop not available
  1445. @H - User's handle
  1446. @R - User's Real name
  1447. @P - User's phone number
  1448. @N - User note
  1449. @p - Password
  1450. @T - Total time spent online
  1451. @t - Time left today
  1452. @# - Total number of calls
  1453. @1..@5 - displays the conference name IF the user has access to the conf.
  1454. @L - Date of last call
  1455. @l - Time of last call
  1456. @h - Hack attempts
  1457. @S - Sysop availability
  1458. @c - Last caller
  1459. @B - User's BBS level
  1460. @G - User's Gfile level
  1461. @X - User's Xfer level
  1462. @Q - Quality rating
  1463.  
  1464. `X - Number of uploads
  1465. `x - number of downloads
  1466. `K - K uploaded (includes a 'k' at the end of the value)
  1467. `k - K downloaded (also includes a 'k' at the end)
  1468. `R - Upload/Download ratio (includes a '%' at the end)
  1469. `r - Upload K/Download K ratio (includes '%')
  1470. `F - File points
  1471. `C - Commission points earned  (since last call)
  1472. `V - Validtion points earned   (since last call)
  1473. `U - New uploads
  1474. `G - New Gfiles
  1475. `P - New posts
  1476. `M - Mail waiting
  1477. `D - New databases
  1478. `c - Average CPS rate user gets downloading
  1479. `p - Number of posts made
  1480. `% - Post/Call ratio
  1481. `u - gfiles uploaded
  1482. `d - Gfiles downloaded
  1483. `$ - Gfile u/d ratio
  1484.  
  1485. Feel free to design some screens and upload them to Terrapin for other sysops
  1486. to use if they desire.  This is yet another feature to make your Celerity system
  1487. look more distinctive and to your liking.
  1488.  
  1489.  
  1490. Appendix F:  CelerityNet Conferencing
  1491. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1492. CelerityNet supports a network of over 50 systems worldwide which run
  1493. Celerity, Havok, Silicosis, Cypher, ADI, Vision-X, Faq, or Oblivion/2
  1494. software - all of which have adopted the CelerityNet standard.  It
  1495. contains approximately fifty message conferences, which are
  1496. essentially local sub-boards which echo messages to all other systems
  1497. in the Net which support the sub identification code.  Set up the
  1498. network as follows:
  1499.  
  1500. Step A: Fill out a Celerity application and send it in for the net
  1501. connection. If you register for the net after purchasing Celerity,
  1502. indicate your serial number on the form.
  1503.  
  1504. Step B: Enter your password, node number, and other relevant information
  1505. in the network setup box.  Your node number will be the same as your
  1506. serial number (#100230, for example).
  1507.  
  1508. Note: If you do not want to join the international CelerityNet, but
  1509. rather a secondary network running Celerity, you would have to join by
  1510. their rules applying to steps A and B, not ours.
  1511.  
  1512. Step C: In SETUP.EXE, go to the net options and turn on CelerityNet.
  1513. Enable features A and F, and choose any other options you wish to
  1514. receive.  Enter a unique origin line, and the host phone #.  The host #
  1515. for international CelerityNet is 310-479-5808.  Enter a "1" in the
  1516. extender field for normal calls, or you can enter international dialing
  1517. codes, an extender, or other dialing codes which will be sent to the
  1518. modem.
  1519.  
  1520. Note: If you are taking your net feed from a regional or local hub
  1521. rather than from the CelerityNet host, you should arrange a net account
  1522. directly with the hub (ie: do steps A-C with the hub).
  1523.  
  1524. Step D:   Enter the sub board section on your BBS.  Make a new sub, and
  1525. give it a sub ID of #99 (test sub).  Make two posts on the sub (the
  1526. first post is always made locally as an "introduction" post), one of
  1527. them saying "This is a test post from xxxx BBS", or something to that
  1528. effect.
  1529.  
  1530. Step E: Create another sub, making it accessible to the sysop only (keep
  1531. all users out).  Give it a CelerityNet ID of #1, and label it
  1532. "CelerityNet Support".  Post a single message on this sub (and all
  1533. subsequent subs).
  1534.  
  1535. Step F: Exit the BBS, and press F1 from the wait for call screen.  The
  1536. system should dial out and attempt to connect to the network server.
  1537. Once it connects, you will get a message saying "It's been a while since
  1538. you've connected.  You will only get recent posts".  Ii will send a
  1539. feature list, zip up your posts, and send them via DSZ Zmodem. After a
  1540. few moments, a return packet should be zipped up and sent to you.  The
  1541. BBS will unpack the return packet and move posts to the appropriate
  1542. subs.
  1543.  
  1544. Step G: Log onto the BBS and see if there are any new posts in the new
  1545. subs you created.  Most likely you won't get anything in the test sub,
  1546. but should get some new posts from the CelerityNet support sub.
  1547.  
  1548. Step H:  Once you know the network is functioning correctly, you are
  1549. welcome to add additional subs.  Check the NETSUBS.EXE program to get a
  1550. list of currently supported subs.  New NETSUBS.DAT files are released
  1551. periodically.  If you have an idea for a new sub, feel free to contact
  1552. "Mobius" through Private Netmail (Sub ID #255) and see if he'll add it.
  1553.  
  1554. Please do not post "Is the net working???" posts on all the subs.  Use
  1555. net sub #99 for test posts.  It works like all other subs do.
  1556.  
  1557. Sysops are responsible for posts originating from their system.  If they
  1558. do not keep the boards free of ragging and other immature posts, or if
  1559. they are indiscriminant in giving out access to the net subs, they may
  1560. be locked out of the network.
  1561.  
  1562.  
  1563. As of July 7th, 1992, these are the current public net subs carried by
  1564. CelerityNet.  For more recent listings, run your NETSUBS.EXE file.
  1565.  
  1566. You will notice that I have divided the subs into a few general groups.
  1567. The first one is for sysops only, and are not for use by general users -
  1568. if you let regular users in here, you'll probably be dropped from the
  1569. net.  The second is "General subs", meaning they aren't
  1570. computer-specific.  The third section is a more technical computer
  1571. section, dealing with the technical aspects of computer use, operating
  1572. systems, programming, Amiga, and assorted hardware.
  1573.  
  1574.  
  1575. Sysop subs: Only the sysop may have access to these.  Not even cosysops
  1576.     are welcome.
  1577.  
  1578. 1:  CelerityNet Support   ---   Discussion of network matters
  1579. 18: Beta Testing          ---   For beta testing of Celerity
  1580. 26: Sysops                ---   Celerity sysops ONLY - no other users.
  1581. 30: Celerity Utilities    ---   Celerity sysops ONLY - no other users
  1582. 80: Celerity Support      ---   Celerity Sysops ONLY - no other users
  1583. 254: CelerityNet management--   Complaints about net quality, etc.
  1584.  
  1585.  
  1586. Discussion subs:  These are various non-computer subs.
  1587.  
  1588. 2:  Buy / Sell            ---   A marketplace for all the CelerityNet boards.
  1589. 9:  News & Politics       ---   Political and world event conversation
  1590. 10: Entertainment         ---   Movie, Video, TV.
  1591. 16: Books & Literature    ---   For those few pirates out there who are literate
  1592. 21: Sports                ---   Discussion of sports
  1593. 25: Music                 ---   Discussion of music, concerts, etc.
  1594. 40: Philosophy & religion ---   Philosophical & religious discussion
  1595. 41: Auto Enthusiasts      ---   Cars & racing
  1596. 42: Video Games           ---   Video game machines
  1597. 46: RPG                   ---   Discussion of Role Playing Games
  1598. 47: Jokes & Riddles       ---   Jokes
  1599. 255:Private NetMail       ---   Network private email
  1600.  
  1601. Technical / Computer subs:  These are mainly technical bases or bases dealing
  1602.     with computer-related topics.
  1603.  
  1604. 5:  BBS Discussion        ---   This is for discussion regarding BBS programs.
  1605. 7:  Technical             ---   For all sorts of technical discussion/questions
  1606. 11: Amiga                 ---   Network Amiga discussion for all Amiga boards
  1607. 12: OS/2                  ---   Information regarding OS/2 and Applications.
  1608. 13: Windows 3.0           ---   Windows 3.0 and Applications
  1609. 14: Multitasking          ---   Discussion of DesqView, VM386, etc.
  1610. 17: CD ROM                ---   General programming - whatever language.
  1611. 20: UNIX                  ---   UNIX / XENIX discussion
  1612. 22: LAN / Networking      ---   Technical discussion regarding networking
  1613. 23: Music & MIDI          ---   Technical discussion about MIDI
  1614. 27: Pascal Programming    ---   Pascal programming
  1615. 28: C Programming         ---   C programming
  1616. 29: Assembly Programming  ---   Assembly programming
  1617. 35: Macintosh             ---   Discussion of the Mac platform
  1618. 36: BBS Programming       ---   Hints/help on making a BBS
  1619. 37: Graphic Programming   ---   Loaders/graphic demos/etc programming
  1620. 38: Shareware             ---   PD/Shareware/Public Domain software
  1621. 43: Adventure Games       ---   Adventure game tips
  1622. 93: Public Vision-X       ---   Discussion of Vision-X for V-X boards
  1623.  
  1624.  
  1625. More conferences will be added in the future as they are needed.  Let
  1626. me know if there is one you wish to see.
  1627.  
  1628.  
  1629. Appendix G-1:  FidoNet Compatibility
  1630. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1631.  
  1632. This appendix is divided into three sections:
  1633.  
  1634. I    General notes & FrontDoor setup instructions by Brendon Woirhaye
  1635. II   Step-by-step instructions for using FrontDoor by Extreme A.I.
  1636. III  Guide to setting up Celerity with D'Bridge by Willy Wonka
  1637.  
  1638. I    General Notes and Setup
  1639. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1640. By Brendon Woirhaye
  1641.  
  1642. Celerity v1.40 brings compatibility with Fido-type echomail networks.  To set
  1643. up such a network, you will need to set up a front-end mailer such as
  1644. FrontDoor, Binkley, or D'Bridge.  Additionally, you will need to use a
  1645. tosser/scanner such as Tosscan or Confmail to toss the messages.
  1646.  
  1647. DO NOT ASK ME QUESTIONS ABOUT FRONT-END MAILERS OR TOSSER/SCANNERS.  I am not
  1648. an expert on these products by any means, and I do not intend to assist
  1649. Celerity sysops in their use.  There will be some people on the net who are a
  1650. much better authority on the matter than I am.
  1651.  
  1652. Comments about the Fido handling are welcome, but I will not abide with
  1653. incessant bitching about this or that.  This is intended to be functional, but
  1654. will not be extremely extensive.
  1655.  
  1656. To set up a Fido-type net with Celerity, I recommend that you get FrontDoor
  1657. (or whatever mailer you use) working completely with the network(s) of your
  1658. choice.  The moderator (or hub) of the network you join should be able to help
  1659. you with this.  Don't ask me about it, because Frontdoor has nothing to do
  1660. with Celerity, and I do not support it.
  1661.  
  1662. The second step is to get your tosser/scanner working correctly.  All incoming
  1663. messages should be placed into a subdirectory tree where they can also be
  1664. found by Celerity.  Each echo must have its own subdirectory.  My structure
  1665. looks like:
  1666.  
  1667. c:\net\
  1668.        ansi\
  1669.        cdrom\
  1670.        cars\
  1671.  
  1672. and so forth.  My tosser/scanner (Tosscan) looks for new messages in these
  1673. directories, and places incoming messages in them.
  1674.  
  1675. The third step would be to set up some subs in Celerity specifying a Fido-type
  1676. network for the sub, and specify the subdirectories on the disk you have set
  1677. up.  When you set up a sub for fido, you will be asked for the subdirectory,
  1678. an origin line (this is a 30-character comment which will be appended to your
  1679. BBS name after the message's tear line.  The origin line may be seperate for
  1680. every sub, although we recommend that you use the same one for all your subs),
  1681. and your net address.  Your net address will be given in four sections: your
  1682. zone, net, node, and point.  These will all be determined for you by your
  1683. network moderator.
  1684.  
  1685. When posts are made on a Fido sub, they will be posted on the sub, then will
  1686. be written to a .msg file in the specified subdirectory (the first name will
  1687. be 2.msg, and they will increment from there).  You may run your scanner after
  1688. every Celerity call, or only before you export messages.  The command for
  1689. tosscan would be "tosscan scan".
  1690.  
  1691. After your mailer has received new messages,  you will need to use your tosser
  1692. to "toss" the messages.  The tosscan command is "tosscan toss".  After the
  1693. tosser tosses messages to the subdirectories (specified in the tosser setup),
  1694. you will need to make Celerity toss the messages.  There are two ways of doing
  1695. this.  The first is to hit Alt-F2 from the WFC screen, and the other way is to
  1696. pass a command-line parameter to Celerity.  The syntax for the latter is
  1697. "Celerity Toss".  This second method would be helpful to automate the process
  1698. after receiving new messages.  Note that tossing can take a VERY long time,
  1699. depending on the size of your conference and the number of messages being
  1700. tossed.  This is due mostly to the old inefficient storage methods being used
  1701. by Celerity (and every other Forum decendant to my knowledge).  It will be
  1702. improved upon in the future.
  1703.  
  1704. When tossing, Celerity will ignore messages which have the "local" flag set
  1705. (indicating a message which has been written but not yet sent).  Messages
  1706. which have the "sent" flag set will be deleted, but not imported.  A message
  1707. with a title of "Scan mark, ignore." - something used by Tosscan (whether
  1708. other mailers use this or not, I do not know) - will be deleted and not
  1709. imported.
  1710.  
  1711.  
  1712. I would like to thank Extreme A.I. for his extensive work on routines and code
  1713. for the Celerity mail handling, and his assistance in debugging and
  1714. implementing the feature.  Thanks to Mobius for sitting down with me and
  1715. figuring out what we needed to do (and then leaving me to do all the work!).
  1716. A nod must also go to R. Bubba Magillicutty who began the Celerity Fido
  1717. project nearly two years ago, although it didn't go anywhere.  I also thank
  1718. Force Ten - the moderator of a network for helping me through Frontdoor and
  1719. Tosscan, and for his assistance in getting things functioning.  Lastly, I
  1720. thank Jawbreaker for allowing me to get a net feed off his BBS.
  1721.  
  1722.  
  1723. II   Setting up with FrontDoor
  1724. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1725. By Extreme A.I.
  1726.  
  1727. As of version 1.40 Celerity BBS now supports the FidoNet networking system.
  1728. This opens a new world of nets for the sysop to join.. Please note that The
  1729. Byter has nothing to do with these nets, and you will have to find and contact
  1730. the Net Hub nearest to you to get a node number.
  1731.  
  1732. These docs assume you have Front Door setup on your system, and use Tosscan
  1733. as your tosser.  Front Door has good documentation, and if you need help
  1734. setting it up, refer to the docs. You must also be setup for a node number,
  1735. and have a list of the subs you will be recieving.
  1736.  
  1737. The first step to setting this up, is to figure out what subs you will be
  1738. using. Lets say the node number assigned to you is 1:323/2123 and you have
  1739. decided to recive "PASCAL","CFORSALE", and "323SYSOPS".
  1740.  
  1741. Next make those directories of off your Celerity directory. (If you plan on
  1742. carring multiple nets, it may be wise to put them in a subdirectory named
  1743. FIDONET first.) So you'd create "F:\CELERITY\PASCAL" for example. Do this for
  1744. all your directories.
  1745.  
  1746.   Now that you know your node number and the subs you want, go into Celerity.
  1747. Logon localy, and go to the message bases. Say your gonna put PASCAL in
  1748. confrence #3, your technical conference. Go there, and create a new base. Set
  1749. the area name and all that stuff like you normaly do. When you get to "Net
  1750. Options" choose it, and choose FidoNet. When it asks you for the directory,
  1751. say F:\CELERITY\PASCAL\ or whatever it was that you called the directory. It
  1752. will then as you for you Zone number. That will be "1", your Net number will
  1753. be "323" and you node number will be "2123" ignore the point value. Just put
  1754. "0".  Repeat this for all of the areas you will be reciving.
  1755.  
  1756. Next go into TOSSCAN's config and set up the areas. Refer to TOSSCAN's
  1757. documentation for help. It is a menu driven program, and much easier to setup
  1758. than most others.
  1759.  
  1760. Now that your all setup, we need to setup some events, and a batch file. I'll
  1761. explain this in two parts. First for people who wish only to use the front
  1762. door during national mail hour (4 to 5 am EST, 1 to 2 am Ca time).
  1763.  
  1764.   Go into Celerity. Set your external batch even for 4am EST. Create/Edit your
  1765. batch file to change to your Front door directory and call "FDBBS.BAT". Go
  1766. into front door's config, set the exit on mail level to 100, and Mail only to
  1767. yes. You will also have to set up an external even to exit to dos at 5am EST
  1768. with whatever errorlevel you want. and another from 4 to 5 am to poll all
  1769. nodes. (Again refer to Front Door's documentation on how to setup Events)
  1770.  
  1771. Have the FDBBS.BAT be the following.
  1772.  
  1773. @ECHO OFF
  1774. Set FD=F:\FD
  1775. :Loop
  1776. CD\FD
  1777. FD
  1778. If Errorlevel 100 goto TOSS
  1779. Goto DONE
  1780. :TOSS
  1781. TOSSCAN TOSS
  1782. CD\CELERITY\NODE1
  1783. CELERITY TOSS
  1784. GOTO LOOP
  1785. :DONE
  1786.  
  1787. Now edit your MAIN.BAT file for celerity so that after celerity exits, it does
  1788. TOSSCAN SCAN.
  1789.  
  1790. Now for the Crashmail system (Front door up 24 hours a day).  Go into Front
  1791. doors config, setup Mail only to NO. Also you will need to setup a couple
  1792. events to poll for mail, and one to exit to dos at around 3 am.. (refer to the
  1793. FD docs for help). Have the External event exit with error level 50, and set
  1794. all the exit on call to errorlevel 99. And mail to 100.
  1795.  
  1796. Your FDBBS.BAT should read
  1797. @Echo off
  1798. Set FD=F:\FD
  1799. Set DSZLOG=F:\CELERITY\NODE1\DSZ.LOG
  1800. :LOOP
  1801. CD\FD
  1802. FD
  1803. IF ERRORLEVEL 99 goto CALLER
  1804. IF ERRORLEVEL 100 GOTO MAILIN
  1805. IF ERRORLEVEL 50 GOTO EXEVENT
  1806. Goto Done
  1807. :CALLER
  1808. CD\Celerity\Node1
  1809. CELERITY EXIT
  1810. TOSSCAN SCAN
  1811. Goto Loop
  1812. :MAILIN
  1813. TOSSCAN TOSS
  1814. CD\CELERITY\NODE1
  1815. CELERITY TOSS
  1816. Goto Loop
  1817. :EXEVENT
  1818. ECHO Forcing CelerityNet Call
  1819. CD\Celerity\Node1
  1820. CELERITY NET
  1821. ECHO Other nightly shit should go here
  1822. GOTO LOOP
  1823. :DONE
  1824.  
  1825. Thats all there is to it. If you want (Though this isn't required) you can
  1826. setup celerity to identify the exact baud rate the call is coming in at, by
  1827. setting the different Caller errorlevel to indivudal values and calling
  1828.  
  1829. CELERITY 38400 <BPSRATE>
  1830. So if a call was at 9600 you'd call it
  1831. CELERITY 38400 9600
  1832. etc..
  1833.  
  1834. Thats all there is to it. Though these docs are in no way thourough, FidoNet
  1835. is one of the hardest things in existance to setup, and I'm am no about to
  1836. attempt to write docs on how to setup the net. Just how to get Celerity hooked
  1837. up in it. There are several documents (most well over 200k) attempting to
  1838. explain how to get the net setup, so if you have any problems, find on of
  1839. those, or ask a local FidoNet board for help.
  1840.  
  1841. I'd like to make one further note. Although Celerity attempts to sniff out
  1842. local posts, it can't always distingush between local and incoming posts
  1843. (especialy if you use a Tosser/Scanner other than TOSSCAN) so it may be a good
  1844. idea to setup CLRFIDO.EXE. This program quickly deletes all posts in your fido
  1845. directories, preventing duplicate incoming posts. Just insert it after the
  1846. TOSSCAN SCAN commands.
  1847.  
  1848.  
  1849. III  Setting Up With D'Bridge
  1850. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1851. By Willy Wonka
  1852.  
  1853.    The following is the Batch file I use to run Celerity and D'Bridge, You
  1854. must also setup schedule events for your maintance files and backup. D'Bridge
  1855. takes you connect rate and divides it by 100. For instance a connect rate of
  1856. 14400 would return a result code of 144, a connect rate of 9600 would be 96,
  1857. and so on.
  1858.    D'Bridge is a lot more automated than Frontdoor and will do most of your
  1859. stuff for you where as Front Door you have to do alot of stuff Manually. The
  1860. hardest part of D'Bridge is making your batch file to start it, Which is why
  1861. I've included most of mine in here.
  1862.    For events just go to the schedule events screen from D'Bridge and set all
  1863. events for errorlevels in your startup.bat with the command *Xerrorlevel. For
  1864. the net I use *X83 which exits D'Bridge and go's to the startup.bat and finds
  1865. errorlevel 83. You should also setup all your maintance and backup events the
  1866. same way.
  1867.    You also can setup your function keys with the *Xerrorlevel for your term
  1868. program and anything you like. Just go into Fuction Key setup from D'Bridge by
  1869. hitting the esc key once it's loaded and setup all function keys with
  1870. errorlevels. I've found that if you do drops to dos, alot of times you won't
  1871. have enough memory free to do everything you need.
  1872.    There is still a lot not included here, but with D'Bridge you can look it
  1873. up in the docs and it's real easy to follow.  This is only the bare minimum
  1874. you need to know to use D'Bridge with Celerity.
  1875.  
  1876.  
  1877. @ECHO OFF
  1878. CD\DV                                        ;Where I have Desqview
  1879. DVANSI                                       ;So Ansi screens show right
  1880. CD\
  1881. :==========================================:
  1882. : Batch File That Runs The Isle Completely : ;The Begining
  1883. :==========================================:
  1884. :begin
  1885. cls
  1886. set DSZPORT=2                                ;What Comport I'm using
  1887. SET DSZLOG=C:\CELERITY\DSZ.LOG               ;Where DSZlog is set to
  1888.  
  1889. :================:
  1890. : Start D'Bridge :                           ;For D'Bridge
  1891. :================:                        
  1892.  
  1893. :Dbridge
  1894. cls
  1895. echo Starting DBridge With Celerity
  1896. c:
  1897. cd \db                                       ;Where D'Bridge is located
  1898. db                                           ;To start D'Bridge
  1899.  
  1900. if errorlevel 384 goto 38400_Baud            ;Errorlevel for 38400 Baud
  1901. if errorlevel 192 goto 19200_Baud            ;Errorlevel for 19200 Baud
  1902. if errorlevel 144 goto 14400_Baud            ;Errorlevel for 14400 Baud
  1903. if errorlevel  96 goto 9600_Baud             ;Errorlevel for 9600  Baud
  1904. if errorlevel  83 goto thenet                ;Errorlevel to run the net
  1905. if errorlevel  50 goto qmodem                ;Errorlevel to run Qmodem
  1906. if errorlevel  40 goto localbbs              ;Errorlevel for local mode
  1907. if errorlevel  24 goto 2400_Baud             ;Errorlevel for 2400  Baud
  1908. if errorlevel  10 goto End                   ;Errorlevel for Exit
  1909. goto end
  1910.  
  1911. :38400_Baud
  1912. SET DSZLOG=C:\CELERITY\DSZ.LOG               ;Must reset DSZ.log if multinode
  1913. cd\celerity                                  ;Where Celerity is located
  1914. celerity link 38400 38400                    ;Linking Celerity with 38400 DTE and 38400 Baud
  1915. goto After_bbs                               ;Going back to D'Bridge
  1916.  
  1917. :19200_Baud                                  
  1918. SET DSZLOG=C:\CELERITY\DSZ.LOG               ;Must reset DSZ.log if multinode
  1919. cd\celerity                                  ;Where Celerity is located
  1920. celerity link 38400 19200                    ;Linking Celerity with 38400 DTE and 19200 Baud
  1921. goto After_bbs                               ;Going back to D'Bridge
  1922.  
  1923. :14400_Baud                                  ;For 14400 logons
  1924. SET DSZLOG=C:\CELERITY\DSZ.LOG               ;Must reset DSZ.log if multinode
  1925. CD\CELERITY                                  ;Where Celerity is located
  1926. CELERITY LINK 38400 14400                    ;Linking Celerity with 38400 DTE and 14400 Baud
  1927. goto After_bbs                               ;Going back to D'Bridge
  1928.  
  1929. :9600_Baud                                   ;For 9600 logons
  1930. SET DSZLOG=C:\CELERITY\DSZ.LOG               ;Must reset DSZ.log if multinode
  1931. cd\celerity                                  ;Where Celerity is located
  1932. celerity link 38400 9600                     ;Linking Celerity with 38400 DTE and 9600 Baud
  1933. goto After_bbs                               ;Going back to D'Bridge
  1934.  
  1935. :2400_Baud                                   ;For 2400 logons
  1936. SET DSZLOG=C:\CELERITY\DSZ.LOG               ;Must reset DSZ.log if multinode
  1937. cd\celerity                                  ;Where Celerity is located
  1938. celerity link 38400 2400                     ;Linking Celerity with 38400 DTE and 2400 Baud
  1939. goto After_bbs                               ;Going back to D'Bridge   
  1940.  
  1941. :Localbbs                                    ;For Local Logons
  1942. SET DSZLOG=C:\CELERITY\DSZ.LOG               ;Must reset DSZ.log if multinode
  1943. cd \Celerity                                 ;Where Celerity is located
  1944. Celerity 38400                               ;Loads Celerity at WFC Menu
  1945. goto After_bbs                               ;Going back to D'Bridge
  1946.  
  1947. :Qmodem                                      ;Is my F2 Key must setup with X@errorlevel
  1948. c:                                           ;drive
  1949. cd\qmodem                                    ;Where Qmodem is located
  1950. qmodem                                       ;Runs qmdoem
  1951. goto Done                                    ;Going back to D'Bridge
  1952.  
  1953. :thenet                                      ;setup in events to run
  1954. SET DSZLOG=C:\CELERITY\DSZ.LOG               ;Must reset DSZ.log
  1955. cd\celerity                                  ;Where Celerity is located
  1956. celerity net                                 ;Command for the net
  1957. goto After_bbs                               ;Going back to D'Bridge
  1958.  
  1959. :After_bbs                                   ;Could really do without                                  
  1960. goto done                                    ;Going back to D'Bridge
  1961.  
  1962. :Done
  1963. c:                                           ;Drive
  1964. goto DBridge                                 ;Going back to D'Bridge
  1965.  
  1966. rem Come here on bad errors or to exit       ;For exiting
  1967. :end
  1968. c:
  1969. cd\
  1970. cls
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976. Appendix H:  A Celerity Demonstration
  1977. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1978. Celerity is distributed in a form which may be run as a demonstration.
  1979. It is fully functional, other than a 10-user limit and the sysop must
  1980. go by the name of "Abdul Clamwacker".  The purpose of the demo is to
  1981. allow potential sysops to look a fully functional system over and get
  1982. a feel for the sysop-side features.  Additionally, the sysop can run
  1983. the demo for a few days while his registration is in the mail.
  1984.  
  1985.  
  1986.  
  1987. Appendix I:  Multi-node Operation
  1988. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1989. With version 1.20 comes the basis for multinodal operation for Celerity.  Each
  1990. node runs as a seperate task under a multitasking operating environment such
  1991. as DesqView, Windows, PC-MOS, VM/386, or OS/2 2.0's DOS compatibility box.
  1992. You may also use a local area network (LAN) and use a seperate computer for each
  1993. node.
  1994.  
  1995. To add an additional node to a system set up for one node, you must make as many
  1996. additional node directories as you require, one for each additional node.  In
  1997. this directory, you must copy the following files:
  1998.  
  1999. CELERITY.EXE    CELERITY.OVR    CONFIG.EXE      CONFIG.OVR      KAU.CFG
  2000. MAIN.BAT
  2001.  
  2002. Switch to this directory and run config.  Use the same setup as you had for the
  2003. first (main) node, but change the node directory to the current directory you
  2004. are in.  Change the BBS node number as well.
  2005.  
  2006. When you put the system up, switch to the node directory and run the MAIN.BAT
  2007. file (which may need some modification if you are using pathnames in it).  Go
  2008. to each additional node (in seperate tasks) and run the main.bat files for each
  2009. node.  The system should now be up and running in a multinodal environment.
  2010.  
  2011. On a multi-node system, users can enter the multinode chat and talk to other
  2012. users who may be on other nodes at the time.  Up to 8 users may use the
  2013. chat at a time.
  2014.  
  2015. If you run Celerity under DesqView, please view Appendix N below.
  2016.  
  2017.  
  2018.  
  2019. Appendix J:  Sysop-definable Files
  2020. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2021. There are certain files which reside in the TEXT directory which the sysop can
  2022. (and is encouraged to) modify to meet the needs of his or her own system.
  2023.  
  2024. Some of these files are:
  2025.           
  2026.                   Assorted Message Files: These have no extension.
  2027.  
  2028. Sysoplst      --  Displayed to a user leaving feedback.  This should
  2029.                   list the various sysops and who is responsible for
  2030.                   what.  If this file does not exist, a list of all
  2031.                   users with sysop flag #8 set is printed.
  2032. Donation      --  Displayed to a user with the $ command.  Usually contains the
  2033.                   board's donation policy.
  2034. Goodbye       --  Displayed to all users when they log off.  Often a list of
  2035.                   other BBS' the system recognizes.
  2036. Newuser       --  When new users log on, this file is displayed.  It usually
  2037.                   tells a bit about the system and the requirements for access.
  2038. Nicetry       --  If a user messes up on a password three times, they will be
  2039.                   logged off and displayed the file.  It usually contains a
  2040.                   message to the effect of "If you were a new user, you aren't
  2041.                   wanted here.  If you're a hacker, screw off".  Not that a
  2042.                   nasty message will stop a hacker.
  2043. Nuke          --  Displayed when the sysop deletes an online user.  Often a
  2044.                   nasty message is appropriate here.
  2045. RaiseReq      --  This file is displayed to a user who is requesting an
  2046.                   access raise.  The format is as follows:  A number of lines
  2047.                   of text, unlimited in length, followed by additional notes
  2048.                   depending on the user's current level.  To add additional
  2049.                   notes, enter a period on a blank line, and the level range
  2050.                   on the next line (ie: 0-9, 10-50, etc.), followed by the
  2051.                   text for that level.  As many entries as there are levels
  2052.                   are permitted.
  2053. Summon        --  Text displayed to the sysop when chat call is activated.
  2054.                   Often something short and one-line is sufficient.
  2055. Timesup       --  Text displayed to user when they run out of time while logged
  2056.                   on.
  2057.  
  2058.                   .BBS Files.  You may include *.ASC versions without color,
  2059.                   and .TXT files for users without IBM ASCII.
  2060.  
  2061. CAEINTRO.BBS  --  File displayed to users logging onto a CAE system
  2062. validud.bbs   --  validation upload text
  2063. Preshell.bbs  --  A file which is displayed before the shell is entered
  2064. Othersys.bbs  --  A message which is displayed when the user is kicked off the
  2065.                   normal system and given the password to system 2 or 3.
  2066. Denied.bbs    --  A message displayed to a user who has been denied access in
  2067.                   the new user voting section.
  2068. Feedback.BBS  --  Message a new user gets indicating them to leave feedback to
  2069.                   the sysop after applying for access.
  2070. Prelogon.BBS  --  Text displayed after a user has given the command to enter
  2071.                         system 1 from the shell.
  2072. Changes.BBS   --  Quick "news brief" displayed AFTER prelogon.BBS, and before
  2073.                   the user enters his/her handle/password etc.  This should
  2074.                   not be more than one line, and may be ommitted altogether if
  2075.                   there is no special news (appropriate news would be "Please
  2076.                   fill out the first infoform.  Skip the rest.".  Inappropriate
  2077.                   news would be "Hard disk crash.  Userlist lost.  Log on new."
  2078.                   Because of Celerity's Auto-backup feature, there is NEVER any
  2079.                   excuse for loosing a userlist.
  2080. Ad.BBS        --  This is displayed when a user hits & from the main menu.
  2081.                   This can be an ad for the software, or can be changed to some
  2082.                   other text.
  2083. Blacklst.BBS  --  Displayed when a user tries to log on new, and has been
  2084.                   blacklisted from your system.  See BLACKLST. Below.
  2085. Prot_S.BBS    --  A menu of the available (non-batch) download protocols
  2086. Prot_R.BBS    --  A menu of the available (non-batch) upload protocols
  2087. Prot_D.BBS    --  A menu of the available batch download protocols
  2088. Prot_U.BBS    --  A menu of the available batch upload protocols
  2089.  
  2090.  
  2091.                   Other Files:  See notes with each individual file.
  2092.  
  2093. Download.Txt  --  Displayed when a user downloads from the system.
  2094. Upload  .txt  --  Displayed before a user uploads.
  2095.  
  2096. Shell.?       --  These are alternate "menus" displayed in the logon
  2097.                   shell when users request help.  Shell.1 replaces the
  2098.                   menu shell's help, Shell.2 is displayed when a user
  2099.                   types "dir" in the DOS shell, Shell.3 is displayed
  2100.                   in the VMS shell, and so on.
  2101.  
  2102. Xfernews.*    --  Xfernews.confnum is displayed when a user enters the xfer
  2103.                   section of conference #confnum.
  2104.  
  2105. Filearea.*    --  Replacement for the file area listings.  Extension refers to
  2106.                   the conference number.
  2107.  
  2108. Subs.*        --  Replacement for the sub-board listings.  Extension refers to
  2109.                   the conference number.
  2110.  
  2111. Blacklst.     --  This file has NO extension.  It contains a list of handles
  2112.                   which you do not want admitted to your system.  If a user
  2113.                   is listed here, they will be displayed the Blacklst.BBS file
  2114.                   when they log on new.
  2115.  
  2116. *.WEL         --  ANSI welcome screens are displayed to the user upon login
  2117.                   if the welcome event is scheduled in the login sequence
  2118.                   configuration.  One file will be picked at random from the
  2119.                   TEXT directory.  There may be up to 100 *.WEL files in the
  2120.                   directory (if you have over 100, the others will be ignored).
  2121.                   The prefix can be any 8-letter name.
  2122.  
  2123. *.WAS, *.WTX  --  These are also welcome files.  A .WAS extension denotes an
  2124.                   8-bit ASCII file, a .WTX extension refers to a 7-bit ASCII
  2125.                   file (no IBM ASCII characters).  Again, you may have up to
  2126.                   100 such files in the text directory.
  2127.  
  2128. *.WNA         --  The .WNA extension specifies a NAPLPS welcome file.
  2129.                   If the user has a NAPLPS terminal program and has the
  2130.                   NAPLPS emulation in Celerity turned on, these files
  2131.                   will be displayed.
  2132.  
  2133.  
  2134. Lognstat.*    --  }
  2135. Userstat.*    --  }  See Appendix F on "Sysop configurable Status Screens"
  2136. Xferstat.*    --  }
  2137. Yourstat.*    --  }
  2138.  
  2139.  
  2140. Menus:  There are four types of menu files, ending with an .ANS suffix
  2141. for ANSI, .ASC for IBM ASCII, .NAP for NAPLPS, and .(nothing) for
  2142. conventional ASCII.  Menus may all be edited at the sysop's convenience.
  2143. Inside the Celerity supplement files, and on the Celerity support BBS
  2144. are a number of complete menu sets.
  2145.  
  2146.  
  2147. Appendix K: CAE Mode
  2148. ---------------------------------
  2149.      The CAE (Celerity ASCII Express) is a return to the ideal of the 
  2150. "no pass AE" or "password AE" of the Golden Age.  The CAE asks for a user's 
  2151. handle and area code upon login, but this information is kept only in the 
  2152. system logs, as Celerity saves no user account information.  Once this 
  2153. information is established, the user is given complete homogenous access to 
  2154. the transfer areas, being able to download whatever he or she pleases, with 
  2155. no obligation to upload.
  2156.      What's the purpose? There could be several reasons for running a CAE.
  2157. File distribution is one.  Users uploading to a CAE system may get the
  2158. file downloaded freely by callers and spread across the nation in a few days,
  2159. spreading it much more quickly than via conventional channels.  Or, if you
  2160. run a BBS for your business or wish to distribute files free of charge, the
  2161. CAE mode would be ideal.
  2162.      
  2163. [Characteristics]
  2164.      As stated above, a CAE system is a transfer system only.  No messages,
  2165. user accounts, email, ratios, or other conventional BBS features other than
  2166. the transfer section.  All callers are given the same access and the same
  2167. online time.
  2168.  
  2169. [Tips for running in CAE mode]
  2170.      The CAE is an open access system, meaning anyone can get on at any
  2171. time.  One way to limit access from anyone with your number is to
  2172. enable the System 1 password in SETUP.  After connection, the user will
  2173. first be prompted for the password, then normal logon procedures occur, 
  2174. thereby limiting access to the specific audience of users whom you   
  2175. advertise to.
  2176.  
  2177.      The transfer area structure is the same as in normal Celerity operation,
  2178. except for a few commands.  The Q (quit to main), M (message areas), and J
  2179. (jump conference) commands cause instant logoff, as these functions are 
  2180. not enabled in the CAE.  To account for this, simply install the CAE/TAC menus
  2181. (CEL13xT.ZIP) on your system, as they will work for CAE mode with little or no
  2182. change.
  2183.  
  2184.      As the CAE utilizes only the transfer areas, there isn't an message 
  2185. base, automessage, or news file to get information to your users. Use
  2186. the XFERNEWS.1 or CAEINTRO.ANS files to pass information along to users
  2187. after login.
  2188.  
  2189. [Registration]
  2190.      To activate the CAE mode, switch the BBS mode to CAE in SETUP.  We ask 
  2191. a non-mandatory registration fee of $10 for a registered copy, and that 
  2192. $10 fee can be put towards a future standard Celerity purchase if desired
  2193. (the standard Celerity registration permits CAE use as well).  The only 
  2194. difference between a registered and non-registered CAE system is that sysops
  2195. must hit Alt-T every call on the local keyboard to enable sysop access with 
  2196. the non-registered copy.
  2197.  
  2198.  
  2199. Appendix L: CAE/TAC Mode
  2200. ----------------------------------------
  2201.      The CAE/TAC (Total Access Control) mode is related to the CAE mode 
  2202. (see Appendix K), but with one major difference - it has individual user
  2203. accounts.  This allows more control by the sysop over who gets access (and
  2204. what type of access) to the system.
  2205.  
  2206. [Characteristics]
  2207.      The CAE/TAC system looks like a CAE system from the users' point of 
  2208. view, and a normal BBS from the sysop's, since the sysop must have access 
  2209. to the sysop menu in order to edit user accounts.  All functions are similar 
  2210. to the CAE mode, with the following exceptions:
  2211.  
  2212.      Since user accounts exist, the Top Ten function can be enabled in 
  2213. SETUP.  Users must login in as new on the first call, so information scripts
  2214. may be present, and the new user feedback option can also be enabled.  The
  2215. system can have a co-sysop, since a specific user's access can be adjusted.
  2216. Any user with co-sysop level priviledges logs onto the normal main board like
  2217. the sysop (as opposed to the transfer area restriction placed on all other
  2218. users).
  2219.  
  2220.      The CAE/TAC system utilizes the message bases and email as well.  Email 
  2221. to users is allowed in this mode - if mail exists for the user, the user is
  2222. first placed into the email section, and then, upon exit, the user enters
  2223. into the CAE system's transfer area.
  2224.  
  2225.      Since you control access levels, you control what the user can do.  The
  2226. amount of online time each user has per day is controlled via the general
  2227. access level, while the specific file areas each user has access to is
  2228. controlled via the xfer access level.  This is helpful to separate the major
  2229. contributors from the average users, or to limit access to certain file areas.
  2230.  
  2231. [Tips for running in CAE/TAC mode]
  2232.      Since a new user must apply for access, it is a good idea to activate a
  2233. login shell, such as the lightbar menu shell.  This way, a new user can find
  2234. he or her way easily enough.  You can also enable other login shell functions,
  2235. such as feedback and chat, so users can contact you.
  2236.  
  2237.      Since the whole board is actually utilized, install any of the wide
  2238. variety of menus available for Celerity, then install the CAE/TAC menus over
  2239. them.  This way, you have your menus, and the users have theirs.
  2240.  
  2241.      With TAC mode, you completely control what users can access the system.
  2242. Use the information scripts and new user feedback to gather complete
  2243. information on an applicant if this precaution is waranted.
  2244.  
  2245.      It is recommended you create your own statistics files (see Appendix F)
  2246. because Celerity's internal displays contain information that the user doesn't
  2247. need, such as new posts, ratios, file points, commission points, etc. Since
  2248. the system is still basically a CAE, this information is meaningless and can
  2249. only confuse new users.  Note that file points, commissions, and ratios CAN be
  2250. enabled for the CAE/TAC.
  2251.  
  2252.      The AUTO.MSG file is an excellent way to communicate policies and to
  2253. pass on information to your users.  PRELOGIN.BBS is also helpful (when the
  2254. login shell is enabled), but can be viewed by anyone calling in, not just
  2255. validated users.  News bulletins are not viewed by the users.
  2256.  
  2257.      Since the message area exists to the sysops and co-sysops, this is a good
  2258. area for a Sysop conversation base, as no user can ever access it.
  2259.  
  2260. [Registration]
  2261.      To activate the CAE/TAC mode, switch the BBS mode to CAE/TAC in SETUP. We
  2262. ask a fee of $25 for a registered copy, and that $25 fee can be put towards a
  2263. future standard Celerity purchase if desired (the standard Celerity
  2264. registration permits CAE/TAC use as well).  Running an unregistered version
  2265. allows a maximum of 15 users, while registration increases this to the 500
  2266. user maximum utilized by standard Celerity registration.
  2267.  
  2268.  
  2269. Appendix M:  QWK Offline Readers
  2270. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2271.         Version 1.39 of Celerity / Alacrity contains provision for the
  2272. creation of packets of messages which can be read with any QWK-compatible
  2273. offline reader. This allows users to quickly log on, create and download a
  2274. packet containing all their new messages, log off, and read the messages at
  2275. their leisure without incurring phone costs while connected.  When the user
  2276. responds to messages, a REP response packet is created, and the user can
  2277. upload it to a Celerity board for processing.
  2278.  
  2279.         When the sysop sets up his system, there are a couple files that
  2280. should be created for the QWK function to work correctly.  These files include
  2281. the following (all are stored in the main BBS directory):
  2282.  
  2283. WELCOME .OFF  -  Displayed when a user enters the offline reader.
  2284. NEWS    .OFF  -  Displayed in the "News" option for most readers.
  2285. BYE     .OFF  -  Displayed when a user leaves the offline reader.
  2286. BLT-0   .?    -  Bulletin files.  First is BLT-0.1, second BLT-0.2, etc.
  2287.  
  2288. Be sure to have PKZIP in your path.
  2289.  
  2290. Some recommended offline readers include Offline Express (OLX), Qmail Deluxe,
  2291. KingQWK, Silly Little Mail Reader (SLMR), 1stReader, BlueWave, WinQWK,
  2292. Session Manager, and dozens of others.
  2293.  
  2294.  
  2295. Appendix N:  Celerity Under DesqView
  2296. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2297.   It is quite easy to run multiple Celerity nodes under DesqView, but you must
  2298. have several things on your system to do it.  It is quite picky about the
  2299. setup of the system when you try to run both nodes on one system.  You cannot
  2300. run more than 2 nodes on one system because of a limitation explained in the
  2301. next paragraph.  Also, it would probably go too slow unless you had a 486
  2302. system or something.
  2303.  
  2304.    You need two serial ports on COM1 and COM2 with COM1 using IRQ 4 and
  2305. COM2 using IRQ 3.  I know that it is supposed to work with other serial port
  2306. configurations, but I was unable to get those to work under DV.  If you use a
  2307. serial mouse, you must connect to COM3 using IRQ 5 or 7.  If your mouse driver
  2308. doesn't support strange COM port/IRQ combinations then you will have to get a
  2309. new mouse driver, get a bus mouse with IRQ 5 or 7 support, or do without a
  2310. mouse.  Both serial ports should be equipped with 16550AFN UART chips (or an
  2311. equivilent buffered UART), or you will lose data right and left.  It is
  2312. recommended that a fast 386 or 486 machine be used, and a static RAM cache is
  2313. advisable.  I use a 386/33 with 64k cache.  It slows performance down just
  2314. slightly when multitasking, but not enough to cause any problem.  File
  2315. transfer speeds are unaffected.
  2316.  
  2317.    To actually get Celerity to have 2 nodes, you must create 2 directories
  2318. under your main CELERITY directory.  I call them NODE1 and NODE2.  Copy the
  2319. following files from your main CELERITY directory to these subdirectories:
  2320. CELERITY.EXE, CELERITY.OVR, SETUP.EXE, SETUP.DAT, and NETSUBS.DAT.  Now you
  2321. must change each copy of Celerity so they can tell which node they are.  Go
  2322. into the Node1 directory, and run SETUP.  Change the "Specific Node Directory"
  2323. to your new Node1 directory.  Be sure you have a "Common Node Directory" set
  2324. correctly.  Celerity will use this to keep track of what is going on with the
  2325. other node, and for multinode chat.  Be sure all the COM port parameters are
  2326. set correctly for your COM1 port.  Go to BBS Node number and change it to 1,
  2327. for node 1.  Now save and exit.  Change to your Node2 directory, and run the
  2328. setup there.  Change the Specific Node Directory to the Node2 path.  Change
  2329. the COM port settings to your COM2 port.  Change BBS node number to 2 for node
  2330. 2.  If you have settings for CelerityNet calls, you will want to either turn
  2331. them off, or change them to another time of day so that both nodes won't be
  2332. trying to net call at the same time.  Be sure to leave Use CelerityNet on,
  2333. however, because you want users to be able to read Net posts, etc.
  2334.  
  2335.    Now create 2 batch files in place of your old Celerity startup batch
  2336. (commonly MAIN.BAT.) Copy your old startup Batch file to a file called
  2337. NODE1.BAT and also to NODE2.BAT.  Go into each batch file and have it change
  2338. the directory to your Node1 directory and your Node2 directory, respectively.
  2339. Change any other applicable directory settings.  Also add a line to the
  2340. beginning of the batch files that changes the DSZ log to a node-specific file.
  2341. SET DSZLOG=DSZNODE1.LOG is how I do it.  That way both nodes have their own
  2342. log file so when two transfers are in progress the log won't be overwritten by
  2343. the other node.  All you should have to do now is create two menu options in
  2344. Desqview to run these two batch files, and you'll be multinoding.
  2345.  
  2346.    You will want to allocate at least 512K for it to work.  You can have
  2347. Desqview load both nodes when started by creating a script macro that loads
  2348. both nodes automatically.  Then give it a name with an ! at the beginning and
  2349. it will execute that script every time Desqview is started.  You usually hit
  2350. Shift-Alt to access the script menu.  I have been able to get a Desqview
  2351. multinode board to run successfully, and am running one now. Feel free to call
  2352. my board if you would like to see how well it works or if you would like to
  2353. ask me a question.  It is MODular Madness, at 512-219-8045.
  2354.  
  2355. Good Luck,
  2356.  
  2357. Fatal Error
  2358.  
  2359.  
  2360.  
  2361. Appendix O      Running Celerity under a Local Area Network
  2362. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2363. The best way to use Celerity as a multi-node BBS is to run it on a network.  I
  2364. have used the software on Novell Netware 3.1 (dedicated host) and Netware Lite
  2365. (peer-to-peer) with no problems.  Artisoft's LANtastic causes some problems,
  2366. and should be avoided if possible.
  2367.  
  2368. With Netware, you must flag all Celerity data files as sharable.  With 3.1,
  2369. this command would be "flag *.* +s".  Flag the files in your BBS directory,
  2370. data directory, and message directory.
  2371.  
  2372.  
  2373. Appendix P      Running Celerity under OS/2 2.0
  2374. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2375. Celerity has been tested under OS/2 2.0, and seems to work quite well in
  2376. this environment.  However, there are a few simple modifications that
  2377. will be neccessary in order to get everything working correctly.
  2378.  
  2379. Under OS/2 MDVM's (Multiple Dos Virtual Machines) some communications
  2380. programs have trouble detecting the serial port's RING INDICATOR.  This
  2381. is the default method that Celerity uses to detect and answer an
  2382. incoming call.  The alternative to answering on Ring Detect, is to
  2383. answer on Carrier Detect.
  2384.  
  2385. Normally Celerity does not enable the AUTO ANSWER mode of your modem.
  2386. The primary advantage to this method (and the reason it is the default)
  2387. is that the modem nevers answers the call unless the BBS program is up
  2388. and running.  Once the modem's Auto Answer mode is turned on, your modem
  2389. will automatically send an answer carrier when the modem detects a ring.
  2390. Once a carrier is established, Celerity will detect that the modem has
  2391. connected, and bring up the login screen.
  2392.  
  2393. Turning on the Auto Answer is very simple.  Follow these four steps:
  2394.  
  2395.     1) Run Setup.
  2396.     2) Select "Modem Setup"
  2397.     3) Change the "Answer on Ring #" field from 0 (Zero) to 1 (one).
  2398.     4) Save the new settings.
  2399.  
  2400. Celerity will automatically send an inititialization string to put the
  2401. modem in Auto Answer mode.  If you have an external modem, you will see
  2402. that the Auto Answer indicator is ON.
  2403.  
  2404.  
  2405. Setting up your Celerity DOS Session under OS/2:
  2406.  
  2407. It is recommended that you create a new icon for the DOS session that
  2408. will run Celerity.  It is suggested that you use the following settings:
  2409.  
  2410. Path and file name:    *        - Run the default command interpreter.
  2411. Optional Parameters:    /K MAIN.BAT    - Start the MAIN batch file.
  2412. Optional Working Dir    C:\CELERITY    - Or whatever path you are using.
  2413.  
  2414. Using these settings OS/2 will start Command.Com and then run the
  2415. Celerity MAIN.BAT file.  Be sure to provide the path to the Celerity
  2416. directory in the Working Directory field.
  2417.  
  2418. OS/2 gives the user a lot of options for customizing the way a DOS
  2419. program runs.  The Dos Settings option for each DOS session has long
  2420. list of these options.  For best results, make the suggested changes to
  2421. the settings listed below.  Please note that these are only suggestions,
  2422. and can changed to suit your needs and preferences.
  2423.  
  2424. COM_HOLD                On.    This setting will protect the serial port.
  2425. DPMI_DOS_API         Off
  2426. DPMI_MEMORY_LIMIT       Zero,  Celerity does not use DPMI.
  2427. EMS_MEMORY_LIMIT     512K.  Celerity can use some EMS memory.
  2428. IDLE_SECONDS         Zero to start, raise to 1 or 2 if BBS is too slow.
  2429. IDLE_SENSITIVITY               75 to start.  Raise if BBS is too slow, lower if BBS is
  2430.                                slowing down other apps to much.
  2431. XMS_MEMORY_LIMIT     Zero, Celerity does not need any XMS.
  2432.  
  2433. Also keep in mind that a "Windowed" DOS session does not perform as well
  2434. as a full screen session.  It is best that you configure each Celerity
  2435. session to run in full screen mode.
  2436.     
  2437. One final note:  GET A 16550 UART!!!  Multitasking operating systems
  2438. such as OS/2 can really benefit from a buffered UART.  OS/2 will detect
  2439. and make full use of your 16550.  Although DOS programs like Celerity
  2440. will NOT report that a 16550 is found, they will receive the full
  2441. benefit of buffered I/O.
  2442.  
  2443.  
  2444. Appendix Q      Configurable menu scripting system
  2445. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2446. One of the new features of Celerity are the configurable menus.  Celerity will
  2447. allow the sysop to define each and every menu via the use of a simple yet
  2448. powerful menu definition file.  This file, CELMENU.INI, resides in your menu
  2449. directory. The following is an example of a menu specification from the
  2450. initialization file.  Please take note of the file format.  All text following
  2451. a semicolon (;) is considered a comment.
  2452.  
  2453. [New Mail]                     ; The identifying menu name
  2454. menufile=                      ; To specify an external menu file
  2455. menuprompt=Mail                ; Text for the menu prompt
  2456. V="View the mail", FN=1, XL=20, SL=20, AGE=18, BAUD=9600
  2457. S="Send A Letter", FN=2
  2458. F="Do Some Feedback", FN=3
  2459. O="Oh!  A Scan!", FN=4
  2460. T="Tell me what's waiting", FN=5,100
  2461. Q="Quit", FN=6
  2462. [END]                          ; End of the menu data object
  2463.  
  2464. As you can see, the first line of the menu data is the name of the menu -
  2465. enclosed in brackets [].  This is the default name of the menu as defined in
  2466. Celerity/Alacrity.  This name will be displayed to the user unless you use the
  2467. "menuprompt" command.  Speaking of which, all text following the "menuprompt="
  2468. command (see line 3 above) will be displayed to the user.  The "menufile="
  2469. command (see line 2 above) allows you to specify an external menu - almost
  2470. always preferable to the internal created menus.
  2471.  
  2472. Starting on line four are the commands themselves.  Each command line has
  2473. three main components.  The first is the command character itself, which must
  2474. be a single character in length.  These should always be uppercase, and may
  2475. not be numeric in nature.
  2476.  
  2477. Following the command character is an equal sign, followed by the command
  2478. description in quotes.  The command description isn't essential if you use
  2479. external menus, but is recommended for your own use when editing menus.
  2480.  
  2481. Follow the command description with a comma.  After this comma, you can enter
  2482. special instructions for the command.  Only one command, the "FN=" parameter,
  2483. is required.  FN= refers to the command number (see the MENUS.DOC file for a
  2484. description of the command numbers for each menu, and the section on "global
  2485. commands" below).
  2486.  
  2487. Lastly, you may add security checks after the command description, seperated
  2488. by commas.  When using the internal menus, users who do not have the
  2489. sufficient access requirements for the command will not see it listed on the
  2490. menu. External menus have no such control.  Users who do not meet the
  2491. requirements cannot access the option either, of course.  The valid security
  2492. check commands include:
  2493.  
  2494. SL=n   ; Security level.  n is the user's level.
  2495. XL=n   ; Transfer level, with n being the required minimum xfer level.
  2496. AGE=n  ; Required user age.  Users below this age will not have access.
  2497. BAUD=n ; Required minimum bps rate.
  2498. MC=n   ; Message conference.  The user must have access to conference #n.
  2499. XC=n   ; Xfer conference.  User must have access to xfer conference #n.
  2500. SFLAG=n; Sysop flag.  User must have this flag set.
  2501.  
  2502. The check command should be followed immediately by an equal (=) sign and the
  2503. numeric value to be checked.  No spaces.  If there are more checks to do,
  2504. conclude the command with a comma.
  2505.  
  2506. Global Commands:  From most menus, the following command numbers can be used
  2507. to access various features of the BBS to add even more flexibility to your
  2508. setup.  Each of the global commands has a number of 100 or above.
  2509.  
  2510. #100: Go to main menu
  2511. #101: Go to transfer sectioon
  2512. #102: Go to message base section
  2513. #104: Information kiosk
  2514. #105: Go to BBS list section
  2515. #106: Call for a chat
  2516. #107: Log off system
  2517. #108: Leave system feedback
  2518. #109: User configuration section
  2519. #110: Automessage section (not useful for Alacrity)
  2520. #111: Art Gallery section
  2521. #112: Display news
  2522. #113: List users
  2523. #114: Go to Door section
  2524. #115: Enter Gfiles section
  2525. #116: Enter oneliner section
  2526. #117: Create a QWK packet
  2527. #118: Show the system status / history / storage information
  2528. #119: New User Voting section
  2529. #120: Show who is online (for multinode systems)
  2530. #121: Enter the multinode chat
  2531. #122: Show the recent activity (calls, uploads, downloads) lists
  2532. #123: Show user status
  2533. #124: Perform global newscan
  2534. #125: Enter main sysop section
  2535. #126: Transfer to another user account
  2536. #127: Enter user custodian section
  2537.  
  2538. Global commands #201 through #299 call additional menu "blanks" which will
  2539. enable you to create additional custom menus utilizing the above commands.
  2540. Command #1 in each menu blank is the command to quit.
  2541.  
  2542. To create these menus, create custom menus with titles of "Menu #1" and edit
  2543. them as you would a normal menu.  Note that additional commands will be
  2544. added in the future.
  2545.  
  2546.  
  2547.  
  2548. Menu Script Objects
  2549. ~~~~~~~~~~~~~~~~~~~
  2550. The following menu data objects are examples for every meny (which we could
  2551. find) in Celerity.  These may be cut and pasted into your CELMENU.INI file
  2552. if you wish to use them, and modified to your liking.
  2553.  
  2554.  
  2555. [Net Management]
  2556. menufile=NetMan
  2557. menuprompt=
  2558. Q="Quit", FN=1
  2559. L="List Outgoing Posts", FN=2
  2560. V="View an outgoing post", FN=3
  2561. D="Delete an outgoing post", FN=4
  2562. [END]
  2563.  
  2564. [Auto Message]
  2565. menufile=automes
  2566. menuprompt=
  2567. V="View Auto Message", FN=1
  2568. W="Write Auto Message", FN=2
  2569. U="Upload Auto Message", FN=3
  2570. Q="Quit", FN=4
  2571. [END]
  2572.  
  2573. [News Editor]
  2574. menufile=News
  2575. menuprompt=
  2576. A="Add news", FN=1
  2577. D="Delete news", FN=2
  2578. V="View news", FN=3
  2579. L="List news", FN=4
  2580. Q="Quit", FN=5
  2581. [END]
  2582.  
  2583. [New User Voting]
  2584. menufile=NUV
  2585. menuprompt=
  2586. L="List new users", FN=1
  2587. V="View voting results", FN=2
  2588. P="Process votes", FN=3
  2589. Q="Quit", FN=4
  2590. [END]
  2591.  
  2592. [Art Gallery]
  2593. menufile=ARtgal
  2594. menuprompt=
  2595. V="View art", FN=1
  2596. U="Upload art", FN=2
  2597. L="List art", FN=3
  2598. D="Delete art", FN=4
  2599. ; P="", FN=5, SL=101
  2600. Q="Quit", FN=6
  2601. [END]
  2602.  
  2603. [BBS List]
  2604. menufile=BBSLIST
  2605. menuprompt=
  2606. A="Add entry", FN=1
  2607. D="Delete entry", FN=2
  2608. L="List entries", FN=3
  2609. ; S="", FN=4, SL=101
  2610. ; P="", FN=5, SL=101
  2611. Q="Quit", FN=6
  2612. [END]
  2613.  
  2614. [Sub-board Access]
  2615. menufile=SUBACC
  2616. menuprompt=
  2617. Q="Quit", FN=1
  2618. L="List users w/access", FN=2
  2619. G="Global access manipulation", FN=3
  2620. U="User access manipulation", FN=4
  2621. [END]
  2622.  
  2623. [Message Base Sponsor]
  2624. menufile=SPONSOR
  2625. menuprompt=
  2626. Q="Quit", FN=1
  2627. A="Access menu", FN=2
  2628. E="Edit sub", FN=3
  2629. K="Kill sub", FN=4
  2630. M="Move Post", FN=5
  2631. S="Sort subs", FN=6
  2632. O="Order subs", FN=7
  2633. [END]
  2634.  
  2635. [Newscan]
  2636. menufile=Subscan
  2637. menuprompt=
  2638. A="Read Again", FN=1
  2639. D="Delete Post", FN=2
  2640. P="Post", FN=3
  2641. R="Reply", FN=4
  2642. U="Upload Post", FN=5
  2643. S="Skip Sub", FN=6
  2644. T="Toggle Dumpscan", FN=7
  2645. Q="Quit", FN=8
  2646. _="Next Post", FN=9
  2647. #="Read Message #", FN=10
  2648. B="Back one Message", FN=11
  2649. [END]
  2650.  
  2651. [Message Menu]
  2652. menufile=msg
  2653. menuprompt=
  2654. A="", FN=1          ;  sub change
  2655. B="Change Board", FN=2
  2656. D="Toggle Dumpscan", FN=3
  2657. F="Toggle Newscan for Sub", FN=4
  2658. G="", FN=5          ;  log off
  2659. ; I="", FN=6
  2660. J="Jump Conferences", FN=7
  2661. K="Kill Post", FN=8
  2662. L="List Posts", FN=9
  2663. M="", FN=10         ;  alternate jump conferences
  2664. N="Newscan", FN=11
  2665. O="Log Off", FN=12
  2666. P="Post", FN=13
  2667. ; Y="", FN=14, SL=101
  2668. R="Replay to Post", FN=15
  2669. S="Scan Posts", FN=16
  2670. T="", FN=17         ;  transfers (see fn 21)
  2671. U="Upload Post", FN=18
  2672. V="Newscan this Sub", FN=19
  2673. W="Who's Got Access", FN=20
  2674. X="Transfer Section", FN=21
  2675. Z="", FN=22         ;  newscan (see fn 11)
  2676. E="Edit Post", FN=23
  2677. _="Next Post", FN=24
  2678. %="Board Sponsor", FN=25
  2679. +="Next Sub", FN=26
  2680. -="Previous Sub", FN=27
  2681. #="# to read Post", FN=28
  2682. Q="Quit", FN=29
  2683. [END]
  2684.  
  2685. [Menu #n]           ;  These are menu blanks.  n is an integer, 1-99.
  2686. menufile=MENUn      ;  see above
  2687. menuprompt=
  2688. Q="Quit", FN=1
  2689. [END]
  2690.  
  2691. [Miscellaneous Functions]
  2692. menufile=MISC
  2693. menuprompt=
  2694. A="Art Gallery", FN=1
  2695. B="BBS List", FN=2
  2696. F="Feedback", FN=3
  2697. G="G-files", FN=4
  2698. I="Infoforms", FN=5
  2699. L="List Users", FN=6
  2700. N="News", FN=7
  2701. D="Doors", FN=8
  2702. O="Log Off", FN=9
  2703. Q="Quit", FN=10
  2704. M="One Liners", FN=11
  2705. S="System Statistics", FN=12
  2706. U="New User Voting", FN=13
  2707. W="Who's online", FN=14
  2708. $="Donation Information", FN=15
  2709. %="Sysop Commands", FN=16, SFLAG=14
  2710. &="Generic Advertisment", FN=17
  2711. .="Celerity Credits", FN=18
  2712. ; +="Debug", FN=19, SL=101
  2713. V="Voting Booth", FN=20
  2714. [END]
  2715.  
  2716. [Main Level]
  2717. menufile=MAINLEV
  2718. menuprompt=
  2719. M="Miscellaneous Menu", FN=1
  2720. B="Sub Boards", FN=2
  2721. X="Xfer Section", FN=3
  2722. T="", FN=4   ; transfers - alternate command
  2723. G="Global Newscan", FN=5
  2724. Z="", FN=6   ; zipscan
  2725. E="Electronic Mail", FN=7
  2726. C="Chat w/sysop", FN=8
  2727. Y="Your Statistics", FN=9
  2728. O="Log Off", FN=10
  2729. K="Configure Interface", FN=11
  2730. /="Multiline Chat", FN=12
  2731. Q="QWK Reader Support", FN=13
  2732. %="Sysop Functions", FN=14, SFLAG=14
  2733. !="User Custodian", FN=15, SFLAG=15
  2734. D="Doors", FN=16
  2735. [END]
  2736.  
  2737. [Main Menu]
  2738. menufile=MAIN
  2739. menuprompt=
  2740. A="Automessage", FN=1
  2741. B="BBS List", FN=2
  2742. C="Chat w/sysop", FN=3
  2743. D="Doors", FN=4
  2744. E="Electronic Mail", FN=5
  2745. F="Feedback", FN=6
  2746. G="", FN=7                ; log off
  2747. =="", FN=8
  2748. I="Information Scripts", FN=9
  2749. J="Last Lists", FN=10
  2750. K="Configure Interface", FN=11
  2751. L="List Users", FN=12
  2752. M="Message Section", FN=13
  2753. N="Read News", FN=14
  2754. O="Log Off", FN=15
  2755. P="General Files", FN=16
  2756. Q="QWK Reader Support", FN=17
  2757. R="One Liners", FN=18
  2758. S="System Statistics", FN=19
  2759. T="", FN=20               ; Transfer section
  2760. U="New User Voting", FN=21
  2761. W="Who's Online", FN=22
  2762. V="View Recent Lists", FN=23
  2763. X="Transfer Section", FN=24
  2764. Y="Your Statistics", FN=25
  2765. Z="Zipscan", FN=26
  2766. $="Donation", FN=27
  2767. ; -="", FN=28
  2768. %="Sysop Options", FN=29, SFLAG=14
  2769. !="User Custodian", FN=30, SFLAG=15
  2770. &="Generic Advertisement", FN=31
  2771. .="Celerity Credits", FN=32
  2772. /="Multinode Chat", FN=33
  2773. [END]
  2774.  
  2775. [File Change]
  2776. menufile=fchange
  2777. menuprompt=
  2778. Q="Quit", FN=1
  2779. U="Uploader", FN=2
  2780. D="Description", FN=3
  2781. S="Special Request", FN=4
  2782. R="Rating", FN=5
  2783. N="Name of file", FN=6
  2784. L="Location", FN=7
  2785. V="Value", FN=8
  2786. A="Access Password", FN=9
  2787. ; E="", FN=10, SL=101
  2788. F="Full Program Name", FN=11
  2789. O="Disk Numbers", FN=12
  2790. P="Private", FN=13
  2791. T="Times Downloaded", FN=14
  2792. [END]
  2793.  
  2794. [Sysop Filescan]
  2795. menufile=newscan
  2796. menuprompt=
  2797. Q="Quit", FN=1
  2798. #="# of points", FN=0   ; really function 2, but will never return a value
  2799. V="Value", FN=2
  2800. C="Change file", FN=3
  2801. E="Rename file", FN=4
  2802. D="Delete file", FN=5
  2803. Z="Zip listing", FN=6
  2804. M="Move file", FN=7
  2805. S="Skip file", FN=8
  2806. 0="Free file", FN=9
  2807. [END]
  2808.  
  2809. [File Newscan]
  2810. menufile=filenew
  2811. menuprompt=
  2812. Q="Quit", FN=1
  2813. N="Next area", FN=2
  2814. ; A="", FN=3, SL=101
  2815. D="Download", FN=4
  2816. +="Add to batch", FN=5
  2817. I="Info on file", FN=6
  2818. Z="Zip listing", FN=7
  2819. C="Change file", FN=8
  2820. R="Rename file", FN=9
  2821. !="Validate files", FN=10
  2822. K="Kill file", FN=11
  2823. _="Next page", FN=12
  2824. [END]
  2825.  
  2826. [File Listing]
  2827. menufile=filelst
  2828. menuprompt=
  2829. Q="Quit", FN=1
  2830. N="Nonstop", FN=2
  2831. A="Repeat listing", FN=3
  2832. D="Download", FN=4
  2833. +="Add to batch", FN=5
  2834. I="Info on file", FN=6
  2835. Z="Zip listing", FN=7
  2836. C="Change file", FN=8
  2837. R="Rename file", FN=9
  2838. !="Validate files", FN=10
  2839. K="Kill file", FN=11
  2840. _="Next page", FN=12
  2841. [END]
  2842.  
  2843. [Global Management]
  2844. menufile=globman
  2845. menuprompt=
  2846. S="Sort areas", FN=1
  2847. P="Point reassign", FN=2
  2848. C="Cleanup offline files", FN=3
  2849. V="Verify locations", FN=4
  2850. O="Delete old files", FN=5
  2851. D="Directory scan", FN=6
  2852. Q="Quit", FN=7
  2853. [END]
  2854.  
  2855. [File Sponsor]
  2856. menufile=fsysop
  2857. menuprompt=
  2858. A="Area change", FN=1
  2859. C="Change file", FN=2
  2860. D="Delete file", FN=3
  2861. F="File directory", FN=4
  2862. L="List files", FN=5
  2863. K="Kill area", FN=6
  2864. R="Edit Area", FN=7
  2865. N="New file scan", FN=8
  2866. S="Sort area", FN=9
  2867. M="Move file", FN=10
  2868. U="List users w/access", FN=11
  2869. O="Order areas", FN=12
  2870. P="Point reassign", FN=13
  2871. E="Rename file", FN=14
  2872. W="Add files to directory", FN=15
  2873. *="Area Change", FN=16
  2874. X="Download unlisted file", FN=17
  2875. B="Batch move/delete", FN=18
  2876. I="Cleanup offline", FN=19
  2877. V="Verify locations", FN=20
  2878. Z="Zip listing", FN=21
  2879. J="Just how much space?", FN=22
  2880. Q="Quit", FN=23
  2881. G="Global management", FN=24
  2882. -="Show who's online", FN=25
  2883. =="View sysop log", FN=26
  2884. +="Add file locally", FN=27
  2885. ; T="Verify xfer areas", FN=28
  2886. [END]
  2887.  
  2888. [User File Editor]
  2889. menufile=usrud
  2890. menuprompt=
  2891. Q="Quit", FN=1
  2892. K="Kill file", FN=2
  2893. D="Describe file", FN=3
  2894. V="Change value", FN=4
  2895. F="Program name", FN=5
  2896. O="Disk numbers", FN=6
  2897. P="Private", FN=7
  2898. [END]
  2899.  
  2900. [Transfers]
  2901. menufile=file
  2902. menuprompt=
  2903. U="Upload", FN=1
  2904. D="Download", FN=2
  2905. L="List files", FN=3
  2906. F="Feedback", FN=4
  2907. Y="Your status", FN=5
  2908. A="Change area", FN=6
  2909. *="Change area", FN=7
  2910. S="Search for file", FN=8
  2911. Q="Quit", FN=9
  2912. %="Sysop Access", FN=10, XL=90
  2913. N="Newscan", FN=11
  2914. V="Newscan Area", FN=12
  2915. ; H="", FN=13, SL=101
  2916. Z="Zip listing", FN=14
  2917. W="Configure file listing", FN=15
  2918. E="Edit upload", FN=16
  2919. T="Type file", FN=17
  2920. R="Request file", FN=18
  2921. C="Create master file list", FN=19
  2922. B="Batch xfer menu", FN=20
  2923. +="Add to batch", FN=21
  2924. X="Extract from archive", FN=22
  2925. I="Information on file", FN=23
  2926. G="Goodbye", FN=24
  2927. J="Jump conferences", FN=25
  2928. M="Message section", FN=26
  2929. ; P="Test archive", FN=27
  2930. /="Multiline Chat", FN=28
  2931. [END]
  2932.  
  2933. [Sysop Commands]
  2934. menufile=sysop
  2935. menuprompt=
  2936. Q="Quit", FN=1
  2937. T="", FN=2
  2938. E="Error log", FN=3
  2939. A="Add news", FN=4
  2940. N="News menu", FN=5
  2941. D="Delete error log", FN=6
  2942. U="User editor", FN=7
  2943. C="Check net", FN=8
  2944. I="Infoform scan", FN=9
  2945. J="Show all infoforms", FN=10
  2946. S="Show sysop log", FN=11
  2947. K="Kill sysop log", FN=12
  2948. V="View all sysops", FN=13
  2949. M="Make a new user", FN=14
  2950. ; F="", FN=15, SL=101
  2951. R="Remove all infoforms", FN=16
  2952. Z="Zap specific users", FN=17
  2953. P="Set parameters", FN=18, SL=100
  2954. !="User Custodian", FN=19
  2955. [END]
  2956.  
  2957. [Doors]
  2958. menufile=doors
  2959. menuprompt=
  2960. L="List doors", FN=1
  2961. O="Open door", FN=2
  2962. C="Create door", FN=3, SFLAG=16
  2963. D="Delete door", FN=4, SFLAG=16
  2964. E="Edit door", FN=5, SFLAG=16
  2965. Q="Quit", FN=5
  2966. %="", FN=6                   ; useless function.  Not displayed.
  2967. [END]
  2968.  
  2969. [Scan Mail]
  2970. menufile=scnmail
  2971. menuprompt=
  2972. R="Reply", FN=1
  2973. F="Forward mail", FN=2
  2974. S="Save mail", FN=3
  2975. A="Read again", FN=4
  2976. N="Next piece", FN=5
  2977. Q="Quit", FN=6
  2978. L="List mail", FN=7
  2979. #="Show mail #", FN=8
  2980. _="Next piece", FN=9
  2981. [END]
  2982.  
  2983. [Electronic Mail]
  2984. menufile=email
  2985. menuprompt=
  2986. V="View mail", FN=1
  2987. S="Send mail", FN=2
  2988. F="Feedback", FN=3
  2989. R="Read mail", FN=4
  2990. L="List mail", FN=5
  2991. Q="Quit", FN=6
  2992. Z="Zap mail", FN=7
  2993. [END]
  2994.  
  2995. [User Editor]
  2996. menufile=uedit
  2997. menuprompt=
  2998. S="Status", FN=1
  2999. D="Delete user", FN=2
  3000. H="Change handle", FN=3
  3001. P="Password", FN=4
  3002. L="Level change", FN=5
  3003. O="File points", FN=6
  3004. E="Xfer level", FN=7
  3005. W="Wanted flag", FN=8
  3006. T="Time left", FN=9
  3007. ; B="Board flags", FN=10
  3008. Q="Quit", FN=11
  3009. ; S="", FN=12, SL=101
  3010. N="Phone Number", FN=13
  3011. I="Show Info script", FN=14
  3012. R="Public note", FN=15
  3013. X="Xfer parameters", FN=16
  3014. C="Conference access", FN=17
  3015. +="Quick validate", FN=18
  3016. K="Kill infoform", FN=19
  3017. Z="Change ratios", FN=20
  3018. [END]
  3019.  
  3020. [Batch Operations]
  3021. menufile=batch
  3022. menuprompt=
  3023. D="Download batch", FN=1
  3024. U="Upload batch", FN=2
  3025. L="List batch queue", FN=3
  3026. C="Clear batch queue", FN=4
  3027. R="Remove one item", FN=5
  3028. +="", FN=6                 ; useless function, not displayed
  3029. Q="Quit", FN=7
  3030. [END]
  3031.  
  3032. [User Custodian]
  3033. menufile=usrcust
  3034. menuprompt=
  3035. ; E="Edit User", fn=1
  3036. N="New User Scan", FN=2
  3037. L="Load Another User", FN=3
  3038. Q="Quit", FN=9
  3039. [END]
  3040.  
  3041. [Voting Booth]
  3042. menufile=vote
  3043. menuprompt=
  3044. V="Vote", FN=1
  3045. L="List Topics", FN=2
  3046. S="Show Results", FN=3
  3047. C="Create Topic", FN=4, SFLAG=18
  3048. D="Delete Topic", FN=5, SFLAG=18
  3049. E="Edit Topic", FN=6, SFLAG=18
  3050. N="Newscan Topics", FN=7
  3051. Q="Quit", FN=8
  3052. [END]
  3053.  
  3054.  
  3055.  
  3056.  
  3057. Appendix Z:  Credits and Acknowledgements
  3058. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3059. Celerity is written by Brendon Woirhaye and Dave Hicks.
  3060.  
  3061. Celerity documentation written by Brendon Woirhaye except for the following:
  3062.  
  3063. Appendix K,L: Written by "Holy Ward", sysop of MidPoint Void CAE/TAC.
  3064. Appendix N  : Written by "Fatal Error", sysop of Modular Madness.
  3065.  
  3066.  
  3067. Others who have contributed significantly to the Celerity project in the area
  3068. of beta testing and suggestions include:
  3069.  
  3070. Lord Icon, sysop of The Genisis Division
  3071. Earl Weaver, sysop of the former Instant Replay
  3072. Malignant Growth, ex-sysop of Fungus Land
  3073. Dr. Crunch, sysop of the former The Proving Grounds
  3074. Phantom, sysop of the former XTC
  3075. Basket Case, sysop of The Hall of Illusions
  3076. General Zennor, sysop of The Cassandra Complex
  3077. The JokeR, sysop of The Arkham Asylum
  3078. The Punisher, sysop of The Crack in Time BBS/CAE
  3079. The WardeN, sysop of Maximum Security BBS/CAE
  3080.  
  3081.  
  3082. Thanks also to those who have written menus, status screens, and info-forms for
  3083. other Celerity sysops to use:
  3084.  
  3085. Lord Icon       Phantom         Basket Case       Trooper X        Grim Reaper
  3086. Wild Gunman     General Zennor  Optical Illusion  Cemetery Shift
  3087.  
  3088. Even more thanks go to those sysops who have chosen Celerity as their BBS of
  3089. choice.
  3090.                                                           
  3091. And to those whom I've forgotten to mention.
  3092.  
  3093. Thanks also go to The Shocker, for implementing CelerityNet into his BBS
  3094. software, expanding the network to more than one software package.
  3095.  
  3096. Additional thanks go to Skeeve, author of Silicosis, for making his software
  3097. the third BBS package to support CelerityNet.
  3098.  
  3099. Thanks also go to Extreme A.I., author of ADI, for his constructive feedback,
  3100. coding assistance (FidoNet, HermesNet), Celerity utilities, and incorporation
  3101. of CelerityNet into ADI.
  3102.  
  3103. Acknowledgement must also go to the following for incorporating CelerityNet
  3104. into their packages: Warlord and The Grim Reaper of Vision-X, the author of
  3105. FAQ (who's handle escapes me at the moment), The Elemental of Cypher, Darkened
  3106. Emnity and the other authors of Oblivion/2, Big Mario of Prism, and other
  3107. authors who choose to support it in the future.
  3108.  
  3109. Exceptional thanks to Extreme A.I. for designing the HermesNet specification
  3110. and to all the BBS packages in our consortium: Celerity, ADI, Prism, Extreme,
  3111. Mirage, Oblivion/2, and Vision-X.
  3112.  
  3113.  
  3114.  
  3115. Acknowledgements
  3116.  
  3117. MS-DOS is a trademark of Microsoft Corporation.
  3118. DSZ is a trademark of Omen Technologies, Inc.
  3119. Turbo Pascal is a trademark of Borland International, Inc.
  3120. Forum is a trademark of Kenneth Duda.
  3121. PKZIP, ZIP, and PKUNZIP are trademarks of PKWare, Inc.
  3122.  
  3123.