home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / bbs / maximus / max_op.prn < prev    next >
Encoding:
Text File  |  1991-11-04  |  303.1 KB  |  7,775 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                      Maximus-CBCS Version 2.00 Operations Manual
  27.             Copyright 1990, 1991 by Scott J. Dudley.  All rights reserved.
  28.                               Created November 3, 1991.
  29.  
  30.  
  31.                   Documentation produced by Bob Davis, Scott Dudley,
  32.                       Jesse David Hollington and Erik Van Riper,
  33.                            with Don Dawson and Hubert Lai.
  34.  
  35.  
  36.  
  37.                                   TABLE OF CONTENTS
  38.  
  39.           LICENCE . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  40.  
  41.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   6
  42.                Notes from the Author  . . . . . . . . . . . . . . . . .   6
  43.                Maximus, Money and You . . . . . . . . . . . . . . . . .   7
  44.                Credits  . . . . . . . . . . . . . . . . . . . . . . . .   9
  45.                It's Canadian, eh? . . . . . . . . . . . . . . . . . . .  11
  46.  
  47.           SYSTEM REQUIREMENTS . . . . . . . . . . . . . . . . . . . . .  12
  48.  
  49.           MAXIMUS OVERVIEW  . . . . . . . . . . . . . . . . . . . . . .  13
  50.                Logging On . . . . . . . . . . . . . . . . . . . . . . .  13
  51.                The Main Menu  . . . . . . . . . . . . . . . . . . . . .  15
  52.                The Message Section  . . . . . . . . . . . . . . . . . .  18
  53.                The Message Menu . . . . . . . . . . . . . . . . . . . .  19
  54.                Message Entry  . . . . . . . . . . . . . . . . . . . . .  26
  55.                Message Editors  . . . . . . . . . . . . . . . . . . . .  27
  56.                The File Menu  . . . . . . . . . . . . . . . . . . . . .  31
  57.                The Change Setup Menu  . . . . . . . . . . . . . . . . .  35
  58.                The SysOp Menu . . . . . . . . . . . . . . . . . . . . .  39
  59.                The Chat Menu  . . . . . . . . . . . . . . . . . . . . .  40
  60.                The Off-Line Reader Menu . . . . . . . . . . . . . . . .  41
  61.  
  62.           INSTALLATION INSTRUCTIONS . . . . . . . . . . . . . . . . . .  43
  63.                Step 1:  Where do I put these files? . . . . . . . . . .  43
  64.                Step 2:  Configuring your Modem  . . . . . . . . . . . .  44
  65.                Step 3:  Installing a FOSSIL . . . . . . . . . . . . . .  46
  66.                Step 4:  Editing Configuration Files . . . . . . . . . .  48
  67.                Step 5:  Setting Up Control Files  . . . . . . . . . . .  50
  68.                Step 6:  Compiling the Control Files . . . . . . . . . .  51
  69.                Step 7:  Starting Maximus  . . . . . . . . . . . . . . .  52
  70.                Step 8:  Support for Remote Callers  . . . . . . . . . .  53
  71.                Step 9:  Events and Yelling  . . . . . . . . . . . . . .  62
  72.                Step 10:  About Priv Levels and Locks  . . . . . . . . .  64
  73.                Step 11:  Customizing *.BBS Files  . . . . . . . . . . .  66
  74.                Step 12:  Customizing Msg/File Areas . . . . . . . . . .  68
  75.                Step 13:  Maintaining File Areas . . . . . . . . . . . .  72
  76.                Step 14:  Customizing Menus  . . . . . . . . . . . . . .  76
  77.                Step 15:  Configuring the QWK Mail Packer  . . . . . . .  77
  78.                Step 16:  Miscellaneous Information  . . . . . . . . . .  78
  79.  
  80.           MAXIMUS UTILITY DOCUMENTATION . . . . . . . . . . . . . . . .  79
  81.                ACCEM:  MECCA Decompiler . . . . . . . . . . . . . . . .  79
  82.                ANSI2BBS/MEC:  ANSI to MEC conversion  . . . . . . . . .  81
  83.                CVTUSR:  User File Conversions . . . . . . . . . . . . .  83
  84.                EDITCALL:  Call Fudging Utility  . . . . . . . . . . . .  85
  85.                FB:  File Database Compiler  . . . . . . . . . . . . . .  86
  86.                MAID:  Language File Compiler  . . . . . . . . . . . . .  89
  87.                MECCA:  Display File Compiler  . . . . . . . . . . . . .  91
  88.                MR: Maximus Renumbering Program  . . . . . . . . . . . .  92
  89.  
  90.  
  91.  
  92.                ORACLE:  Display File Viewer . . . . . . . . . . . . . .  93
  93.                SCANBLD:  Database Builder . . . . . . . . . . . . . . .  95
  94.                SILT:  Control File Compiler . . . . . . . . . . . . . .  98
  95.  
  96.           RUNNING EXTERNAL PROGRAMS . . . . . . . . . . . . . . . . . . 100
  97.                Execution Methods  . . . . . . . . . . . . . . . . . . . 100
  98.                ErrorLevel Batch Files . . . . . . . . . . . . . . . . . 101
  99.                Restarting After Chain/Errorlevel  . . . . . . . . . . . 103
  100.                External Program Translation Characters  . . . . . . . . 105
  101.                Running Doors  . . . . . . . . . . . . . . . . . . . . . 108
  102.                On-Line User Record Modification . . . . . . . . . . . . 112
  103.  
  104.           MULTI-LINE OPERATION GUIDE  . . . . . . . . . . . . . . . . . 113
  105.                Installation . . . . . . . . . . . . . . . . . . . . . . 113
  106.                Multi-Node Chat Operation  . . . . . . . . . . . . . . . 115
  107.  
  108.           USING CUSTOM MENUS  . . . . . . . . . . . . . . . . . . . . . 118
  109.  
  110.           WAITING FOR CALLER SUBSYSTEM  . . . . . . . . . . . . . . . . 120
  111.                Starting WFC . . . . . . . . . . . . . . . . . . . . . . 120
  112.                Screen Display and SysOp Keys  . . . . . . . . . . . . . 120
  113.  
  114.           EXPIRATION/SUBSCRIPTION SYSTEM  . . . . . . . . . . . . . . . 122
  115.  
  116.           MULTILINGUAL SUPPORT  . . . . . . . . . . . . . . . . . . . . 123
  117.  
  118.           QWK MAIL PACKER . . . . . . . . . . . . . . . . . . . . . . . 125
  119.                Configuration  . . . . . . . . . . . . . . . . . . . . . 125
  120.                Bulletins, News Files and File Lists . . . . . . . . . . 125
  121.                Remote Message Packing . . . . . . . . . . . . . . . . . 126
  122.                Local Mail Packing . . . . . . . . . . . . . . . . . . . 127
  123.                Unattended Mail Packing ("Vacation Saver") . . . . . . . 127
  124.                NetMail Messages . . . . . . . . . . . . . . . . . . . . 128
  125.  
  126.           MISCELLANEOUS INFORMATION . . . . . . . . . . . . . . . . . . 129
  127.                Filename Specifications  . . . . . . . . . . . . . . . . 129
  128.                Hard-Coded Filenames . . . . . . . . . . . . . . . . . . 129
  129.  
  130.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
  131.  
  132.  
  133.  
  134.                                        LICENCE
  135.  
  136.           Copyright 1991 by Scott J. Dudley.  All rights reserved. 
  137.           COMMERCIAL DISTRIBUTION AND/OR USE PROHIBITED WITHOUT WRITTEN
  138.           CONSENT FROM THE AUTHOR.
  139.  
  140.           Noncommercial distribution and/or use is permitted under the
  141.           following terms:
  142.  
  143.           1)   You may copy and distribute verbatim copies of the Maximus-
  144.                CBCS source, documentation, and executable code as you
  145.                receive it, in any medium, provided that you conspicuously
  146.                and appropriately publish on each copy a valid copyright
  147.                notice "Copyright 1991 by Scott J. Dudley"; keep intact the
  148.                notices on all files that refer to this Licence Agreement
  149.                and to the absence of any warranty;  PROVIDE UNMODIFIED
  150.                COPIES OF THE DOCUMENTATION AS PROVIDED WITH THE PROGRAM;
  151.                and give any other recipients of the Maximus-CBCS program a
  152.                copy of this Licence Agreement along with the program.  You
  153.                may charge a distribution fee for the physical act of
  154.                transferring a copy, but no more than is necessary to
  155.                recover your actual costs incurred in the transfer. Under no
  156.                circumstances is Maximus-CBCS to be distributed in such a
  157.                way as to be construed as "value added" in a sales
  158.                transaction, such as, but not limited to, software bundled
  159.                with a modem or CD-ROM software collections, without the
  160.                prior written consent of the author.
  161.  
  162.           2)   You may modify your copy or copies of Maximus-CBCS or any
  163.                portion of it, and copy and distribute such modifications
  164.                under the terms of Paragraph 1 above, provided that you also
  165.                do the following:
  166.  
  167.                a) cause the modified files to carry prominent notices
  168.                stating that you changed the files and the date of any
  169.                change;
  170.  
  171.                b) cause the executable code of such modified version to
  172.                clearly identify itself as such in the course of its normal
  173.                operation;
  174.  
  175.                c) if the modified version is not a "port", but operates in
  176.                the same hardware and/or software environment as the
  177.                original distribution, make the original version equally
  178.                available, clearly identifying same as the original,
  179.                unmodified version;
  180.  
  181.                d) cause the whole of any work that you distribute or
  182.                publish, that in whole or in part contains or is a
  183.  
  184.  
  185.                     Maximus-CBCS v2.00 Operations Manual - Page 1
  186.  
  187.  
  188.  
  189.                derivative of Maximus-CBCS or any part thereof, to be
  190.                licensed at no charge to all third parties on terms
  191.                identical to those contained in this Licence Agreement
  192.                (except that you may choose to grant more extensive warranty
  193.                protection to some or all third parties, at your option);
  194.                and:
  195.  
  196.                e) send the complete source code modifications to Scott
  197.                Dudley at the addresses listed below,  for the purpose of
  198.                evaluation for inclusion in future releases of Maximus-CBCS. 
  199.                Should your source code be included in Maximus-CBCS, Scott
  200.                Dudley retains all rights for redistribution of the code as
  201.                part of Maximus-CBCS and all derivative works, with
  202.                appropriate credit given to the author of the modification;
  203.  
  204.                f) You may charge a distribution fee for the physical act of
  205.                transferring a copy, but no more than is necessary to
  206.                recover your actual costs incurred in the transfer, and you
  207.                may at your option offer warranty protection in exchange for
  208.                a fee;
  209.  
  210.                g) when distributing modified versions of Maximus-CBCS, you
  211.                must not change the name of the program or the official
  212.                version number, except to append an identifier which
  213.                indicates that modifications have been made.  For ports to
  214.                other operating systems, the following convention must be
  215.                followed:
  216.  
  217.                     Maximus-CBCS v<v>.<os>.R<r>
  218.  
  219.                ...where <v> is the official Maximus-CBCS version number,
  220.                <os> is the name of the operating system which the port runs
  221.                under, and <r> (optional) is the OS-specific revision
  222.                number.  For example, the second OS/2 revision of Maximus-
  223.                CBCS 1.02 must have a version string in this format: 
  224.                `Maximus-CBCS v1.02.OS/2.R2'
  225.  
  226.                Similarly, modifications to Maximus-CBCS which are designed
  227.                to run under MS-DOS must also follow a naming convention. 
  228.                The version string must read:
  229.  
  230.                     Maximus-CBCS v<v>.<i>.<r>
  231.  
  232.                where <v> is the official Maximus-CBCS version number, <i>
  233.                is three initials (indicating your first, middle and last
  234.                names), and <r> (optional) is the revision number of your
  235.                modifications.
  236.  
  237.  
  238.  
  239.  
  240.                     Maximus-CBCS v2.00 Operations Manual - Page 2
  241.  
  242.  
  243.  
  244.                For example, a version of Maximus-CBCS 2.00 modified by Joe
  245.                T. SysOp must have a version string in this format:
  246.                `Maximus-CBCS v2.00.jts.1'
  247.  
  248.           3)   Mere aggregation of another unrelated program with this
  249.                program and documentation (or derivative works) on a volume
  250.                of a storage or distribution medium does not bring the other
  251.                program under the scope of these terms.
  252.  
  253.           4)   You may copy and distribute Maximus-CBCS and its associated
  254.                documentation (or a portion or derivative of it, under
  255.                Paragraph 2) in object code or executable form under the
  256.                terms of Paragraphs 1 and 2 above provided that you also do
  257.                one of the following:
  258.  
  259.                a) accompany it with the complete corresponding
  260.                machine-readable source code, which must be distributed
  261.                under the terms of Paragraphs 1 and 2 above; or,
  262.  
  263.                b) accompany it with a written offer, valid for at least
  264.                three years, to give any third party free (except for a
  265.                nominal shipping charge) a complete machine-readable copy of
  266.                the corresponding source code, to be distributed under the
  267.                terms of Paragraphs 1 and 2 above; or,
  268.  
  269.                c) accompany it with the information you received as to
  270.                where the corresponding source code may be obtained. (This
  271.                alternative is allowed only for noncommercial distribution
  272.                and only if you received the program in object code or
  273.                executable form alone.)
  274.  
  275.                For an executable file, complete source code means  all the
  276.                source code for all modules it contains; but, as a special
  277.                exception, it need not include source code for modules which
  278.                are standard libraries that accompany the operating system
  279.                on which the executable file runs.
  280.  
  281.           5)   You may not copy, sublicense, distribute or transfer
  282.                Maximus-CBCS and its associated documentation except as
  283.                expressly provided under this Licence Agreement.  Any
  284.                attempt otherwise to copy, sublicense, distribute or
  285.                transfer Maximus-CBCS is void and your rights to use the
  286.                program under this Licence agreement shall be automatically
  287.                terminated.
  288.  
  289.                However, parties who have received computer software
  290.                programs from you with this Licence Agreement will not have
  291.                their licences terminated so long as such parties remain in
  292.  
  293.  
  294.  
  295.                     Maximus-CBCS v2.00 Operations Manual - Page 3
  296.  
  297.  
  298.  
  299.                full compliance, and notify Scott Dudley of their intention
  300.                to comply with this Agreement.
  301.  
  302.           6)   You may not incorporate parts of Maximus-CBCS into a program
  303.                which is NOT completely free for ALL users. If you wish to
  304.                use Maximus-CBCS in such a way, you must obtain written
  305.                permission from Scott Dudley before using any of the
  306.                Maximus-CBCS code.
  307.  
  308.           7)   You may not incorporate parts of Maximus-CBCS into a
  309.                FUNCTIONALLY SIMILAR program, including other bulletin board
  310.                packages or tossers/scanners.  If you are writing another
  311.                BBS or remote host package, you must contact Scott Dudley
  312.                before using any of the Maximus-CBCS code.
  313.  
  314.           8)   The privileges granted above apply only to noncommercial
  315.                users of the Maximus-CBCS software.  You are a NONCOMMERCIAL
  316.                user only if you are running Maximus-CBCS a private
  317.                individual with no "sponsors", "backers", and only if your
  318.                BBS is not making (or helping to make) a profit.  You are a
  319.                COMMERCIAL user if you make a profit from running your BBS. 
  320.                You are also a COMMERCIAL user if your BBS is being run by
  321.                (or for) any corporation, government, company, foundation,
  322.                church, school, or any other organization  You are also a
  323.                COMMERCIAL user if your system is used to advertise such a
  324.                commercial organization for the purposes of making a profit.
  325.  
  326.                This licence only governs NONCOMMERCIAL users.  If you are a
  327.                COMMERCIAL user, you are not licensed to use or distribute
  328.                this software without the prior written consent of Scott
  329.                Dudley.  If you wish to run Maximus-CBCS as a commercial
  330.                user, please see the section below on site licences.
  331.  
  332.           9)   This licence may be revoked by Scott Dudley without prior
  333.                notice.
  334.  
  335.                                      NO WARRANTY
  336.  
  337.           BECAUSE MAXIMUS-CBCS IS LICENSED FREE OF CHARGE, WE PROVIDE
  338.           ABSOLUTELY NO WARRANTY.  EXCEPT WHEN OTHERWISE STATED IN WRITING,
  339.           SCOTT DUDLEY AND/OR OTHER PARTIES PROVIDE MAXIMUS-CBCS "AS IS"
  340.           WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
  341.           INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  342.           MERCHANTABILITY AND FITNESS FOR A  PARTICULAR PURPOSE.  THE
  343.           ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF MAXIMUS-CBCS,
  344.           AND THE ACCURACY OF ITS ASSOCIATED DOCUMENTATION, IS WITH YOU. 
  345.           SHOULD MAXIMUS-CBCS OR ITS ASSOCIATED DOCUMENTATION PROVE
  346.           DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR
  347.           OR CORRECTION.
  348.  
  349.  
  350.                     Maximus-CBCS v2.00 Operations Manual - Page 4
  351.  
  352.  
  353.  
  354.           IN NO EVENT WILL SCOTT DUDLEY BE RESPONSIBLE IN ANY WAY FOR THE
  355.           BEHAVIOUR OF MODIFIED VERSIONS OF MAXIMUS-CBCS. IN NO EVENT WILL
  356.           SCOTT DUDLEY AND/OR ANY OTHER PARTY WHO MAY MODIFY AND
  357.           REDISTRIBUTE MAXIMUS-CBCS AS PERMITTED ABOVE, BE LIABLE TO YOU
  358.           FOR DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES, OR OTHER
  359.           SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  360.           USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF
  361.           DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  362.           THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  363.           OTHER PROGRAMS) MAXIMUS-CBCS, EVEN IF SCOTT DUDLEY HAS BEEN
  364.           ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY
  365.           ANY OTHER PARTY.
  366.  
  367.           You can contact the author at any of the addresses listed below:
  368.  
  369.           FidoNet:    1:249/106
  370.           IMEXnet:    89:487/106
  371.           Internet:   sjd@f106.n249.z1.fidonet.org
  372.           CServe:     >INTERNET:sjd@f106.n249.z1.fidonet.org
  373.           BBS:        (613) 389-8315, 14.4K/HST
  374.  
  375.           Surface mail:
  376.  
  377.           777 Downing St.
  378.           Kingston, Ont.
  379.           Canada  K7M 5N3
  380.  
  381.           The author can also be reached through the EchoMail conferences
  382.           called MUFFIN (Max support) and TUB (Squish support).
  383.  
  384.           Sending correspondence via electronic mail is strongly preferred. 
  385.           However, if you expect to receive a reply via surface mail,
  386.           please enclose a self-addressed, stamped envelope.  Maximus users
  387.           outside of Canada should include an international postal reply
  388.           coupon instead of a stamp.
  389.  
  390.           DO NOT ATTEMPT TO CONTACT THE AUTHOR BY TELEPHONE!  VOICE SUPPORT
  391.           WILL NOT BE PROVIDED FOR NONCOMMERCIAL USERS!
  392.  
  393.           Please feel free to contact the author at any time to share your
  394.           comments about this software and/or licensing policies.
  395.  
  396.           Our thanks to Richard Stallman at the Free Software Foundation,
  397.           Inc. and BBS Co. for most of the wording of this licence.
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.                     Maximus-CBCS v2.00 Operations Manual - Page 5
  406.  
  407.  
  408.  
  409.                                      INTRODUCTION
  410.  
  411.  
  412.           Notes from the Author
  413.  
  414.           Maximus-CBCS v2.00 is the first major upgrade since Maximus 1.0
  415.           was released.  Although 1.02 added several new features and
  416.           functions, it has taken over a year to complete Max 2.0.  When
  417.           writing version 2, major portions of the message and file
  418.           sections were gutted and rewritten.  Both the file and message
  419.           sections now use compiled database for quick access; indeed, one
  420.           of the biggest new features in Max 2.0 is the message system. 
  421.           Max now uses a generic message API (Application Program
  422.           Interface) when dealing with messages.  Under OS/2, this means
  423.           that a new message format can be used by simply replacing the
  424.           MSGAPI.DLL!  Max 2.0 still supports the standard *.MSG format,
  425.           but Max 2.0 also supports the proprietary "Squish" message
  426.           format, selectable on an area-by-area basis.
  427.  
  428.           As promised in the 1.02 documentation, Max 2.0 includes full
  429.           multilingual support, a new message base format, and more.  I
  430.           have some unique ideas planned for the next release; in fact, one
  431.           of the planned features for the next version has been in
  432.           development for the past nine months (in parallel to Max 2.0).  I
  433.           can't release any more information at this point, but I did want
  434.           to say that there are some neat things ahead.
  435.  
  436.           If you are having trouble installing Maximus, in spite of the
  437.           automated installation program, please have a look in the
  438.           troubleshooting section of this manual.  If you still can't get
  439.           Maximus to work correctly, then either post a message in the
  440.           MUFFIN echomail conference, or send NetMail to the Maximus Help
  441.           node at 1:1/119.
  442.  
  443.           Scott Dudley
  444.           October 14th, 1991
  445.  
  446.           For contact information, please see the program licence.
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                     Maximus-CBCS v2.00 Operations Manual - Page 6
  461.  
  462.  
  463.  
  464.  
  465.           Maximus, Money and You
  466.  
  467.           In general, Maximus is a freeware program.  If you are a
  468.           noncommercial user and you abide by the terms given in the
  469.           licence, there is NO CHARGE for running Maximus.  NONCOMMERCIAL
  470.           USERS ARE STILL WELCOME TO RUN MAXIMUS WITHOUT PAYING A CENT.
  471.  
  472.           Unlike other software, this program does not have crippled
  473.           features or "registration incentives".  Maximus does not have any
  474.           "registered only" commands.  There is one simple difference
  475.           between the commercial and noncommercial versions of Maximus: 
  476.           the commercial version entitles you to legally use Maximus in a
  477.           commercial environment.
  478.  
  479.           If you are a COMMERCIAL USER as defined in point 8) of the
  480.           licence above, you must obtain a licence before using Maximus. 
  481.           Please see ORDER.FRM for more information.  If you did not
  482.           receive a copy of the order form with this document, contact the
  483.           author at one of the addresses listed in the licence for more
  484.           information.
  485.  
  486.           If you are a NONCOMMERCIAL user as defined in the licence above,
  487.           you are welcome to use Maximus for free.  However, Maximus is an
  488.           extremely large and complex program, and simply maintaining the
  489.           existing code is consuming a large percentage of my time. 
  490.           Donations of any value (or even just a postcard) will be gladly
  491.           accepted.  However, noncommercial donations are on a VOLUNTARY
  492.           basis and are NOT REQUIRED.
  493.  
  494.           However, BOTH commercial and noncommercial users must abide by
  495.           several restrictions before using Maximus.  The main points in
  496.           the licence are:
  497.  
  498.           *    You may not distribute Maximus on a CD-ROM, WORM, or as any
  499.                other form of a "value added" good in a sales transaction. 
  500.                You may not bundle Maximus with other software without prior
  501.                written permission of the author.
  502.  
  503.           *    You may modify Maximus, but only under the conditions given
  504.                in the licence.
  505.  
  506.           *    You may not incorporate parts of Maximus into another BBS
  507.                package.
  508.  
  509.           *    You may not incorporate parts of Maximus into another
  510.                program which is not completely free for all users.
  511.  
  512.  
  513.  
  514.  
  515.                     Maximus-CBCS v2.00 Operations Manual - Page 7
  516.  
  517.  
  518.  
  519.           Other than the above, there are few restrictions on the use of
  520.           Maximus.  However, because additional restrictions or
  521.           qualifications may apply to you, the licence agreement should
  522.           still be read carefully.
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.                     Maximus-CBCS v2.00 Operations Manual - Page 8
  571.  
  572.  
  573.  
  574.  
  575.           Credits
  576.  
  577.           Even though Maximus is almost all original code, several other
  578.           people contributed a great deal to the project and deserve to be
  579.           acknowledged.
  580.  
  581.           First and foremost, my thanks go to Wynn Wagner III.  Without
  582.           Wynn, there would be no Opus; without Opus, there would be no
  583.           Maximus, or at least not in the format that it is today.  Maximus
  584.           does not use any of Wynn's code, but he did provide the program
  585.           after which Maximus was originally modeled.  Wynn also wrote a
  586.           large number of utilities and established the WaZOO handshaking
  587.           standard.
  588.  
  589.           Secondly, my thanks go to Peter Fitzsimmons, for all of his help
  590.           and code.  Peter is the head of the Max-OS/2 development team,
  591.           but he has also contributed a good deal of code to the DOS
  592.           version.  Comments can be sent to him at 1:250/628.
  593.  
  594.           As well, I should also thank Bob Hartman, Vince Perriello and
  595.           Alan Applegate.  These three people created the BinkleyTerm front
  596.           end, and they also contributed all of Max's file transfer
  597.           protocols.
  598.  
  599.           I would also be remiss if I failed to thank all of my alpha and
  600.           beta testers.  Although the list is too long to include here, my
  601.           sincere gratitude goes out to all of them, not only for their
  602.           help in tracking down the many bugs which were visible in earlier
  603.           Maximus releases, but also for their helpful suggestions and
  604.           comments.  My thanks also go to the rest of the documentation
  605.           team, as listed on the front page of each manual.
  606.  
  607.           Thanks go to the following people who have contributed to the
  608.           Maximus source, by donating algorithms, structures, ideas, or
  609.           even code.  (My sincere apologies if someone has been left out.)
  610.  
  611.           Peter Fitzsimmons
  612.           Vince Perriello and Bob Hartman
  613.           Andrew Farmer
  614.           Scott Friedman
  615.           Ray Duncan
  616.           Thomas Plum
  617.           Alan Hughes
  618.           Anders Brink
  619.           Jim Lin
  620.           Gordon Benedict
  621.  
  622.  
  623.  
  624.  
  625.                     Maximus-CBCS v2.00 Operations Manual - Page 9
  626.  
  627.  
  628.  
  629.           Finally, I wish to acknowledge several products and trademarks
  630.           which have been mentioned in this document.  Use of these names
  631.           and trademarks neither constitutes an endorsement nor suggests
  632.           any affiliation with the specified products.
  633.  
  634.           ARC, SEAlink & SEAdog:        Thom Henderson
  635.           BinkleyTerm:                  Bob Hartman & Vince Perriello
  636.           BNUcomm:                      David Nugent, Unique Computing
  637.           Courier HST:                  U.S. Robotics Inc.
  638.           DESQview:                     Quarterdeck Office Systems
  639.           DoubleDOS:                    SoftLogic Solutions Inc.
  640.           FEND:                         David Luong
  641.           Fido & FidoNet:               Tom Jennings, Fido Software
  642.           FrontDoor & FDterm:           Joaquim Homrighausen
  643.           FView:                        Doug Boone
  644.           IBM-PC, PC-DOS, OS/2:         International Business Machines
  645.           Lharc and LZH:                Haruyasu Yoshizaki
  646.           Minimus:                      John Cuccia
  647.           MS-DOS:                       Microsoft Inc.
  648.           Opus-CBCS:                    Wynn Wagner III
  649.           OpusComm & ConfMail:          Bob Hartman, Spark Software
  650.           PCBoard:                      Clark Software Development Corp.
  651.           QuickBBS:                     Pegasus Software, Inc.
  652.           QM, QMail & AreaFix:          Greg Dawson & George Peace
  653.           RBBS:                         Capital PC Users Group
  654.           TBBS:                         eSoft, Inc.
  655.           Telix:                        Colin Sampaleanu, Exis Inc.
  656.           TheDraw:                      Ian Davis, TheSoft Services
  657.           TinyTerm, OECC:               George A. Stanislav
  658.           Turbo C:                      Borland International
  659.           V-Series and Hayes:           Hayes Microcomputer Products
  660.           VT-100:                       Digital Equipment Corporation
  661.           X00:                          Ray Gwinn, RENEX Co.
  662.           Xmodem:                       Ward Christiensen
  663.           ZIP:                          Phil Katz, PKWare
  664.           Zmodem and MobyTurbo:         Chuck Forsberg
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.                     Maximus-CBCS v2.00 Operations Manual - Page 10
  681.  
  682.  
  683.  
  684.  
  685.           It's Canadian, eh?
  686.  
  687.           Maximus is a Canadian product.  As such, proper English spellings
  688.           are used in most places.  Carbon-based life forms living in the
  689.           United States of America should make the following mental
  690.           translations:
  691.  
  692.           Proper spelling    American spelling
  693.  
  694.           Colour             Color
  695.           Favoured           Favored
  696.           Licence            License
  697.           Neighbour          Neighbor
  698.  
  699.           For your viewing pleasure, an alternate language file called
  700.           AMERICAN.MAD is included in the Maximus distribution package. 
  701.           This language file is an "Americanized" version of the standard
  702.           English file, including many of the above changes.
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                     Maximus-CBCS v2.00 Operations Manual - Page 11
  736.  
  737.  
  738.  
  739.                                  SYSTEM REQUIREMENTS
  740.  
  741.           Although it is possible to run Maximus on a system with less than
  742.           the following equipment, the following should be considered the
  743.           realistic minimum with which you can get by:
  744.  
  745.           *    An IBM (or compatible) personal computer running MS-DOS or
  746.                PC-DOS, with at least 256K of available RAM, with at least
  747.                164K free.
  748.  
  749.           *    MS-DOS or PC-DOS version 2.0 or greater, 3.2 or above
  750.                preferred.
  751.  
  752.           *    A Hayes-compatible modem.  It is possible to use Maximus
  753.                with a modem which is not Hayes-compatible.  However, doing
  754.                so will make your life unnecessarily complicated.
  755.  
  756.           *    A hard disk.  Capacity of 30 megabytes or greater is
  757.                preferable.
  758.  
  759.           *    A FOSSIL communications driver, revision level 5 or higher. 
  760.                (Common FOSSILs are X00, BNU and OpusComm.)
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.                     Maximus-CBCS v2.00 Operations Manual - Page 12
  791.  
  792.  
  793.  
  794.                                    MAXIMUS OVERVIEW
  795.  
  796.           This section of the documentation is designed to give you, the
  797.           SysOp, a general overview of what Maximus can do.  By any means,
  798.           this is not complete, but it should give you a general idea of
  799.           how the system operates.
  800.  
  801.  
  802.           Logging On
  803.  
  804.           When Maximus starts up with a caller on-line, the Maximus name
  805.           and version will be displayed, followed by the SysOp-created log-
  806.           on screen (usually \MAX\MISC\LOGO.BBS).  This screen should be
  807.           kept under 2K in length, and it should not use ANSI graphics and
  808.           high-bit IBM characters.
  809.  
  810.           After the logo screen has been displayed, Maximus will then
  811.           prompt the user to enter a name.  Unlike other BBS programs,
  812.           Maximus allows a user to use names with more than two words, so
  813.           even a name such as "Jesse David Hollington" will be accepted. 
  814.           (On the other hand, Maximus will reject callers with a one-word
  815.           name, unless you have the `Alias System' keyword uncommented in
  816.           MAX.CTL.)
  817.  
  818.           However, if the user does NOT exist in the user file, Maximus
  819.           will display the NOTFOUND.BBS file.  This serves to confirm that
  820.           the user really wanted to enter the name which was entered at the
  821.           prompt.  In addition, Maximus will disable key stacking, just in
  822.           case the user entered a name in the format of `Joe SysOp Y
  823.           Password', and misspelled the name `Joe SysOp'.  With other BBS
  824.           software, this would result in a new user account being created
  825.           under the wrong name.
  826.  
  827.           If the name was not in the user file, Maximus will go through the
  828.           new user routine.  First, Maximus will display APPLIC.BBS; this
  829.           normally gives the caller some information about your system, and
  830.           it may also present an application form to be filled out.  (If a
  831.           caller hangs up before APPLIC.BBS has completed displaying, then
  832.           the user's configuration will NOT be saved, and no entry will be
  833.           made in USER.BBS.)
  834.  
  835.           When APPLIC.BBS ends, Maximus will then prompt the user to enter
  836.           his/her city, alias (if applicable), phone number, and so on. 
  837.           Finally, Maximus will display NEWUSER2.BBS, which can be yet
  838.           another screen directed toward educating new users.
  839.  
  840.           On the other hand, if the user's name was found in the user file,
  841.           then Maximus will ask that user to enter his/her password.  The
  842.           user will get five tries to enter the correct password; if all
  843.  
  844.  
  845.                     Maximus-CBCS v2.00 Operations Manual - Page 13
  846.  
  847.  
  848.  
  849.           five tries fail, or if the user pressed <enter> five times,
  850.           Maximus will hang up and recycle.  However, Max will display the
  851.           file \MAX\MISC\BAD_PWD.BBS before doing so, which means that you
  852.           can prompt the user to enter a message of explanation before
  853.           hanging up.
  854.  
  855.           If the user enters the correct password, Maximus will proceed
  856.           with the log-on sequence, and display WELCOME.BBS to the user. 
  857.           Note!  If a user's account has a BLANK password, then Maximus
  858.           will treat that user as a `guest account'.  This means that
  859.           Maximus will ask a user who is using this account for his/her
  860.           configuration settings at every log-on, and Maximus will also
  861.           skip the password prompt.  This allows the SysOp to create an
  862.           account specifically for new users (while using a `Logon Level
  863.           Preregistered' statement), such that users can look around the
  864.           system, but the user file won't get cluttered with users who
  865.           choose not to register.  (User registration would presumably be
  866.           done through an on-line questionnaire.)
  867.  
  868.           Maximus also supports a concept known as a `custom welcome
  869.           screen'.  A special welcome screen can be created to display to
  870.           each individual user, BEFORE displaying the main WELCOME.BBS.  By
  871.           placing a file called `#.BBS' in the Maximus system directory,
  872.           where `#' is a user number, Maximus will display that .BBS file
  873.           to the caller with that user number.  (You can find out a user's
  874.           user number by looking in the log file, or also by doing a find
  875.           in the user editor.)  For example, if you wanted to show a custom
  876.           welcome to user #5, then you might create a file called
  877.           `\MAX\5.BBS'.
  878.  
  879.           As an added security feature, you can also disable remote sysop
  880.           logons.  If you place a "[isremote sequal hangup]" at the top of
  881.           your WELCOME.MEC, Max will automatically hang up on remote
  882.           callers with a priv level of SysOp.  If you never call your
  883.           system from remote, using this option can help prevent accidents.
  884.  
  885.           If the user has ANSI or AVATAR graphics support, the user can use
  886.           the cursor keys to edit any of the text on the command line. 
  887.           Editing can be performed through the <left>, <right>, <bs>,
  888.           <del>, <ctrl-left>, and <ctrl-right> keys.  To use this feature,
  889.           the caller's terminal must support either "Doorway mode" or VT-
  890.           100 keyboard codes.
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.                     Maximus-CBCS v2.00 Operations Manual - Page 14
  901.  
  902.  
  903.  
  904.           The Main Menu
  905.  
  906.           Although Max's menus are completely redefinable, this section
  907.           attempts to explain the commands which would normally be found on
  908.           the main menu.  This is also where the commands appear in the
  909.           default configuration.
  910.  
  911.           Message Section
  912.  
  913.                This enters the message section.  From here all the message
  914.                entering and reading features are available.  See the
  915.                section on the message areas for more detail.
  916.  
  917.           File Section
  918.  
  919.                This takes the user to the Files Section.  From here a user
  920.                can exchange files by uploading or downloading, or simply
  921.                see what files are available.  See the section on the file
  922.                areas for more detail.
  923.  
  924.           Change Setup
  925.  
  926.                This takes the user to the Change Setup menu.  From here, a
  927.                user can modify his/her user profile.  The user can set the
  928.                screen length, change the graphics mode, password, toggle
  929.                the full-screen editor, and more.  See the section on the
  930.                Change Setup menu for more details.
  931.  
  932.           Goodbye
  933.  
  934.                This option logs the user off the system and hangs up the
  935.                phone.  This is almost identical to what happens if a user
  936.                simply drops carrier.  Maximus will not `hang' if a user
  937.                drops carrier, but will recycle as if they logged off using
  938.                this command.  This command simply asks the user to confirm
  939.                that they want to disconnect, asks if he/she wants to leave
  940.                a message to the sysop, and then hangs up on the user.  By
  941.                default, comments are placed in message area 1, although
  942.                this is selectable in MAX.CTL.
  943.  
  944.           Comments to the sysop are saved in the "Comment Area", as defined
  945.           in MAX.CTL.  (By default, comments are stored in area 1.)  If
  946.           message area 1 does not exist, or if you use a "Comment Area"
  947.           statement with no area listed, users will not be asked if they
  948.           want to leave you comments.
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.                     Maximus-CBCS v2.00 Operations Manual - Page 15
  956.  
  957.  
  958.  
  959.           Statistics
  960.  
  961.                This option displays the user's statistics, including the
  962.                time the user has been online for the current call, the time
  963.                online for the day, amount uploaded, amount downloaded,
  964.                NetMail credit, and so on.
  965.  
  966.           Yell
  967.  
  968.                This command allows the user to attempt to contact the SysOp
  969.                while he/she is on-line.  You can set when you want users to
  970.                be able to page you with this command, and you can toggle
  971.                the local speaker noise with the local "!" command.
  972.  
  973.           Userlist
  974.  
  975.                This command simply displays a list of all the users who are
  976.                currently in the user file.  You can set the maximum and
  977.                minimum privilege levels to display in the list through
  978.                options in the control file.  By default, will not display
  979.                users with a privilege of SysOp, Hidden or Twit.  These
  980.                privilege levels are also selectable in the control file.
  981.  
  982.           Version
  983.  
  984.                This displays the version number and a few other statistics
  985.                about the current revision of Maximus and the version of the
  986.                operating system currently in use.
  987.  
  988.           SysOp Menu
  989.  
  990.                This command takes you to the Maximus SysOp menu.  See below
  991.                for more details.
  992.  
  993.           Chat Menu
  994.  
  995.                If enabled, this menu can be used to access all of Max's
  996.                multi-node chat features, including paging, toggling chat
  997.                availability, and the chat itself.  This feature allows
  998.                callers to talk with one or more other callers.  Chatting
  999.                with the SysOp is performed through the Yell command.
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.                     Maximus-CBCS v2.00 Operations Manual - Page 16
  1011.  
  1012.  
  1013.  
  1014.           Who is On?
  1015.  
  1016.                If the multi-node chat system is enabled, this command can
  1017.                be used to display a list of callers who are currently
  1018.                logged onto other nodes of the same system.  This command
  1019.                will display the user name, the node number, and that user's
  1020.                status.  The status message indicates the current activities
  1021.                of the user, such as "Downloading a file", "Entering a
  1022.                message", and so on.
  1023.  
  1024.           In addition, you can define other options in the main menu to
  1025.           call sub-menus, display text files, or run external programs. 
  1026.           See the control-file reference section for more details on
  1027.           defining menus.
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.                     Maximus-CBCS v2.00 Operations Manual - Page 17
  1066.  
  1067.  
  1068.  
  1069.  
  1070.           The Message Section
  1071.  
  1072.           There are four basic types of message areas within Maximus. 
  1073.           These area types are Local, NetMail, EchoMail and conference
  1074.           mail.
  1075.  
  1076.           Local messages are messages entered by a user on your BBS.  They
  1077.           can be either public or private, and they remain on your BBS. 
  1078.           Other users can only read these messages by logging onto your BBS
  1079.           and selecting that particular message area.°
  1080.  
  1081.           NetMail messages are messages that are sent from one BBS to
  1082.           another through a network that you are connected to.  They are
  1083.           generally private messages.
  1084.  
  1085.           Unless you are a host or hub, most NetMail messages you encounter
  1086.           will either be entered on your system, or will be sent to your
  1087.           system from another.  Maximus is fully compatible with the
  1088.           FidoNet mail standard for these messages.  A user entering a
  1089.           NetMail message will be prompted to enter additional information
  1090.           to tell your mail processor where to send the message.  Maximus
  1091.           is capable of reading a FidoNet compatible Version 5 or Version 6
  1092.           nodelist file in order to get its address and cost information. 
  1093.           Generally your users will need to have credit in their user
  1094.           accounts in order to send NetMail.  Under most circumstances you
  1095.           should only have one of these areas.
  1096.  
  1097.           EchoMail messages are messages that are shared between several
  1098.           bulletin board systems over a wide area.  An EchoMail message
  1099.           will be sent through your network to all other systems
  1100.           participating in that same conference.  Generally, EchoMail areas
  1101.           only permit public message.  To a Maximus user, an echo area
  1102.           appears identical to a local message area, except that messages
  1103.           entered in EchoMail areas will have special control information
  1104.           added to the end, such as origin and tear lines.  In addition,
  1105.           when a user enters a message in an EchoMail area, Maximus will
  1106.           add that area's tag to your echo tosslog.
  1107.  
  1108.           Maximus also supports a variety of message area toggles (or
  1109.           "attributes"), each of which can be set independently.  Although
  1110.           a complete list can be found in the MSGAREA.CTL reference in the
  1111.           Maximus Technical Reference Manual, some of the more common
  1112.           attributes are:
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.                     Maximus-CBCS v2.00 Operations Manual - Page 18
  1121.  
  1122.  
  1123.  
  1124.           Private Only
  1125.  
  1126.                All messages entered in these areas will be marked private,
  1127.                and can only be read by the user who sent the message, the
  1128.                user it is addressed to, and the sysop.
  1129.  
  1130.           Public Only
  1131.  
  1132.                All messages entered in these areas will be public and can
  1133.                be read by any user.  This flag is recommended for EchoMail
  1134.                areas.
  1135.  
  1136.           Read-Only
  1137.  
  1138.                Messages in these areas can be read by users, but only users
  1139.                with a privilege level of assistant sysop or higher can
  1140.                enter messages.
  1141.  
  1142.           Anonymous OK
  1143.  
  1144.                In an area has this attribute set, users can optionally
  1145.                enter messages under a pseudonym instead of that user's real
  1146.                name.  Maximus will embed the user's real name within the
  1147.                message in such a way that only the SysOp can see it.  If
  1148.                this causes some sort of security or anonymity problem, this
  1149.                embedding of the user's real name can be disabled.  Please
  1150.                refer to the MSGAREA.CTL reference (in the Maximus Technical
  1151.                Reference Manual) for more details.
  1152.  
  1153.           Maximus is also capable of assigning passwords to message and
  1154.           file areas, and re-assigning privileges within the area for
  1155.           certain passwords.  In addition, you can assign user names to the
  1156.           barricade file, so only certain users can enter an area.  See the
  1157.           section on extended barricades in MAX_REF.PRN for more details.
  1158.  
  1159.           In addition, the private and public message-area attributes can
  1160.           be defined individually by privilege level, rather than globally
  1161.           for all callers.  (In other words, you can allow the SysOp to
  1162.           enter anonymous messages, while still forcing normal users to use
  1163.           their real names.) See the control-file reference for more
  1164.           information on how to assign these attributes to areas.
  1165.  
  1166.  
  1167.           The Message Menu
  1168.  
  1169.           The following attempts to explain the options that would normally
  1170.           be used in a message area menu:
  1171.  
  1172.  
  1173.  
  1174.  
  1175.                     Maximus-CBCS v2.00 Operations Manual - Page 19
  1176.  
  1177.  
  1178.  
  1179.           Area Change
  1180.  
  1181.                This command allows the user to change to another message
  1182.                area.  The user will be prompted to enter the message area
  1183.                they want to go to, or to enter a "?" for a list of the
  1184.                areas that are available to them.  The user can also enter
  1185.                the "<" or ">" characters to go to the previous or next area
  1186.                in the list, respectively.  If entering a barricaded area
  1187.                where a password is required, he/she will be prompted for
  1188.                the password before they are allowed to enter the area.
  1189.  
  1190.           Next
  1191.  
  1192.                This command will display the next message in the current
  1193.                area.  To keep reading messages in this direction, the user
  1194.                can press the ENTER key at the next prompt.  The ENTER key
  1195.                will repeat the last N)ext or P)revious command.
  1196.  
  1197.           Previous
  1198.  
  1199.                This command will display the previous message in the
  1200.                current area.  To keep reading messages in this direction,
  1201.                the user can press the ENTER key at the next prompt.  The
  1202.                ENTER key will repeat the last N)ext or P)revious command.
  1203.  
  1204.           Enter a Message
  1205.  
  1206.                This command will allow the user to enter a message.  After
  1207.                the user selects this command, Maximus will prompt them for
  1208.                some information is needs to know to send the message, such
  1209.                as who the message is to, the subject of the message, and
  1210.                whether the message is public or private, and any other
  1211.                information allowed by the configuration of the current
  1212.                area.
  1213.  
  1214.                If the area does not allow public messages, or does not
  1215.                allow private messages, the user will not be able to select
  1216.                whether they want the message to be public or private.
  1217.  
  1218.                If the area allows anonymous messages, the user will be able
  1219.                to change who the message is from as well.  If the message
  1220.                area is a NetMail area, the user will be prompted for a
  1221.                network address to send the message to.  When entering the
  1222.                address, the user can either enter the address, or use the
  1223.                following keys to get listings:
  1224.  
  1225.                     #    This will display a list of all the nodes in the
  1226.                          current net.
  1227.  
  1228.  
  1229.  
  1230.                     Maximus-CBCS v2.00 Operations Manual - Page 20
  1231.  
  1232.  
  1233.  
  1234.                     /    This will display a list of all the nets in the
  1235.                          nodelist.
  1236.  
  1237.                If you only enter a node number, Maximus will automatically
  1238.                default to your current net.
  1239.  
  1240.                A special shortcut exists for addressing points off the
  1241.                current system.  Suppose that you are currently entering a
  1242.                message on 1:106/114.  If you wish to write a message to
  1243.                John Doe at 1:106/114.22, simply enter `.22' at the
  1244.                destination prompt.  Maximus will automatically expand this
  1245.                address to the full `1:106/114.22'.
  1246.  
  1247.                After entering this information, the user will be placed in
  1248.                the message editor to enter the message.  For more details,
  1249.                refer to the section on message editors.
  1250.  
  1251.                Finally, if your nodelist processor can create a
  1252.                FIDOUSER.LST, Maximus is capable of finding a network
  1253.                address based on a user's name.  If you enable the "FidoUser
  1254.                D:\Path\Fidouser.Lst" statement in MAX.CTL, Max will search
  1255.                the nodelist for a particular SysOp name.  If that name was
  1256.                found, Max will automatically enter that SysOp's netmail
  1257.                address for you.
  1258.  
  1259.           Change a Message
  1260.  
  1261.                The Change command allows users to modify an existing
  1262.                message.  Before allowing a user to change a message, Max
  1263.                will check to make sure that the user actually WROTE that
  1264.                message.  Max will also check to see if the message has been
  1265.                scanned out or read by the recipient.  If either of these
  1266.                conditions is true, Max will display a message to that
  1267.                effect and abort the change.  (However, this acts only as a
  1268.                warning to callers with a priv level of SysOp; Max will
  1269.                always let the SysOp modify a message, whether or not the
  1270.                message has been read or scanned out.)
  1271.  
  1272.                Both the message header and the message body can be
  1273.                modified.  When graphics are turned on, the message status
  1274.                bits in the NetMail area (such as crash, hold, and so forth)
  1275.                can also be modified.
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.                     Maximus-CBCS v2.00 Operations Manual - Page 21
  1286.  
  1287.  
  1288.  
  1289.           Reply to Message
  1290.  
  1291.                This command allows the user to send a response to the
  1292.                author of the current message.  The reply command is similar
  1293.                to the enter command, except that some of the message fields
  1294.                will be filled in (the name of the author of the message to
  1295.                which you are replying will automatically be inserted in the
  1296.                To: field).  Also, once in the editor, the user will be able
  1297.                to QUOTE the message they are replying to.  See the section
  1298.                on the message editor for details.  "RK" [R)eply/K)ill] will
  1299.                kill the original message after the reply is finished.
  1300.  
  1301.           Read Non-Stop
  1302.  
  1303.                This command will allow a user to read all of the messages
  1304.                in the current area, starting with the current message,
  1305.                without pausing between each message.  This is useful if
  1306.                users want to capture the messages to a disk file for later
  1307.                perusal.
  1308.  
  1309.           Read Original
  1310.  
  1311.                This command will allow the user to display the original
  1312.                message to which the message they are reading is a reply. 
  1313.                Messages that are replies to another will have a "*** This
  1314.                is a reply to #xx" tag at the bottom of the message.
  1315.  
  1316.           Read Reply
  1317.  
  1318.                This command will allow the user to display any messages
  1319.                that are replies to the message they are reading.  Messages
  1320.                that have replies to them will have a "***See also #xx" tag
  1321.                at the bottom of them.
  1322.  
  1323.           Read Current
  1324.  
  1325.                This command will allow the user to redisplay the current
  1326.                message number.  This command is useful when first entering
  1327.                an area (to re-read the message you read in your last
  1328.                session), and also when trying to redisplay a message which
  1329.                scrolled off the screen.
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.                     Maximus-CBCS v2.00 Operations Manual - Page 22
  1341.  
  1342.  
  1343.  
  1344.           Browse
  1345.  
  1346.                Browse is an extremely powerful command; it replaces the
  1347.                functionality of Max 1.02's Scan, Inquire, List, and
  1348.                mailchecker commands.  Browse acts as a powerful database
  1349.                engine for the message bases.  Users can select a set of
  1350.                messages and operations to perform, and have Maximus
  1351.                automatically identify and display the messages which were
  1352.                requested.  Browse is broken down into 3-4 separate menus.
  1353.  
  1354.                The first menu allows the user to select a set of areas to
  1355.                query.  The user can select either the current area, the set
  1356.                of areas selected with the T)ag command, or all message
  1357.                area.
  1358.  
  1359.                The second menu allows the user to specify a set of messages
  1360.                to select.  The user can specify ALL MESSAGES (each message
  1361.                in every area specified), NEW MESSAGES (messages above the
  1362.                lastread pointer in each area), YOUR MESSAGES (messages
  1363.                above the lastread pointer and addressed to the current
  1364.                user), and FROM A MESSAGE NUMBER (such as from message #200
  1365.                and up).  Maximus also allows the user to perform a search
  1366.                based on keywords in the to, from and subject fields, in
  1367.                addition to the message body.  Complex searches can be
  1368.                defined using the logical OR and the logical AND operators.
  1369.  
  1370.                The third menu selects an operation to perform on the
  1371.                specified messages.  Selected messages can be listed (one to
  1372.                a line, to/from/subject only), read (displayed in full, with
  1373.                the option to reply or kill), or packed into a QWK bundle
  1374.                for off-line reading.
  1375.  
  1376.           Tag
  1377.  
  1378.                The tag command allows each user to select a subset of
  1379.                message areas available on the system.  Each individual user
  1380.                can select his or her own set of message areas to be stored
  1381.                across calls.  This set of areas can be used with the Browse
  1382.                command, or also with the Download command on the off-line
  1383.                reader menu.
  1384.  
  1385.           Edit User
  1386.  
  1387.                This function invokes the user editor from the message menu;
  1388.                however, it also reads in the current message, checks the
  1389.                'From:' field, and automatically positions the user editor
  1390.                on that user's user record.  This may be useful for
  1391.                validating users, since you can pull up a user's record at
  1392.                the press of a key.  (This command is for SysOps only.)
  1393.  
  1394.  
  1395.                     Maximus-CBCS v2.00 Operations Manual - Page 23
  1396.  
  1397.  
  1398.  
  1399.           Goodbye
  1400.  
  1401.                This is identical to the G)oodbye command at the main menu. 
  1402.                It will log off the user.
  1403.  
  1404.           Main Menu
  1405.  
  1406.                This will return the user to the main menu.
  1407.  
  1408.           Kill a Message
  1409.  
  1410.                This command allows a user to delete a message in the
  1411.                current area.  Unless a user has SysOp privileges, a user
  1412.                will only be able to kill messages which are addressed TO or
  1413.                FROM that individual.
  1414.  
  1415.           Upload a Message
  1416.  
  1417.                This command allows a user to directly upload a text file as
  1418.                a message to the current area.  This is identical to the
  1419.                E)nter message command, except instead of invoking the
  1420.                editor, Maximus will start a file upload.  The user may then
  1421.                upload a pre-typed ASCII text file which will be stored as a
  1422.                message.  Any file transfer protocol may be used for
  1423.                uploading the message text.  The maximum length of an
  1424.                uploaded message is 8K.
  1425.  
  1426.           Forward
  1427.  
  1428.                This command allows a user to make a copy of a message in
  1429.                the current area, and send it to someone else.  The user
  1430.                enters the message number to forward, and the name of the
  1431.                person to forward it to.  The user can also forward the
  1432.                message directly into another area by typing the area number
  1433.                when prompted.  The F)orward command supports two special
  1434.                modifiers, as follows:
  1435.  
  1436.                "FK" [F)oward K)ill] will delete the original message after
  1437.                forwarding it.
  1438.  
  1439.                "FB" [F)orward B)ombrun] will allow a user to specify a
  1440.                filename containing a list of users to forward the message
  1441.                to.  In order for a user to use this command,their privilege
  1442.                level must be equal to the privilege level required to
  1443.                create a message from a file as defined in the Maximus
  1444.                control file.  (See the control file reference in
  1445.                MAX_REF.PRN for more information.)  The format of the
  1446.                bombing run file is as follows:
  1447.  
  1448.  
  1449.  
  1450.                     Maximus-CBCS v2.00 Operations Manual - Page 24
  1451.  
  1452.  
  1453.  
  1454.                <username> <dest_net/dest_node> [-x]
  1455.  
  1456.                -x can be one of the following switches:
  1457.  
  1458.                     -h   Message should be marked as HOLD FOR PICKUP
  1459.                     -c   Message should be marked as CRASH
  1460.                     -n   Message should be marked as NORMAL (default)
  1461.  
  1462.                The bombing file can contain any number of lines.
  1463.  
  1464.                The <dest_net/dest_node> and [-x] fields are only used for
  1465.                NetMail messages, and should be omitted for local bombing
  1466.                runs.
  1467.  
  1468.                In the username field, spaces in a user's name must be
  1469.                represented by underscores.
  1470.  
  1471.                For example:
  1472.  
  1473.                SysOp                        225/337
  1474.                Scott_Dudley                 249/106      -c
  1475.                Hubert_Lai                   249/102      -h
  1476.                Vince_Perriello              141/191      -n
  1477.                Jesse_David_Hollington       225/1        -c
  1478.  
  1479.                This would send carbon copies of a message to the five
  1480.                people names, sending the messages to SysOp and Vince
  1481.                Perriello as NORMAL messages, and the messages to 249/106
  1482.                and 225/1 as CRASH messages.
  1483.  
  1484.                Note!  If you are performing a NetMail bombing run, make
  1485.                sure NOT to route your messages through anyone else. 
  1486.                Routing bombing-run messages is against FidoNet policy.
  1487.  
  1488.           Hurl
  1489.  
  1490.                This command is used to move messages from one area to
  1491.                another.  It will ask the user which message to hurl and
  1492.                which area to hurl it to.
  1493.  
  1494.                In addition, you can define other options in the message
  1495.                menu to call auxiliary menus, display text files, or run
  1496.                external programs.  See the control-file reference for more
  1497.                details on defining menus.
  1498.  
  1499.           Xport
  1500.  
  1501.                The Xport command, normally available only to SysOps, can be
  1502.                used to export a particular message to a specified filename. 
  1503.  
  1504.  
  1505.                     Maximus-CBCS v2.00 Operations Manual - Page 25
  1506.  
  1507.  
  1508.  
  1509.                This message will be formatted for 80 columns, and the file
  1510.                will also include the message header.  TO PRINT A MESSAGE ON
  1511.                THE PRINTER, specify an Xport filename of "prn".
  1512.  
  1513.           Message Entry
  1514.  
  1515.           For ANSI and AVATAR callers, Maximus supports a sophisticated
  1516.           message entry screen.  After selecting one of the options which
  1517.           begins the message entry process (such as E)nter, R)eply, or
  1518.           U)pload), Maximus will then display a "template" for the user to
  1519.           fill in.  The template indicates whether or not the message is
  1520.           private or public, the name of the recipient, the recipient's
  1521.           matrix address (if in a netmail area), the subject of the
  1522.           message, and optionally, an "alias" or alternate name for the
  1523.           sender.
  1524.  
  1525.           The user can move back and forth through the various items if
  1526.           they have an ANSI/VT-100 or IBM-compatible terminal emulator, and
  1527.           if not, users can also use the WordStar-like Control-E and
  1528.           Control-X keys to move up and down the fields (respectively). 
  1529.           Control-Y will delete the contents of the current field, and
  1530.           pressing <escape> TWICE will abort the message.  Assuming that
  1531.           all of the fields in the template have been filled, Maximus will
  1532.           invoke the message editor when the user presses <enter> on the
  1533.           last field in the header.
  1534.  
  1535.           Maximus also supports a carbon copy feature.  To utilize this,
  1536.           simply include your carbon copy list at the top of the message
  1537.           body in this form:
  1538.  
  1539.                cc: name1, name2, name3, etc.
  1540.  
  1541.           or this form:
  1542.  
  1543.                cc: name1
  1544.                cc: name2
  1545.                cc: name3
  1546.                cc: etc.
  1547.  
  1548.           If you are in the Matrix area, you may optionally specify a
  1549.           matrix address after each name.  However, Maximus will also look
  1550.           up the SysOp name in your FIDOUSER.LST and NAMES.MAX files; if a
  1551.           match can be found, the message will be automatically addressed
  1552.           to the right node.
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.                     Maximus-CBCS v2.00 Operations Manual - Page 26
  1561.  
  1562.  
  1563.  
  1564.           Message Editors
  1565.  
  1566.           Maximus supports two types of message editors:, MaxEd, the full
  1567.           screen editor, and BORED, the line-oriented editor.  Maximus also
  1568.           supports an external editor for local use, but that is covered in
  1569.           the control file documentation.
  1570.  
  1571.  
  1572.           MaxEd
  1573.  
  1574.           MaxEd is the Maximus full screen editor.  This can only be used
  1575.           by users who are capable of receiving ANSI or AVATAR graphics,
  1576.           and have a screen width of 80 columns and a length of at least 23
  1577.           rows.  The full screen editor has a number of advantages over the
  1578.           line editor, the most obvious being that it is far easier to use. 
  1579.           MaxEd is more like a word processor than a BBS editor; you can
  1580.           use the cursor keys to move around, insert and delete text in the
  1581.           middle of paragraphs, and so on.
  1582.  
  1583.           MaxEd uses a mixture of WordStar, generic VT-100 and IBM-PC
  1584.           commands, a list of which can be obtained by typing ^n
  1585.           (Control-N) from within the editor.  (The help file is contained
  1586.           in \MAX\HLP\FSED.MEC.)
  1587.  
  1588.           Also, if the message you are editing is a reply to another, then
  1589.           you can quote text from the original message, and place it inside
  1590.           your own, which greatly increases readability.  You can look at
  1591.           four lines at a time through a "quote window", and optionally
  1592.           copy those lines into the message you are writing.  You can also
  1593.           page through the original message in either direction, forward or
  1594.           backwards.
  1595.  
  1596.           MaxEd also has a special menu, which is accessible via either ^kH
  1597.           (Control-K and then 'H'). or the <F10> key The options available
  1598.           on the MaxEd menu are similar to those found on the BORED menu,
  1599.           and includes the following:
  1600.  
  1601.           Continue
  1602.  
  1603.                This will return to MaxEd and allow the user to continue
  1604.                entering the message.
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.                     Maximus-CBCS v2.00 Operations Manual - Page 27
  1616.  
  1617.  
  1618.  
  1619.           To
  1620.  
  1621.                This allows the user to change the addressee of the message.
  1622.  
  1623.           Subject
  1624.  
  1625.                This allows the user to change the subject of the message.
  1626.  
  1627.           From
  1628.  
  1629.                This will allow the user to change who the message is from. 
  1630.                The privilege level of this command should be set rather
  1631.                high, as this command can be used from any area, whether
  1632.                it's anonymous or not.
  1633.  
  1634.           Handling
  1635.  
  1636.                This is another command for which the privilege level should
  1637.                be set high.  It will allow the user to change the flags on
  1638.                the message.  Flags such as Private or Public can be
  1639.                changed, in addition to NetMail-type flags such as Crash,
  1640.                Hold or File Attach.
  1641.  
  1642.           Read File
  1643.  
  1644.                This will allow the user to enter a path to a file on your
  1645.                hard disk and read it in as a message.  The privilege level
  1646.                of this command should be set fairly high.
  1647.  
  1648.  
  1649.           BORED
  1650.  
  1651.           BORED is the Maximus line-editor.  BORED can be used by anybody,
  1652.           regardless of whether they have graphics or not.  Most users who
  1653.           have graphics will most likely prefer to use MaxEd.
  1654.  
  1655.           BORED allows the user to enter a message, one line at a time. 
  1656.           When the user is finished entering the message, they are
  1657.           presented with the editor menu.  The commands available on the
  1658.           editor menu are as follows:
  1659.  
  1660.           Save
  1661.  
  1662.                This will save the message the user has just entered.
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.                     Maximus-CBCS v2.00 Operations Manual - Page 28
  1671.  
  1672.  
  1673.  
  1674.           Abort
  1675.  
  1676.                This aborts the message without saving it.
  1677.  
  1678.           List
  1679.  
  1680.                Lists the message, preceding each line of the message with
  1681.                it's line number.
  1682.  
  1683.           Edit
  1684.  
  1685.                This command edits a line in the message, to correct any
  1686.                mistakes.  Firstly, the user must select the line number
  1687.                that they wish to edit, then enter the text that they wish
  1688.                to replace, followed by the text you wish to replace it
  1689.                with.  To insert at the beginning of the line, just press
  1690.                <Enter> for the "Text to replace" prompt.
  1691.  
  1692.           Insert
  1693.  
  1694.                This command will insert a blank line in the message
  1695.                preceding a specified line number.
  1696.  
  1697.           Delete
  1698.  
  1699.                This command will delete a specified line of the message.
  1700.  
  1701.           Continue
  1702.  
  1703.                Allows the user to continue entering their message, by
  1704.                appending to the end.
  1705.  
  1706.           Quote
  1707.  
  1708.                This command allows the user to quote text from the message
  1709.                to which he/she is replying.  The user must enter the
  1710.                starting and ending numbers of the lines that he/she wishes
  1711.                to quote.
  1712.  
  1713.           To
  1714.  
  1715.                This allows the user to change the addressee of the message.
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.                     Maximus-CBCS v2.00 Operations Manual - Page 29
  1726.  
  1727.  
  1728.  
  1729.           Subject
  1730.  
  1731.                This allows the user to change the subject of the message.
  1732.  
  1733.           From
  1734.  
  1735.                This will allow the user to change who the message is from. 
  1736.                The privilege level of this command should be set rather
  1737.                high, as this command can be used in any message area,
  1738.                whether or not the area is declared as anonymous.
  1739.  
  1740.           Handling
  1741.  
  1742.                This is another command for which the privilege level should
  1743.                be set high.  It will allow the user to change the flags on
  1744.                the message.  Flags such as Private or Public can be
  1745.                changed, in addition to NetMail-type flags such as Crash,
  1746.                Hold or File Attach.
  1747.  
  1748.           Read File From Disk
  1749.  
  1750.                This will allow the user to enter a path to a file on your
  1751.                hard disk and read it in as a message.  The privilege level
  1752.                of this command should be set fairly high.
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.                     Maximus-CBCS v2.00 Operations Manual - Page 30
  1781.  
  1782.  
  1783.  
  1784.  
  1785.           The File Menu
  1786.  
  1787.           The following attempts to describe the options that would
  1788.           normally be used in a file area menu, and how they are displayed
  1789.           in the default configuration.
  1790.  
  1791.           Area Change
  1792.  
  1793.                This command allows the user to change to another file area. 
  1794.                The user will be prompted to enter the file area they want
  1795.                to go to, or to enter a "?" for a list of the areas that are
  1796.                available to them.  The user can also enter the "<" or ">"
  1797.                characters to go to the previous or next area in the list,
  1798.                respectively.  If entering a barricaded area where a
  1799.                password is required, they will be prompted for the password
  1800.                before they are allowed to enter the area.
  1801.  
  1802.           Locate
  1803.  
  1804.                This command allows a user to search all of the file areas
  1805.                accessible with his/her priv level.  The text that the user
  1806.                enters will be matched anywhere in the filename or
  1807.                description, so wildcards are not required.  There are a
  1808.                couple of modifiers to the L)ocate command.
  1809.  
  1810.                "L*" [L)ocate New] will search all of the file areas for any
  1811.                files that have been uploaded since the user was last on the
  1812.                system.
  1813.  
  1814.                "L?" [L)ocate ?)Help] will display help information on the
  1815.                L)ocate command.
  1816.  
  1817.           File Titles
  1818.  
  1819.                This command will display a list of files in the current
  1820.                area, along with their descriptions.  New files will be
  1821.                identified by a flashing asterisk (*).  An argument to this
  1822.                command can be specified in the same manner as for the
  1823.                L)ocate command, however F)ile Titles will only search the
  1824.                CURRENT file area.
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.                     Maximus-CBCS v2.00 Operations Manual - Page 31
  1836.  
  1837.  
  1838.  
  1839.           View
  1840.  
  1841.                This command will allow a user to display the contents of
  1842.                any ASCII text file.  The file is checked to make sure that
  1843.                it is an ASCII file, and the user is informed if it is not.
  1844.  
  1845.                NOTE!  In prior versions of Maximus, this command was called
  1846.                T)ype.
  1847.  
  1848.           Goodbye
  1849.  
  1850.                This is identical to the G)oodbye command at the main menu. 
  1851.                It will log the user off.
  1852.  
  1853.           Main Menu
  1854.  
  1855.                This will return the user to the main menu.
  1856.  
  1857.           Download
  1858.  
  1859.                The download command allows the user to download one or more
  1860.                files from the file areas.  Max 2.0 has a new format for
  1861.                downloading; now, users can enter the files to download on
  1862.                as many lines as they like, pressing <enter> after each
  1863.                file.  Wildcards will be automatically expanded.  If FB (the
  1864.                Maximus file database builder) is used, files can be quickly
  1865.                downloaded from any file area on the system, regardless of
  1866.                the current area.  (Of course, the user's priv level is
  1867.                checked before allowing such an operation.)  If files were
  1868.                T)agged earlier, those files will be automatically added to
  1869.                the current download.
  1870.  
  1871.                If no default protocol is selected, the user will also be
  1872.                prompted to select a file transfer protocol.  Maximus
  1873.                supports Xmodem, Xmodem-1k, SEAlink, Telink and Zmodem
  1874.                internally; more protocols, including DSZ, BiModem and Mpt,
  1875.                can be directly added as external protocols.
  1876.  
  1877.                The user can also specify one of several operations before
  1878.                beginning the transfer.  Entering "/q" causes Max to abort
  1879.                the transfer without sending anything.  Entering "/e" causes
  1880.                Max to revert to "edit mode"; this mode allows the user to
  1881.                delete and list files in the download queue.  Entering "/g"
  1882.                causes Max to hang up after the transfer is completed.
  1883.  
  1884.                To start the download, simply press <enter> on a blank line.
  1885.  
  1886.           Tag
  1887.  
  1888.  
  1889.  
  1890.                     Maximus-CBCS v2.00 Operations Manual - Page 32
  1891.  
  1892.  
  1893.  
  1894.                The Tag command allows the user to queue one or more files
  1895.                for later downloading.  The Tag command is also accessible
  1896.                through the "t" command (on the More [Y,n,t,=] prompt) when
  1897.                performing a F)iles listing or a L)ocate.
  1898.  
  1899.                Max will prompt the user to enter the filename to tag. 
  1900.                Wildcards are allowed, and if FB is used, global downloading
  1901.                is also permitted.  Max will NOT print a newline when
  1902.                tagging from a file listing to prevent the rest of the list
  1903.                from scrolling off the screen.
  1904.  
  1905.                To download previously-tagged files, simply select the
  1906.                Download option and press <enter> at the "File(s) to
  1907.                download" prompt.
  1908.  
  1909.           Upload
  1910.  
  1911.                This is the reverse of the download command, and allows a
  1912.                user to send files to your system.  Maximus will ask the
  1913.                user which protocol they are using to upload, and in some
  1914.                cases the name of the file they are uploading (if the user
  1915.                selects a batch protocol, such as Zmodem or SEAlink, the
  1916.                filename is transmitted automatically in the transfer, so
  1917.                Maximus won't bother prompting the user).  The protocols are
  1918.                identical to those used for the Download command.
  1919.  
  1920.           Statistics
  1921.  
  1922.                This option displays the user's statistics, including the
  1923.                time the user has been online for the current call, the time
  1924.                online for the day, amount uploaded, amount downloaded,
  1925.                NetMail credit (if any), and so on.
  1926.  
  1927.           Contents
  1928.  
  1929.                The C)ontents command will allow a user to look into a
  1930.                compressed file and see what files are contained inside. 
  1931.                The C)ontents can view any .ZIP, .ARC, .PAK, .ARJ or .LZH
  1932.                file.  For other compression methods, you are on your own.
  1933.  
  1934.           Raw Directory
  1935.  
  1936.                This will display a listing of ALL the files in the current
  1937.                file directory, not just the files listed in the files
  1938.                listing.  The privilege level of this command should be set
  1939.                fairly high.
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.                     Maximus-CBCS v2.00 Operations Manual - Page 33
  1946.  
  1947.  
  1948.  
  1949.           Override Path
  1950.  
  1951.                This will allow the user to supply a path to a different
  1952.                directory than the one specified in the FILEAREA.CTL file
  1953.                for the current file area.  This command should, for obvious
  1954.                reasons, be accessible only to users with high privilege
  1955.                levels.  All changes made with this command are temporary,
  1956.                and the area's path will revert back to normal once you
  1957.                leave the area.
  1958.  
  1959.           Hurl
  1960.  
  1961.                This command will allow a user to move a file from one area
  1962.                to another.  It will ask the user the name of the file to
  1963.                move, and the number of the file area to hurl it to.  This
  1964.                command should be set to a rather high privilege level.
  1965.  
  1966.           Kill File
  1967.  
  1968.                This command will allow the user to delete a file from a
  1969.                file area.  They will be asked for the name of the file to
  1970.                kill, and will then be asked to confirm that they want to
  1971.                delete it.  If they answer "n" to the "Delete?" prompt, they
  1972.                will be given the option of leaving the file but simply
  1973.                removing the entry from the file listing.  For obvious
  1974.                reasons, this command should be set to a high privilege
  1975.                level.
  1976.  
  1977.                In addition, you can define other options in the file menu
  1978.                to call auxiliary menus, display text files, or run external
  1979.                programs.  See the SILT Documentation for more details on
  1980.                defining menus.
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.                     Maximus-CBCS v2.00 Operations Manual - Page 34
  2001.  
  2002.  
  2003.  
  2004.  
  2005.           The Change Setup Menu
  2006.  
  2007.           From this section, a user may change as many of their settings as
  2008.           you permit.  Upon entering the change menu, the user's profile
  2009.           will be displayed.  The menu options are as follows:
  2010.  
  2011.           City
  2012.  
  2013.                Allows the user to change his/her city.
  2014.  
  2015.           Phone Number
  2016.  
  2017.                Allows the user to change his/her phone number.
  2018.  
  2019.           Real Name
  2020.  
  2021.                Designed for an alias system.  Allows user to change his/her
  2022.                real name.
  2023.  
  2024.           Password
  2025.  
  2026.                Allows the user to change their password.  The user will be
  2027.                prompted to enter his/her old password, then enter his/her
  2028.                new password twice.  If the user gets his/her old password
  2029.                wrong five times, he/she will be quietly disconnected.  If
  2030.                the new passwords don't match, the password will not be
  2031.                changed.  Users should be encouraged to change their
  2032.                passwords every so often to prevent other people from
  2033.                finding them out.
  2034.  
  2035.           Help Level
  2036.  
  2037.                Allows the user to change his/her help level.  There are
  2038.                four different help levels available in Maximus:
  2039.  
  2040.                     NOVICE:        Full Menus.
  2041.                     REGULAR:       Abbreviated Menus.
  2042.                     EXPERT:        No Menus
  2043.                     HOTFLASH:      Full-screen, hotkey interface.
  2044.  
  2045.           Nulls
  2046.  
  2047.                Allows the user to change the delay after each transmitted
  2048.                line.  Most users won't need to use this unless they are
  2049.                using a really ancient terminal.
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.                     Maximus-CBCS v2.00 Operations Manual - Page 35
  2056.  
  2057.  
  2058.  
  2059.           Width
  2060.  
  2061.                Allows the user to change the width of his/her screen.  The
  2062.                screen width is used to determine where Maximus should
  2063.                word-wrap, and how wide the menus should be,among other
  2064.                things.
  2065.  
  2066.           Length
  2067.  
  2068.                Allows the user to change the length of his/her screen.  The
  2069.                screen length is used to determine when the "More?" prompts
  2070.                appear.
  2071.  
  2072.           Tabs
  2073.  
  2074.                Allows the user to toggle the translation of tabs.  Normally
  2075.                tabs are sent unaltered, which speeds up the display time
  2076.                marginally.  If this option is off, tabs will be translated
  2077.                to spaces before being sent.
  2078.  
  2079.           More
  2080.  
  2081.                This allows the user to toggle the `More [Y,n,=]?' prompts
  2082.                on and off.
  2083.  
  2084.           Video Mode
  2085.  
  2086.                This allows the user to change Video modes.  Currently, only
  2087.                TTY (plain), ANSI and AVATAR video modes are supported. 
  2088.                More video modes will be added in future releases of
  2089.                Maximus-CBCS for compatibility with other systems.
  2090.  
  2091.           Full-Screen Editor
  2092.  
  2093.                This command allows users to toggle the use of the MaxEd
  2094.                full-screen editor.  If MaxEd is turned off, BORED will be
  2095.                turned on by default.
  2096.  
  2097.           Screen Clear
  2098.  
  2099.                This allows the user to toggle the sending of screen
  2100.                clearing codes in case his/her terminal cannot handle the
  2101.                TTY clearscreen (ASCII character 12) or the ANSI`CLS'
  2102.                command.
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.                     Maximus-CBCS v2.00 Operations Manual - Page 36
  2111.  
  2112.  
  2113.  
  2114.           IBM Graphics
  2115.  
  2116.                This allows the user to toggle whether or not Maximus will
  2117.                send IBM extended ASCII characters.  The IBM (and
  2118.                compatibles) have a special `extended' 8-bit character set,
  2119.                which allows things such as box-drawing and block graphics,
  2120.                while running in text mode.  Most non-IBM systems do not
  2121.                support these extended ASCII characters.  For those users
  2122.                that have this option turned off, Maximus will translate IBM
  2123.                extended ASCII characters into standard ASCII characters in
  2124.                the range of 32 (decimal) to 128.
  2125.  
  2126.           Hotkeys
  2127.  
  2128.                This option allows the user to turn the hotkeys setting on
  2129.                and off.  Turning on hotkeys instructs Maximus to execute
  2130.                commands as soon as they are received, without requiring an
  2131.                <enter> after every second keystroke.
  2132.  
  2133.           Language
  2134.  
  2135.                The Language command allows the user to select an alternate
  2136.                system language.  Max supports up to eight different
  2137.                language files, all of which can be available at the same
  2138.                time.  Simply add the appropriate "Language" statements to
  2139.                LANGUAGE.CTL, and those languages will become available for
  2140.                the Language command.  The user's language preference is
  2141.                automatically saved across calls; to prompt users for an
  2142.                alternate language every time they log on, place a
  2143.                "[menu_cmd chg_language]" token at the top of WELCOME.BBS.
  2144.  
  2145.           Protocol
  2146.  
  2147.                The Protocol command allows the user to select a default
  2148.                transfer protocol.  If a default file transfer protocol is
  2149.                selected, the Download command will immediately shift to the
  2150.                "File(s) to download" prompt instead of asking the user to
  2151.                choose a protocol.
  2152.  
  2153.           Archiver
  2154.  
  2155.                The Archiver command allows the user to select a default
  2156.                archiving and compression program.  Max will shell out to
  2157.                the archiver when performing certain functions, such as
  2158.                compressing QWK bundles and decompressing REP packets.  Max
  2159.                will use the information defined in COMPRESS.CFG to display
  2160.                a list of supported archivers, and will then prompt the user
  2161.                to choose one of the selected options.  (See the READER.CTL
  2162.  
  2163.  
  2164.  
  2165.                     Maximus-CBCS v2.00 Operations Manual - Page 37
  2166.  
  2167.  
  2168.  
  2169.                section in the Maximus Technical Reference Manual for more
  2170.                information.)
  2171.  
  2172.           Show in Userlist
  2173.  
  2174.                The Show in Userlist option allows each individual user to
  2175.                select whether or not his/her name should be displayed in
  2176.                the system userlog.  By default, the user's name will be
  2177.                displayed.  If you wish to stop users from using this
  2178.                command, simply change the priv level of the Chg_Userlist
  2179.                command to Hidden.
  2180.  
  2181.           Full-screen Reader
  2182.  
  2183.                The Full-Screen Reader option allows users to toggle between
  2184.                the old-style Max 1.0x message header (the default) and the
  2185.                Max 2.0 full-screen reader box.  The full-screen reader
  2186.                (hereafter referred to as FSR) displays a pretty blue box at
  2187.                the top of the screen, including the to/from/subject fields,
  2188.                reply links, and net/node information.  However, this box
  2189.                takes a bit longer to display on a remote system, so it is
  2190.                turned off by default.
  2191.  
  2192.           Alias
  2193.  
  2194.                The Alias command allows each user to select an alternate
  2195.                alias.  (Note:  by default, this command is disabled in the
  2196.                distribution MENUS.CTL.)  This command will change the
  2197.                "alias" field in the user record to whatever the user
  2198.                desires, as long as the specified alias doesn't already
  2199.                exist on the system.
  2200.  
  2201.           Quit
  2202.  
  2203.                This will return the user to the main menu.
  2204.  
  2205.           Due to the dynamic menu structure of Maximus, it is possible to
  2206.           configure the change menu to include any commands.  The above are
  2207.           only the commands that are most often used in the change menu on
  2208.           most systems.
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.                     Maximus-CBCS v2.00 Operations Manual - Page 38
  2221.  
  2222.  
  2223.  
  2224.  
  2225.           The SysOp Menu
  2226.  
  2227.           User Editor
  2228.  
  2229.                This invokes the Maximus Internal User Editor.  This command
  2230.                should be made available only to SysOps, for obvious
  2231.                reasons. See the section on the user editor for more
  2232.                details.
  2233.  
  2234.           OS Shell
  2235.  
  2236.                The OS shell permits either a local or remote shell to the
  2237.                operating system.  Note that <Alt-J> can always be used for
  2238.                a local shell to the OS.  (Note:  OS/2 users should use
  2239.                MaxPipe to run CMD.EXE, as opposed to redirecting
  2240.                COMMAND.COM.)
  2241.  
  2242.                If you are using an alternate command processor under DOS
  2243.                (such as 4DOS), make sure to change the menu entry for this
  2244.                command to reflect the command processor (ie. 4DOS.COM)
  2245.                instead of COMMAND.COM.
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.                     Maximus-CBCS v2.00 Operations Manual - Page 39
  2276.  
  2277.  
  2278.  
  2279.  
  2280.           The Chat Menu
  2281.  
  2282.           Maximus supports a full-fledged, internal multi-node chat module. 
  2283.           Users on different nodes can hold private discussions with one
  2284.           another; users can even engage in large group discussions on a
  2285.           "virtual CB channel".
  2286.  
  2287.           CB Chat
  2288.  
  2289.                The CB Chat function allows two or more users to participate
  2290.                in a real-time multi-node chat.  Messages can be sent back
  2291.                and forth, one line at a time, to all users who are
  2292.                participating in that particular conference channel. 
  2293.                (Maximus supports up to 255 virtual CB channels.)
  2294.  
  2295.           Page User
  2296.  
  2297.                The Page User command allows for private chatting between
  2298.                two nodes only.  Selecting Page causes Maximus to send a
  2299.                "chat request" to the specified node number, and it will
  2300.                automatically place the paging user in chat mode, waiting
  2301.                for the other user to respond to the page.
  2302.  
  2303.           Answer Page
  2304.  
  2305.                The Answer Page command is used in conjunction with the Page
  2306.                User command; after a user receives a page message from
  2307.                another user, the paged user can select Answer Page to
  2308.                engage in a private chat with the first user.
  2309.  
  2310.           Toggle Status
  2311.  
  2312.                The Toggle Status function allows a user to toggle his/her
  2313.                chat availability.  Users which are unavailable for chat
  2314.                will be unpagable through the Page User command.
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.                     Maximus-CBCS v2.00 Operations Manual - Page 40
  2331.  
  2332.  
  2333.  
  2334.  
  2335.           The Off-Line Reader Menu
  2336.  
  2337.           The Off-Line Reader menu is the key to Max's internal QWK mail
  2338.           packer.  This menu can be used to select a default protocol and
  2339.           archiving program, select a set of message areas, download
  2340.           messages from those areas, and upload reply packets.
  2341.  
  2342.           Tag Area
  2343.  
  2344.                The Tag Area command (equivalent to the command of the same
  2345.                name on the message menu) allows the user to select a set of
  2346.                message areas for access with the Browse or Download
  2347.                commands.  This area selection will be saved across calls,
  2348.                so it's possible to select a set of message areas that
  2349.                interest the user and keep referring to those tagged areas
  2350.                for future calls.
  2351.  
  2352.           Download New Msgs
  2353.  
  2354.                The Download command packs new messages from all of the
  2355.                currently-tagged areas, compresses them into an archive, and
  2356.                prepares the file for download.  (This option is the
  2357.                equivalent of specifying the argument "t;n;p" for the Browse
  2358.                command.)  If no default archiver or protocol is selected,
  2359.                Max will prompt the user to select a protocol before
  2360.                commencing the download.
  2361.  
  2362.           Upload Replies
  2363.  
  2364.                The Upload Replies option allows users to upload a .REP
  2365.                reply packet into the message areas.  Max will automatically
  2366.                determine the type of archive (even if it's different from
  2367.                the one selected as the user's default archiver), decompress
  2368.                the reply packet, and toss the replies into the appropriate
  2369.                areas.
  2370.  
  2371.           Protocol Default
  2372.  
  2373.                The Protocol option allows the user to select a default file
  2374.                transfer protocol; this option is identical to the one found
  2375.                on the Change menu,
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.                     Maximus-CBCS v2.00 Operations Manual - Page 41
  2386.  
  2387.  
  2388.  
  2389.           Archiver Default
  2390.  
  2391.                The Archiver option allows the user to select a default
  2392.                archiving program; this option is identical to the one found
  2393.                on the Change menu.
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.                     Maximus-CBCS v2.00 Operations Manual - Page 42
  2441.  
  2442.  
  2443.  
  2444.                               INSTALLATION INSTRUCTIONS
  2445.  
  2446.           This section of the manual describes how to install Maximus from
  2447.           scratch.  There is no conversion procedure available for other
  2448.           BBS programs aside from CVTUSR, the Maximus user file conversion
  2449.           utility.
  2450.  
  2451.           Users of Maximus/2 should also read OS2.DOC before beginning the
  2452.           installation.
  2453.  
  2454.  
  2455.           Step 1:  Where do I put these files?
  2456.  
  2457.           This is the easiest part of installing Maximus.  Max is
  2458.           distributed in four separate parts:  MAX200-1.LZH, MAX200-2.LZH,
  2459.           MAX200-3.LZH and MAX200-4.LZH.  Each file contains crucial system
  2460.           information, so you'll need ALL FOUR FILES to install Maximus.
  2461.  
  2462.           The first step in the installation is to unarchive all four files
  2463.           into an empty subdirectory using LHarc.  (Obviously, since you
  2464.           are reading this file, you already know how to operate LHarc!)
  2465.  
  2466.           Most of the files in the distribution kit are packed using a
  2467.           proprietary FIZ compression method, so you'll see a few files
  2468.           with a .FIZ extension, some documentation files, and the install
  2469.           program itself.  The only way to unpack the .FIZ files is through
  2470.           the installation program, so that's what you should run next.
  2471.  
  2472.           When run, the installation program will display some copyright
  2473.           information, and then proceed with the installation.  It will ask
  2474.           you where to place the contents of each .FIZ file; unless you
  2475.           know what you are doing, or if want to use a different directory
  2476.           structure, the defaults are recommended.  To select the default
  2477.           path, simply press <enter> at each prompt.  (The installation
  2478.           program will create directories which do not exist.)
  2479.  
  2480.           You should make sure to specify that you are performing a NEW
  2481.           installation (the default), since you need to extract ALL of the
  2482.           Max 2.00 files.
  2483.  
  2484.           After extracting each .FIZ file, the installation program will
  2485.           then proceed with the first-time configuration.  Simply type in
  2486.           the appropriate text at each box, and use <tab> (or click with
  2487.           the mouse) to move between fields.  To select a particular option
  2488.           from a radio button group, use the left/right keys to cursor over
  2489.           to the appropriate location and press <space> to select that
  2490.           option.  Click or press <enter> on the OK button when you have
  2491.           specified the correct values.
  2492.  
  2493.  
  2494.  
  2495.                     Maximus-CBCS v2.00 Operations Manual - Page 43
  2496.  
  2497.  
  2498.  
  2499.  
  2500.           Step 2:  Configuring your Modem
  2501.  
  2502.           The modem is your gateway to the rest of the world.  It can also
  2503.           be your biggest headache.  Since this documentation can't cover
  2504.           all aspects of installing your modem, you should refer to your
  2505.           modem's manual if you are experiencing difficulties.
  2506.  
  2507.           To begin with, a Hayes-compatible modem is strongly recommended. 
  2508.           Although you may be able to use Maximus with a non-Hayes-
  2509.           compatible modem, Maximus will be unable to use your modem to its
  2510.           full potential.
  2511.  
  2512.           If you do have a Hayes-compatible modem, but you can't get it to
  2513.           work, chances are that are that your problems have to do with
  2514.           DCD, or Data Carrier Detect.  DCD is a signal which your modem
  2515.           sends to your computer when it is connected to another modem. 
  2516.           However, when most modems are shipped from the factory, they have
  2517.           DCD forced on all the time.  Unfortunately, this default is
  2518.           exactly the opposite of what most bulletin board packages
  2519.           require, including Maximus.  Without DCD set correctly, Maximus
  2520.           will not be able to tell when a user has hung up, and your mailer
  2521.           software may have problems handling incoming phone calls.  There
  2522.           are two ways to change the way your modem handles DCD, depending
  2523.           on the type of modem you have.
  2524.  
  2525.           If you own a 1200 bps modem, then chances are that your modem's
  2526.           DCD handling is controlled through DIP switches.  DIP switches
  2527.           are those miniscule plastic bits on the front, rear or bottom of
  2528.           your modem.  (You may have to remove one or more panels to access
  2529.           these switches.)  On most 1200 bps modems, DIP switch #6 toggles
  2530.           whether or not DCD is forced, and it should usually be set in the
  2531.           UP position.  (However, it is a good idea to check your modem
  2532.           manual, just in case the switch settings are different.)  Set the
  2533.           switch so that DCD reflects the modem's actual state, instead of
  2534.           being forced on.  Also make sure that your modem will send back
  2535.           verbal result codes (as opposed to numbers).  The DIP switch to
  2536.           control these result codes varies by modem manufacturer, so you
  2537.           will need to consult your modem's manual to determine which one
  2538.           to use.
  2539.  
  2540.           If you own a 2400 bps (or greater) modem, then you will be spared
  2541.           the trouble of fiddling with DIP switches.  Since almost all of
  2542.           these modems use non-volatile RAM (or NVRAM) instead of DIP
  2543.           switches, you can modify the modem's settings directly using a
  2544.           terminal program.  Once you load up a communications package,
  2545.           type in the command `AT' and press <enter>.  If everything is
  2546.           well, your modem should emit a response of "OK".  After you have
  2547.           established that your modem is working, type in the command
  2548.  
  2549.  
  2550.                     Maximus-CBCS v2.00 Operations Manual - Page 44
  2551.  
  2552.  
  2553.  
  2554.           `AT&C1&S1&D2&W' and press <enter>.  (This command may not work
  2555.           for all 2400 bps modems; consult your modem manual for details.) 
  2556.           This command will set up your modem so that DCD will always
  2557.           reflect the modem's actual state, rather than being always forced
  2558.           high.
  2559.  
  2560.           One other thing which may caused problems is your modem cable. 
  2561.           If your cable does not have the right number of signals wired
  2562.           through, your modem may also behave as if DCD was set
  2563.           incorrectly, regardless of DIP switch or NVRAM settings.  One way
  2564.           you can verify your cable configuration is by borrowing a modem
  2565.           cable from a fellow SysOp.  If you determine that your cable is
  2566.           at fault, you can go to your local computer store or service
  2567.           centre, and ask them for a cable that has at least pins 2-8 and
  2568.           20 wired straight through.
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.                     Maximus-CBCS v2.00 Operations Manual - Page 45
  2606.  
  2607.  
  2608.  
  2609.  
  2610.           Step 3:  Installing a FOSSIL
  2611.  
  2612.           Note!  Unlike DOS, OS/2 does not require a FOSSIL driver.  OS/2
  2613.           includes a device driver to handle serial output, so Maximus/2
  2614.           users can skip this section.
  2615.  
  2616.           Under DOS, Maximus uses an external serial port driver.  Like
  2617.           most FidoNet-compatible packages, Maximus requires a FOSSIL. 
  2618.           `FOSSIL' is an acronym which stands for `Fido/Opus/SEAdog
  2619.           Standard Interface Layer'.  A FOSSIL is a program which handles
  2620.           all of Maximus' low-level serial communication needs, including
  2621.           sending and receiving characters.
  2622.  
  2623.           Using a FOSSIL allows Maximus to be used on semi-compatible
  2624.           computer systems which don't have 100% compatible serial
  2625.           hardware.  The Maximus distribution package is shipped with a
  2626.           copy of David Nugent's BNU FOSSIL, which will be more than enough
  2627.           to get your system running.  However, if BNU is not suitable or
  2628.           will not run on your system, other FOSSILs are available.  Some
  2629.           of the most common FOSSILs are X00 and OpusComm.  (Later versions
  2630.           of BNU may also be available.)  If you can't find any of these
  2631.           programs on a BBS near you, one can be usually be obtained from a
  2632.           local Software Distribution System ("SDS") node, or from the
  2633.           author's BBS.  (See the program licence for details on the
  2634.           author's BBS.)
  2635.  
  2636.           When you are searching for a FOSSIL driver, make sure that the
  2637.           FOSSIL supports at least "FOSSIL Revision 5" or above, since
  2638.           Maximus won't work with lower FOSSIL versions.
  2639.  
  2640.           There are two principal techniques used to install a FOSSIL. 
  2641.           Some FOSSILs, such as OpusComm and BNU, are loaded as TSR
  2642.           (Terminate and Stay Resident) programs in your AUTOEXEC.BAT file. 
  2643.           Others, such as X00.SYS, are loaded via your CONFIG.SYS file. 
  2644.           Although different FOSSILs have different set-up instructions,
  2645.           it's fairly easy to install a FOSSIL for a basic configuration.
  2646.  
  2647.           Here are the basic installation instructions for the three most
  2648.           popular FOSSILs.  These cover only a generic 2400 bps modem on
  2649.           COM1; you should consult your FOSSIL manual to use Max on a
  2650.           different COM port or at higher speeds.
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.                     Maximus-CBCS v2.00 Operations Manual - Page 46
  2661.  
  2662.  
  2663.  
  2664.           OPUSCOMM Installation:
  2665.  
  2666.                To install OpusComm on COM1, simply insert the following
  2667.                command at the beginning of your AUTOEXEC.BAT:
  2668.  
  2669.                OPUSCOMM
  2670.  
  2671.                Make sure that OPUSCOMM.EXE is on your current PATH, or else
  2672.                this will not work.
  2673.  
  2674.           BNUCOM Installation:
  2675.  
  2676.                To install BNUcom on COM1, simply insert the following
  2677.                command at the beginning of your AUTOEXEC.BAT:
  2678.  
  2679.                BNU
  2680.  
  2681.                Make sure that BNU.COM is on your current PATH, or else this
  2682.                will not work.
  2683.  
  2684.           X00 Installation:
  2685.  
  2686.                To install X00 on COM1:, simply insert the following command
  2687.                at the beginning of your CONFIG.SYS:
  2688.  
  2689.                DEVICE=X00.SYS
  2690.  
  2691.                Make sure that X00.SYS is in your C:\ root directory, or
  2692.                else this will not work.
  2693.  
  2694.           If you have advanced requirements (such as if your modem is on
  2695.           COM2, or if you are running a 9600 bps modem), you should consult
  2696.           your FOSSIL's documentation for more information.
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.                     Maximus-CBCS v2.00 Operations Manual - Page 47
  2716.  
  2717.  
  2718.  
  2719.  
  2720.           Step 4:  Editing Configuration Files
  2721.  
  2722.           In order to run Maximus on your system, you will need to make
  2723.           several changes to your system set-up, especially in your
  2724.           CONFIG.SYS and AUTOEXEC.BAT files.  (DOS only.)
  2725.  
  2726.           Note!  The default OS/2 CONFIG.SYS does not need to be modified
  2727.           to use Maximus/2.  OS/2 users should skip this section.
  2728.  
  2729.           In the CONFIG.SYS file, you'll either need to EDIT the following
  2730.           items if they already exist, or ADD them to the end of CONFIG.SYS
  2731.           if they do not.  A generic text editor can be used to edit your
  2732.           CONFIG.SYS file, but a word processor in `non-document' mode will
  2733.           also get the job done.
  2734.  
  2735.           The first change you have to make is to the `BUFFERS=' statement. 
  2736.           (Again, if you don't already have a BUFFERS= statement, add it to
  2737.           the end of CONFIG.SYS.)  If the system you are using is an XT or
  2738.           a PC, make sure that the line reads `BUFFERS=20'.  However, if
  2739.           you are using an AT or an 80386, this line should read
  2740.           `BUFFERS=30' for improved performance.  The BUFFERS statement
  2741.           controls the amount of space that DOS uses for buffering files
  2742.           that are being read from or written to disk.  Setting the BUFFERS
  2743.           command to the wrong number may slow down your system, but
  2744.           Maximus will still function correctly.
  2745.  
  2746.           A second change must be made to the `FILES=' statement.  Unlike
  2747.           the BUFFERS= statement, Maximus will not be able to run properly
  2748.           unless you have this statement set to a number GREATER THAN OR
  2749.           EQUAL TO 20.  If you are running under a multitasking environment
  2750.           such as DESQview or DoubleDOS, then this number should be at
  2751.           least double that.  In other words, if you have no multitasker,
  2752.           use `FILES=20'.  However, if you are running a multitasker, you
  2753.           should use at least `FILES=40', or else Maximus will probably
  2754.           exhibit erratic behaviour.  Again, if you do not already have a
  2755.           `FILES=' statement, simply add it to the end of your CONFIG.SYS.
  2756.  
  2757.           The third change you must make is to add the line
  2758.           `DEVICE=ANSI.SYS' to the end of your CONFIG.SYS.  If you look on
  2759.           your MS-DOS distribution disk(s), you should find a file called
  2760.           `ANSI.SYS' on one of them.  After making the aforementioned
  2761.           change to CONFIG.SYS, copy ANSI.SYS from your DOS disk to the
  2762.           root directory of your hard disk.
  2763.  
  2764.           NOTE!  If you are using IBM-compatible hardware and wish to set
  2765.           Maximus up to use direct screen writes (using "Video IBM" or
  2766.           "Video BIOS"), you do not need to install ANSI.SYS.  Please refer
  2767.  
  2768.  
  2769.  
  2770.                     Maximus-CBCS v2.00 Operations Manual - Page 48
  2771.  
  2772.  
  2773.  
  2774.           to the MAX.CTL documentation for more details, since your system
  2775.           may or may not be able to handle this video mode.
  2776.  
  2777.           Finally, if you are planning on using Squish areas in a multinode
  2778.           environment, you MUST install a copy of DOS's SHARE.EXE.  This
  2779.           sharing module allows Max to share Squish message bases with
  2780.           other nodes or tasks; using Squish areas in a multinode
  2781.           environment without SHARE will certainly cause damage.  To
  2782.           install share, simply make sure that SHARE.EXE is in your root
  2783.           directory, and then add the line "share" to the end of your
  2784.           AUTOEXEC.BAT.
  2785.  
  2786.           Note to Novell users:  Installing SHARE is not completely
  2787.           necessary.  As long as you load INT2F.COM after Netware shell,
  2788.           you can get away without loading SHARE.
  2789.  
  2790.           Once you have made all of these changes and saved the
  2791.           configuration files, you should press <Ctrl-Alt-Del> to reboot
  2792.           your computer.  Unless you reboot, changes made to CONFIG.SYS and
  2793.           AUTOEXEC.BAT will not take effect.
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.                     Maximus-CBCS v2.00 Operations Manual - Page 49
  2826.  
  2827.  
  2828.  
  2829.  
  2830.           Step 5:  Setting Up Control Files
  2831.  
  2832.           This is the most complicated step in setting up your BBS. 
  2833.           Maximus has four basic configuration files which control the
  2834.           operation of your system: MAX.CTL, FILEAREA.CTL, MSGAREA.CTL, and
  2835.           MENUS.CTL.  MAX.CTL is the main control file, and it controls
  2836.           almost everything about your system from the log-on screens
  2837.           displayed to the time `reward' given to users who upload. 
  2838.           MSGAREA.CTL controls all of the message areas on your BBS;
  2839.           FILEAREA.CTL controls all of the file areas, and MENUS.CTL
  2840.           controls all of the menus and options.  The control files are all
  2841.           straight ASCII text, so to edit these files, you must either use
  2842.           a text editor, or a word-processor in a "non- document" or ASCII
  2843.           mode.
  2844.  
  2845.           There are a lot of fairly complicated commands in these control
  2846.           files, but they give you control over even the most minute
  2847.           aspects of your BBS.  Along with this power to tailor your BBS to
  2848.           your particular needs, there also comes the potential for
  2849.           screwing things up.  Therefore, if you are a new SysOp, it is
  2850.           advised that you refrain from playing too much with these files
  2851.           until you get your BBS up and running, and have become more
  2852.           familiar with the various options which are available.
  2853.  
  2854.           The installation program has already customized most of the
  2855.           system control files, so you don't need to do anything just yet. 
  2856.           However, make sure that you know how to edit your control files,
  2857.           and make sure that your editor can handle plain ASCII files.
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.                     Maximus-CBCS v2.00 Operations Manual - Page 50
  2881.  
  2882.  
  2883.  
  2884.  
  2885.           Step 6:  Compiling the Control Files
  2886.  
  2887.           Once you have made all of the required changes to MAX.CTL, the
  2888.           next step is to `compile' your control files.  If you make any
  2889.           changes to your control files and forget to compile them, Maximus
  2890.           will not realize that anything has changed, and will still run
  2891.           using your old configuration.
  2892.  
  2893.           Note!  The idiot-proof configuration program already compiled
  2894.           your control file for the first time.  However, it's a good idea
  2895.           to compile it again here, just so that you can learn how to
  2896.           compile everything properly.
  2897.  
  2898.           Compiling your control files is easy; the program that compiles
  2899.           all of your control files is called SILT.  Just type in the
  2900.           command `SILT <ctlname>' and press <enter>, where <ctlname> is
  2901.           the name of your main control file.  If you are working with the
  2902.           default configuration, then `SILT MAX' should get you running and
  2903.           compile all four of the control files.
  2904.  
  2905.           The main MAX.CTL has `Include' statements near the end which tell
  2906.           SILT to read in MENUS.CTL, FILEAREA.CTL and MSGAREA.CTL
  2907.           automatically.  You cannot compile the other control files
  2908.           individually, so you must always give SILT the name of the main
  2909.           control file.
  2910.  
  2911.           The first time you run SILT, it will probably complain that a few
  2912.           directories didn't exist, and that it is creating them for you. 
  2913.           You need not worry, since this is perfectly normal.  If you have
  2914.           made any errors in the control file, such as misspelling a
  2915.           keyword, SILT will warn you about those too.  If you have made
  2916.           any errors, restart your text editor, move to the specified line
  2917.           number, fix the error, and then recompile using SILT.
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.                     Maximus-CBCS v2.00 Operations Manual - Page 51
  2936.  
  2937.  
  2938.  
  2939.  
  2940.           Step 7:  Starting Maximus
  2941.  
  2942.           Once you have compiled your control files, you are finally ready
  2943.           to start Maximus.  Although your BBS is still fairly bare-bones,
  2944.           it will be partially usable.
  2945.  
  2946.           To start up Maximus for the first time, CD to the \MAX directory
  2947.           and type in the command "max -c".  The `-c' switch tells Maximus
  2948.           to create a new user file, so you should only do this the first
  2949.           time you run Max.  (If you are converting from another BBS
  2950.           program, now would be a good time to run CVTUSR.)
  2951.  
  2952.           After a bit of disk activity, Maximus should display a copyright
  2953.           banner, and print out a message about the lack of an existing
  2954.           user file.  Maximus will then display the prompt: 
  2955.           "Your Name Here [Y,n]?", where "Your Name Here" is the name
  2956.           entered in the "SysOp" box of the installation program.  Type the
  2957.           letter `Y' to continue your logon.
  2958.  
  2959.           After doing this, Maximus will display a bit of text which
  2960.           describes your BBS.  This text is contained in a file called
  2961.           \MAX\MISC\APPLIC.MEC.  (Files with an extension of .MEC will be
  2962.           discussed in greater detail later in this document.)
  2963.  
  2964.           Maximus will also prompt you for a few pieces of information,
  2965.           including your city, phone number, and password.  Maximus will
  2966.           also prompt you for ANSI screen controls, the MaxEd editor,
  2967.           IBM-PC characters, and hotkeys.  Answer `Y' to all four of these
  2968.           prompts.
  2969.  
  2970.           After Maximus has finished the interrogation, it will display a
  2971.           welcome screen and a bulletin file, and will then finally place
  2972.           you at the main menu.  All of these screens are completely
  2973.           redefinable.  Such customization will be described later in this
  2974.           manual.
  2975.  
  2976.           Now that you have Maximus working, you will probably want to look
  2977.           around for a while.  Feel free to play around, and explore the
  2978.           different features of your new BBS.  If you would like to send
  2979.           some test NetMail, try going into the user editor and giving
  2980.           yourself some matrix credit.
  2981.  
  2982.           When you have finished looking around at your new BBS, type `G'
  2983.           from any menu to log off, and Maximus will exit back to the
  2984.           command prompt.
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.                     Maximus-CBCS v2.00 Operations Manual - Page 52
  2991.  
  2992.  
  2993.  
  2994.  
  2995.           Step 8:  Support for Remote Callers
  2996.  
  2997.           To handle non-local callers, Maximus needs to be run from a batch
  2998.           file.  Although Max can be run locally from the command-line, to
  2999.           properly support external callers, a batch file must be created
  3000.           to recycle your system after a caller hangs up.  In the case of a
  3001.           power failure, your batch files should also be capable of
  3002.           restarting the BBS without intervention.
  3003.  
  3004.           There are two mutually-exclusive methods of running Max:
  3005.  
  3006.           1)   Max can be run using the internal Waiting For Caller (WFC)
  3007.                subsystem.  WFC handles all of the modem manipulation inside
  3008.                of Maximus, so no external programs are required to answer
  3009.                the phone.  Max will answer the phone, flush out any MNP
  3010.                garbage, and drop immediately to the main BBS.
  3011.  
  3012.           2)   Max can also be run under a "front end".  A front end is a
  3013.                program which answers the phone, optionally performs some
  3014.                additional processing, and then passes control to the BBS. 
  3015.                Front ends are commonly used for FidoNet support, since the
  3016.                FTSC-0001 protocol layer is not built into most BBS
  3017.                software.  If you wish to become a member of FidoNet, you
  3018.                must run a front end.
  3019.  
  3020.           In addition, a combination of these two methods is available for
  3021.           multi-node systems.  In most cases, only one node needs to have a
  3022.           FidoNet address, so one line of your system can run a front end,
  3023.           whereas the other lines can use the internal WFC module.  (All of
  3024.           this is possible using the same set of control files!)
  3025.  
  3026.           Using the Internal WFC Module
  3027.  
  3028.           When run in this mode, Maximus will handle incoming callers on
  3029.           its own.  The first principle of WFC mode is the "-w" command
  3030.           line switch.  To start Max in the most basic WFC mode, the
  3031.           following command should be used:
  3032.  
  3033.                max -w
  3034.  
  3035.           "-w" instructs Maximus to enter WFC mode.  After this command is
  3036.           executed, Maximus will load up, display a few windows, initialize
  3037.           the modem, and wait for an incoming call.  Max will autodetect
  3038.           the incoming caller's speed and switch baud rates automatically.
  3039.  
  3040.           By default, Maximus is set up to run on any Hayes-compatible
  3041.           modem.  If WFC doesn't seem to be answering the phone correctly,
  3042.           read the comments in the Equipment section of MAX.CTL.  You may
  3043.  
  3044.  
  3045.                     Maximus-CBCS v2.00 Operations Manual - Page 53
  3046.  
  3047.  
  3048.  
  3049.           have to fiddle with the command strings, but most modems can be
  3050.           made to work with Maximus.
  3051.  
  3052.           In addition to the standard "-w" switch, you can also use the "-
  3053.           b" (baud rate) and "-p" (com port) switches to specify an
  3054.           alternate port number and maximum baud rate for the current node,
  3055.           overriding the defaults in the control file.  For example, to
  3056.           start WFC on port 2 with a baud rate of 38400, specify the
  3057.           following command:
  3058.  
  3059.                max -w -p2 -b38400
  3060.  
  3061.           To run WFC with a locked baud rate, either see your FOSSIL
  3062.           documentation about locking your FOSSIL driver, or see the
  3063.           documentation on the "-s" command-line switch in the Maximus
  3064.           Technical Reference Manual.
  3065.  
  3066.           No matter which options you use, the command line must always
  3067.           include a "-w" if you wish to handle remote callers.  This
  3068.           command must be placed in your batch file where you wish Max to
  3069.           be run.
  3070.  
  3071.           The WFC module can also handle timed events which are run at
  3072.           specified times of the day.  Please see the section entitled
  3073.           "WAITING FOR CALLER SUBSYSTEM".
  3074.  
  3075.  
  3076.           Using an External Front End
  3077.  
  3078.           In this mode, Maximus will not answer the telephone by itself. 
  3079.           Since you are probably using this mode for FidoNet compatibility,
  3080.           you'll need a "front end" or a "mailer" to handle incoming and
  3081.           outgoing calls.  There are six or seven FidoNet-compatible
  3082.           mailers freeware/shareware market, and three or four in the
  3083.           commercial market, so you have plenty to choose from.  (At the
  3084.           time of this writing, the two most common mailers are BinkleyTerm
  3085.           and FrontDoor.)
  3086.  
  3087.           Although setting up your front-end mailer is beyond the scope of
  3088.           this document, you will find several sample batch files for
  3089.           different mailers in the appendices in the Maximus Technical
  3090.           Reference Manual.
  3091.  
  3092.           Your mailer's documentation may have some specific details for
  3093.           hooking it up to a Maximus system; if so, you should follow those
  3094.           directions.  If not, read on.  When Maximus starts up with a
  3095.           caller already on-line, it expects to find a minimum of one
  3096.           parameter:  `-b<speed>', where <speed> is the baud rate of the
  3097.           caller currently on-line.  Generally, this is handled through
  3098.  
  3099.  
  3100.                     Maximus-CBCS v2.00 Operations Manual - Page 54
  3101.  
  3102.  
  3103.  
  3104.           errorlevels or through a batch file called SPAWNBBS.BAT or
  3105.           EXEBBS.BAT.
  3106.  
  3107.  
  3108.           Maximus Errorlevels
  3109.  
  3110.           Once you are able to run Max for a remote caller (either through
  3111.           the WFC or from your front end), you are halfway there.  When
  3112.           Maximus terminates, it needs to tell your system what to do next. 
  3113.           For example, if a user entered an EchoMail message, you may want
  3114.           to run a utility (such as Squish) to process that message, or you
  3115.           may wish to run some sort of logging utility.  To accomplish
  3116.           this, Maximus sets a numeric variable in DOS called an
  3117.           `errorlevel'.  As mentioned earlier, Maximus has several
  3118.           errorlevels to juggle for various events, such as a user entering
  3119.           an echomail message, a user entering a netmail message, logging
  3120.           off before the user enters a name, etc.
  3121.  
  3122.           You'll note that in several places throughout the control file,
  3123.           you can tell Maximus which errorlevel to use in certain
  3124.           situations.  Errorlevels are always numeric, and always have a
  3125.           value from 1 through 255.  (However, Maximus reserves errorlevels
  3126.           1 through 4 to indicate errors, so you should not use these in
  3127.           the control file.)  The control file comes pre-set with certain
  3128.           errorlevels, so unless you have a special case, you should not
  3129.           need to modify these.
  3130.  
  3131.           Once Maximus is set up to use errorlevels, the only other task is
  3132.           to make your batch file detect the errorlevel Maximus used, and
  3133.           react accordingly.  Errorlevels can be detected in a batch file
  3134.           quite easily, through the use of the `If Errorlevel <e> <a>'
  3135.           statement.  <e> is a number, and should indicate the actual
  3136.           errorlevel to check for, and should also correspond to the
  3137.           errorlevel specified in MAX.CTL.  <a> specifies an action, which
  3138.           is simply a normal batch file command.
  3139.  
  3140.           However, there is one item which you should pay special attention
  3141.           to: DOS process all errorlevels using a greater- than-or-equal-to
  3142.           operation.  In other words,the statement `If ErrorLevel 10 echo
  3143.           Hi!' will display the word `Hi!' if the errorlevel was set to 10,
  3144.           but will ALSO display `Hi!' if the errorlevel was set to 11, 12,
  3145.           or above.  For this reason, if you have more than one errorlevel
  3146.           to check for, you should always arrange the group of errorlevel
  3147.           statements in a DESCENDING order.  For example, to check for
  3148.           errorlevels 1, 3, 9, 10, 11 and 12, this would be the proper way
  3149.           to place the statements in your batch file:
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.                     Maximus-CBCS v2.00 Operations Manual - Page 55
  3156.  
  3157.  
  3158.  
  3159.                MAX -p%1 -b%2 (other switches here; use "-w" instead for WFC
  3160.                mode)
  3161.  
  3162.                If ErrorLevel 12  (Do op `A' here.)
  3163.                If ErrorLevel 11  (Do op `B' here.)
  3164.                If ErrorLevel 10  (Do op `C' here.)
  3165.                If ErrorLevel  9  (Do op `D' here.)
  3166.                If ErrorLevel  3  (Do op `E' here.)
  3167.                If ErrorLevel  1  (Do op `F' here.)
  3168.  
  3169.           The only other point to remember is that ALL programs modify the
  3170.           DOS errorlevel.  In the example given above, if you were to run a
  3171.           program called (for example) ABCD.EXE for the 'If ErrorLevel 12'
  3172.           statement, ABCD would RESET the DOS errorlevel after ABCD.EXE
  3173.           terminated.  Since the batch file is executed one line at a time,
  3174.           the errorlevel statements which follow would use the errorlevel
  3175.           set by the ABCD program, rather than the value set by Maximus. 
  3176.           To get around this DOS limitation, you must instead use a GOTO
  3177.           statement for the `action' portion of the errorlevel statement.
  3178.  
  3179.           The GOTO command allows your batch file to jump to a completely
  3180.           different location within the same batch file, and start
  3181.           executing commands from that point.  This is accomplished by
  3182.           using a statement in the form of `GOTO <l>', where <l> is a
  3183.           LABEL.  A label is a unique, alphanumeric, ONE-WORD name, which
  3184.           indicates where in the batch file you wish to jump to.  Some
  3185.           valid labels could be called `DoScan', `Heres_The_Scoop', and
  3186.           `ScanBLD'.  However, a GOTO statement alone is not enough to
  3187.           complete the GOTO operation.  You must also place the same label
  3188.           somewhere else within the batch file, which lets DOS know where
  3189.           the GOTO statement should end up.  You can do this simply by
  3190.           placing a colon (`:') at the beginning of a line, simply followed
  3191.           by the label name.
  3192.  
  3193.           For example, the following sample batch file:
  3194.  
  3195.           Line 1:   :BigLoop
  3196.           Line 2:   echo This will be shown repeatedly
  3197.           Line 3:   goto BigLoop
  3198.  
  3199.           ...would cause the line `This will be shown repeatedly' to
  3200.           continuously display on the screen, until the user hits control-C
  3201.           to abort.  (Omit the `Line X:' tags when typing this in.)  When
  3202.           DOS starts the batch file, it will process each line in sequence. 
  3203.           When DOS reads line 1, it will recognize that `BigLoop' is simply
  3204.           a label definition, and will ignore it.  Next, DOS will read line
  3205.           2, and process the ECHO command, by displaying `This will be
  3206.           shown repeatedly' on the screen.  Once DOS encounters line 3, it
  3207.           will realize that it contains a GOTO statement, and will parse
  3208.  
  3209.  
  3210.                     Maximus-CBCS v2.00 Operations Manual - Page 56
  3211.  
  3212.  
  3213.  
  3214.           the label `BigLoop' out of the command.  Having done that, DOS
  3215.           will then scan for the prior `:BigLoop' label, and jump back to
  3216.           line 1, thus continuing the cycle.
  3217.  
  3218.           However, the GOTO command does have practical applications.  The
  3219.           above example could be re-written like this:
  3220.  
  3221.                MAX (command line switches here)
  3222.  
  3223.                If ErrorLevel 12  goto OpA
  3224.                If ErrorLevel 11  goto OpB
  3225.                If ErrorLevel 10  goto OpC
  3226.                If ErrorLevel  9  goto OpD
  3227.                If ErrorLevel  3  goto OpE
  3228.                If ErrorLevel  1  goto OpF
  3229.  
  3230.                :OpA
  3231.                REM * Do operation `A' here.
  3232.                goto End
  3233.  
  3234.                :OpB
  3235.                REM * Do operation `B' here.
  3236.                goto End
  3237.  
  3238.                :OpC
  3239.                REM * Do operation `C' here.
  3240.                goto End
  3241.  
  3242.                :OpD
  3243.                REM * Do operation `D' here.
  3244.                goto End
  3245.  
  3246.                :OpE
  3247.                REM * Do operation `E' here.
  3248.                goto End
  3249.  
  3250.                :OpF
  3251.                REM * Do operation `F' here.
  3252.                goto End
  3253.  
  3254.                :End
  3255.  
  3256.  
  3257.           In this situation, DOS would first compare the errorlevel
  3258.           returned by Maximus to those listed in the `If ErrorLevel'
  3259.           portion of the batch file, and then jump down to the
  3260.           corresponding label.  For example, if Maximus exited using
  3261.           errorlevel 10, DOS would jump down to `:OpC', and process the
  3262.           statements which followed.  The REM statement is simply a remark,
  3263.  
  3264.  
  3265.                     Maximus-CBCS v2.00 Operations Manual - Page 57
  3266.  
  3267.  
  3268.  
  3269.           and is ignored by DOS.  (Typically, there would be one or more
  3270.           programs run in that portion of the batch file, as opposed to
  3271.           just the REM command.)  After processing the REM command, DOS
  3272.           then reads the next line of the batch file, and processes it. 
  3273.           The `goto End' statement is necessary, to make sure that DOS
  3274.           doesn't keep going, and execute the commands for `OpD' as well. 
  3275.           (Recall that DOS just ignores LABEL DEFINITIONS, such as `:OpD'. 
  3276.           Without the extra `goto End', the batch file would just `fall
  3277.           through' to the statements under OpD, OpE, etc.  The extra goto
  3278.           specifically instructs DOS to jump to the `:End' label, which is
  3279.           located at the end of the batch file.  On the other hand, some
  3280.           times you may WANT the batch file to `fall through', since it
  3281.           allows one to have several similar commands to be processed, when
  3282.           using the same errorlevel.  Fortunately, cases where intentional
  3283.           fall-throughs are needed are few and far between.)
  3284.  
  3285.           Arranging the batch file like this allows for more than one
  3286.           command to be executed for a certain errorlevel, and in addition,
  3287.           gets around the above-mentioned problem of other programs
  3288.           changing the errorlevel.
  3289.  
  3290.           Max's errorlevel numbers higher than 5 are completely
  3291.           configurable, but if you are using the default configuration, the
  3292.           following errorlevels will be used:
  3293.  
  3294.           *    Errorlevel 255:  This means that Maximus terminated with an
  3295.                undefined error condition.  Your batch file should return to
  3296.                your front-end mailer.
  3297.  
  3298.           *    Errorlevel 12:  This indicates that a user entered EchoMail
  3299.                and perhaps also NetMail during this session.  In response,
  3300.                your batch file should call whatever scanner/packer program
  3301.                you use, such as SQUISH OUT SQUASH.  If you are using *.MSG
  3302.                areas, you should also call SCANBLD at this point.  After
  3303.                calling all of these external programs, your batch file
  3304.                should then restart your mailer.
  3305.  
  3306.           *    Errorlevel 11:  This indicates that a user entered NetMail
  3307.                but no EchoMail during this session.  In response, your
  3308.                batch file should call your mail packer, such as SQUISH
  3309.                SQUASH or oMMM.  After calling the packer, your batch file
  3310.                should then restart your mailer.
  3311.  
  3312.           *    Errorlevel 5:  This indicates that a user logged off without
  3313.                entering either EchoMail or NetMail during his/her session. 
  3314.                In response, your batch file can execute a program such as
  3315.                the SCANBLD mail database utility.  Alternatively, you may
  3316.                have your batch file simply restart your mailer.
  3317.  
  3318.  
  3319.  
  3320.                     Maximus-CBCS v2.00 Operations Manual - Page 58
  3321.  
  3322.  
  3323.  
  3324.           *    Errorlevels 4 and 3:  These errorlevels are used to indicate
  3325.                an error condition.  Detecting either errorlevel 4 or
  3326.                errorlevel 4 should cause your batch file to restart your
  3327.                mailer (or to reload Max in WFC mode).
  3328.  
  3329.           *    Errorlevel 2:  Errorlevel indicates that the caller hung up
  3330.                before entering a valid name at the log-on prompt.
  3331.  
  3332.           *    Errorlevel 1:  This errorlevel indicates that the SysOp
  3333.                pressed <Alt-X> at the WFC screen.  When your batch file
  3334.                receives this errorlevel, it should exit back to the
  3335.                operating system.
  3336.  
  3337.           A generic batch file for Maximus (in WFC mode) might look
  3338.           something like this:
  3339.  
  3340.           echo off
  3341.           rem * This is where you call Maximus itself.  Change
  3342.           rem * the `%1' and `%2' as necessary, to make Maximus
  3343.           rem * work with your mailer.  (See the appendix on Sample
  3344.           rem * Batch Files for more information.)
  3345.  
  3346.           :Loop
  3347.           MAX -w (command line switches here)
  3348.           if errorlevel 255 goto Error
  3349.           if errorlevel 16  goto Error
  3350.           if errorlevel 12  goto EchoMail
  3351.           if errorlevel 11  goto NetMail
  3352.           if errorlevel  5  goto Aftercall
  3353.           if errorlevel  4  goto Error
  3354.           if errorlevel  3  goto Error
  3355.           if errorlevel  2  goto Loop
  3356.           if errorlevel  1  goto Loop
  3357.  
  3358.  
  3359.           :EchoMail
  3360.           rem * Invoke scanner and packer here.  Next, go to the
  3361.           rem * 'Aftercall' label to process any after-caller actions.
  3362.           rem *
  3363.           rem * For the Squish mail processor, use the following command:
  3364.           rem
  3365.           rem SQUISH OUT SQUASH -fc:\max\echotoss.log
  3366.  
  3367.           goto Aftercall
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.  
  3375.                     Maximus-CBCS v2.00 Operations Manual - Page 59
  3376.  
  3377.  
  3378.  
  3379.           :NetMail
  3380.           rem * Invoke packer here, then go to the 'Aftercall' label.
  3381.           rem
  3382.           rem For the Squish mail processor, use the following command:
  3383.           rem
  3384.           rem SQUISH SQUASH
  3385.  
  3386.           goto Aftercall
  3387.  
  3388.  
  3389.  
  3390.           :Aftercall
  3391.           rem * Invoke after-each-caller utilities here.
  3392.           goto End
  3393.  
  3394.  
  3395.  
  3396.           :Error
  3397.           rem * Something funky happened, so let's say so.
  3398.           echo There has been an error!
  3399.           goto Down
  3400.  
  3401.  
  3402.  
  3403.           :End
  3404.           rem * This label should re-load your phone answering program.
  3405.           rem * If you are using the Maximus WFC, you should use the
  3406.           rem * following line to jump back up to the top of the loop:
  3407.            
  3408.           goto Loop
  3409.  
  3410.           rem * If you are using FrontDoor, BinkleyTerm or another front
  3411.           rem * end, you should comment out the above 'goto' and
  3412.           rem * uncomment the following line:
  3413.           rem
  3414.           rem runbbs
  3415.           rem
  3416.           rem * This assumes that you use RUNBBS.BAT to start your
  3417.           rem * front end.  If not, simply insert the name of that
  3418.           rem * batch file above.
  3419.           rem *
  3420.           rem * WARNING!  OS/2 users must always use the "Spawn"
  3421.           rem * method of executing Maximus.  Please see OS2.DOC for
  3422.           rem * more information on setting up your batch files to
  3423.           rem * work with OS/2.
  3424.  
  3425.  
  3426.           :Down
  3427.  
  3428.  
  3429.  
  3430.                     Maximus-CBCS v2.00 Operations Manual - Page 60
  3431.  
  3432.  
  3433.  
  3434.           rem * The system arrives here if there was a problem
  3435.           echo Error!  Maximus had a fatal error and could not continue!
  3436.           exit
  3437.  
  3438.  
  3439.  
  3440.           Finally, if you are using any *.MSG message areas, it would be a
  3441.           good idea to read the chapter on SCANBLD right now.  (SCANBLD is
  3442.           discussed in the "Maximus Utility Documentation" section of this
  3443.           manual.)  When using *.MSG areas, SCANBLD updates the index file
  3444.           for each area, so you'll have to use it after every caller.  In
  3445.           the sample batch file above, the call to SCANBLD would go under
  3446.           the label marked ':Aftercall'.
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.                     Maximus-CBCS v2.00 Operations Manual - Page 61
  3486.  
  3487.  
  3488.  
  3489.  
  3490.           Step 9:  Events and Yelling
  3491.  
  3492.           The distribution copy of Maximus comes with a pre-configured
  3493.           event file.  This "event file" serves two purposes:
  3494.  
  3495.           1)   With the internal Waiting for Caller subsystem, the event
  3496.                file is used to schedule "external events".  External events
  3497.                are used for running external programs at predetermined
  3498.                times.  These events are useful for nightly maintenance,
  3499.                general cleanup, and anything else you may desire.
  3500.  
  3501.           2)   "Yell events" are also controlled through the events control
  3502.                file.  Yell events are used to define when callers are
  3503.                allowed to page the SysOp, how long the page should last,
  3504.                and which tune to play while the SysOp is being paged.  Yell
  3505.                events are configured just like external events, except that
  3506.                a yell number is specified instead of an errorlevel.
  3507.  
  3508.           All events are kept in the file called EVENTSxx.BBS, where 'xx'
  3509.           is the current task number.  (For a system with no task number,
  3510.           use '00' for 'xx'.)  Each node on a multi-node system must have a
  3511.           separate events file.  However, all of the event files use the
  3512.           same format, so you can simply copy a master events file to
  3513.           EVENTS01.BBS, EVENTS02.BBS, and so on.
  3514.  
  3515.  
  3516.           Yell Events
  3517.  
  3518.           The distribution version of Maximus comes with an event file
  3519.           called EVENTS00.BBS.  This event file contains a single yell
  3520.           event which is active between 13:00 and 23:00 (local time).  You
  3521.           should read the comments in the event file for details, but you
  3522.           can add alternate yell time slots by simply duplicating that line
  3523.           and inserting the appropriate starting and ending times.
  3524.  
  3525.           One thing to note are the numbers in the "Y3/3/1" flag.  The
  3526.           first "3" specifies that the bell or tune will be played three
  3527.           times.  The second "3" specifies that the user can yell up to
  3528.           three times in a row before Max will automatically turn off the
  3529.           Y)ell command.  The final "1" specifies that tune #1 will be
  3530.           played from TUNES.BBS.
  3531.  
  3532.           Max has an external file called TUNES.BBS which can be used to
  3533.           play simple notes and melodies on the local speaker.  The
  3534.           comments in TUNES.BBS describe the structure of the file in more
  3535.           detail, but it essentially contains any number of notes, each
  3536.           note consisting of a frequency and a duration.
  3537.  
  3538.  
  3539.  
  3540.                     Maximus-CBCS v2.00 Operations Manual - Page 62
  3541.  
  3542.  
  3543.  
  3544.           The tunes file can contain more than one tune; Max will play the
  3545.           tune "Yell1" when a user yells, since the distribution events
  3546.           file includes a "1" in the default yell event.  The distribution
  3547.           version of the tunes file also includes "Yell2", "Yell3", "Yell4"
  3548.           and "Yell5", so you can try changing the last number of the yell
  3549.           event to produce different sounds.  If you desire, you can also
  3550.           create your own tunes file.
  3551.  
  3552.  
  3553.           External Events
  3554.  
  3555.           As mentioned above, the events file also supports external
  3556.           events.  (These events are only active when using the internal
  3557.           WFC.)  To add an external event, simply add a line to
  3558.           EVENTSxx.BBS with the appropriate starting time, and add an
  3559.           "E<erl>" flag to the end of the line.  <erl> specifies the
  3560.           errorlevel that Max will exit with at the specified time.  After
  3561.           creating an entry for the event in EVENTSxx.BBS, you should
  3562.           modify your batch files to "trap" the specified errorlevel and to
  3563.           run your external event when that errorlevel is found.
  3564.  
  3565.           For more information, see either the comments in the distribution
  3566.           EVENTS00.BBS or the section entitled "EVENTS.BBS CONFIGURATION"
  3567.           in the Maximus Technical Reference Manual.
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.                     Maximus-CBCS v2.00 Operations Manual - Page 63
  3596.  
  3597.  
  3598.  
  3599.  
  3600.           Step 10:  About Priv Levels and Locks
  3601.  
  3602.           Unlike other BBS programs, Maximus does not use numbers to
  3603.           represent a user's access level.  Instead, Maximus uses a series
  3604.           of keywords, which are called `Priv Levels'.  Listed in
  3605.           descending order, the following privilege levels are currently
  3606.           supported:
  3607.  
  3608.                Hidden (special, see note below)
  3609.                SysOp
  3610.                AsstSysOp
  3611.                Clerk
  3612.                Extra
  3613.                Favored
  3614.                Privil
  3615.                Worthy
  3616.                Normal
  3617.                Limited
  3618.                Disgrace
  3619.                Twit
  3620.  
  3621.           All of these privilege levels, except for `Hidden', can be
  3622.           applied to an ordinary user or menu command.  The`Hidden'
  3623.           privilege level is a special case, and if applied to a user, it
  3624.           ensures that the user will NOT be able to log onto your system,
  3625.           since Maximus will disconnect as soon as the user enters his/her
  3626.           password.  Similarly, setting a menu option or a message/file
  3627.           area priv of `Hidden' means that nobody can access that option -
  3628.           not even the SysOp.  This is useful for hiding commands that you
  3629.           don't want even yourself to be able to access.
  3630.  
  3631.           The only privilege level which confers special capabilities is
  3632.           that of `SysOp'.  For example, users with the privilege level of
  3633.           SysOp can read private messages in any area, regardless of who
  3634.           the actual addressee is.  It should be noted that simply having
  3635.           your name listed in the `SysOp' section of the control file does
  3636.           NOT automatically confer SysOp privileges upon you.  Your actual
  3637.           user profile, contained in the USER.BBS data file, must have your
  3638.           privilege level set to `SysOp'.
  3639.  
  3640.           The remaining privilege levels do not confer any special
  3641.           capabilities and can be assigned to any users you wish,
  3642.           regardless of what the name of the privilege level implies.  The
  3643.           privilege levels that are required to access menu options and
  3644.           message/file areas are controlled in MENUS.CTL and
  3645.           MSGAREA.CTL/FILEAREA.CTL, respectively.  These three files will
  3646.           be discussed later in this document.
  3647.  
  3648.  
  3649.  
  3650.                     Maximus-CBCS v2.00 Operations Manual - Page 64
  3651.  
  3652.  
  3653.  
  3654.           When first setting up your BBS, try and define a set of rules for
  3655.           using privilege levels.  For example:  "First-time callers get a
  3656.           privilege level of DISGRACE, validated users get a privilege
  3657.           level of NORMAL, and users who have donated money to the SysOp
  3658.           receive a privilege level of PRIVIL."  If you don't lay out a
  3659.           plan for assigning privilege levels when you first start out, you
  3660.           will find it very easy to lose track later in the game of who has
  3661.           access to what.
  3662.  
  3663.           Privilege levels are not the only way to control user access to
  3664.           various areas or menu options, since Max has a "lock and key"
  3665.           system.  Using Max's locks, you can give specific users access to
  3666.           certain areas or options independently of that user's priv level. 
  3667.           Once an option or area is `locked' with a specific lock number, a
  3668.           user must have the same key number to access that particular
  3669.           option or area.  Valid lock/keys are numbers from 1 to 8 and
  3670.           letters from A to X.  To add a lock to a message/file area or a
  3671.           menu option, simply add a forward slash after the privilege
  3672.           level, followed by the lock characters you wish to use.  To
  3673.           illustrate, an area with an access level of `Privil/167AQX' would
  3674.           be accessible to only those users whose privilege level was at
  3675.           least `Privil', and who had keys 1, 6, 7, A, Q, and X.
  3676.  
  3677.           You can modify a user's keys in the user editor (through the keys
  3678.           command).  User keys can also be modified on-line, using the keys
  3679.           1 through 8 on your keyboard.  Alphanumeric keys can be also
  3680.           toggled through the priv level window, accessible through the 'S'
  3681.           option on the SysOp screen.
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.                     Maximus-CBCS v2.00 Operations Manual - Page 65
  3706.  
  3707.  
  3708.  
  3709.  
  3710.           Step 11:  Customizing *.BBS Files
  3711.  
  3712.           Now that Maximus is functional, you are probably interested in
  3713.           customizing the screens and menus.  Your first step will probably
  3714.           be to modify the welcome screens and information files which came
  3715.           with the default Maximus package.
  3716.  
  3717.           Almost all of the display files are stored in your \MAX\MISC
  3718.           subdirectory, so this is where you will be doing most of your
  3719.           customization work.  Different files are used for different
  3720.           purposes, and each file has its own unique name.  For example,
  3721.           the first screen displayed to a new user is stored in a file
  3722.           called APPLIC.BBS, the bulletins are stored in BULLETIN.BBS, etc. 
  3723.           You can change these filenames in MAX.CTL if you want, but it
  3724.           will be simpler if you leave the names alone for now.
  3725.  
  3726.           Each file which can be displayed to the user ends with the
  3727.           extension .BBS.  However, you will not be working directly with
  3728.           these files; just like the *.CTL files, display files need to be
  3729.           compiled before they can be displayed.  Although it is possible
  3730.           to directly enter text into the *.BBS file, it is usually much
  3731.           easier to edit the "source code" which contained in the .MEC
  3732.           file.
  3733.  
  3734.           "MEC" is an acronym which stands for `Maximus Embedded Commands'. 
  3735.           However, if you really have a burning urge to insert compiled
  3736.           MECCA codes directly into a .BBS file, a list of the MECCA codes
  3737.           and their translations can be found in the MECCA language
  3738.           reference, in the Maximus Technical Reference Manual.
  3739.  
  3740.           Two of the advantages to using MECCA (as opposed to simply
  3741.           creating files with ANSI graphics) are:
  3742.  
  3743.           1)   You can imbed user- or system-specific information into any
  3744.                screen displayed to the user, which gives your BBS a
  3745.                personal touch.
  3746.  
  3747.           2)   Secondly, MECCA allows you to directly enter colour tokens
  3748.                and cursor controls.  The advantage to this is that Maximus
  3749.                will STRIP OUT these colour and cursor controls for callers
  3750.                who don't support them, which makes the *.ANS and *.ASC
  3751.                kludges of other BBS programs unnecessary.  Only one file is
  3752.                needed for any given screen, and Maximus will convert it
  3753.                on-the-fly for callers with or without ANSI graphics, with
  3754.                or without the ability to display IBM graphics characters,
  3755.                or any combination of the above.  This greatly reduces the
  3756.                time required to maintain your BBS, and it saves disk space
  3757.                too.
  3758.  
  3759.  
  3760.                     Maximus-CBCS v2.00 Operations Manual - Page 66
  3761.  
  3762.  
  3763.  
  3764.           A *.MEC file is composed of straight text, plus some optional
  3765.           "embedded commands".  If you want to see an actual *.MEC file,
  3766.           start up your text editor, and load the file
  3767.           `\MAX\MISC\NEWUSER2.MEC'.  As you can see, the file is mainly
  3768.           composed of straight ASCII text, but with a few special commands
  3769.           inserted in, mainly to control colour and to perform special
  3770.           functions such as displaying the user's name.
  3771.  
  3772.           Generally speaking, anything in a *.MEC file which is NOT inside
  3773.           a pair of square brackets is treated as straight text, and is
  3774.           therefore displayed to the user without alteration.  Anything
  3775.           which IS enclosed in square brackets is called a `token', and is
  3776.           interpreted specially by Maximus.  Tokens have various functions,
  3777.           which can range from changing the colour of the text, to running
  3778.           an external *.EXE or *.COM program, to invoking the internal
  3779.           mail- checker
  3780.  
  3781.           Although you can see many MECCA tokens in use in the distribution
  3782.           \MAX\MISC\*.MEC files, a complete list of these tokens is
  3783.           available in the MECCA documentation, in the Maximus Technical
  3784.           Reference manual.  A complete walkthrough to creating a MECCA
  3785.           source file is given in that same documentation, so you should at
  3786.           least read the first few pages of that section.
  3787.  
  3788.           Once you have finished creating or modifying a *.MEC file, you
  3789.           must then compile it using MECCA, the Maximus Embedded Command
  3790.           Compiler (Advanced).  Compiling a file with MECCA is easy. 
  3791.           Simply type in the command `MECCA <filename>', where <filename>
  3792.           is the name of the *.MEC file you wish to compile.  For example,
  3793.           to compile the file called `APPLIC.MEC' into the file called
  3794.           `APPLIC.BBS', type in `MECCA APPLIC'.  MECCA will then compile
  3795.           the specified file, and warn you if you made any errors.
  3796.  
  3797.           It's also a good idea to test your creations before allowing your
  3798.           users to log on.  Chances are that some of your compiled *.BBS
  3799.           files will have problems, so users might get stuck in an endless
  3800.           loop (or something equally embarrassing).  The Oracle utility
  3801.           will allow you to view *.BBS files off-line without having to
  3802.           start up a local Maximus session.  Please see the section on
  3803.           Oracle for more information.
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.                     Maximus-CBCS v2.00 Operations Manual - Page 67
  3816.  
  3817.  
  3818.  
  3819.  
  3820.           Step 12:  Customizing Msg/File Areas
  3821.  
  3822.           The next step in customizing your bulletin board system is to set
  3823.           up your own message and file areas.  Although the Maximus
  3824.           distribution kit came pre-configured with three message and three
  3825.           file areas, you will probably want to expand beyond this,
  3826.           particularly if you are a member of FidoNet and carry a number of
  3827.           EchoMail conferences.
  3828.  
  3829.           The first thing you should know is that all message areas are
  3830.           defined in MSGAREA.CTL, and file areas are defined in
  3831.           FILEAREA.CTL.  Both message and file areas have 9-character area
  3832.           "names", so you can have an unlimited number of message and file
  3833.           areas, in theory.  However, it is usually a good idea to start
  3834.           with a small number of areas, and then create new ones only as
  3835.           the need arises.
  3836.  
  3837.           Each area definition in both MSGAREA.CTL and FILEAREA.CTL begins
  3838.           with an `Area <area_no>' line and ends with an `End Area' line. 
  3839.           Everything between those lines pertains to that specific area
  3840.           only.  <area_no> specifies the area `number' that is being
  3841.           defined.  Max supports alphanumeric area "numbers" up to nine
  3842.           characters long; area names such "CHATTER" and "HELP" are
  3843.           acceptable, as are numbers such as "1", "2" and "3".  You can
  3844.           even mix the two, such as "SYSOP249".
  3845.  
  3846.           Inside each area definition are a number of keywords which
  3847.           describe that area.  There are many advanced options available,
  3848.           but only a small subset of those are required for a basic
  3849.           configuration.
  3850.  
  3851.           Remember that message areas are defined in MSGAREA.CTL, and file
  3852.           areas are defined in FILEAREA.CTL.  It's possible to mix and
  3853.           match the two, but your system will be much easier to handle if
  3854.           the message and file areas are separated into two different
  3855.           control files.
  3856.  
  3857.  
  3858.  
  3859.           Options in MSGAREA.CTL
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.                     Maximus-CBCS v2.00 Operations Manual - Page 68
  3871.  
  3872.  
  3873.  
  3874.           MsgAccess <priv>
  3875.  
  3876.                This statement defines the access level that a user must
  3877.                possess to access this message area.
  3878.  
  3879.           MsgInfo <desc>
  3880.  
  3881.                This statement tells Maximus what to describe this message
  3882.                area as to the user.
  3883.  
  3884.           Local <path>
  3885.           EchoMail <path>
  3886.           Matrix <path>
  3887.  
  3888.                Depending on what type of message area this is, you will use
  3889.                ONE of the above three statements to tell Maximus the type
  3890.                of messages that are in this area and in what subdirectory
  3891.                the messages are located.  The area type can be LOCAL
  3892.                (Messages entered in this area stay on your system alone.),
  3893.                ECHOMAIL (Messages entered in this type of area are
  3894.                broadcast to other systems who are participating in the
  3895.                EchoMail conference.), or MATRIX.  (Messages entered in this
  3896.                area are sent directly to the destination node, sometimes
  3897.                referred to as `NetMail'.)  <path> specifies the directory
  3898.                in which the messages are located.  Note:  Each message area
  3899.                must have its own separate subdirectory!  Yes, that is
  3900.                correct.  You must have a separate subdirectory for each
  3901.                message area, just as you must have a separate subdirectory
  3902.                for each file area.  SILT will create this directory for you
  3903.                if it does not already exist.
  3904.  
  3905.           Private Only
  3906.           Public and Private
  3907.           Public Only
  3908.           Read-Only
  3909.  
  3910.                Again, you can use only one of these four statements in a
  3911.                given message area.  These commands tell Maximus which type
  3912.                of messages to allow users to enter in this area.  The first
  3913.                three statements perform as expected.  Users may enter only
  3914.                private messages, they may be given the option of entering
  3915.                either private messages or public messages, or they may
  3916.                enter only public messages.  For most users, a read-only
  3917.                message area means that they cannot enter any messages. 
  3918.                Instead, they can only read existing messages.  This is
  3919.                useful for those sysops who want to set up a message area in
  3920.                which he/she can post bulletins for users to read. 
  3921.                Obviously, there must be some way for messages to be
  3922.                entered, or users would have nothing to read. Users with a
  3923.  
  3924.  
  3925.                     Maximus-CBCS v2.00 Operations Manual - Page 69
  3926.  
  3927.  
  3928.  
  3929.                with a privilege level of at least AsstSysOp are permitted
  3930.                to enter messages in read-only areas.  Users below AsstSysOp
  3931.                will receive the message, `This is a read-only area', and
  3932.                Maximus will not allow them to enter a message.
  3933.  
  3934.           MsgName <tag>
  3935.  
  3936.                THIS IS ONLY REQUIRED FOR ECHOMAIL MESSAGE AREAS:
  3937.  
  3938.                This keyword tells Maximus what the `echo tag' of the
  3939.                current message area is.  This tag should be the same as the
  3940.                one which you have defined for this area in the control file
  3941.                for your EchoMail utility, usually called AREAS.BBS.  For
  3942.                example, `MUFFIN' is the echo tag of the Maximus SysOp
  3943.                support echo.
  3944.  
  3945.  
  3946.           Options in FILEAREA.CTL
  3947.  
  3948.  
  3949.           FileAccess <priv>
  3950.  
  3951.                This statement defines the access level that a user must
  3952.                possess to access this file area.
  3953.  
  3954.           FileInfo <desc>
  3955.  
  3956.                This statement tells Maximus how to describe this file area
  3957.                to the user.  You can add some descriptive comments if you
  3958.                like, so long as all of the text will fit on one line.  For
  3959.                example, the <desc> could be:  "General purpose utilities".
  3960.  
  3961.           Download <path>
  3962.  
  3963.                This statement defines the subdirectory in which the files
  3964.                for this file area are contained.  In other words, this is
  3965.                where users will be able to download files from.
  3966.  
  3967.           Upload <path>
  3968.  
  3969.                This statement defines the subdirectory in which uploads for
  3970.                this file area will be placed.  You have two options for
  3971.                defining an upload path:
  3972.  
  3973.                *    Set it to the same subdirectory as the download path. 
  3974.                     This means that users should be in the correct area
  3975.                     when they upload files, since the file will be
  3976.                     available for download from the specified area as soon
  3977.                     as the user finishes uploading.
  3978.  
  3979.  
  3980.                     Maximus-CBCS v2.00 Operations Manual - Page 70
  3981.  
  3982.  
  3983.  
  3984.                *    Set ALL upload paths in ALL file areas to point to the
  3985.                     DOWNLOAD path for area 0, which is normally accessible
  3986.                     by only the sysop.  This is the most secure option,
  3987.                     since it allows the sysop to check files which are
  3988.                     uploaded before they are put on-line.  Only after the
  3989.                     sysop has checked the file out and Hurled it to the
  3990.                     appropriate area is the file available for download by
  3991.                     users.  This also means that users can upload a file of
  3992.                     any type anywhere and not have to worry about getting
  3993.                     it in the correct area, since there is only one area
  3994.                     for uploads.
  3995.  
  3996.           Note!  By default, all log-off comments will be placed in message
  3997.           area 1.  However, if you wish to change the comment area, you can
  3998.           edit the "Comment Area" string in SESSION section of MAX.CTL.
  3999.  
  4000.           One last reminder.  Don't forget to recompile your control files
  4001.           with SILT after you make any changes!
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.                     Maximus-CBCS v2.00 Operations Manual - Page 71
  4036.  
  4037.  
  4038.  
  4039.  
  4040.           Step 13:  Maintaining File Areas
  4041.  
  4042.           Although message areas are easy to create (by simply adding the
  4043.           appropriate area definition to MSGAREA.CTL), file areas require a
  4044.           bit more maintenance.  Not only do you still need to create the
  4045.           area definition, but you also need to create a listing of files
  4046.           which are available for download in each file area.
  4047.  
  4048.           If you have no files to go into a particular area, you don't have
  4049.           to do anything.  Maximus will create a file catalog as needed
  4050.           when a user uploads a file.
  4051.  
  4052.  
  4053.           Creating File Listings
  4054.  
  4055.           If you already have some files that you would like to place in a
  4056.           certain file area, setting up that area is a bit more involved. 
  4057.           For starters, do a CD to the DOWNLOAD directory for that file
  4058.           area, as you specified it in FILEAREA.CTL.  From the download
  4059.           directory, just copy in all of the files that you wish to have in
  4060.           that file area.
  4061.  
  4062.           Once you have done that, to create the initial file catalog,
  4063.           simply type in the following command at the DOS or OS/2 command
  4064.           prompt:
  4065.  
  4066.                FOR %F IN (*.*) DO ECHO %F >> FILES.BBS
  4067.  
  4068.           You should see a bit of disk and screen activity as the file
  4069.           catalog is created for you.  Although this creates the file
  4070.           names, you are not done yet.  Next, load up an ASCII text editor,
  4071.           and load in FILES.BBS.  Inside this file, you should see a list
  4072.           of the files in the directory.  If you wish to add a comment for
  4073.           a particular file, you can just add one or more spaces after the
  4074.           filename, and insert your comment there.  (You can use up to
  4075.           forty-eight characters if you wish to keep the comment on one
  4076.           line.  If the comment is any longer, then Maximus will
  4077.           automatically wordwrap it onto the next line.  You can make the
  4078.           comment as long as you want, up to 255 characters in length.)
  4079.  
  4080.           Here are the contents of a sample FILES.BBS for a hypothetical
  4081.           file area:
  4082.  
  4083.           TEST.ZIP      This is a text file
  4084.           ABCDEFGH.TXT  This is another interesting text file
  4085.           ACKTHPPT.ZIP  A digitized Bloom County comic strip
  4086.  
  4087.  
  4088.  
  4089.  
  4090.                     Maximus-CBCS v2.00 Operations Manual - Page 72
  4091.  
  4092.  
  4093.  
  4094.           If you want to add files to your catalog after performing the
  4095.           initial `FOR %F' command, you can simply use your text editor to
  4096.           place the filename on a new line of FILES.BBS, followed by the
  4097.           description.  Similarly, to delete a file from the catalog, just
  4098.           delete the line containing the file entry you wish to remove. 
  4099.           You will also need to delete the actual file from the
  4100.           subdirectory.
  4101.  
  4102.           When using the default `File Date Automatic' setting in the
  4103.           control file, Maximus will automatically place the file size and
  4104.           date beside the filename, in addition to adding a bit of colour
  4105.           to the catalog.
  4106.  
  4107.           In addition, you can have files selected for "free download
  4108.           bytes" (doesn't count against user's download limit), "free
  4109.           download time" (doesn't count against user's time limit), or
  4110.           both.  Before a file's description, place a slash and a flag
  4111.           character.  For a free time download, use "/t".  For a free bytes
  4112.           download, use "/b".  For both free time and bytes, use "/tb".
  4113.  
  4114.           For example, to make the Max 2.00 files not count against the
  4115.           user's DL quota, use the following:
  4116.  
  4117.                MAX200-1.LZH /b This is Max 2.00!
  4118.  
  4119.           If you want to count the download against the user's byte total
  4120.           (but not the user's time), this would do:
  4121.  
  4122.                MAX200-1.LZH /t This is Max 2.00!
  4123.  
  4124.           Similarly, if you want both free time AND bytes to be given to
  4125.           the user, the following also works:
  4126.  
  4127.                MAX200-1.LZH /tb This is Max 2.00!
  4128.  
  4129.           Finally, you may add comments to the FILES.BBS listing which are
  4130.           NOT specifically related to one file.  If the FIRST character on
  4131.           a line is a dash or a space, Maximus will treat the line as a
  4132.           comment and display it to the user.  All of the usual *.BBS file
  4133.           colours and tokens are acceptable.  If the first character on the
  4134.           line is a dash, the colour will be set to WHITE before displaying
  4135.           the line.  If the first character is a space, the colour will be
  4136.           left alone (usually cyan).
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.                     Maximus-CBCS v2.00 Operations Manual - Page 73
  4146.  
  4147.  
  4148.  
  4149.           Global Downloading and Dupe Checking
  4150.  
  4151.           If you want to enable global downloading, upload dupe checking,
  4152.           and the fast locate function, you must use a compiled file
  4153.           database (as created by FB.EXE).
  4154.  
  4155.           Global downloading allows users to download a file from an area
  4156.           other than the current area.  For example, if a file in area 10
  4157.           is called QWERTY.LZH, a user could enter "d;qwerty.lzh" from area
  4158.           1 and successfully download that file.
  4159.  
  4160.           Upload dupe checking tells Max to check for duplicate file
  4161.           uploads.  Whenever a user uploads a file, Max will check the
  4162.           compiled file database to see if that file already exists in one
  4163.           of your other file areas.  If it does, Max will abort the upload
  4164.           and display a short message to the user.
  4165.  
  4166.           The fast locate command simply makes the Locate and Newfiles
  4167.           commands much faster.  The search times on a large system will be
  4168.           sped up by several magnitudes, especially if you have a CD-ROM or
  4169.           WORM available to users.  The fast locate command will be
  4170.           automatically used if a compiled file database exists in the Max
  4171.           root directory.
  4172.  
  4173.           To create a file area database (and to use all of the above
  4174.           features), you must run a program called FB (Filebase Build).  FB
  4175.           scans the FILES.BBS directories in each file area, compiles it
  4176.           into a flat binary file, and creates a sorted index at the end. 
  4177.           Max can use this index to process global downloads and dupe
  4178.           checking; the flat binary files are used for the Locate and
  4179.           Newfiles commands.
  4180.  
  4181.           Creating a compiled file database is easy; after making any
  4182.           change to the file areas (whether it be adding, deleting,
  4183.           receiving a TICK file, or even modifying a file description), the
  4184.           following command should be run from the Max root directory:
  4185.  
  4186.                FB
  4187.  
  4188.           This tells FB to scan all of the file areas listed in AREA.DAT. 
  4189.           This command creates all of the binary and index files, and so as
  4190.           long as you remember to run FB, global downloading and upload
  4191.           dupe checking can be used with no special effort.  (You may need
  4192.           to enable upload dupe checking through the "Upload Check Dupe"
  4193.           keyword in the SESSION section of MAX.CTL.)
  4194.  
  4195.           If you have a large system, running FB in this manner can take a
  4196.           long time (especially if you make a lot of small changes).  For
  4197.           information on compiling only one or two areas at a time, or for
  4198.  
  4199.  
  4200.                     Maximus-CBCS v2.00 Operations Manual - Page 74
  4201.  
  4202.  
  4203.  
  4204.           using an area data file other than AREA.DAT, please see the
  4205.           section on FB in this manual.
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.  
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.  
  4231.  
  4232.  
  4233.  
  4234.  
  4235.  
  4236.  
  4237.  
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.                     Maximus-CBCS v2.00 Operations Manual - Page 75
  4256.  
  4257.  
  4258.  
  4259.  
  4260.           Step 14:  Customizing Menus
  4261.  
  4262.           Max's menus are completely redefinable and can become difficult
  4263.           to manipulate.  If you are just starting out, leave the menus
  4264.           alone until you become more comfortable with Maximus.  However,
  4265.           even novices can change the access levels of particular commands
  4266.           in MENUS.CTL.  The access level is usually located in the second
  4267.           or third column of each menu option.  The only other "safe" field
  4268.           is the "Command as it appears to user" option.  This command will
  4269.           be shown on the user's screen for NOVICE-level menus.  Remember,
  4270.           the FIRST character in the command will be used to activate that
  4271.           option, so make sure that no more than one of your commands uses
  4272.           a given letter as its first character.  (For example, don't use
  4273.           both "F)ile List" and "F)ind File" on the same menu.)
  4274.  
  4275.           The last thing which is safe to play around with is the
  4276.           `MenuFile' option.  This option tells Maximus to display a
  4277.           customized *.BBS file, as opposed to generating a canned file. 
  4278.           This will allow you to completely customize your BBS and make it
  4279.           look different from any other.  Please see the section entitled
  4280.           `Using Custom Menus' for more information on this topic.
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.  
  4309.  
  4310.                     Maximus-CBCS v2.00 Operations Manual - Page 76
  4311.  
  4312.  
  4313.  
  4314.  
  4315.           Step 15:  Configuring the QWK Mail Packer
  4316.  
  4317.           Maximus supports a built-in QWK offline mail packer.  This
  4318.           feature allows callers to log on, pack up messages from one or
  4319.           more message areas, and download a compressed mail bundle for
  4320.           off-line reading and reply.  This packer is fully integrated with
  4321.           the main BBS, so the packer will automatically adjust itself as
  4322.           areas are added to or deleted from your system.
  4323.  
  4324.           All of the information for the off-line reader is stored in
  4325.           READER.CTL.  Your next task is load this file into your text
  4326.           editor, since several keywords need to be modified.
  4327.  
  4328.           1)   First of all, you will need to modify the "Packet Name"
  4329.                keyword.  This keyword specifies the filename to use when
  4330.                sending QWK packets to your users, minus the ".QWK"
  4331.                extension.  This name should be eight or fewer characters,
  4332.                case insensitive, with no spaces.  Try to make the name
  4333.                describe your BBS in some way; an abbreviation of your BBS
  4334.                name is normally used.  For example, a BBS called "Fowl
  4335.                Weather Post" might use a packet name of "FOWLPOST", and a
  4336.                BBS called "123 Systems Inc." might use a packet name of
  4337.                "123SYS".
  4338.  
  4339.           2)   Second, you should modify the "Phone Number" keyword to
  4340.                reflect your actual phone number.  Maximus doesn't use this
  4341.                information, but your system's phone number is normally
  4342.                placed in the .QWK download packets.  The phone number
  4343.                format given in the control file is suggested, even if you
  4344.                live in another country, since some external readers depend
  4345.                on this number being in a certain format.  Unfortunately,
  4346.                this is a problem with the readers, so there's nothing that
  4347.                Maximus can do about it.
  4348.  
  4349.           3)   Finally, you may want to customize the "Max Mesasges" limit. 
  4350.                If you run a busy system and you want to restrict callers
  4351.                from downloading more than 200 messages at a time, you can
  4352.                set a maximum here.  In the distribution control file, a
  4353.                maximum of 600 messages is set.  To completely disable the
  4354.                maximum, comment out the "Max Messages" keyword.
  4355.  
  4356.           That's all there is to it!  Beyond the initial configuration, the
  4357.           QWK packer is completely self-maintaining.  No extra maintenance
  4358.           is required.  However, if you would like to add some features to
  4359.           your mail packer (such as bulletins and new file lists), please
  4360.           see the section entitled "QWK MAIL PACKER".
  4361.  
  4362.  
  4363.  
  4364.  
  4365.                     Maximus-CBCS v2.00 Operations Manual - Page 77
  4366.  
  4367.  
  4368.  
  4369.  
  4370.           Step 16:  Miscellaneous Information
  4371.  
  4372.           You have now completed the installation of Maximus-CBCS. 
  4373.           Although you are now officially finished, there are a few things
  4374.           that you should keep in mind:
  4375.  
  4376.           For users of *.MSG areas:  A renumbering utility is required.  If
  4377.           you carry any EchoMail conferences, a renumbering utility will be
  4378.           especially crucial.  Maximus comes bundled with a program caller
  4379.           MR; this will automatically delete, renumber and link messages
  4380.           based on information given in MSGAREA.CTL.  MR doesn't use low-
  4381.           level disk calls, so it's safe to use on all systems.  For more
  4382.           information on MR, please see the Maximus Utility Documentation.
  4383.  
  4384.           For users of Squish areas:  Although Squish normally handles
  4385.           renumbering on-the-fly, you may need to use the "SQPACK" utility
  4386.           on a semi-frequent basis.  (Typical systems only need to run
  4387.           SQPACK once a week, but large systems may need to use SQPACK on a
  4388.           daily basis.)  Squish areas gradually develop small holes over a
  4389.           period of time, and the SQPACK program can be used to remove
  4390.           these holes.  In addition, if you are performing renumbering by
  4391.           date, you must use SQPACK, since renumbering by date cannot be
  4392.           performed on-the-fly.  SQPACK is part of Max's companion mail
  4393.           processor, SquishMail.  The SquishMail package includes a number
  4394.           of other useful utilities (such as diagnostic and repair aids for
  4395.           Squish-style areas), so getting a copy of SQSH_*.* is a good
  4396.           idea.
  4397.  
  4398.           Finally, if you are having trouble installing Maximus, chances
  4399.           are that you have not followed these instructions to the letter. 
  4400.           Try reading through the installation instructions once more to
  4401.           see if you forgot anything.
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.                     Maximus-CBCS v2.00 Operations Manual - Page 78
  4421.  
  4422.  
  4423.  
  4424.                             MAXIMUS UTILITY DOCUMENTATION
  4425.  
  4426.  
  4427.           ACCEM:  MECCA Decompiler
  4428.  
  4429.           ACCEM does the reverse of what the MECCA utility does: it takes a
  4430.           compiled .BBS file, and converts it back to a human- readable
  4431.           .MEC file.  This can be useful if you have lost the source for
  4432.           one of your .BBS display files, or if you are trying to change a
  4433.           compiled .BBS file which someone else has given you.
  4434.  
  4435.           After running ACCEM on a .BBS file, you can freely edit the
  4436.           resulting .MEC file, and recompile it as you wish.  ACCEM can
  4437.           convert a .BBS file back to the complete .MEC file.  The .MEC
  4438.           file created with ACCEM should be identical to the original .MEC
  4439.           file, with one small exception: since label names are not stored
  4440.           in the .BBS file, MECCA will simply convert these into numeric
  4441.           labels in the form of `/L0', `/L1', `/L2', etc.  However, the
  4442.           reverse-engineered .MEC file will still compile correctly, and
  4443.           after compiling, the output from the new .MEC file should be
  4444.           identical to the original .BBS file.
  4445.  
  4446.           The format for ACCEM is:
  4447.  
  4448.                ACCEM <infile> [outfile] [-s]
  4449.  
  4450.           <infile> is the name of the .BBS file to convert.  If no
  4451.           extension is given, then ACCEM will automatically use an
  4452.           extension of .BBS.
  4453.  
  4454.           [outfile] is the name of the .MEC file to write to.  If no
  4455.           extension is given, or even if [outfile] is omitted, then ACCEM
  4456.           will default to the <infile> filename, but using an extension of
  4457.           .MEC.
  4458.  
  4459.           [-s] tells ACCEM to split lines which are over 100 characters. 
  4460.           Using this will make ACCEM place an empty brace at the end of
  4461.           each line, thereby limiting the length of lines in the .MEC file,
  4462.           but without affecting the .BBS output.  This is useful if you are
  4463.           decompiling a .BBS file with some very long lines, and if your
  4464.           editor can only display a limited number of columns.
  4465.  
  4466.           For example, to convert TEST.BBS to TEST.MEC, all of the commands
  4467.           following would work equally well:
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.                     Maximus-CBCS v2.00 Operations Manual - Page 79
  4476.  
  4477.  
  4478.  
  4479.                ACCEM TEST
  4480.                     or
  4481.                ACCEM TEST.BBS
  4482.                     or
  4483.                ACCEM TEST.BBS TEST
  4484.  
  4485.           If one wanted to split lines over 100 characters in length, the
  4486.           following would work, too:
  4487.  
  4488.                ACCEM TEST -s
  4489.                ACCEM TEST.BBS -s
  4490.                ACCEM TEST.BBS TEST -s
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.  
  4504.  
  4505.  
  4506.  
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.  
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.                     Maximus-CBCS v2.00 Operations Manual - Page 80
  4531.  
  4532.  
  4533.  
  4534.  
  4535.           ANSI2BBS/MEC:  ANSI to MEC conversion
  4536.  
  4537.           ANSI2BBS and ANSI2MEC are two programs which will process a file
  4538.           containing ANSI graphics, and convert it into a file displayable
  4539.           by Maximus.  ANSI2BBS will convert a file containing ANSI
  4540.           graphics directly into a .BBS file, which can be immediately
  4541.           displayed by Maximus.  On the other hand, ANSI2MEC will convert a
  4542.           file with ANSI graphics into a file containing MECCA commands, as
  4543.           opposed to the compiled AVATAR sequences which are generated when
  4544.           ANSI2BBS is run.  ANSI2BBS is useful for a one-time translation,
  4545.           when you are sure that the output will look right.  ANSI2MEC is
  4546.           useful if you wish to display a file containing ANSI graphics,
  4547.           but also want to add some special effects, such as customizing
  4548.           the screen with MECCA tokens, or adding menus.  After running
  4549.           ANSI2MEC and making any changes,the .MEC file must then be
  4550.           compiled into a .BBS file through MECCA, the Maximus Embedded
  4551.           Command Compiler.  Please refer to the MECCA command language
  4552.           reference manual for more details on the operation of MECCA.
  4553.  
  4554.           The format for ANSI2BBS (and ANSI2MEC) is as follows:
  4555.  
  4556.                ANSI2BBS <infile> [outfile]
  4557.                   or
  4558.                ANSI2MEC <infile> [outfile]
  4559.  
  4560.           <infile> is the name of the input file which contains ANSI
  4561.           graphics.  If no filename extension is specified, then ".ANS"
  4562.           will be used by default.
  4563.  
  4564.           [outfile] is the name of the file to place ANSI2BBS/ANSI2MEC's
  4565.           output in.  If no output filename is specified, then ANSI2BBS
  4566.           will add a `.BBS' extension to the input filename, and send the
  4567.           output to that file.  ANSI2MEC will do similar, except it will
  4568.           use an extension of `.MEC' instead.
  4569.  
  4570.           Although ANSI2BBS and ANSI2MEC will try do the best job they can
  4571.           when converting an ANSI file, due to some ambiguities in the ANSI
  4572.           cursor-movement syntax, it is not always possible to correctly
  4573.           convert all ANSI graphics files.  ANSI2BBS and ANSI2MEC will
  4574.           particularly have problems with some `highly-animated'
  4575.           screens,including some of TheDraw's alternate scanning modes,
  4576.           such as `Diagonal', `Gate', `Squiggle', etc.  Maximus can handle
  4577.           almost all straight-through ANSI files, so unless you are using
  4578.           one of those scanning modes, you should not have any problems.
  4579.  
  4580.           However, once you have converted an ANSI screen, it is a good
  4581.           idea to put it in a place where Maximus can access it, and test
  4582.           it in local mode, or with the Oracle utility.  If the file didn't
  4583.  
  4584.  
  4585.                     Maximus-CBCS v2.00 Operations Manual - Page 81
  4586.  
  4587.  
  4588.  
  4589.           convert correctly and has some formatting glitches, then you have
  4590.           two choices:
  4591.  
  4592.           *    If the file is animated, load the file using TheDraw, an
  4593.                excellent ANSI screen editor by Ian Davis, and turn off the
  4594.                animation by pressing Alt-J and then `N' to convert the
  4595.                drawing to normal mode.  Then try ANSI2BBS again, and hope
  4596.                it works.
  4597.  
  4598.           *    Convert the file using ANSI2MEC, and try to edit the MECCA
  4599.                tokens to fix the problem, and then compile the .MEC file
  4600.                using MECCA.
  4601.  
  4602.           *    Leave the file as-is, and send straight ANSI codes to the
  4603.                caller.  Although it won't be viewable by AVATAR or TTY
  4604.                callers, and it will look icky if you have the `Video IBM'
  4605.                statement enabled, it should work okay for remote ANSI
  4606.                callers, if you enclose the graphics inside `[colour]' and
  4607.                `[endcolour] tokens.
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.                     Maximus-CBCS v2.00 Operations Manual - Page 82
  4641.  
  4642.  
  4643.  
  4644.  
  4645.           CVTUSR:  User File Conversions
  4646.  
  4647.           CVTUSR is a utility which will allow you to convert foreign user
  4648.           files into a format Maximus can handle, from several other
  4649.           popular BBS programs.  In addition, CVTUSR is also capable of
  4650.           generating an Opus 1.10-style USER.DAT file (for use with
  4651.           external programs) FROM Maximus' own USER.BBS.
  4652.  
  4653.           The command-line format for CVTUSR is
  4654.  
  4655.                CVTUSR [[-x]...] 
  4656.  
  4657.           where valid switches are:
  4658.  
  4659.           -l and
  4660.           -m        These switches tell CVTUSR to reset the lastread
  4661.                     pointers in a Maximus-style USER.BBS.  This option is
  4662.                     normally only used to fix cross-linked lastread
  4663.                     pointers, so it should only be used when "Lastread ptr
  4664.                     xlinked" error message appear in the log.  This
  4665.                     function may reset the lastread pointers for some or
  4666.                     all users, but it will correct any crosslinked
  4667.                     pointers.  Both -l and -m function identically.
  4668.  
  4669.           -o110     This switch tells CVTUSR that you are converting an
  4670.                     Opus 1.10-style USER.DAT to a Maximus-style USER.BBS. 
  4671.                     This procedure will convert almost all of the Opus 1.10
  4672.                     fields, with the exception of the expiry dates,
  4673.                     personal welcome screens, and any utility-specific
  4674.                     fields which may be stored in the user file.  Your old
  4675.                     USER.DAT is NOT overwritten by this procedure, so you
  4676.                     don't need to make a copy of it.
  4677.  
  4678.           -q        This switch tells CVTUSR to convert a QuickBBS or RA-
  4679.                     style USERS.BBS to a Maximus USER.BBS.  This conversion
  4680.                     function is not as complete as some of the others; it
  4681.                     will leave out things such as ANSI graphics and "More
  4682.                     [Y,n]?" prompting.  However, the next time the user
  4683.                     logs on, Maximus will ask for all the information which
  4684.                     couldn't be converted, so the loss is minimal.
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.  
  4694.  
  4695.                     Maximus-CBCS v2.00 Operations Manual - Page 83
  4696.  
  4697.  
  4698.  
  4699.                     When converting QBBS security levels, CVTUSR will use
  4700.                     the following conversion system:
  4701.  
  4702.                     QBBS User Level          Max Priv Level
  4703.  
  4704.                     100-32000                SysOp
  4705.                      90-99                   AsstSysOp
  4706.                      80-89                   Clerk
  4707.                      70-79                   Extra
  4708.                      60-69                   Favoured
  4709.                      50-59                   Privil
  4710.                      40-49                   Worthy
  4711.                      20-39                   Normal
  4712.                       1-19                   Disgrace
  4713.  
  4714.           -x110     This switch CVTUSR to convert the Maximus-style
  4715.                     USER.BBS to an Opus 1.10-style USER.DAT.  CVTUSR will
  4716.                     translate all of Maximus' fields into the equivalent
  4717.                     Opus 1.10 fields, and will also attempt to store some
  4718.                     Maximus-specific information in some "spare" fields. 
  4719.                     This means that it MAY be possible to convert the
  4720.                     Maximus USER.BBS to the Opus USER.DAT, run a program
  4721.                     which modifies the Opus version of the user file, and
  4722.                     convert it back.  Although this theoretically should
  4723.                     work without problems, it is not advised, and doing so
  4724.                     may cause some fields to be lost in the Maximus portion
  4725.                     of the user file.
  4726.  
  4727.           -n        This flag tells CVTUSR to convert an older Maximus 1.0x
  4728.                     USER.BBS to a Maximus 2.00 USER.BBS file.
  4729.  
  4730.           -s        This flag tells CVTUSR to swap the `alias' and `name'
  4731.                     fields in a Maximus 2.00 USER.BBS file.  This function
  4732.                     is used to accommodate the changes in the alias system
  4733.                     available in Maximus 2.00 from older Maximus systems.
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.                     Maximus-CBCS v2.00 Operations Manual - Page 84
  4751.  
  4752.  
  4753.  
  4754.  
  4755.           EDITCALL:  Call Fudging Utility
  4756.  
  4757.           EditCall is a small utility which was written to dummy up the
  4758.           `number of callers' count contained in BBSTATxx.BBS.  This
  4759.           program is useful if you have recently changed from another BBS
  4760.           package, and want to set the caller count to reflect the actual
  4761.           number of callers to your system.
  4762.  
  4763.           The command-line format for EditCall is:
  4764.  
  4765.                EDITCALL <task_num> [num_calls]
  4766.  
  4767.           <task_num> should indicate the task number whose caller counter
  4768.           you wish to set.  If you are running only one line, then use 0
  4769.           for <task_num>.
  4770.  
  4771.           [num_calls] should indicate the new number-of-calls variable you
  4772.           wish to set for the specified task.  If you don't specify this
  4773.           parameter, then EditCall will simply display the number of
  4774.           callers for the specified task number, without changing anything.
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.                     Maximus-CBCS v2.00 Operations Manual - Page 85
  4806.  
  4807.  
  4808.  
  4809.  
  4810.           FB:  File Database Compiler
  4811.  
  4812.           FB is the Maximus File Database compiler.  FB compiles the ASCII
  4813.           listings in FILES.BBS into a format which can be used by the
  4814.           global downloading routines, upload dupe checker, and the fast
  4815.           Locate command.  FB is not required, since Max can use FILES.BBS
  4816.           directly, but you'll be missing out on a lot of the new features
  4817.           if you don't use FB.
  4818.  
  4819.           WARNING!  FB can only be used for automatic file dating.  If you
  4820.           are using "File Date Manual", you should make sure to remove all
  4821.           file dates from FILES.BBS before running FB.  Using manual dating
  4822.           is much less of a necessity with FB anyway, since file sizes and
  4823.           dates are stored in the binary database.
  4824.  
  4825.           The command line format of FB is as follows:
  4826.  
  4827.                FB [[area_dat] [area...] [/u]]
  4828.  
  4829.           [area_dat] specifies the name of the area data file.  If no
  4830.           command line parameters are specified, FB will default to
  4831.           AREA.DAT in the current directory.
  4832.  
  4833.           [area...] is a list of zero or more area "numbers", as specified
  4834.           in the "Area <anum>" statement in FILEAREA.CTL.  If no area
  4835.           numbers are specified, FB will rebuild the entire file database. 
  4836.           Otherwise, FB will only process the file areas given.
  4837.  
  4838.           [/u] is the optional `upload' switch.  This causes Maximus to
  4839.           scan the UPLOAD path of the specified file areas rather than the
  4840.           download path.  This parameter is used internally by Maximus in
  4841.           RUNFB.BAT (see below for more information).
  4842.  
  4843.           When compiling a file area, FB will parse FILES.BBS and create
  4844.           the following files in each file area:
  4845.  
  4846.                FILES.DAT A compiled version of each file's name, size,
  4847.                          timestamp, privilege level and flags.
  4848.  
  4849.                FILES.DMP A compiled version of each file description.
  4850.  
  4851.  
  4852.  
  4853.  
  4854.  
  4855.  
  4856.  
  4857.  
  4858.  
  4859.  
  4860.                     Maximus-CBCS v2.00 Operations Manual - Page 86
  4861.  
  4862.  
  4863.  
  4864.                FILES.IDX A sorted binary index of all files in the current
  4865.                          area.
  4866.  
  4867.           If you are using a FileList statement in FILEAREA.CTL, Max will
  4868.           simply chop off the file list's extension and add .DAT, .DMP and
  4869.           .IDX as appropriate.  For example, if you specified the following
  4870.           in FILEAREA.CTL:
  4871.  
  4872.                FileList    D:\AREA1.LST
  4873.  
  4874.           FB would then create files called D:\AREA1.DAT, D:\AREA1.DMP and
  4875.           D:\AREA1.IDX.  This allows owners of CD-ROMs to store all of the
  4876.           file area information in an alternate location.
  4877.  
  4878.           Max also supports a special feature for updating the file
  4879.           database after a file is uploaded.  After processing all of the
  4880.           files uploaded in a single U)pload command, Max will try to find
  4881.           a file called RUNFB.BAT (or RUNFB.CMD for OS/2) in the Max root
  4882.           directory.  After the upload, if this batch/command file is
  4883.           found, Max will execute it with the following parameters:
  4884.  
  4885.                RUNFB <area_dat> <areanum> -u
  4886.  
  4887.           where <area_dat> is the name of the current AREA.DAT file,
  4888.           <areanum> is the area into which the files were uploaded.  (-u
  4889.           specifies that FB should check the upload paths rather than the
  4890.           download paths.)
  4891.  
  4892.           In the default distribution, RUNFB.BAT looks like this:
  4893.  
  4894.                fb %1 %2 %3
  4895.  
  4896.           This causes RUNFB to automatically run FB, which causes the file
  4897.           database to be updated on the spot.  However, if you don't have
  4898.           enough memory to run FB in the BBS window, or if you don't wish
  4899.           to waste time by compiling the file database while the user is
  4900.           on-line, you can use the following in RUNFB instead:
  4901.  
  4902.                echo fb %1 %2 %3 >>do_fb.bat
  4903.  
  4904.           (OS/2 users should use 'do_fb.cmd' instead of 'do_fb.bat'.)
  4905.  
  4906.           The above command creates a log of file areas to update.  If you
  4907.           are using this deferred file database updating, you should insert
  4908.           the following command in your batch file after each caller:
  4909.  
  4910.           (DOS 3.0-3.2 only)
  4911.  
  4912.                if exist do_fb.bat command /c do_fb.bat
  4913.  
  4914.  
  4915.                     Maximus-CBCS v2.00 Operations Manual - Page 87
  4916.  
  4917.  
  4918.  
  4919.                del do_fb.bat
  4920.  
  4921.           (DOS 3.3 and above only)
  4922.  
  4923.                if exist do_fb.bat call do_fb.bat
  4924.                del do_fb.bat
  4925.  
  4926.           (OS/2 only)
  4927.  
  4928.                if exist do_fb.cmd call do_fb.cmd
  4929.                del do_fb.cmd
  4930.  
  4931.           These lines cause Max to perform all file database updating after
  4932.           the caller logs off, which saves on both memory and on-line time. 
  4933.           Make sure to select the command which is appropriate for your
  4934.           system and DOS revision, and make sure that it's run after EVERY
  4935.           caller, regardless of whether or not that caller entered NetMail,
  4936.           EchoMail, or no mail.
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.                     Maximus-CBCS v2.00 Operations Manual - Page 88
  4971.  
  4972.  
  4973.  
  4974.  
  4975.           MAID:  Language File Compiler
  4976.  
  4977.           MAID is Maximus Language File compiler.  MAID takes a language
  4978.           file source, such as ENGLISH.MAD, and turns it into a form usable
  4979.           by Maximus.  The language file support can be used to support
  4980.           non-foreign languages, or simply to change the prompts in the
  4981.           English version of Max.
  4982.  
  4983.           MAID reads the source language from a file called <langname>.MAD. 
  4984.           The distribution version of Maximus comes with one language file
  4985.           called ENGLISH.MAD.  The different files associated with language
  4986.           file processing area:
  4987.  
  4988.           <langname>.MAD:     The Maximus International Definitions file. 
  4989.                               This file contains the language "source". 
  4990.                               This file can be edited with an ordinary text
  4991.                               editor, and this file is used as the input
  4992.                               file for MAID.
  4993.  
  4994.           <langname>.LTF:     The Language Translation File.  This is the
  4995.                               compiled version of the <langname>.MAD file,
  4996.                               as produced by MAID.  This is the only file
  4997.                               that Max uses; if you don't want to change
  4998.                               the language source, feel free to delete the
  4999.                               <langname>.MAD file.
  5000.  
  5001.           ENGLISH.LTH:        The dynamic language include file for the C
  5002.                               language.  This is only required when
  5003.                               recompiling the source code.
  5004.  
  5005.           ENGLISH.H:          The static language include file for the C
  5006.                               language.  This is only required when
  5007.                               recompiling the source code.
  5008.  
  5009.           If you are planning on changing the language files, you must keep
  5010.           ENGLISH.MAD and ENGLISH.LTF as a minimum.  By default, the
  5011.           install program places language files in the \MAX\LANG directory.
  5012.  
  5013.           The command line format for MAID is as follows:
  5014.  
  5015.                MAID <langname> [-s] [-d]
  5016.  
  5017.           <langname> is the full path and name of the language file.  Do
  5018.           NOT include an extension; MAID will add the ".MAD" automatically.
  5019.  
  5020.           -s   Specifies that you want the static language include file to
  5021.                be generated.  This is only required when recompiling the
  5022.  
  5023.  
  5024.  
  5025.                     Maximus-CBCS v2.00 Operations Manual - Page 89
  5026.  
  5027.  
  5028.  
  5029.                source code.  The <langname>.LTH file is not created unless
  5030.                you use this switch.
  5031.  
  5032.           -d   Specifies that you want the dynamic language include file to
  5033.                be generated.  This is only required when recompiling the
  5034.                source code.  The <langname>.H file is not created unless
  5035.                you use this switch.
  5036.  
  5037.           If you wish to change the source in ENGLISH.MAD, you must be wary
  5038.           of three points: 
  5039.  
  5040.           1)   Make sure NOT to change the order of the statements within
  5041.                the file!  Disastrous consequences may result if the strings
  5042.                get out-of-sync.  You can add and delete blank lines or
  5043.                comments, but leave the order of the strings alone.
  5044.  
  5045.           2)   After changing the language file source, the file must be
  5046.                recompiled with MAID to create the .LTF version of the
  5047.                language.
  5048.  
  5049.           3)   After compiling the language file, you MUST recompile your
  5050.                .PRM file with SILT!  Since Max overlays strings in memory,
  5051.                Max needs to know how long your language files are; the
  5052.                summary of this information is stored in MAX.PRM.  SILT
  5053.                collects this information while compiling the .PRM file, so
  5054.                you can simply run SILT to create the language file.  If
  5055.                Maximus detects that the language file has been changed at
  5056.                start-up, it will print out "Old language <langname>: 
  5057.                recompile PRM file with SILT!" and exit.  It is vitally
  5058.                important that the .PRM file be recompiled after changing
  5059.                any of the language files.
  5060.  
  5061.           Finally, if you wish to create a modified language for other
  5062.           people to use, you can simply copy ENGLISH.* to MYLANG.* (or
  5063.           whatever you wish to call the language), and then add that
  5064.           language as a "Language MYLANG" statement in MAX.CTL.
  5065.  
  5066.           NOTE!  We are attempting to set up a "Maximus Language File
  5067.           Repository".  If you have written a Maximus language file for
  5068.           another language (or if you have done a take-off of the English
  5069.           language, such as JIVE, VALLEY, etc.), please upload a copy of
  5070.           the .MAD file to the author's BBS.  A special portion of the
  5071.           Maximus distribution area will be set up for alternate language
  5072.           files, acting as a  central location for obtaining new language
  5073.           files.  Language files are also welcome in SDSMAX, the Software
  5074.           Distribution System area dedicated to Maximus and related
  5075.           utilities.
  5076.  
  5077.  
  5078.  
  5079.  
  5080.                     Maximus-CBCS v2.00 Operations Manual - Page 90
  5081.  
  5082.  
  5083.  
  5084.  
  5085.           MECCA:  Display File Compiler
  5086.  
  5087.           MECCA is a companion utility which will compile *.MEC input files
  5088.           into binary *.BBS files, which can then be displayed by Maximus.
  5089.  
  5090.           The operation of MECCA itself is fairly simple.  The command-line
  5091.           format is:
  5092.  
  5093.                MECCA <infile> [outfile] [-t]
  5094.  
  5095.           <infile> is the name of the input file, and if no extension is
  5096.           specified, an extension of `.MEC' will be used by default. 
  5097.           <infile> can include wildcards, so entering `MECCA *.MEC' is
  5098.           perfectly valid.
  5099.  
  5100.           [outfile] is the name of the compiled output file.  This
  5101.           parameter is optional, and if not specified, it defaults to
  5102.           <infile>, using an extension of `.BBS'.
  5103.  
  5104.           In other words, typing `MECCA BULLETIN' would cause MECCA to try
  5105.           to compile the file `BULLETIN.MEC' into a file called
  5106.           `BULLETIN.BBS'.
  5107.  
  5108.           [-t] tells Maximus to compare the date stamps of the input and
  5109.           output files, and to skip the current file if the output filename
  5110.           is newer than the input filename.  This is useful for recompiling
  5111.           an entire directory of .MEC files, if you can't remember what has
  5112.           changed.  Simply type `MECCA *.MEC -t', and MECCA will
  5113.           automatically scan all of the files in the current directory, and
  5114.           recompile those which have changed.
  5115.  
  5116.           Documentation on the internal format of a *.MEC file itself, and
  5117.           the keywords used therein, is contained in the MECCA Command
  5118.           Language Reference, in the Maximus Technical Reference Manual.
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.                     Maximus-CBCS v2.00 Operations Manual - Page 91
  5136.  
  5137.  
  5138.  
  5139.  
  5140.           MR: Maximus Renumbering Program
  5141.  
  5142.           MR is the Maximus-specific renumbering program.  MR is only used
  5143.           for *.MSG-style areas, since Squish areas renumber themselves on-
  5144.           the-fly.  MR automatically reads the information given in
  5145.           AREA.DAT, renumbers, deletes and relinks messages in *.MSG-style
  5146.           areas.
  5147.  
  5148.           The command line format for MR is:
  5149.  
  5150.                MR <area_dat> [area...]
  5151.  
  5152.           [area_dat] specifies the name of your Maximus AREA.DAT file. 
  5153.           This parameter must be given for MR to operate properly.
  5154.  
  5155.           [area...] specifies one or more message areas to be renumbered. 
  5156.           If no message areas are specified, MR will process all *.MSG
  5157.           areas on your system.
  5158.  
  5159.           When renumbering, MR will check the "Renum Days" and "Renum Max"
  5160.           settings for each message area.  (For more information on Renum
  5161.           Days and Renum Max, please see the MSGAREA.CTL section of the
  5162.           Maximus Technical Reference Manual.)  If either of those two
  5163.           keywords are set, MR will also purge messages based on the
  5164.           specified criteria.  Messages can be killed by message number, by
  5165.           age, or both.
  5166.  
  5167.           MR automatically updates the Maximus lastread files and message
  5168.           area links.  Essentially, just include a call to MR in your daily
  5169.           batch file, and all of your renumbering needs will be taken care
  5170.           off.  If you want to delete messages, make sure to include a
  5171.           "Renum Max" or "Renum Days" statement in MSGAREA.CTL for the
  5172.           areas to be trimmed.
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.                     Maximus-CBCS v2.00 Operations Manual - Page 92
  5191.  
  5192.  
  5193.  
  5194.  
  5195.           ORACLE:  Display File Viewer
  5196.  
  5197.           ORACLE is an off-line .BBS file viewer.  Unlike other BBS
  5198.           programs with embedded command languages, Maximus allows you to
  5199.           view compiled .BBS files without logging on, while still having
  5200.           the screens displayed exactly as they would be through Maximus
  5201.           itself.
  5202.  
  5203.           The command line format for ORACLE is:
  5204.  
  5205.                ORACLE <bbsfile> [[-x]...]
  5206.  
  5207.           <bbsfile> is the name of the compiled .BBS file you wish to view. 
  5208.           If no extension is supplied, then .BBS will be used by default.
  5209.  
  5210.           [-x] can be any of the following command-line parameters:
  5211.  
  5212.           -hX     Sets the current help level to `X', where `X' is the
  5213.                   first letter of a valid help level.  Valid options are
  5214.                   `hN' (Normal), `-hR' (Regular), `-hE' (Expert), and `-hH'
  5215.                   (Hotflash).
  5216.  
  5217.           -i      Disables high-bit IBM characters.  With this option
  5218.                   enabled, ORACLE will automatically translate IBM Extended
  5219.                   ASCII to the ASCII equivalent.
  5220.  
  5221.           -kX     Sets the user's keys to X, where X is simply a listing of
  5222.                   keys to assign to the user.  Valid keys are from 1-8 and
  5223.                   A-X.  For example, using `-k1237AD' would give keys 1, 2,
  5224.                   3, 7, A and D to the user.
  5225.  
  5226.           -mX     Sets the local video mode to X, where X is one of `D'
  5227.                   (DOS), `F' (FAST), 'B' (BIOS) or `I' (IBM).  By default,
  5228.                   ORACLE will use the video mode defined in the control
  5229.                   file.  However, if you wish to use ORACLE from remote, it
  5230.                   may be necessary to use the DOS video mode, since output
  5231.                   from the IBM and FAST video modes normally cannot be
  5232.                   redirected to a COM port.
  5233.  
  5234.           -pX     This tells ORACLE to read the Maximus .PRM information
  5235.                   from the file `X'.  If no PRM file is specified, then
  5236.                   ORACLE will default to using MAX.PRM, in the current
  5237.                   directory.  THIS PARAMETER IS REQUIRED!
  5238.  
  5239.           -q      This option enables the `quick' hotkey mode.
  5240.  
  5241.           -slX    This option sets the virtual screen length to `X' rows. 
  5242.                   This doesn't change your physical screen length; however,
  5243.  
  5244.  
  5245.                     Maximus-CBCS v2.00 Operations Manual - Page 93
  5246.  
  5247.  
  5248.  
  5249.                   it does determine when the `More [Y,n,=]?' prompts are
  5250.                   displayed.  This option defaults to 24 lines.
  5251.           -swX    This option sets the virtual screen width to X columns. 
  5252.                   This doesn't change your physical screen width; however,
  5253.                   it does change the screen width, and controls when
  5254.                   virtual screen wraps will occur.
  5255.  
  5256.           -t      The -t parameter forces Oracle into TTY video mode.  This
  5257.                   will disable all ANSI and AVATAR graphics commands, and
  5258.                   display the file just as it would be shown to a TTY
  5259.                   caller.
  5260.  
  5261.           -vX     This sets the user's privilege level to `X', where `X' is
  5262.                   the first letter of a valid priv level.  For example,
  5263.                   `-va' would set the user's priv level to AsstSysOp, while
  5264.                   `-vl' would set the user's priv level to Limited.
  5265.  
  5266.           In addition to specifying the above parameters on the command
  5267.           line, you can also permanently set these options through an
  5268.           environment variable.  Instead of typing all of the parameters on
  5269.           the command line, you can simply place the same options into the
  5270.           ORACLE environment variable.
  5271.  
  5272.           For example, issuing the following sequence of commands:
  5273.  
  5274.                SET ORACLE=-pD:\Max\Max2.Prm -vS -q
  5275.                ORACLE D:\Max\Misc\Bulletin 
  5276.  
  5277.           is identical to entering all of this at once:
  5278.  
  5279.                ORACLE D:\Max\Misc\Bulletin -pD:\Max\Max2.Prm -vS -q
  5280.  
  5281.           Although the first example looks like more typing, you can easily
  5282.           place the SET command into your AUTOEXEC.BAT, and only type
  5283.           `ORACLE <filename>' for each future file you wish to display.
  5284.  
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.                     Maximus-CBCS v2.00 Operations Manual - Page 94
  5301.  
  5302.  
  5303.  
  5304.  
  5305.           SCANBLD:  Database Builder
  5306.  
  5307.           SCANBLD is the Maximus *.MSG database update utility.  SCANBLD is
  5308.           only required if you are using *.MSG areas; if you are using
  5309.           Squish-format areas (which have their own indexing), SCANBLD is
  5310.           not required and this section may be skipped.
  5311.  
  5312.           SCANBLD's primary function is to speed up Max's internal
  5313.           mailchecker, plus a few of the other internal commands.  Since
  5314.           the *.MSG storage system is very slow, an index file must be
  5315.           built for each area to provide reasonably fast mailchecking. 
  5316.           SCANBLD is not REQUIRED for using the mailchecker, but running
  5317.           the checker on a non-SCANBLD-compiled *.MSG area will be
  5318.           extremely slow.
  5319.  
  5320.           When SCANBLD runs, it creates a database of all of the messages
  5321.           in each area of your system.  SCANBLD must be run after certain
  5322.           actions, including after running a message renumbering utility,
  5323.           after receiving EchoMail, and so on.  This is somewhat
  5324.           inconvenient; however, unless you switch to the Squish message
  5325.           format, you'll have to use SCANBLD to maintain speed in your
  5326.           *.MSG areas.
  5327.  
  5328.           The command line format for SCANBLD is as follows:
  5329.  
  5330.                SCANBLD <user_bbs> <area_dat> ...
  5331.                     [ [All | Local | Matrix | Echo | Conf | @<afile> | ...
  5332.                     <areaname> | !<areaname> | /x]...]
  5333.  
  5334.           <user_bbs> specifies the name and location of your USER.BBS file. 
  5335.           This parameter is required.
  5336.  
  5337.           <area_dat> gives the name and location of your AREA.DAT file. 
  5338.           This parameter is required.
  5339.  
  5340.           After the two mandatory parameters, any of the following commands
  5341.           can appear in any order:
  5342.  
  5343.           ALL            Specifies that SCANBLD is to scan ALL areas,
  5344.                          regardless of what type of message area it is. 
  5345.                          This is the default, and all areas will be scanned
  5346.                          if no parameters are specified.  Note that SCANBLD
  5347.                          will only scan *.MSG areas.  Even if a Squish-
  5348.                          format message area is specified for processing,
  5349.                          that area will be automatically skipped.
  5350.  
  5351.           LOCAL          Specifies that SCANBLD should scan LOCAL areas.
  5352.  
  5353.  
  5354.  
  5355.                     Maximus-CBCS v2.00 Operations Manual - Page 95
  5356.  
  5357.  
  5358.  
  5359.           MATRIX         Specifies that SCANBLD should scan MATRIX areas.
  5360.  
  5361.           ECHO           Specifies that SCANBLD should scan ECHOMAIL areas.
  5362.  
  5363.           CONF           Specifies that SCANBLD should scan CONFERENCE
  5364.                          areas.
  5365.  
  5366.           @<afile>       Specifies that SCANBLD should read the named file
  5367.                          which contains a list of area tags.  SCANBLD will
  5368.                          compare those tags to those specified for the
  5369.                          `MsgName' keyword in each area, and process areas
  5370.                          with matching tags.  <afile> can be Max's own
  5371.                          ECHOTOSS.LOG, or it can be the import data files
  5372.                          produced by Squish, ConfMail or QM.
  5373.  
  5374.           <areaname>     Specifies a specific area number/name for SCANBLD
  5375.                          to process.
  5376.  
  5377.           !<areaname>    Specifies that this area is to be excluded from a
  5378.                          normal scan, and is not to be processed.  This is
  5379.                          useful if you have two separate area numbers
  5380.                          pointing to the same physical message path, or if
  5381.                          you want to exclude certain areas from one of the
  5382.                          above EchoMail/Matrix/Local scans.
  5383.  
  5384.           /c             Forces SCANBLD to do a full compile of each area
  5385.                          processed.  By default, SCANBLD will normally try
  5386.                          to update the mail database in the areas processed
  5387.                          without rebuilding the entire area.  You should
  5388.                          ALWAYS use this option after renumbering messages,
  5389.                          or else the message database will become out of
  5390.                          sync with the actual messages.
  5391.  
  5392.           /nd            Informs SCANBLD that you do NOT want the @<afile>
  5393.                          specification to be deleted after processing. 
  5394.                          This is useful if you have other utilities which
  5395.                          need the specified file, even after SCANBLD has
  5396.                          finished with it.
  5397.  
  5398.           /q             This switch forces SCANBLD into quiet mode. 
  5399.                          Instead of displaying each area's statistics,
  5400.                          SCANBLD will instead display a single hash sign
  5401.                          (`#') for each area processed.
  5402.  
  5403.           The options specified on SCANBLD's command-line are cumulative,
  5404.           so entering the following:
  5405.  
  5406.                SCANBLD user.bbs areas.dat echo matrix 45 !22 @et.log
  5407.  
  5408.  
  5409.  
  5410.                     Maximus-CBCS v2.00 Operations Manual - Page 96
  5411.  
  5412.  
  5413.  
  5414.           would cause SCANBLD to process all EchoMail areas, in
  5415.           addition to all NetMail areas, plus area number 45, plus the
  5416.           areas listed in the ECHOTOSS.LOG-format ET.LOG, with the
  5417.           exception of area number 22.
  5418.  
  5419.           It is suggested that you run SCANBLD as follows, since this
  5420.           procedure ensures that the mail databases always remain
  5421.           synchronized with the actual messages.
  5422.  
  5423.           AFTER A USER ENTERS ECHOMAIL (usually errorlevel 12):
  5424.  
  5425.                SCANBLD user.bbs area.dat local matrix @echotoss.log
  5426.  
  5427.           AFTER A USER ENTERS MATRIX MAIL (usually errorlevel 11):
  5428.  
  5429.                SCANBLD user.bbs area.dat local matrix
  5430.  
  5431.           AFTER A USER ENTERS LOCAL MAIL (usually errorlevel 5):
  5432.  
  5433.                SCANBLD user.bbs area.dat local
  5434.  
  5435.           AFTER IMPORTING ECHOMAIL:
  5436.  
  5437.                SCANBLD user.bbs area.dat local matrix @echotoss.log
  5438.  
  5439.           AFTER RUNNING ANY MESSAGE-RENUMBERING UTILITY:
  5440.  
  5441.                SCANBLD user.bbs area.dat all /c
  5442.  
  5443.           Finally, after using an external message editor, you must SCANBLD
  5444.           all of the areas which you entered messages in.  If your editor
  5445.           can produce an ECHOTOSS.LOG-like file, then you should run
  5446.           SCANBLD after your editor, using the command shown for `If a user
  5447.           enters EchoMail'.  On the other hand, if your external editor
  5448.           does not produce an ECHOTOSS.LOG (or similar) file, then you must
  5449.           scan all areas, using the following command:
  5450.  
  5451.                SCANBLD user.bbs area.dat ALL
  5452.  
  5453.           IF THESE INSTRUCTIONS ARE NOT FOLLOWED TO THE LETTER, SCANBLD may
  5454.           miss messages which would otherwise be flagged as new mail.
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.                     Maximus-CBCS v2.00 Operations Manual - Page 97
  5466.  
  5467.  
  5468.  
  5469.  
  5470.           SILT:  Control File Compiler
  5471.  
  5472.           SILT is the Maximus control file compiler.  SILT takes the raw
  5473.           ASCII control files which you have created and turns them into
  5474.           something that Maximus can use directly.  Optionally, SILT can be
  5475.           instructed to parse only part of your system control files.
  5476.  
  5477.           Starting SILT is fairly easy; the command syntax of SILT is:
  5478.  
  5479.                SILT <ctl_file> [-a] [-m] [-o] [-p] [-s103] [-s110] ...
  5480.                     [-u] [-x]
  5481.  
  5482.           <ctl_file> specifies the name of the control file you want SILT
  5483.           to process, and is the only required argument.  If only the name
  5484.           of the control file is given with no other arguments, then SILT
  5485.           will process everything EXCEPT the SYSTEM*.BBS files.  Otherwise,
  5486.           SILT will only process the parts of the control file which are
  5487.           given on the command- line.  When specifying the control file, do
  5488.           not include the .PRM extension.
  5489.  
  5490.           -a        Tells SILT to compile only MSG/FILEAREA.CTL.
  5491.  
  5492.           -m        Tells SILT to generate the *.MNU files from MENUS.CTL.
  5493.  
  5494.           -p        Instructs SILT to generate MAX.PRM, and if requested,
  5495.                     the Opus version 14 and 17 *.PRM files.
  5496.  
  5497.           -s103     Tells SILT to create SYSTEM*.BBS files for Opus 1.03
  5498.                     compatibility, in addition to compiling only
  5499.                     MSG/FILEAREA.CTL.
  5500.  
  5501.           -s110     Tells SILT to create SYSTEM*.DAT files for Opus 1.10
  5502.                     compatibility, in addition to compiling only
  5503.                     MSG/FILEAREA.CTL.
  5504.  
  5505.           -u        Tells SILT to run in "unattended mode".  Normally, SILT
  5506.                     will prompt the user for input in certain situations,
  5507.                     including when a specified directory doesn't exist. 
  5508.                     (In such a case, SILT would ask the user whether or not
  5509.                     s/he want to create the directory.)  Using `-U' will
  5510.                     tell SILT not to stop to ask for directions, and to
  5511.                     create any nonexistent directories.
  5512.  
  5513.           -x        Causes SILT to compile everything, INCLUDING the
  5514.                     SYSTEM*.BBS and SYSTEM*.DAT files.
  5515.  
  5516.           -y        This switch tells SILT _not_ to sort message and file
  5517.                     area numbers into alphanumeric order.  By default, SILT
  5518.  
  5519.  
  5520.                     Maximus-CBCS v2.00 Operations Manual - Page 98
  5521.  
  5522.  
  5523.  
  5524.                     will sort message and file area numbers before writing
  5525.                     the final index.  If you wish to override the default
  5526.                     sort order, using the -y switch tells SILT to use areas
  5527.                     in the order that they are processed (with no sorting). 
  5528.                     This option can be used to override the default sorting
  5529.                     order.
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.  
  5542.  
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.  
  5552.  
  5553.  
  5554.  
  5555.  
  5556.  
  5557.  
  5558.  
  5559.  
  5560.  
  5561.  
  5562.  
  5563.  
  5564.  
  5565.  
  5566.  
  5567.  
  5568.  
  5569.  
  5570.  
  5571.  
  5572.  
  5573.  
  5574.  
  5575.                     Maximus-CBCS v2.00 Operations Manual - Page 99
  5576.  
  5577.  
  5578.  
  5579.                               RUNNING EXTERNAL PROGRAMS
  5580.  
  5581.           Although Maximus itself offers a large selection of internal
  5582.           features, chances are that you'll want to execute programs
  5583.           OUTSIDE of Maximus while a user is on-line.  Maximus can run
  5584.           almost all types of external programs, from customized file-
  5585.           transfer protocols, to `door' programs written for another BBS
  5586.           program.
  5587.  
  5588.           Maximus can execute as many external programs as you wish, from
  5589.           either a menu option, or from a MECCA embedded command file. 
  5590.           Since these two pieces comprise the whole of the Maximus
  5591.           software, it means that you can run any external program
  5592.           anywhere, at any time.
  5593.  
  5594.  
  5595.           Execution Methods
  5596.  
  5597.           In general, Maximus supports four different methods of running
  5598.           external programs.  You can determine what type of exit you need
  5599.           by looking at the list below, and comparing the methods'
  5600.           advantages and disadvantages to the requirements of the program
  5601.           you wish to run.
  5602.  
  5603.           DOS:      This is the so-called `normal' exit type.  Maximus will
  5604.                     load a second copy of COMMAND.COM, and then run the
  5605.                     external program.
  5606.  
  5607.                     *    This is the only way to run a batch file as an
  5608.                          external program.
  5609.  
  5610.                     *    Since COMMAND.COM has to be loaded, your external
  5611.                          program will have about 174K less space to work
  5612.                          in.  (164K/Maximus + 10K/COMMAND.COM = 174K)
  5613.  
  5614.                     *    If the program is located on the DOS PATH, no
  5615.                          explicit path needs to be given.
  5616.  
  5617.                     You can execute internal DOS commands using this
  5618.                     method, such as DIR, TYPE, CHDIR, etc.
  5619.  
  5620.           RUN:      This exit is identical to `DOS', except that
  5621.                     COMMAND.COM is NOT loaded.  This means:
  5622.  
  5623.                     *    Your program will have a bit more memory to run
  5624.                          in, since a second COMMAND.COM is not in memory.
  5625.  
  5626.                     *    You cannot run a batch file with this command.
  5627.  
  5628.  
  5629.  
  5630.                    Maximus-CBCS v2.00 Operations Manual - Page 100
  5631.  
  5632.  
  5633.  
  5634.                     *    This method will run faster than the DOS method,
  5635.                          because COMMAND.COM doesn't have to be loaded.
  5636.  
  5637.           CHAIN:    This command is just like `RUN', except the external
  5638.                     program will be loaded ON TOP of Maximus.  In other
  5639.                     words, the external program will overlay Maximus in
  5640.                     RAM.  NOTE: this execution format may not work with all
  5641.                     hardware and software combinations.
  5642.  
  5643.                     *    Since the program is loaded on top of Maximus, it
  5644.                          will be able to use all available system memory.
  5645.  
  5646.                     *    This is a one-way command, and control will not be
  5647.                          passed back to Maximus when the program
  5648.                          terminates.  It is the responsibility of the
  5649.                          external program to reload Maximus with the
  5650.                          appropriate parameters once the program has been
  5651.                          executed.  (See below about restarting Maximus
  5652.                          after a CHAIN command.)
  5653.  
  5654.           ERRORLVL: This command tells Maximus to exit completely from
  5655.                     memory, and exit to the calling batch file or program.
  5656.  
  5657.                     *    This command is slow, since the transient portion
  5658.                          of COMMAND.COM must be reloaded.
  5659.  
  5660.                     *    The only interface Maximus has with the external
  5661.                          program is an errorlevel.  (However, this is not
  5662.                          totally true.  See below about Errorlevel Batch
  5663.                          Files.)  Also, see below about restarting Maximus
  5664.                          after an errorlevel exit.
  5665.  
  5666.  
  5667.           ErrorLevel Batch Files
  5668.  
  5669.           When exiting via an errorlevel exit, Maximus uses a concept
  5670.           similar to BinkleyTerm's `BBSBATCH' command, which allows Maximus
  5671.           to pass command-line parameters to an external program.  To
  5672.           create an errorlevel batch file, instead of specifying only an
  5673.           errorlevel as the command to execute, add a single SPACE
  5674.           character (or an underscore, if you are running the external
  5675.           program through a menu option), and then the name of the command
  5676.           you wish to run.
  5677.  
  5678.           ie. `Xtern_Erlvl 65' -> `Xtern_Erlvl 65_Myprg_Arg1_Arg2'.
  5679.  
  5680.           When Maximus encounters an argument after the errorlevel, it will
  5681.           write a file called ERRORLVL.BAT in the Maximus startup
  5682.           directory, containing the argument specified after the
  5683.  
  5684.  
  5685.                    Maximus-CBCS v2.00 Operations Manual - Page 101
  5686.  
  5687.  
  5688.  
  5689.           errorlevel.  (If you have a task number defined in MAX.CTL, then
  5690.           Max will write a file called `ERRORLxx.BAT' instead, where `xx'
  5691.           is the task number, in hexadecimal.  However, aside from the
  5692.           filename change, the use of ERRORLVL.BAT is identical to that in
  5693.           a single-node environment.)  In the case of the above example
  5694.           with MYPRG.EXE, the ERRORLVL.BAT file would contain:
  5695.  
  5696.                Myprg Arg1 Arg2
  5697.  
  5698.           Once the errorlevel batch file has been written, then Maximus
  5699.           will exit with the specified errorlevel.  You can then trap this
  5700.           errorlevel in your batch file, and use a `CALL ERRORLVL.BAT'
  5701.           command to execute the command.  (If using DOS 3.2 or under,
  5702.           replace the `CALL' with `COMMAND /C'.)  After executing the
  5703.           external program, you can then restart Maximus by the method
  5704.           described in the next section.
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.  
  5713.  
  5714.  
  5715.  
  5716.  
  5717.  
  5718.  
  5719.  
  5720.  
  5721.  
  5722.  
  5723.  
  5724.  
  5725.  
  5726.  
  5727.  
  5728.  
  5729.  
  5730.  
  5731.  
  5732.  
  5733.  
  5734.  
  5735.  
  5736.  
  5737.  
  5738.  
  5739.  
  5740.                    Maximus-CBCS v2.00 Operations Manual - Page 102
  5741.  
  5742.  
  5743.  
  5744.  
  5745.           Restarting After Chain/Errorlevel
  5746.  
  5747.           After executing an external program via the CHAIN or ERRORLEVEL
  5748.           exit methods, Maximus can restart itself exactly where it left
  5749.           off and appear as if Maximus had remained in memory for the
  5750.           entire time.
  5751.  
  5752.           This feature is made possible through the `-r' command-line
  5753.           parameter.  When Maximus is invoked using `-r', it will read a
  5754.           file called RESTAR*.BBS from the root directory.  This file was
  5755.           written to disk just before Maximus executed the chain/errorlevel
  5756.           command.  This file contains all of the information that Maximus
  5757.           needs to start up again, so Maximus will simply pick up right
  5758.           where it left off, whether Maximus was displaying a menu or in
  5759.           the middle of a *.BBS file.
  5760.  
  5761.           Also make sure to specify the *.PRM file name on the
  5762.           command-line, if you are not using MAX.PRM.  In addition, if you
  5763.           are using a NON-ZERO task number, then you MUST accompany the
  5764.           `-r' option with the `-nXX' (set task number) option.
  5765.  
  5766.           WARNING!  Never attempt to use an `[xtern_erlvl]' token before a
  5767.           new caller has reached the NEWUSER2 file.  Maximus cannot perform
  5768.           a restart until it knows who the user is, and that means that the
  5769.           user must have entered their name, password, graphics selection,
  5770.           etc.
  5771.  
  5772.           This is an example batch file which utilizes errorlevel batch
  5773.           files, and also the restart option:
  5774.  
  5775.  
  5776.  
  5777.  
  5778.  
  5779.  
  5780.  
  5781.  
  5782.  
  5783.  
  5784.  
  5785.  
  5786.  
  5787.  
  5788.  
  5789.  
  5790.  
  5791.  
  5792.  
  5793.  
  5794.  
  5795.                    Maximus-CBCS v2.00 Operations Manual - Page 103
  5796.  
  5797.  
  5798.  
  5799.           REM * These first "%1 %2 %3" parameters will be passed to
  5800.           REM * the batch file by your mailer.  However, they
  5801.           REM * are not really important when dealing with errorlevel
  5802.           REM * batch files, so we'll just assume that they are
  5803.           REM * correct.  Also, make sure that the `:DoErlvl' label
  5804.           REM * comes AFTER the main `Max -b%1 ...' command.
  5805.  
  5806.           Max -b%1 -p%2 -t%3 -n2
  5807.  
  5808.           :DoErlvl
  5809.           if errorlevel 65 goto Outside
  5810.           REM * [..more errorlevels here..]
  5811.           if errorlevel  1 goto end
  5812.           goto end
  5813.  
  5814.           :Outside
  5815.           REM * Replace the `Call' with a `Command /C', if using DOS
  5816.           REM * 3.2 or below!  Also, make sure that the number after
  5817.           REM * the `-n' parameter specifies the Maximus task number
  5818.           REM * to use, if not the one specified in the control
  5819.           REM * file.
  5820.           REM *
  5821.           REM * Finally, if you are using a non-zero task number, keep
  5822.           REM * in mind that the filename Maximus writes will be
  5823.           REM * `ERRORLxx.BAT', where `xx' is the hexadecimal task
  5824.           REM * number.
  5825.  
  5826.           call C:\Max\Errorlvl.Bat
  5827.           Max -r -n2
  5828.           goto DoErlvl
  5829.  
  5830.           :End
  5831.  
  5832.           After you have created a batch file such as this, using
  5833.           errorlevel exits becomes just as easy as any of the other exit
  5834.           types.  In MECCA, instead of using something in this format:
  5835.  
  5836.                [xtern_run]D:\Path\Progname.Exe Arg1 Arg2 
  5837.  
  5838.           one could easily replace it with something like this:
  5839.  
  5840.                [xtern_erlvl]65 D:\Path\Progname.Exe Arg1 Arg2
  5841.  
  5842.           As you can see, once you have added the errorlevel code to your
  5843.           batch files, adding new options requires only a minimal amount of
  5844.           work.
  5845.  
  5846.  
  5847.  
  5848.  
  5849.  
  5850.                    Maximus-CBCS v2.00 Operations Manual - Page 104
  5851.  
  5852.  
  5853.  
  5854.  
  5855.           External Program Translation Characters
  5856.  
  5857.           When passing a command-line to an external program (and also when
  5858.           parsing some special MECCA tokens), Maximus can include
  5859.           information about the user and SysOp by using special translation
  5860.           tokens.  A format token consists of a percent sign and a single,
  5861.           case-sensitive letter or symbol.  Maximus will interpret the
  5862.           character following the percent sign, and replace it with the
  5863.           variable which that character represents.
  5864.  
  5865.           Maximus currently supports the following external program
  5866.           translation characters:
  5867.  
  5868.           Char      Translation
  5869.  
  5870.           %!        Embeds a newline in a string.
  5871.           %A        The user's FIRST name, in upper-case.
  5872.           %b        The user's baud rate.  If the user is a local caller,
  5873.                     then this will translate to `0'.
  5874.           %B        The user's LAST name, in upper-case.  (If the user has
  5875.                     no last name, then this will translate into `NLN', `No
  5876.                     Last Name'.)
  5877.           %c        The user's city.
  5878.           %C        The response to the last `[menu]' MECCA token.
  5879.           %d        The area number of the current message area
  5880.           %D        The area number of the current file area
  5881.           %e        The user's password
  5882.           %E        The user's screen length, in rows
  5883.           %f        The user's first name, in mixed case.
  5884.           %F        Path to the current file area.
  5885.           %g        User's graphics mode -- `0' for TTY, `1' for ANSI, and
  5886.                     `2' for AVATAR.
  5887.           %G        User's Daily DL limit, in kilobytes
  5888.           %h        The user's phone number.
  5889.           %H        Number of kilobytes downloaded today
  5890.           %i        Total downloads
  5891.           %I        Total uploads
  5892.           %j        Minutes on-line, this call
  5893.           %k        The current node's task number.  (`0' for no task
  5894.                     number.)
  5895.           %K        The current node's task number in hexadecimal format
  5896.                     padded with leading zero to make it two characters.
  5897.                     (`0' for no task number.)
  5898.           %l        The user's last name, in mixed case.  If the user has
  5899.                     no last name, then this will translate into `NLN'.
  5900.           %L        If the user is REMOTE, this will translate into the
  5901.                     string `-pX -bY', where X is the port number (1=COM1,
  5902.  
  5903.  
  5904.  
  5905.                    Maximus-CBCS v2.00 Operations Manual - Page 105
  5906.  
  5907.  
  5908.  
  5909.                     2=COM2, etc) and `y' is the baud rate.  If the user is
  5910.                     LOCAL, this will translate into a simple `-k'.
  5911.           %m        The name of the first file to transfer when invoking an
  5912.                     external protocol.
  5913.           %M        Path to the current message area.
  5914.           %n        User's full name, in mixed case.
  5915.           %N        The name of your BBS, as defined in MAX.CTL.
  5916.           %p        The current port number (0=COM1, 1=COM2, etc).
  5917.           %P        The current port number (1=COM1, 2=COM2, etc).
  5918.           %q        Path to the current msg area (NO trailing backslash)
  5919.           %Q        Path to the current file area (NO trailing backslash)
  5920.           %r        The user's real name, if applicable.
  5921.           %R        All remaining stacked text, as entered at the last
  5922.                     menu.
  5923.           %s        The SysOp's last name, in mixed case.  If the SysOp has
  5924.                     no last name, then this will translate into `NLN'.
  5925.           %S        The SysOp's first name, in mixed case.
  5926.           %t        The amount of time the user has left, in minutes.
  5927.           %T        The amount of time the user has left, in seconds.
  5928.           %u        The user's user number.
  5929.           %U        Simply translates to an underscore.
  5930.           %v        Path to the current upload area (with trailing
  5931.                     backslash)
  5932.           %V        Path to the current upload area (NO trailing backslash)
  5933.           %w        The path to the current FILES.BBS-type file.  This
  5934.                     takes into account the alternate names which may be
  5935.                     used by the `FileList' option.
  5936.           %W        The "steady baud rate", as passed via the -s
  5937.                     command-line parameter.
  5938.           %x        Drive letter of current drive, in upper case.
  5939.           %X        The last read message number for the current message
  5940.                     area.  This only works while in a message area. 
  5941.           %Y        The user's current language number, zero based (0 is
  5942.                     first language, 1 is second, etc.)
  5943.           %Z        Translates to the user's full name, in caps.
  5944.  
  5945.           In addition to the above translation characters, there is also
  5946.           another set of almost-identical characters, which can be used
  5947.           when giving Maximus the name of a file to display.  However, the
  5948.           first character in sequence should be a "+", rather than the
  5949.           usual "%".  The second character WILL be treated as shown above,
  5950.           and translated normally.  For example, to display a file called
  5951.           D:\<#>.BBS, where <#> is the user's number, you would use the
  5952.           following command in MENUS.CTL:
  5953.  
  5954.                Display_File  D:\+u.BBS  Twit  "Display It!"
  5955.  
  5956.  
  5957.  
  5958.  
  5959.  
  5960.                    Maximus-CBCS v2.00 Operations Manual - Page 106
  5961.  
  5962.  
  5963.  
  5964.           Please keep in mind that the usage of the "+" is only required
  5965.           when specifying a filename to display.  The percent sign should
  5966.           be used in all other cases.
  5967.  
  5968.           Finally, there is one additional shortcut for *.MNU menu names. 
  5969.           If you wish to substitute the current task number in a filename,
  5970.           then substitute the "*" character where you wish the task number
  5971.           to appear, and Maximus will translate it automatically.  For
  5972.           example, the following line...
  5973.  
  5974.                First Menu  MAIN*
  5975.  
  5976.           would cause task 0 to display a menu called MAIN00.MNU when first
  5977.           executed, task 1 to display MAIN01.MNU, etc.  (Keep in mind that
  5978.           the task number is in hexadecimal, and therefore the menu
  5979.           displayed for task 12 would be MAIN0C.MNU.)
  5980.  
  5981.  
  5982.  
  5983.  
  5984.  
  5985.  
  5986.  
  5987.  
  5988.  
  5989.  
  5990.  
  5991.  
  5992.  
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.  
  6002.  
  6003.  
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013.  
  6014.  
  6015.                    Maximus-CBCS v2.00 Operations Manual - Page 107
  6016.  
  6017.  
  6018.  
  6019.  
  6020.           Running Doors
  6021.  
  6022.           A `door' is just a fancy name for an external program which can
  6023.           be run and can communicate with an on-line user.  Most door
  6024.           programs contain modem routines, so they can keep track of a
  6025.           user's time limit, make sure that the user doesn't drop carrier
  6026.           while inside the door, etc.
  6027.  
  6028.           However, running a door program presents a special problem. 
  6029.           There are several conflicting standards for `door interfaces',
  6030.           which are what controls the way the BBS program passes
  6031.           information to the door.  Most modern door interfaces can pass
  6032.           out the user's name, whether or not the user supports ANSI
  6033.           graphics, the name of the SysOp, etc.
  6034.  
  6035.           Maximus includes built-in support for the Opus 1.03 LASTUSER.BBS
  6036.           standard, as well as the capability to DIRECTLY write ANY
  6037.           text-based door interface file.  The distribution version of
  6038.           Maximus comes with MECCA scripts which allow you to create door
  6039.           interface files for the following formats: DORINFO1.DEF (QuickBBS
  6040.           and RBBS), CHAIN.TXT (WWIV), CALLINFO.BBS (WildCat!) and
  6041.           DOOR.SYS.  In addition, you can write your own MECCA scripts,
  6042.           which allow you to generate a door interface file for almost any
  6043.           other system type.
  6044.  
  6045.           Maximus can achieve this through the use of the `[write]' MECCA
  6046.           token.  Although the `[open]' and `[post]' commands were
  6047.           originally used for on-line questionnaires, they serve a dual
  6048.           purpose under Maximus.  The `[write]' token will simply write a
  6049.           line of text to the previously-opened file, while making
  6050.           translations to the string, as described in the `External Program
  6051.           Translation Characters' section, above.
  6052.  
  6053.           For example, the only requirement to make Maximus write a
  6054.           QuickBBS or RBBS-compatible DORINFO1.DEF file is to copy the
  6055.           following MECCA script into a file called DORINFO.MEC, and
  6056.           compile it.  (Note!  If you are using the standard distribution
  6057.           package, then you can find this file, including the compiled .BBS
  6058.           version, in the \MAX\MISC subdirectory.)
  6059.  
  6060.           When copying this into a file, be sure to line up all of the text
  6061.           against the left margin.  Also make sure to change the [delete]
  6062.           and [open] tokens to reflect the path where you want the
  6063.           DORINFO1.DEF interface file to be placed.)
  6064.  
  6065.  
  6066.  
  6067.  
  6068.  
  6069.  
  6070.                    Maximus-CBCS v2.00 Operations Manual - Page 108
  6071.  
  6072.  
  6073.  
  6074.           [delete]C:\Max\Dorinfo1.Def
  6075.           [open]C:\Max\Dorinfo1.Def
  6076.           [write]%N               [ comment Write the BBS name]
  6077.           [write]%S               [ comment Write the SysOp's f.name]
  6078.           [write]%s               [ comment Write the SysOp's l.name]
  6079.           [islocal write]COM0     [ comment Write the COM port]
  6080.           [isremote write]COM%P   [ comment (local is always COM0)]
  6081.           [write]%b BAUD,N,8,1    [ comment Write the baud rate]
  6082.           [write] 0               [ comment Say we are not networked]
  6083.           [write]%A               [ comment Write the first name]
  6084.           [write]%B               [ comment Write the last name]
  6085.           [write]%c               [ comment Write the city]
  6086.           [write]%g               [ comment Write the graphics]
  6087.           [sequal write]100       [ comment Write the security level]
  6088.           [sxclude write]50       [ comment Ditto]
  6089.           [write]%t               [ comment Write the time remaining]
  6090.           [write]1                [ comment Say we are using a FOSSIL]
  6091.           [quit]                  [ comment And we are done!]
  6092.  
  6093.           You can create similar files for other door interface types, by
  6094.           simply creating another MECCA file containing the appropriate
  6095.           commands.  (A list of the external program translation characters
  6096.           has been provided in the prior section; however, you can use the
  6097.           above DORINFO.MEC file as a guide to designing your own door
  6098.           interface files.)
  6099.  
  6100.           There are three ways to have DORINFO1.DEF (or any of the
  6101.           above-mentioned files) created when running an external program:
  6102.  
  6103.           TO CREATE DORINFO1.DEF FROM A .MEC FILE:
  6104.  
  6105.                To have the appropriate door file created, simply include
  6106.                the following line, whenever you wish to have DORINFO1.DEF
  6107.                written:
  6108.  
  6109.                [link]C:\Max\Misc\Dorinfo
  6110.  
  6111.                As mentioned above, the distribution version of Maximus also
  6112.                comes with MECCA scripts to generate several other types of
  6113.                door interfaces.  The format for using these is similar to
  6114.                the interface described above:
  6115.  
  6116.                [link]C:\Max\Misc\WWIV        - To create CHAIN.TXT
  6117.                [link]C:\Max\Misc\CallInfo    - To create CALLINFO.BBS
  6118.                [link]C:\Max\Misc\DoorSys     - To create DOOR.SYS
  6119.  
  6120.           TO CREATE DORINFO1.DEF FROM A MENU OPTION:
  6121.  
  6122.  
  6123.  
  6124.  
  6125.                    Maximus-CBCS v2.00 Operations Manual - Page 109
  6126.  
  6127.  
  6128.  
  6129.                Similarly, you can achieve the same results through a menu
  6130.                option, by simply linking the appropriate .BBS file to the
  6131.                menu option.  (For more information, please see `Linking
  6132.                Menu Options' in the Maximus Technical Reference Manual.)
  6133.  
  6134.                For example, to create a DORINFO1.DEF file for running a
  6135.                program called `C:\Max\Prg.Exe', you would use something
  6136.                similar to the following in MENUS.CTL:
  6137.  
  6138.           NoDsp  Display_File   C:\Max\Misc\Dorinfo Twit "Run Prg.Exe"
  6139.                  Xtern_Run      C:\Max\Prg.Exe      Twit "R"
  6140.  
  6141.                Again, the same concept can also be applied to the other
  6142.                MECCA-created door scripts, by simply substituting the name
  6143.                of the script into the Display_File command.
  6144.  
  6145.           TO HAVE DORINFO1.DEF CREATED AUTOMATICALLY:
  6146.  
  6147.                If you wish to have DORINFO1.DEF written every time Maximus
  6148.                exits for an external program, for whatever reason, you can
  6149.                simply edit the `Uses Leaving' statement in MAX.CTL, such
  6150.                that it reads like this:
  6151.  
  6152.                     Uses Leaving C:\Max\Misc\Dorinfo
  6153.  
  6154.                This will instruct Maximus to create DORINFO1.DEF whenever
  6155.                Maximus runs an external program, without needing to be
  6156.                specifically instructed to.
  6157.  
  6158.           What follows is a demonstration of how to install a non- Maximus
  6159.           door in a menu file, assuming that you have NOT implemented the
  6160.           above `Uses Leaving' statement in MAX.CTL.
  6161.  
  6162.           In MENUS.CTL, you should add the following to the menu which you
  6163.           wish the door to appear on.
  6164.  
  6165.                   Display_File  Misc\DorInfo   Disgrace   "Play BoreDoor"
  6166.           NoDsp   Xtern_Dos     BD\Bore.Bat    Disgrace   "P"
  6167.  
  6168.           The `Display_File' command tells Maximus to write the
  6169.           DORINFO1.DEF file, which will always be written to the C:\MAX
  6170.           directory (unless you have changed the .MEC file).
  6171.  
  6172.           The `Xtern_Run' command tells Maximus to run the batch file
  6173.           called BD\BORE.BAT, which you'll need to create later.  (The
  6174.           `NoDsp' in front tells Maximus not to show `P' on the menu a
  6175.           second time, since you only want the first `Play BoreDoor' to be
  6176.           visible.  See the section on Linking Menu Options (in the Maximus
  6177.           Technical Reference Manual) for more details.)
  6178.  
  6179.  
  6180.                    Maximus-CBCS v2.00 Operations Manual - Page 110
  6181.  
  6182.  
  6183.  
  6184.           When a user selects `P' from the menu, Maximus will execute the
  6185.           above options in order.  That means that DORINFO1.DEF will first
  6186.           be written, followed by the execution of BORE.BAT.
  6187.  
  6188.           Although the contents of the batch file are highly specific to
  6189.           the door program you'll be running, in general, you should use a
  6190.           format similar to this, in BORE.BAT:
  6191.  
  6192.                echo off
  6193.  
  6194.                REM * Change to the right directory
  6195.                cd \Max\BD
  6196.  
  6197.                REM * Copy the DORINFO1.DEF file from the
  6198.                REM * main Maximus directory into the
  6199.                REM * current directory, which is probably
  6200.                REM * where the door program will look for
  6201.                REM * it.
  6202.                copy \Max\Dorinfo1.Def
  6203.  
  6204.                REM * This is the door program itself.  The
  6205.                REM * command-line parameters will be
  6206.                REM * specific to the door you are running, so
  6207.                REM * you should consult your door's installation
  6208.                REM * instructions for more details.
  6209.                BoreDoor
  6210.  
  6211.                REM * Now change back to the Maximus
  6212.                REM * directory.
  6213.                cd \Max
  6214.  
  6215.                REM * And exit back to Max!
  6216.                exit
  6217.  
  6218.  
  6219.  
  6220.  
  6221.  
  6222.  
  6223.  
  6224.  
  6225.  
  6226.  
  6227.  
  6228.  
  6229.  
  6230.  
  6231.  
  6232.  
  6233.  
  6234.  
  6235.                    Maximus-CBCS v2.00 Operations Manual - Page 111
  6236.  
  6237.  
  6238.  
  6239.  
  6240.           On-Line User Record Modification
  6241.  
  6242.           Some door programs may be written specifically for Maximus, and
  6243.           may need to directly change part of a user's profile (such as the
  6244.           user's remaining time, ANSI/AVATAR preference, phone number,
  6245.           etc.), even while the user is on-line.  Maximus supports this
  6246.           feature through a series of special keywords and characters,
  6247.           which cause it to re-read the LASTUSxx.BBS file after returning
  6248.           from an external program.
  6249.  
  6250.           If you are running the external program through an option in
  6251.           MENUS.CTL, then the fastest way to enable on-line modification is
  6252.           to place the `ReRead' modifier in front of the usual `Xtern_xxx'
  6253.           option.  In other words, instead of invoking the program like
  6254.           this:
  6255.  
  6256.                     Xtern_Run   D:\Path\Prog.Exe   Disgrace  "Program"
  6257.  
  6258.           you would place the following line in MENUS.CTL, which would
  6259.           enable on-line modification:
  6260.  
  6261.           ReRead    Xtern_Run   D:\Path\Prog.Exe   Disgrace  "Program"
  6262.  
  6263.           Similarly, you can perform the same operation when using the
  6264.           [xtern_xxx] MECCA tokens, by using an `@' as the first character
  6265.           in the program name.  For example, instead of using this:
  6266.  
  6267.                [xtern_run]D:\Path\Prog.Exe
  6268.  
  6269.           you would use this, instead:
  6270.  
  6271.                [xtern_run]@D:\Path\Prog.Exe
  6272.  
  6273.           However, keep in mind that most programs don't need this feature. 
  6274.           For security reasons, you should not use this feature, unless the
  6275.           external program's documentation states that on-line modification
  6276.           will be performed.
  6277.  
  6278.  
  6279.  
  6280.  
  6281.  
  6282.  
  6283.  
  6284.  
  6285.  
  6286.  
  6287.  
  6288.  
  6289.  
  6290.                    Maximus-CBCS v2.00 Operations Manual - Page 112
  6291.  
  6292.  
  6293.  
  6294.                               MULTI-LINE OPERATION GUIDE
  6295.  
  6296.           In addition to general multi-line support, Maximus 2.00 supports
  6297.           an integrated paging and inter-node chat facility, which makes it
  6298.           ideal for multi-line systems.  In addition, Maximus uses
  6299.           NetBIOS-compatible file opening calls (using the SH_DENYNONE
  6300.           attribute), which makes Maximus even more suited for network
  6301.           applications.
  6302.  
  6303.           This section is merely a guide to running Maximus in a multi-line
  6304.           environment.  Undoubtedly, there will be some problems which are
  6305.           not covered by this section, and there will be some questions
  6306.           left unanswered.  However, this section will hopefully answer
  6307.           most of the basic questions, and at least give you a head start
  6308.           on installing a multi-node version of Maximus.
  6309.  
  6310.  
  6311.           Installation
  6312.  
  6313.           Installation of a network version of Maximus is fairly similar to
  6314.           a normal installation.  Simply run the INSTALL program, and
  6315.           answer all of the questions it asks.
  6316.  
  6317.           However, there are several important things to consider:
  6318.  
  6319.           *    Normally, you'll need a SEPARATE batch file for EACH copy of
  6320.                Maximus you wish to run.  You can reduce duplication by
  6321.                moving common parts of the batch file into a separate file
  6322.                and calling it with CALL or COMMAND/C, but you'll still need
  6323.                a separate batch file for each node you wish to run. 
  6324.                However, all Max tasks can be run out of the same directory,
  6325.                so you can run everything out of \MAX.
  6326.  
  6327.                Fortunately, you only need one copy of the MAX.PRM file: 
  6328.                you can use the `-nXX' and `-lX' command line parameters to
  6329.                adjust the task number and log filenames at runtime. 
  6330.                However, you DO need to specify a separate log file for each
  6331.                task.  Naming the log Line01.Log for task 1, Line02.Log for
  6332.                task 2, and so on is a reasonably way of handling log files. 
  6333.                (If you don't want a log file for a certain node, then
  6334.                simply use the `-l' command line parameter without
  6335.                specifying a filename.)
  6336.  
  6337.                Even if you use the same .PRM file for all tasks, you can
  6338.                still display node-specific files to the user through the
  6339.                use of the `*' token.  When display a .BBS file, `*'
  6340.                translates into the current two-digit task number, zero-
  6341.                padded and in hexadecimal.  For example, if you specified
  6342.                `D:\Max\Misc\Welcom*' as the welcome file in MAX.CTL,
  6343.  
  6344.  
  6345.                    Maximus-CBCS v2.00 Operations Manual - Page 113
  6346.  
  6347.  
  6348.  
  6349.                Maximus would display WELCOM01.BBS for task 1, WELCOME02.BBS
  6350.                for task 2, and so on.
  6351.  
  6352.  
  6353.                Advanced users:  Actually, it's possible to run multiple
  6354.                copies of Max with only one batch file.  If you set an
  6355.                environment variable to equal the current node number, you
  6356.                can use that variable as a replaceable parameters in a
  6357.                single batch file.  However, this requires a bit of
  6358.                knowledge about DOS, so it is not recommended for normal
  6359.                users.
  6360.  
  6361.           *    When setting up your batch files, you should make sure that
  6362.                ALL copies of Maximus are started from the same directory. 
  6363.                This will allow you to share some files between nodes, in
  6364.                addition to providing a cleaner directory structure.
  6365.  
  6366.           *    If you are part of FidoNet, you may want to run a mailer on
  6367.                one line only.  Fortunately, the internal WFC module can be
  6368.                used on a node-by-node basis with the same set of control
  6369.                files.  For more information on using WFC, please see the
  6370.                section of the installation entitled "Support for Remote
  6371.                Callers".
  6372.  
  6373.           *    When looking for a compatible FOSSIL, it may take a bit of
  6374.                work to find one that runs correctly under your network
  6375.                software.  If you are having mysterious communications
  6376.                problems, then try switching to a different FOSSIL.  There
  6377.                are at least three different types for the IBM PC, so you
  6378.                should have no problem finding one which works with your
  6379.                hardware.
  6380.  
  6381.           *    In your AUTOEXEC.BAT, you may wish to include commands to
  6382.                delete ACTIVE*.BBS and UTASK*.* from the main Maximus
  6383.                directory, and IPC*.BBS from the inter-process
  6384.                communications directory.  These are temporary files created
  6385.                by Maximus during execution, so they should not be left
  6386.                lying around.  If you need to restart the network while
  6387.                Maximus is running, these files won't get deleted which may
  6388.                cause future problems.  To fix this, you should include the
  6389.                above-mentioned delete commands in your AUTOEXEC.BAT to make
  6390.                sure that you start with a clean slate whenever you reboot. 
  6391.                (In the case of a network, the delete commands should be
  6392.                placed in the server's AUTOEXEC.BAT.  If you are running
  6393.                DESQview or some other multitasker on a single node, then
  6394.                you can also place those statements in your main
  6395.                AUTOEXEC.BAT.)
  6396.  
  6397.  
  6398.  
  6399.  
  6400.                    Maximus-CBCS v2.00 Operations Manual - Page 114
  6401.  
  6402.  
  6403.  
  6404.           *    If you wish to use either of the multi-node chat or the
  6405.                paging features, your operating system must support file and
  6406.                record locking.  Under DOS, this means that you must load
  6407.                the DOS "SHARE" program.  Under OS/2, file locking is built
  6408.                into the operating system, so no special utilities are
  6409.                necessary.  Although it is possible to use Maximus in a
  6410.                multi-node environment without loading SHARE (through the
  6411.                `No Share.Exe' option in MAX.CTL), this is strongly
  6412.                discouraged, and no guarantees are made if you don't load
  6413.                SHARE.
  6414.  
  6415.           *    Make sure that all copies of Max have a unique and NON-ZERO
  6416.                task number.  If the task number is set to zero, Maximus
  6417.                will assume that you are running in a single-node
  6418.                environment, and won't bother to check the inter-process
  6419.                communications area.  In fact, none of the multi-node
  6420.                features will work if you are using a task number of zero.
  6421.  
  6422.  
  6423.           Multi-Node Chat Operation
  6424.  
  6425.           The main way in which Maximus takes advantage of multiple lines
  6426.           is through the integrated multi-node chat and paging facility. 
  6427.           These features are much like those found in the commercial
  6428.           PCBoard and TBBS programs and are just as flexible.  Users can
  6429.           toggle whether or not they can be paged by others, they can
  6430.           display a list of who is on-line, and they can actually enter
  6431.           into a real-time conversation with other callers.
  6432.  
  6433.           The first step in configuring the multi-node chat is to enable
  6434.           the `Path IPC' statement in MAX.CTL.  (Make sure to follow the
  6435.           instructions in the `Path IPC' description about installing
  6436.           SHARE.EXE and creating a RAM disk!)
  6437.  
  6438.           The second step is to edit MENUS.CTL and uncomment the
  6439.           Display_Menu option which calls the CHAT menu.  Although you can
  6440.           use a custom MenuFile for the chat section, it is best to leave
  6441.           this for later, and use the built-in `MenuHeader Chat' for now. 
  6442.           You can worry about tweaking the cosmetics once everything is
  6443.           running smoothly.
  6444.  
  6445.           Having changed MENUS.CTL, the only remaining step is to recompile
  6446.           the control files.  But before allowing users to call the system,
  6447.           you should first test it yourself, by logging onto two nodes
  6448.           locally.  (You'll have to use two different user names, since
  6449.           Maximus will only let one user hog one node at a time.)
  6450.  
  6451.           Before testing the chat mode itself, enter the Chat Section, and
  6452.           look at the menu display.  The table should show the node number
  6453.  
  6454.  
  6455.                    Maximus-CBCS v2.00 Operations Manual - Page 115
  6456.  
  6457.  
  6458.  
  6459.           which you are logged on to (including your name, and the `(you)'
  6460.           designation), in addition to the same information about the
  6461.           second node.  (If there is no display, check to make sure that
  6462.           you have implemented the `Path IPC' keyword, and that it points
  6463.           to a valid drive and directory.  Another possibility is that you
  6464.           have forgotten to load SHARE.EXE.)
  6465.  
  6466.           If the menu display seems to be in order, the next step it to try
  6467.           toggling your chat availability a few times.  After your status
  6468.           has been toggled, the table should indicate whether or not you
  6469.           are available for chat, in the `Status' portion of the table. 
  6470.           You can also check that the other node was informed of the
  6471.           change, by simply entering the Chat Section on the second node,
  6472.           and looking at the table on that system.
  6473.  
  6474.           Finally, after you have confirmed that everything else is
  6475.           working, you can enter the multi-node chat itself.  To initiate a
  6476.           chat, select the P)age option.  Then enter the number of the
  6477.           other node you have logged onto, and wait for the chat request to
  6478.           register.  (This should take no longer than about 15 seconds.)
  6479.  
  6480.           After you have paged the user, you should see a `You are being
  6481.           paged by Joe SysOp (node XX)' message on the other node.  This is
  6482.           the canned page message; to modify it, you can either edit the
  6483.           ENGLISH.MAD language file, or you can create a
  6484.           \MAX\MISC\CHATPAGE.MEC file.  (For information on the latter, see
  6485.           the section on hardcoded filenames.)
  6486.  
  6487.           To answer the chat request, simply select the A)nswer Page option
  6488.           and enter the node number of the user who sent the request.  This
  6489.           should place you inside chat mode:  the other user should see a
  6490.           `User Name joins the conversation' message, which indicates that
  6491.           the other user answered the chat request.
  6492.  
  6493.           The user who answered the page won't see anything immediately; to
  6494.           find out who is participating in the conversation, you can simply
  6495.           type a `/w' command at the beginning of a line, and Maximus will
  6496.           display the list of callers on the same channel.  To list all of
  6497.           the callers on the system, whether or not they re in chat, type
  6498.           '/s'.
  6499.  
  6500.           Once in chat, users can send messages to each other by simply
  6501.           typing the text that they wish to send.  Maximus will
  6502.           automatically word-wrap at the end of lines, and the text will be
  6503.           transmitted one line at a time.  If possible, it's best to try
  6504.           typing a few times from each node to make sure that the chat
  6505.           function is working properly.
  6506.  
  6507.  
  6508.  
  6509.  
  6510.                    Maximus-CBCS v2.00 Operations Manual - Page 116
  6511.  
  6512.  
  6513.  
  6514.           Once you are finished testing, you can use the `/q' command on
  6515.           each node to exit chat mode.  (When a node exits chat, the other
  6516.           nodes participating in the same chat should see a `User Name
  6517.           leaves the conversation' message.)
  6518.  
  6519.           In addition to the private chat facility (which is what you just
  6520.           tested), Maximus also supports a group chat, or a `virtual CB'
  6521.           chat.  The CB chat is useful when you have three or more nodes,
  6522.           and want to have more than two callers in one conference. 
  6523.           Maximus supports 255 concurrent `channels', which means that
  6524.           there can be up to 255 separate group conversations going on at
  6525.           the same time.  However, the CB chat has no paging ability; it's
  6526.           up to the callers to look at the status screen in the Chat
  6527.           Section, and see which channel everyone else is using.
  6528.  
  6529.           Aside from the differences in invoking the CB chat, once you get
  6530.           inside the chat mode itself, Maximus will behave just as it does
  6531.           inside the private chat, even using the same commands.  For more
  6532.           information on using Max's multi-line chat, please see the chat
  6533.           help file, included in the Maximus distribution package. 
  6534.           (Assuming a standard system, the help file is accessible using
  6535.           the `?' command from the chat menu, or through the `/?' command
  6536.           inside chat mode.)
  6537.  
  6538.  
  6539.  
  6540.  
  6541.  
  6542.  
  6543.  
  6544.  
  6545.  
  6546.  
  6547.  
  6548.  
  6549.  
  6550.  
  6551.  
  6552.  
  6553.  
  6554.  
  6555.  
  6556.  
  6557.  
  6558.  
  6559.  
  6560.  
  6561.  
  6562.  
  6563.  
  6564.  
  6565.                    Maximus-CBCS v2.00 Operations Manual - Page 117
  6566.  
  6567.  
  6568.  
  6569.                                   USING CUSTOM MENUS
  6570.  
  6571.           Maximus allows you to create custom menus with relative ease:
  6572.           simply insert a `MenuFile' command in the appropriate section of
  6573.           MENUS.CTL, and you are done.  However, there are several tips and
  6574.           tricks you may find useful when designing custom menus,
  6575.           especially when using fancy ANSI or AVATAR graphics.
  6576.  
  6577.           *    When using a menu which contains a `[cls]' MECCA token,
  6578.                you'll notice that output from some of the internal commands
  6579.                (such as Version or Statistics) disappears, since the [cls]
  6580.                command in the menu erases it, before it can be seen by the
  6581.                user.  The solution for this is to link a `Press_Enter' menu
  6582.                option after the appropriate command, which will cause
  6583.                Maximus to wait until the user presses <enter>, before
  6584.                re-displaying the menu.  (For more details, see the section
  6585.                entitled `Linking Menu Options' in the Maximus Technical
  6586.                Reference Manual.)  For example, to make Maximus wait after
  6587.                displaying the user's statistics, you might use something
  6588.                like this:
  6589.  
  6590.                     Statistics     Disgrace  "Statistics"
  6591.           NoDsp     Press_Enter    Disgrace  "S"
  6592.  
  6593.           *    If you are using a custom MenuFile statement in the message
  6594.                or file areas, you should never disable the MenuHeader
  6595.                statement.  If all you want to do is to suppress the
  6596.                'MESSAGE Section' banner and statistics information, use
  6597.                "SilentMenuHeader Message" or "SilentMenuHeader File"
  6598.                instead of the equivalent MenuHeaders.  This will cause the
  6599.                appropriate menu processing to take place, but nothing will
  6600.                be displayed on-screen.
  6601.  
  6602.                However, if you REALLY need to disable even the
  6603.                SilentMenuHeaders, for whatever reason, you must modify your
  6604.                MenuFile to compensate for this.  Due to the flexible way
  6605.                that Maximus handles menus, you need to inform the menu
  6606.                handler that a particular menu represents a message/file
  6607.                area so it can read certain pieces of information from
  6608.                AREA.DAT.  Since the MenuHeader statement usually informs
  6609.                Maximus of this, disabling it will make Maximus think that
  6610.                the menu just represents a normal area.  The solution for
  6611.                this is to place either the `[message]' and `[file]' MECCA
  6612.                tokens at the top of the custom MenuFile, depending on the
  6613.                type of area (message or file) you want the menu to
  6614.                represent.  These tokens must be used before any of the
  6615.                message- specific tokens (such as `[msg_cname]') are used. 
  6616.                The [message] or [file] token only needs to be used when a
  6617.                message area is first entered - this means that you can
  6618.  
  6619.  
  6620.                    Maximus-CBCS v2.00 Operations Manual - Page 118
  6621.  
  6622.  
  6623.  
  6624.                place the [message] or [file] token in the custom HeaderFile
  6625.                as well, although it will work equally well in the MenuFile.
  6626.  
  6627.           *    When designing a custom menu with an input prompt at the
  6628.                bottom, you may have some trouble getting the cursor to stop
  6629.                at the appropriate place.  Most text editors automatically
  6630.                insert a carriage return after the last line of the file,
  6631.                and since Maximus reads the entire file, this will cause the
  6632.                cursor to skip down to the next line after the entire file
  6633.                is displayed.  There are two solutions to this: the first is
  6634.                to use a text editor that DOESN'T insert a carriage return
  6635.                at the end of the file.  The other solution, if you are
  6636.                using a .MEC file to create the menu, is to insert a
  6637.                `[quit]' token where you want the cursor to stop.  As soon
  6638.                as Maximus encounters this token, it will stop displaying
  6639.                the file, without displaying an extra carriage return.  On
  6640.                the other hand, if you are creating the MenuFile manually,
  6641.                you can insert the compiled equivalent directly into the
  6642.                text, which is `^oQ'.  (Control-O and then a capital letter
  6643.                `Q'.).  This has the same affect as would the [quit] token,
  6644.                and this token will caused Maximus to behave in the desired
  6645.                fashion.
  6646.  
  6647.  
  6648.  
  6649.  
  6650.  
  6651.  
  6652.  
  6653.  
  6654.  
  6655.  
  6656.  
  6657.  
  6658.  
  6659.  
  6660.  
  6661.  
  6662.  
  6663.  
  6664.  
  6665.  
  6666.  
  6667.  
  6668.  
  6669.  
  6670.  
  6671.  
  6672.  
  6673.  
  6674.  
  6675.                    Maximus-CBCS v2.00 Operations Manual - Page 119
  6676.  
  6677.  
  6678.  
  6679.                              WAITING FOR CALLER SUBSYSTEM
  6680.  
  6681.           Max 2.00 supports an internal Waiting for Caller (WFC) module. 
  6682.           This module allows Max to initialize the modem, wait for a call,
  6683.           answer the phone, and pass control to the main BBS.  WFC can be
  6684.           used on all nodes of a system, on selected nodes, or on no nodes. 
  6685.           Nodes which do NOT use WFC will require an external program to
  6686.           answer the phone, such as BinkleyTerm or FrontDoor.
  6687.  
  6688.  
  6689.           Starting WFC
  6690.  
  6691.           The WFC module is activated with the `-w' command line switch. 
  6692.           Optionally, the `-p' and `-b' switches can be used to override
  6693.           the starting com port and baud rate.  If you specify just `-w',
  6694.           WFC will start up using the com port and baud rate specified in
  6695.           the control file.
  6696.  
  6697.           Before using WFC, you must make sure that the modem strings in
  6698.           MAX.CTL are configured correctly.  The distribution version of
  6699.           Max comes with a modem configuration which supports most Hayes-
  6700.           compatible modems.  However, if the WFC module doesn't work out
  6701.           of the box, you may have to fiddle with certain strings (such as
  6702.           the "Answer" and "Init" strings) to make it perform as expected.
  6703.  
  6704.           In particular, the distribution MAX.CTL defaults to using "manual
  6705.           answer".  This means that, instead of telling the modem to
  6706.           automatically answer the phone when it detects a ring, Max will
  6707.           take care of ring checking itself.  This means that the phone
  6708.           will only be answered when Max is ready to take a call, which is
  6709.           the preferred method of doing things.
  6710.  
  6711.           However, this manual phone answering may not be compatible with
  6712.           all systems.  If you wish to disable manual answering, change the
  6713.           last part of the Init string to read "S0=1" instead of "S0=0",
  6714.           and comment out the "Answer" string.  This will instruct your
  6715.           modem to answer the phone automatically, which may work better on
  6716.           several brands of semi-compatible modems.
  6717.  
  6718.  
  6719.           Screen Display and SysOp Keys
  6720.  
  6721.           When WFC starts up, assuming that you are using Video IBM or
  6722.           Video BIOS, you will see four multicolored windows displayed on
  6723.           the screen.
  6724.  
  6725.           The first window, "Status", gives you the time until the next
  6726.           event, the current modem status, the number of calls made to your
  6727.  
  6728.  
  6729.  
  6730.                    Maximus-CBCS v2.00 Operations Manual - Page 120
  6731.  
  6732.  
  6733.  
  6734.           system (both today and in total), and the name of the last caller
  6735.           on your system.
  6736.  
  6737.           The second window, "Modem Responses", displays a scrolling list
  6738.           of past responses from the modem.  In this window, Max will print
  6739.           out result codes send from the modem.
  6740.  
  6741.           The third window, "Current Activity", is a scrolling window which
  6742.           displays log messages as they appear.
  6743.  
  6744.           The fourth window, "SysOp Keys", contains descriptions for all of
  6745.           the keys which can be pressed while in WFC mode.
  6746.  
  6747.           Pressing <Alt-K> will start a local copy of the BBS.  Maximus
  6748.           will take the phone off-hook and then commence the normal log-on
  6749.           procedure.
  6750.  
  6751.           Pressing <Alt-J> will start an OS shell.  You can do file
  6752.           maintenance, make changes to your batch files, or perform other
  6753.           small changes while in the shell.  Type `exit' to return to
  6754.           Maximus.  Maximus will take the modem off-hook while you are in
  6755.           the shell.
  6756.  
  6757.           Pressing <Alt-X> will take the system down.  Max will put the
  6758.           phone off-hook, clear the screen, and exit to your batch file
  6759.           with errorlevel 1.
  6760.  
  6761.           For more information on installing WFC, please see the section in
  6762.           the installation entitled "Supporting Remote Callers".
  6763.  
  6764.           When using the internal WFC, Max can also handle "external
  6765.           events".  External events are used to run a particular program at
  6766.           a given time, usually by exiting to your batch file with an
  6767.           errorlevel.  Events are covered in detail in the EVENTS.BBS
  6768.           section of the Maximus Technical Reference Manual.
  6769.  
  6770.  
  6771.  
  6772.  
  6773.  
  6774.  
  6775.  
  6776.  
  6777.  
  6778.  
  6779.  
  6780.  
  6781.  
  6782.  
  6783.  
  6784.  
  6785.                    Maximus-CBCS v2.00 Operations Manual - Page 121
  6786.  
  6787.  
  6788.  
  6789.                             EXPIRATION/SUBSCRIPTION SYSTEM
  6790.  
  6791.           Maximus supports a full-fledged user subscription and expiry
  6792.           system.  Callers can be set to "expire" based on the current date
  6793.           or time used (in minutes).  When a caller expires, Max can
  6794.           optionally demote that caller to a lower priv level, hang up, or
  6795.           delete that user's account.
  6796.  
  6797.           To access the user subscription system, start up the Max user
  6798.           editor with "max -u".  Until you get the hang of Max's
  6799.           subscription system, create a new user for testing purposes. 
  6800.           (The "A" key will append a blank record to the end of the user
  6801.           file.)
  6802.  
  6803.           To create a subscriber, first select the "," key; this allows you
  6804.           to set the "expire by" field.  If you want the user's account to
  6805.           expire after a certain date, select "D".  If you want the user's
  6806.           account to expire after a certain number of minutes, press "M". 
  6807.           If you don't want the user to expire at all, press "N".
  6808.  
  6809.           Next, press "." to set the expiry action field.  If you want Max
  6810.           to hang up and delete that user's account, press "A".  If you
  6811.           want Max to demote that user to a lower priv level, press "D" and
  6812.           enter the priv level.  If you don't want any action to take
  6813.           place, press "N".
  6814.  
  6815.           Finally, press "<" to set the expiry date/time.  If you selected
  6816.           DATE for the "expire by" field, you can enter the expiry date of
  6817.           the user here.  Otherwise, if you selected MINUTES, you can enter
  6818.           the number of on-line minutes to give the specified user.
  6819.  
  6820.           After setting up the expiry controls for a user, the subscription
  6821.           system is completely self-maintaining.  If a user expires, that
  6822.           user's account will be modified accordingly whenever that user
  6823.           logs on again.
  6824.  
  6825.           In addition, when a user expires due to the current date, the
  6826.           file \MAX\MISC\XPDATE.BBS will be shown.  When a user expires due
  6827.           to running out of minutes, the file \MAX\MISC\XPTIME.BBS will be
  6828.           shown.
  6829.  
  6830.  
  6831.  
  6832.  
  6833.  
  6834.  
  6835.  
  6836.  
  6837.  
  6838.  
  6839.  
  6840.                    Maximus-CBCS v2.00 Operations Manual - Page 122
  6841.  
  6842.  
  6843.  
  6844.                                  MULTILINGUAL SUPPORT
  6845.  
  6846.           Maximus 2.00 includes full-fledged multilingual support.  Up to
  6847.           eight different languages can be defined in MAX.CTL, and users
  6848.           can switch to any of these languages at any time.  The language
  6849.           files themselves encompass almost everything that Max displays to
  6850.           the user, including prompts, system messages and command keys.  A
  6851.           separate language file can be created to use Oui and Non instead
  6852.           of Yes and No; even the keystrokes for various options can be
  6853.           changed.
  6854.  
  6855.           Language files are divided into two distinct sections.  Each
  6856.           language file has a set of strings to be displayed to the USER,
  6857.           and each also has a second set of strings to be displayed to the
  6858.           SYSOP.  By default, the SysOp interface always uses the FIRST
  6859.           language file defined in LANGUAGE.CTL, regardless of the language
  6860.           currently in use by the user.  This means that the user can be
  6861.           walking through the menus in German, but the SysOp will still be
  6862.           able to read the pop-up menus in English.  Max also comes with a
  6863.           second language file, AMERICAN.MAD, which was modified to handle
  6864.           certain American spellings.
  6865.  
  6866.           Max's multilingual support can be used to define different
  6867.           prompts, menus and custom display files for each individual
  6868.           language.  Prompts are all handled by the language file itself,
  6869.           simply by editing the appropriate <langname>.MAD file.  However,
  6870.           menus must be specially designed by the SysOp, since a separate
  6871.           set of menus should normally be used for each language. 
  6872.           Likewise, most display files should be changed to accommodate
  6873.           each new language.
  6874.  
  6875.           The principal method of supporting alternate menus and display
  6876.           files is through the "%Y" external program translation character. 
  6877.           The "%Y" character translates to the user's current language
  6878.           number, with 0 being the FIRST language defined in MAX.CTL, 1
  6879.           being the second, and so on.  "%Y" can be used in many places,
  6880.           including the "First Menu" option in MAX.CTL, all Display_Menu
  6881.           options, and also as "+Y" in all Display_File commands.  The
  6882.           careful placement of the "%Y" token can be used to handle most of
  6883.           Max's multilingual support.
  6884.  
  6885.           For example, if you had the following language statements in
  6886.           LANGUAGE.CTL:
  6887.  
  6888.                Language  English
  6889.                Language  Sanskrit
  6890.  
  6891.           using a "First Menu MAIN%Y" statement in MAX.CTL would cause
  6892.           "MAIN0" to be displayed for callers who selected the English
  6893.  
  6894.  
  6895.                    Maximus-CBCS v2.00 Operations Manual - Page 123
  6896.  
  6897.  
  6898.  
  6899.           language, and "MAIN1" would be shown to callers who selected the
  6900.           Sanskrit language.
  6901.  
  6902.           This methodology can also be applied to display files; you can
  6903.           either use a "Display_File D:\Path\File%Y" to display different
  6904.           physical files, or the "[iflang]" MECCA token can be used within
  6905.           an individual display file to make decisions based on the current
  6906.           language.
  6907.  
  6908.           By default, Max stores a user's language preference in the user
  6909.           file.  However, if you want Max to prompt the user for a new
  6910.           language each time he/she logs on, you can do this by placing the
  6911.           token "[menu_cmd chg_language]" at the top of WELCOME.MEC.
  6912.  
  6913.  
  6914.  
  6915.  
  6916.  
  6917.  
  6918.  
  6919.  
  6920.  
  6921.  
  6922.  
  6923.  
  6924.  
  6925.  
  6926.  
  6927.  
  6928.  
  6929.  
  6930.  
  6931.  
  6932.  
  6933.  
  6934.  
  6935.  
  6936.  
  6937.  
  6938.  
  6939.  
  6940.  
  6941.  
  6942.  
  6943.  
  6944.  
  6945.  
  6946.  
  6947.  
  6948.  
  6949.  
  6950.                    Maximus-CBCS v2.00 Operations Manual - Page 124
  6951.  
  6952.  
  6953.  
  6954.                                    QWK MAIL PACKER
  6955.  
  6956.           Through the reader menu, Max allows users to download mail for
  6957.           off-line reading.  Max supports the popular QWK format, so
  6958.           readers such as Deluxe2, Qmail, SLMR and OFFLINE can all be used
  6959.           to read the downloaded mail packets.
  6960.  
  6961.  
  6962.           Configuration
  6963.  
  6964.           The QWK mail packer is largely self-maintaining, since it uses
  6965.           most of the Max configuration files to a full extent.  However,
  6966.           you do have to edit READER.CTL at least once to configure it for
  6967.           your system.
  6968.  
  6969.           The first keyword to change is the "Packet Name" option.  You
  6970.           should set this to a name describing your BBS, eight characters
  6971.           or less, with no spaces.  Maximus will use this as the base
  6972.           filename when sending QWK mail packets.
  6973.  
  6974.           You should also configure your phone number properly, and also
  6975.           make sure that you have all of the archivers defined in
  6976.           COMPRESS.CFG.
  6977.  
  6978.           For more information on configuring the QWK mail packer, please
  6979.           see the section in the installation entitled "Configuring the QWK
  6980.           Mail Packer".
  6981.  
  6982.  
  6983.           Bulletins, News Files and File Lists
  6984.  
  6985.           In addition to mail, the QWK format also supports bulletins, news
  6986.           files and new file lists.  Max supports these files in an
  6987.           extremely simple manner; anything which exists in the \MAX\OLR
  6988.           directory will be packed up with each mail packet.
  6989.  
  6990.           The QWK format defines several standard files which will be
  6991.           displayed to the user.  To use these features, simply place a
  6992.           file with the specified name(s) in the \MAX\OLR directory.
  6993.  
  6994.           HELLO          Displayed when the reader first starts up.  This
  6995.                          is typically the equivalent of your WELCOME.BBS
  6996.                          screen.  This should be ANSI only; no AVATAR or
  6997.                          MECCA codes allowed.
  6998.  
  6999.           NEWS           Your BBS news file.  This is usually available as
  7000.                          an option from the QWK reader's main menu.  This
  7001.                          is normally a flat ASCII with no graphics.
  7002.  
  7003.  
  7004.  
  7005.                    Maximus-CBCS v2.00 Operations Manual - Page 125
  7006.  
  7007.  
  7008.  
  7009.           GOODBYE        Displayed when the reader closes the packet from
  7010.                          your BBS.  This file can include ANSI graphics.
  7011.  
  7012.           BLT-1.1        Bulletin file 1.  This is usually displayed as an
  7013.                          option on the reader's main menu.  In this case,
  7014.                          the file extension is ".1", but you can use
  7015.                          anything from ".1" to ".99" to provide up to 99
  7016.                          different bulletins.
  7017.  
  7018.           NEWFILES.DAT   This file can contain a new files listing for your
  7019.                          BBS.  Max won't generate this for you, but it's
  7020.                          easy to have your file list generator create a
  7021.                          copy of a new files list in the off-line reader
  7022.                          directory.
  7023.  
  7024.           Again, all of these files are optional.  However, since Max packs
  7025.           up everything in the \MAX\OLR directory when creating a packet
  7026.           for the remote system, simply placing one of the above files in
  7027.           that directory will cause it to be displayed on the remote side.
  7028.  
  7029.  
  7030.           Remote Message Packing
  7031.  
  7032.           The default Max configuration includes an "off-line reader" menu,
  7033.           but mail can also be packed from the regular message menu.  All
  7034.           of the QWK mail packing functionality is built into the Browse
  7035.           command; in fact, the "Download" command on the reader menu is a
  7036.           simple macro which invokes the Browse command.
  7037.  
  7038.           The default Download command passes the options "t/n/p" to
  7039.           Browse.  This requests a scan of T)agged areas, N)ew messages,
  7040.           and P)ack in QWK format.  Obviously, with the flexibility of the
  7041.           Browse command, many more operations can be performed.  A
  7042.           selective download can be performed by using the search function
  7043.           (complete with AND/OR operators), and messages could be packed
  7044.           from only the current area, as opposed to all areas on the
  7045.           system.  Since the QWK packer is seamlessly integrated with the
  7046.           rest of the Browse logic, an infinite number of combinations are
  7047.           possible.
  7048.  
  7049.           When selecting the Pack option from the Browse menu, Max will
  7050.           gather all of the specified messages, print out how many it
  7051.           captured, and find out if the user wants to download them.  If
  7052.           so, Max will compress the packet with the user's default
  7053.           archiving program, count to ten (giving the user a chance to
  7054.           abort), and then send the file using the default transfer
  7055.           protocol.
  7056.  
  7057.  
  7058.  
  7059.  
  7060.                    Maximus-CBCS v2.00 Operations Manual - Page 126
  7061.  
  7062.  
  7063.  
  7064.           The reader menu also includes an upload option; this allows the
  7065.           user to upload a .REP file (created by one of the off-line
  7066.           readers).  This .REP file will be decompressed based on the
  7067.           information given in COMPRESS.CFG, and messages contained within
  7068.           will be tossed to the appropriate message areas.
  7069.  
  7070.  
  7071.           Local Mail Packing
  7072.  
  7073.           In addition to remote use, the QWK routines can also be used in
  7074.           local mode.  After compressing a packet, Max will simply leave
  7075.           the packed QWK file in the off-line reader directory.  (By
  7076.           default, the file will be in the \MAX\OLR\NODExx\ directory,
  7077.           where 'xx' is the current task number).  Max normally deletes the
  7078.           QWK file after it's sent, but Max will leave it there for a local
  7079.           session.
  7080.  
  7081.           In local mode, if you want to "upload" a .REP packet, select the
  7082.           Upload option from the reader menu.  If the caller is local, Max
  7083.           will prompt for the path and filename of the .REP packet.  Enter
  7084.           the location of the packet (as created by your off-line reader),
  7085.           and Max will then decompress and toss that packet.
  7086.  
  7087.  
  7088.           Unattended Mail Packing ("Vacation Saver")
  7089.  
  7090.           In conjunction with the "-j" command-line parameter, local mail
  7091.           packing is an important feature.  At predefined intervals, you
  7092.           can set up your batch files to call Max with the "-j" command
  7093.           line switch.  This switch can be used to log on as a certain
  7094.           user, execute a download command, log off, and have your batch
  7095.           files copy the created QWK packet to a file area.
  7096.  
  7097.           By doing this, you can pack mail "in advance" for certain users,
  7098.           or use it to save mail for yourself while you are on vacation. 
  7099.           Since the packing process is completely controlled by the
  7100.           keystrokes you specify for the -j switch, almost any type of mail
  7101.           download is possible.
  7102.  
  7103.           For example, if the keystrokes required to get from the main menu
  7104.           to the reader menu, download a packet and log off were
  7105.           "n;o;d;y;m;g", the following command-line would automatically
  7106.           start up Max, pack mail for the specified user, and then log off.
  7107.  
  7108.                max "-jJoe User;Y;Password;n;o;d;y;m;g"
  7109.  
  7110.           Note!  If your log-on sequence includes a "Press ENTER to
  7111.           continue" prompt, you should use the "|" character where you
  7112.           would normally press the <enter> key.
  7113.  
  7114.  
  7115.                    Maximus-CBCS v2.00 Operations Manual - Page 127
  7116.  
  7117.  
  7118.  
  7119.           In addition, you can create multiple lines in your batch file for
  7120.           multiple users, as long as you remember to copy the packet from
  7121.           \MAX\OLR\NODExx into a safe place after each mail pack.
  7122.  
  7123.  
  7124.           NetMail Messages
  7125.  
  7126.           Since the QWK format was not designed with NetMail messages in
  7127.           mind, you must follow a special convention when reading and
  7128.           replying to NetMail messages in a QWK reader.  When you download
  7129.           messages from your NetMail area, the first line of each message
  7130.           will look like this:
  7131.  
  7132.           From: <addr>
  7133.  
  7134.           where <addr> is the 4D network address of the sender.  Since
  7135.           there's no place in the QWK header to store the origination
  7136.           address, Max places this information in the message body instead.
  7137.  
  7138.           If you wish to create or reply to a NetMail message, Max expects
  7139.           to see a "To: <addr>" line as the FIRST line in the message body. 
  7140.           For example, to send a NetMail message to 1:123/456, the first
  7141.           line of your message should look like this:
  7142.  
  7143.           To: 1:123/456
  7144.  
  7145.           Note that the "To:" text will be stripped before the message is
  7146.           written to the Max message base, so your QWK messages will look
  7147.           like normal messages to everyone else.
  7148.  
  7149.           When replying to a message, there's an easy way to set the
  7150.           destination address; simply quote the original message, then
  7151.           change the "From:" line to a "To:" (after removing any quoting
  7152.           marks).  This ensures that the destination address is correct,
  7153.           and Max will make sure that you reply is sent to its intended
  7154.           destination.
  7155.  
  7156.  
  7157.  
  7158.  
  7159.  
  7160.  
  7161.  
  7162.  
  7163.  
  7164.  
  7165.  
  7166.  
  7167.  
  7168.  
  7169.  
  7170.                    Maximus-CBCS v2.00 Operations Manual - Page 128
  7171.  
  7172.  
  7173.  
  7174.                               MISCELLANEOUS INFORMATION
  7175.  
  7176.           This chapter is for miscellaneous information which didn't fit
  7177.           anywhere else in this documentation.
  7178.  
  7179.  
  7180.           Filename Specifications
  7181.  
  7182.           Wherever you specify a filename, make sure to specify a FULL
  7183.           path, including drive specifier and leading backslash.  For speed
  7184.           reasons, Maximus changes the current directory as it executes. 
  7185.           This mean that you can never assume anything about the current
  7186.           directory.  SILT will try to compensate for this, but cannot do
  7187.           so in all circumstances.
  7188.  
  7189.  
  7190.           Hard-Coded Filenames
  7191.  
  7192.           Maximus uses several hard-coded filenames, whose names are not
  7193.           changeable:
  7194.  
  7195.                <areaname>.DSC:  For Squish areas only. This file will be
  7196.                displayed to a user when entering an area, only if that
  7197.                user's lastread pointer is set to zero.  This is useful for
  7198.                giving a brief description of a message area, including the
  7199.                topics allowed and other appropriate information.  For *.MSG
  7200.                areas, see DESCRIPT.BBS.
  7201.  
  7202.                <areaname>.SQR:  For Squish areas only.  This file can be
  7203.                placed in the subdirectory containing the messages for that
  7204.                area.  <areaname> is the same as the name for the Squish
  7205.                message database (defined by Matrix, Local, Echomail, or
  7206.                Conference keyword in MSGAREA.CTL).  It will be displayed to
  7207.                callers each time they enter a message area.  For *.MSG
  7208.                areas, see RULES.BBS.
  7209.  
  7210.                <areaname>.SQX:  For Squish areas only.  This file will be
  7211.                displayed to a user who attempts to enter a message in a
  7212.                read-only area.
  7213.  
  7214.                ACTIVExx.BBS:  This file is created by Maximus whenever a
  7215.                user logs onto a given node.  'xx' is the hexadecimal task
  7216.                number of the node in question.  This file will be deleted
  7217.                when the user logs off.
  7218.  
  7219.                ATTRIB.BBS:  This is the file displayed to users who press a
  7220.                "?" at the attribute prompt in the full-screen message entry
  7221.                header.  This file explains the various attributes
  7222.  
  7223.  
  7224.  
  7225.                    Maximus-CBCS v2.00 Operations Manual - Page 129
  7226.  
  7227.  
  7228.  
  7229.                available, such as private, crash, hold, and so on.  This
  7230.                file is located in the \MAX\MISC directory.
  7231.  
  7232.                BADUSER.BBS:  If a file named BADUSER.BBS resides in the
  7233.                main Maximus directory, Maximus can use it as a screen when
  7234.                a new user logs on, to keep out users with unwanted names. 
  7235.                This file is a simple ASCII text file, containing a list of
  7236.                names not to be allowed on the BBS, one to a line.  Each
  7237.                name listed in the file will be matched to either the first,
  7238.                last, or the entire name of the user.  If Maximus finds a
  7239.                match, then it will try to display a file called
  7240.                BAD_USER.BBS in your miscellaneous directory, and then hang
  7241.                up.  This file should be located in the \MAX directory.
  7242.  
  7243.                BLT-1.1 - BLT-1.99:  Bulletins to be displayed to the users
  7244.                of the QWK packer.  Please see the section entitled "QWK
  7245.                Mail Packer" for more information.  This file should be
  7246.                located in the \MAX\OLR directory.
  7247.  
  7248.                BROWSE.BBS:  The help file for the Browse command.  This
  7249.                file should be located in the \MAX\MISC directory.
  7250.  
  7251.                CHATHELP.BBS:  This is the help file which will be displayed
  7252.                inside the multi-node chat.  It is located in the Maximus
  7253.                MISC\ directory.
  7254.  
  7255.                CHATPAGE.BBS:  This file is displayed to the user when a
  7256.                chat request is received from another node.  Maximus will
  7257.                display the "You are being paged ..." message first,
  7258.                followed by this file.  For example, this file could be used
  7259.                to display information on how to access the Answer Page
  7260.                command.  CHATPAGE.BBS should be located in the Misc
  7261.                directory.
  7262.  
  7263.                CHG_SENT.BBS:  This is the help file displayed when a user
  7264.                tries to edit a message which has already been sent, packed,
  7265.                or scanned as EchoMail.  CHG_SENT.BBS should be located in
  7266.                the Misc  directory.
  7267.  
  7268.                CHG_NO.BBS:  This is the help file displayed when a user
  7269.                tries to edit a message which was written by someone else. 
  7270.                It is located in the \MAX\MISC directory.
  7271.  
  7272.                DESCRIPT.BBS:  If this file exists in a *.MSG directory, the
  7273.                contents will be displayed to users who enter this area, and
  7274.                whose lastread pointer is set to zero.  For Squish areas,
  7275.                see the comments for <areaname>.DSC.  To display a file to
  7276.                all users who enter an area (regardless of lastread pointer
  7277.                settings), see also RULES.BBS
  7278.  
  7279.  
  7280.                    Maximus-CBCS v2.00 Operations Manual - Page 130
  7281.  
  7282.  
  7283.  
  7284.                EVENTSxx.BBS:  The ASCII event control file used by Max's
  7285.                event controller, where 'xx' is the current node number. 
  7286.                See the section in the installation entitled "Events and
  7287.                Yelling" for more information, and also see the "EVENT FILE
  7288.                CONFIGURATION" section in the Maximus Technical Reference
  7289.                Manual.  These files should be located in the Max root
  7290.                directory.
  7291.  
  7292.                EVENTSxx.DAT:  The compiled version of the Maximus event
  7293.                file, where 'xx' is the current node number.  The ASCII
  7294.                event file, EVENTSxx.BBS, is compiled by MAX.EXE at runtime. 
  7295.                These files should be located in the Max root directory.
  7296.  
  7297.                EXCBYTES.BBS:  This file will be displayed to a user who
  7298.                attempts to download too many kilobytes in one session. 
  7299.                (Maximus will display this after printing "That would exceed
  7300.                your daily download limit.")  This file should be located in
  7301.                the \MAX\MISC directory.
  7302.  
  7303.                EXCRATIO.BBS:  This file will be displayed to a user who
  7304.                attempted to download a file that would exceed his/her file
  7305.                download ratio.  (Maximus will display this file after
  7306.                printing "That would exceed your download ratio.")  This
  7307.                file should be located in the \MAX\MISC directory.
  7308.  
  7309.                EXCTIME.BBS:  This file will be displayed to a user who
  7310.                attempted to download a file that would exceed his/her time
  7311.                limit.  (Maximus will display this file after printing "That
  7312.                would exceed your time limit.")  This file should be located
  7313.                in the \MAX\MISC directory.
  7314.  
  7315.                FILES.BBS:  This is the name of the ASCII file listing in
  7316.                each file directory.  For more information on creating a
  7317.                FILES.BBS, please see the section in the installation
  7318.                entitled "Maintaining File Areas".
  7319.  
  7320.                FILES.DAT:  This is the name of the compiled file name
  7321.                listing in each file directory.  The FB utility creates
  7322.                FILES.DAT and several other files from the master FILES.BBS.
  7323.  
  7324.                FILES.DMP:  This is the name of the compiled file
  7325.                description listing in each file directory.  The FB utility
  7326.                creates FILES.DMP and several other files from the master
  7327.                FILES.BBS.
  7328.  
  7329.                FILES.IDX:  This is the name of the compiled file index in
  7330.                each file directory.  The FB utility creates FILES.IDX and
  7331.                several other files from the master FILES.BBS.
  7332.  
  7333.  
  7334.  
  7335.                    Maximus-CBCS v2.00 Operations Manual - Page 131
  7336.  
  7337.  
  7338.  
  7339.                FILE_BAD.BBS:  This file is displayed when an uploaded file
  7340.                fails the upload virus check.  Please see the MAX.CTL
  7341.                reference for more information on the "Upload Check Virus"
  7342.                keyword.  This file should be located in the \MAX\MISC
  7343.                directory.
  7344.  
  7345.                FILE_OK.BBS:  This file is displayed when an uploaded file
  7346.                passes the upload virus check.  Please see the MAX.CTL
  7347.                reference for more information on the "Upload Virus Check"
  7348.                keyword.  This file should be located in the \MAX\MISC
  7349.                directory.
  7350.  
  7351.                GOODBYE:  This is the name of the file displayed (by the
  7352.                off-line reader) to a QWK user who closes your system's mail
  7353.                packet.  This file should be located in the \MAX\OLR
  7354.                directory.
  7355.  
  7356.                HELLO:  This is the name of the file displayed (by the off-
  7357.                line reader) to a QWK user who opens your system's mail
  7358.                packet.  This file should be located in the \MAX\OLR
  7359.                directory.
  7360.  
  7361.                LASTUSxx.BBS:  This file is created by Maximus as a record
  7362.                of the last caller on the system.  In addition, this file is
  7363.                used by Maximus-specific door programs to obtain information
  7364.                about the user who is currently on-line.  This file simply
  7365.                contains a copy of that user's user record, with the "time
  7366.                remaining" and "baud rate" fields filled out appropriately.
  7367.  
  7368.                MAXFILES.IDX:  This is the system-wide file index, as
  7369.                created by FB.  This file is used for performing global
  7370.                downloading and upload dupe checking.
  7371.  
  7372.                MTAG.BBS:  This is a binary file used by Maximus to store
  7373.                message area T)agging information for each individual
  7374.                caller.  This file is located in the \MAX directory.
  7375.  
  7376.                NAMES.MAX:  Max has a feature similar to FrontDoor's
  7377.                NAMES.FD.  If you place a file called NAMES.MAX in your
  7378.                system directory, you can use it as an "alias" file for
  7379.                entering NetMail messages.  NAMES.MAX has the following
  7380.                format, one alias definition to a line:
  7381.            
  7382.                     <alias>,<name>,<address> [,<subject>]
  7383.            
  7384.                You can have any number of aliases listed in NAMES.MAX.  If
  7385.                Max spots a message addressed to "alias" (which can be done
  7386.                by entering the name directly at the prompt, when doing
  7387.                carbon copies, etc.), the message will be automatically
  7388.  
  7389.  
  7390.                    Maximus-CBCS v2.00 Operations Manual - Page 132
  7391.  
  7392.  
  7393.  
  7394.                readdressed to "name".  <subject> is optional; it can be
  7395.                used to enter a default subject for the message.  Example: 
  7396.            
  7397.                     jdh,Jesse David Hollington,1:225/1
  7398.                     adf,Andrew Farmer,1:163/115
  7399.                     sjd,Scott Dudley,1:249/106
  7400.                     afx,Areafix,1:106/116,gronk
  7401.                     jimbo,Jim Jones,1:106/114.5
  7402.  
  7403.                Entering the initials in the left column instructs Max to
  7404.                readdress the message to the appropriate person, using the
  7405.                specified address.
  7406.  
  7407.                If a "*" is placed at the beginning of an alias definition,
  7408.                that definition can only be used by callers with a priv of
  7409.                SysOp.  This may be useful for protecting Areafix and Raid
  7410.                passwords.  The NAMES.MAX file should be located in the \MAX
  7411.                directory.
  7412.  
  7413.                NEWFILES.DAT:  This file is displayed to a QWK user (by the
  7414.                off-line mail reader) when that user requests a new file
  7415.                listing from your BBS.  Please see the section entitled "QWK
  7416.                Mail Packer" for more information.  This file should be
  7417.                located in the \MAX\OLR directory.
  7418.  
  7419.                NEWS:  This is displayed to a QWK user (by the off-line mail
  7420.                reader) when that user requests a news file display from
  7421.                your BBS.  Please see the section of the documentation
  7422.                entitled "QWK Mail Packer" for more information.  This file
  7423.                should be located in the \MAX\OLR directory.
  7424.  
  7425.                NOTIN.BBS: When a user yells and the sysop does not respond,
  7426.                Maximus will look for this file in the Maximus MISC\
  7427.                directory.  If it exists, then this file will be displayed. 
  7428.                If it does not exist, Maximus will display the standard
  7429.                `Sorry, there's no answer'.  (Compare to YELL.BBS.)
  7430.  
  7431.                RAWDIR.BBS: If a file of this name exists in a file area
  7432.                directory, it will be displayed to the user when s/he
  7433.                attempts a R)aw directory command.  It will be displayed
  7434.                AFTER the command is selected from the menu, but BEFORE the
  7435.                `Enter mask:' prompt.
  7436.  
  7437.                READONLY.BBS: If this file exists in a read-only message
  7438.                area, and a user tries to enter a message, then this file
  7439.                will be displayed, as opposed to the built-in, "canned"
  7440.                message which Maximus normally displays.
  7441.  
  7442.  
  7443.  
  7444.  
  7445.                    Maximus-CBCS v2.00 Operations Manual - Page 133
  7446.  
  7447.  
  7448.  
  7449.                RESTARxx.BBS:  This file is created by Maximus (where 'xx'
  7450.                is the current node number) when performing an [xtern_erlvl]
  7451.                exit.  This file is used to store state information about
  7452.                the current caller, and it was designed to put Maximus back
  7453.                exactly where it was before the xtern_erlvl was performed. 
  7454.                This file is deleted by Max after restarting with the -r
  7455.                switch.  Also, this file can be used to change some
  7456.                information which is normally not modifiable by external
  7457.                programs, such as the "time user logged on system" field,
  7458.                the current menu, and more.  This file is located in the
  7459.                \MAX directory.
  7460.  
  7461.                RULES.BBS:  When placed in a *.MSG directory, Max will
  7462.                display this file to all callers who access this area.  For
  7463.                Squish areas, see <areaname>.SQR.  To display a file to
  7464.                callers only once, see DISPLAY.BBS and <areaname>.DSC.
  7465.  
  7466.                TAG_FILE.BBS:  This is the help file for the file area Tag
  7467.                command.  This file is located in the \MAX\MISC directory.
  7468.  
  7469.                TAG_MSG.BBS:  This is the help file for the message area Tag
  7470.                command.  This file is located in the \MAX\MISC directory.
  7471.  
  7472.                TIMEUP.BBS:  This file is displayed to callers when their
  7473.                time limits expire.  This message will be displayed after
  7474.                Max prints "TIME LIMIT."  This file is located in the
  7475.                \MAX\MISC directory.
  7476.  
  7477.                TUNES.BBS:  This is the file referred to by the 'Uses Tunes'
  7478.                command in MAX.CTL.  This filename is not hardcoded, but
  7479.                several utilities look for it in the \MAX directory.
  7480.  
  7481.                WHY_ANSI.BBS:  This is the help file for the "Want ANSI
  7482.                [Y,n,?]" question at log-on.  This file is located in the
  7483.                \MAX\MISC directory.
  7484.  
  7485.                WHY_FB.BBS:  This is the help file for the "Goodbye [Y,n,?]"
  7486.                question at log-off.  This explains to callers why they
  7487.                should leave feedback to the system operator.  This file is
  7488.                located in the \MAX\MISC directory.
  7489.  
  7490.                WHY_FSED.BBS:  This is the help file for the "Want MaxEd
  7491.                [Y,n,?]" question at log-on.  This file is located in the
  7492.                \MAX\MISC directory.
  7493.  
  7494.                WHY_HOT.BBS:  This is the help file for the "Want Hotkeys
  7495.                [Y,n,?]" question at log-on.  This file is located in the
  7496.                \MAX\MISC directory.
  7497.  
  7498.  
  7499.  
  7500.                    Maximus-CBCS v2.00 Operations Manual - Page 134
  7501.  
  7502.  
  7503.  
  7504.                WHY_HU.BBS:  This is the help file for the "Goodbye [Y,n,?]"
  7505.                question at log-off.  This file is located in the \MAX\MISC
  7506.                directory.
  7507.  
  7508.                WHY_PC.BBS:  This is the help file for the "Want IBM Chars
  7509.                [Y,n,?]" question at log-on.  This file is located in the
  7510.                \MAX\MISC directory.
  7511.  
  7512.                WHY_PVT.BBS:  This is the help file for the "Private [Y,n]?"
  7513.                question when entering a message in TTY mode.  This file is
  7514.                located in the \MAX\MISC directory.
  7515.  
  7516.                XPDATE.BBS:  This file is displayed when a user's
  7517.                subscription expires due to the current date.  This file
  7518.                should be in the \MAX\MISC directory.
  7519.  
  7520.                XPTIME.BBS:  This file is displayed when a user's
  7521.                subscription expires due to that user's number of on-line
  7522.                minutes.  This file should be in the \MAX\MISC directory.
  7523.  
  7524.                YELL.BBS: When yell is turned off and a user tries to yell
  7525.                for the sysop, Maximus will look for this file in the
  7526.                \MAX\MISC directory.  If it exists, it will display the file
  7527.                to the user.  If it does not exist, Maximus will display the
  7528.                standard `Yell is turned off' message.
  7529.  
  7530.  
  7531.  
  7532.  
  7533.  
  7534.  
  7535.  
  7536.  
  7537.  
  7538.  
  7539.  
  7540.  
  7541.  
  7542.  
  7543.  
  7544.  
  7545.  
  7546.  
  7547.  
  7548.  
  7549.  
  7550.  
  7551.  
  7552.  
  7553.  
  7554.  
  7555.                    Maximus-CBCS v2.00 Operations Manual - Page 135
  7556.  
  7557.  
  7558.  
  7559.                                         INDEX
  7560.  
  7561.           .FIZ                        43     BULLETIN.BBS            66, 91
  7562.           .LZH                        33     BULLETIN.MEC                91
  7563.           *.BBS  66, 67, 73, 76, 91, 103     cable                       45
  7564.           *.CTL                       66     CALLINFO.BBS          108, 109
  7565.           *.MEC                   67, 91     Canadian                    11
  7566.           *.MNU                  98, 107     CB chat                40, 117
  7567.           *.PRM                  98, 103     CD-ROM                1, 7, 74
  7568.           \MAX   13, 14, 27, 52, 59, 66,     chain       101, 103, 108, 109
  7569.                         67, 89, 94, 104,     CHAIN.TXT             108, 109
  7570.                       108-111, 113, 116,     chat          16, 17, 40, 113,
  7571.                            122, 125-128,                       115-117, 130
  7572.                                  130-135     COM2                   47, 106
  7573.           \MAX\HLP                    27     command line   14, 53, 54, 57,
  7574.           \MAX\MISC  13, 14, 52, 66, 67,                    59, 86, 89, 92,
  7575.                       94, 108, 109, 110,                   93-95, 113, 120,
  7576.                      113, 116, 122, 130,                                127
  7577.                       131, 132, 134, 135     COMMAND.COM       39, 100, 101
  7578.           80386                       48     comment     15, 60, 71-73, 77,
  7579.           9600 bps                    47                           109, 120
  7580.           ACCEM                   79, 80     CONFIG.SYS               46-49
  7581.           ANSI   13, 14, 26, 27, 36, 48,     ConfMail                10, 96
  7582.                       52, 66, 81-83, 94,     control file   16, 24, 27, 50,
  7583.                      105, 108, 112, 118,                51, 54, 55, 62, 64,
  7584.                            125, 126, 134                70, 73, 77, 93, 98,
  7585.           ANSI.SYS                    48                           120, 131
  7586.           ANSI2BBS                81, 82     Copyright            1, 43, 52
  7587.           ANSI2MEC                81, 82     custom menu                119
  7588.           APPLIC.BBS          13, 66, 67     custom welcome              14
  7589.           APPLIC.MEC              52, 67     CVTUSR          43, 52, 83, 84
  7590.           ARC                     10, 33     DCD                     44, 45
  7591.           Area 0                      71     DESQview           10, 48, 114
  7592.           AREA.DAT   74, 75, 86, 87, 92,     DIP switches                44
  7593.                              95, 97, 118     door interface        108, 109
  7594.           AREAS.BBS                   70     DOOR.SYS              108, 109
  7595.           AUTOEXEC.BAT    46-49, 94, 114     DORINFO.MEC           108, 109
  7596.           AVATAR     14, 26, 27, 36, 81,     DOS  2, 9, 10, 12, 39, 46, 48,
  7597.                        82, 94, 105, 112,                 49, 55, 56-58, 72,
  7598.                                 118, 125                   87, 88, 93, 100,
  7599.           BAD_USER.BBS               130                101, 102, 104, 110,
  7600.           BADUSER.BBS                130                           114, 115
  7601.           barricade                   19     DoubleDOS               10, 48
  7602.           BiModem                     32     DSZ                         32
  7603.           BinkleyTerm     9, 10, 54, 60,     ECHOTOSS.LOG        59, 96, 97
  7604.                                 101, 120     EDITCALL                    85
  7605.           BNU             12, 46, 47, 46     editor   14, 15, 21-24, 26-28,
  7606.           BORED               27, 28, 36                 36, 39, 48, 50-52,
  7607.           BUFFERS=                    48                65, 67, 72, 73, 77,
  7608.  
  7609.  
  7610.                    Maximus-CBCS v2.00 Operations Manual - Page 136
  7611.  
  7612.  
  7613.  
  7614.                          79, 82, 89, 97,                                129
  7615.                                 119, 122     lock                        65
  7616.           errorlevel  55-59, 62, 63, 97,     locked baud rate            54
  7617.                             101-104, 121     LOGO.BBS                    13
  7618.           ERRORLVL.BAT     101, 102, 104     LZH         10, 33, 43, 73, 74
  7619.           Event                      120     mailchecker             23, 95
  7620.           extended ASCII          37, 93     mailer    44, 54, 58, 59, 104,
  7621.           extended barricades         19                                114
  7622.           external program      100-103,     matrix  26, 52, 69, 95-97, 129
  7623.                       105, 108-110, 112,     MAX.CTL     13, 15, 21, 49-51,
  7624.                                 120, 123                53, 55, 66, 71, 74,
  7625.           FEND                        10                 90, 102, 106, 110,
  7626.           FidoNet     5, 10, 18, 25, 46,                113, 115, 120, 123,
  7627.                          53, 54, 68, 114                           132, 134
  7628.           FILEAREA.CTL                            Address   18, 20, 21, 26,
  7629.                Download  23, 32, 33, 37,                  53, 128, 132, 133
  7630.                       41, 70-74, 77, 86,          Alias System   13, 35, 84
  7631.                         87, 125-128, 131          FidoUser               21
  7632.                FileAccess             70          File Date Automatic    73
  7633.                FileInfo               70          Name   2, 13, 17, 19, 21,
  7634.                FileList               87                  22, 24-26, 33-35,
  7635.                Upload    24, 33, 41, 50,                38, 41, 51, 52, 55,
  7636.                      70, 71, 74, 86, 87,                56, 59, 60, 64, 66,
  7637.                        90, 106, 127, 132                67, 77, 79, 81, 84,
  7638.           FILES.BBS  72-74, 86, 106, 131                86, 87, 89, 91, 92,
  7639.           FILES=                      48                    93, 95, 96, 98,
  7640.           FOSSIL     12, 46, 47, 54, 114                101, 103, 105, 106,
  7641.           FrontDoor     10, 54, 60, 120,                 108-110, 112, 116,
  7642.                                      132                     117, 121, 125,
  7643.           FSR                         38                            129-133
  7644.           goto                56-60, 104          No Share.Exe          115
  7645.           guest account               14          Output    46, 79, 81, 91,
  7646.           Hayes      10, 12, 44, 53, 120                            93, 118
  7647.           idiot-proof                 51          Path IPC         115, 116
  7648.           Inquire                     23          Upload Check Dupe      74
  7649.           installation    6, 43, 46, 47,          Uses Leaving          110
  7650.                         50, 52, 78, 111,          Video IBM     48, 82, 120
  7651.                      113, 114, 121, 125,     MAX.PRM   90, 93, 98, 103, 113
  7652.                                      131     MaxEd      27, 28, 36, 52, 134
  7653.           Joe SysOp              13, 116     Maximus Help Node            6
  7654.           label           56-61, 79, 104     MECCA  66, 67, 79, 81, 82, 91,
  7655.           LANGUAGE.CTL                37                     100, 104, 105,
  7656.           lastread  23, 83, 92, 129, 130                 108-110, 112, 118,
  7657.           LASTUSER.BBS               108                           124, 125
  7658.           LICENSE                     11     MECCA token     105, 108, 118,
  7659.           Local  16, 18, 25, 27, 39, 45,                                124
  7660.                      46, 53, 62, 67, 69,          [cls]                 118
  7661.                      81, 93, 95-97, 105,          [delete]              108
  7662.                      106, 109, 121, 127,          [file]           118, 119
  7663.  
  7664.  
  7665.                    Maximus-CBCS v2.00 Operations Manual - Page 137
  7666.  
  7667.  
  7668.  
  7669.                [message]        118, 119                           129, 130
  7670.                [msg_cname]           118          End                    68
  7671.                [open]                108          MsgAccess              69
  7672.                [post]                108          MsgInfo                69
  7673.                [quit]           109, 119          MsgName            70, 96
  7674.                [write]          108, 109          Private Only       19, 69
  7675.                [xtern_erlvl]    103, 134          Public and Private     69
  7676.                [xtern_run]           112          Public Only        19, 69
  7677.           Menus   15, 17, 23, 25, 34-36,          Read-Only     19, 69, 70,
  7678.                      38, 50, 51, 64, 66,                           129, 133
  7679.                         76, 81, 98, 106,     MUFFIN                       6
  7680.                      110, 112, 115, 118,     multi-line            113, 117
  7681.                                      123     multi-node chat    16, 17, 40,
  7682.           MENUS.CTL  38, 50, 51, 64, 76,                      115, 116, 130
  7683.                       98, 106, 110, 112,     NetBIOS                    113
  7684.                                 115, 118     NetMail     6, 16, 18, 20, 21,
  7685.                Display_Menu     115, 123                25, 26, 28, 30, 33,
  7686.                HeaderFile            119                 52, 55, 58-60, 69,
  7687.                MenuFile    76, 115, 118,                   88, 97, 128, 132
  7688.                                      119     NEWUSER2.MEC                67
  7689.                MenuHeader       115, 118     nodelist                18, 21
  7690.                Press_Enter           118     non-volatile RAM            44
  7691.                ReRead                112     NOTIN.BBS                  133
  7692.                Statistics    16, 33, 96,     Novell                      49
  7693.                                      118     OECC                        10
  7694.                Version     1-3, 6, 7, 9,     oMMM                        58
  7695.                       11-13, 16, 18, 62,     Opus    9, 10, 46, 83, 84, 98,
  7696.                      63, 84, 86, 89, 90,                                108
  7697.                       98, 108, 109, 113,     OpusComm    10, 12, 46, 47, 46
  7698.                            118, 120, 131     Oracle          67, 81, 93, 94
  7699.                Xtern_Run        110, 112     OS/2  2, 6, 9, 10, 39, 46, 48,
  7700.           Minimus                     10                60, 72, 87, 88, 115
  7701.           modem   1, 12, 44-47, 53, 108,     packer     41, 58-60, 77, 125,
  7702.                                 120, 121                      126, 130, 133
  7703.           MPt                         32     PAK                         33
  7704.           MR                      78, 92     PCBoard                10, 115
  7705.           MS-DOS           2, 10, 12, 48     phone number   13, 35, 52, 77,
  7706.           MSGAREA.CTL                                         105, 112, 125
  7707.                Anonymous OK           19     printer                     26
  7708.                Area    6, 15, 18-26, 28,     Printing messages           26
  7709.                       30-32, 34, 41, 61,     Privilege Level    19, 24, 28,
  7710.                       64, 65, 68-72, 74,                30, 33, 34, 64, 65,
  7711.                      75, 86, 87, 89, 90,                         70, 86, 94
  7712.                          92, 95-99, 105,          AsstSysop  64, 70, 84, 94
  7713.                           106, 115, 118,          Clerk              64, 84
  7714.                         126-130, 132-134          Disgrace      64, 65, 84,
  7715.                EchoMail    5, 6, 18, 19,                      110, 112, 118
  7716.                      55, 58, 59, 68, 69,          Extra     58, 64, 77, 84,
  7717.                       70, 78, 88, 95-97,                                119
  7718.  
  7719.  
  7720.                    Maximus-CBCS v2.00 Operations Manual - Page 138
  7721.  
  7722.  
  7723.  
  7724.                Favored            11, 64     security  14, 19, 84, 109, 112
  7725.                Hidden         16, 38, 64     SHARE.EXE         49, 115, 116
  7726.                Limited  1, 4, 5, 64, 79,     SILT   34, 51, 69, 71, 90, 98,
  7727.                                       94                            99, 129
  7728.                Normal     1, 19, 25, 34,     Software Distribution
  7729.                      51, 55, 64, 65, 82,               System        46, 90
  7730.                         84, 93, 96, 100,     source code   2, 3, 66, 89, 90
  7731.                      113, 114, 118, 121,     SPAWNBBS.BAT                55
  7732.                                      128     support echo
  7733.                Privil         64, 65, 84          MUFFIN                  6
  7734.                Sysop   3, 13-16, 19, 21,     SYSTEM*.BBS                 98
  7735.                       24-26, 39, 45, 50,     SYSTEM*.DAT                 98
  7736.                      52, 59, 62, 64, 65,     TBBS                   10, 115
  7737.                         70, 71, 84, 105,     TheDraw             10, 81, 82
  7738.                      106, 108, 109, 116,     trademarks                  10
  7739.                      120, 121, 123, 133,     translation characters    105,
  7740.                                      135                      106, 108, 109
  7741.                Twit     16, 64, 106, 110     TSR                         46
  7742.                Worthy             64, 84     TTY       36, 82, 94, 105, 135
  7743.           QM                      10, 96     TUNES.BBS              62, 134
  7744.           questionnaire               14     user editor    14, 23, 39, 52,
  7745.           QuickBBS           10, 83, 108                            65, 122
  7746.           quote          22, 27, 29, 128     user file  13, 14, 16, 43, 52,
  7747.           QWK                     37, 41                   83, 84, 122, 124
  7748.           RAWDIR.BBS                 133     USER.BBS       13, 64, 83, 84,
  7749.           RBBS                   10, 108                         95-97, 130
  7750.           READER.CTL                         USER.DAT                83, 84
  7751.                Packet Name            77     WARRANTY               1, 2, 4
  7752.           READONLY.BBS               133     WaZOO                        9
  7753.           real name          19, 35, 106     WELCOME.BBS    14, 37, 125, 37
  7754.           remote sysop logons         14     WELCOME.MEC            14, 124
  7755.           RENUM                       92     WildCat!                   108
  7756.           REP                     37, 41     WWIV                  108, 109
  7757.           RESTAR*.BBS                103     X00         10, 12, 46, 47, 46
  7758.           restarting   53, 101, 103, 134     Xmodem                  10, 32
  7759.           result codes           44, 121     Xmodem-1K                   32
  7760.           reward                      50     Yell command                16
  7761.           run   2, 4, 7, 12, 17, 24, 25,     YELL.BBS              133, 135
  7762.                      34, 39, 43, 46, 48,     ZIP                 10, 33, 72
  7763.                       51-56, 58, 63, 74,     Zmodem              10, 32, 33
  7764.                      77, 78, 81, 84, 87,
  7765.                      88, 90, 95, 97, 98,
  7766.                      100, 101, 108, 110,
  7767.                             112-114, 121
  7768.           SCANBLD      56, 58, 61, 95-97
  7769.           scanner                 58, 59
  7770.           screen writes               48
  7771.           SDSMAX                      90
  7772.           SEAlink             10, 32, 33
  7773.  
  7774.  
  7775.                    Maximus-CBCS v2.00 Operations Manual - Page 139