home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / SIMPDOC4.ZIP / SIMPLEX.DOC next >
Text File  |  1991-07-15  |  169KB  |  3,945 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.            ┌───────┐ ┌─┐ ┌─────────┐ ┌──────┐ ┌─┐      ┌──────┐ ┌─┐   ┌─┐           ┌───────┐ ┌─┐ ┌─────────┐ ┌──────┐ ┌─┐      ┌──────┐ ┌─┐   ┌─┐
  8.            │ ┌─────┘ │ │ │ ┌─┐ ┌─┐ │ │ ┌──┐ │ │ │      │ ┌────┘ └┐└┐ ┌┘┌┘           │ ┌─────┘ │ │ │ ┌─┐ ┌─┐ │ │ ┌──┐ │ │ │      │ ┌────┘ └┐└┐ ┌┘┌┘
  9.            │ └─────┐ │ │ │ │ │ │ │ │ │ └──┘ │ │ │      │ └──┐    └┐└─┘┌┘           │ └─────┐ │ │ │ │ │ │ │ │ │ └──┘ │ │ │      │ └──┐    └┐└─┘┌┘
  10.            └─────┐ │ │ │ │ │ └─┘ │ │ │ ┌────┘ │ │      │ ┌──┘    ┌┘┌─┐└┐           └─────┐ │ │ │ │ │ └─┘ │ │ │ ┌────┘ │ │      │ ┌──┘    ┌┘┌─┐└┐
  11.            ┌─────┘ │ │ │ │ │     │ │ │ │      │ └────┐ │ └────┐ ┌┘┌┘ └┐└┐           ┌─────┘ │ │ │ │ │     │ │ │ │      │ └────┐ │ └────┐ ┌┘┌┘ └┐└┐
  12.            └───────┘ └─┘ └─┘     └─┘ └─┘      └──────┘ └──────┘ └─┘   └─┘           └───────┘ └─┘ └─┘     └─┘ └─┘      └──────┘ └──────┘ └─┘   └─┘
  13.  
  14.  
  15.                               Simplex BBS - (c) 1989-91
  16.                       Chris Laforet Software/Christopher Laforet
  17.                                 All Rights Reserved.
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                          Chris Laforet can be contacted at:
  28.  
  29.                The Programmer's Oasis BBS - Graham, NC - 919/226-6984
  30.               The Programmer's Oasis 2 BBS - Graham, NC - 919/226-7136
  31.                 FidoNet Mail 1:151/401 or 1:151/402 as Chris Laforet
  32.                         CompuServe Email - User ID: 76120,110
  33.                            Genie Email - User ID: XTX74591
  34.                             BIX Email - User ID: laforet
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                             Programming by Chris Laforet
  41.                        Unauthorized Selling/Renting Prohibited
  42.                Documentation Title Page/Help Files/Etc by Robbie Foust
  43.  
  44.  
  45.  
  46.  
  47.  
  48.           _________________________________________________________________
  49.  
  50.                                       Chapter 1                                      Chapter 1
  51.  
  52.                                Legalistic Mumbo-Jumbo                               Legalistic Mumbo-Jumbo
  53.           _________________________________________________________________
  54.  
  55.  
  56.  
  57.  
  58.           Simplex is copyright (c) 1989-91, Chris Laforet Software and/or
  59.           Christopher Laforet.  This copyright is waived for the
  60.           distribution of the executable files for Simplex.  This means
  61.           that you are free to distribute the Simplex executables as you
  62.           wish as long as they are contained in the original form in which
  63.           you received them.
  64.  
  65.           Simplex executables as released by Chris Laforet Software are
  66.           absolutely free of charge to individuals and corporations.  Sale
  67.           of any of these executables is in violation of this agreement and
  68.           is subject to court action.  The only exception to this is
  69.           shareware and freeware software distribution houses are allowed
  70.           to charge for distribution materials (e.g. diskettes).  Even
  71.           though it is free for use, if you feel the need to send a
  72.           contribution, be assured that it will be cheerfully accepted!
  73.  
  74.           The source code for Simplex is available for purchase from Chris
  75.           Laforet Software.  When you purchase this code, you are granted
  76.           an exclusive license to modify it for your own use.  The
  77.           executables that you produce must never be distributed in place
  78.           of the original executables as compiled and distributed from
  79.           Chris Laforet Software unless you arrange a royalty system with
  80.           Chris Laforet Software.  During the course of your modifications,
  81.           should you develop a feature which you believe should be a part
  82.           of the distributed Simplex executables, you may submit the code
  83.           to Chris Laforet Software for review and for possible
  84.           incorporation into Simplex, as long as such incorporation does
  85.           not place Chris Laforet Software and/or Christopher Laforet under
  86.           any monetary obligations.  Your submitted code must include a
  87.           cover letter indicating that you are freely granting permission
  88.           to Chris Laforet Software for the incorporation of your code into
  89.           Simplex.
  90.  
  91.           Should you wish to purchase Simplex for use as a platform for
  92.           another product, or wish to convert Simplex to another language
  93.           (French, Japanese, Swahili) or to another operating system (Atari
  94.           ST, VAX, AX-400), and wish to market the resultant product,
  95.           contact Chris Laforet Software and a royalty agreement can be
  96.           developed.  Royalties generally range somewhere between 10% and
  97.           15% of the sales price of the product, but each case is different
  98.           and merits discussion.
  99.  
  100.  
  101.  
  102.  
  103.                   --------------------------------------------------
  104.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  105.                                         Page 2                                        Page 2
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.           There are no warranties of any kind, explicit or implied, on the
  113.           Simplex software.  Simplex's executables are provided on an "AS
  114.           IS" basis.  What this means is that if you decide to use Simplex,
  115.           it is at your own risk.  In plain English, this means that if you
  116.           use Simplex and your machine blows up, the developers and
  117.           distributors of Simplex are not responsible in any fashion.  If
  118.           you use Simplex and it loses all of the files on your disk, once
  119.           again the developers and distributors of Simplex are not to be
  120.           held accountable.  While these scenarios are rather extreme in
  121.           nature, they serve to indicate that Chris Laforet Software and/or
  122.           Christopher Laforet does not warrant, guarantee, or make any
  123.           other representations regarding the use, or results of use, of
  124.           Simplex or its documentation in terms of accuracy, reliability,
  125.           correctness, currentness, or otherwise.
  126.  
  127.           Simplex has been developed and alpha tested on a 386-20 running
  128.           OS/2 1.xx.  Two copies of Simplex using US Robotics Courier HST
  129.           9600 baud modems run simultaneously 24 hours/day on this setup.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.                   --------------------------------------------------
  167.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  168.                                         Page 3                                        Page 3
  169.  
  170.  
  171.  
  172.  
  173.  
  174.           _________________________________________________________________
  175.  
  176.                                       Chapter 2                                      Chapter 2
  177.  
  178.                                Introduction to Simplex                               Introduction to Simplex
  179.           _________________________________________________________________
  180.  
  181.  
  182.  
  183.  
  184.           Simplex is a package created for the running of a Bulletin Board
  185.           System (BBS).  The development of Simplex arose out of Chris'
  186.           personal gripes insofar as his inability to either fix bugs or
  187.           add features to other BBS packages.  From the outset, Simplex was
  188.           designed to be an easy-to-use BBS system, with source code
  189.           available (at a price!) to anyone who might be interested.  On
  190.           the other hand, Simplex's executables are meant to be distributed
  191.           as public-domain material.  There are many good BBSes out there,
  192.           ones which have cost their SYSOPs (System Operators) lots of
  193.           money to purchase the necessary hardware.  There is no reason on
  194.           earth why they also have to ante up lots of money for their BBS
  195.           software.
  196.  
  197.           Simplex is somewhat based on the user interface of QuickBBS.  It
  198.           is said that imitation is the sincerest form of praise, and it is
  199.           in praise of QuickBBS' logical user interface (like P for Pause!)
  200.           that Simplex emulates certain of its characteristics.
  201.  
  202.           Simplex is currently available for DOS or OS/2.  It is currently
  203.           being ported to UNIX also.  Simplex is going to be produced in a
  204.           multiuser version for OS/2 in the future.  There are no plans to
  205.           make the DOS version multiuser, but once it has been ported to
  206.           UNIX, Simplex should be multiuser there.
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.                   --------------------------------------------------
  230.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  231.                                         Page 4                                        Page 4
  232.  
  233.  
  234.  
  235.  
  236.  
  237.           _________________________________________________________________
  238.  
  239.                                       Chapter 3                                      Chapter 3
  240.  
  241.                                  Installing Simplex                                 Installing Simplex
  242.           _________________________________________________________________
  243.  
  244.  
  245.  
  246.  
  247.           DOS users of Simplex will require a FOSSIL driver such as Ray
  248.           Gwinn's excellent X00 package.  FOSSILs are available on most
  249.           BBSes and services.  A FOSSIL driver is a special program which
  250.           provides an interface to communications ports.  OS/2 users do not
  251.           have to use a fossil since OS/2 supports communications ports
  252.           with interrupt-driven drivers.
  253.  
  254.           Please take careful note:  Simplex users must have a modem which          Please take careful note:
  255.           is capable of CTS-RTS handshaking (many 2400 baud modems control
  256.           this with &R1).  Also, Simplex requires that DTR controls the
  257.           on-line state of the modem (most 2400 baud modems control this
  258.           with &D2) and CD (carrier detect) must correctly follow the
  259.           remote's carrier (controlled with &C1 om many 2400 baud modems).
  260.           Without these criteria being met, Simplex probably will not work
  261.           on your system.
  262.  
  263.           DOS users of Simplex must set up to have a sufficient number of
  264.           file handles available for Simplex to run.  This is done by
  265.           editing/creating a file called CONFIG.SYS which is found in the
  266.           root directory of the boot drive (A: or C:) and ensuring that
  267.           there is an entry that sets files greater than or equal to 30.
  268.           If it is there, but less than 30, change it to 30.  If it is not
  269.           there, add a line that says:
  270.  
  271.                   files=30
  272.  
  273.           and then save your changes.  The machine must then be rebooted to
  274.           install the changes.  OS/2 users of Simplex do not have to do
  275.           anything special to raise their file handles.
  276.  
  277.  
  278.  
  279.           3.1-Simplex and Answering the Phone          3.1-Simplex and Answering the Phone
  280.           _________________________________________________________________
  281.  
  282.  
  283.  
  284.  
  285.           Simplex will answer the phone by itself as long as your modem
  286.           returns string results (like Hayes).  In CONFIG you can configure
  287.           your modem's strings for Simplex to monitor.  If you are running
  288.           a FidoNet node, then you will probably have a front-end mailer
  289.  
  290.  
  291.  
  292.                   --------------------------------------------------
  293.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  294.                                         Page 5                                        Page 5
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.           answer the phone for you.  See below for more details of using a
  302.           mailer.
  303.  
  304.           If you are running Simplex as a simple host program, you might
  305.           want to use the ringback feature.  This feature permits you to
  306.           use your voice line for your host and not have to worry too much
  307.           about your modem answering the phone and surprising one of your
  308.           friends!  How this works is that a person wishing to call your
  309.           host rings the number and allows it to ring less than 5 times.
  310.           This will then arm the answer feature.  They can then call back
  311.           in less than 40 to 50 seconds and the modem will answer them.
  312.           After they hang up, the system will be back in an unarmed state.
  313.  
  314.  
  315.  
  316.           3.2-Setting Up Simplex BBS Paths          3.2-Setting Up Simplex BBS Paths
  317.           _________________________________________________________________
  318.  
  319.  
  320.  
  321.  
  322.           Simplex should have a special directory for its configuration,
  323.           message, and userlist files.  This directory can be shared with
  324.           other programs if so desired (for example, with the front-end
  325.           mailer's configuration files).  It also requires a directory for
  326.           its menu files, a directory which should be used exclusively for
  327.           these files.  Simplex also requires a directory for its screen
  328.           files.  It is advisable to create 3 subdirectories, say \SIMPLEX
  329.           (for the configuration, message, and userlist files),
  330.           \SIMPLEX\MENUS (for the menu files), and \SIMPLEX\SCREENS (for
  331.           the screen files).
  332.  
  333.           Simplex and its utility programs respond to the SIMPLEX
  334.           environment variable (SET SIMPLEX=path of Simplex configuration
  335.           file).  It is advisable to place this set statement in your
  336.           autoexec.bat file (in DOS) or in your config.sys (in OS/2) so
  337.           that Simplex and its utilities can always find their home
  338.           directory.
  339.  
  340.           If you are planning to run a FidoNet node with Simplex, you also
  341.           need an inbound directory where your front-end mailer places
  342.           files bound for your node.  There also needs to be an outbound
  343.           directory in which your Simplex system will place files for your
  344.           front-end mailer to send to other nodes.  These could be called
  345.           \SIMPLEX\INBOUND and \SIMPLEX\OUTBOUND and must be set up in both
  346.           Simplex's configuration as well as your front-end mailer's
  347.           configuration.
  348.  
  349.           Simplex requires two other directories to handle its normal
  350.           FidoNet mail duties.  These are a matrix directory where it
  351.           tosses mail as standard FSC-0001 message files during
  352.  
  353.  
  354.  
  355.                   --------------------------------------------------
  356.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  357.                                         Page 6                                        Page 6
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.           exportation/forwarding, and a packet directory which it uses as a
  365.           scratch area while unpacking inbound mail.  These could be called
  366.           \SIMPLEX\MATRIX and \SIMPLEX\PACKET.  Please notice that Simplex
  367.           maintains its packet directory and thus it should only be used by
  368.           Simplex itself.
  369.  
  370.  
  371.  
  372.           3.3-Presumptions Underlying Simplex's Fidonet Mail          3.3-Presumptions Underlying Simplex's Fidonet Mail
  373.           _________________________________________________________________
  374.  
  375.  
  376.  
  377.  
  378.           Fidonet mail has been implemented in Simplex 1.04 with a number
  379.           of underlying presumptions.  The first and foremost of these is
  380.           that all users should have access to Fidonet mail.  The second of
  381.           these is that file attaching should be controllable by the Sysop
  382.           and access to this feature should be granted exclusively by
  383.           him/her.  The third of these is that when Echomail discussions
  384.           get off-topic, they should be taken to netmail.
  385.  
  386.           The first presumption is demonstrated when a user without mail
  387.           credit decides to enter a Fidonet message.  They are permitted to
  388.           send the message, but can only choose to send it as Routed mail
  389.           or as Held mail.  If the user has sufficient credit, they can
  390.           send it as Direct mail or either of the previous two types.
  391.  
  392.           Simplex looks at mail as a three-layered system.  These three
  393.           layers are as follows (compared with oMMM's mail extensions):
  394.  
  395.                     Direct Mail                   oMMM's CM
  396.                     Routed Mail                   oMMM's Normal
  397.                     Held Mail                     oMMM's Held
  398.  
  399.           Direct mail is mail that is intended to be sent DIRECTLY from
  400.           your node to the destination (whether this is indeed how it is
  401.           sent depends upon the Sysop!).  Routed mail is that which is
  402.           supposed to follow a routing path through the network.  Held mail
  403.           is that which is supposed to be held for pickup by another node
  404.           which polls yours at specific intervals.
  405.  
  406.           Notice that the three-layered system is all theoretical.  For
  407.           example, none of my nodes sends Netmail bound for international
  408.           locations directly to them, regardless of if the message was
  409.           specified as being Direct.  It is much cheaper to send direct
  410.           mail to the specified Zone gates and let them be routed from
  411.           there.  On the other hand, if someone enters a message to a local
  412.           node and specifies that it is to be Held, it is transformed to
  413.           Direct mail and sent immediately (since the node is local, it
  414.           doesn't cost anything, right?).
  415.  
  416.  
  417.  
  418.                   --------------------------------------------------
  419.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  420.                                         Page 7                                        Page 7
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.           The way that you implement the three-layered system is controlled
  428.           by your use of SMP (or SMP/2) to handles your specific routing
  429.           needs.  SMP's routing verbs are discussed later on in this file.
  430.  
  431.           The second presumption in Simplex is that the option to Netmail
  432.           file-attaching is under control of the Sysop.  How this control
  433.           is exerted is by means of a flag in the user's record.  The Sysop
  434.           must be careful with who is granted the privilege of file-
  435.           attaching since a hacker can easily file-attach critical files
  436.           (like userlist.bbs?) to themselves at another node if they have
  437.           any idea how your system is laid out!!  Please notice that the
  438.           local file-attaching feature works differently.  Only files from
  439.           a specific sysop-specified directory can be attached to another
  440.           user on the same system.
  441.  
  442.           The third presumption in Simplex is that Echomail discussions
  443.           should go over to Netmail when they start drifting off-topic.
  444.           This is implemented by a special option that appears while
  445.           reading Echomail messages which permits users to reply directly
  446.           to the message using Netmail.  Notice that the user can only
  447.           enter Routed or Held Netmail if they don't have enough/any
  448.           credit!
  449.  
  450.  
  451.  
  452.           3.4-Installing A Fidonet Node          3.4-Installing A Fidonet Node
  453.           _________________________________________________________________
  454.  
  455.  
  456.  
  457.  
  458.           If you want to use Simplex as a Fidonet node, you will need to
  459.           use some sort of a front-end mailer software such as BinkleyTerm
  460.           or FrontDoor.  This software is needed in order to handle mail
  461.           transactions between your node and other fidonet nodes.  Whatever
  462.           mailer you use must comply with oMMM message bundle formatting
  463.           (unless you choose to write a message handling interface between
  464.           your mailer and Simplex).
  465.  
  466.           Simplex needs a special directory which it uses as an interface
  467.           to the front-end mailer.  Traditionally, this directory has been
  468.           named the MATRIX directory.  This directory is used during the
  469.           exportation/forwarding of messages from Simplex to other nodes.
  470.           The format of these messages is the standard FidoNet message
  471.           format as outlined in their FSC-0001 standard (1.MSG, 2.MSG,
  472.           etc.).  These messages are then taken by mail bundlers such as
  473.           oMMM or SMP and bundled for the front-end mailer.  It is
  474.           essential that this directory not be used for anything else.
  475.  
  476.           Simplex also needs a special directory where inbound bundles and
  477.           message packets are placed.  Traditionally, this directory has
  478.  
  479.  
  480.  
  481.                   --------------------------------------------------
  482.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  483.                                         Page 8                                        Page 8
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.           been called INBOUND.  The front-end mailer will place the inbound
  491.           bundles in message packets here once they have been successfully
  492.           received.  Simplex's mail utilities will scan this directory for
  493.           any unpacked bundles or packets which it would proceed to unpack.
  494.           It is not essential that this area be used exclusively for
  495.           inbound mail since Simplex searches for bundles and packets based
  496.           on their file extensions.
  497.  
  498.           Simplex requires a special directory which can be used as a
  499.           "scratch" area.  This directory is essential and must be used
  500.           exclusively by Simplex.  It is suggested that you call this
  501.           directory PACKET since it is used to hold unarchived inbound mail
  502.           bundles.  This directory is essential because once the mail is
  503.           unarchived, the archives are deleted.  If the packets are not
  504.           unpacked for any reason, they will remain intact until Simplex's
  505.           mail utilities are run once again.  This directory along with the
  506.           inbound directory is searched for message packets every time
  507.           Simplex's mail utilities are run.
  508.  
  509.           All members of FidoNet are listed in a file called the Nodelist.
  510.           In order to be able to communicate with other nodes, BBS and
  511.           mailer software must have access to this nodelist.  Simplex is no
  512.           exception to this rule.  It requires that the nodelist be
  513.           compiled using any Version 6 nodelist compiler (Version 6
  514.           nodelists are used by BinkleyTerm, Opus, and many other FidoNet
  515.           utilities) such as ParseList.  Simplex must know exactly where to
  516.           find the compiled nodelist.
  517.  
  518.           Simplex requires a FidoNet node's address.  This address uniquely
  519.           identifies the node during communications with other FidoNet
  520.           nodes.  A FidoNet address consists of a Zone (read continent), a
  521.           Net, and a Node number such as 1:151/401 which identifies
  522.           Simplex's "home" node as being in Zone 1 (North America), Net 151
  523.           (Eastern North Carolina), and Node 401 in that net.  While use of
  524.           the Zone number is not absolutely essential at this time and it
  525.           is perfectly acceptable to list your Zone number as 0, such use
  526.           should be frowned upon in a network which is worldwide in nature!
  527.           Hence Simplex does somewhat attempt to enforce the use of the
  528.           Zone number.
  529.  
  530.  
  531.  
  532.           3.5-Configuring Simplex with CONFIG          3.5-Configuring Simplex with CONFIG
  533.           _________________________________________________________________
  534.  
  535.  
  536.  
  537.  
  538.           Configuration of Simplex is rather simple using CONFIG.EXE (in
  539.           OS/2 it is CONFIG2.EXE).  In DOS using some old CGA systems,
  540.           direct screen writes cause "snow" on the screen.  If you run
  541.  
  542.  
  543.  
  544.                   --------------------------------------------------
  545.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  546.                                         Page 9                                        Page 9
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.           CONFIG and get snow, exit and then run it with CONFIG -S to
  554.           enable retrace ("snow") checking.
  555.  
  556.           Essentially Simplex is a menu-driven program which is
  557.           straightforward to use with the following exceptions:
  558.  
  559.                 1.  When you make changes on a text field you MUST hit
  560.                     Enter on the field to keep them.
  561.                 2.  When you change a screen of options, you may hit hit
  562.                     Alt-X, Alt-Q or ESC to exit back to the menu and keep
  563.                     the changes.
  564.                 3.  When editing menus, pressing PgUp, PgDn, or Alt-X will
  565.                     keep the changes.  Pressing ESC aborts the changes on
  566.                     the current menu page only.
  567.                 4.  To go forwards to a specific field without affecting
  568.                     the contents of any other fields, press Tab.  To go
  569.                     backwards use Shift-Tab.
  570.                 5.  On multiple choice options, you may select the
  571.                     letter/number corresponding to the choice that you
  572.                     wish, hit Enter or Tab to skip past it without making a
  573.                     change, or hit Shift-Tab to skip back to the previous
  574.                     option.
  575.                 6.  On scrolling, light-bar menus, use your Arrow keys to
  576.                     select the option that you wish.  You may also hit the
  577.                     first letter of an option to get to the first option
  578.                     matching that letter.  Ctrl-PgUp and Ctrl-PgDn move a
  579.                     "page" of options at a time.
  580.                 7.  Always remember that your ESC key backs you out without
  581.                     saving changes!
  582.  
  583.           Option 1:  You must enter your BBS Name and Sysop Name.  If you
  584.           provide your Sysop name in the same form as your login, messages
  585.           addressed to Sysop will be directed to you.  If you run a Fidonet
  586.           node, then you must also provide your address and origin line to
  587.           use in Echomail messages.  This origin line will be appended to
  588.           the bottom of Echomail messages along with your node number
  589.           unless you have configured a special origin line along with the
  590.           message area (see option 6).
  591.  
  592.           Option 2:  This screen allows you to configure your modem
  593.           parameters.  You also can indicate if your modem is slow to
  594.           respond to commands, and set the minimum baud rate a user has to
  595.           have to log on to Simplex and the minimum baud a user has to have
  596.           in order to see ANSI color screens.  Notice that in modem
  597.           configuration strings the | character indicates Carriage Return
  598.           and the ~ character indicates a 0.5 second pause.
  599.  
  600.           Option 3:  This screen allows you to configure Simplex's usage
  601.           options.  Most are self-explanatory.  Private BBS operation means
  602.           that if someone is not on the nodelist they are not allowed to
  603.           log in.  Disable local keyboard means that by default the
  604.  
  605.  
  606.  
  607.                   --------------------------------------------------
  608.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  609.                                        Page 10                                       Page 10
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.           keyboard is disabled from being active while someone is logged in
  617.           (this can be toggled on and off with Alt-K while Simplex is
  618.           running.
  619.  
  620.           Option 4:  This screen allows you to configure Simplex's paths.
  621.           Some of the paths are only for FidoNet mail paths and can be
  622.           ignored if you are not going to run a FidoNet node.
  623.  
  624.           Option 5:  This screen allows you to configure the archiver
  625.           command lines for archivers available on your system.  This
  626.           option is needed for FidoNet nodes and for systems that allow
  627.           downloadable mail.  NOTICE: Archivers must exit with a 0
  628.           errorlevel if the archiving was a success.  Any other return
  629.           value is taken by Simplex to mean that the archiving process
  630.           failed.
  631.  
  632.           Option 6:  This section permits you to edit/add/delete message
  633.           boards for your Simplex system.  Use PgUp and PgDn keys to scroll
  634.           through each message board.  The number of the message board is
  635.           used in menu options.  Message boards may be numbered any value
  636.           from 1 through 9999, depending on your preferences.  The message
  637.           board name is shown to the user while reading messages.  Message
  638.           board types may be Local, FidoNet Mail (should only be one area
  639.           for FidoNet mail), Echomail, or Local Fileattach.  Message boards
  640.           may allow messages which are private only, public only, or both
  641.           public and private.  The read and write privilege levels are the
  642.           minimum user levels to be able to read and post messages on the
  643.           board.  The sysop privilege level is the minimum user level
  644.           required to have access to sysop's message options like Export
  645.           and Move messages.  If the area is an Echomail area, you can also
  646.           specify a special origin line to be used in lieu of the default
  647.           origin line for that area only.
  648.  
  649.           Option 7:  This section permits you to edit/add/delete file
  650.           boards for your Simplex system.  As in option 6, use PgUp and
  651.           PgDn to scroll through each file board.  The number of the file
  652.           board is used in menu options.  File boards may be numbered from
  653.           1 to 9999.  The file board name is shown to the user during
  654.           searches across areas.  The search privilege level is the minimum
  655.           user level needed in order to get access to the file area in
  656.           searches across areas.  The file path is the path to the file
  657.           area.  This area should contain files for the area along with a
  658.           FILES.BBS file (see description below).  In most cases the
  659.           alternate path to FILES.BBS should be left blank (it defaults to
  660.           the file area path), it is only included for special systems such
  661.           as CD-ROM units which must have a FILES.BBS in a directory on the
  662.           hard drive separate from the regular file path.
  663.  
  664.           Option 8:  This section allows you to edit/add/delete events for
  665.           your Simplex system.  The event title will be shown to the user
  666.           if their online time is going to be cut short by a pending forced
  667.  
  668.  
  669.  
  670.                   --------------------------------------------------
  671.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  672.                                        Page 11                                       Page 11
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.           system event.  You may select the weekdays and time that the
  680.           event is supposed to occur and the errorlevel that Simplex exits
  681.           with if the event occurs.  You may set an event to be forced or
  682.           not.  In Simplex, an event is "forced" if it will exit even if a
  683.           user is online.  If an event is not "forced", it will only exit
  684.           if Simplex is sitting idle when the event occurs.  Should you
  685.           wish to temporarily suspend an event without deleting, you may
  686.           mark it as not enabled.  PLEASE NOTICE THAT WHILE EVENTS DO NOT
  687.           EXIT WITH THIS RELEASE OF SIMPLEX, THEY WILL ACT TO LIMIT A USERS
  688.           TIME ONLINE AT SPECIAL TIMES OF THE DAY.
  689.  
  690.           Option 9:  This section allows you to edit/add/copy/delete menu
  691.           files.  Use of this section rather straightforward.  Follow the
  692.           prompts and help information.  While the menu editor is
  693.           convenient for small fixes, the Simplex Menu Compiler (SMC) is
  694.           more convenient for laying out complete menu systems.  Bear in
  695.           mind that some menu options require data to be provided in the
  696.           optional data field while others do not.  See below for more
  697.           details on menu types.  Two points that must be clarified here
  698.           are the use of the expert and autoexecute flags in menu lines.  A
  699.           user can toggle expert mode, a mode which should disable the
  700.           showing of menu options, only showing a list of hotkeys.
  701.           However, some lines of the menu should still show so that the
  702.           user knows where they are.  One of these should be the menu title
  703.           line.  Hence you can indicate with a "Yes" to the expert mode
  704.           question when you would like to show menu lines to the expert
  705.           mode user.  Autoexecuting menus options are done when the menu is
  706.           being shown.  Any menu type can be autoexecuting, however some
  707.           menu types do not make sense if they are automatic.  One use of
  708.           this feature is outlined in the description of the type 49 option
  709.           below.
  710.  
  711.           Option 0:  This section allows you to do primitive
  712.           editing/additions to users.  This is not the best way to handle
  713.           users; using the internal Simplex user editor is the preferred
  714.           way of editing the userlist.
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.                   --------------------------------------------------
  734.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  735.                                        Page 12                                       Page 12
  736.  
  737.  
  738.  
  739.  
  740.  
  741.           _________________________________________________________________
  742.  
  743.                                       Chapter 4                                      Chapter 4
  744.  
  745.                                  Simplex Menu Types                                 Simplex Menu Types
  746.           _________________________________________________________________
  747.  
  748.  
  749.  
  750.  
  751.           This chapter gives a brief rundown of the types of menu options
  752.           available for menu development.  Some of these require
  753.           information in the additional data fields, while others do not
  754.           and merely ignore the contents of said field.  Options in square
  755.           brackets ([]) are optional.
  756.  
  757.           Type 0: Show menu line.  This option will merely show the
  758.                contents of the menu line and will not respond to any
  759.                hotkeys.  Hence there is no need for a key value for this
  760.                kind of menu.  It is mostly used to give menu titles and/or
  761.                blank formatting lines.  Additional Data: None
  762.  
  763.           Type 1: Call new menu - Add to return stack.  This option will
  764.                show the contents of the menu line and if its corresponding
  765.                hotkey is triggered, it will attempt to call the menu name
  766.                specified in the data line.  The current menu is pushed on a
  767.                stack so that a subsequent call to menu type 3 will return
  768.                to the current menu.  If a password is provided, then the
  769.                user will be prompted for the password prior to being given
  770.                access to the new menu.  Additional Data: Menuname
  771.                [Password] [/ Menu Template Macros]
  772.  
  773.           Type 2: Goto new menu - Clear return stack.  This option will
  774.                show the contents of the menu line and if its corresponding
  775.                hotkey is triggered, it will attempt to call the menu name
  776.                specified in the data line.  The return stack is cleared and
  777.                the new menu becomes the new base of the stack.  If a
  778.                password is provided, then the user will be prompted for the
  779.                password prior to being given access to the new menu.
  780.                Additional Data: Menuname [Password] [/ Menu Template
  781.                Macros]
  782.  
  783.           Type 3: Return to previous menu.  This option pops the current
  784.                menu off of the stack and returns to the previous menu.
  785.                Additional Data: None
  786.  
  787.           Type 4: Replace current menu on return stack.  This option will
  788.                show the contents of the menu line and if its corresponding
  789.                hotkey is triggered, it will attempt to call the menu name
  790.                specified in the data line.  The new menu is put on the
  791.                stack and replaces the current menu so that a subsequent
  792.                call to menu type 3 will return to the current menu's
  793.  
  794.  
  795.  
  796.                   --------------------------------------------------
  797.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  798.                                        Page 13                                       Page 13
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.                previous menu!  If a password is provided, then the user
  806.                will be prompted for the password prior to being given
  807.                access to the new menu.  Additional Data: Menuname
  808.                [Password] [/ Menu Template Macros]
  809.  
  810.           Type 16: Enter a message on board.  This option permits the user
  811.                to enter a message on the specified message board.
  812.                Optionally the user may be logged off automatically after
  813.                exiting the message editor by specifying a /L on the data
  814.                line.  THe logoff is exactly as if a type 255 menu option
  815.                was executed.  The message may be forced to a specific user
  816.                by using the optional /T=user_name option.  Please note the
  817.                "_" (underscore) between the user's firat and last names.
  818.                This will be changed into a space when the message is
  819.                actually entered.  Additional Data: board# [/L]
  820.                [/T=user_name]
  821.  
  822.           Type 17: Read messages on board.  This option permits the user to
  823.                read public messages or private messages to him/her on a
  824.                message board.  If the user's privilege level is greater or
  825.                equal to the message board's sysop privilege, then he/she
  826.                will be able to read all messages in the area.  Additional
  827.                Data: board#
  828.  
  829.           Type 18: Scan messages on board.  This option permits the user to
  830.                see the headers for public messages or private message to
  831.                him/her on a message board.  If the user's privilege is
  832.                greater or equal to the message board's sysop privilege,
  833.                then he/she will be able to see all the headers in the area.
  834.                Additional Data: board#
  835.  
  836.           Type 19: Quickscan messages on board.  This option permits the
  837.                user to see the basic headers for public messages or private
  838.                message to him/her on a message board.  If the user's
  839.                privilege is greater or equal to the message board's sysop
  840.                privilege, then he/she will be able to see all the basic
  841.                headers in the area.  Additional Data: board#
  842.  
  843.           Type 20: Search userlist.  This option permits the user to search
  844.                the userlist for a user's name and/or list all users on the
  845.                bbs.  Additional Data: None
  846.  
  847.           Type 21: Search for Fidonet address.  This option permits a user
  848.                to search for a specific FidoNet node in the nodelist.
  849.                Additional Data: None
  850.  
  851.           Type 22: Generate FREQ to Fidonet address.  This option permits
  852.                the user to generate network file-requests (in *.REQ files)
  853.                to a specific FidoNet node.  Additional Data: None
  854.  
  855.  
  856.  
  857.  
  858.  
  859.                   --------------------------------------------------
  860.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  861.                                        Page 14                                       Page 14
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.           Type 32: List files on file board.  This option opens the file
  869.                board's FILES.BBS and lists the files available in the area.
  870.                Additional Data: board#
  871.  
  872.           Type 33: Upload file to file board.  This option permits the user
  873.                to upload files to the specific file board.  In local mode,
  874.                this option permits files to be copied from another
  875.                drive/directory into the file area.  Additional Data: board#
  876.  
  877.           Type 34: Download file from file board.  This option permits the
  878.                user to download files from the specified file board.  In
  879.                local mode, this option permits files from the file area to
  880.                be copied to another drive/directory.  Additional Data:
  881.                board#
  882.  
  883.           Type 35: Raw directory list of file board.  This options permits
  884.                the user to get a raw directory of the files in the
  885.                specified file board.  Additional Data: board#
  886.  
  887.           Type 36: Contents of archive on file board.  This option permits
  888.                the user to see the contents of .ARC, .PAK, .ZIP, .LZH, and
  889.                .ZOO files in the specified file board.  Additional Data:
  890.                board#
  891.  
  892.           Type 37: Show new files across file boards.  This option searches
  893.                across file boards for files with dates later then the
  894.                user's last login or with dates later than a user-defined
  895.                date.  Additional Data: board#
  896.  
  897.           Type 38: Search for filename across file boards.  This option
  898.                searches across file boards for a specified file name.
  899.                Additional Data: board#
  900.  
  901.           Type 39: Search for keyword across file boards.  This option
  902.                searches across file boards for a specified keyword in the
  903.                descriptions.  Additional Data: board#
  904.  
  905.           Type 40: Delete file on file board.  This option permits the user
  906.                to delete files and description entries in the specified
  907.                file area.  Additional Data: board#
  908.  
  909.           Type 41: Read a text file on file board.  This option permits a
  910.                user to read the contents of a file contained in the
  911.                specified file area.  Additional Data: board#
  912.  
  913.           Type 42: Download ONE special file from board.  This option
  914.                permits a user to download a sysop-specified file from a
  915.                specified area.  Additional Data: board# filename.ext
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.                   --------------------------------------------------
  923.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  924.                                        Page 15                                       Page 15
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.           Type 43: Move file(s) from one file board to another.  This
  932.                option permits the user to move files and descriptions to a
  933.                different board.  Additional Data: source_board#
  934.  
  935.           Type 48: Show ascii/ansi file.  This option shows the user the
  936.                specified ansi or ascii file.  Do not include the extension,
  937.                only the base filename.  The file will not pause at the end.
  938.                Additional Data: filename
  939.  
  940.           Type 49: Show ascii/ansi file with menu hotkeys.  If this option
  941.                is used as an automatic executing menu option, the file
  942.                indicated in the data line will be shown to the user when
  943.                its menu line is being shown however the menu's hotkeys will
  944.                still be active!  This permits you to design free-form menus
  945.                using an ANSI screen editor.  As with a type 48 data line,
  946.                do not include the exension, just the base filename.  The
  947.                file will not pause at the end, but will continue showing
  948.                any additional menu lines until the menu is finished.  If
  949.                someone actually provides a hotkey for this menu type, it
  950.                will behave exactly like a type 48 (i.e. hotkeys are only
  951.                active when it is an automatic executing option).
  952.                Additional Data: filename
  953.  
  954.           Type 50: Show ascii/ansi file with pause at end.  This option
  955.                shows the user the specified ansi or ascii file.  Do not
  956.                include the extension, only the base filename.  The file
  957.                will pause at the end and prompt the user for Enter.
  958.                Additional Data: filename
  959.  
  960.           Type 51: Answer questionaire file.  This option leads the user
  961.                through a questionaire file if it is in the screens
  962.                directory.  See below for more info on Simplex's
  963.                questionaire language.  Additional Data: filename
  964.  
  965.           Type 52: Show quote of the moment.  This option will look in the
  966.                screens directory for a compiled quote file.  If it exists,
  967.                it will "randomly" select a quote from it, show it to the
  968.                user and pause for the user to press Enter.  See the SQUOTE
  969.                section for more details on quote files.  Additional Data:
  970.                filename
  971.  
  972.           Type 64: Change user's city/state.  This option permits the user
  973.                to change his/her city/state.  Additional Data: None
  974.  
  975.           Type 65: Change user's password.  This option permits the user to
  976.                change his/her password.  Prior to changing the password,
  977.                PASSWORD.A?? is shown (see below).  Additional Data: None
  978.  
  979.           Type 66: Change user's clearscreen status.  This option allows
  980.                the user to toggle on or off his/her sending of clear-screen
  981.  
  982.  
  983.  
  984.  
  985.                   --------------------------------------------------
  986.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  987.                                        Page 16                                       Page 16
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.                codes.  These are only sent is ANSI status is on.
  995.                Additional Data: None
  996.  
  997.           Type 67: Change user's MORE status.  This option allows the user
  998.                to toggle on or off his/her screen pausing status.  These
  999.                are only sent is ANSI status is on.  Additional Data: None
  1000.  
  1001.           Type 68: Change user's screen length.  This option allows the
  1002.                user to toggle on or off his/her sending of clear-screen
  1003.                codes.  These are only sent is ANSI status is on.
  1004.                Additional Data: None
  1005.  
  1006.           Type 69: Change user's ANSI status.  This option allows the user
  1007.                to toggle on or off his/her sending of ANSI codes.
  1008.                Additional Data: None
  1009.  
  1010.           Type 70: Change user's default editor status.  This option allows
  1011.                the user to toggle between using the line editor and the
  1012.                full-screen ANSI editor.  The full-screen editor is only
  1013.                entered if ANSI status is on.  Additional Data: None
  1014.  
  1015.           Type 71: Change user's novice/expert mode.  This option allows
  1016.                the user to toggle between normal menu mode and expert mode
  1017.                (where only option letters are shown).  Additional Data:
  1018.                None
  1019.  
  1020.           Type 72: Change user's home phone number.  This option allows the
  1021.                user to change his/her home number.  Additional Data: None
  1022.  
  1023.           Type 73: Change user's data/work phone number.  This option
  1024.                allows the user to change his/her data or work number.
  1025.                Additional Data: None
  1026.  
  1027.           Type 80: Enter an advertisement in ad area.  This option permits
  1028.                a user to enter an advertisement or user-posted bulletin in
  1029.                an "ad" area.  Ads are placed in a special file which is
  1030.                indicated in the data line.  The days argument indicates the
  1031.                maximum amount of time that the "ad" can remain on the
  1032.                system.  The optional /R argument indicates the message
  1033.                board number where replies to "ads" will be posted.  If not
  1034.                provided, the user is not prompted to permit replies.
  1035.                Additional Data: filename /D=days [/R=board#]
  1036.  
  1037.           Type 81: Read advertisements in ad area.  This option permits a
  1038.                user to read advertisements or user-posted bulletins in an
  1039.                "ad" area.  The optional /R argument indicates the message
  1040.                board number where replies to "ads" will be posted.
  1041.                Additional Data: filename [/R=board#]
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.                   --------------------------------------------------
  1049.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1050.                                        Page 17                                       Page 17
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.           Type 82: Scan advertisements in ad area.  This option permits a
  1058.                user to scan the headers of advertisements or user-posted
  1059.                bulletins in an "ad" area.  Additional Data: filename
  1060.  
  1061.           Type 96: Set a user's privilege level.  This option sets the
  1062.                user's privilege level to the value in the data line (1
  1063.                through 255).  This privilege level is written to the user's
  1064.                record and is permanent.  The user's time online is adjusted
  1065.                to suit their new level.  It is the equivalent of up or
  1066.                downgrading a user from the keyboard.  Additional Data:
  1067.                priv_level
  1068.  
  1069.           Type 97: Raise a user's time.  This option adds the number of
  1070.                minutes specified in the data line to the user's online
  1071.                time.  Additional Data: minutes_to_raise
  1072.  
  1073.           Type 98: Drop a user's time.  This option removes the number of
  1074.                minutes specified in the data line from the user's online
  1075.                time.  Additional Data: minutes_to_delete
  1076.  
  1077.           Type 99: Set flags in user's configuration.  This option sets the
  1078.                flags specified in the data line in the user's flags
  1079.                configuration.  The flags are presented as a string of
  1080.                letters corresponding to the flags to set.  There are 16
  1081.                flags ranging from A to P.  e.g. a data string of "AMjp"
  1082.                will set the A. M, J, and P flags if they are not already
  1083.                set.  Additional Data: flags_to_set
  1084.  
  1085.           Type 100: Delete flags from user's configuration.  This option
  1086.                unsets the flags specified in the data line in the user's
  1087.                flags configuration.  The flags are presented as a string of
  1088.                letters corresponding to the flags to set.  There are 16
  1089.                flags ranging from A to P.  e.g. a data string of "AMjp"
  1090.                will delete the A. M, J, and P flags if they are set.
  1091.                Additional Data: flags_to_delete
  1092.  
  1093.           Type 101: Set the time of a user to an absolute time.  This
  1094.                option sets the user's time online to the number of minutes
  1095.                specified in the data line.  Additional Data: minutes_to_set
  1096.  
  1097.           Type 112: Set up combined message boards.  This option allows a
  1098.                user to select the message boards that he/she wants to use
  1099.                for combined message reading and downloading.  These
  1100.                settings are saved until they are changed.  The user can
  1101.                only select boards for which they have read permission.
  1102.                Additional Data: none
  1103.  
  1104.           Type 113: Read messages on combined message boards.  This option
  1105.                permits the user to read messages on the selected combined
  1106.                message boards.  Additional Data: none
  1107.  
  1108.  
  1109.  
  1110.  
  1111.                   --------------------------------------------------
  1112.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1113.                                        Page 18                                       Page 18
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.           Type 114: Scan messages on combined message boards.  This option
  1121.                permits the user to scan message headers that are on the
  1122.                selected combined message boards.  Additional Data: none
  1123.  
  1124.           Type 115: Quickscan messages on combined message boards.  This
  1125.                option permits the user to quickscan message headers that
  1126.                are on the selected combined message boards.  Additional
  1127.                Data: none
  1128.  
  1129.           Type 116: Download messages from combined message boards.  This
  1130.                option permits the user to download all or only new messages
  1131.                in the selected combined message boards.  If archivers are
  1132.                specified in option 5 of CONFIG, the user can then
  1133.                optionally elect to archive the mail before downloading it
  1134.                with a protocol.  This option also requires that the file-
  1135.                attach path be set in CONFIG.  This path is used for the
  1136.                preparation of downloadable mail.  Additional Data: none
  1137.  
  1138.           Type 240: Run a program from within SIMPLEX.  This option permits
  1139.                a user to run an external program.  The data line contains
  1140.                the command line to be passed to the command spawn function.
  1141.                This function searches the path for the program to run.
  1142.                There are certain $-escaped meta-commands which can be used
  1143.                to pass data.  These meta-commands MUST BE IN LOWERCASE.
  1144.                The following meta-commands can be used as arguments to the
  1145.                program:
  1146.  
  1147.                     $r  = user's time left in minutes
  1148.                     $d  = current date as mm/dd/yy
  1149.                     $t  = current time as hh:mm
  1150.                     $f  = user's first name
  1151.                     $l  = user's last name
  1152.                     $a  = user's ansi flag (ascii 1 if on or ascii 0 if
  1153.                           off)
  1154.                     $p  = In DOS: comm port number (ascii 1 for com1). In
  1155.                           OS/2: comm file handle as a decimal ascii string
  1156.                     $u  = user's number in userlist as ascii decimal string
  1157.                           (0 is first)
  1158.                     $b  = connect baud rate as ascii decimal string (0 is
  1159.                           local keyboard)
  1160.                     $k  = Keep the user's time unaltered upon return from
  1161.                           the external program (except for recalculating
  1162.                           time due to a pending forced event).  This
  1163.                           behaves like suspending the user's time while in
  1164.                           chat mode.
  1165.                     $*  = DOS only: leave fossil hot (do not deinitialize)
  1166.                           before calling program (not considered an
  1167.                           argument to the program)
  1168.                     $e  = stop and wait for Enter after running program
  1169.                           (not considered an argument to the program)
  1170.  
  1171.  
  1172.  
  1173.  
  1174.                   --------------------------------------------------
  1175.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1176.                                        Page 19                                       Page 19
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.                     $## = Passes the pathname for the file board specified
  1184.                           by ##.  For example, if file board 100 has its
  1185.                           path as d:\files\editors, then using $100 would
  1186.                           substitute d:\files\editors.  Notice that the
  1187.                           path name is NEVER backslash-terminated.  If the
  1188.                           file board specified by ## does not exist, then a
  1189.                           blank argument is passed (i.e. a nul-string).
  1190.  
  1191.                When the external program returns to Simplex, the user's
  1192.                record is reread and any changes to fields such as
  1193.                privilege, or flags (anything other than date/time info) is
  1194.                incorporated into the data held by Simplex.  This allows
  1195.                external programs to modify a user's access.  If the user
  1196.                has less than two minutes left online upon return, their
  1197.                time is reset to two minutes so they can exit in an orderly
  1198.                fashion.  Additional Data: program.exe [options]
  1199.  
  1200.           Type 241: Exit to DOS with an errorlevel.  This option is not
  1201.                currently implemented.
  1202.  
  1203.           Type 242: Show version/copyright information.  This option shows
  1204.                the user information about Simplex BBS.  Additional Data:
  1205.                None
  1206.  
  1207.           Type 243: Show user's usage statistics.  This option shows the
  1208.                user some information about his/her first connect date, the
  1209.                last connect date and time, upload and download statistics,
  1210.                and time information for this call.  Additional Data: None
  1211.  
  1212.           Type 244: Yell for chat with Sysop.  This option permits the user
  1213.                to summon the sysop for a chat if the current time is within
  1214.                the configured yell time specified under option 3 in CONFIG.
  1215.                Additional Data: None
  1216.  
  1217.           Type 245: Show current time of day.  This option shows the
  1218.                current date and time until the user presses Enter.  This is
  1219.                provided for systems with access to exact time.  Additional
  1220.                Data: None
  1221.  
  1222.           Type 246: Check for mail.  This option checks for unreceived mail
  1223.                addressed to the user.  It marks mail for later reading and
  1224.                gives them the option of reading mail immediately.
  1225.                Additional Data: None
  1226.  
  1227.           Type 247: Sysop's user-upgrade option.  This option permits the
  1228.                user to access/modify userlist records.  It is not meant for
  1229.                anyone other than Sysops.  The user must have ANSI enabled
  1230.                to access this option.  Additional Data: None
  1231.  
  1232.           Type 255: Logoff/hangup connection.  This option logs the user
  1233.                off of the system.  Additional Data: None
  1234.  
  1235.  
  1236.  
  1237.                   --------------------------------------------------
  1238.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1239.                                        Page 20                                       Page 20
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.           _________________________________________________________________
  1246.  
  1247.                                       Chapter 5                                      Chapter 5
  1248.  
  1249.                                    Menu Templates                                   Menu Templates
  1250.           _________________________________________________________________
  1251.  
  1252.  
  1253.  
  1254.  
  1255.           In order to support multiple menus which are similar, Simplex
  1256.           supports a menu template structure.  This feature is activated by
  1257.           using the / after the name of the menu (and password if one is
  1258.           present) in type 1 (Call new menu) and type 2 (Goto new menu)
  1259.           menu types, and then following this slash with macros
  1260.           assignments.
  1261.  
  1262.  
  1263.  
  1264.           5.1-Assigning Menu Template Macros          5.1-Assigning Menu Template Macros
  1265.           _________________________________________________________________
  1266.  
  1267.  
  1268.  
  1269.  
  1270.           Macros can be assigned to any letter from uppercase A to
  1271.           uppercase Z.  The assignments look like this:
  1272.  
  1273.                   A=1  B=Messages_to_the_Sysop
  1274.  
  1275.           Where A is assigned the string "1" and B is assigned the string
  1276.           "Messages to the Sysop".  There can be NO SPACES between the
  1277.           macro letter, the equals, and the beginning of the assignment.
  1278.           Since a space signifies the end of the macro assignment, you must
  1279.           use an underscore to represent a space (as in macro B above).
  1280.           Sorry, there is no way to represent an underscore character in an
  1281.           assignment string!
  1282.  
  1283.           A complete data line for a menu which calls a template menu would
  1284.           look similar to the following:
  1285.  
  1286.                   msgs password / A=1 B=Messages_to_the_Sysop C=24
  1287.  
  1288.           if there is a password for the area or like:
  1289.  
  1290.                   msgs / A=1 B=Messages_to_the_Sysop C=24
  1291.  
  1292.           if there is not a password.  MSGS is the name of the template
  1293.           menu to which to apply the macros.
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.                   --------------------------------------------------
  1301.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1302.                                        Page 21                                       Page 21
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.           Macros assigned in this fashion will only be applied to the menu
  1310.           in question, thus the same letters can be reused within a
  1311.           template menu to call another template menu.
  1312.  
  1313.  
  1314.  
  1315.           5.2-Using Template Macro Assignments          5.2-Using Template Macro Assignments
  1316.           _________________________________________________________________
  1317.  
  1318.  
  1319.  
  1320.  
  1321.           A template menu is not very different from a regular menu.  The
  1322.           difference mainly is in the use of $-escaped UPPERCASE letters to
  1323.           represent macro substitutions in the prompt and data lines.  For
  1324.           example, $A will substitute the value of macro A for that
  1325.           specific template menu.
  1326.  
  1327.           Since a picture is worth a thousand words, I suspect that an
  1328.           example is worth ten thousand, so here is an example!  In the
  1329.           previous section we called a menu "MSGS" with three macro
  1330.           assignments, A, B and C.  Here is how MSGS can use the macros.
  1331.           Assume that the first prompt line is the name of the message
  1332.           area:
  1333.  
  1334.                   --- Message Area $A: ^$B^
  1335.  
  1336.           This will print the following when called using the syntax of the
  1337.           previous section:
  1338.  
  1339.                   --- Message Area 1: Messages to the Sysop                                      Messages to the Sysop
  1340.  
  1341.           when $A and $B are assigned the values assigned to A and B.
  1342.  
  1343.           Ok, the prompt line works fine, but how does this affect data
  1344.           lines?  The same way.  Here are sample menu prompt and data lines
  1345.           from the same menu:
  1346.  
  1347.                   prompt: <^$$^> Scan messages
  1348.                     data: $C
  1349.  
  1350.           This will actually become the following when the menu is actually
  1351.           called:
  1352.  
  1353.                   prompt: <$> Scan messages                           $
  1354.                     data: 24
  1355.  
  1356.           which will pass the number 24 to the Scan function (we assume
  1357.           this was a type 18 menu and that message board 24 is where sysop
  1358.           messages are!).  The $$ is interpreted as representing a single
  1359.           dollar sign ($).
  1360.  
  1361.  
  1362.  
  1363.                   --------------------------------------------------
  1364.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1365.                                        Page 22                                       Page 22
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.           _________________________________________________________________
  1372.  
  1373.                                       Chapter 6                                      Chapter 6
  1374.  
  1375.                                    Running Simplex                                   Running Simplex
  1376.           _________________________________________________________________
  1377.  
  1378.  
  1379.  
  1380.  
  1381.           Simplex may be started by merely typing Simplex on the command
  1382.           line (OS/2 users use Simplex2) and pressing Enter in the assigned
  1383.           Simplex directory.   However, it is doubtful that such simple use
  1384.           would suffice for most applications of Simplex!  Hence Simplex
  1385.           accepts a series of command line arguments that permit you to
  1386.           call it under specified conditions, and it returns with specific
  1387.           errorlevels to indicate that certain events have occurred.
  1388.  
  1389.           The Simplex command line may include any of the following
  1390.           options.  A list of these options might be obtained by typing
  1391.           Simplex -? on the command line.  Most of these options are meant
  1392.           to be used when spawning Simplex from a front-end FidoNet mailer,
  1393.           but some are even handy for use in simple host applications:
  1394.  
  1395.              -Bxxxx Startup at the specified baud (User is online)
  1396.              -D     Drop in to Simplex with user's info in simplex.usr
  1397.              -H     Do not hangup before exiting
  1398.              -L     Startup in local mode (same as -B0)
  1399.              -Pxxx  DOS: Use the specified comm port *or*
  1400.              -Pxxx  OS/2: Use the specified comm handle
  1401.              -R     Do ringback model of call answering
  1402.              -S     DOS: Do not close stdout and reopen it to NUL
  1403.              -Txxx  Set maximum time user is allowed on system
  1404.              -X     Exit after carrier is lost or after logoff
  1405.  
  1406.           The DOS version has the -S option because of the propensity of
  1407.           some fossil drivers to "sign-on" with a message each time they
  1408.           are initialized by Simplex (e.g. Ray Gwinn's x00.sys).  This
  1409.           behavior has the tendency to kill Simplex's screen which is
  1410.           undesirable.  So, by default, Simplex closes the standard output
  1411.           file handle (handle 1) and reopens it pointing to NUL.  This is
  1412.           the equivalent of typing "simplex > nul" at the command line!  If
  1413.           your fossil does not do this, or it causes problems on your
  1414.           system, you may specify the -S flag to stop Simplex from closing
  1415.           the handle.
  1416.  
  1417.           The -D option permits Simplex to be called as a door to another
  1418.           program.  The other program must somehow create the login file
  1419.           "simplex.usr" according to the following byte-packed C structure.
  1420.           All strings are terminated with nul characters (0).
  1421.  
  1422.           struct uf
  1423.  
  1424.  
  1425.  
  1426.                   --------------------------------------------------
  1427.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1428.                                        Page 23                                       Page 23
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.               {
  1436.               char uf_name[41];  /* nul-terminated user name, first last */
  1437.               char uf_password[16];   /* nul-terminated password */
  1438.               char uf_city[31];  /* nul-terminated city, state */
  1439.               char uf_home[15];  /* nul-terminated user's home number */
  1440.               char uf_data[15];  /* nul-terminated user's data/business
  1441.           number */
  1442.               char uf_screenlen;  /* length of users screen in lines */
  1443.               int uf_flags;  /* bit mapped flags for options, see
  1444.           URGENT.DOC */
  1445.               };
  1446.  
  1447.           The user is logged in and if they have never entered Simplex
  1448.           before, their user record is created automatically.  The -D
  1449.           option automatically sets the -X flag so that Simplex will exit
  1450.           if the user drops carrier or logs off.
  1451.  
  1452.           A front-end mailer program might spawn Simplex with the following
  1453.           command line in a batch file:
  1454.  
  1455.                   simplex2 -B%1 -P%2 -X
  1456.  
  1457.           or for a local session, it might use the following:
  1458.  
  1459.                   simplex2 -L -X
  1460.  
  1461.           In order to let batch files know what is causing Simplex to exit,
  1462.           it returns different errorlevels.  The following errorlevels are
  1463.           currently supported in Simplex.
  1464.  
  1465.                0    Normal Simplex exit prompted by Alt-X keystroke.
  1466.                1    Simplex had an internal error.
  1467.                2    Normal Simplex exit after user was on and -X or (-D)
  1468.                     was on command line.
  1469.                3    Netmail was entered and Alt-X pressed or -X (-D) was on
  1470.                     command line.
  1471.                4    Echomail was entered and Alt-X pressed or -X (-D) was
  1472.                     on command line.
  1473.                5    Netmail and Echomail were entered and Alt-X pressed or
  1474.                     -X (-D) was on command line.
  1475.                6+   Errorlevel generated by an event exit.
  1476.  
  1477.           Errorlevel 2 is especially created for simple Simplex host
  1478.           applications which need to know if to run external utilities such
  1479.           as SRECENT or SUSAGE (see below).  Obviously, if you have exited
  1480.           from a waiting-state with Alt-X, there is no need to check to see
  1481.           if the last user has been added to the database.  Hence you could
  1482.           have a batch file similar to this:
  1483.  
  1484.                   set simplex=d:\host
  1485.                   :runhost
  1486.  
  1487.  
  1488.  
  1489.                   --------------------------------------------------
  1490.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1491.                                        Page 24                                       Page 24
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.                   d:
  1499.                   cd \host
  1500.                   simplex2 -x
  1501.                   if errorlevel 3 goto runhost
  1502.                   if errorlevel 1 goto recent
  1503.                   if errorlevel 0 goto end
  1504.  
  1505.                   :recent
  1506.                   srecent 20
  1507.                   susage -G -I
  1508.                   goto runhost
  1509.  
  1510.                   :end
  1511.  
  1512.           while a FidoNet compatible BBS might have something like:
  1513.  
  1514.                   :runbbs
  1515.                   simplex -b%1 -x
  1516.                   if errorlevel 6 goto recent
  1517.                   if errorlevel 5 goto echomatrix
  1518.                   if errorlevel 4 goto echo
  1519.                   if errorlevel 3 goto matrix
  1520.                   goto recent
  1521.  
  1522.                   :echomatrix
  1523.                   smail -nx -ex
  1524.                   goto recent
  1525.  
  1526.                   :echo
  1527.                   smail -ex
  1528.                   goto recent
  1529.  
  1530.                   :matrix
  1531.                   smail -nx
  1532.  
  1533.                   :recent
  1534.                   srecent 20
  1535.                   susage -G -I
  1536.                   goto runbbs
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.                   --------------------------------------------------
  1553.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1554.                                        Page 25                                       Page 25
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.           _________________________________________________________________
  1561.  
  1562.                                       Chapter 7                                      Chapter 7
  1563.  
  1564.                             Setting up Downloadable Mail                            Setting up Downloadable Mail
  1565.           _________________________________________________________________
  1566.  
  1567.  
  1568.  
  1569.  
  1570.           As of version 1.04, Simplex handles downloadable mail.  This
  1571.           permits users who keep track of large message bases to be able to
  1572.           download their mail (optionally in compressed form) using a
  1573.           protocol, and then using an ASCII file reader/browser (such as
  1574.           LIST in DOS or LSTPM in OS/2) to read their mail offline.
  1575.  
  1576.           In order to implement the downloadable feature, you must define a
  1577.           fileattach directory in option 4 of CONFIG.  You must ensure that
  1578.           there are a few megabytes of space free on the drive you specify
  1579.           at any time depending upon the total amount of mail most users
  1580.           would download).
  1581.  
  1582.           If you are not running FidoNet mail and wish users of the
  1583.           downloadable mail to have access to the different archivers, you
  1584.           must set up archivers in option 5 of CONFIG.  Whatever archivers
  1585.           that you provide command line templates for will be presented to
  1586.           the user as options.  To set up an archiver, find the respective
  1587.           line corresponding to the archiver (ARC, ZIP, LZH, or ZOO) under
  1588.           option 5 and enter a template line as follows:
  1589.  
  1590.                   [path]archiver [options] %A %F
  1591.  
  1592.           where %A is the name of the archive-file that will be generated
  1593.           by Simplex and %F is the name of the file that will be inserted
  1594.           into the archive.  Simplex will look along the path for the
  1595.           archiver before running.  Here are some examples of some command
  1596.           lines:
  1597.  
  1598.                   ARC Command: arc m5 %A %F
  1599.                   ZIP Command: pkzip -a -m %A %F
  1600.                   LZH Command: lh2 A %A %F /i /c /o
  1601.  
  1602.           While Simplex is diligent about deleting the files it creates, it
  1603.           might not be a bad idea to add a cleanup routine to the batch
  1604.           file that runs your BBS like this:
  1605.  
  1606.                   del d:\files\fattach\mail*.dl > NUL
  1607.                   del d:\files\fattach\mail*.arc > NUL
  1608.                   del d:\files\fattach\mail*.zip > NUL
  1609.                   del d:\files\fattach\mail*.lzh > NUL
  1610.                   del d:\files\fattach\mail*.zoo > NUL
  1611.  
  1612.  
  1613.  
  1614.  
  1615.                   --------------------------------------------------
  1616.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1617.                                        Page 26                                       Page 26
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.           which would ensure that the area is kept clean.
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.                   --------------------------------------------------
  1679.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1680.                                        Page 27                                       Page 27
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.           _________________________________________________________________
  1687.  
  1688.                                       Chapter 8                                      Chapter 8
  1689.  
  1690.                                Simplex Ancillary Files                               Simplex Ancillary Files
  1691.           _________________________________________________________________
  1692.  
  1693.  
  1694.  
  1695.  
  1696.           Simplex BBS requires a number of files to be provided by the user
  1697.           in order to do its normal work and to present a helpful and
  1698.           friendly interface to the user.  The following sections outline
  1699.           the files that Simplex looks for under various conditions.  These
  1700.           files are named with extensions for users who are using ANSI and
  1701.           those who are not.
  1702.  
  1703.           If the user is running ANSI, then the user is presented with the
  1704.           contents of filename.ANS.  If this file cannot be found, or if
  1705.           the user has ANSI off, the contents of filename.ASC are shown.
  1706.           This means that you can include as many ANSI sequences as you
  1707.           wish in the .ANS file but leave them out of the .ASC.  If you use
  1708.           the SANSI compiler, it will automatically prepare the two
  1709.           distinct files for you.
  1710.  
  1711.  
  1712.  
  1713.           8.1-Files for Help          8.1-Files for Help
  1714.           _________________________________________________________________
  1715.  
  1716.  
  1717.  
  1718.  
  1719.           The files that present help screens should attempt to be very
  1720.           helpful yet concise at the same time.  No user appreciates being
  1721.           swamped with information when they ask for help!  These files
  1722.           must be in the configured screen path.
  1723.  
  1724.           DLHELP.A??     This file presents help on the download protocols
  1725.                          available on your Simplex system.  It is accessed
  1726.                          by pressing H at the Download Menu.
  1727.  
  1728.           ULHELP.A??     This file presents help on the upload protocols
  1729.                          available on your Simplex system.  It is accessed
  1730.                          by pressing H at the Upload Menu.
  1731.  
  1732.           NODEHELP.A??   This file presents help on the choices in the
  1733.                          Search Nodelist Menu.
  1734.  
  1735.           READHELP.A??   This file presents help on the choices available
  1736.                          in the Read Messages Menu.
  1737.  
  1738.  
  1739.  
  1740.  
  1741.                   --------------------------------------------------
  1742.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1743.                                        Page 28                                       Page 28
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.           TOPICHLP.A??   This file is shown when a user presses H in the
  1751.                          Read Topics Menu.
  1752.  
  1753.           EDITHELP.A??   This file is invoked by requesting help from the
  1754.                          Line Editor Menu.  It should describe the options
  1755.                          available to the user of the Line Editor.
  1756.  
  1757.           ANSIHELP.A??   This file presents help when the user of the Full
  1758.                          Screen Editor presses ^K ?.  It should present a
  1759.                          list of the options available in that editor.
  1760.  
  1761.           QSHELP.A??     This file presents the user with help for using
  1762.                          the QuickScan option in a message area.
  1763.  
  1764.           SCANHELP.A??   This file is shown when a user requests help in
  1765.                          the Scan Menu of a message area.
  1766.  
  1767.           ADHELP.A??     This file is shown when in read mode while in an
  1768.                          Ad/User Bulletin area.
  1769.  
  1770.  
  1771.  
  1772.           8.2-General Files          8.2-General Files
  1773.           _________________________________________________________________
  1774.  
  1775.  
  1776.  
  1777.  
  1778.           These files are called upon in certain specific situations during
  1779.           the running of Simplex.  They are almost essential for providing
  1780.           a friendly interface between your BBS and the user.  These files
  1781.           must be in the configured screen path.
  1782.  
  1783.           TOOSLOW.ASC    This file does not have an ANSI flavor since the
  1784.                          user's ANSI preference is not known at the time it
  1785.                          is shown.  It is shown when a user has logged on
  1786.                          with a modem slower than your minimum baud rate
  1787.                          configured in CONFIG.
  1788.  
  1789.           LOGO.ASC       This file is shown before the user is asked for
  1790.                          his/her name.  Since the user's ANSI preference is
  1791.                          not yet known, there is no ANSI flavor of this
  1792.                          file.  It is not wise to embed ANSI codes in it
  1793.                          since it might cause undesirable side-effects on
  1794.                          the user's terminal.
  1795.  
  1796.           NOTFOUND.ASC   This file is shown after a user enters a name that
  1797.                          is not in the userlist, and before the user is
  1798.                          prompted if they entered the correct name.
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.                   --------------------------------------------------
  1805.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1806.                                        Page 29                                       Page 29
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.           PRIVATE.ASC    This file is shown only if the user's name is not
  1814.                          in the userlist and the BBS is configured for
  1815.                          preregistered operation.
  1816.  
  1817.           ANSI.ASC       This file is shown after a user has indicated that
  1818.                          their name was spelled correctly and it was not in
  1819.                          the userlist.  It is wise to indicate to the user
  1820.                          that they will be asked a few questions which will
  1821.                          help to configure the system to their liking, and
  1822.                          maybe to explain the meaning of ANSI to them.
  1823.  
  1824.           PASSWORD.A??   This file is sent before the new user enters
  1825.                          his/her password into the system, or when a user
  1826.                          opts to change his/her password.  It should
  1827.                          indicate that they must choose a password of at
  1828.                          least 4 characters and that it should be easy to
  1829.                          remember yet difficult for close friends to guess.
  1830.  
  1831.           NEWUSER.A??    This file is shown to a user after they have
  1832.                          finished filling out the new-user questionnaire
  1833.                          and before they are provided with the welcome
  1834.                          screen.  It is a good idea to welcome them to your
  1835.                          system and maybe to explain some of the rules of
  1836.                          conduct.
  1837.  
  1838.           NEWUSER2.A??   This file is shown to users who have called less
  1839.                          than 5 times.  It is a good idea to use it to give
  1840.                          a few pointers on the use of your system.
  1841.  
  1842.           WELCOME.A??    This file is shown to a user after logging in, or
  1843.                          to a new user after NEWUSER2.A??.  It precedes the
  1844.                          automatic mail check.  This is the place to put a
  1845.                          splashy logo screen since Simplex knows at this
  1846.                          point if the user runs ANSI or not!
  1847.  
  1848.           DAYQUOTE.CQ    This is a compiled quote file (see SQUOTE below)
  1849.                          which is searched for a "random" quote for the
  1850.                          day.  A quote from this file will be shown after
  1851.                          WELCOME.A?? and before checking for mail.
  1852.  
  1853.           BULLETIN.A??   This file shows the latest news on the system to a
  1854.                          user logging in.  It is shown after the
  1855.                          WELCOME.A?? and the mail check.
  1856.  
  1857.           NOANSWER.A??   This file is shown after a user has yelled and the
  1858.                          Sysop did not answer immediately.  It should
  1859.                          explain to the user that the Sysop is unavailable
  1860.                          and that he/she might break in and chat while they
  1861.                          continue using the board normally.
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.                   --------------------------------------------------
  1868.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1869.                                        Page 30                                       Page 30
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.           TOOMANY.A??    This file is shown after a user has attempted to
  1877.                          yell but does not have any remaining yells (as set
  1878.                          in CONFIG).
  1879.  
  1880.           NOYELL.A??     This file is shown when the user attempts to yell
  1881.                          but it is outside of the yell hours configured in
  1882.                          CONFIG.  It should indicate to the user that they
  1883.                          should leave the Sysop a message instead.
  1884.  
  1885.           GOODBYE.A??    This is the last file that the user sees after
  1886.                          logging off of your BBS.  It is shown before the
  1887.                          modem is told to hang-up.
  1888.  
  1889.  
  1890.  
  1891.           8.3-Files Created by CONFIG          8.3-Files Created by CONFIG
  1892.           _________________________________________________________________
  1893.  
  1894.  
  1895.  
  1896.  
  1897.           The following files are normal in the Simplex home directory and
  1898.           are created by CONFIG.  They are not meant to be deleted or
  1899.           edited by any means other than with CONFIG.
  1900.  
  1901.           CONFIG.BBS     This file contains the configuration information
  1902.                          needed by Simplex and its utilities.  This
  1903.                          information includes the BBS name, the Sysop name,
  1904.                          the paths to different directories, and Fidonet
  1905.                          addresses.
  1906.  
  1907.           EVENTS.BBS     This file contains the event information used by
  1908.                          Simplex.
  1909.  
  1910.           FILEAREA.BBS   This file contains the path and file area name
  1911.                          information referenced by menus.
  1912.  
  1913.           MSGAREA.BBS    This file contains the message area information
  1914.                          which is referenced by menus.
  1915.  
  1916.  
  1917.  
  1918.           8.4-Files Needed by Simplex          8.4-Files Needed by Simplex
  1919.           _________________________________________________________________
  1920.  
  1921.  
  1922.  
  1923.  
  1924.           The following files are absolutely essential for Simplex's
  1925.           operations and must be in the Simplex home directory.  Notice,
  1926.           Ctrl-Z cannot appear as the End-of-file marker.  This rules out
  1927.  
  1928.  
  1929.  
  1930.                   --------------------------------------------------
  1931.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1932.                                        Page 31                                       Page 31
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.           using editors like EDLIN.  If your editor uses Ctrl-Z for EOF,
  1940.           you must use a program that strips Ctrl-Z's to remove them.  Most
  1941.           good editors allow you to write files without Ctrl-Z at the end.
  1942.  
  1943.           TIMES.BBS      This file contains in ascending priority order,
  1944.                          the maximum amount of time in minutes per day that
  1945.                          allowed for each privilege level.  The maximum
  1946.                          amount is 1440 minutes (24 hours).  The file is
  1947.                          plain ASCII text organized like this:
  1948.  
  1949.                          <level> <time>
  1950.  
  1951.                          as in the following:
  1952.  
  1953.                          1 30
  1954.                          100 60
  1955.                          200 120
  1956.                          255 180
  1957.  
  1958.                          This means that any user with level 1 through 99
  1959.                          has 30 minutes on the system.  Any user with level
  1960.                          100 through 199 has 60 minutes on the system.  Any
  1961.                          user with level 200 through 254 has 120 minutes on
  1962.                          the system, and any user with level 255 has 180
  1963.                          minutes on the system.
  1964.  
  1965.           USERLIST.BBS   This file contains the user records.  It is
  1966.                          maintained by using the USERLIST program or by
  1967.                          using the Sysop user-editor from within Simplex
  1968.                          itself.
  1969.  
  1970.           FILES.BBS      Each file directory needs a FILES.BBS.  This file
  1971.                          contains the names of the files along with a
  1972.                          description line as follows:
  1973.  
  1974.                          <filename> <description>
  1975.  
  1976.                          The filename should be in all caps and any amount
  1977.                          of spaces or tabs may separate it from the
  1978.                          description.  The maximum length of a line can be
  1979.                          250 characters.  If a line begins with a hyphen
  1980.                          then it and all subsequent lines will be shown in
  1981.                          bright white.  If a line begins with a space or
  1982.                          hyphen, it is shown as is.  For example:
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.                   --------------------------------------------------
  1994.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  1995.                                        Page 32                                       Page 32
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.                          - My Main File Area
  2003.                            -----------------
  2004.  
  2005.                          FILENAME.DOC  A description of this file area for
  2006.                          my users.
  2007.                          SIMPLEX.ZIP   The latest Simplex programs.
  2008.                          ANOTHER.LZH Yet another file in this area.
  2009.  
  2010.  
  2011.  
  2012.           8.5-Files Created by Simplex          8.5-Files Created by Simplex
  2013.           _________________________________________________________________
  2014.  
  2015.  
  2016.  
  2017.  
  2018.           The following files are found in the Simplex home directory and
  2019.           are created and maintained by Simplex and its utilities.  They
  2020.           are best left alone by the user.
  2021.  
  2022.           MSGHEAD.BBS    This file contains the header information (such as
  2023.                          to, from, subject) for each message in the Simplex
  2024.                          system.  It contains an offset pointer to the
  2025.                          relevant text in MSGBODY.BBS.
  2026.  
  2027.           MSGBODY.BBS    This file contains the text of messages in the
  2028.                          Simplex system.
  2029.  
  2030.           MSGLINK.BBS    This file contains abbreviated information about
  2031.                          each message in the Simplex system and is used for
  2032.                          quick searching.
  2033.  
  2034.           MSGDATA.BBS    This file contains information about the total
  2035.                          number of messages in Simplex and in each message
  2036.                          area.
  2037.  
  2038.           MSGREAD.BBS    This file contains the last-message-read pointers
  2039.                          for each user for each message area in the Simplex
  2040.                          system.
  2041.  
  2042.           MSGCOMB.BBS    This file contains the combined message board
  2043.                          information for each user.
  2044.  
  2045.           USERINFO.BBS   This file contains information about the
  2046.                          last/current user for external utilities to use
  2047.                          (such as SRECENT).
  2048.  
  2049.           DORINFO1.DEF   This file is created by Simplex before running
  2050.                          external programs and contains information used by
  2051.                          certain games and utilities.
  2052.  
  2053.  
  2054.  
  2055.  
  2056.                   --------------------------------------------------
  2057.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2058.                                        Page 33                                       Page 33
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.           8.6-Files used by Simplex Utilities          8.6-Files used by Simplex Utilities
  2066.           _________________________________________________________________
  2067.  
  2068.  
  2069.  
  2070.  
  2071.           The following files may be found in the Simplex home directory.
  2072.           They are files that are needed by external Simplex utilities and
  2073.           must be edited with a pure-ASCII text editor.  They will not be
  2074.           needed if you do not intend to run Fidonet mail.
  2075.  
  2076.           AREAS.BBS      This file is used by SMAIL to Export/Import
  2077.                          echomail.  It is organized as follows:
  2078.  
  2079.                          <msgarea number> <echo-areaname> <destination
  2080.                          addresses>
  2081.  
  2082.                          The <msgarea number> is the Simplex message area
  2083.                          number as defined in CONFIG.  The special area
  2084.                          "number" P is reserved for "pass through" echomail
  2085.                          areas, that is areas which are not on your BBS but
  2086.                          which you might be passing on to other BBSes.  The
  2087.                          <echo-areaname> is the official echo "tag" for
  2088.                          that echo.  The destination addresses are the
  2089.                          addresses which your BBS "feeds".   Comment lines
  2090.                          in this file begin with a semicolon (;).  Here is
  2091.                          an example of an AREAS.BBS file:
  2092.  
  2093.                          ; This is a sample AREAS.BBS comment!
  2094.                          10 C_ECHO  1:151/401 1:151/403 1:151/404
  2095.                          1:151/1000
  2096.                          11 SIMPLEX 1:151/401 1:151/404 1:151/1000
  2097.                          12 LUNATIC 1:151/401
  2098.                          P  WRITING 1:151/404 1:151/1000
  2099.                          P  AMIGA   1:151/403 1:151/1000
  2100.  
  2101.                          Urgent: In AREAS.BBS, the FIRST line must contain
  2102.                          a comment or anything other than an echo area
  2103.                          list.  This is for compatibility with older
  2104.                          systems.  C_ECHO, for example, is imported to area
  2105.                          10, and is forwarded to the other addresses
  2106.                          listed.  On the other hand, AMIGA is not imported,
  2107.                          but just forwarded to the listed nodes.  Note the
  2108.                          full use of zone notation.  If you omit the zone
  2109.                          and net they will default to the same as your zone
  2110.                          and net number as configured in CONFIG (e.g. 10
  2111.                          C_ECHO 401 403 404 1000 is the same as above since
  2112.                          my address is 1:151/402).
  2113.  
  2114.           SMP.CTL        This file is used by SMP to export messages to
  2115.                          other systems.  Notice:  Prior to version 1.04
  2116.  
  2117.  
  2118.  
  2119.                   --------------------------------------------------
  2120.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2121.                                        Page 34                                       Page 34
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.                          Simplex, it was somewhat similar to oMMM's CTL
  2129.                          file.  After 1.04's release, the verbs changed
  2130.                          radically to bring them in line with the new
  2131.                          policy underlying Fidonet mail as implemented in
  2132.                          Simplex.
  2133.  
  2134.                          Routing verbs allow mail to be converted between
  2135.                          states (Held <-> Routed <-> Direct), moved out and
  2136.                          into of the reach of mailers (Left <-> Send), and
  2137.                          archived (Arc, Zip, Zoo, Lzh) to specific nodes.
  2138.                          Here is a listing of the various verbs:
  2139.  
  2140.                HOLDTO <destination> <sources...>
  2141.                          This causes all held mail bound to sources to be
  2142.                          held for destination.  e.g. HOLDTO 151/402 151/400
  2143.                          151/401 151/402.  This holds all held mail for
  2144.                          151/400, 401 and 402 for 151/402.
  2145.  
  2146.                HOSTHOLD <destinations...>
  2147.                          This causes all held mail bound to destinations to
  2148.                          be held for network host (node 0 of one's net).
  2149.                          e.g.  HOSTHOLD 151/ALL 120/ALL will cause all held
  2150.                          mail for nets 151 and 120 to be held for 151/0
  2151.                          (from 151/401).
  2152.  
  2153.                ROUTETO <destination> <sources...>
  2154.                          This causes all routed mail bound to sources to
  2155.                          get routed to destination.  e.g. ROUTETO 151/402
  2156.                          151/ALL 120/ALL will route all routed mail for
  2157.                          nets 151 and 120 to 151/402.
  2158.  
  2159.                HOSTROUTE <destinations...>
  2160.                          This causes all routed mail bound to destinations
  2161.                          to get routed to network host (node 0 of one's
  2162.                          net).  e.g. HOSTROUTE 151/ALL 120/ALL will cause
  2163.                          all routed mail for nets 151 and 120 to be routed
  2164.                          to 151/0 (from 151/401).
  2165.  
  2166.                DIRECTTO <destination> <sources...>
  2167.                          This causes all direct mail bound to sources to
  2168.                          get directed to destination.  e.g. DIRECTTO
  2169.                          151/402 151/ALL 120/ALL will direct all directed
  2170.                          mail for nets 151 and 120 to 151/402.
  2171.  
  2172.                HOSTDIRECT <destinations...>
  2173.                          This causes all direct mail bound to destinations
  2174.                          to get directed to network host (node 0 of one's
  2175.                          net).  e.g. HOSTDIRECT 151/ALL 120/ALL will cause
  2176.                          all routed mail for nets 151 and 120 to be
  2177.                          directed to 151/0 (from 151/401).
  2178.  
  2179.  
  2180.  
  2181.  
  2182.                   --------------------------------------------------
  2183.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2184.                                        Page 35                                       Page 35
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.                ARCHOLD <destination> <sources...>
  2192.                ZIPHOLD <destination> <sources...>
  2193.                LZHHOLD <destination> <sources...>
  2194.                ZOOHOLD <destination> <sources...>
  2195.                          These options archive held mail for sources using
  2196.                          the archiver specified to the specified
  2197.                          destination.  e.g. ZIPHOLD 151/402 151/401 151/402
  2198.                          151/405 151/406 will archive all held mail to
  2199.                          151/401, 402, 405 and 406 with ZIP and route it to
  2200.                          151/402.
  2201.  
  2202.                ARCROUTE <destination> <sources...>
  2203.                ZIPROUTE <destination> <sources...>
  2204.                LZHROUTE <destination> <sources...>
  2205.                ZOOROUTE <destination> <sources...>
  2206.                          These options archive routed mail for sources
  2207.                          using the archiver specified to the specified
  2208.                          destination.  e.g. ZIPROUTE 151/402 151/401
  2209.                          151/402 151/405 151/406 will archive all routed
  2210.                          mail to 151/401, 402, 405 and 406 with ZIP and
  2211.                          route it to 151/402.
  2212.  
  2213.                ARCDIRECT <destination> <sources...>
  2214.                ZIPDIRECT <destination> <sources...>
  2215.                LZHDIRECT <destination> <sources...>
  2216.                ZOODIRECT <destination> <sources...>
  2217.                          These options archive direct mail for sources
  2218.                          using the archiver specified to the specified
  2219.                          destination.  e.g. ZIPDIRECT 151/402 151/401
  2220.                          151/402 151/405 151/406 will archive all direct
  2221.                          mail to 151/401, 402, 405 and 406 with ZIP and
  2222.                          route it to 151/402.
  2223.  
  2224.                HOLDROUTE <destinations...>
  2225.                          This option converts all held mail bound for
  2226.                          destinations to routed mail (from HOLD to ROUTE).
  2227.                          e.g. HOLDROUTE 151/402 will convert held mail for
  2228.                          151/402 to routed mail.
  2229.  
  2230.                HOLDDIRECT <destinations...>
  2231.                          This option converts all held mail bound for
  2232.                          destinations to directed mail (from HOLD to
  2233.                          DIRECT).  e.g. HOLDROUTE 151/402 will convert held
  2234.                          mail for 151/402 to directed mail.
  2235.  
  2236.                ROUTEHOLD <destinations...>
  2237.                          This option converts all routed mail bound for
  2238.                          destinations to held mail (from ROUTE to HOLD).
  2239.                          e.g. ROUTEHOLD 151/402 will convert routed mail
  2240.                          for 151/402 to held mail.
  2241.  
  2242.  
  2243.  
  2244.  
  2245.                   --------------------------------------------------
  2246.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2247.                                        Page 36                                       Page 36
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.                ROUTEDIRECT <destinations...>
  2255.                          This option converts all routed mail bound for
  2256.                          destinations to directed mail (from ROUTE to
  2257.                          DIRECT).  e.g. ROUTEDIRECT 151/402 will convert
  2258.                          routed mail for 151/402 to directed mail.
  2259.  
  2260.                DIRECTHOLD <destinations...>
  2261.                          This option converts all direct mail bound for
  2262.                          destinations to held mail (from DIRECT to HOLD).
  2263.                          e.g. DIRECTHOLD 151/402 will convert directed mail
  2264.                          for 151/402 to held mail.
  2265.  
  2266.                DIRECTROUTE <destinations...>
  2267.                          This option converts all direct mail bound for
  2268.                          destinations to routed mail (from DIRECT to
  2269.                          ROUTE).  e.g. DIRECTROUTE 151/402 will convert
  2270.                          directed mail for 151/402 to routed mail.
  2271.  
  2272.                LEAVEHOLD <destinations...>
  2273.                          This option converts all held mail bound for
  2274.                          destinations to non-active held mail.
  2275.  
  2276.                LEAVEROUTE <destinations...>
  2277.                          This option converts all routed mail bound for
  2278.                          destinations to non-active routed mail.
  2279.  
  2280.                LEAVEDIRECT <destinations...>
  2281.                          This option converts all direct mail bound for
  2282.                          destinations to non-active direct mail.
  2283.  
  2284.                SENDHOLD <destinations...>
  2285.                          This option converts all non-active held mail
  2286.                          bound for destinations to regular held mail.
  2287.  
  2288.                SENDROUTE <destinations...>
  2289.                          This option converts all non-active routed mail
  2290.                          bound for destinations to regular routed mail.
  2291.  
  2292.                SENDDIRECT <destinations...>
  2293.                          This option converts all non-active direct mail
  2294.                          bound for destinations to regular direct mail.
  2295.  
  2296.                POLL <destinations...>
  2297.                          This will create a blank .flo file to the
  2298.                          destinations providing there is not already direct
  2299.                          mail addressed to the same address.
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.                   --------------------------------------------------
  2309.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2310.                                        Page 37                                       Page 37
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.           _________________________________________________________________
  2317.  
  2318.                                       Chapter 9                                      Chapter 9
  2319.  
  2320.                            Simplex External Mail Utilities                           Simplex External Mail Utilities
  2321.           _________________________________________________________________
  2322.  
  2323.  
  2324.  
  2325.  
  2326.           This chapter describes all of the external mail utilities for
  2327.           Simplex.  These utilities are basically of two types, utilities
  2328.           to maintain Simplex's message base, and utilities to handle
  2329.           incoming and outgoing FidoNet mail.
  2330.  
  2331.           Simplex's message base is contained in a series of files
  2332.           contained in the Simplex root directory.  The message files are
  2333.           described above.  FidoNet mail is exported from the message base
  2334.           in standard FSC-0001 message format.  Incoming FidoNet mail may
  2335.           be either in standard FSC-0001 packed message packets or in
  2336.           archived format.  Outgoing FidoNet mail is prepared in standard
  2337.           FSC-0001 packed message packets and then archived by SMP.
  2338.  
  2339.  
  2340.  
  2341.           9.1-SCLEAN: Simplex Mail Cleaning Utility          9.1-SCLEAN: Simplex Mail Cleaning Utility
  2342.           _________________________________________________________________
  2343.  
  2344.  
  2345.  
  2346.  
  2347.           SCLEAN.EXE (or SCLEAN2.EXE for OS/2) is a message base
  2348.           maintenance program which cleans out messages from message
  2349.           boards.  Messages can be cleaned out completely from message
  2350.           boards, deleted if received, or deleted if older than a specified
  2351.           number of days.  SCLEAN has the following options:
  2352.  
  2353.                   -q      Quiet....do not show message by message activity
  2354.                   -dxx    Sets maximum days for message killing to xx
  2355.                   -kaxx   Kill ALL messages on board #xx
  2356.                   -kdxx   Kill messages prior to maximum days on board #xx
  2357.                   -krxx   Kill all received messages on board #xx
  2358.  
  2359.           The quiet flag can be used to speed up SCLEAN considerably on
  2360.           slow machines.
  2361.  
  2362.           SCLEAN can be used to kill messages older than 10 days on message
  2363.           boards 1, 7 and 12 and kill all received messages on board 8 with
  2364.           the following command line:
  2365.  
  2366.                   sclean -d10 -kd1 -kd7 -kd12 -kr8
  2367.  
  2368.  
  2369.  
  2370.  
  2371.                   --------------------------------------------------
  2372.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2373.                                        Page 38                                       Page 38
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.           The -ka option will normally be used to remove a defunct message
  2381.           board's messages from the message base.  Notice that SCLEAN
  2382.           merely deletes messages and does not actually remove them from
  2383.           the message base.
  2384.  
  2385.  
  2386.  
  2387.           9.2-SPACK: Simplex Message Base Deletion          9.2-SPACK: Simplex Message Base Deletion
  2388.           _________________________________________________________________
  2389.  
  2390.  
  2391.  
  2392.  
  2393.           SPACK.EXE (or SPACK2.EXE for OS/2) is a message base compression
  2394.           program.  It will analyse the message base and determine how many
  2395.           messages have been deleted, then check file space prior to
  2396.           packing.  Packing may optionally be done in-place instead of in
  2397.           duplicate files if disk space is at a premium, however this
  2398.           method is frowned upon since it might be dangerous should a power
  2399.           failure occur.
  2400.  
  2401.           SPACK has the following command line options:
  2402.  
  2403.                   -q      Quiet....do not show message activity
  2404.                   -p      Pack message base
  2405.                   -w      Write message base files in place
  2406.  
  2407.           The quiet flag will speed up SPACK considerably and should be
  2408.           used on slow machines!
  2409.  
  2410.           In order to pack the message base, use the following command
  2411.           line:
  2412.  
  2413.                   spack -p
  2414.  
  2415.  
  2416.  
  2417.           9.3-SLINK: Simplex Message Thread Linker          9.3-SLINK: Simplex Message Thread Linker
  2418.           _________________________________________________________________
  2419.  
  2420.  
  2421.  
  2422.  
  2423.           SLINK.EXE (or SLINK2.EXE for OS/2) is a message base thread
  2424.           linker program which will link messages by topic by message
  2425.           board.  What SLINK loads all the message topics for a board,
  2426.           removes all RE's from the topic lines, then links matching
  2427.           message topics into threads.  By default, SLINK links ALL message
  2428.           boards, however if a file called SLINK.BBS is located in the root
  2429.           Simplex directory, only the board numbers contained in that file
  2430.           are linked (SLINK.BBS is a series of 16-bit ints with each board
  2431.  
  2432.  
  2433.  
  2434.                   --------------------------------------------------
  2435.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2436.                                        Page 39                                       Page 39
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.           number to link).  This file is generally created by SMAIL when it
  2444.           is importing FidoNet mail so that SLINK would not waste time
  2445.           uselessly relinking boards that were not imported.
  2446.  
  2447.           There are no options to SLINK.  To run it, merely type SLINK (or
  2448.           SLINK2) on the command line and hit Enter.
  2449.  
  2450.  
  2451.  
  2452.           9.4-SMAIL: Simplex FidoNet Mail Utility          9.4-SMAIL: Simplex FidoNet Mail Utility
  2453.           _________________________________________________________________
  2454.  
  2455.  
  2456.  
  2457.  
  2458.           SMAIL.EXE (or SMAIL2.EXE for OS/2) is a FidoNet mail importation
  2459.           and exportation utility.  SMAIL is used to export FidoNet mail
  2460.           and Echomail to other systems after mail has been entered, a
  2461.           situation which can be determined by Simplex's exit errorlevel.
  2462.           Incoming FidoNet and echomail can be imported into the Simplex
  2463.           message base when your front-end mailer detects incoming mail
  2464.           packets.
  2465.  
  2466.           The command line options for SMAIL are the following:
  2467.  
  2468.                   -ua     unarc inbound mail packets
  2469.                   -it     import/toss net and echo mail
  2470.                   -ib     import/toss net and echo mail in bad messages
  2471.           area
  2472.                   -nx     export netmail to other systems
  2473.                   -ex     export echomail to other systems
  2474.                   -s      disable conversion of "sysop" messages to sysop's
  2475.           name
  2476.                   -c###   clean out signatures over ### days old
  2477.  
  2478.           SMAIL uses the unarchiver command lines from CONFIG's option 5 if
  2479.           you specify the -ua flag.  It also uses the packet path from
  2480.           CONFIG's option 4 as the destination directory for the contents
  2481.           of the archived mail.
  2482.  
  2483.           SMAIL handles Echomail signatures, which are files containing
  2484.           data from messages which have passed through the system.  These
  2485.           are kept in order to stop duplicate messages from being passed
  2486.           along.  These signatures are kept in the Simplex directory in
  2487.           files called SMAILxxx.SIG where where xxx is the Julian date of
  2488.           the year when the signature file is created.  These files can be
  2489.           maintained by using the SMAIL -c command.  This deletes signature
  2490.           files older then the specified number of days.  A reasonable
  2491.           period to keep signatures is between 3 and 10 days.  Too short a
  2492.           period might allow duplicates to slip through, and too long a
  2493.           period will slow the system down excessively while loading the
  2494.  
  2495.  
  2496.  
  2497.                   --------------------------------------------------
  2498.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2499.                                        Page 40                                       Page 40
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.           files.  The best time in your setting will be best left to
  2507.           experimentation!
  2508.  
  2509.           SMAIL, by default, converts any messages addressed to "Sysop"
  2510.           over to messages addressed to the sysop's name as specified in
  2511.           CONFIG.  This behavior might be considered annoying by some
  2512.           Sysops and therefore can be disabled using the -s switch on the
  2513.           command line.
  2514.  
  2515.           Here are some sample parts of a FidoNet mail compatible system's
  2516.           batch file which illustrate using SMAIL for exporting entered
  2517.           mail:
  2518.  
  2519.                   :runbbs
  2520.                   simplex -b%d -x
  2521.                   if errorlevel 6 goto runbbs
  2522.                   if errorlevel 5 goto echomatrix
  2523.                   if errorlevel 4 goto echo
  2524.                   if errorlevel 3 goto matrix
  2525.                   goto runbbs
  2526.  
  2527.                   :echomatrix
  2528.                   smail -nx -ex
  2529.                   smp -p
  2530.                   goto end
  2531.  
  2532.                   :echo
  2533.                   smail -ex
  2534.                   smp -p
  2535.                   goto end
  2536.  
  2537.                   :matrix
  2538.                   smail -nx
  2539.                   smp -p
  2540.                   goto end
  2541.  
  2542.                   :end
  2543.  
  2544.           Here is a sample of a front-end mailer's batch file,
  2545.           demonstrating the use of SMAIL for importing and forwarding
  2546.           incoming mail.
  2547.  
  2548.                   :runmailer
  2549.                   mailer
  2550.                   if errorlevel 2 goto runmailer
  2551.                   if errorlevel 1 goto import
  2552.                   goto end
  2553.  
  2554.                   :import
  2555.                   smail -ua -it
  2556.                   smp -p
  2557.  
  2558.  
  2559.  
  2560.                   --------------------------------------------------
  2561.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2562.                                        Page 41                                       Page 41
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.                   goto runmailer
  2570.  
  2571.                   :end
  2572.  
  2573.  
  2574.  
  2575.           9.5-SMP: Simplex Mail Packer          9.5-SMP: Simplex Mail Packer
  2576.           _________________________________________________________________
  2577.  
  2578.  
  2579.  
  2580.  
  2581.           SMP (or SMP2 for OS/2) is a FidoNet compatible mail
  2582.           router/packer/archiver.  It uses the archiver command lines from
  2583.           CONFIG's option 5.  Essentially SMP reads the messages in the
  2584.           matrix directory, and based on the rules in the SMP.CTL file (see
  2585.           above), packs the messages in packets and optionally archives
  2586.           them to their ultimate destinations.
  2587.  
  2588.           SMP will delete truncated (i.e. 0-length) files in the outbound
  2589.           directories before it begins packing.  Notice that it will not
  2590.           delete truncated files for the current day of the week, only for
  2591.           the other 6 days.
  2592.  
  2593.           SMP's options are the following:
  2594.  
  2595.                   -p      Pack and route files in matrix and outbound areas
  2596.                   -s(tag) Use information for sched (tag) in SMP.CTL where
  2597.                           (tag) is a letter from A to Z
  2598.  
  2599.           Use of SMP is demonstrated in the sample batch files under SMAIL
  2600.           above.
  2601.  
  2602.  
  2603.  
  2604.           9.6-SMAILFIX: Simplex Mail Fixer          9.6-SMAILFIX: Simplex Mail Fixer
  2605.           _________________________________________________________________
  2606.  
  2607.  
  2608.  
  2609.  
  2610.           Occasionally, systems crash and lock up.  That is almost a rule
  2611.           in the world of computing.  Unfortunately, these crashes and
  2612.           lock-ups have a nasty habit of occurring at the worst possible
  2613.           moment, and in the case of Simplex, the worst possible moment is
  2614.           when the message base is being manipulated!  Since the message
  2615.           base files are so intertwined, any corruption to any of the files
  2616.           could be quite disasterous.
  2617.  
  2618.           Hence the raison d'etre of SMAILFIX.  Should your message base
  2619.           appear to have become corrupted, SMAILFIX gives you a chance to
  2620.  
  2621.  
  2622.  
  2623.                   --------------------------------------------------
  2624.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2625.                                        Page 42                                       Page 42
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.           attempt to restore/rebuild some of the message files so that you
  2633.           can recover as much of the message base as possible.  OS/2 users
  2634.           should ensure that no utilities are able to manipulate the
  2635.           message files while SMAILFIX is running, and both DOS and OS/2
  2636.           users should ensure that their systems do not shut down or reboot
  2637.           before SMAILFIX is finished.
  2638.  
  2639.           To run SMAILFIX, just type it's name on the command line and hit
  2640.           Enter.  Notice that you should be in your Simplex root directory
  2641.           when you do this.  SMAILFIX will prompt you if you are sure that
  2642.           you want to run it.  Answer Y and it will begin attempting to
  2643.           recover your message base.  Once it is finished it will inform
  2644.           you if you need to run SLINK and/or SPACK on the message base.
  2645.  
  2646.           An option for SMAILFIX is the -date (or /date) option.  This
  2647.           makes SMAILFIX delete any messages which have a date beyond
  2648.           today's date.
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.                   --------------------------------------------------
  2687.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2688.                                        Page 43                                       Page 43
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.           _________________________________________________________________
  2695.  
  2696.                                      Chapter 10                                     Chapter 10
  2697.  
  2698.                      SUSAGE and SRECENT: Simplex Screen Builders                     SUSAGE and SRECENT: Simplex Screen Builders
  2699.           _________________________________________________________________
  2700.  
  2701.  
  2702.  
  2703.  
  2704.           There are two utilities which can be used by Simplex in order to
  2705.           generate special screens.  These are SUSAGE, a utility which
  2706.           generates an hourly usage chart for your system, and SRECENT, a
  2707.           utility which creates and maintains a recent callers listing.  In
  2708.           order to take advantage of these utilities, one must have the BBS
  2709.           exit after each user has logged off.  Both of these utilities
  2710.           read and utilize the USERINFO.BBS file created when a user logs
  2711.           in.
  2712.  
  2713.           SUSAGE must have the -G option enabled in order to generate usage
  2714.           files.  These files are placed in the screens directory and are
  2715.           appropriately named SUSAGE.ANS and SUSAGE.ASC.  These files
  2716.           normally use normal 7-bit ASCII characters to build the bar
  2717.           charts, but should you prefer to use IBM 8-bit characters, you
  2718.           can specify that with the optional -I switch.
  2719.  
  2720.           SRECENT must have a numeric option which specifies the number of
  2721.           last callers that you want to keep up with.  SRECENT 30 will keep
  2722.           information on 30 users and will build the screens with that
  2723.           information.  The resulting screens are placed in the screens
  2724.           directory and are called SRECENT.ANS and SRECENT.ASC.
  2725.  
  2726.           You may list names which you do not wish to show up on the recent
  2727.           callers list by creating a file with an editor in the Simplex
  2728.           directory called SRECENT.CFG.  This file would contain the first
  2729.           and last names of people who are exempt from SRECENT separated by
  2730.           an ENTER.  For example:
  2731.  
  2732.           Susan Smith
  2733.           Fred Flintstone
  2734.           John Doe
  2735.           Jane Doe
  2736.  
  2737.           Whenever these people log off, they will not be included in the
  2738.           recent-callers list.
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.                   --------------------------------------------------
  2750.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2751.                                        Page 44                                       Page 44
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.           _________________________________________________________________
  2758.  
  2759.                                      Chapter 11                                     Chapter 11
  2760.  
  2761.                             Simplex Questionaire Language                            Simplex Questionaire Language
  2762.           _________________________________________________________________
  2763.  
  2764.  
  2765.  
  2766.  
  2767.           Simplex has a rather simple but powerful questionaire language.
  2768.           A questionaire file is an ascii file with a .QF extension which
  2769.           is placed in the screen files directory.  This file can be
  2770.           created using a flat-ASCII text editor.
  2771.  
  2772.           The answer file is placed in the same directory and has the same
  2773.           base name as the questionaire file, however it sports an .AF
  2774.           extension.
  2775.  
  2776.           The following is an alphabetical list of questionaire commands.
  2777.           Commands are case-insensitive.  Strings are included in double
  2778.           quotes like this "string".
  2779.  
  2780.                ASK (variable) (len) :  This will accept up to the maximum
  2781.                     length specified of a user's input and store it in the
  2782.                     variable specified.  After hitting Enter, the system
  2783.                     will go to the next line.
  2784.  
  2785.                CHOOSE (variable) (choices) :  This will load the variable
  2786.                     specified with the choice letter selected from the list
  2787.                     of choices.
  2788.  
  2789.                CLS :  Clears the screen to the current color.
  2790.  
  2791.                COLOR (foreground) [(background)] :  Sets the current color
  2792.                     to the specified foreground/background (optional)
  2793.                     color.
  2794.  
  2795.                EXIT :  Immediately exits the questionnaire file.
  2796.  
  2797.                GOTO (labelname) :  Jumps to the label specified.  If label
  2798.                     is not found, it will exit.
  2799.  
  2800.                IF (variable) = ("string")  *or*
  2801.                IF (variable) != ("string") *or*
  2802.                IF (variable) = (variable)  *or*
  2803.                IF (variable) != (variable)
  2804.                ENDIF :  If the case is true, the questionnaire will fall
  2805.                     into the if-endif.  If it is not true, it will skip
  2806.                     over it.  *Warning* Do not "nest" ifs!  The !=
  2807.                     indicates "not equal to".
  2808.  
  2809.  
  2810.  
  2811.  
  2812.                   --------------------------------------------------
  2813.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2814.                                        Page 45                                       Page 45
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.                LABEL (labelname) :  Sets the labelname as a point to which
  2822.                     the GOTO will jump.  If a label is reused, then it will
  2823.                     replace the previous use.
  2824.  
  2825.                PRINT ("string") *or*
  2826.                PRINT (variable) :  Shows a string of contents of a variable
  2827.                     on the screen.  Does not go to the next line.
  2828.  
  2829.                PRINTLINE ("string") *or*
  2830.                PRINTLINE (variable) :  Shows a string of contents of a
  2831.                     variable on the screen.  This will then go to the next
  2832.                     line.
  2833.  
  2834.                SET (variable) = ("string") *or*
  2835.                SET (variable) = (variable) :  Sets a variable to a string
  2836.                     value or to the value of another variable.
  2837.  
  2838.                SETFLAG ("string") :  Turns on or sets the user's flags
  2839.                     corresponding to the letters contained in the string (A
  2840.                     through P, 16 flags) and updates the user's record.
  2841.  
  2842.                SHOW ("filename") : Shows a file (filename.ans if ansi is
  2843.                     on, otherwise filename.asc if it is not.
  2844.  
  2845.                UNSETFLAG ("string") :  Turns off or resets the user's flags
  2846.                     corresponding to the letters contained in the string (A
  2847.                     through P, 16 flags) and updates the user's record.
  2848.  
  2849.                WRITEINFO :  Writes the user's name, time and date, and
  2850.                     other info to the questionnaire answer file.
  2851.  
  2852.                WRITE ("string") *or*
  2853.                WRITE (variable) :  Writes the string or variable to the
  2854.                     questionnaire answer file.  This does not add a CR-LF
  2855.                     pair at the end.
  2856.  
  2857.                WRITELINE ("string") *or*
  2858.                WRITELINE (variable) :  Writes the string or variable to the
  2859.                     questionnaire answer file.  This adds a CR-LF pair at
  2860.                     the end.
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.                   --------------------------------------------------
  2876.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2877.                                        Page 46                                       Page 46
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.           _________________________________________________________________
  2884.  
  2885.                                      Chapter 12                                     Chapter 12
  2886.  
  2887.                          SQUOTE: Simplex Quote File Compiler                         SQUOTE: Simplex Quote File Compiler
  2888.           _________________________________________________________________
  2889.  
  2890.  
  2891.  
  2892.  
  2893.           You may create quote files for Simplex which are searched for
  2894.           random sayings either on login (see DAYQUOTE.CQ above) or in
  2895.           response to a type 52 menu option.  These files can contain salty
  2896.           wisdom sayings, scripture verses, variations on Murphy's Law,
  2897.           short jokes, or whatever else you desire.  Simplex can "randomly"
  2898.           select one of these sayings on demand and show it to the user.
  2899.  
  2900.           Creating quote files is a rather simple operation.  You need to
  2901.           edit a flat-ASCII file containing one quote per line (Maximum of
  2902.           512 characters per saying) and then compile it using SQUOTE.  The
  2903.           quote file produced by SQUOTE must be placed in the screen files
  2904.           directory.  The uncompiled quote file must have a .Q extension
  2905.           (e.g. DAYQUOTE.Q) and the compiler will create a file with a .CQ
  2906.           extension (e.g. DAYQUOTE.CQ).
  2907.  
  2908.           Here is an example of a simple uncompiled quote file:
  2909.  
  2910.                   The toast always falls on the carpet buttered-side down!
  2911.                   A penny saved is a penny earned.
  2912.  
  2913.                   God is love. (I John 4:16a NIV)
  2914.  
  2915.           Notice that each line is an individual saying.  Blank lines
  2916.           between quote lines will not hurt anything so you could group
  2917.           similar sayings together and separate them with blank lines as
  2918.           above.  This might make it easier to maintain your quote files.
  2919.  
  2920.           Assume that the above file is called DAYQUOTE.Q, compiling it is
  2921.           achieved by doing:
  2922.  
  2923.                   SQUOTE dayquote[.Q]
  2924.  
  2925.           where the .Q is assumed and is optional.  The compiler will
  2926.           indicate how many lines of quotes it found and write out a
  2927.           DAYQUOTE.CQ file.
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.                   --------------------------------------------------
  2939.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  2940.                                        Page 47                                       Page 47
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.           _________________________________________________________________
  2947.  
  2948.                                      Chapter 13                                     Chapter 13
  2949.  
  2950.                             SANSI: Simplex Ansi Compiler                            SANSI: Simplex Ansi Compiler
  2951.           _________________________________________________________________
  2952.  
  2953.  
  2954.  
  2955.  
  2956.           In order to assist you in preparing your ANSI and ASCII files,
  2957.           Simplex includes a compiler and a high-level language.  This
  2958.           system is called SANSI.  You can write a single "source" file
  2959.           which includes all of the information for screens which can be
  2960.           compiled into the respective .ANS and .ASC files.  The compiler
  2961.           will leave any ANSI statements out of of the .ASC files.
  2962.  
  2963.           The SANSI language will also access to special Simplex features
  2964.           as well as ANSI codes.  Special SANSI codes are introduced with `
  2965.           (forward single quote) in the .ANS and .ASC files (`` is
  2966.           interpreted by Simplex as being a `), however, use of the high-
  2967.           level language is strongly recommended for ease of maintenance.
  2968.  
  2969.           SANSI keywords are encoded in text in curly braces as in
  2970.           {sequence}.  Any number of SANSI keywords may be included in the
  2971.           curly braces separated by spaces (like {stopoff cls bell}).  To
  2972.           encode an true opening curly brace, simply type two in a row like
  2973.           this {{.  Following is a list of SANSI keywords and codes.
  2974.  
  2975.  
  2976.  
  2977.           13.1-SANSI User's Personal Information          13.1-SANSI User's Personal Information
  2978.           _________________________________________________________________
  2979.  
  2980.  
  2981.  
  2982.  
  2983.           Code   Representation                             SANSI Keyword
  2984.           -----  -----------------------------------------  -------------
  2985.           `A     User's Full Name                           name
  2986.           `B     User's First Name                          first
  2987.           `C     User's Last Name                           last
  2988.           `D     User's City-State                          citystate
  2989.           `E     User's Home Number                         homephone
  2990.           `F     User's Work/Data Number                    dataphone
  2991.           `G     User's Password                            password
  2992.           `H     User's Privilege Level (1 to 255)          priv
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.                   --------------------------------------------------
  3002.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3003.                                        Page 48                                       Page 48
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.           13.2-SANSI User's BBS Settings          13.2-SANSI User's BBS Settings
  3011.           _________________________________________________________________
  3012.  
  3013.  
  3014.  
  3015.  
  3016.           Code   Representation                             SANSI Keyword
  3017.           -----  -----------------------------------------  -------------
  3018.           `M     User's Baud Rate (300 -> 19200 or Local)   baud
  3019.           `N     User's Ansi Setting (On or Off)            ansi
  3020.           `O     User's More Setting (On or Off)            more
  3021.           `P     User's Clearscreen Setting (On or Off)     clear
  3022.           `Q     User's Editor Setting (Line or Ansi)       editor
  3023.           `R     User's Expert-mode Setting (On or Off)     expert
  3024.           `S     Length of User's Screen Page (for More)    pagelen
  3025.           `T     User's Netmail Credit ($x.xx)              credit
  3026.  
  3027.  
  3028.  
  3029.           13.3-SANSI User's Time/File Information          13.3-SANSI User's Time/File Information
  3030.           _________________________________________________________________
  3031.  
  3032.  
  3033.  
  3034.  
  3035.           Code   Representation                             SANSI Keyword
  3036.           -----  -----------------------------------------  -------------
  3037.           `a     Date of User's First Call (MM/DD/YY)       firstdate
  3038.           `b     Date of User's Last Call (MM/DD/YY)        lastdate
  3039.           `c     Time of User's Last Call (HH:MM)           lasttime
  3040.           `d     User's Total Daily Time (M mins S secs)    totaltime
  3041.           `e     Total Time Used Today (M mins S secs)      timeused
  3042.           `f     Time Remaining for Today (M mins S secs)   timeleft
  3043.           `g     Time Used During This Call (M mins S secs) timeon
  3044.           `h     User's Total Uploads (Number of Files)     ul
  3045.           `i     User's Total Uploaded Bytes (Kilobytes)    ulkb
  3046.           `j     User's Total Downloads (Number of Files)   dl
  3047.           `k     User's Total Downloaded Bytes (Kilobytes)  dlkb
  3048.           `l     Number of User's Calls to System           calls
  3049.  
  3050.  
  3051.  
  3052.           13.4-SANSI System Information          13.4-SANSI System Information
  3053.           _________________________________________________________________
  3054.  
  3055.  
  3056.  
  3057.  
  3058.           Code   Representation                             SANSI Keyword
  3059.           -----  -----------------------------------------  -------------
  3060.           `p     Day of Week (Monday, Tuesday, ... Sunday)  day
  3061.  
  3062.  
  3063.  
  3064.                   --------------------------------------------------
  3065.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3066.                                        Page 49                                       Page 49
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.           `q     Short Day of Week (Mon, Tue, ... Sun)      shortday
  3074.           `r     Date (MM/DD/YY)                            date
  3075.           `s     Time (HH:MM:SS)                            time
  3076.           `t     Number of Times User Yelled for Chat       yells
  3077.           `u     Total Number of Users on System            users
  3078.           `v     Last User on System                        lastuser
  3079.  
  3080.  
  3081.  
  3082.           13.5-SANSI System Control          13.5-SANSI System Control
  3083.           _________________________________________________________________
  3084.  
  3085.  
  3086.  
  3087.  
  3088.           Code   Representation                             SANSI Keyword
  3089.           -----  -----------------------------------------  -------------
  3090.           `0     Turn [More] Off                            moreoff
  3091.           `1     Turn [More] back On (If user allows it)    moreon
  3092.           `2     Turn [Stop] Off                            stopoff
  3093.           `3     Turn [Stop] On                             stopon
  3094.           `4     Pause and Wait for [Enter] to be Pressed   enter
  3095.           `5     Clearscreen code (FF character)            cls
  3096.           `6     Bell                                       bell
  3097.           `7     Backspace                                  bs
  3098.  
  3099.  
  3100.  
  3101.           13.6-SANSI ANSI Sequences          13.6-SANSI ANSI Sequences
  3102.           _________________________________________________________________
  3103.  
  3104.  
  3105.  
  3106.  
  3107.           Representation                                SANSI Keyword
  3108.           --------------------------------------------  -------------
  3109.           Set black foreground                          black
  3110.           Set red foreground                            red
  3111.           Set green foreground                          green
  3112.           Set brown foreground                          brown
  3113.           Set blue foreground                           blue
  3114.           Set magenta foreground                        magenta
  3115.           Set cyan foreground                           cyan
  3116.           Set white foreground                          white or lightgray
  3117.           Set gray foreground                           gray or lightblack
  3118.           Set light red foreground                      lightred
  3119.           Set light green foreground                    lightgreen
  3120.           Set yellow foreground                         yellow or
  3121.           lightbrown
  3122.           Set light blue foreground                     lightblue
  3123.           Set light magenta foreground                  lightmagenta
  3124.  
  3125.  
  3126.  
  3127.                   --------------------------------------------------
  3128.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3129.                                        Page 50                                       Page 50
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.           Set light cyan foreground                     lightcyan
  3137.           Set bright white foreground                   lightwhite
  3138.           Set black background                          onblack
  3139.           Set red background                            onred
  3140.           Set green background                          ongreen
  3141.           Set brown background                          onbrown
  3142.           Set blue background                           onblue
  3143.           Set magenta background                        onmagenta
  3144.           Set cyan background                           oncyan
  3145.           Set white background                          onwhite
  3146.           Set blinking characters                       blink
  3147.           Erase to End of Line                          erasetoeol
  3148.           Erase to End of Screen                        erasetoeos
  3149.           Erase to cursor from top of screen            erasefromtos
  3150.           Erase screen                                  erasescreen
  3151.           Move cursor up one line                       cursorup
  3152.           Move cursor down one line                     cursordown
  3153.           Move cursor left one character                cursorleft
  3154.           Move cursor right one character               cursorright
  3155.           Home cursor                                   home
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.                   --------------------------------------------------
  3191.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3192.                                        Page 51                                       Page 51
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.           _________________________________________________________________
  3199.  
  3200.                                      Chapter 14                                     Chapter 14
  3201.  
  3202.                         SMC: Simplex Menu Compiler/Decompiler                        SMC: Simplex Menu Compiler/Decompiler
  3203.           _________________________________________________________________
  3204.  
  3205.  
  3206.  
  3207.  
  3208.           In order to speed up development of menus on big Simplex
  3209.           applications, it might be easier to use SMC, the Simplex Menu
  3210.           Compiler.  This allows you to use a text editor to build menu
  3211.           source files, and thus be able to use the block-copy and
  3212.           find/replace facilities of the editor to ease the burden of menu
  3213.           development.
  3214.  
  3215.           Keywords are the following:
  3216.  
  3217.             menu "STRING" :  This sets the name of the menu file and resets
  3218.                     the line number counter.
  3219.                     e.g.  menu "main"
  3220.  
  3221.             prompt "STRING" : Sets the string as the prompt and all
  3222.                     subsequent information before the next "menu" or "line"
  3223.                     keywords will refer to the prompt.
  3224.                     e.g.  prompt "[^$r min^] What is your choice? "
  3225.  
  3226.             line "STRING" :  Sets the string as a menu line and all
  3227.                     subsequent information before the next "menu",
  3228.                     "prompt", or "line" keywords will refer to the new
  3229.                     line.
  3230.                     e.g.  line "<^M^> Go to Message Areas"
  3231.  
  3232.             define DEFINITION NUMBER *or*
  3233.             define DEFINITION "string" :  Allows the definition of a
  3234.                     constant value, either numeric or string.  Later use of
  3235.                     the definitions will be substitued for the
  3236.                     representative number or string by the compiler.
  3237.                     e.g. define WHITE 15
  3238.                          define RETURN "<^M^> Return to main menu"
  3239.  
  3240.             type NUMBER :  This is only valid in a "line" clause and sets
  3241.                     the type of the menu item to the specified value.  For
  3242.                     a list of menu types see above or type SMC without
  3243.                     parameters.
  3244.                     e.g.  type 0  /* show a menu line */
  3245.  
  3246.             priv VALUE :  This is only valid in a "line" clause and sets
  3247.                     the user privilege needed to see/access the menu item.
  3248.                     This value may be between 0 and 255.
  3249.                     e.g.  priv 255
  3250.  
  3251.  
  3252.  
  3253.                   --------------------------------------------------
  3254.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3255.                                        Page 52                                       Page 52
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.             flags "flag_vals" :  This is only valid in a "line" clause and
  3263.                     sets the user flags needed to see/access the menu item.
  3264.                     Flags are lettered from A to P (16 flags).
  3265.                     e.g.  flags "ABJMP"
  3266.  
  3267.             color VALUE :  This is valid in a "line" clause or a "prompt"
  3268.                     clause.  It sets the non-highlighted color for either
  3269.                     the current line or the current prompt.  The value is a
  3270.                     normal IBM color value from 0 to 255.  See below for a
  3271.                     list of color values.
  3272.                     e.g.  color 10
  3273.  
  3274.             hilite VALUE :  This is valid in a "line" clause or a "prompt"
  3275.                     clause.  It sets the hilighted color for either the
  3276.                     current line or the current prompt.  The value is a
  3277.                     normal IBM color value from 0 to 255.  See below for a
  3278.                     list of color values.
  3279.                     e.g.  hilite 14
  3280.  
  3281.             key "CHARACTER" :  This is valid only in a "line" clause and it
  3282.                     sets the value of the hotkey to trigger the option for
  3283.                     that menu line.  A character is any value >= ASCII 32
  3284.                     decimal.  To specify a non-keyed line, use key "" with
  3285.                     nothing between the quotes.  The character may be upper
  3286.                     or lowercase, however when a character is receieved by
  3287.                     the menu handler, it is case does not matter (i.e.
  3288.                     there is no difference between key "A" and key "a").
  3289.                     e.g.  key "A"
  3290.  
  3291.             auto :  This is valid only in a "line" clause and indicates
  3292.                     that the menu item autoexecutes when its line is being
  3293.                     shown.  See menu type 49 above for an example of using
  3294.                     autoexecution.
  3295.                     e.g.  auto
  3296.  
  3297.             expert :  This is valid only in a "line" clause and indicates
  3298.                     that the menu item is shown even if a user has expert
  3299.                     mode toggled on.  At least menu titles should be
  3300.                     qualified with the expert keyword so that a user can
  3301.                     know where they are on your system.
  3302.                     e.g.  expert
  3303.  
  3304.             data "STRING" :  This is valid only in a "line" clause.  It is
  3305.                     used to provide the additional data line needed by
  3306.                     various menu types (see above).
  3307.                     e.g.  data "logoff password"
  3308.  
  3309.           Using the SMC compiler will permit you to use the script language
  3310.           to put together a series of menus (you can have more than one
  3311.           menu in a .SMC file) and avoid the overhead of using the line-
  3312.  
  3313.  
  3314.  
  3315.  
  3316.                   --------------------------------------------------
  3317.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3318.                                        Page 53                                       Page 53
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.           by-line menu editor in CONFIG.  Should you wish to decompile an
  3326.           already existant menu, you can do it with the command line:
  3327.  
  3328.                   SMC /d file.mnu > file.smc
  3329.  
  3330.           which will redirect the decompiler's output into the required
  3331.           file which can then be editord and then recompiled using the
  3332.           following command line:
  3333.  
  3334.                   SMC file[.SMC]
  3335.  
  3336.  
  3337.           Color values in the IBM machine consist of an 8 bit number which
  3338.           is broken up as follows:
  3339.  
  3340.                   High   | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |   Low
  3341.                            ^ | Background| ^ | Foreground|
  3342.                          Blink          Hilight
  3343.  
  3344.           The background and foreground colors range from 0 to 7 and
  3345.           represent the following:
  3346.  
  3347.                   0  Black                4  Red
  3348.                   1  Blue                 5  Magenta
  3349.                   2  Green                6  Brown (Dark Yellow)
  3350.                   3  Cyan                 7  Light Gray (Dark White)
  3351.  
  3352.           The highlight bit refers to the foreground color so that
  3353.           essentially the following color numbers in the lower 4 bits
  3354.           indicate the following colors:
  3355.  
  3356.                   8  Dark Gray            12 Light Red
  3357.                   9  Light Blue           13 Light Magenta
  3358.                   10 Light Green          14 Yellow
  3359.                   11 Light Cyan           15 White
  3360.  
  3361.           The blink bit will make the foreground color blink.  Here is a
  3362.           list of all of the possible combinations using a black
  3363.           foreground:
  3364.  
  3365.                   0   Black on black      128 Blink black on black
  3366.                   16  Black on blue       144 Blink black on blue
  3367.                   32  Black on green      160 Blink black on green
  3368.                   48  Black on cyan       176 Blink black on cyan
  3369.                   64  Black on red        192 Blink black on red
  3370.                   80  Black on magenta    208 Blink black on magenta
  3371.                   96  Black on brown      224 Blink black on brown
  3372.                   112 Black on white      240 Blink black on white
  3373.  
  3374.  
  3375.  
  3376.  
  3377.  
  3378.  
  3379.                   --------------------------------------------------
  3380.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3381.                                        Page 54                                       Page 54
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.           Using this table, merely add your desired foreground color to the
  3389.           base value given, and you will have the number for that color.
  3390.           For example, light red on white is 12 + 112 = 124!
  3391.  
  3392.           In strings, to encode a literal " (double quote), use the
  3393.           sequence \".  For example, "this is a \"string\"" will become:
  3394.  
  3395.                   this is a "string"
  3396.  
  3397.           after it is compiled.
  3398.  
  3399.           In menu lines and menu data lines, the following meta commands
  3400.           are recognized and are substituted accordingly:
  3401.  
  3402.                   $$  Dollar sign         $r  Time left for call (mins)
  3403.                   $f  User's first name   $l  User's last name
  3404.                   $d  Current date        $t  Current time
  3405.                   $a  User's ANSI flag    $u  User's number on system
  3406.                   $b  User's baud rate    $## File board's directory
  3407.  
  3408.           In menu lines the following have special significance:
  3409.  
  3410.                   $c  As the final two chars of a line means "continue"
  3411.                       next menu line without going to next line.
  3412.                   ^   Indicates a change of color from normal to hilight or
  3413.                       vice versa.
  3414.                   ^^  Means show a caret (^) mark.
  3415.  
  3416.           In data lines the following have special significance:
  3417.  
  3418.                   $*  Shell with hot fossil (DOS only).  Do not
  3419.                       deinitialize fossil driver before executing program.
  3420.                       Note that this option is not passed as a parameter to
  3421.                       the program in a type 240 menu option.
  3422.                   $e  After executing program, pause and wait for Enter
  3423.                       before continuing.  Note that this option is not
  3424.                       passed as a parameter to the program in a type 240
  3425.                       menu option.
  3426.  
  3427.           Here is a sample fragment of an SMC script for a menu:
  3428.  
  3429.           /* Comments are done like this and can span
  3430.           ** multiple lines. */
  3431.  
  3432.  
  3433.           menu "logoff"   /* this begins the menu called logoff */
  3434.             prompt "[^$r min^] What is your choice?"
  3435.                   color 15        hilite 14
  3436.  
  3437.             line "[ ^Log Off Menu ^ >----------------------"
  3438.                   type 0  expert  priv 0  color 13  hilite 14
  3439.  
  3440.  
  3441.  
  3442.                   --------------------------------------------------
  3443.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3444.                                        Page 55                                       Page 55
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.             line ""       /* blank "space holder" line */
  3452.                   type 0  priv 0  color 7  hilite 15
  3453.  
  3454.             line ""
  3455.                   type 0  priv 0  color 7  hilite 15
  3456.  
  3457.             line "<^Y^> Yes, log me off right now!"
  3458.                   type 255  key "Y"  priv 0  color 11  hilite 14
  3459.  
  3460.             line "<^N^> No, do not log me off!"
  3461.                   type 3  key "N"  priv 0  color 10  hilite 14
  3462.  
  3463.             line "<^L^> Leave a message to Sysop and log off!"
  3464.                   type 16  key "L"  data "1 /T=Chris_Laforet /L"
  3465.                   priv 0  color 12  hilite 14
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.                   --------------------------------------------------
  3506.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3507.                                        Page 56                                       Page 56
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.           _________________________________________________________________
  3514.  
  3515.                                      Chapter 15                                     Chapter 15
  3516.  
  3517.                            Acknowlegements and Thank Yous                           Acknowlegements and Thank Yous
  3518.           _________________________________________________________________
  3519.  
  3520.  
  3521.  
  3522.  
  3523.           First of all, thanks goes to God for His strength and guidance
  3524.           during the development of Simplex BBS.  Without His Spirit, this
  3525.           project would never have made it off of the ground!
  3526.  
  3527.           I know that it is not very often that I seem appreciative of the
  3528.           many bug reports from my beta testers, especially since bugs pop
  3529.           up at the most inconvenient times.  I know that getting a BBS up
  3530.           and running can be rough especially when you have bugs to contend
  3531.           with, and users who jump all over you when features break down!!
  3532.           Thank you guys for a job well done, and may I add, keep up the
  3533.           good work.
  3534.  
  3535.           The job accomplished by beta testers is so important and yet it
  3536.           is downplayed.  These are the guys who actually stand on the
  3537.           front line and get pounded by bugs and undocumented "features".
  3538.           Special thanks goes to my beta testers:
  3539.  
  3540.                Robbie Foust of Stardate BBS       (1:151/404 at
  3541.           919/376-8432)
  3542.                Kelly Hughes of Bedside Manor BBS  (1:151/117 at
  3543.           919/233-8566)
  3544.                Scott Hughes of NightHawk BBS      (1:151/406 at
  3545.           919/228-7002)
  3546.  
  3547.           Thanks goes especially for my wife, Sherry, a "computer widow"
  3548.           who spent much time listening to me pecking at the keyboard late
  3549.           into the night for the many months spent while developing
  3550.           Simplex.  She is the one who named the package and I dedicate it
  3551.           to her and to my lovely daughter Rebekah.
  3552.  
  3553.           Thanks to Brady Flowers of Oberon Software in Mankato, MN for
  3554.           helping me through some of OS/2's uncharted reefs!  Thanks also
  3555.           to Michael Sly of Berean BBS in Warren, MI who is
  3556.           amending/expanding this user's manual.
  3557.  
  3558.           Thanks to the many people who have made excellent suggestions for
  3559.           features in Simplex over the course of time.  Thanks also to the
  3560.           many kind souls who reported bugs and who sent messages of
  3561.           encouragement.
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.                   --------------------------------------------------
  3569.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3570.                                        Page 57                                       Page 57
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.           _________________________________________________________________
  3577.  
  3578.                                      Chapter 16                                     Chapter 16
  3579.  
  3580.                                   Revision History                                  Revision History
  3581.           _________________________________________________________________
  3582.  
  3583.  
  3584.  
  3585.  
  3586.           Version 1.00:  Released Jan 3, 1991.  This was the first non-beta
  3587.                          version of Simplex.  Events are not completed.
  3588.                          ANSI editor can have some additional features
  3589.                          added.  External protocols are not yet
  3590.                          implemented.
  3591.  
  3592.           Version 1.01:  Released Feb 24, 1991.  The following things were
  3593.                          modified or added:
  3594.  
  3595.                   - Linted and cleaned up code.
  3596.                   - Added logic to put commas in displays of numbers (as in
  3597.                   1,009,198).
  3598.                   - Squashed bug in Ymodem and Ymodem-G send which wasted
  3599.                   file-handles by reopening the file to send each time it
  3600.                   send SOH!
  3601.                   - Fixed the problem when adding a new message area,
  3602.                   causing false message counts for that area instead of a
  3603.                   count of 0.
  3604.                   - Added logic for handling logins of deleted users.
  3605.                   - Added logic for re-entering names if hitting enter on
  3606.                   password 3 times in a row.
  3607.                   - Cleaned up s_start.c to stop initializing and
  3608.                   deintializing fossil each time it went out to
  3609.                   reinitialize the modem.
  3610.                   - Cleaned up OS/2 fossil threads to exit upon
  3611.                   deinitialization of fossil.
  3612.                   - Started work on the MultiChat version of OS/2.
  3613.                   - Fixed problem that allowed echomail-barred users to
  3614.                   reply to echomail messages!  Now if user doesn't have a
  3615.                   level >= write_level for the echo, they cannot reply.
  3616.                   - Added option that users with a level >= sysop_level for
  3617.                   an echomail area can now send echomail addressed to
  3618.                   "Sysop".  Other users cannot enter mail to sysop in an
  3619.                   echomail area.
  3620.                   - Added new options, uptime, downtime, change priv.
  3621.                   - Allow zone to go up to 99.
  3622.  
  3623.                   - Smailfix now has a new option -date to delete messages
  3624.                   with a date greater than today's date.
  3625.  
  3626.                   - SMC and Config were modified to support the new menu
  3627.                   options in Simplex.
  3628.  
  3629.  
  3630.  
  3631.                   --------------------------------------------------
  3632.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3633.                                        Page 58                                       Page 58
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.                The only known bug at this point is that Simplex Zmodem
  3641.                   download will occassionally hang when garbage characters
  3642.                   are coming in on the back channel and it requests a ZACK
  3643.                   from the receiver.
  3644.  
  3645.           Version 1.02:  Released March 3, 1991.  The following things were
  3646.                          added and modified:
  3647.  
  3648.                   - Corrected minor bug in s_user which didn't clear change
  3649.                   flag when searching or next find.
  3650.                   - Corrected bug in search nodelist.
  3651.                   - Corrected bug in show new files in a single area.
  3652.                   - Added support for user flags.
  3653.                   - Added file handling that closes open handles when
  3654.                   carrier is dropped.
  3655.  
  3656.           Version 1.03:  Released March 10, 1991.  The following things
  3657.                          were added and modified:
  3658.  
  3659.                   - Set up Path separators as macros to aid portability.
  3660.                   - Set up get_closefile in preparation for porting.
  3661.                   - Added SETFLAG and UNSETFLAG keywords to questionaire
  3662.                   language.
  3663.                   - Set up to handle all ^a kludges if area is echo or net
  3664.                   and user has
  3665.                   sysop priv in the message area.
  3666.  
  3667.                   - Fixed bug in SMC with compiling flags.
  3668.                   - Fixed SMAIL to handle ^a kludges.
  3669.                   - Fixed SMAIL to handle PATH and SEEN-BY lines correctly.
  3670.  
  3671.           Version 1.04:  Released April 27, 1991.  The following things
  3672.                          were added and modified:
  3673.  
  3674.                   - Added absolute time setting menu option.
  3675.                   - Changed efficiency percentages of protocols.
  3676.                   - Fixed move_messages to correctly turn on
  3677.                   netmail/echomail entered flags.
  3678.                   - Added $k option to external shell which allows a user's
  3679.                   time to be kept untouched while he/she is out of Simplex
  3680.                   (i.e. time is not recalculated upon reentry).
  3681.                   - Added logic to check for events after returning from
  3682.                   external shell.
  3683.                   - Expanded file-list buffer from 150 to 256 characters.
  3684.                   - Fixed bug in running help in ANSI editor from quote
  3685.                   window which blew memory!
  3686.                   - Added 8th-bit filter to chat mode on incoming to help
  3687.                   if chatting with someone who has 7 bits and even, mark or
  3688.                   odd parity on!
  3689.                   - Set up to show crash-mail boards in listings of Fido
  3690.                   nodes.
  3691.  
  3692.  
  3693.  
  3694.                   --------------------------------------------------
  3695.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3696.                                        Page 59                                       Page 59
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.                   - Show warnings that a board is not CM if it isn't when
  3704.                   entering a message.
  3705.                   - Fixed error FATAL to ERROR in s_run.c if unable to
  3706.                   spawn program.
  3707.                   - Added combined message boards - reading, scanning and
  3708.                   quick-scanning.
  3709.                   - Fixed problem where a user couldn't quote messages with
  3710.                   Ctrl-A kludge in s_full.c (ANSI editor).
  3711.                   - Installed menu template types in s_menu.c
  3712.                   - Fixed problem with logging in if there are no message
  3713.                   areas.  This was due to calling message-handling
  3714.                   functions which had no checks for message file existence.
  3715.                   - Fixed bug in filename search routines to correctly
  3716.                   handle wildcards.
  3717.                   - Added S flag for DOS startup which prevents Simplex
  3718.                   from closing the
  3719.                   stdout (console writes) handle and reopening it to the
  3720.                   NUL device (to prevent fossils like X00 from messing up
  3721.                   the screen!).
  3722.                   - Added new menu item: Replace Current Menu.
  3723.                   - Added new menu item: Show Quote from file.
  3724.                   - Added downloadable combination mail.
  3725.                   - Shorted timeouts in Zmodem.
  3726.                   - Corrected bug in ansi editor.  User could insert a
  3727.                   blank line and arrow over a few spaces and start typing
  3728.                   -- this would cause the contents of the previous line to
  3729.                   spill out of the end of the current line as if they were
  3730.                   being pushed by the insertion of the new text!
  3731.                   - Sped up filename and keyword searches across file
  3732.                   areas.  Fixed minor bugs in keyword search code.
  3733.                   - Cleaned up OS/2 FOSSIL startup.
  3734.                   - Cleaned up Zmodem and Ymodem-G along with protocol-
  3735.                   sends under OS/2.
  3736.                   - Set up netmail to handle routed and hold-for-pickup
  3737.                   mail options.
  3738.                   -
  3739.                   Added -D flag which allows Simplex to start up with a
  3740.                   data file containing a user's information.
  3741.  
  3742.                   - Added quiet flags to SPACK and SCLEAN.
  3743.  
  3744.                   - SMP: Stopped echomail with INTL addresses from being
  3745.                   sent to their origins by comparing INTL-net and INTL-node
  3746.                   with header destination net/node.  If no match, the
  3747.                   message is sent to header net/node else it is sent to
  3748.                   INTL location.
  3749.                   - SMP: Corrected problem in preliminary routing where
  3750.                   "ALL" destinations were not matched and acted upon.
  3751.                   - SMP: Changed routing verbs to match new Simplex mail
  3752.                   philosophy.
  3753.  
  3754.  
  3755.  
  3756.  
  3757.                   --------------------------------------------------
  3758.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3759.                                        Page 60                                       Page 60
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.                   - SMAIL: Corrected message headers for echomail to
  3767.                   include current node's address when forwarding mail.
  3768.                   - SMAIL: Improved resynchronizing algorithm while
  3769.                   unpacking packets.
  3770.                   - SMAIL: Corrected problem that prevented grunged packets
  3771.                   from being deleted.
  3772.  
  3773.                   - CONFIG: Set up Path seperators as macros to aid
  3774.                   portability.
  3775.                   - CONFIG: Fixed minor problem with deleting user.
  3776.                   - CONFIG: Corrected problem with net-credit field.
  3777.  
  3778.                Known bugs at this point:
  3779.  
  3780.                   - Occasionally, some Zmodem and Ymodem-G users encounter
  3781.                   problems.
  3782.                   - Last Read message pointers can sometimes be reset for
  3783.                   some users.
  3784.                   - Smail still cannot handle every perversion of
  3785.                   FSC-0001's date/time stamp standard.  Please report the
  3786.                   source programs (e.g. Simplex) which have problems in
  3787.                   this area!
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.                   --------------------------------------------------
  3821.           Simplex BBS                                       A User's Manual          Simplex BBS                                       A User's Manual
  3822.                                        Page 61                                       Page 61
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.           ____________________________________________________________
  3829.  
  3830.  
  3831.                                Table of Contents                               Table of Contents
  3832.           ____________________________________________________________
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.                Chapter 1  Legalistic Mumbo-Jumbo                     2               Chapter 1
  3839.  
  3840.                Chapter 2  Introduction to Simplex                    4               Chapter 2
  3841.  
  3842.                Chapter 3  Installing Simplex                         5               Chapter 3
  3843.                   3.1   Simplex and Answering the Phone  . . . . . . 5                  3.1
  3844.                   3.2   Setting Up Simplex BBS Paths . . . . . . . . 6                  3.2
  3845.                   3.3   Presumptions Underlying Simplex's Fidonet                  3.3
  3846.                         Mail . . . . . . . . . . . . . . . . . . . . 7
  3847.                   3.4   Installing A Fidonet Node  . . . . . . . . . 8                  3.4
  3848.                   3.5   Configuring Simplex with CONFIG  . . . . . . 9                  3.5
  3849.  
  3850.                Chapter 4  Simplex Menu Types                        13               Chapter 4
  3851.  
  3852.                Chapter 5  Menu Templates                            21               Chapter 5
  3853.                   5.1   Assigning Menu Template Macros . . . . . .  21                  5.1
  3854.                   5.2   Using Template Macro Assignments . . . . .  22                  5.2
  3855.  
  3856.                Chapter 6  Running Simplex                           23               Chapter 6
  3857.  
  3858.                Chapter 7  Setting up Downloadable Mail              26               Chapter 7
  3859.  
  3860.                Chapter 8  Simplex Ancillary Files                   28               Chapter 8
  3861.                   8.1   Files for Help . . . . . . . . . . . . . .  28                  8.1
  3862.                   8.2   General Files  . . . . . . . . . . . . . .  29                  8.2
  3863.                   8.3   Files Created by CONFIG  . . . . . . . . .  31                  8.3
  3864.                   8.4   Files Needed by Simplex  . . . . . . . . .  31                  8.4
  3865.                   8.5   Files Created by Simplex . . . . . . . . .  33                  8.5
  3866.                   8.6   Files used by Simplex Utilities  . . . . .  34                  8.6
  3867.  
  3868.                Chapter 9  Simplex External Mail Utilities           38               Chapter 9
  3869.                   9.1   SCLEAN: Simplex Mail Cleaning Utility  . .  38                  9.1
  3870.                   9.2   SPACK: Simplex Message Base Deletion . . .  39                  9.2
  3871.                   9.3   SLINK: Simplex Message Thread Linker . . .  39                  9.3
  3872.                   9.4   SMAIL: Simplex FidoNet Mail Utility  . . .  40                  9.4
  3873.                   9.5   SMP: Simplex Mail Packer . . . . . . . . .  42                  9.5
  3874.                   9.6   SMAILFIX: Simplex Mail Fixer . . . . . . .  42                  9.6
  3875.  
  3876.                Chapter 10  SUSAGE and SRECENT: Simplex Screen               Chapter 10
  3877.                            Builders                                 44
  3878.  
  3879.                Chapter 11  Simplex Questionaire Language            45               Chapter 11
  3880.  
  3881.  
  3882.  
  3883.                                           i
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.                Chapter 12  SQUOTE: Simplex Quote File Compiler      47               Chapter 12
  3891.  
  3892.                Chapter 13  SANSI: Simplex Ansi Compiler             48               Chapter 13
  3893.                   13.1   SANSI User's Personal Information . . . .  48                  13.1
  3894.                   13.2   SANSI User's BBS Settings . . . . . . . .  49                  13.2
  3895.                   13.3   SANSI User's Time/File Information  . . .  49                  13.3
  3896.                   13.4   SANSI System Information  . . . . . . . .  49                  13.4
  3897.                   13.5   SANSI System Control  . . . . . . . . . .  50                  13.5
  3898.                   13.6   SANSI ANSI Sequences  . . . . . . . . . .  50                  13.6
  3899.  
  3900.                Chapter 14  SMC: Simplex Menu Compiler/Decompiler    52               Chapter 14
  3901.  
  3902.                Chapter 15  Acknowlegements and Thank Yous           57               Chapter 15
  3903.  
  3904.                Chapter 16  Revision History                         58               Chapter 16
  3905.  
  3906.  
  3907.  
  3908.  
  3909.  
  3910.  
  3911.  
  3912.  
  3913.  
  3914.  
  3915.  
  3916.  
  3917.  
  3918.  
  3919.  
  3920.  
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.  
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.                                          ii
  3945.