home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / mbbs25a4.zip / MACROBBS.DOC < prev    next >
Text File  |  1993-05-14  |  56KB  |  1,502 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                              W E L C O M E   T 0
  13.  
  14.  
  15.  
  16.  
  17.             ////   ////                          //////  //////  //////  tm
  18.            // // // //  ///  ///// ////  ////// //   // //   // //
  19.           //  ///  // // // //    // // //  // // ///  // ///  //////
  20.          //       // ///// //    ////  //  // //   // //   //     //
  21.         //       // // // ///// // // ////// //////  //////  //////
  22.  
  23.  
  24. ==================
  25. A  full-function                Version 2.5a
  26. Shareware BBS for
  27. use with {COMMO},
  28. -- a powerful IBM
  29. telecommunications              May 14, 1992
  30. package by Fred P.
  31. Brucker -- V5.3 or
  32. higher.
  33. ==================                   by
  34.  
  35.  
  36.  
  37.                                  Jeff Oberlee
  38.  
  39.                               2827 Harwick, Apt 7
  40.                             Lansing, Michigan 48917
  41.                               BBS: (517) 323-3405
  42.                               FidoNet 1:159/500
  43.  
  44.  
  45.                         Host mode embryo by Shad Muegge
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.            (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  60.  
  61.                                     MacroBBS                          Page 1
  62.  
  63.  
  64.  
  65.                                Table of Contents
  66.                                -----------------
  67.  
  68.  
  69.       Shareware Notice  .......................................   2
  70.  
  71.       Introduction  ............................................  3
  72.  
  73.       Hardware/software requirements  ..........................  4
  74.  
  75.       First-Time Setup  ........................................  4
  76.           Booting MacroBBS  ....................................  5
  77.  
  78.  
  79.       I.   OFF-LINE
  80.  
  81.            Off-line Wait Screen  ...............................  7
  82.  
  83.            Special Functions Menu  .............................  9
  84.  
  85.  
  86.       II.  ON-LINE
  87.  
  88.            Log-on  ...............................................  10
  89.  
  90.            New Caller Welcome  ...................................  11
  91.  
  92.            Main Menu  ............................................  12
  93.  
  94.            Message Base Menu  ....................................  14
  95.               Read menu       ................................  15
  96.               Sysop menu      ................................  15
  97.  
  98.            Message Packer Menu  ..................................  16
  99.  
  100.            File Base Menu      ...................................  17
  101.  
  102.            The Hall of Fame  .....................................  18
  103.  
  104.            Remote Config Menu  ...................................  19
  105.  
  106.            On-line Sysop Menu  ...................................  19
  107.  
  108.            Chat Mode  ............................................  20
  109.  
  110.            External Protocols and Doors  .........................  21
  111.  
  112.            "In the Unlikely Event of a Crash" (trouble-shooting)    22
  113.  
  114.  
  115.      III.  NOTES
  116.  
  117.           ASCII/ANSI screens  ....................................  23
  118.  
  119.           Access Levels  .........................................  23
  120.  
  121.                                     MacroBBS                          Page 2
  122.  
  123.           E-mail  ................................................  24
  124.  
  125.           QuotED  ................................................  24
  126.  
  127.       Acknowledgements  ..........................................  24
  128.  
  129.  
  130.  
  131.                                   SHAREWARE NOTICE
  132.                                   ----------------
  133.  
  134.     MacroBBS's associated macro files and documentation are the property of
  135. the author and may not be sold but may be freely distributed -- provided that
  136. the MACROBBS files/archive are unaltered and remain as a unit -- via elec-
  137. tronic Bulletin Board Systems.  The author does not guarantee this program to
  138. be free from defects and will not be held responsible for any loss caused
  139. by the use or misuse of this product.
  140.  
  141.     Your use of this product constitutes your acceptance of these terms.
  142.  
  143.                    ========================================
  144.  
  145.     The macro files included in this package represent more than two
  146. work-years of program and development time.   All I ask is:  If you like
  147. MacroBBS and use it, please consider registering your copy by sending a
  148. donation of $10.  I figure there are LOTS of people like myself who, if
  149. they enjoy a program, will send a donation.  Perhaps there are some who
  150. appreciate being trusted (as I do).  That's why unregistered copies of
  151. MacroBBS are not crippled in any way.  USE MacroBBS for a while, give it
  152. a thorough testing, but most of all ... ENJOY!
  153.  
  154.     I hope you, a {COMMO} user like myself, find MacroBBS easy and fun to
  155. use.  Please feel free to send comments, questions, suggestions, and/or
  156. donations to me at the address below.
  157.  
  158.                   Sincerely,
  159.  
  160.                             Jeff Oberlee
  161.  
  162.                             2827 Harwick, Apt 7
  163.                             Lansing, Michigan  48917
  164.                             BBS:  (517) 323-3405
  165.                             FidoNet 1:159/500
  166.  
  167.  
  168.  
  169.  
  170.  
  171.   {COMMO} is a trademark of Fred P. Brucker
  172.   "DOS" is a reference to MS-DOS, a trademark of MicroSoft Corp.
  173.   DSZ.COM is a product of Omen Technology, Inc.
  174.   MacroBBS is a trademark of Jeff Oberlee.
  175.   QuotED is a trademark of Dennis Boone.
  176.   Other shareware products mentioned herein are trademarks of their authors.
  177.  
  178.  
  179.             (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  180.  
  181.                                     MacroBBS                          Page 3
  182.  
  183.  
  184.                                   INTRODUCTION
  185.                                   ------------
  186.  
  187.     WELCOME to MacroBBS! -- a program written in {COMMO}'s built-in
  188. macro language.  MacroBBS allows you to set-up your computer system to
  189. receive modem calls from other computer systems, provided that you are
  190. successfully telecommunicating with {COMMO} 5.3 or higher.  Once
  191. MacroBBS detects an incoming call and the connection is made, the remote
  192. Caller logs-on to your system, supplying a name and password.  The
  193. Caller has several options from the Main Menu, including direct access
  194. to DOS (if DOORWAY.EXE is installed), E-mail, public message exchange, a
  195. message packer, and upload/download file transfer, among many other
  196. options.
  197.  
  198.     Although MacroBBS is but a set of {COMMO} macro files, it is a
  199. highly functional BBS package having many useful features, such as:
  200.  
  201.  *  Access Levels  (AL)
  202.     Each person can have a different Access Level (0-999).  MacroBBS uses
  203.     this variable for security.  Example:  Anyone with an access level of 10
  204.     cannot "see" (access) a message or file area having an Access Level of
  205.     20.  A Caller would need an Access Level of 20 or higher in this case.
  206.     Access Levels are issued BY YOU, the System Operator (SysOp).
  207.  
  208.   *  Multiple message areas
  209.      Post, upload, reply, edit, quote, move, delete, and a maximum line input
  210.      that YOU define.  Each area can have its own Access Level (0-999) and
  211.      maximum number of messages allowed before auto-deletion of excess messages
  212.      takes place.
  213.  
  214.   *  Multiple file areas
  215.      Upload and Download using the protocol driver of your choice, or simply
  216.      use XMODEM and take advantage of {COMMO}'s built-in xmodem protocols.
  217.      An automated LOCAL UPLOAD routine allows the sysop to "fill" the file
  218.      areas with ease.  Each file area can have its own Access Level (0-999).
  219.  
  220.   *  Remote Config Menu.
  221.      Add, Edit, Delete or Review message areas, file areas and user files
  222.      remotely.
  223.  
  224.   *  ON-LINE SYSOP MENU accessible by pressing the ESCape key.
  225.      Use this menu to edit the on-line Caller's handle or Access Level,
  226.      to answer a chat request, to shell to DOS, or to reset the BBS.
  227.  
  228.   *  Full-function OFF-LINE WAIT SCREEN.
  229.      Add, Edit, Delete or Review  message areas, file areas and user files.
  230.      Read e-mail, send e-mail, edit any external file viewable by {COMMO}'s
  231.      built-in ASCII editor, shell to DOS, and more.
  232.  
  233.   *  Daily, overall usage, and Caller logs are kept by MacroBBS for your
  234.      reference.
  235.  
  236.   *  The MacroBBS package Includes QuotED -- a ready-to-use quote generator
  237.      by Dennis Boone, complete with an ASCII-editable sample quote file.
  238.  
  239.   *  AND SO MUCH MORE!
  240.  
  241.                                     MacroBBS                          Page 4
  242.  
  243.  
  244.                           HARDWARE/SOFTWARE REQUIREMENTS
  245.                           ------------------------------
  246.  
  247.     1.  You must successfully use {COMMO}, a fine telecommunications package
  248.         by Fred P. Brucker (Version 5.3 or higher).
  249.  
  250.     If you successfully run {COMMO} on your computer, you can use
  251. MacroBBS. MacroBBS runs under {COMMO}'s guidance and will optionally
  252. utilize a protocol driver such as DSZ.COM just as {COMMO} does -- for
  253. Zmodem file transfer. Even though MacroBBS COULD be run from a floppy
  254. drive, I HIGHLY RECOMMEND USE OF A HARD DRIVE! The MESSAGE and FILE
  255. BASES will prove to be major space-takers as your BBS grows.
  256.  
  257.     2.  To "UNZIP" the MacroBBS archive, you must have PKUNZIP.EXE (by
  258. PKWARE, Inc.) at your disposal.
  259.  
  260.     3.  For REMOTE access to DOS (eg. if you call your BBS from a friend's
  261. system and want to access your DOS), install DOORWAY.EXE (by Marshall Dudley)
  262. in your {COMMO} disk directory.
  263.  
  264.  
  265.                                 FIRST-TIME SETUP
  266.                                 ----------------
  267.  
  268.     Ok.  This should be a cinch.   If you got {COMMO} set-up, you can do
  269. this.   IMPORTANT:  If you are upgrading from an earlier version of
  270. MacroBBS, refer to the file "!UPGRADE.DOC".
  271.  
  272. -->  1.  MAKE SURE to place MBBSxx.ZIP in your {COMMO} disk directory.
  273.                                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  274. -->  2.  At the DOS prompt (eg. C:\COMMO>_ ) type:
  275.  
  276.                        PKUNZIP -de MBBSxx  <press ENTER>  (xx = version number)
  277.  
  278.              ...to unzip the MacroBBS files.
  279.  
  280.  \COMMO\  MACROBBS  ......  to contain the ANSI/ASCII files, logs, and misc;
  281.           CALLERS  .......  to contain the userfiles;
  282.           CALLERS\DATA\  .  to contain all of the (optional) logon datafiles;
  283.           CALLERS\REGS\  .  to contain all the REGistry files (Hall of Fame)
  284.           MSGS  ..........  to contain Message Area info files & E-mail;
  285.           MSGS\INDEX\  ...  to contain each User's message base index file;
  286.           MSGS\TAGS\  ....  to contain each User's tagged message areas;
  287.           FILES  .........  to contain File Area info files;
  288.           READER  ........  work directory for the message packer.
  289.           READER\TAGS\  ..  to contain each User's tagged message areas
  290.                                                          (for packing).
  291.  
  292.         Several files are then copied to these directories.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.                                     MacroBBS                          Page 5
  302.  
  303. -->  3.  Next, type:
  304.  
  305.                        PKUNZIP QUOTED  <press ENTER>
  306.  
  307.              ...to unzip the QuotED files, if you would like MacroBBS to
  308.         display a quote at log-on.
  309.  
  310. -->  4.  Next, type:
  311.  
  312.                        MBCFG  <press ENTER>
  313.  
  314.              ...to run the MacroBBS configuration module.  Answer all ques-
  315.         tions as best you can.  Default text is provided, but you may want to
  316.         change a few things such as BBS name, Sysop name, etc.
  317.  
  318.  
  319. IMPORTANT NOTE:  The MODEM INIT STRING is very important to MacroBBS's
  320. operation.  Your modem MUST be told (initialized) to return ENGLISH
  321. result codes, rather than numeric codes,  Note the following sample
  322. modem init string:
  323.  
  324.                      AT E0 H0 M0 Q0 V1 X4
  325.                          │  │  │  │  │  │
  326.                          │  │  │  │  │  Uses the FULL set of result codes
  327.                          │  │  │  │  returns Verbal (English) result codes
  328.                          │  │  │  turns result codes ON
  329.                          │  │  turns modem speaker off
  330.                          │  puts modem ON Hook
  331.                          turns Echo off
  332.  
  333.     Whatever you choose as a modem init string, be SURE to turn ON result codes
  334. with Q0, choose ENGLISH result codes (rather than numeric) with V1, and choose
  335. the FULL set of result codes with X4.  For more information, please refer to
  336. your modem manual.  This note assumes HAYES compatibility.
  337.  
  338. -->  6.  If you want to access DOS remotely, make sure DOORWAY.EXE is in your
  339. {COMMO} directory.  MacroBBS is already set-up to use it, if installed.
  340.  
  341. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  342. * ------>  NOTE TO ALL SYSOPS RUNNING MACROBBS FOR THE FIRST TIME  <------  *
  343. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  344. *  "SYSOP" is already a member of your BBS.  SYSOP was created to ensure    *
  345. * that YOU, the sysop, get position number one on the BBS.  This is neces-  *
  346. * sary for several reasons, most dealing with private e-mail.  First, log-  *
  347. * on locally by choosing option 1 from the OFF-LINE WAIT SCREEN.  At the    *
  348. * LOGIN: prompt, enter "Sysop" or "1".  Then, at the PASSWORD: prompt,      *
  349. * enter "PASS".  MAKE SURE TO CHANGE YOUR PASSWORD!  Choose option "Y"      *
  350. * (Your Data) from the MAIN MENU to change it.  Next, press ESCape to       *
  351. * pop-up the ON-LINE SYSOP MENU.  Type the letter "U" then press <ENTER>    *
  352. * to edit your account.  Since YOU are on-line, YOUR current handle is dis- *
  353. * played.  Use the BACKSPACE key to erase "SYSOP" then enter the handle you *
  354. * wish to use (as you did in the config section).  MAKE SURE to give your-  *
  355. * self an adequate AL (Access Level).  I recommend 999, as that is the      *
  356. * highest possible AL.  When the new info is saved, press ESCape again to   *
  357. * return to the BBS.  You're all set!  Next time you log-on, use the new    *
  358. * info at the LOGIN: and PASSWORD: prompts.      Have FUN!                  *
  359. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  360.  
  361.                                     MacroBBS                          Page 6
  362.  
  363.  
  364.     Booting MacroBBS
  365.     ----------------
  366.  
  367.   -  From DOS (your {COMMO} disk directory), type:  BBS  <press ENTER>
  368.  
  369.   -  From DOS (ANY directory):  If C:\COMMO is not in your PATH (consult your
  370. DOS manual for more info), copy the file BBS.BAT to your root (\) directory.
  371. Then edit C:\BBS.BAT to look like this:
  372.  
  373.             ECHO OFF
  374.             CLS
  375.             CD \COMMO
  376.             COMMO /iN /mMACROBBS.MAC /:BBS
  377.  
  378.      Then you should be able to run MacroBBS from anywhere in DOS by typing
  379. "BBS".  Example:   C:\WHEREVER>_   (Type: BBS <press ENTER>)
  380.  
  381.   -  From within {COMMO}:  Rather than exiting {COMMO} to run BBS.BAT that
  382. will just re-load {COMMO} (to run MacroBBS), you can easily program a {COMMO}
  383. key sequence to automatically boot MacroBBS.  The example below uses the key
  384. sequence ALT-V:
  385.  
  386.             {:ALV}  {MACL macrobbs.mac,bbs}  {}
  387.  
  388.     If you add the above line (typed exactly as shown) to your {COMMO} macro
  389. file (ALT-M from {COMMO}'s terminal screen), pressing ALT-V (from the
  390. terminal screen) will boot MacroBBS.
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                                     MacroBBS                          Page 7
  422.  
  423.  
  424. I ********
  425.   OFF-LINE
  426. **********
  427.  
  428.                          OFF-LINE WAIT SCREEN
  429.                          --------------------
  430.  
  431. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  432. # BBS's name here ###########################################################
  433. +--------------------------------++-  // // /// /// ///  /// tm ------------+
  434. | MacroBBS:  OFF-LINE            ||  / / / /-/ /   /_ / / / Version xx      |
  435. |--------------------------------|| /   / / / /// /  / ///  by Jeff Oberlee |
  436. | OPTIONS                MISC    |+--------- B B S -------------------------+
  437. | 1. Log-on (local)     D - DOS  |+-----------------------------------------+
  438. | 2. See Scrollback     I - Init ||    Embryo     ____    by Shad Muegge    |
  439. | 3. Text/Bulletins     S - Spec ||   ---------|\/ o  \------------------   |
  440. | 4. Edit Ext. File     Q - Quit ||        ____|    ,__| Association of     |
  441. | 5. Master SysMenu    ESC-Reset ||       /  o \/|____/  Babble Fish        |
  442. |              LOGS              ||      |__,    |____   Programmers        |
  443. |    C - Calls      U - Usage    ||       \____|\/ o  \                     |
  444. +--------------------------------+|            |    ,__| MEMBER             |
  445. +--------------------------------+|   ---------|/\____/------------------   |
  446. | Command: _                     ||                                         |
  447. +--------------------------------++-----------------------------------------+
  448.  
  449.    Last Caller: Sysop #1                                   Sysop Mail : 1
  450.    Last Date  : 05/13/93               ____                Pub Posted : 0
  451.    Logon Time :  1:12 pm            |\/ o  \               Pvt Mailed : 0
  452.    Logoff Time:  1:36 pm            |    ,__|
  453.    Calls Today: 0                   |/\____/               Total Calls: 100
  454.    Mins Active: 0
  455.  
  456.    System Time:  4:00 pm       Waiting for a Call       Date: 05/13/93 (Thu)
  457. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  458.  
  459.   1.  Log-on (local)
  460.  
  461.     Use this option to log-on to MacroBBS locally.
  462.  
  463.   2.  See Scrollback
  464.  
  465.     Depending on the size of the {COMMO} scrollback buffer, which you set in
  466. {COMMO}'s setup file (ALT-G from {COMMO}'s terminal screen), the scrollback
  467. buffer can serve as an actual "you-are-there" log.  Say, for example, I call
  468. your BBS when you're not home.  You can view any of the other logs to see
  469. basically what I did, but the scrollback buffer will show you the exact
  470. screens (minus the color) that *I* saw.  It's the most detailed log you could
  471. possibly want.  However, it IS limited to a maximum of 64k.  If your computer
  472. has enough free memory, set the scrollback buffer size to 64k.
  473.  
  474.   3.  Text/Bulletins
  475.  
  476.     A window will open behind the OPTIONS menu.  The following files may
  477. be edited:
  478.  
  479.  
  480.  
  481.                                     MacroBBS                          Page 8
  482.  
  483.      1. NOTICES,.DAT - The file containing your logon notices.
  484.      2. MBBSBULL.LST - The file containing your BULLETIN/TEXT FILE definitions.
  485.      3. MBBSARCH.LST - The file containing your archiver configuration.
  486.  
  487.   4.  Edit Ext. File.
  488.  
  489.   A window will open to accept the path and filename of a file to edit.
  490. Be sure to specify a FULL path if the file you want to edit is NOT in
  491. your {COMMO} home directory.
  492.  
  493.   5.  Master SysMenu
  494.  
  495.     After successfully entering the system password, a window will open
  496. behind the babblefish tank and a menu will appear with four options.
  497. Choose the option that corresponds with the area you wish to work in
  498. (ie. File Areas, Filelists, Message areas, or Caller Records.)  Just
  499. follow the menus to edit filelists and to Add, Edit, Delete and/or
  500. Review file areas, message areas, or Caller records as needed to
  501. configure your BBS.
  502.  
  503.   C.  Caller Logs
  504.  
  505.     Two files may be viewed:  CALLERS.ALL (the list of ALL calls to your BBS
  506. since day-one) or CALLERS.TDY (the list of all calls to your BBS since 12:00
  507. am of the current day).
  508.  
  509.   U.  Usage Logs
  510.  
  511.     Two files may be viewed:  STATS.LOG (the data representation of
  512. daily system usage), or CHART.LOG (the graphic representation of daily
  513. system usage).  Both logs are updated nightly.
  514.  
  515.   D.  Shell to DOS
  516.  
  517.     Use this handy feature for quick access to DOS.
  518.  
  519.   I.  Initialize the modem
  520.  
  521.     Sends the modem "init string" you specify in the MacroBBS configuration.
  522.  
  523.   S.  Special Functions Menu
  524.  
  525.     After successfully entering the system password, you will be presented
  526. with the SPECIAL FUNCTIONS MENU (explained in detail below).
  527.  
  528.   Q.  Quit
  529.  
  530.     Exits MacroBBS and returns you to {COMMO}'s terminal screen.
  531.  
  532.   ESC.  Reset
  533.  
  534.     Pressing your ESCape key from the OFFLINE WAIT SCREEN will reset
  535. the BBS.
  536.  
  537.  
  538.  
  539.             (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  540.  
  541.                                     MacroBBS                          Page 9
  542.  
  543.  
  544.                                SPECIAL FUNCTIONS MENU
  545.                                ----------------------
  546.  
  547.     Entering "S" at the OFF-LINE WAIT SCREEN will call the "system password"
  548. routine.  Type the password you defined in the MacroBBS configuration and
  549. press ENTER.  If you typed the password correctly, you will be presented with
  550. the Special Functions Menu:
  551.  
  552. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  553.  
  554.               1. Read SYSOP mail            5. Edit a letter
  555.               2. Read another's mail        6. System logs
  556.               3. Send e-mail to ...         7. List Members
  557.               4. Mail count                 8. Re-config MacroBBS
  558.  
  559.               Which? (1-8, ENTER=quit) : _
  560. \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  561.  
  562.   Option description:
  563.  
  564.     1.  Read SYSOP mail:  Read and reply to your mail.
  565.  
  566.     2.  Read another's mail:  It's not nice to snoop, but it IS nice to
  567. have the option.  :)
  568.  
  569.     3.  Send e-mail to ... :  Send e-mail to the Caller you specify by Handle
  570. or ID#.
  571.  
  572.     4.  Mail count:  Count the number of e-mail letters the specified Caller
  573. has waiting in his/her "E-mailbox."
  574.  
  575.     5.  Edit a letter:  Uses {COMMO}'s built-in editor to edit any e-mail
  576. letter on the system.
  577.  
  578.     6.  System logs:  This option lets you view the activity logs kept by
  579. MacroBBS.  Enter a number "1" (the log for the current day) through "7" (the
  580. log for a week ago today, if it exists).
  581.  
  582.     7.  List Members:  Displays the membership list.
  583.  
  584.     8.  Re-config MacroBBS:  Use this to make any changes to the system
  585. configuration.  This is the same routine you use(d) when setting-up MacroBBS
  586. for the first time.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.             (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  600.  
  601.                                     MacroBBS                          Page 10
  602.  
  603.  
  604. II *******
  605.    ON-LINE
  606. **********
  607.  
  608.  
  609.                                LOGON
  610.                                -----
  611.  
  612.    What the person calling your BBS sees, or what YOU see when you choose
  613. option 1 (log-on locally) from the OFF-LINE WAIT SCREEN....
  614.  
  615.    After answering the ANSI (Y,n) prompt, the welcome screen is displayed:
  616.  
  617. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  618.         W E L C O M E   T O
  619.  
  620.  
  621.  
  622.   +-  // // /// /// ///  /// tm ------------+
  623.   |  / / / /-/ /   /_ / / /                 |
  624.   | /   / / / /// /  / ///  by Jeff Oberlee |
  625.   +--------- B B S -------------------------+
  626.  
  627.  
  628.  
  629. 1st-time callers to this system, enter "NEW"
  630. Otherwise, please enter your handle or ID#.
  631.  
  632.    Login: _
  633. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  634.  
  635.     When logging-on for the first time, all Callers must enter NEW.  Persons
  636. who have already signed-up with your system must enter their handle or Caller
  637. ID number.
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.             (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  660.  
  661.                                     MacroBBS                          Page 11
  662.  
  663.  
  664.                               NEW CALLER WELCOME
  665.                               ------------------
  666.  
  667.     Upon entering NEW at the LOGIN: prompt, the NEW CALLER WELCOME screen is
  668. displayed:
  669.  
  670. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  671.                          /   / /// /   /// /// // // ///
  672.                         / / / /-  /   /   / / / / / /-
  673.                        // // /// /// /// /// /   / ///
  674.  
  675. Welcome aboard!  This BBS program is a macro file written in the {COMMO}
  676. macro language -- just a bunch of macros, all working together inside a
  677. terminal program called {COMMO}.  This is NOT a stand-alone BBS, but it DOES
  678. have several neat features that rival commercial software.
  679.  
  680. Your Access Level right now is 0.  You can't post/reply or UL/DL...until
  681. you're validated.  Try to (C)hat or leave me a note at logoff and I'll do
  682. my best to get you validated ASAP.
  683.  
  684.             Talk to ya soon!
  685.  
  686.  
  687.                                    Da Sysop  (#1)
  688.  
  689. Enter your name or handle: _
  690. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  691.  
  692.     The Caller is prompted to enter a handle.  MacroBBS then checks to be
  693. sure the handle isn't already being used and, if all is well, MacroBBS asks
  694. for a password.  The Caller then provides a word that he/she must remember
  695. and must supply each time he/she logs-on to your system.
  696.  
  697. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  698. Checking... OK
  699. Choose a password.  You will need it each time you log-on.
  700. Password: _
  701. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  702.  
  703.     Next, the Caller must choose a default protocol for file transfer...
  704.  
  705. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  706.              +---------------------------------------------------+
  707.              | ############ File Transfer Protocols ############ 3
  708.              +---------------------------------------------------+
  709.                                  [Z] Zmodem
  710.                                  [Y] Ymodem
  711.                                  [X] Xmodem csum
  712.                                  [K] Xmodem-1k
  713.  
  714. (When in doubt, choose 'Z'...
  715. You can always change it later, if needed.)
  716.  
  717. Protocol: _
  718. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  719.  
  720.  
  721.                                     MacroBBS                          Page 12
  722.  
  723.  
  724.     The Caller's information is then saved to disk and he/she is asked to
  725. relog-on to verify the new information...
  726.  
  727. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  728. Your Caller ID# is 11
  729. Saving your information...
  730. Please re-enter your name and password for verification.
  731.  
  732.    Login: George
  733.  
  734. Password: ****
  735. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  736.  
  737.  
  738.  
  739.                                    MAIN MENU
  740.                                    ---------
  741.  
  742.     This is the MAIN MENU of options available to a Caller:
  743.  
  744. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  745. |  Rock #1                              AL=999   LOCAL   0 mins
  746. |  Jeff Oberlee  -  Lansing, MI
  747. +----------------------------------------------------------------------------
  748.  
  749.  
  750.                                BBS's name here
  751.  
  752.                                    Main Menu
  753.  
  754. [M] Message Base    [B] Bulletin/Text   [H] Hall of Fame    [C] Chat
  755. [O] Msg Packer      [E] External Stuff  [L] List Members    [V] Version/BBS
  756. [F] File Base       [Y] Your Config     [R] Read E-mail     [G] Goodbye
  757. [S] Send E-mail ^   [I] Intromsg ^      [D] DOS Doorway ^^  [U] Usage Logs ^^
  758. [!] Remote Config ^^
  759.  
  760.                      [A] ANSI Toggle    [X] Xpert Toggle
  761.                      [*] Quick log-off (from all menus)
  762.  
  763. Main Menu   4:00 pm
  764. Mins Left: 60
  765. MM Command: _
  766. \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  767.  
  768.   ^ --->  The Caller must have an Access Level of 1 (or higher) or these
  769. options will not be displayed--they will be disabled.
  770.  
  771.  ^^ ---> The Caller must have an Access Level equal to or greater than the
  772.          [D]OS DOORWAY Access Level you specify in the MacroBBS configuration,
  773.          or these options will not be displayed--they will be disabled.
  774.  
  775.   Option description:
  776.  
  777.     [!]  Remote Config: Go to the REMOTE CONFIG menu.   (See "Remote
  778. Config Menu")  To access this option, Callers must have an Access Level
  779.  
  780.  
  781.                                     MacroBBS                          Page 13
  782.  
  783.  
  784. equal to or greater than the access level you assign to the DOS DOORWAY
  785. option in MacroBBS's config module.
  786.  
  787.     [*] Quick log-off (from all menus)
  788.  
  789.     [A]  ANSI toggle:  Toggles between straight ASCII and ANSI color modes.
  790.  
  791.     [B]  Bulletins/text:  Go to the Bulletins/Text menu.
  792.  
  793.     [C]  Chat:  Allows the ON-LINE Caller to request chat (with you).
  794.  
  795.     [D]  DOS doorway:  Drop to DOS.  To access this option, Callers must
  796. have an Access Level equal to or greater than the access level you
  797. assign to the DOS DOORWAY option in MacroBBS's config module.  LOCAL
  798. mode uses SHELL; REMOTE mode utilizes DOORWAY.EXE, if installed. (See
  799. "First-time Setup")
  800.  
  801.     [E]  External Stuff:  Go to the EXTERNAL STUFF menu. (See "External
  802. Protocols & Doors")
  803.  
  804.     [F]  File Base:  Go to the FILE BASE menu.  (See "File Base Menu")
  805.  
  806.     [G]  Goodbye:  Callers choose this option to log-off (hang-up).
  807.  
  808.     [H]  Hall of Fame:  Go to the HALL OF FAME menu.  (See "Hall of Fame")
  809.  
  810.     [I]  Intromsg:  Display/edit the introductory message (Intromsg) that is
  811. displayed when a Caller logs-on.  Callers must have an Access Level of 1 or
  812. higher to access this option.
  813.  
  814.     [L]  List Members:  Displays the membership list.
  815.  
  816.     [M]  Go to the MESSAGE BASE menu.  (See "Message Base Menu")
  817.  
  818.     [O]  Message Packer:  Go to the MESSAGE PACKER menu.  (See "Message Packer
  819. Menu")
  820.  
  821.     [R]  Read E-mail:  Read any private E-mail in your mailbox.
  822.  
  823.     [S]  Send E-mail:  Send e-mail to anyone on the system.  Callers must
  824. have an Access Level of 1 or higher to access this option.
  825.  
  826. ^^  [U]  Usage Logs:  View system logs.  To access this option, Callers
  827. must have an Access Level equal to or greater than the access level you
  828. assign to the DOS DOORWAY option in MacroBBS's config module.
  829.  
  830.     [V]  Version/BBS:  Displays the version of MacroBBS you are using.
  831.  
  832.     [X]  Xpert Toggle:  Toggles between full menus and no menus (prompts only).
  833.  
  834.     [Y]  Your Config:  Displays a menu that lets the Caller change
  835. his/her password, location, and other config settings.
  836.  
  837.  
  838.  
  839.             (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  840.  
  841.                                     MacroBBS                          Page 14
  842.  
  843.  
  844.                                MESSAGE BASE MENU
  845.                                -----------------
  846.  
  847.     The Message Base is my personal favorite.  I spent a lot of time devel-
  848. oping this routine and have big plans for its improvement in the next release
  849. of MacroBBS.  Keep an eye out for this one!
  850.  
  851. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  852. |  Rock #1                              AL=999   LOCAL   0 mins
  853. |  Jeff Oberlee  -  Lansing, MI
  854. +----------------------------------------------------------------------------
  855.  
  856.  
  857.  
  858.              +---------------------------------------------------+
  859.              | ################## Message Base ################# |
  860.              +---------------------------------------------------+
  861.                [<] Reverse       [A] Area List       [>] Forward
  862.  
  863.           [U] Upload a message     [T] Tag areas        [O] Message Packer
  864.           [P] Post a message       [R] ReviewScan       [F] File Base
  865.           [N] NewScan ALL areas    [C] Chat             [H] Hall of Fame
  866.           [S] NewScan THIS area    [X] Xpert Toggle     [Q] MAIN MENU
  867.  
  868.                        Enter a command or message number.
  869.  
  870. Message Base
  871. [General Stuff]   4:01 pm
  872. Msg(s): 1-9  Last read: 9
  873. Mins Left: 60
  874. MB Command: _
  875. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  876.  
  877.   Option description:
  878.  
  879.     [A]  Area List:  Displays a list of available Message Areas.  Only the
  880. areas the Caller has access to will be displAyed (determined by the Caller's
  881. Access Level and the Message Areas' Access Levels).
  882.  
  883.     [C]  Chat:  Allows the ON-LINE Caller to request chat (with you).
  884.  
  885.     [F]  File Base:  Go to the File Base.
  886.  
  887.     [H]  Hall of Fame:  Go to the Hall of Fame.
  888.  
  889.     [N]  NewScan TAGGED areas:  Displays messages with respect to the
  890. Caller's "last read" message pointers for each TAGGED message area. (See
  891. "Tag" below.)  This will continue until all of the Caller's tagged areas
  892. have been scanned.  To abort this scan, select option "Q" (Quit) from
  893. the READ menu.
  894.  
  895.     [P]  Post in this area:  Post a public message in the current area.
  896. Callers must have an Access Level of 1 or higher to post a message.
  897. NOTE: The name of the current area appears in square brackets next to the
  898. time.  (See above diagram.)
  899.  
  900.  
  901.                                     MacroBBS                          Page 15
  902.  
  903.     [Q]  MAIN MENU  Go to the Main Menu.
  904.  
  905.     [R] ReviewScan (brief):  Display a list of message headers.
  906.  
  907.     [S]  NewScan THIS area:  Displays messages with respect to the Caller's
  908. "last read" message pointer.  If message 2 was the last read message, display
  909. would begin at message 3 and continue to the last message in the current
  910. area.  To abort this scan, select option "Q" (Quit) from the READ MENU.
  911.  
  912.     [T] Tag Areas:  Callers will use this option to mark (tag) the
  913. message areas to be included  in their global message base NewScan.
  914.  
  915.     [X]  Xpert Toggle:  Toggles between full menus and no menus (prompts only).
  916.  
  917.     [>] Forward:  Jump forward one area.
  918.  
  919.     [<] Reverse:  Jump back one area.
  920.  
  921.     READ MENU
  922.     ---------
  923.  
  924.     After a message is displayed, the READ MENU is displayed:
  925.  
  926. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  927. Read Menu:  Reply, Prev, Again, Next, Trace, Jump, Sysop or Quit? _
  928. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  929.  
  930.   Option description:
  931.  
  932.     [A]  Again:  Re-displays the current message.
  933.  
  934.     [J]  Jump:  Jumps to the specified message number, if it exists.
  935.  
  936.     [N]  Next:  Displays the Next message in the current area, if it exists.
  937.  
  938.     [P]  Prev:  Displays the Previous message in the current area,
  939.  
  940.     [Q]  Quit:  Aborts reading of messages/returns to the MESSAGE BASE MENU.
  941.  
  942.     [R]  Reply:  Reply to the current message.  Callers must have an Access
  943. Level of 1 or higher to reply to a public message.
  944.  
  945.     [S]  Sysop:  This option is only visible and accessible to those with
  946. an Access Level equal to or greater than the Access Level you specify in
  947. the MacroBBS configuration.
  948.  
  949.     [T]  Trace:  Auto-displays the message to which the current message is a
  950. reply.  Allows continued trace-back until the origin message is reached.
  951.  
  952. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  953. Sysop Menu:  Delete, Edit, Move or Quit? _
  954. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  955.  
  956.   Option description:
  957.  
  958.     [D]  Delete:  Delete the current message.
  959.  
  960.  
  961.                                     MacroBBS                          Page 16
  962.  
  963.     [E]  Edit:   Edit the current message.  Local mode uses {COMMO}'s built-in
  964. editor; remote uses MacroBBS's editor.
  965.  
  966.     [M]  Move:  Move the current message to another message area.
  967.  
  968.     [Q]  Quit:  Exits back to the READ MENU.
  969.  
  970.  
  971.  
  972.                                MESSAGE PACKER MENU
  973.                                -------------------
  974.  
  975.   The Message Packer was designed for those Callers who like to read
  976. messages offline.  I hope to program an automated reader/replier in
  977. the future.  Any and all ideas are welcomed.
  978.  
  979. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  980. |  Rock #1                              AL=999   LOCAL   0 mins
  981. |  Jeff Oberlee  -  Lansing, MI
  982. +----------------------------------------------------------------------------
  983.  
  984.  
  985.  
  986.              +---------------------------------------------------+
  987.              | ################# Message Packer ################ |
  988.              +---------------------------------------------------+
  989.  
  990.                 [A] Archiver                  [M] Message Base
  991.                 [T] Tag Areas                 [F] File Base
  992.                 [D] Download Packet           [Q] MAIN MENU
  993.  
  994.                         [C] Chat     [X] Xpert Toggle
  995.  
  996. Message Packer    4:01 pm
  997. Mins Left: 60
  998. MP Command: _
  999. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1000.  
  1001.   Option description:
  1002.  
  1003.     [A] Archiver:  Callers choose from your self-defined list of
  1004. archivers.  PkZip is the default unless the Caller specifies another
  1005. archiver from this list. (Edit this list via OFFLINE OPTION 3.)
  1006.  
  1007.     [C] Chat:  Allows the ON-LINE Caller to request chat (with you).
  1008.  
  1009.     [D] Download Packet: When selected, this option will display a chart
  1010. of all TAGGED message areas and the number of unread messages in each of
  1011. these areas.  If the Caller chooses to download the messages, they are
  1012. packed, archived with the default archiver, and sent to the Caller using
  1013. his/her default protocol.  Finally, the last-read message pointers are
  1014. updated.
  1015.  
  1016.     [F] File Base:  Go to the File Base.
  1017.  
  1018.     [M] Message Base:  Go to the Message Base.
  1019.  
  1020.  
  1021.                                     MacroBBS                          Page 17
  1022.  
  1023.     [Q] MAIN MENU  Go to the Main Menu.
  1024.  
  1025.     [T] Tag Areas:  Callers will use this option to mark (tag) the
  1026. message areas to be scanned for packing/downloading.
  1027.  
  1028.     [X] Xpert Toggle:  Toggles between full menus and no menus (prompts only).
  1029.  
  1030.  
  1031.  
  1032.                                  FILE BASE MENU
  1033.                                  --------------
  1034.  
  1035. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1036. |  Rock #1                              AL=999   LOCAL   0 mins
  1037. |  Jeff Oberlee  -  Lansing, MI
  1038. +----------------------------------------------------------------------------
  1039.  
  1040.  
  1041.              +---------------------------------------------------+
  1042.              | ################### File Base ################### |
  1043.              +---------------------------------------------------+
  1044.                [<] Reverse       [A] Area List       [>] Forward
  1045.  
  1046.         [L] List this area's files   [P] Protocol Menu    [M] Message Base
  1047.         [U] UPLOAD (give) a file     [C] Chat             [H] Hall of Fame
  1048.         [D] DOWNLOAD (take) a file   [X] Xpert Toggle     [Q] MAIN MENU
  1049.  
  1050.  
  1051. File Base
  1052. [Miscellaneous Files]   4:46 pm
  1053. Mins Left: 60
  1054. FB Command: _
  1055. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1056.  
  1057.   Option description:
  1058.  
  1059.     [A]  Area List:  Displays a list of available File Areas.  Only the
  1060. areas the Caller has access to will be displAyed (determined by the Caller's
  1061. Access Level and the File Areas' Access Levels).
  1062.  
  1063.     [C]  Chat:  Allows the ON-LINE Caller to request chat (with you).
  1064.  
  1065.     [D]  DOWNLOAD (take) a file:  Allows Callers to take a copy of a file
  1066. listed in a file area.
  1067.  
  1068.     [H]  Hall of Fame:  Go to the Hall of Fame.
  1069.  
  1070.     [L]  List this area's files:  Displays the list of all files in the
  1071. current area.  NOTE:  The current area appears in square brackets next to the
  1072. time.  (See above diagram.)
  1073.  
  1074.     [M]  Message Base:  Go to the Message Base.
  1075.  
  1076.     [P]  Protocol Menu:  Go to the file transfer protocol selection menu.
  1077.  
  1078.     [Q]  MAIN MENU:  Go to the Main Menu.
  1079.  
  1080.  
  1081.                                     MacroBBS                          Page 18
  1082.  
  1083.     [U]  UPLOAD (give) a file:  Allows Callers to give files to your BBS
  1084.  
  1085.     [X]  Xpert Toggle:  Toggles between full menus and no menus (prompts only).
  1086.  
  1087.     [>] Forward:  Jump forward one area.
  1088.  
  1089.     [<] Reverse:  Jump back one area.
  1090.  
  1091.  
  1092.  
  1093.                                 THE HALL OF FAME
  1094.                                 ----------------
  1095.  
  1096.     This section of MacroBBS allows Callers to answer a set of questions you
  1097. define in the file QUESTION.DAT.  This feature serves to help your Callership
  1098. get to know one another by allowing CALLER A to "look-up" CALLER B's entry,
  1099. thereby learning something about him/her.  Answering these questions may be
  1100. entirely voluntary (but then, some Callers won't bother).  Or you could make
  1101. it a requirement for a Caller to do so before he/she receives higher access
  1102. to your BBS (a Communist form of control, but hey; it's your BBS! :)  The
  1103. choice is yours.  As it stands, the Hall of Fame is accessible only to
  1104. Callers with an Access Level of 1 or higher.
  1105.  
  1106. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1107. |  Rock #1                              AL=999   LOCAL   0 mins
  1108. |  Jeff Oberlee  -  Lansing, MI
  1109. +----------------------------------------------------------------------------
  1110.  
  1111.  
  1112.              +---------------------------------------------------+
  1113.              | ###########  H A L L   O F   F A M E  ########### |
  1114.              +---------------------------------------------------+
  1115.  
  1116.         [E] Enter your info      [V] View an entry    [M] Message Base
  1117.         [D] Display Your entry   [C] Chat             [F] File Base
  1118.         [U] Update your entry    [X] Xpert Toggle     [Q] MAIN MENU
  1119.  
  1120.  
  1121. Hall of Fame   4:54 pm
  1122. Mins Left: 60
  1123. HOF Command: _
  1124. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1125.  
  1126.     A sample QUESTION.DAT file has been included.  Its straight ASCII format
  1127. allows for easy editing.  Each question requires TWO lines:
  1128.  
  1129. 1: Maximum number of characters that can be used to answer the question
  1130.     (i.e. 15)
  1131. 2: The question (or PROMPT)
  1132.    (i.e.  Real Name)
  1133.  
  1134. /\/\/\/\/\/\/\
  1135. 15
  1136. Real Name
  1137. 20
  1138. Date of Birth
  1139.   .
  1140.  
  1141.                                     MacroBBS                          Page 19
  1142.   .
  1143.   .
  1144. 50
  1145. Personal Note
  1146. /\/\/\/\/\/\/\
  1147.  
  1148.     You may have as many questions as you want, but the more you have, the
  1149. longer it takes to display.  I recommend using the sample QUESTION.DAT
  1150. file as a guideline for both format AND length (number of questions).
  1151.  
  1152.  
  1153.  
  1154.                                   REMOTE CONFIG
  1155.                                   -------------
  1156.  
  1157.     This menu is a near-clone of the OFFLINE MASTER SYSMENU, reworked to
  1158. allow remote configuration of File Areas, Message Areas, and/or Caller
  1159. Records.
  1160.  
  1161. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1162. |  Rock #1                              AL=999   LOCAL   0 mins
  1163. |  Jeff Oberlee  -  Lansing, MI
  1164. +----------------------------------------------------------------------------
  1165.  
  1166.  
  1167.   Master SysMenu
  1168.  
  1169.  1. File Areas
  1170.  3. Message Areas
  1171.  4. Caller Records
  1172.  
  1173.   1-4, ENTER=quit:
  1174. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1175.  
  1176.  
  1177.                                ON-LINE SYSOP MENU
  1178.                                ------------------
  1179.  
  1180.     Press the ESCape key at any time to pop-up a window in the middle of the
  1181. screen.  Your location in MacroBBS determines what will appear in this
  1182. window.  Under normal circumstances, the ON-LINE SYSOP MENU will appear:
  1183.  
  1184. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1185.             PRESS:  [ENTER] to CHAT, [U]seredit, [D]OS, [H]angup
  1186.  
  1187.       >..............................................................
  1188.  
  1189.                            Press [Esc] to cancel
  1190. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1191.  
  1192.   Option Description:
  1193.  
  1194.     [ENTER] to CHAT:  Press ENTER to initiate CHAT MODE.  This function is
  1195. disabled when you access this menu from within CHAT MODE.
  1196.  
  1197.     [D]OS:  Shell to DOS
  1198.  
  1199.     [H]angup (reset):  Press the letter H to Hangup/reset MacroBBS.
  1200.  
  1201.                                     MacroBBS                          Page 20
  1202.  
  1203.     [U]seredit:  Press the letter U to edit the ON-LINE Caller's system info
  1204. (to change handle, raise/lower Access Level, etc.)  You are prompted with the
  1205. current data.  Press ENTER to keep it and go to the next data field, or use
  1206. the BACKSPACE key to erase the old data then type in the new data and press
  1207. ENTER.  Changes take effect immediately.  Handle changes take the most time,
  1208. as there are several system files that must be updated.  BE PATIENT!
  1209.     This function is disabled when a system file is open.  This will be the
  1210. case when you "break-in" to chat while an external file is displaying.  If
  1211. you were to initiate CHAT MODE halfway through the display of a message (in
  1212. the Message Base), that file will be left open and the [U]seredit option
  1213. will be unavailable until the file is allowed to finish displaying.
  1214.  
  1215.     Press [Esc] to cancel:  Press the ESCape key to exit the ON-LINE SYSOP
  1216. MENU.
  1217.  
  1218.   *  IMPORTANT:  If you press ESCape and see this:
  1219.  
  1220. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1221.                        A macro is running.  Terminate it?
  1222.  
  1223.                                      [y/N]
  1224. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1225.  
  1226.     ...answer NO by pressing the letter N or by pressing ENTER.  If you want
  1227. to hangup/reset the BBS, press the letter Y (for YES).  But be warned that an
  1228. on-line Caller will be hung-up on and, under certain circumstances, the BBS
  1229. will "crash" due to an open file that was not closed before resetting.  Your
  1230. best bet is to avoid this situation altogether by answering NO to the above
  1231. prompt.  (See "In the Unlikely Event of a Crash")
  1232.  
  1233.  
  1234.  
  1235.                                    CHAT MODE
  1236.                                    ---------
  1237.  
  1238.     When a Caller wants to chat with you, he/she may page you by selecting
  1239. option C from one of the menus.  If you, for some reason, do not answer the
  1240. chat request, the chat flag will be set for as long as the Caller remains
  1241. on-line.  "CHAT" appears on the upper-right status line to let you know of
  1242. the chat request.  To answer a chat request or to "break-in" at almost any
  1243. time, press the ESCape key and then press ENTER.  This will bump you and the
  1244. on-line Caller into chat mode:
  1245.  
  1246. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1247. You've just entered . . . The Twilight Zone.  Reality vanishes.
  1248. (Type "bye!" on a blank line to return to the BBS when desired.)
  1249.  
  1250. _
  1251. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  1252.  
  1253.   Available commands:
  1254.  
  1255.     bye!   -  Exits CHAT MODE.
  1256.  
  1257.     bye!!  -  Terminates the call (hangs-up).
  1258.  
  1259.  
  1260.  
  1261.                                     MacroBBS                          Page 21
  1262.  
  1263.    /c      -  Displays a small number/color chart.  Choose from 0 to 7.
  1264.               Color changes are only remembered for the duration of the
  1265.               current chat session.
  1266.  
  1267.    /scroll -  Allows you to access {COMMO}'s scrollback buffer.
  1268.  
  1269. * NOTE:  You do not have to leave CHAT MODE to use the ON-LINE SYSOP MENU.
  1270. Press the ESCape key to:  1) edit the current Caller's info (change handle,
  1271. raise or lower Access Level, etc), 2) shell to DOS, or 3) hang-up (reset the
  1272. BBS).  Press ESCape again to return to CHAT MODE.
  1273. - NOTE: The "ENTER to CHAT" option is disabled when you are already in CHAT
  1274. MODE.  Press ESCape again to exit the ON-LINE SYSOP MENU and return to CHAT
  1275. MODE.
  1276.  
  1277.     All CHAT MODE commands must be entered on a blank line followed by a
  1278. press of the ENTER key.
  1279.  
  1280. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  1281. bye! <press ENTER>
  1282.  
  1283.  
  1284. You've just left . . . The Twilight Zone.  Reality restored.
  1285. /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  1286.  
  1287.  
  1288.  
  1289.                           EXTERNAL PROYOCOLS AND DOORS
  1290.                           ----------------------------
  1291.  
  1292.     Setting-up external protocols and door programs in MacroBBS is
  1293. really quite simple.  First, get yourself into the MacroBBS
  1294. configuration module and select option 4 or 5, depemding on what you
  1295. want to set-up.  Once in the specific config aeaa, choose a letter from
  1296. "A" to "Z" that you want to assign to your door or protocol.  This
  1297. letter will appear on the appropriate ONLINE BBS memu (ie. it's the
  1298. letter a Caller must type to select the external program from your
  1299. menu.)  If a definition file for the letter you select already exists,
  1300. you have the option of zborting the procedure, deleting the "old"
  1301. definition, or editing it.  Next, give your definition an English (or
  1302. French!) menu name. Then supply the path information, command line
  1303. parameters, and for external DOORS, selrct a "dropfile" whether or not
  1304. your external program requires one.
  1305.     At this point, you will be teleported to {COMMO}'s internal editor to
  1306. EDIT the main definition control file.  Just follow the on-screen
  1307. instructions, do whateever editing is needed, then press your ESCzpe
  1308. key to save/exit.
  1309.     That's all!  Provided that you set-up everything correctly, you will
  1310. have a new menu option!  If you have problems getting it working, read
  1311. your program's docs THOROUGHLY.
  1312.  
  1313. NOTE: Bi-directional transsfer protpcls will work bi-directionally whrn
  1314. set-up as a DOOR rather than a protocol.  The advantage is in NNT having
  1315. to specify a filename to upload (or download).  Special thanks to Jeff
  1316. Liddle of Alabama for his help in testing BiModem as a door with
  1317. MacroBBS.
  1318.  
  1319.  
  1320.  
  1321.                                     MacroBBS                          Page 22
  1322.  
  1323.  
  1324.                         IN THE UNLIKELY EVENT OF A CRASH
  1325.                         --------------------------------
  1326.  
  1327.     Due to the limited nature of the {COMMO} macro language and MY
  1328. limitations as a programmer therein, there are some circumstances under
  1329. which a macro error will occur and MacroBBS will "crash."
  1330.  
  1331.   1.  A previously mentioned cause of a system crash is answering YES to the
  1332. "A macro is running.  Terminate it?"-prompt you may get when pressing ESCape.
  1333. If you answer YES to this prompt, you may get a beep and a screen-full of
  1334. macro language along with the notification that a macro error has occurred:
  1335. "a file is already open," or possibly "a file is not open."
  1336.  
  1337.     If a macro error occurs:
  1338.  
  1339.         *   press the ESCape key to clear the error, then press ESCape again
  1340.             to close the macro file.
  1341.  
  1342.         *   Next, press ALT-U to reset MacroBBS.
  1343.  
  1344.   2.  Another problem will sometimes occur when a Caller hangs-up (drops
  1345. carrier) at a time when MacroBBS cannot detect the loss.  This may result in
  1346. a "hang" -- the phone is off the hook with no one on-line.  If it occurs at
  1347. all, this condition will occasionally remedy itself (if MacroBBS does
  1348. eventually detect the loss of carrier).  But if the loss goes undetected,
  1349. manual reset is necessary.
  1350.  
  1351.     If MacroBBS is "hanging":
  1352.  
  1353.         *   press ESCape.  You will be presented with either the ON-LINE
  1354.             SYSOP MENU or "A macro is running.  Terminate it?"  If you get
  1355.             the ON-LINE SYSOP MENU, hangup/reset MacroBBS by pressing the
  1356.             letter H and then press ENTER.  Otherwise, answer YES to the "A
  1357.             macro is running..." prompt.  MacroBBS SHOULD reset normally.  If
  1358.             a macro error occurs, refer to the solution to problem #1 above.
  1359.  
  1360.  
  1361. IF MACROBBS WON'T RUN ON YOUR SYSTEM:
  1362.  
  1363.     1.  Make sure the SETUP steps were properly followed.
  1364.  
  1365.     2 .  Make sure your {COMMO} dialing dir isn't too huge.  {COMMO} macro
  1366. files must SHARE 64k with the dial dir, and considering that MACROBBS.MAC is
  1367. approximately 60k, your dial dir should not exceed 4k.  If it does, try
  1368. weeding-out unused numbers. (I had to. :)
  1369.  
  1370.     3.  Make sure the directories you specified in the MacroBBS configuration
  1371. do indeed exist on your disk.  (And make sure you're using the disk directory
  1372. that contains your {COMMO} system files.}
  1373.  
  1374.     4.  If you still can't get it working, my BBS number is (517) 323-3405.
  1375. I'll be glad to help if I can!
  1376.  
  1377.  
  1378.  
  1379.             (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  1380.  
  1381.                                     MacroBBS                          Page 23
  1382.  
  1383.  
  1384. III *****
  1385.     NOTES
  1386. *********
  1387.  
  1388.  
  1389.   *  ASCII/ANSI screens
  1390.  
  1391.     The log-on, new caller welcome, and log-off screens are fully editable.
  1392. I encourage everyone to personalize MacroBBS for themselves by designing a
  1393. log-on and log-off screen.  Use any of a number of ANSI editing programs,
  1394. such as AnsiPaint or The Draw.
  1395.  
  1396.     LOGONA.MNU   - ASCII (A) log-on welcome screen
  1397.     LOGONN.MNU   - ANSI (N) log-on welcome screen
  1398.     LOGOFFA.MNU  - ASCII (A) log-off screen
  1399.     LOGOFFN.MNU  - ANSI (N) log-off screen
  1400.     NEWUSERA.MNU - ASCII (A) screen displayed to NEW Callers.
  1401.     NEWUSERN.MNU - ANSI (N) screen displayed to NEW Callers.
  1402.  
  1403. These files are located in the "MACROBBS" subdirectory.
  1404.  
  1405. * NOTE:  Because MacroBBS uses the ASCII UPLOAD function to send the log-on 
  1406. and log-off screens over the modem, you may want to turn off the ASCII UPLOAD
  1407. FINISHED ALARM (afa) in the "SOUNDS" section of {COMMO}'s set-up file (ALT-G
  1408. from the terminal screen).  The alarm causes a short delay at log-on that you
  1409. may not want.  To disable this alarm, find the ASCII UPLOAD FINISHED ALARM
  1410. setting [afa=yes], then simply replace the YES with a NO.  The setting should
  1411. read:  [afa=no] ... Then restart {COMMO} to initiate the change.  The alarm
  1412. will not sound after the log-on screen is displayed, if the change was made
  1413. correctly.  You MUST reboot {COMMO} or the change will not take effect.
  1414.  
  1415.  
  1416.   *  Access Levels
  1417.  
  1418.     A NEW Caller starts with an Access Level of 0.  The reason for this is
  1419. clear enough.  If someone calls your BBS with disaster in mind, an AL of 0
  1420. prevents them from being able to do damage.  The only time this person would 
  1421. be allowed to WRITE to your disk is at log-off -- to leave you a note.  If 
  1422. he/she had write access to your message or file base, the person could make a
  1423. mess.  Be somewhat careful who you give access to.
  1424.  
  1425.     Remember:
  1426.  
  1427.         -  An AL of 1 is all that's needed to send e-mail to anyone, UL/DL,  
  1428.            and access the Hall of Fame.  The individual MESSAGE AREA and FILE
  1429.            AREA AL's will, of course, keep out those with insufficient AL's.
  1430.  
  1431.         -  AL's may be edited on-line (see "ON-LINE SYSOP MENU")  If you want
  1432.            to give or take away access, you can always do so by adjusting the
  1433.            person's AL.
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.             (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  1440.  
  1441.                                     MacroBBS                          Page 24
  1442.  
  1443.   *  E-mail
  1444.  
  1445.     The E-mail system works much like the Message Base, with one exception:
  1446. it's private.  Only you (the Sysop) and the person an E-mail message is sent
  1447. to can read that message.
  1448. IMPORTANT:  To avoid disk clutter, a Caller's mailbox is "cleaned-out" when
  1449. he/she logs-off.  Example:  If a Caller logs-on to your system to find he/she
  1450. has two E-mail letters in his/her E-mailbox, those two letters will be 
  1451. deleted at log-off whether or not they were read by the Caller.
  1452.  
  1453.  
  1454.   *  QuotED  (by Dennis Boone)
  1455.  
  1456.     QuotED is an all-purpose quote generating program that keeps track of the
  1457. last-used quote in order to not repeat or avoid quotes (as "random" quote 
  1458. generators all-too-often do).  QuotED reads sequentially from the first 
  1459. quote to the last, then cycles back to the first.  The included QUOTES.BBS
  1460. file boasts a straight ASCII format and is therefore EASY to edit.  Use your 
  1461. favorite ASCII editor to add, edit, and delete quotes as you see fit.  For
  1462. additional information, refer to the brief documentation file QUOTED.DOC.
  1463.  
  1464.     QuotED is a shareware program and may be used for other purposes, 
  1465. provided these purposes do not infringe upon the author's copyright.
  1466.  
  1467.  
  1468.  
  1469.                                 ACKNOWLEDGEMENTS
  1470.                                 ----------------
  1471.  
  1472.    Extra SPECial thanks to my Dear friend, Mary "Funny Girl" Palmer, former
  1473. SysOp of THE ZOO.  Without her encouragement and "prodding," MacroBBS would
  1474. never have developed as it did.  Thamk you, hon!
  1475.  
  1476.    Special thanks also to my good friends, Kip, former SysOp of THE
  1477. KIPSTER DOME, Dennis Boone, Jeff Liddle, and Erik Kremswreiter.  Without
  1478. their faithful assistance in testing MacroBBS, I would surely be lost.
  1479.  
  1480. Technical support:    Dennis Boone    -  Author of QuotED
  1481.                       Joe Norton
  1482.                  &    Mark Martin     -  Sysop of The Safe House
  1483.                                          Phone: (517) 484-2397
  1484.  
  1485.  
  1486. Many thanks to all those who have helped more than they'll know with
  1487. suggestions, comments, and donations.  Thank you!
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.            (C) Copyright 1992,93 by Jeff Oberlee - All Rights Reserved
  1500.  
  1501.  
  1502.