home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / obv2_210.zip / OBV210-G.ZIP / OBV.DOC
Text File  |  1993-05-04  |  197KB  |  4,280 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.           ┌───────────────────────────────────────────────────────────┐
  27.           │                                                           │
  28.           │                                                           │
  29.           │             Oblivion/2 Bulletin Board System              │
  30.           │                       Version 2.10                        │
  31.           │                                                           │
  32.           │ Copyright (C) 1991-1993 Darkflame Enterprises.            │
  33.           │ All rights reserved. No part of this documentation may    │
  34.           │ be altered without the consent of Darkflame Enterprises.  │
  35.           │                                                           │
  36.           │ Written by: Eric Katz  (Referred to as Darkened Enmity)   │
  37.           │           : Rony Daher (Referred to as Lord Tracer)       │
  38.           │ Documentation: Rony Daher                                 │
  39.           │                                                           │
  40.           │                                                           │
  41.           │                                                           │
  42.           └───────────────────────────────────────────────────────────┘
  43.           
  44.           
  45.           
  46.           
  47.           
  48.           
  49.           
  50.           
  51.           
  52.           
  53.           
  54.           
  55.           
  56.           
  57.           
  58.           
  59.           
  60.           
  61.           
  62.           
  63.           
  64.           
  65.           
  66.           
  67.           
  68.                                 TABLE OF CONTENTS
  69.                                 ─────────────────
  70.           
  71.           LEGAL INFORMATION                                 1
  72.           
  73.           GENERAL OVERVIEW                                  1.1
  74.           
  75.           REGISTRATION                                      1.2
  76.           
  77.           ACS SYSTEM                                        2
  78.           
  79.           CONFIGURATION PROGRAM                             3
  80.           
  81.           MENUCODE/STATCODE/MAKEPROM/MAKEHELP               4
  82.           
  83.           DATA AREA CONFIGURATION                           5
  84.           
  85.           CONFERENCE EDITOR                                 6
  86.           
  87.           SYSOP ONLINE FUNCTIONS                            7
  88.           
  89.           INFOFORMS                                         8
  90.           
  91.           MAKING REPEAT ANSIS                               9
  92.           
  93.           MAKING STANDARD ANSIS                            10
  94.           
  95.           MCI CODES / SYSOP CONFIGURABLE TEXTFILES         11
  96.           
  97.           CONFIGURABLE CHAT                                12
  98.           
  99.           MENU EDITOR                                      13
  100.           
  101.           MESSAGE / FILE BASE SETUP                        14
  102.           
  103.           UPLOAD CHECKER                                   15
  104.           
  105.           CONFIGURABLE ARCHIVERS                           16
  106.           
  107.           
  108.           
  109.           
  110.           
  111.           
  112.           
  113.           
  114.           
  115.           
  116.           
  117.           
  118.           
  119.           
  120.           
  121.            
  122.           
  123.           
  124.           
  125.           
  126.           
  127.           
  128.           
  129.           
  130.           
  131.           
  132.           
  133.           
  134.                            SECTION 1: LEGAL INFORMATION
  135.                            ────────────────────────────
  136.           
  137.                Darkflame Enterprises grants to the Purchaser and
  138.           Purchaser accepts a nontransferable and non-exclusive license
  139.           to use,  on a single computer, the Software Products and
  140.           accompanying materials provided to Purchaser by Darkflame
  141.           Enterprises. Purchaser is hereby licensed only to read the
  142.           program from its medium into the memory of  a single
  143.           computer solely for the purpose of executing the program.
  144.           Darkflame Enterprises shall have the right to terminate this
  145.           license if purchaser violates any of its provisions.
  146.           Purchaser agrees that the Software Products and accompanying
  147.           materials are  the property of Darkflame Enterprises and that
  148.           Darkflame Enterprises shall maintain title to and ownership
  149.           of the Software Products at all times.  Purchaser agrees to
  150.           make no more than one (1) additional working copy and one (1)
  151.           backup copy of the Software Products for personal use only.
  152.           Except as indicated above, the Software Products may not, in
  153.           whole or part, be copied, reproduced, translated, or
  154.           distributed to other parties.
  155.           
  156.                Darkflame Enterprises makes  no warranties of any kind,
  157.           expressed or implied, with respect to the quality,
  158.           performance, accuracy, or fitness of the Software Products
  159.           for any particular purpose.  Darkflame Enterprises assumes no
  160.           responsibility for any decisions made or actions taken on the
  161.           part of the Purchaser because of the use  of the Software
  162.           Products.  In no event shall Darkflame Enterprises, or any of
  163.           its representatives, be liable for any loss of profit or any
  164.           other damages, including but not limited to special,
  165.           incidental, consequential or other damages, arising
  166.           out of the use or inability to use this product -even if
  167.           Darkflame Enterprises or an authorized agent of such has been
  168.           advised of the possibility of such damages -or for any claim
  169.           by any other party.
  170.           
  171.           
  172.                           SECTION 1.1: GENERAL OVERVIEW
  173.                           ─────────────────────────────
  174.           
  175.                Oblivion/2 BBS was designed with two things in mind: The
  176.           SysOp, and the user. This bulletin board program attempts to
  177.           give the best of both worlds: Power for the SysOp, and ease
  178.           of use for the user. With the unique menu editor, and
  179.           configurable ACS system, the power is present. The
  180.           possibility for change gives the SysOp his power, while also
  181.           giving the user an easy interface for operations.
  182.           
  183.           List of major features:
  184.           
  185.           o    Powerful menu editor. Allows for configuring all aspects
  186.                of the BBS.
  187.           o    Configurable String editor. No more internal strings.
  188.                Add a personal touch to your BBS!
  189.           o    Optimized for increased speed. Runs fast on any machine!
  190.           o    Support for multiple menu sets.
  191.           o    Support for multiple stat screen sets.
  192.           o    Echomail/Netmail Compatible.
  193.           o    Configurable Data Area System. Create your own
  194.                BBS/VMB/NUA listing, and configure them any way you
  195.                wish. Similar to an online database, but completely
  196.                configurable.
  197.           o    Support for SR/DOOR.SYS/DORINFO1.DEF door file formats.
  198.           o    Support for up to 255 separated message/file
  199.                conferences.
  200.           o    Support for multiple prompts. User selectable.
  201.           o    Integrated upload checking system! Checks all uploaded
  202.                files for CRC, viruses, and runs age tests. Also
  203.                includes ability for additional SysOp specified
  204.                maintainence to uploaded files!
  205.           o    Support for multiple, SysOp configurable archivers!
  206.                Anything on the BBS can be packed and unpacked in your
  207.                favorite archive type. Also includes automatic archive
  208.                signature recognition. The BBS knows what type of
  209.                archiver a file was packed in w/o looking at its
  210.                extension!
  211.           o    Advanced user editor with integrated searching
  212.                functions!
  213.           o    Parameter editor for easy control and maintaince of user
  214.                levels!
  215.           
  216.                             SECTION 1.2: REGISTRATION
  217.                             ─────────────────────────
  218.           
  219.                Registration of Oblivion/2 is simple. All of our
  220.           registrations are handled through our HQ support system. This
  221.           system, Elements of Evil, can be reached at 216-273-1527.
  222.           
  223.                The cost of Oblivion/2 is $50.00. There is no areacode
  224.           restriction, or other restrictions for that matter.
  225.           
  226.                To clear up certain things about registration, keep
  227.           these things in mind:
  228.           
  229.           o    A completed ORDER.FRM MUST be sent with your order.
  230.           o    Personal checks are NOT accepted. If you send one, your
  231.                order will be returned. Please send a cashier check or a
  232.                money order.
  233.           o    You cannot transfer your registration to a friend. All
  234.                registrations are handled with us.
  235.           o    Please only send your registration after you've been
  236.                validated on Elements of Evil, and after a member of the
  237.                team has given you the OK.
  238.           
  239.                Registration is handled through a serial number system.
  240.           When we validate your registration, you will receive a ZIP
  241.           containing a textfile named SERIAL.NUM. Inside this textfile,
  242.           you'll find a BBS Name, BBS SysOp, and a 20-digit serial
  243.           number. Enter that information in your Obv/2 config EXACTLY
  244.           as they appear in the SERIAL.NUM. If the information is not
  245.           correct, the BBS will not register.
  246.           
  247.                Should you lose your SERIAL.NUM, please contact any
  248.           member of the Oblivion/2 staff, and a new one will be made
  249.           available for you.
  250.           
  251.                If you wish to get in contact with the Oblivion/2 team,
  252.           please mail us on Elements of Evil, or at this address:
  253.           
  254.           
  255.           Post Office Box 43364
  256.           Cleveland, Ohio  44143-0364
  257.           
  258.           
  259.                               SECTION 2: ACS SYSTEM
  260.                               ─────────────────────
  261.           
  262.               ACS, or Access Conditioning System, has become a reality
  263.           for many BBS programs being produced today. With ACS you can
  264.           allow and restrict user's access to a certain area to the
  265.           board based not only on level but on Baud Rate, Time Left,
  266.           Number of File Points and much more. In essence, ACS
  267.           offers the SysOp "Total Control" of his system.
  268.           
  269.               Before any SysOp can use the ACS System, it must be known
  270.           it can get very complicated (as you will see).  It can become
  271.           a programming language in itself.  So if your access doesn't
  272.           go as planned the first time, continue to experiment until
  273.           you find the results you are looking for.
  274.           
  275.           The following is a list of valid ACS Commands:
  276.           
  277.           
  278.           
  279.           Flag                   Description
  280.           ─────────────────────────────────────────────────────────────
  281.           -                      False
  282.           +                      True
  283.           SXXXX                  True if Level Greater or equal to X.
  284.           VX                     True if user is on Node X.
  285.           DXXXX                  True if File Level Greater or equal to
  286.                                  XXXX.
  287.           EX                     True if user called more than X times
  288.                                  today.
  289.           BXXX                   True if BPS Rate (w/o 00's) is Greater
  290.                                  or equal to XXX. (ie:3, 12, 24, 48,
  291.                                  96, 144, 168, 192, 384)
  292.           CXXX                   True if user hasn't called in XXX days
  293.           FX                     True if X flag is set. (A-Z)
  294.           PXX                    True if user has XX file points.
  295.           YXXX                   True if it is at least XXX minutes
  296.                                  past midnight.
  297.           ()'s                   Tells Obv/2 to Process Codes in
  298.                                  parenthesis before any other codes.
  299.           |                      Used to "Or" what is on the left
  300.                                  side of the | with what is on the
  301.                                  right side of the |.
  302.           ~                      Makes a Code False that would
  303.                                  otherwise be true and vice versa.
  304.           \                      True if Fail Flag is True.
  305.           =                      True if user is local.
  306.           [                      True only when system is run
  307.                                  multinode.
  308.           ;                      True if input is not broken using
  309.                                  space or ESC.
  310.           '                      Used to prompt for SysOp password.
  311.           KX                     True if absolute file area # is equal
  312.                                  to value of X.
  313.           LX                     True if absolute message area # is
  314.                                  equal to value of X.
  315.           MX                     True if MSG conference is equal
  316.                                  to the value of X.
  317.           NX                     True of FILE conference is equal
  318.                                  to the value of X.
  319.           PXXXX                  True if # of file points is greater
  320.                                  than the value of XXXX.
  321.           TXXXX                  True if time left is greater than
  322.                                  the value of X.
  323.           UXXXX                  True if the user # is equal to X.
  324.           AXX                    True of age is greater than XX.
  325.           GX                     True if user is male (X must be
  326.                                  0), or user is female (X must be 1)
  327.           
  328.           
  329.           The Following are a few examples of the ACS System:
  330.           
  331.           ~U2                      - Creates a base that can be accessed
  332.                                      by everyone EXCEPT User #2.
  333.           S20D20                   - Creates a base that anyone can
  334.                                      access as long as their main/file
  335.                                      levels are greater/equal to 20.
  336.           Y120                     - Creates a Base that will open after
  337.                                      2:00 am and close at 11:59 pm.
  338.           y60~y120                 - Creates a base that will be open
  339.                                      from 1am to 2am.
  340.           =S255                    - Creates a base that can only be
  341.                                      accessed via the local terminal, AND
  342.                                      the user online must have a security
  343.                                      level of 255.
  344.           P100|S50                 - Creates an option that can be
  345.                                      accessed only
  346.                                      if the user has 100 or more file
  347.                                      points, OR if the user has a
  348.                                      security level of 50 or greater.
  349.           T90|FABC                 - Creates an option that can only be
  350.                                      used if the user has 90+ minutes of
  351.                                      time, OR if he has flags A,B,C set.
  352.           B144|FA                  - Creates an option that can be
  353.                                      accessed only by someone who has a
  354.                                      14.4k or better modem, OR if the
  355.                                      user has flag A set.
  356.           A18G0                    - True if the user is male, and 18 or
  357.                                      over.
  358.           A18G1                    - True if the user is female, and is
  359.                                      18 or over.
  360.           (s20d20~U2)|(U2Y60~Y120) - Creates a base that will allow
  361.                                      anyone except user #2 who has both a
  362.                                      Main Level and Transfer Level
  363.                                      Greater than or equal to 20 OR Allow
  364.                                      User #2 to access this base from 1am
  365.                                      to 2am.
  366.           
  367.           
  368.           
  369.                                  SECTION 3: CONFIGURATION PROGRAM
  370.                                  ────────────────────────────────
  371.           
  372.                In version 2.0 and later, the configuration program is
  373.           now an active part of the BBS.  No longer do you have to exit
  374.           the BBS, and run a large, clunky config, but you can do all
  375.           of this online.
  376.           
  377.                The configuration program has a number of global
  378.           commands. To Clear a field, use the CTRL-Y command, to
  379.           advance to the next option, use either your arrow keys, or
  380.           your ENTER key. To enter into insert mode, or to exit
  381.           from it, use the CTRL-V option. To end configuration from a
  382.           certain menu, use CTRL-Z (Unless otherwise told).
  383.           
  384.                Each Section of the configuration program covers a
  385.           different aspect of the BBS. Use your arrow keys to navigate
  386.           throughout the config.
  387.           
  388.                In the next part of this section, certain commands in
  389.           the configuration program will be explained in detail.
  390.           Commands that are obvious, will be skipped.
  391.           
  392.           System Information:
  393.           
  394.           Multinode Operation  - If you plan to run your system with
  395.                                  multiple nodes, select yes for this
  396.                                  option.
  397.           Node Number          - This is the node number for the
  398.                                  current node. Leave this at 1 if you
  399.                                  do not plan on running more than
  400.                                  one node.
  401.           Mins to Time Out     - This value (in minutes) will tell the
  402.                                  BBS when to hang up if there has been
  403.                                  no keypresses from the remote side.
  404.           Days to save log     - This number (in days) tells the BBS
  405.                                  how long to save the system log. The
  406.                                  log will automatically be purged after
  407.                                  that number of days. This is primarily
  408.                                  a security feature.
  409.           Lines of Scrollback  - This number tells the BBS how many
  410.                                  lines of text to save in the
  411.                                  scrollback buffer. This buffer can be
  412.                                  accessed via the F4 SysOp command, and
  413.                                  is used to view any text/ansi that
  414.                                  scrolled off the screen. The higher
  415.                                  you make this number, the more memory
  416.                                  you'll need.  If you make the number
  417.                                  too high, your system will crash with
  418.                                  an ERROR 203. Should this happen,
  419.                                  lower this number!
  420.           Page Times           - This number tells the BBS how many
  421.                                  times to allow the user to page the
  422.                                  SysOp. If he pages more than this
  423.                                  amount of times, a textfile,
  424.                                  ENOUGH.ANS, will be printed.
  425.           QWKName              - (Max 8 letters, no extension) This is
  426.                                  the filename
  427.                                  that your BBS will generate when a
  428.                                  user creates a QWK packet for
  429.                                  download. ie: OBV2 would make a packet
  430.                                  called OBV2.QWK.
  431.           BIOS Writes          - If this option is Yes, then screen
  432.                                  writes will be handled through the
  433.                                  BIOS. This is very slow, but may
  434.                                  sometimes be needed if you have
  435.                                  multitasking problems.  For normal
  436.                                  operations, change this to No.
  437.           Use MAINTAIN.BAT     - Read the section on the upload checker
  438.                                  for information on this batch file.
  439.           Starting Menu        - After the BBS finishes with the
  440.                                  MATRIX.MNU file (your matrix), which
  441.                                  menu should it then go to. This option
  442.                                  tells Obv/2.  Do not include a .MNU
  443.                                  extension; That is assumed.
  444.           Use Status Bar       - If you wish to use the status bar,
  445.                                  turn this option on.  If not, keep it
  446.                                  off. The status bar is located on line
  447.                                  25 of your local screen. It gives
  448.                                  important user info on the current
  449.                                  user. There are three different parts
  450.                                  to the bar. Toggle all of these by
  451.                                  using ALT-B. You can also turn off
  452.                                  your status bar at anytime by using
  453.                                  ALT-B.
  454.           
  455.           System Information 2
  456.           
  457.           Data Library Ansis   - Tells the BBS if the ansis for data
  458.                                  areas are in the current status screen
  459.                                  library, or if they're in the textfile
  460.                                  directory. Yes = Ansis in status
  461.                                  library, and No = Ansis are in
  462.                                  textfile directory. Note: If you enter
  463.                                  yes for this field, and the ansis are
  464.                                  not there, the BBS will then look in
  465.                                  the textfile directory.
  466.           Scan all areas       - When this option is set to yes, then
  467.                                  the BBS will check all file areas for
  468.                                  duplicates when globally uploading
  469.                                  files. This method is slower, but
  470.                                  there's no possibility of having the
  471.                                  same file in 2 directories. If the
  472.                                  option is set to no, then the current
  473.                                  area will only be scanned for
  474.                                  duplicates.
  475.           Use upload checker   - If you want your uploads CRC tested,
  476.                                  age checked, and virus scanned, turn
  477.                                  this option on. Read the section on
  478.                                  the upload checker for more
  479.                                  information on the upload checker.
  480.           SCAN Command         - This is the commandline of the virus
  481.                                  scanner that the upload checker will
  482.                                  use. IE: SCAN /A /NOMEM /NOPAUSE for
  483.                                  SCAN.EXE from McAfee.
  484.           Comment File         - This is the filename of the comment
  485.                                  that the upload checker will add to
  486.                                  your checked files. Make sure that the
  487.                                  file is in your textfile. If you
  488.                                  don't want comments added, leave it
  489.                                  blank.
  490.           File to add          - This is the filename of the file that
  491.                                  the BBS will add to checked files.
  492.                                  Again leave it blank if you don't want
  493.                                  a file added.
  494.           Age for files        - If the newst file in an archive is
  495.                                  older than this date, then the file
  496.                                  will fail the upload checker.
  497.           Delete List          - This filename (in your textfile
  498.                                  directory) contains files that the
  499.                                  upload checker will delete from
  500.                                  uploaded archives. Put one filename
  501.                                  per line.
  502.           
  503.           Communications:
  504.           
  505.           Manual Answer        - When this command is set to yes,
  506.                                  Oblivion/2 monitors the carrier pin on
  507.                                  your serial card. When this pin
  508.                                  signals true (when the phone rings),
  509.                                  the BBS sends the answer string.  This
  510.                                  method is quicker than waiting for the
  511.                                  "RING" message from the modem.  It
  512.                                  doesn't work with all modems, so
  513.                                  experiment.
  514.           Initialization String- This string is sent to the modem after
  515.                                  every call, and when first loading up
  516.                                  the BBS. Use | as return, and ~, or
  517.                                  comma, for pauses.  Use "+++" to put
  518.                                  the modem into command mode.
  519.           Hangup String        - This string is sent to the modem when
  520.                                  you want it to hang up the phone.  Use
  521.                                  the same symbols as above.
  522.           Send Carrier Str.    - This string is sent when you want to
  523.                                  send carrier to another user.  (ie:
  524.                                  User is in his term program, and you
  525.                                  want to switch form a voice call to a
  526.                                  data call. User receives carrier
  527.                                  (ATX1D), and you send carrier (ATA))
  528.           Receive Carrier Str. - Same as above, except this will
  529.                                  receive carrier. This is typically
  530.                                  ATX1D.
  531.           Lockout Password     - This password is required for a user
  532.                                  to login when his baud rate is under
  533.                                  the minimum baud rate.
  534.           
  535.           ACS Configuration:
  536.           
  537.           Post Anonymous ACS   - ACS required to post anonymously in
  538.                                  any base. (See the section on ACS for
  539.                                  codes)
  540.           SysOp ACS            - ACS required to be a full SysOp. When
  541.                                  you have this ACS you'll be able to
  542.                                  access all SysOp commands. (Unless
  543.                                  otherwise changed by the menu editing)
  544.           Message SysOp ACS    - ACS required to have access to the
  545.                                  message sponsor commands. (Again, this
  546.                                  can be overriden by menu editing)
  547.           File SysOp ACS       - Same as above, except for file system.
  548.           Exec in MiniDOS ACS  - ACS required to use the *COMMAND, or
  549.                                  &COMMAND commands in MiniDOS. *COMMAND
  550.                                  will execute COMMAND after performing
  551.                                  a DOS shell. Use this to run PKZIP
  552.                                  etc..  &COMMAND will execute command
  553.                                  w/o a DOS shell. Use this to run any
  554.                                  commands that are internal to
  555.                                  COMMAND.COM. (ie: DEL, ERASE, COPY)
  556.           //\\COMMAND ACS      - //\\COMMAND is a quick way to execute
  557.                                  any command from anywhere.  You must
  558.                                  have the specified ACS.  To use
  559.                                  //\\COMMAND, type //\\ followed by the
  560.                                  corresponding menu command. For
  561.                                  example, the menu command for text
  562.                                  editor is *T. If you've got //\\
  563.                                  ACS, you'd type //\\*T. This would be
  564.                                  the same as executing the text editor
  565.                                  from the SysOp menu, but you can do it
  566.                                  from anywhere!
  567.           Post Mandatory ACS   - ACS required to post a message in a
  568.                                  mandatory (NEWS) message base.
  569.                                  Mandatory message bases are
  570.                                  automatically newscanned upon logon to
  571.                                  the system. Use them to post news
  572.                                  bulletins. Be sure to purge them
  573.                                  periodically, as they will get
  574.                                  numerous.
  575.           Topten exempt ACS    - ACS for users to be exempt from the
  576.                                  top ten listing.
  577.           Certified Mail ACS   - ACS required for a user to send
  578.                                  certified mail. Cerified mail is a
  579.                                  type of Email that sends the sender a
  580.                                  notice when the receiver has read the
  581.                                  mail.
  582.           Filemail ACS         - ACS required to attach files to email.
  583.           
  584.           File Section Config:
  585.           
  586.           Points per 10k       - This is used to establish a file point
  587.                                  ratio. 10K would be worth how many
  588.                                  filepoints?
  589.           External Area Listing- If you have made an external file area
  590.                                  listing, using either the straight
  591.                                  ANSI method, or the repeat method, set
  592.                                  this option to Yes.
  593.           Repeat Method        - If you made your area listing using
  594.                                  the Repeat Method select yes. (Read
  595.                                  the section on making external screens
  596.                                  for instruction on making repeat
  597.                                  method screens.)
  598.           Filepoint Commission - If this option is toggled to yes, a
  599.                                  commission system for filepoints will
  600.                                  be used. The commission system grants
  601.                                  the uploader a percentage credit (in
  602.                                  FP's), when someone downloads his
  603.                                  file. This encourages good uploads. If
  604.                                  nobody downloads the file, then the
  605.                                  uploader doesn't get credits.
  606.           Percentage Commission- Percent of the total filepoints to
  607.                                  give the uploader when someone
  608.                                  downloads his file. Example:
  609.                                  Points per 10K = 1
  610.                                  Percentage Commission = 100%
  611.                                  User downloads a 100K file, and the
  612.                                  uploader will get 10 points added on
  613.                                  to his account.
  614.           Times Point Back     - When you rate a file, the uploader
  615.                                  will get that rating multiplied by
  616.                                  this number. (ie: if this was 2, and
  617.                                  you rated a file at 5 pts, the user
  618.                                  gets 10 pts added to his account)
  619.           Description form 1-8 - With these 8 lines, you can completely
  620.                                  customize
  621.                                  your file descriptions. You can add
  622.                                  such things as
  623.                                  Uploaded by:       (See the MCI code
  624.                                  Size Compressed:    section for the
  625.                                  Size Uncompressed:  codes to these
  626.                                  Newest File:        features)
  627.                                  Oldest File:
  628.                                  Any of these that you wanted to
  629.                                  include in all your descriptions will
  630.                                  be added to each upon upload. When
  631.                                  adding one of these extra features,
  632.                                  you'll want to add them starting at
  633.                                  description form 8, and working your
  634.                                  way up. (8,7,6 etc..) If you do not
  635.                                  want to add an extra feature into a
  636.                                  certain line, you must use |Dx
  637.                                  x equals a number from one to 8. This
  638.                                  tells the BBS which lines to use for
  639.                                  description, and which to use for
  640.                                  features.  Look at this example:
  641.                                  Description Form 1: |DE
  642.                                  Description Form 2: |D1
  643.                                  Description Form 3: |D2
  644.                                  Description Form 4: |D3
  645.                                  Description Form 5: |D4
  646.                                  Description Form 6: |D5
  647.                                  Description Form 7: Size Uncompr: |TC
  648.                                  Description Form 8: Uploaded by: |UL
  649.                                  As you can see, Lines 1-6 will be used
  650.                                  for any description that the user
  651.                                  gives, and lines 7-8 will be used to
  652.                                  tell the user how much space the file
  653.                                  takes up after its been UNZIPPED, and
  654.                                  the uploader name. Make sure to use
  655.                                  |DE as the FIRST line. |Dx are used
  656.                                  for EXTENDED descriptions only.
  657.           Lines of extended    - How many lines of extended description
  658.           description            are you using? In the above example,
  659.                                  this field will be 5.
  660.           Percent Time back    - How much time back (in %) should the
  661.                                  user get back after his upload.
  662.           Autovalidate files   - If yes, files will automatically be
  663.                                  validated after upload. Otherwise,
  664.                                  they will be marked as NEW, and
  665.                                  must be manually validated.
  666.           Min K for upload     - (in Kbytes) When your HD his this
  667.                                  amount of space, or less, uploads will
  668.                                  not be accepted.
  669.           Use Average CPS      - If this option is set to true, time
  670.                                  estimates for transfers will be made
  671.                                  on the average CPS rate of that user.
  672.                                  If it's set to no, time estimates will
  673.                                  be made based upon the connect rate.
  674.           
  675.           Email Config:
  676.           
  677.           Allow Filemail       - When this option is set to yes, users
  678.                                  will be allowed to send files to each
  679.                                  other through Email.
  680.           Days to keep filemail- Filemail will be kept for this amount
  681.                                  of days. It will then be auto-purged.
  682.           
  683.           Message Section:
  684.           
  685.           External Base List   - Use an external base listing in the
  686.                                  message section?  (See section on
  687.                                  making an external listings in these
  688.                                  docs)
  689.           
  690.           Repeat Method        - If you made your base listing using
  691.                                  the repeat method, select yes.
  692.           
  693.           Val User/NUV Settings:
  694.           
  695.           Default Flags        - When a user is validated, he will
  696.                                  receive these access flags.
  697.           Daily Flag Change    - Flag changed on first call of each
  698.                                  day. (Format: +FLAGS -FLAGS)
  699.                                  (ie: +ABC-XYZ  - Adds ABC, turns off
  700.                                  XYZ)
  701.           Call Flag Change     - Flag changed on every call.
  702.                                  (Format: +FLAGS -FLAGS)
  703.                                  (ie: +ABC-XYZ  - Adds ABC, turns off
  704.                                  XYZ)
  705.           
  706.           
  707.                   SECTION 4: MENUCODE/STATCODE/MAKEPROM/MAKEHELP
  708.                   ──────────────────────────────────────────────
  709.           
  710.           MENUCODE:
  711.           
  712.               Before your users can choose from multiple sets of menus,
  713.           you must first code your ansi/ascii menu files into a single
  714.           library file. To do this, you will need the enclosed utility
  715.           MENUCODE.EXE.  The commandline for the code utility is as
  716.           follows.
  717.           
  718.           MENUCODE <.LIB Name>
  719.           
  720.           Note: You might want to do this in a separate dir. Also, if a
  721.                 file is missing the program will inform you.
  722.           
  723.                You may be thinking to yourself, What do I name the
  724.           files? The answer is simple. With versions greater than 2.0,
  725.           the SysOp decides which menu(s) will be in each library file.
  726.           Do this by entering an up to 8 letter filename (no extension)
  727.           in the HELP ID field in the menu editor. (Once you've begun
  728.           to edit any menu, HELP ID is on the menu editor change
  729.           screen.) If you do not want an ansi menu coded for a specific
  730.           MNU file that you have, leave the HELP ID blank.
  731.           
  732.                After all files are successfully coded, copy the *.LIB,
  733.           and *.NDX files to your data directory. Proceed to login to
  734.           the BBS, and enter the main  SysOp menu.  When you've reached
  735.           that, option "N" will allow you to edit your status screens
  736.           or menus. Since you'll be adding menus, select M.
  737.           
  738.                Option "A" will add a menu set for users to choose from.
  739.           Select this, and fill out the questions. If you do not wish
  740.           to use Library set menus, use the Obv/2 TEXTFILE directory as
  741.           the LIB filename.
  742.           
  743.           Example:
  744.           Menu Name   : Normal Menus
  745.           Library File: C:\OBV2\TEXTFILE\
  746.           
  747.           If you take this approach, no LIB/NDX files are necessary.
  748.           
  749.           
  750.           STATCODE:
  751.           
  752.               With the ability to code multiple menu sets, the idea of
  753.           being able to do the same with status screens was invented.
  754.           We call these 'Status Screen Libraries.  Using a small
  755.           utility, called STATCODE, you will be able to code multiple
  756.           statistic screen sets for your users to choose from.
  757.           
  758.               The status library consists of a few configurable ANSI
  759.           screens, they are as follows:
  760.           
  761.           NEWSHEAD.ANS  - The News Header
  762.           HDR.ANS       - The Header
  763.           HEADER.ANS    - Message Header
  764.           EHEADER.ANS   - Header for fullscreen editor
  765.           BCHANGE.ANS   - Base Change Header
  766.           SUBSSRT.ANS   - Sub Listing Start ANSI (Optional)
  767.           SUBSMID.ANS   - Sub Listing Repeat ANSI (Optional)
  768.           SUBSEND.ANS   - Sub Listing End ANSI (Optional)
  769.           AREASRT.ANS   - File Area Listing Start ANSI (Optional)
  770.           AREAMID.ANS   - File Area Listing Repeat ANSI (Optional)
  771.           AREAEND.ANS   - File Area Listing End ANSI (Optional)
  772.           USERSRT.ANS   - User Listing Start ANSI (Optional)
  773.           USERMID.ANS   - User Listing Repeat ANSI (Optional)
  774.           USEREND.ANS   - User Listing End ANSI (Optional)
  775.           STATUS.ANS    - Login Status Screen
  776.           USERSTAT.ANS  - Your Stat ANSI
  777.           FILESTAT.ANS  - File Status
  778.           FCONFIGS.ANS  - File Listing Configuration Screen
  779.           CONFSCR.ANS   - Config Screen
  780.           
  781.                It is now possible to code any screen that you want into
  782.           the status library. With the invention of the -N menu command
  783.           (see the menu editor documentation), you may now display
  784.           status screens anywhere in the BBS. To code additional
  785.           screens, create a textfile called *.LST. (ie: If you code
  786.           OBV.LIB, you'll create and OBV.LST) In this textfile, each
  787.           line should have a  valid DOS filename without any path
  788.           information.  When you run STATCODE, make sure to have this
  789.           textfile in the main BBS directory.
  790.           
  791.                You can also code the data area ansis into your status
  792.           screen libraries. Simply toggle that option on in the CONFIG,
  793.           and place any ansis that have to do with data areas in the
  794.           temp directory that you're using, and run STATCODE. (See the
  795.           section on the data areas on these ansi files)
  796.           
  797.               As you can see, there are quite a few files that you can
  798.           include in your status screen library.  You'll also notice
  799.           that some of the screens were optional.  Those do NOT have to
  800.           be included in your library, but can be.
  801.           
  802.           To Code a Status Library:
  803.           
  804.           1.  Create a temporary directory, copy ALL files to this
  805.               directory.
  806.           2.  Make sure to have your .LST file in the main directory.
  807.           3.  Run STATCODE.EXE with this format: STATCODE <libname>
  808.               <directory>
  809.               ie: STATCODE PMD C:\TEMP\   (No extension on libname!)
  810.           4.  Add the status set with the "N" SysOp command.
  811.           5.  If you coded any of the 3 part listing screens (ie:
  812.               SUBXXXX.ANS, USERXXXX.ANS, or AREAXXXX.ANS) you must
  813.               toggle their use in the CONFIG.  (See the chapter on the
  814.               configuration program on just where to find these
  815.               options.)
  816.           6.  If you coded the data area ansis, make sure that the
  817.               corresponding option is turned on in the CONFIG.
  818.           
  819.           
  820.           MAKEPROM:
  821.           
  822.                With the new-and-improved string system in version 2.00
  823.           and greater, there is no more need for a string compiler.
  824.           Instead, we've written a new utility called MAKEPROM which
  825.           will add/arrange any new strings. No textfiles, no compilers,
  826.           nothing but a simple executable file.
  827.           
  828.                This utility will add any new strings to the data file,
  829.           and will arrange them in their specific order. Do not run
  830.           this program more than on time per new version. The program
  831.           will inform you which prompts it can convert, and all you
  832.           need to do is run it once to update your PROMPTS.DAT.
  833.           
  834.           MAKEHELP:
  835.           
  836.                With the new configuration system in version 2.0 and
  837.           greater, we've created a help system. This system will give
  838.           the SysOp a brief description of each option. Whenever new
  839.           options are added to the config, new descriptions must be
  840.           added to the data file. MAKEHELP will update your help file.
  841.           Run this only once per new version, just like MAKEPROM.
  842.           
  843.           
  844.                         SECTION 5: DATA AREA CONFIGURATION
  845.                         ──────────────────────────────────
  846.           
  847.                The data area is a new outlook on an old idea. This data
  848.           area system draws on the old database system found in some
  849.           BBS softwares. This system takes the good features of the
  850.           database, and combines them with the configurability of
  851.           Oblivion/2.
  852.           
  853.                Data areas can be used for a few very practical
  854.           applications. We've already utilized these areas in making a
  855.           BBS list, Rumors, and One Liners. All of these are completely
  856.           SysOp configurable, and can be altered in any way the SysOp
  857.           chooses.
  858.           
  859.                To show the configurability of the data areas, I will
  860.           demonstrate making a BBS listing, along with explaining how
  861.           these data areas work.
  862.           
  863.                When you first enter the data area sysop menu, you'll be
  864.           presented with a few self-explanatory options. (Add, delete,
  865.           change, quit.) Since we're just starting out, we'll select
  866.           add. You'll be presented with the following screen:
  867.           
  868.           
  869.           (A) Area Name      : BBS List
  870.           (B) Access ACS     :
  871.           (C) Add ACS        :
  872.           (D) List Prefix    : BBS
  873.           (E) Add Ansi       : ADDBBS.ANS
  874.           (F) Sponsor        : Lord Tracer
  875.           (G) Allow Anonymous: No
  876.           (H) Store Message  : Yes
  877.           (I) Data File Name : BBSLIST
  878.           (J) Show Ansi      : SHOWBBS.ANS
  879.           (K) AutoDelete     : 0
  880.           
  881.           Area name          - Name of the data area. In our case, this
  882.                                will be BBS list.
  883.           Access ACS         - ACS required to access this data area.
  884.           Add ACS            - ACS required to add an option. In this
  885.                                case, it would be adding your BBS entry.
  886.           List Prefix        - This prefix (up to 5 letters) tells the
  887.                                BBS the name of the 3-part listing file
  888.                                to use. Using BBS, the 3 ansis you'd
  889.                                need to make would be BBSSRT.ANS,
  890.                                BBSMID.ANS, and BBSEND.ANS. (See the
  891.                                section on making 3 part repeat ansis
  892.                                for help with this)
  893.           Add Ansi           - The ANSI that appears when the user
  894.                                wants to add to the database. In this
  895.                                case, this ansi could be a box with BBS
  896.                                name, number etc. Each of these options
  897.                                requires an MCI code. Worry about that
  898.                                later.
  899.           Sponsor            - The user that can edit the database. If
  900.                                you want to give specific users their
  901.                                own database, you do not need to give
  902.                                them SysOp access to edit their
  903.                                database.
  904.           Allow Anonymous    - Can the user add to this database
  905.                                anonymously? If so, set this to yes.
  906.           Store Message      - Can this database store an ANSI file or
  907.                                description for each entry? If so,
  908.                                change this to yes.  In our case, we
  909.                                wish to allow the SysOp to upload his
  910.                                BBS ad, or write a description.
  911.           Data filename      - This is the filename the BBS uses to
  912.                                store information about this database.
  913.                                Do not include an extension.
  914.           Show Ansi          - This ansi is displayed when the user
  915.                                views one of the data listings. In this
  916.                                example, you'd want to give a lot of
  917.                                information in the Show Ansi. Stuff that
  918.                                you didn't put in the listing ansi.
  919.                                Again, you'll use MCI codes for this
  920.                                ansi, worry about what codes to use
  921.                                later.
  922.           
  923.           Autodelete         - This number is the maximum number of
  924.                                entries in one database. Entries will be
  925.                                auto-purged to stay below this number.
  926.           
  927.           
  928.                After you've completed the configuration of the data
  929.           area, press q to quit. The BBS will ask you "Edit Options?"
  930.           Select yes. In this section, there are 3 options:
  931.           
  932.           Name          : BBS Name
  933.           String Length : 40
  934.           MCI Code      : BN
  935.           
  936.                Enter every piece of information that you want to prompt
  937.           the user. (You should use all of these MCI codes in your add
  938.           ansi. Use the important ones in your listing ansi, and
  939.           finally, all of them in your show Ansi. See the example BBS
  940.           list provided with the BBS.)
  941.           
  942.                Taking a look at the above example, the name of the
  943.           field is BBS name, you can enter up to 40 characters for this
  944.           field, and the MCI code for your ansis is |BN. Notice that
  945.           you do NOT put the | in the editor! Just BN!
  946.           
  947.                The data areas require a little work to create, but when
  948.           you put in the effort, and understand how it works, the
  949.           results are pleasing.
  950.           
  951.           
  952.                            SECTION 6: CONFERENCE EDITOR
  953.                            ────────────────────────────
  954.           
  955.               With the conferencing system, there can be up to 255
  956.           separated message and file conferences.  Also with the system
  957.           comes many security features to prevent unwanted users in
  958.           your conferences.
  959.           
  960.               The Conference Manager is located in the main SysOp menu.
  961.           Upon entering, you will be asked whether you wish to edit a
  962.           message or a file conference. Select the appropriate option.
  963.           You will be taken to the main menu of the manager. It looks a
  964.           bit like this:
  965.           
  966.           
  967.            Add Conference      Edit Conference
  968.            Delete Conference   Change Type
  969.            Users w/Access      Reorder
  970.            List                Quit
  971.           
  972.           
  973.           
  974.           Add/Edit/Delete/List        - These are quite self-
  975.                                         explanatory.
  976.           Reorder                     - Will allow you to change the
  977.                                         order of your conferences.
  978.                                         (ie: Making Conference 2 into
  979.                                         Conference 1)
  980.           Users with Access           - This command will display a
  981.                                         listing of all users that have
  982.                                         access to the conference.
  983.           
  984.               When you wish to add/edit a conference, you are presented
  985.           with the following:
  986.           
  987.           Description    :  Oblivion/2 Support
  988.           ACS            :  S25
  989.           Conference ID  :  1
  990.           Password       :
  991.           
  992.           Description        -  This is the name of the current
  993.                                 conference.
  994.           ACS                -  This is the ACS required to enter the
  995.                                 conference.
  996.           Password           -  This is the password required to enter
  997.                                 the conference.
  998.           Conference ID      -  This number is used internally by
  999.                                 Oblivion/2 to tell the BBS which
  1000.                                 conference is which. You must use this
  1001.                                 number when working with the JT, and JF
  1002.                                 menu commands. It's also used in the
  1003.                                 sub/file area listing when you don't
  1004.                                 use repeat method screens.
  1005.           
  1006.                         SECTION 7: SYSOP ONLINE FUNCTIONS
  1007.                         ─────────────────────────────────
  1008.           
  1009.                Oblivion/2 v2.0 was designed specifically with the SysOp
  1010.           in mind. There are a few global SysOp commands that can be
  1011.           accessed via the local terminal. You can also get a listing
  1012.           of these keys by pressing ALT-H from within the program.
  1013.           
  1014.           F1     - Bring User Into Chat mode  (Split-Screen)
  1015.           F2     - Bring User Into Chat mode  (One line)
  1016.           F3     - User Editor
  1017.           F4     - Scrollback Buffer
  1018.           F5     - Screen Image
  1019.           F9     - Input Lockout (Locks incoming data from modem)
  1020.           F10    - Output Lockout (Locks BBS output to modem)
  1021.           ALT-A  - Toggle chat availability
  1022.           ALT-B  - Toggle Status Bar (on/off)
  1023.           ALT-N  - Nuke User (Hangs up)
  1024.           ALT-M  - Access to all message bases
  1025.           ALT-X  - Access to all file areas
  1026.           ALT-T  - Temporary SysOp access
  1027.           ALT-J  - SysOp Shell to DOS
  1028.           ALT-V  - Validate user
  1029.           
  1030.                                    EVENT EDITOR
  1031.                                    ────────────
  1032.           
  1033.                One of the many great features of Oblivion/2 is its
  1034.           powerful event editing system. With the internal event
  1035.           editor, you're able to perform most any daily maintainence
  1036.           you wish, toggle SysOp availability, and much more. There are
  1037.           four basic types of events. They are:
  1038.           
  1039.           Errorlevel  - BBS exits at a certain errorlevel to run batch
  1040.                         files.
  1041.           Code        - Executes one or more menu commands with full
  1042.                         CString support.
  1043.           Availability- Toggles on/off SysOp availability.
  1044.           User ACS    - Allows you to define ACS required to login to
  1045.                         the BBS at certain times.
  1046.           
  1047.                Errorlevel events are ones in which the BBS will exit at
  1048.           an errorlevel of your choice, and run a batch file, or other
  1049.           program of your choice. To make the BBS run a batch file, you
  1050.           need to add statements to your batch file that runs the BBS.
  1051.           They will look similar to this:
  1052.           
  1053.           If errorlevel xx then runme.bat  (Use batch knowledge)
  1054.           
  1055.           Define your errorlevel, and replace xx with that level.
  1056.           Assign a time for this event, and away it goes.
  1057.           
  1058.                Code events are probably the most useful. They allow you
  1059.           to perform certain menu commands with full CString support at
  1060.           any hour of the day. The uses for this are endless. One
  1061.           example is packing the Email. This should be done often to
  1062.           keep the Email system quick. To do this, add a 'Code' event
  1063.           that runs the Command Keys "EZ". Assign a time for it, and
  1064.           away it goes.
  1065.           
  1066.                SysOp availability is toggled through the event editor.
  1067.           You can toggle when the SysOp is in/out by using this event
  1068.           type. Select Availability event, and toggle whether it is to
  1069.           be when the SysOp is available or not. Assign a time, and
  1070.           thats it.
  1071.           
  1072.                The final event type is User ACS. This event type is
  1073.           used to restrict BBS logins to certain ACS requirements. For
  1074.           example, you can make it so that only user 20 can log into
  1075.           the system at 5:00am to 6:00am. Add a User ACS event, and
  1076.           make the ACS "U20" (No "" marks). Add 5:00 am as the start
  1077.           time, and 6:00 am for the end time. Simple as that.
  1078.           
  1079.                The commandline switch -E is used to execute your events
  1080.           if you're running FD. When running any type of mailer,
  1081.           chances are that the BBS will miss its events. If the time
  1082.           has already passed (Say you've got an event scheduled to pack
  1083.           the message bases at 2:00am), Obv/2 will run that 2:00am
  1084.           event. (Only if its past 2:00am)
  1085.           
  1086.           
  1087.           
  1088.                                   STRING EDITOR
  1089.                                   ─────────────
  1090.           
  1091.                With new versions of Oblivion/2, string editing has
  1092.           become much easier. You no longer need to compile your
  1093.           strings, the BBS will do it all for you.
  1094.           
  1095.                This new version now has an online string editor. Some
  1096.           features include: strings of up to 255 characters, being able
  1097.           to use filenames in place of strings, and customized
  1098.           variables for displaying BBS information in your strings.
  1099.           
  1100.                Moving around in the editor is quite simple. Press [,]
  1101.           to view 5 more strings. When you see a string that you wish
  1102.           to edit, press that strings corresponding number. The BBS
  1103.           will then allow you to edit that string on the lower half of
  1104.           the screen. You may use CTRL-V to toggle insert mode, and use
  1105.           CTRL-U as an ascii chart. (Use the cursor to pick the upper
  1106.           ASCII character you want, and it will be printed in the
  1107.           cursor's current position in your string).
  1108.           
  1109.                Notice that when you see your strings, you'll see 2
  1110.           lines for each string. The upper line is what the string
  1111.           description is, and the lower line is what you've configured
  1112.           that string to be.
  1113.           
  1114.                You may use |Ux (1-6) for each of the six user colors.
  1115.           You can also use |01-15 to force a certain color. |OT, and
  1116.           |O2 are internal variable MCI codes that the BBS uses to
  1117.           place information. If you see one of the prompts with a |OT,
  1118.           or |O2, make sure that your string also has one.
  1119.           
  1120.                Another approach to string editing is filenames. You can
  1121.           have the BBS print a file instead of a string. This comes in
  1122.           handy for places where you just need to put more information.
  1123.           For example, you might want to configure your message reading
  1124.           string, or file newscanning string to use a textfile. This is
  1125.           a simple process. Create your ANSI, and place it into your
  1126.           textfile directory. Use %%FILENAME.EXT for that string in
  1127.           your editor. This will force the BBS to read that string from
  1128.           the file. In this external file, you may use 3 percent codes:
  1129.           %IN, %OT, and %O2. %IN tells the BBS where to place the
  1130.           cursor after the screen has been drawn. Use this to place
  1131.           user input anywhere you want. The input color will be the
  1132.           same as the color that you use with %IN. Like above %OT, and
  1133.           %O2 are information placers.  Only use them if the original
  1134.           string has them.
  1135.           
  1136.                You should run the Oblivion/2 Utility MAKEPROM.EXE when
  1137.           you are instructed to by us. This updates your prompts
  1138.           automatically. It saves a lot of time, and is better than the
  1139.           old PROMPTS.TXT way of doing things. Make sure not to run the
  1140.           program more than one time, as it could lead to damage of
  1141.           your string file!
  1142.           
  1143.                                 MENU PROMPT EDITOR
  1144.                                 ──────────────────
  1145.           
  1146.                The menu prompt editor allows you to configure many
  1147.           different prompts, and have your users choose which one they
  1148.           like. These prompts can range from something simple like
  1149.           this:
  1150.           
  1151.           Main Menu:
  1152.           
  1153.           to something more extravagant:
  1154.           
  1155.           [10:06 pm EST]
  1156.           [Main Menu] [?/Help]:
  1157.           
  1158.                The operations of this editor are quite self-
  1159.           explanatory. When making menu prompts, you'll be in the
  1160.           Fullscreen editor. There are several MCI codes that you'll be
  1161.           able to use in your prompts.
  1162.           
  1163.           |01-|15 : ANSI colors from 01-15
  1164.           |MN     : Menu Name (Name in prompt in Menu editor)
  1165.           |TL     : Time Left
  1166.           |TN     : Time Now
  1167.           |FLxx   : Sets input length to xx
  1168.           |RC     : Regular Color
  1169.           |SC     : Status Color
  1170.           |PC     : Prompt Color
  1171.           |EC     : Input Color
  1172.           |VC     : Inverse Color
  1173.           |XC     : Box Color
  1174.           |Ux     : Moves up x amount of lines
  1175.           |Dx     : Moves down x amount of lines
  1176.           |Fx     : Moves forward x spaces
  1177.           |Bx     : Moves backward x spaces
  1178.           |Xxx    : Moves to absolute X value. ie: |X10 moves to the
  1179.                     10th row
  1180.           
  1181.                                  PROTOCOL EDITOR
  1182.                                  ───────────────
  1183.           
  1184.                With version 2.xx of Oblivion/2, protocol editing has
  1185.           been made much easier. All protocol setup is done internally.
  1186.           
  1187.                When you first enter the protocol editor. You'll be
  1188.           asked which type of protocols you want to edit. There's four
  1189.           types of protocols: Single File, Batch, Resume, and
  1190.           Bidirectional.  Single File protocols (both upload and
  1191.           download) are used in sending QWK Packets, Receiving REP
  1192.           Packets, Receiving Filemail, Sending Memorized Messages,
  1193.           Sending Complete File Lists, etc.  Batch Protocols are the
  1194.           heart of the file system. Resume Protocols are used to let a
  1195.           user resume an uncompleted upload. (Only some protocols
  1196.           support this, DSZ, MPT, HS-Link are a few examples)
  1197.           
  1198.                Once you've selected which type of protocol you want to
  1199.           edit, you'll be placed in an Oblivion/2 Box editor. The
  1200.           options available from this screen are: Description, Key,
  1201.           Program Name, and Commandline. Description is the description
  1202.           you want to give the protocol. (ie: Zmodem Mobyturbo). Key is
  1203.           the KEY that users must press to activate that protocol. (for
  1204.           Zmodem, this could be Z). Program Name is the protocol
  1205.           executable itself. (For Zmodem, DSZ.COM, or GSZ.EXE) Finally,
  1206.           the commandline options are to be placed in the commandline
  1207.           string. (See the DSZ documentation for the best string to
  1208.           use)
  1209.           
  1210.                                  PARAMETER EDITOR
  1211.                                  ────────────────
  1212.           
  1213.                The parameter editor is a quick and easy way of
  1214.           utilizing levels. What the editor does is allow you to define
  1215.           a level (lets say 50), and let you give that level certain
  1216.           PCR, UD, UD K, Time, DL K PER DAY ratios, and various
  1217.           expiration values.
  1218.           
  1219.                To use the editor, just create a level (say 50). Then,
  1220.           enter in level 50's PCR, UD, UD K, TIME and DL K PER DAY
  1221.           ratios/values. Now, when someone's given level 50 from the
  1222.           user editor, they'll get these specified amounts.
  1223.           
  1224.                You can now also specify a # of days til expiration, and
  1225.           the level that the user will receive when his account expires
  1226.           for each level in your parameter editor.
  1227.           
  1228.                The unique feature of this Paramater editor is that it
  1229.           can be totally invisible to the SysOp if he/she desires. In
  1230.           your CONFIG, under 'Validated User Levels' there are a few
  1231.           'Default XXXX level' entries. Should you wish to use the
  1232.           parameter editor, change those values from whatever they may
  1233.           be to zero. (Do this only for the Default UD, UD K, DL K per
  1234.           day, Time etc. Do not change Average CPS to 0). When the
  1235.           value is Zero, it tells Obv/2 to read from the parameter
  1236.           editor values. Should you wish not to use this editor, change
  1237.           the values to whatever you wish. The parameter editor will
  1238.           have no function.
  1239.           
  1240.                If you want to change a certain field for a certain
  1241.           user, it's simple. Say you wanted to give Joe User 30 minutes
  1242.           instead of 15 mins. (Say level 50 had 15 mins in it). You'd
  1243.           then go to the user editor. Option 'time left' should be
  1244.           changed to 30. Thats it.
  1245.           
  1246.                Please note, in the user editor, DL K per DAY, Time, UD,
  1247.           UD K, and PCR must all be zero. The parameter system will
  1248.           only look at those values in the parameter editor if the
  1249.           values for the above, in the user editor, are zero. There is
  1250.           a function in the editor which allows you to Zero-Out certain
  1251.           levels of users, so that they can follow the parameters. Also
  1252.           note that the default CONFIG levels must also be zero for the
  1253.           parameter editor to take effect. If they're not, the
  1254.           parameter editor will not function correctly.
  1255.           
  1256.           
  1257.                                    USER EDITOR
  1258.                                    ───────────
  1259.           
  1260.                The user editor in 2.xx has been completely overhauled.
  1261.           It's now completely batch oriented, and allows for many new
  1262.           options. A few of these include Infoform Extraction,
  1263.           Searching, Quick Loading of Users, Highlight Selected User
  1264.           Editing and more.
  1265.           
  1266.                When you first select the user edit option, you'll be
  1267.           asked 'Edit Individual' If you pick yes, the BBS will prompt
  1268.           you to enter a username. If you select no, the BBS will clear
  1269.           screen, and print 23 user names, and let you select them with
  1270.           a highlight bar. Hit "Q" to quit that process, or RETURN to
  1271.           select the highlighted user.
  1272.           
  1273.                Once inside the editor, you'll find a myriad of
  1274.           configurable options. Note a few important keys: [,] move to
  1275.           the previous/next user. {,} move to the previous/next user in
  1276.           your search link. * extracts the selected Infoform to a file.
  1277.           Finally, S takes you into the Search Editor. It looks like
  1278.           this:
  1279.           
  1280.           (H) Handle String  : [OFF]
  1281.           (A) ACS            : [OFF]
  1282.           (L) Level          : [OFF] - [OFF]
  1283.           (F) File Level     : [OFF] - [OFF]
  1284.           (D) Days Since 1st : [OFF] - [OFF]
  1285.           (S) Days Since Last: [OFF] - [OFF]
  1286.           (E) Flag           : [OFF]
  1287.           (N) Number of Calls: [OFF] - [OFF]
  1288.           (Y) Age            : [OFF] - [OFF]
  1289.           (G) Gender         : [OFF]
  1290.           (P) PCR            : [OFF] - [OFF]
  1291.           (U) % U/D Ratio    : [OFF] - [OFF]
  1292.           (K) % U/D K Ratio  : [OFF] - [OFF]
  1293.           (X) Expiration Date: [OFF] - [OFF]
  1294.           (T) Tabulate Search
  1295.           
  1296.                This unique editor allow you to have the BBS search for
  1297.           specific users, using your search criteria, and let you edit
  1298.           all of them easily. This makes manual changes a breeze.
  1299.           
  1300.                The options above are pretty self-explanatory. Make sure
  1301.           to press "T" to 'Tabulate Search' If you don't, your search
  1302.           won't run, and you'll lose your search criteria.
  1303.           
  1304.                When in the user editor, use the {,} keys for quick
  1305.           backward/forward progress in your search editing.
  1306.           
  1307.                                SECTION 8: INFOFORMS
  1308.                                ────────────────────
  1309.           
  1310.                Infoforms are a sysop's easy way of keeping information
  1311.           about his users. Usually, when you login to a BBS, you'll be
  1312.           asked to fill out forms. Sometimes forms are used as
  1313.           applications to groups or whatnot. None the less, they are
  1314.           very useful in storing information.
  1315.           
  1316.               Making Ansi or Ascii infoforms is quite simple. For Ascii
  1317.           infoforms create your ascii file with questions, and using
  1318.           Qedit or any similar text editor use one of these following
  1319.           characters depending on what you wish to do:
  1320.           
  1321.           *    -- Waits for a response. (Abortable)
  1322.           |Xx  -- Limits User input to x spaces.
  1323.           
  1324.                           SECTION 9: MAKING REPEAT ANSIS
  1325.                           ──────────────────────────────
  1326.           
  1327.               In an effort to add more configurability to Obv/2, we've
  1328.           created the 'Repeat Method' of making ANSI screens. These
  1329.           screens are used all around the BBS. Some areas include:
  1330.           Message base/File Area Listings, One Liners, Rumors, User
  1331.           Listing, Last Caller Listing, BBS Listing and more. Its
  1332.           important that you learn how these work. Please read
  1333.           carefully.
  1334.           
  1335.           
  1336.               In the repeat method, there are 3 screens for each type
  1337.           of listing. The first, an intro, the second is the actual way
  1338.           to repeat, and the 3rd is an ending.
  1339.           
  1340.           For example, to make a messge base listing that looked like
  1341.           this:
  1342.           
  1343.           
  1344.           Base         Description                        Sponsor
  1345.           ─────────────────────────────────────────────────────────────
  1346.           1            General Talk                       Lord Tracer
  1347.           2            BBS Advertisements                 Lord Tracer
  1348.           ─────────────────────────────────────────────────────────────
  1349.           
  1350.           The 3 files used in message base listing are:
  1351.           
  1352.           SUBSSRT.ANS - Intro to listing
  1353.           SUBSMID.ANS  - Middlle (This uses MCI codes, and is the one
  1354.                          that will be repeated)
  1355.           SUBSEND.ANS  - The end of the listing.
  1356.           
  1357.           
  1358.           Our SUBSTART.ANS would look like this:
  1359.           
  1360.           Base         Description                        Sponsor
  1361.           ─────────────────────────────────────────────────────────────
  1362.           
  1363.           Our SUBSMID.ANS would look like this:
  1364.           
  1365.           |AN          |BN                                |SS
  1366.           
  1367.           Our SUBSEND.ANS would look like this:
  1368.           
  1369.           ─────────────────────────────────────────────────────────────
  1370.           
  1371.           
  1372.               As you can see, the system is very easy to use, and is
  1373.           very versatile. Please note that each screen type has certain
  1374.           MCI codes that go with it. Only in Data Areas can you define
  1375.           your own MCI codes. These are as follows:
  1376.           
  1377.           
  1378.           SUBSSTAR.ANS - Message Base Listing Start
  1379.           SUBSMID.ANS - Message Base Listing Middle
  1380.             |AN - Base Number
  1381.             |BN - Base Name
  1382.             |SS - Sponsor
  1383.           SUBSEND.ANS - Message Base Listing End
  1384.           
  1385.           AREASTAR.ANS - File Area Listing Start
  1386.           AREAMID.ANS - File Area Listing Middle
  1387.             |AN - Area Number
  1388.             |AI - Area Name
  1389.             |AS - Area Sponsor
  1390.           AREAEND.ANS - File Area Listing End
  1391.           
  1392.           
  1393.           USERSTAR.ANS - User Listing Start
  1394.           USERMID.ANS - User Listing Middle
  1395.             |UH - User Handle
  1396.             |LE - Level
  1397.             |UN - User Note
  1398.             |AC - Area Code
  1399.             |LC - Last Call
  1400.           USEREND.ANS - User Listing End
  1401.           
  1402.           LASTSRT.ANS - Recent Callers Start
  1403.           LASTMID.ANS - Recent Callers Middle
  1404.             |UH - User Handle
  1405.             |DO - Date On
  1406.             |TO - Time On
  1407.             |BR - Baud Rate
  1408.           LASTEND.ANS - Recent Callers End
  1409.           
  1410.                         SECTION 10: MAKING STANDARD ANSIS
  1411.                         ─────────────────────────────────
  1412.           
  1413.               When making the animated statistic screens, such as a new
  1414.           Main User Stat screen, a few simple rules must be followed.
  1415.           Screens should be made in this manner to insure that they
  1416.           will work correctly with Oblivion/2.
  1417.           
  1418.               These are the instructions to make a non-animated status
  1419.           screen. Animated Status screens require a bit more work and
  1420.           will require maintenance if they are not correctly made.
  1421.           
  1422.           To make Stat Screens w/o Complex Animations, follow these
  1423.           steps:
  1424.           
  1425.           1] Draw Basic Screen.
  1426.           2] Put Thedraw into ANIMATION Mode. And when prompted to
  1427.              select scanning method, use "TOP" (Others may work, but
  1428.              this is standard.)
  1429.           3] Add the Appropriate MCI Codes, some external screens use
  1430.              the |xx codes and others use the %xx codes. Make sure you
  1431.              use the right ones.
  1432.           4] After you've finished adding the MCI Codes, Save Animation
  1433.              in Ansi file format.  Select Clear Screen, and Maximum
  1434.              line length to 255.  Again, other numbers work, but this
  1435.              is standard.
  1436.           
  1437.               If your MCI codes seem out of place (ie: The stat isn't
  1438.           showing up where I put the MCI code for it), this could be
  1439.           one of two things.
  1440.           
  1441.           1] |xx codes were used instead of %xx and vice versa.
  1442.           2] Thedraw has expanded the MCI codes and Oblivion/2 cannot
  1443.              recognize them.
  1444.           
  1445.               If you used the right type of MCI codes, chances are that
  1446.           your problem is #2.  Thedraw has a nasty habit of expanding
  1447.           MCI codes to more than 3 letters, therefore making them
  1448.           unrecognizable to Oblivion/2.  There is a solution to this,
  1449.           ANSITRAN.EXE was written by Darkened Enmity to combat this
  1450.           problem. It is included in the distribution ZIP.  Here
  1451.           are the instructions for using this utility:
  1452.           
  1453.           1] Save ANSI in 80 character per line mode. With whatever
  1454.              preparation you've previously chosen.
  1455.           2] Run ANSITRAN filename to correct the MCI bug.
  1456.           
  1457.           
  1458.           Another Screen that requires Attention is CONFSCR.ANS
  1459.           
  1460.               Use the appropriate |xx codes for this screen, but there
  1461.           is a difference in this screen than in others. When making
  1462.           your ansi, you MUST make the Color Bar.  Use Ansi Block
  1463.           Characters to make the bar.  ALL COLORS 0-15 must be in this
  1464.           bar if you want it to work correctly.  After you have
  1465.           made the main ansi with the color bar, put it into Top Scan
  1466.           Animation. Add the |xx codes.  When you are adding the |CB
  1467.           code (|CB is color bar), put this code OVER the Black on
  1468.           Black Box.  It will look a bit like this.
  1469.           
  1470.           0123456789ABCDE  (You'll have boxes, numbers are used only
  1471.                             for example)
  1472.           
  1473.           |CB go right over 0,1, and 2.
  1474.           
  1475.           An example will be provided for you.
  1476.           
  1477.                SECTION 11: MCI CODES / SYSOP CONFIGURABLE TEXTFILES
  1478.                ────────────────────────────────────────────────────
  1479.           
  1480.           STANDARD CODES: All preceeded with %
  1481.           
  1482.           UN Handle
  1483.           RN Real Name
  1484.           PN Phone Number
  1485.           AD Address
  1486.           LO Location
  1487.           UC UserNote
  1488.           UL Level
  1489.           FL File level
  1490.           FP File Points
  1491.           UK Uploaded K
  1492.           DK Downloaded K
  1493.           UP Uploads
  1494.           DN Downloads
  1495.           PS Posts
  1496.           CS Calls
  1497.           TL Time Left
  1498.           NF New Files
  1499.           NP New Posts
  1500.           CR Connect Rate
  1501.           TT Daily Time Limit
  1502.           LC Last Caller
  1503.           TC Total Calls
  1504.           CT Calls Today
  1505.           FT Files Uploadded or Added Today
  1506.           PT Messages Posts Today
  1507.           NT New Users Today
  1508.           UU User Number
  1509.           BN Board Name
  1510.           SN Sysop Name
  1511.           DT Date
  1512.           TM Time
  1513.           SS Current Status Screen Library Name
  1514.           MS Current Menu Library Name
  1515.           PC Post/Call Ratio
  1516.           NR U/D Ratio
  1517.           KR U/D K Ratio
  1518.           LD Last On Date
  1519.           UA Makes anything below it unabortable. Use it for screens
  1520.              that you want to force users to see.
  1521.           CA Current Area
  1522.           CB Current Base
  1523.           DU Days until expiration
  1524.           
  1525.           ANSIS IN STATUS SCREEN LIBRARIES:
  1526.           
  1527.           BCHANGE.ANS - Message Base Changing Ansi
  1528.             |SN - Base Name
  1529.             |SS - Base Sponsor
  1530.             |NM - Number of Messages
  1531.             |UP - Number of Posts you made
  1532.             |LR - Last Read
  1533.             |DT - Date
  1534.             |TI - Time
  1535.           
  1536.           HDR.ANS - Message
  1537.             |HM - Header Message
  1538.             |LH - Repeats next character for as many characters there
  1539.                   are in the header message
  1540.             |CC - Repeats next character for as many characters as are
  1541.                   needed such that four |CC and |HM fill a line.
  1542.             |CH - Displays a centered header message
  1543.           
  1544.           HEADER.ANS - Message Header
  1545.             |BN - Base Name
  1546.             |RT - Message to which current is a reply
  1547.             |MN - Message Number
  1548.             |OU - Total Messages
  1549.             |TL - Title
  1550.             |UN - Poster's Note
  1551.             |FM - Poster's Name
  1552.             |DT - Date Posted
  1553.             |TI - Time Posted
  1554.             |TO - Sent To
  1555.             |ST - Status
  1556.           
  1557.           CONFSCR.ANS - User Config Screen
  1558.             |CB - Color Bar Starting
  1559.             |FS - Full Screen Editor Toggle
  1560.             |PL - Page Length
  1561.             |DP - Pause
  1562.             |AD - Address
  1563.             |LC - Location
  1564.             |RC - Regular Color
  1565.             |PC - Prompt Color
  1566.             |IC - Input Color
  1567.             |VC - Inverse Color
  1568.             |SC - Status Color
  1569.             |BC - Box Color
  1570.             |CP - Current Prompt
  1571.             |EP - Emulation
  1572.             |CM - Current Menu
  1573.             |CS - Current Status Screen
  1574.             |RR - Reply Reading
  1575.             |UN - User Note
  1576.             |YN - Yes No Bars
  1577.             |RM - Redisplay Message
  1578.             &xy - X = User flag. Y = Key to toggle flag.
  1579.                 - With this code, you can add in your own configuration
  1580.                 - options.
  1581.           
  1582.           
  1583.           FCONFIGS.ANS - File List Config Screen
  1584.             |O1 - Option 1 - Status Points
  1585.             |O2 - Option 2 - Points
  1586.             |O3 - Option 3 - Size
  1587.             |O4 - Option 4 - Date Uploaded
  1588.             |O5 - Option 5 - Downloads
  1589.             |O6 - Option 6 - Uploader
  1590.             |O7 - Option 7 - File Description
  1591.             |US - Used Space
  1592.             |EX - Example
  1593.           
  1594.           FSEHEAD.ANS - Full Screen Editor Header
  1595.             |TI - Title
  1596.             |ST - Send To
  1597.             |AN - Anonymous
  1598.             |AU - Autosig
  1599.             |DT - Date
  1600.             |TM - Time
  1601.           
  1602.           SUBSSTAR.ANS - Base Listing Start
  1603.           
  1604.           SUBSMID.ANS - Base Listing Middle
  1605.             |AN - Base Number
  1606.             |BN - Base Name
  1607.             |SS - Sponsor
  1608.           
  1609.           SUBSEND.ANS - Base Listing End
  1610.           
  1611.           FHEADER.ANS - File List Header
  1612.             |FH - Line of Information
  1613.           
  1614.           STATUS.ANS - User's Status
  1615.             Standard Codes
  1616.           
  1617.           FILESTAT.ANS - User's File Status
  1618.             Standard Codes
  1619.           
  1620.           USERSTAT.ANS - User's Stats
  1621.             Standard Codes
  1622.           
  1623.           AREASTAR.ANS - File Area Listing Start
  1624.           
  1625.           AREAMID.ANS - File Area Listing Middle
  1626.             |AN - Area Number
  1627.             |AI - Area Name
  1628.             |AS - Area Sponsor
  1629.           
  1630.           AREAEND.ANS - File Area Listing End
  1631.           
  1632.           NEWSHEAD.ANS - News Header
  1633.             |BN - Base Name
  1634.             |RT - Message to which current is a reply
  1635.             |MN - Message Number
  1636.             |OU - Total Messages
  1637.             |TL - Title
  1638.             |UN - Poster's Note
  1639.             |FM - Poster's Name
  1640.             |DT - Date Posted
  1641.             |TI - Time Posted
  1642.             |TO - Sent To
  1643.             |ST - Status
  1644.           
  1645.           USERSTAR.ANS - User Listing Start
  1646.           
  1647.           USERMID.ANS - User Listing Middle
  1648.             |UH - User Handle
  1649.             |LE - Level
  1650.             |UN - User Note
  1651.             |AC - Area Code
  1652.             |LC - Last Call
  1653.           
  1654.           USEREND.ANS - User Listing End
  1655.           
  1656.           LASTSRT.ANS - Recent Callers Start
  1657.           
  1658.           LASTMID.ANS - Recent Callers Middle
  1659.             |UH - User Handle
  1660.             |DO - Date On
  1661.             |TO - Time On
  1662.             |BR - Baud Rate
  1663.           
  1664.           LASTEND.ANS - Recent Callers End
  1665.           
  1666.           OTHER: (Not in STAT libraries)
  1667.           
  1668.           SYSPASS.ANS - System Password Ansi
  1669.             |PP  - Place to prompt for password
  1670.             |BP  - Place to put any error messages
  1671.           
  1672.           USERLOG.ANS  - Username Ansi
  1673.             |NP  - Place to prompt for username
  1674.             |PP  - Place to prompt for password
  1675.             |QP  - Place to prompt 'Use xx for quicker login'
  1676.             |IP  - Place to prompt 'Invalid User name'
  1677.           
  1678.           FILE DESCRIPTION CONFIG MCI CODES:
  1679.           
  1680.           |DE - Main description line.
  1681.           |Dx - Extended description line.
  1682.           |TC - Size uncompressed.
  1683.           |CC - Size compressed.
  1684.           |UL - Uploader of file.
  1685.           |UD - Date of upload.
  1686.           |TM - Time of upload.
  1687.           
  1688.           PRINTED FILES: ALL use standard codes:
  1689.           
  1690.           NOTLEFT .ANS - No Time Left
  1691.           WELCOME .XXX - Welcome Screen
  1692.           EXPIRED .BBS - Account Expired
  1693.           SLOWBAUD.ANS - User's baud rate is too low and does not know
  1694.                          lockout pass
  1695.           PRELOGON.ANS - Prelogon Screen
  1696.           TOONODE .ANS - User already on another node
  1697.           CHECKED .XXX - User checked for access, but has level less
  1698.                          than zero XXX is a level less than 0 that the
  1699.                          user has.
  1700.           PRINT   .APP - User starts applying
  1701.           NUPBAD  .APP - Does not know NUP
  1702.           BLACKLST.ANS - User in Blacklist
  1703.           LETTER  .APP - Send letter to the sysop during application
  1704.           DONE    .APP - User done applying
  1705.           ENOUGH  .ANS - User paged more than the specified times
  1706.           GOODBYE .ANS - User logging off
  1707.           SUBS    .XXX - User viewing message base listing where XXX is
  1708.                          the conference ID, external listings are on,
  1709.                          but repeat method is not.
  1710.           XFER    .XXX - User viewing file area listing where XXX is
  1711.                          the conference ID, external listings are on,
  1712.                          but repeat method is not. (Conference ID's can
  1713.                          be found in the Conference Editor)
  1714.           LINEMENU.ANS - Help Screen for the Line Editor
  1715.           ULCHECK.ANS  - Upload checker display screen.
  1716.           SYSPASS.ANS  - Ansi displayed when prompting for System
  1717.                          Password
  1718.           USERLOG.ANS  - Ansi displayed when prompting for user
  1719.                          username and password.
  1720.           
  1721.                           SECTION 12: CONFIGURABLE CHAT
  1722.                           ─────────────────────────────
  1723.           
  1724.               Configurable Chat was added to allow for more
  1725.           configuration for the SysOp, therefore making his board
  1726.           different than anybody else's.  You can make horizontal split
  1727.           screen chats, vertical ones, diagonal ones, or anything that
  1728.           pops into your head. To make a chat follow the following
  1729.           instructions:
  1730.           
  1731.           1] Create the design for your chat, name this CHATDEF.ANS
  1732.              It will be placed in the TEXTFILE directory when you're
  1733.              all done.
  1734.           2] Put CHATDEF.ANS into Animation Mode, and use TOP Scan.
  1735.           3] You must now create the "Margins" for the SysOp side of
  1736.              the chat, and the user's side of the chat.  To do this,
  1737.              you'll need some MCI codes.  For the left border of each
  1738.              line of the SysOp's side, You use ^xx, and for the right
  1739.              margin of the SysOp's type, use &xx.  Do the same for the
  1740.              user side. Here are the codes for the user side, `xx for
  1741.              the left, and ~xx for the right margin.  These MCI codes
  1742.              will tell Oblivion/2 where to wordwrap each line. Here is
  1743.              an example Horizontal Split Screen Chat (Non-animated, of
  1744.              course). This will help you to get the idea of what you
  1745.              must do.
  1746.           
  1747.           ^01                                                      &01
  1748.           ^02                                                      &02
  1749.           ^03                                                      &03
  1750.           ^04                                                      &04
  1751.           ────────|SN───────────────Split Screen Chat───|UN───────────
  1752.           `01                                                      ~01
  1753.           `02                                                      ~02
  1754.           `03                                                      ~03
  1755.           `04                                                      ~04
  1756.           
  1757.           
  1758.               As you can see, the start MCI code will tell the program
  1759.           where to start typing, and the end MCI code will tell the
  1760.           program where to wordwrap.  If you notice, the xx has been
  1761.           replaced by numbers.  Each line must have a number, so Line
  1762.           01 will wordwrap onto Line 02. So, don't mix up the numbers
  1763.           or you'll have a REAL MESS! If you notice in the example, the
  1764.           end MCI codes have been placed right at the end of the line.
  1765.           This is because the wordwrap starts where the MCI code
  1766.           starts. Placing them as they are above will prevent any
  1767.           problems that could arise.  Place them in that fashion when
  1768.           you make your own.  Another thing to notice is the |SN and
  1769.           |UN. |SN is the MCI code for the SysOp Name, and |UN is the
  1770.           pipe code for the current user name.  These are NOT required
  1771.           in your screen. So if you want to play some kind of game with
  1772.           the user, you can do that too.
  1773.           
  1774.           4] Save the Screen, and use the ANSITRAN.EXE utility if it
  1775.              doesn't show up properly.  See the docs of ANSITRAN for
  1776.              more info.
  1777.           
  1778.                There are a few options that SysOps and users can use in
  1779.           the chat mode:
  1780.           
  1781.           /TYPE - Allows the SysOp to type any file in the textfile
  1782.                   directory.
  1783.           /PAGE - In one line chat, /PAGE will page the SysOp. In split
  1784.                   screen chat, /PAGE will page the user.
  1785.           
  1786.                              SECTION 13: MENU EDITOR
  1787.                              ───────────────────────
  1788.           
  1789.           Introduction...............................
  1790.           "-" Control Commands.......................
  1791.           "&" MultiNode Commands.....................
  1792.           "{" Matrix Commands........................
  1793.           "!" Global Newscan Commands................
  1794.           "[" Main Menu Commands.....................
  1795.           "." Door Commands..........................
  1796.           "*" SysOp Commands.........................
  1797.           "^" New User Voting Commands...............
  1798.           "C" Conference Editor Commands.............
  1799.           "D" Data Commands..........................
  1800.           "E" Email Commands.........................
  1801.           "F" File Commands..........................
  1802.           "J" Join Conference Commands...............
  1803.           "M" Message Commands.......................
  1804.           "Q" QWKMail Commands.......................
  1805.           "R" Top Ten Listing Commands...............
  1806.           "S" Message Sponsor Commands...............
  1807.           "T" File Sponsor Commands..................
  1808.           "V" Voting Booth Commands..................
  1809.           "+" Color Setting Commands.................
  1810.           Menu Editor Function Over-View.............
  1811.           
  1812.           
  1813.                                    Introduction
  1814.           
  1815.           
  1816.                Oblivion/2 2.0 Menu Editor.  This is, in my opinion, the
  1817.           best feature ever offered in any BBS software.  The menu
  1818.           editor will allow you to modify, customize, or make a totaly
  1819.           unique menu system for your BBS.
  1820.           
  1821.                The Menu Editor is a very simple yet uses a complex
  1822.           system of commands that can be used individualy or stacked.
  1823.           The commands can be restricted to access levels, flags,
  1824.           conferences, age, and a variety other levels.
  1825.           
  1826.                Due to the fact that just about everything in Oblivion/2
  1827.           2.0 can be configured via the Menu Editor, it's pretty much
  1828.           impossible for us to show you examples of how to use every
  1829.           command (Not to mention I doubt anybody would actuly print 25
  1830.           meg of documentation). Instead we've put together a few
  1831.           samples of what can be done, and a descriptive list of all
  1832.           the available commands.  After that is's up to you and your
  1833.           imagination.  Have fun with it & take your time.
  1834.           
  1835.           
  1836.           ------------------------------------------------------------
  1837.                                  "-" = Control Commands
  1838.           ------------------------------------------------------------
  1839.           
  1840.           Command Key: -A
  1841.           Function   : Writes CString into the Header (Use With
  1842.                      : Stacking)
  1843.           CString    : <String You Would Like Displayed>
  1844.           
  1845.           
  1846.           Command Key: -B
  1847.           Function   : Sets the Bad Prompt to CString
  1848.           CString    : <String You Would Like Displayed when an invalid
  1849.                         command is entered, blank if none>
  1850.           
  1851.           
  1852.           Command Key: -C
  1853.           Function   : Clears The FailFlag
  1854.           CString    : None
  1855.           
  1856.           
  1857.           Command Key: -D
  1858.           Function   : Sends CString to the modem.
  1859.           CString    : ~ = .5 sec delay, | = Return, ^X = Ctrl-X
  1860.                      : Note: Make sure to put your modem back
  1861.                      : into online mode after you execute this
  1862.                      : command, otherwise your BBS will be hung.
  1863.                      : Use the ATO command to do this. Also, make
  1864.                      : sure to use the +++ escape sequence to put
  1865.                      : the modem into command mode. Otherwise, your
  1866.                      : commands won't get to the modem.
  1867.           
  1868.           Command Key: -E
  1869.           Function   : Writes Characters with ^ control char support
  1870.           CString    : <String to be displayed>
  1871.           
  1872.           
  1873.           Command Key: -F
  1874.           Function   : Displays A Text Or ANSi File
  1875.           CString    : <FILENAME>
  1876.           
  1877.                      <filename>     A MS-DOS filename.
  1878.           
  1879.                         This command will display a text file located
  1880.                         in the TEXTFILE directory.
  1881.           
  1882.           
  1883.           Command Key: -G
  1884.           Function   : Goes in the x,y position specified in the
  1885.                      : CString
  1886.           CString    : X,Y
  1887.           
  1888.           
  1889.           Command Key: -H
  1890.           Function   : Gets String with Hidden Input
  1891.           CString    : # <Length of Hidden Input String>
  1892.           
  1893.           
  1894.           Command Key: -I
  1895.           Function   : Gets String with Normal Input
  1896.           CString    : # <Length Of Normal Input String>
  1897.           
  1898.           
  1899.           Command Key: -M
  1900.           Function   : If the string inputted with -I or -J is not the
  1901.                      : Cstring the fail flag is set to true.
  1902.           CString    : <String To Check>
  1903.           
  1904.           
  1905.           Command Key: -N
  1906.           Function   : Displays a status screen from the current status
  1907.                        library. (Use this in correspondence with the
  1908.                        STATLIST. textfile to put status screens
  1909.                        anywhere you want.)
  1910.           CString    : <Filename to print>
  1911.                      : IE: STATUS.ANS
  1912.           
  1913.           Command Key: -J
  1914.           Function   : If the Sysop is not Available, the Fail Flag is
  1915.                      : Set to True If he/she is available, the fail
  1916.                      : flag is set to false
  1917.           CString    : None
  1918.           
  1919.           
  1920.           Command Key: -K
  1921.           Function   : Change Starting Menu to CString, so all -^ will
  1922.                        set the fallback to the old starting menu
  1923.           CString    : <Menu Name>
  1924.           
  1925.           
  1926.           Command Key: -L
  1927.           Function   : Clears the Screen
  1928.           CString    : None
  1929.           
  1930.           
  1931.           Command Key: -P
  1932.           Function   : Pauses X Number of seconds
  1933.           CString    : X <Number Of Seconds>
  1934.           
  1935.           
  1936.           Command Key: -Q
  1937.           Function   : Sets the current menu prompt to the value in the
  1938.                      : cstring
  1939.           CString    : <Menu Prompt #>
  1940.           
  1941.           
  1942.           Command Key: -R
  1943.           Function   : Prints a Return
  1944.           CString    : None
  1945.           
  1946.           
  1947.           Command Key: -S
  1948.           Function   : Changes User Flags
  1949.           CString    : <+,-> <Flag Letter>
  1950.           
  1951.                      A "-" followed by certain letters will turn off
  1952.                      That flag in the users account
  1953.           
  1954.                      A "+" Followed by certain letters will trun on
  1955.                      That Flag if it's active in the users account
  1956.           
  1957.           
  1958.           Command Key: -T
  1959.           Function   : Sets the Status Library to the Value in the
  1960.                      : Cstring
  1961.           CString    : <#>
  1962.           
  1963.                      # is the number of any Status Library
  1964.           
  1965.           
  1966.           Command Key: -V
  1967.           Function   : Sets Menu Library to the Value in the CString
  1968.           CString    : <#>
  1969.           
  1970.                      # is the number of any Menu Library
  1971.           
  1972.           
  1973.           Command Key: -U
  1974.           Function   : Sets the Starting Menu to cstring and sets the
  1975.                      : fallback of all the : menus called with the -^
  1976.                      : command to the menu name in the cstring.
  1977.           CString    : <Menu Name>
  1978.           
  1979.                           Menu Name is the name of any menu
  1980.           
  1981.           
  1982.           Command Key: -W
  1983.           Function   : Writes CString in the Log
  1984.           CString    : Whatever You Want Written in the SysOp Log
  1985.           
  1986.           This Command is good for keeping track of your SysOp's
  1987.           And Co-SysOp's By Stacking it with other commands.
  1988.           
  1989.           Command Key: -/
  1990.           Function   : Goes to the menu name in the Cstring and sets
  1991.                      : the fallback to the current menu
  1992.           CString    : Menu You Wanna Go To
  1993.           
  1994.           Command Key: -\
  1995.           Function   : Goes to the fallback menu and sets the fallback
  1996.                      : menu to the previous fallback
  1997.           CString    : Menu You Wanna Go To
  1998.           
  1999.           
  2000.           Command Key: -^
  2001.           Function   : Goes to the menu name in the Cstring and sets
  2002.                      : the fallback to the starting menu
  2003.           CString    : Menu You Wanna Go To
  2004.           
  2005.           
  2006.           Command Key: -*
  2007.           Function   : Sets the input variable usually inputted with -I
  2008.                      : and -J to the string in the Cstring
  2009.           CString    : String
  2010.           
  2011.           
  2012.           Command Key: -=
  2013.           Function   : Sets User Level to value contained in the
  2014.                      : CString
  2015.           CString    : User Level
  2016.                      : (Be carefull w/how you use this one..)
  2017.           
  2018.           
  2019.           Command Key: -&
  2020.           Function   : After The execution of an external program via
  2021.                      : door commands, the errorlevel with which the
  2022.                      : external program exited will be put into the
  2023.                      : input string, the one that is also set with -I,
  2024.                      : -J, and -M.
  2025.           
  2026.           
  2027.           Command Key: -(
  2028.           Function   : Send's The "Hit Return" prompt and waits for a
  2029.                      : return
  2030.           CString    : None
  2031.           
  2032.           
  2033.           Command Key: -{
  2034.           Function   : Goes to the menu specified in the CString,
  2035.                      : but will not execute any FIRSTCMD statements.
  2036.           CString    : <Menu to go to>
  2037.           
  2038.           
  2039.           Command Key: -}
  2040.           Function   : Drops to the previous menu, but will not run any
  2041.                        FIRSTCMD statements.
  2042.           CString    : None
  2043.           
  2044.           
  2045.           Command Key: -:
  2046.           Function   : Toggles locking of output to the modem.
  2047.           CString    : None
  2048.                      : Note: Use this command again to unlock the
  2049.                      : output to the modem.
  2050.           
  2051.           
  2052.           Command Key: -;
  2053.           Function   : Toggles locking input from the modem.
  2054.           CString    : None
  2055.                      : Note: Use this command again to unlock the input
  2056.                      : from the modem.
  2057.           
  2058.           
  2059.           Command Key: -$
  2060.           Function   : Goes to a menu keeping the current fallback menu
  2061.                      : and it will process FIRSTCMD statements.
  2062.           CString    : Menu name to goto.
  2063.           
  2064.           
  2065.           Command Key: -%
  2066.           Function   : Goes to a menu keeping the current fallback menu
  2067.                      : but it won't process FIRSTCMD statements.
  2068.           CString    : Menu name to goto.
  2069.           
  2070.           
  2071.           Command Key: --
  2072.           Function   : Displays and gets input in same format as prompt
  2073.                        string.
  2074.           CString    : None
  2075.           
  2076.           
  2077.           ------------------------------------------------------------
  2078.                                   & = MultiNode Commands
  2079.           ------------------------------------------------------------
  2080.           
  2081.           Command Key: &A
  2082.           Function   : Gets Page Status
  2083.           CString    : None
  2084.           
  2085.           
  2086.           Command Key: &C
  2087.           Function   : Enters Into Multinode Chat
  2088.           CString    : None
  2089.           
  2090.           
  2091.           Command Key: &F
  2092.           Function   : Forces a user into multinode chat
  2093.           CString    : None
  2094.           
  2095.           
  2096.           Command Key: &L
  2097.           Function   : Views the log of a user on the other node.
  2098.           CString    : None
  2099.           
  2100.           
  2101.           Command Key: &M
  2102.           Function   : Sends a MultiNode Message to another node
  2103.           CString    : None
  2104.           
  2105.           
  2106.           Command Key: &N
  2107.           Function   : Allows a user to kick a user off of another node
  2108.           CString    : None
  2109.           
  2110.                      : Make sure to use an appropriate ACS on this
  2111.                      : option so that only certain people can access
  2112.                      : it.
  2113.           
  2114.           
  2115.           Command Key: &S
  2116.           Function   : View MultiNode Status
  2117.           CString    : None
  2118.           
  2119.           
  2120.           -------------------------------------------------------------
  2121.                                   { = Matrix Commands
  2122.           -------------------------------------------------------------
  2123.           
  2124.           
  2125.           Command Key: {A
  2126.           Function   : Applies as New User.  If User completed the
  2127.                      : application, fail flag is set to false,
  2128.                      : otherwise it is true.
  2129.           CString    : None
  2130.           
  2131.           
  2132.           Command Key: {C
  2133.           Function   : Checks User Access.  If User is validated,
  2134.                      : failflag is set to false, otherwise it is true.
  2135.           CString    : None
  2136.           
  2137.           
  2138.           Command Key: {F
  2139.           Function   : Leaves Feedback to the user number contained in
  2140.                        the cstring
  2141.           CString    : User # of the user to send Matrix FeedBack to
  2142.           
  2143.           
  2144.           Command Key: {G
  2145.           Function   : Logs Off From the Matrix
  2146.           CString    : None
  2147.           
  2148.           
  2149.           Command Key: {L
  2150.           Function   : Launches Extra System
  2151.           CString    : System Password,ErrorLevel
  2152.                      : System Password being the Password a user needs
  2153.                      : to get to the extra system, and ErrorLevel the
  2154.                      : Errorlevel that Oblivion/2 would drop at.  (ie
  2155.                      : "GETIN,58" would make the Password GETIN and
  2156.                      : would make Obv/2 drop at an ErrorLevel Of 58)
  2157.           
  2158.           
  2159.           Command Key: {P
  2160.           Function   : Matrix Chat
  2161.           CString    : None
  2162.           
  2163.           
  2164.           Command Key: {S
  2165.           Function   : Loads The Main BBS System
  2166.           CString    : x (Number between 1-999)
  2167.                      : When a CString is specified, PRELOGON.X, an
  2168.                      : USERLOG.X, and SYSPASS.X will be displayed.
  2169.                      : Using CString 1, these files would be printed
  2170.                      : PRELOGON.1, SYSPASS.1 USERLOG.1. Use for
  2171.                      : increased matrix effects.
  2172.           
  2173.           Command Key: {T
  2174.           Function   : Sets FailFlag to false if user is able to get to
  2175.                      : main system through knowing the system password
  2176.                      : and having an account.
  2177.                      : This would be used for stacking commands at the
  2178.                      : matrix without actually logging onto to the
  2179.                      : board.
  2180.           CString    : Same as for {S.
  2181.           
  2182.           Command Key: {X
  2183.           Function   : Drops into the BBS
  2184.           CString    : None
  2185.                      : Use This Command With Caution! - NOTE>
  2186.           
  2187.           
  2188.           
  2189.           -------------------------------------------------------------
  2190.                                   ! = Global Newscan Commands
  2191.           -------------------------------------------------------------
  2192.           
  2193.           
  2194.           Command Key: !A
  2195.           Function   : Scans Message and File Conferences
  2196.           CString    : None
  2197.           
  2198.           
  2199.           Command Key: !F
  2200.           Function   : Scans File Conferences
  2201.           CString    : None
  2202.           
  2203.           
  2204.           Command Key: !M
  2205.           Function   : Scans Message Conference
  2206.           CString    : None
  2207.           
  2208.           
  2209.           -------------------------------------------------------------
  2210.                                   [ = Main Menu Commands
  2211.           -------------------------------------------------------------
  2212.           
  2213.           
  2214.           Command Key: [A
  2215.           Function   : Edits AutoSig
  2216.           CString    : None
  2217.           
  2218.           
  2219.           Command Key: [C
  2220.           Function   : Pages Sysop
  2221.           CString    : None
  2222.           
  2223.           
  2224.           Command Key: [D
  2225.           Function   : Does the Infoform with the value contained in
  2226.                      : the Cstring
  2227.           CString    : Number Of The Infoform To Fill Out
  2228.           
  2229.           
  2230.           Command Key: [F
  2231.           Function   : Fills out infoform into a textfile.
  2232.           CString    : INFOFORM#,TEMPLATE
  2233.                      : TEMPLATE format is a directory, and
  2234.                      : a filename w/o period or extension.
  2235.                      : IE: 1,C:\APPS\OBVAPP
  2236.                      : This would fill out infoform #1, and
  2237.                      : put it into the file OBVAPP.1, then
  2238.                      : OBVAPP.2, etc. These files would be
  2239.                      : located in the C:\APPS\ directory.
  2240.           
  2241.           
  2242.           Command Key: [G
  2243.           Function   : Logs Off
  2244.           CString    : None
  2245.           
  2246.           
  2247.           Command Key: [H
  2248.           Function   : Logs Off without displaying the goodbye ansi
  2249.           CString    : None
  2250.           
  2251.           
  2252.           Command Key: [I
  2253.           Function   : Fills out Infoform
  2254.           CString    : None
  2255.           
  2256.           
  2257.           Command Key: [K
  2258.           Function   : User Configuration (Goes To The "Konfig" Menu)
  2259.           CString    : <valid DOS filename>
  2260.                      : You can create multiple configuration screens
  2261.                      : by telling the BBS which screen to go to. Make
  2262.                      : sure that the screen is in your status screen
  2263.                      : library. (Read the STATCODE section on how to
  2264.                      : code an extra screen in the status libraries)
  2265.           
  2266.           Command Key: [L
  2267.           Function   : Lists Users
  2268.           CString    : None
  2269.           
  2270.           
  2271.           Command Key: [S
  2272.           Function   : System Status
  2273.           CString    : None
  2274.           
  2275.           
  2276.           Command Key: [U
  2277.           Function   : Time Bank
  2278.           CString    : {Maximum Total Time} {Maximum Time to Deposit
  2279.                      : Today} Maximum Total Time Being total time
  2280.                      : allowed in the time bank.  Maximum Time Today
  2281.                      : being the total time allowed per day.  (ie 60 15
  2282.                      : would make a max of 60 minutes and 15 minutes
  2283.                      : per day)
  2284.           
  2285.           
  2286.           
  2287.           Command Key: [V
  2288.           Function   : Views Daily Log
  2289.           CString    : None
  2290.           
  2291.           
  2292.           Command Key: [W
  2293.           Function   : Last Callers
  2294.           CString    : 1-20
  2295.                      : Tells how many callers to list.
  2296.           
  2297.           Command Key: [X
  2298.           Function   : Transfer to User
  2299.           CString    : None
  2300.           
  2301.           
  2302.           Command Key: [Y
  2303.           Function   : Users Status
  2304.           CString    : None
  2305.           
  2306.           
  2307.           Command Key: [+
  2308.           Function   : Change Password
  2309.           CString    : None
  2310.           
  2311.           
  2312.           -------------------------------------------------------------
  2313.                                   . = Door Commands
  2314.           -------------------------------------------------------------
  2315.           
  2316.           
  2317.           Command Key: .E
  2318.           Function   : Executes file in your main BBS Directory (No
  2319.                      : Door File Created)
  2320.           CString    : %1 = Connect Rate
  2321.           
  2322.           
  2323.           Command Key: .N
  2324.           Function   : Makes Door RBBS DORINFO1.DEF File with COM0
  2325.                      : in the DORINFO1.DEF if you are local and
  2326.                        executes file in the door directory
  2327.           CString    : <FILENAME>
  2328.           
  2329.           
  2330.           Command Key: .R
  2331.           Function   : Makes Door RBBS DORINFO1.DEF File with LOCAL in
  2332.                      : the DORINFO1.DEF if you are local and executes
  2333.                      : the file in the door directory
  2334.           CString    : <FILENAME>
  2335.           
  2336.           
  2337.           Command Key: .S
  2338.           Function   : Makes SRE DOOR.SR file and executes the file in
  2339.                      : the door directory
  2340.           CString    : <FILENAME>
  2341.           
  2342.           
  2343.           Command Key: .T
  2344.           Function   : Makes Standard DOOR.SYS file (GAP - TeleGard -
  2345.                      : WildCat 3.0+)
  2346.           
  2347.           
  2348.           
  2349.           
  2350.           
  2351.           -------------------------------------------------------------
  2352.                                   * = Sysop Commands
  2353.           -------------------------------------------------------------
  2354.           
  2355.           Note - All of the following commands can be dangerous if
  2356.                  accessed by un-authorized users.  Use them with
  2357.                  caution!
  2358.           
  2359.           Command Key: *#
  2360.           Function   : Runs The Menu Editor
  2361.           CString    : None
  2362.           
  2363.           
  2364.           Command Key: *B
  2365.           Function   : Allows The SysOp To Edit/View The Blacklist
  2366.           CString    : None
  2367.           
  2368.           
  2369.           Command Key: *C
  2370.           Function   : Enters The System Configuration Menu
  2371.           CString    : None
  2372.           
  2373.           
  2374.           Command Key: *D
  2375.           Function   : Enters MiniDos
  2376.           CString    : None
  2377.           
  2378.           
  2379.           Command Key: *E
  2380.           Function   : Edits Strings (Internal Prompts)
  2381.           CString    : None
  2382.           
  2383.           
  2384.           Command Key: *I
  2385.           Function   : Shows Infoforms
  2386.           CString    : None
  2387.           
  2388.           
  2389.           Command Key: *K
  2390.           Function   : Clears Infoforms
  2391.           CString    : None
  2392.           
  2393.           
  2394.           Command Key: *L
  2395.           Function   : Shows SysOp Log's
  2396.           CString    : None
  2397.           
  2398.           
  2399.           Command Key: *M
  2400.           Function   : Make User
  2401.           CString    : None
  2402.           
  2403.           
  2404.           Command Key: *P
  2405.           Function   : Enters the Protocol Editor
  2406.           CString    : None
  2407.           
  2408.           
  2409.           Command Key: *R
  2410.           Function   : Configures Menu Prompts
  2411.           CString    : None
  2412.           
  2413.           
  2414.           Command Key: *S
  2415.           Function   : Sets Libraries
  2416.           CString    : None
  2417.           
  2418.           
  2419.           Command Key: *T
  2420.           Function   : Runs the internal Text Editor
  2421.           CString    : None
  2422.           
  2423.           Command Key: *U
  2424.           Function   : User Editor
  2425.           CString    : None
  2426.           
  2427.           
  2428.           Command Key: *V
  2429.           Function   : Event Editor
  2430.           CString    : None
  2431.           
  2432.           
  2433.           Command Key: *X
  2434.           Function   : View Voting
  2435.           
  2436.           
  2437.           Command Key: *Y
  2438.           Function   : Parameter Editor
  2439.           CString    : None
  2440.           
  2441.           
  2442.           Command Key: *Z
  2443.           Function   : Archiver Editor
  2444.           CString    : None
  2445.           
  2446.           
  2447.           -------------------------------------------------------------
  2448.                                   ^ = New User Voting Commands
  2449.           -------------------------------------------------------------
  2450.           
  2451.           
  2452.           Command Key: ^D
  2453.           Function   : Starts new user voting without asking the user
  2454.                      : if they would like to skip it
  2455.           CString    : None
  2456.           
  2457.           
  2458.           Command Key: ^L
  2459.           Function   : Lists Users in the NUV
  2460.           CString    : None
  2461.           
  2462.           
  2463.           Command Key: ^S
  2464.           Function   : Ask's User if they would like to vote on new
  2465.                      : users
  2466.           CString    : Q
  2467.                      : If "Q" is specified as the CString, then users
  2468.                      : are forced to vote on new users. They cannot
  2469.                      : quit
  2470.           
  2471.           
  2472.           -------------------------------------------------------------
  2473.                                   C = Conference Editor
  2474.           -------------------------------------------------------------
  2475.           
  2476.           
  2477.           Command Key: CA
  2478.           Function   : Adds a Conference
  2479.           CString    : None
  2480.           
  2481.           
  2482.           Command Key: CD
  2483.           Function   : Deletes a Conference
  2484.           CString    : None
  2485.           
  2486.           
  2487.           Command Key: CE
  2488.           Function   : Edits a Conference
  2489.           CString    : None
  2490.           
  2491.           
  2492.           Command Key: CI
  2493.           Function   : Initializes Conference Editor
  2494.           CString    : None
  2495.           
  2496.           
  2497.           Command Key: CL
  2498.           Function   : List Conferences
  2499.           CString    : None
  2500.           
  2501.           
  2502.           Command Key: CR
  2503.           Function   : Reorders Conference
  2504.           CString    : None
  2505.           
  2506.           
  2507.           Command Key: CT
  2508.           Function   : Selects Conference Type
  2509.           CString    : None
  2510.           
  2511.           
  2512.           Command Key: CU
  2513.           Function   : List Users with Access to a Conference
  2514.           CString    : None
  2515.           
  2516.           
  2517.           
  2518.           -------------------------------------------------------------
  2519.                                   D = Data Area Menu
  2520.           -------------------------------------------------------------
  2521.           
  2522.           
  2523.           Command Key: DA
  2524.           Function   : Adds Data
  2525.           CString    : None
  2526.           
  2527.           
  2528.           Command Key: DD
  2529.           Function   : Deletes Data
  2530.           CString    : None
  2531.           
  2532.           
  2533.           Command Key: DE
  2534.           Function   : Edits Selected Data Area
  2535.           CString    : None
  2536.           
  2537.           
  2538.           Command Key: DF
  2539.           Function   : List Data w/o asking for range limits
  2540.           CString    : None
  2541.           
  2542.           
  2543.           Command Key: DG
  2544.           Function   : Puts the data area listing into a file, and
  2545.                      : if you're remote, it will send it to you.
  2546.           CString    : None
  2547.           
  2548.                      : This option would be equivelant to listing the
  2549.                      : data area, and turning on a capture in your term
  2550.                      : program.
  2551.           
  2552.           
  2553.           Command Key: DK
  2554.           Function   : Deletes Selected Data Area
  2555.           CString    : None
  2556.           
  2557.           
  2558.           Command Key: DL
  2559.           Function   : Lists Data w/ asking for range limits
  2560.           CString    : None
  2561.           
  2562.           
  2563.           Command Key: DM
  2564.           Function   : Add Data Area
  2565.           CString    : None
  2566.           
  2567.           
  2568.           Command Key: DR
  2569.           Function   : Displays a Random Entry in this data area using
  2570.                      : the List Prefix followed by "RAN.ANS" as the
  2571.                      : ansi to tell it how it should look.
  2572.           CString    : None
  2573.           
  2574.           
  2575.           Command Key: DS
  2576.           Function   : Shows Data
  2577.           CString    : None
  2578.           
  2579.           
  2580.           Command Key: D*
  2581.           Function   : Selects Data Area in the Cstring
  2582.           CString    : # of Data Area, if blank, will let user select
  2583.                      : which
  2584.           
  2585.           
  2586.           
  2587.           -------------------------------------------------------------
  2588.                                   E = Email Commands
  2589.           -------------------------------------------------------------
  2590.           
  2591.           
  2592.           Command Key: EA
  2593.           Function   : Sysop Option to Scan Email
  2594.           CString    : None
  2595.           
  2596.           
  2597.           Command Key: EB
  2598.           Function   : Looks in a User's Mail Box
  2599.           CString    : None
  2600.           
  2601.           
  2602.           Command Key: ED
  2603.           Function   : Delete Incoming piece of Email
  2604.           CString    : # of Email - Asks For # if none is specified
  2605.           
  2606.           
  2607.           Command Key: EE
  2608.           Function   : Edits Outgoing Email
  2609.           CString    : # of Email - Asks For # If None is specified
  2610.           
  2611.           
  2612.           Command Key: EF
  2613.           Function   : Forwards Mail
  2614.           CString    : # of Email - Asks For # if None is Specified
  2615.           
  2616.           
  2617.           Command Key: EG
  2618.           Function   : Edits Groups
  2619.           CString    : None
  2620.           
  2621.           Command Key: EK
  2622.           Function   : Kills Outgoing Mail
  2623.           CString    : # of Email - Asks For # if None is Specified
  2624.           
  2625.           
  2626.           Command Key: EL
  2627.           Function   : Lists Mail
  2628.           CString    : None
  2629.           
  2630.           
  2631.           Command Key: EN
  2632.           Function   : Scans for Email
  2633.           CString    : None
  2634.           
  2635.           
  2636.           Command Key: EP
  2637.           Function   : Replies to Incoming Email
  2638.           CString    : # of Email - Asks if None is Specified
  2639.           
  2640.           
  2641.           Command Key: ER
  2642.           Function   : Read Incoming Mail
  2643.           CString    : # of Email - Asks if None is Specified
  2644.           
  2645.           
  2646.           Command Key: ES
  2647.           Function   : Sends Email
  2648.           CString    : # Of the user to send Email to - Asks if None is
  2649.                      : Specified
  2650.           
  2651.           
  2652.           Command Key: ET
  2653.           Function   : Shows Incoming/Outgoing Information
  2654.           CString    : None
  2655.           
  2656.           
  2657.           Command Key: EV
  2658.           Function   : Views Outgoing Email
  2659.           CString    : # Of Email  - Asks if None is Specified
  2660.           
  2661.           
  2662.           Command Key: EX
  2663.           Function   : Purges FileMail older than a number of days set
  2664.                      : in the config
  2665.           CString    : None
  2666.           
  2667.           
  2668.           Command Key: EZ  -
  2669.           Function   : Packs Email, do this every once in a while, it
  2670.                      : clears out deleted email and thus speeds up the
  2671.                      : searching for new email
  2672.           CString    : None
  2673.           
  2674.           
  2675.           
  2676.           -------------------------------------------------------------
  2677.                                   F = File Commands
  2678.           -------------------------------------------------------------
  2679.           
  2680.           
  2681.           Command Key: FA
  2682.           Function   : Lists File Areas Does Not Ask Which Base To
  2683.                      : Switch to
  2684.           CString    : None
  2685.           
  2686.           
  2687.           Command Key: FB
  2688.           Function   : Batch Menu
  2689.           CString    : None
  2690.           
  2691.           
  2692.           Command Key: FC
  2693.           Function   : Change Files
  2694.           CString    : FILENAME or # of first file to edit - Will ask
  2695.                      : if None is Specified
  2696.           
  2697.           
  2698.           Command Key: FD
  2699.           Function   : Downloads Files
  2700.           CString    : FILENAME of # of the first file to Download
  2701.                      : Will ask if None is Specified
  2702.           
  2703.           
  2704.           Command Key: FE
  2705.           Function   : Newscanns the current file area.
  2706.           CString    : None
  2707.           
  2708.           
  2709.           Command Key: FF
  2710.           Function   : Newscans File Areas without asking if you want
  2711.                      : to scan them all
  2712.           CString    : None
  2713.           
  2714.           
  2715.           Command Key: FI
  2716.           Function   : Inits File Areas in the file conference selected
  2717.           CString    : None
  2718.           
  2719.           
  2720.           Command Key: FK
  2721.           Function   : User Configurable File List Configuration
  2722.           CString    : None
  2723.           
  2724.           
  2725.           Command Key: FL
  2726.           Function   : Lists Files in current file area
  2727.           CString    : None
  2728.           
  2729.           
  2730.           Command Key: FM
  2731.           Function   : Bidirectional Transfer
  2732.           CString    : None
  2733.           
  2734.           Notes      : For bidirectional protocols, you need to create
  2735.                      : a progam that will convert the protocol's log
  2736.                      : files to a DSZLOG compatible log. The filename
  2737.                      : should be the same as the 'LOGNAME' option in
  2738.                      : the config with a U or D as the last part of the
  2739.                      : extension. IE: If you had C:\OBV\DSZLOG. The
  2740.                      : filename would be C:\OBV\DSZLOG.1U or DSZLOG.1D.
  2741.                      : U for upload, and D for download.
  2742.           
  2743.           
  2744.           Command Key: FN
  2745.           Function   : Newscans File Areas, asks if you want to scan
  2746.                      : them all
  2747.           CString    : None
  2748.           
  2749.           
  2750.           Command Key: FO
  2751.           Function   : Shows info for files
  2752.           CString    : FILENAME or # - Will ask if None is Specified
  2753.           CString    : None
  2754.           
  2755.           
  2756.           Command Key: FR
  2757.           Function   : Resumes file(s)
  2758.           CString    : FILENAME or # - Will Ask if None is Specified
  2759.           
  2760.           
  2761.           Command Key: FS
  2762.           Function   : Sets File Area
  2763.           CString    : Area # - if zero, Obv/2 will prompt
  2764.           
  2765.           
  2766.           Command Key: FT
  2767.           Function   : Type file(s)
  2768.           CString    : FILENAME or # - Will Ask if None is Specified
  2769.           
  2770.           
  2771.           Command Key: FU
  2772.           Function   : Upload
  2773.           CString    : None
  2774.           
  2775.           
  2776.           Command Key: FV
  2777.           Function   : Views files
  2778.           CString    : None
  2779.           
  2780.           
  2781.           Command Key: FX
  2782.           Function   : Extract file(s)
  2783.           CString    : FILENAME or # - Will Ask if None is Specified
  2784.           
  2785.           
  2786.           Command Key: FY
  2787.           Function   : File Status
  2788.           CString    : FILENAME or # - Will Ask if None is Specified
  2789.           
  2790.           
  2791.           Command Key: FZ
  2792.           Function   : Search for File
  2793.           CString    : None
  2794.           
  2795.           
  2796.           Command Key: F[
  2797.           Function   : Previous Area
  2798.           CString    : None
  2799.           
  2800.           
  2801.           Command Key: F]
  2802.           Function   : Next Area
  2803.           CString    : None
  2804.           
  2805.           
  2806.           Command Key: F|
  2807.           Function   : Generate Complete File List
  2808.           CString    : None
  2809.           
  2810.           
  2811.           
  2812.           -------------------------------------------------------------
  2813.                                   J = Join Conference
  2814.           -------------------------------------------------------------
  2815.           
  2816.           
  2817.           Command Key: JF
  2818.           Function   : Joins Relative File Conference
  2819.           CString    : Conference # - Will ask if None is Specified.
  2820.                      : If the User types, Q, the fail flag will be set
  2821.                      : Otherwise it will not be. What Relative
  2822.                      : Conference means is the number of the conference
  2823.                      : that the user sees This means, that if there are
  2824.                      : 3 conferences to which user has access, the
  2825.                      : relative file conference number corresponds
  2826.                      : to the number of the conference in the listing
  2827.           
  2828.           
  2829.           Command Key: JM
  2830.           Function   : Joins Relative Message Conference
  2831.           CString    : Conference # - Will Ask if None is Specified
  2832.                      : If the User types, Q, the fail flag will be set
  2833.                      : Otherwise it will not be What Relative
  2834.                      : Conference means is the number of the conference
  2835.                      : that the user sees This means, that if there are
  2836.                      : 3 conferences to which user has access, the
  2837.                      : relative file conference number corresponds
  2838.                      : to the number of the conference in the listing
  2839.           
  2840.           Command Key: JS
  2841.           Function   : Joins Absolute Message Conference
  2842.           CString    : Conference ID #
  2843.                      : Will set the message conference to the
  2844.                      : conference that has the conference ID of the
  2845.                      : Cstring.  Unlike the relative conferences
  2846.                      : the number never varies, however with this
  2847.                      : command, a user can join a deleted conference or
  2848.                      : one to which he does not have access
  2849.           
  2850.           Command Key: JT
  2851.           Function   : Joins Absolute File Conference
  2852.           CString    : Conference ID #
  2853.                      : Will set the message conference to the
  2854.                        conference that has the conference ID of the
  2855.                        Cstring.  Unlike the relative conferences the
  2856.                        number never varies, however with this command,
  2857.                        a user can join a deleted conference or one to
  2858.                        which he does not have access
  2859.           
  2860.           
  2861.           
  2862.           
  2863.           -------------------------------------------------------------
  2864.                                   M = Message Commands
  2865.           -------------------------------------------------------------
  2866.           
  2867.           
  2868.           Command Key: MB
  2869.           Function   : Backwards title scan
  2870.           CString    : None
  2871.           
  2872.           Command Key: MC
  2873.           Function   : Newscan Config for the current conference
  2874.           CString    : None
  2875.           
  2876.           
  2877.           Command Key: MD
  2878.           Function   : Deletes a Message
  2879.           CString    : None
  2880.           
  2881.           
  2882.           Command Key: ME
  2883.           Function   : Edits a Message
  2884.           CString    : None
  2885.           
  2886.           
  2887.           Command Key: MF
  2888.           Function   : Message Newscans all areas
  2889.           CString    : None
  2890.           
  2891.           
  2892.           Command Key: MH
  2893.           Function   : Sets Message Header
  2894.           CString    : 0 = Internal
  2895.                      : 1 = External
  2896.           
  2897.           
  2898.           Command Key: MI
  2899.           Function   : Inits Message Bases in this conferences
  2900.           CString    : None
  2901.           
  2902.           
  2903.           Command Key: ML
  2904.           Function   : Lists Message Bases in this conference
  2905.           CString    : None
  2906.           
  2907.           
  2908.           Command Key: MN
  2909.           Function   : Newscans w/ prompt to scan all
  2910.           CString    : None
  2911.           
  2912.           
  2913.           Command Key: MP
  2914.           Function   : Posts Message
  2915.           CString    : None
  2916.           
  2917.           
  2918.           Command Key: MR
  2919.           Function   : Reads Messages
  2920.           CString    : None
  2921.           
  2922.           
  2923.           Command Key: MS
  2924.           Function   : Selects Message Base
  2925.           CString    : # of Messages base - if 0 Obv/2 will prompt
  2926.           
  2927.           
  2928.           Command Key: MT
  2929.           Function   : Reads Messages in this base in reply reading
  2930.                      : newscan
  2931.           CString    : None
  2932.           
  2933.           
  2934.           Command Key: MU
  2935.           Function   : Lists Users w/ access to this conference
  2936.           CString    : None
  2937.           
  2938.           
  2939.           Command Key: MV
  2940.           Function   : Reads Messages in this base w/ normal reading
  2941.                      : newscan
  2942.           CString    : None
  2943.           
  2944.           
  2945.           Command Key: MW
  2946.           Function   : Forward Title Scan
  2947.           CString    : # of message to start scan
  2948.           
  2949.           
  2950.           Command Key: M[
  2951.           Function   : Previous Message Base
  2952.           CString    : None
  2953.           
  2954.           
  2955.           Command Key: M]
  2956.           Function   : Next Message Base
  2957.           CString    : None
  2958.           
  2959.           
  2960.           Command Key: M!
  2961.           Function   : Download Message Capture
  2962.           CString    : None
  2963.           
  2964.           
  2965.           Command Key: N#
  2966.           Function   : Reads the message with the # specified in the
  2967.                      : CString
  2968.           CString    : Message # to read.
  2969.           
  2970.           
  2971.           Command Key: NA
  2972.           Function   : Reads the current message again.
  2973.           CString    : None
  2974.           
  2975.           
  2976.           Command Key: NB
  2977.           Function   : Backward thread of messages.
  2978.           CString    : None
  2979.           
  2980.           
  2981.           Command Key: ND
  2982.           Function   : Delete current message.
  2983.           CString    : None
  2984.           
  2985.           
  2986.           Command Key: NE
  2987.           Function   : Edits the current message.
  2988.           CString    : None
  2989.           
  2990.           
  2991.           Command Key: NI
  2992.           Function   : Sets the fail flag to true if the user is at the
  2993.                      : last message.
  2994.           CString    : None
  2995.           
  2996.           
  2997.           Command Key: NL
  2998.           Function   : Sets the fail flag to true if the user is at the
  2999.                      : last message base.
  3000.           CString    : None
  3001.           
  3002.           
  3003.           Command Key: NN
  3004.           Function   : Reads next message.
  3005.           CString    : None
  3006.           
  3007.           
  3008.           Command Key: NO
  3009.           Function   : Backward title scan from current message.
  3010.           CString    : None
  3011.           
  3012.           
  3013.           Command Key: NR
  3014.           Function   : Reply to the current message.
  3015.           CString    : None
  3016.           
  3017.           
  3018.           Command Key: NT
  3019.           Function   : Forward title scan from current message.
  3020.           CString    : None
  3021.           
  3022.           
  3023.           Command Key: NU
  3024.           Function   : Update current message as lastread message.
  3025.           CString    : None
  3026.           
  3027.           
  3028.           
  3029.           -------------------------------------------------------------
  3030.                                   Q = QWKMail Menu
  3031.           -------------------------------------------------------------
  3032.           
  3033.           
  3034.           Command Key: QM
  3035.           Function   : Make QWK Packet
  3036.           CString    : None
  3037.           
  3038.           
  3039.           Command Key: QR
  3040.           Function   : Receives REP Packet
  3041.           CString    : None
  3042.           
  3043.           
  3044.           
  3045.           -------------------------------------------------------------
  3046.                                   R = Top Ten Listing
  3047.           -------------------------------------------------------------
  3048.           
  3049.           
  3050.           Command Key: RA   (Top Ten #1)
  3051.           Function   : Top Ten List by Top Uploaders
  3052.           CString    : Header
  3053.           
  3054.           
  3055.           Command Key: RB   ( Top Ten #2)
  3056.           Function   : Top Ten List by Worst Uploaders
  3057.           CString    : Header
  3058.           
  3059.           
  3060.           Command Key: RC   (Top Ten #3)
  3061.           Function   : Top Ten List by Top Downloaders
  3062.           CString    : Header
  3063.           
  3064.           
  3065.           Command Key: RD   (Top Ten #4)
  3066.           Function   : Top Ten List by Worst Downloaders
  3067.           CString    : Header
  3068.           
  3069.           
  3070.           Command Key: RE   (Top Ten #5)
  3071.           Function   : Top Ten List by Top PCR
  3072.           CString    : Header
  3073.           
  3074.           
  3075.           Command Key: RF   (Top Ten #6)
  3076.           Function   : Top Ten List by Worst PCR
  3077.           CString    : Header
  3078.           
  3079.           
  3080.           Command Key: RG   (Top Ten #7)
  3081.           Function   : Top Ten List by Top K Uploaded
  3082.           CString    : Header
  3083.           
  3084.           
  3085.           Command Key: RH   (Top Ten #8)
  3086.           Function   : Top Ten List by Worst K Uploaded
  3087.           CString    : Header
  3088.           
  3089.           
  3090.           Command Key: RI   (Top Ten #9)
  3091.           Function   : Top Ten List by Top K Downloaded
  3092.           CString    : Header
  3093.           
  3094.           
  3095.           Command Key: RJ   (Top Ten #10)
  3096.           Function   : Top Ten List by Worst K Downloaded
  3097.           CString    : Header
  3098.           
  3099.           
  3100.           Command Key: RK   (Top Ten #11)
  3101.           Function   : Top Ten List by Top Posters
  3102.           CString    : Header
  3103.           
  3104.           
  3105.           Command Key: RL   (Top Ten #12)
  3106.           Function   : Top Ten List by Worst Posters
  3107.           CString    : Header
  3108.           
  3109.           
  3110.           Command Key: RM   (Top Ten #13)
  3111.           Function   : Top Ten List by Top Callers
  3112.           CString    : Header
  3113.           
  3114.           
  3115.           Command Key: RN   (Top Ten #14)
  3116.           Function   : Top Ten List by Worst Callers with header in
  3117.                      : Cstring
  3118.           CString    : Header
  3119.           
  3120.           
  3121.           
  3122.           -------------------------------------------------------------
  3123.                                   S = Message Base Sponsor
  3124.           -------------------------------------------------------------
  3125.           
  3126.           
  3127.           Command Key: SE
  3128.           Function   : Edit Current Message Base
  3129.           CString    : None
  3130.           
  3131.           
  3132.           Command Key: SK
  3133.           Function   : Kill Current Message Base
  3134.           CString    : None
  3135.           
  3136.           
  3137.           Command Key: SM
  3138.           Function   : Make Message Base
  3139.           CString    : None
  3140.           
  3141.           
  3142.           Command Key: SP
  3143.           Function   : Packs Message Bases
  3144.           CString    : None
  3145.           
  3146.           
  3147.           Command Key: SR
  3148.           Function   : Reorders Message Bases
  3149.           CString    : None
  3150.           
  3151.           
  3152.           Command Key: S@
  3153.           Function   : Toggles Access to all file bases
  3154.           CString    : None
  3155.           
  3156.           
  3157.           
  3158.           -------------------------------------------------------------
  3159.                                   T = File Sponsor Commands
  3160.           -------------------------------------------------------------
  3161.           
  3162.           
  3163.           Command Key: TA
  3164.           Function   : Add Files
  3165.           CString    : None
  3166.           
  3167.           
  3168.           Command Key: TC
  3169.           Function   : Offline Clean Up, takes files that are not
  3170.                      : present out of the file listings
  3171.           CString    : None
  3172.           
  3173.           
  3174.           Command Key: TD
  3175.           Function   : Delete Files
  3176.           CString    : FILENAME or # to start list - Will Ask if None
  3177.                      : is Specified
  3178.           
  3179.           
  3180.           Command Key: TE
  3181.           Function   : Edit Current File Area
  3182.           CString    : None
  3183.           
  3184.           
  3185.           Command Key: TF
  3186.           Function   : Move Files
  3187.           CString    : FILENAME or # to start list - Will Ask if None
  3188.                      : is Specified
  3189.           
  3190.           
  3191.           Command Key: TK
  3192.           Function   : Kill File Area
  3193.           CString    : None
  3194.           
  3195.           
  3196.           Command Key: TM
  3197.           Function   : Make File Area
  3198.           CString    : None
  3199.           
  3200.           
  3201.           Command Key: TP
  3202.           Function   : Global Point Reassign
  3203.           CString    : None
  3204.           
  3205.           
  3206.           Command Key: TR
  3207.           Function   : Re-Order Areas
  3208.           CString    : None
  3209.           
  3210.           
  3211.           Command Key: TS
  3212.           Function   : Sort Areas
  3213.           CString    : None
  3214.           
  3215.           
  3216.           Command Key: TT
  3217.           Function   : Offline Tag, Tags files that are not there as
  3218.                      : offline and offline : files that have been
  3219.                      : returned as online.
  3220.           CString    : None
  3221.           
  3222.           
  3223.           Command Key: TU
  3224.           Function   : Global Local Upload
  3225.           CString    : None
  3226.           
  3227.           
  3228.           Command Key: TV
  3229.           Function   : File Validation
  3230.           CString    : None
  3231.           
  3232.           
  3233.           Command Key: T@
  3234.           Function   : Toggles Access to all file areas
  3235.           CString    : None
  3236.           
  3237.           
  3238.           
  3239.           
  3240.           
  3241.           -------------------------------------------------------------
  3242.                                   V = Voting Commands
  3243.           -------------------------------------------------------------
  3244.           
  3245.           
  3246.           Command Key: VA
  3247.           Function   : Add Question
  3248.           CString    : None
  3249.           
  3250.           
  3251.           Command Key: VC
  3252.           Function   : Checks for unanswered mandatory questions
  3253.           CString    : None
  3254.           
  3255.           
  3256.           Command Key: VD
  3257.           Function   : Deletes voting question
  3258.           CString    : # of voting question to delete - will prompt if
  3259.                        blank
  3260.           
  3261.           
  3262.           Command Key: VL
  3263.           Function   : Lists Voting Questions
  3264.           CString    : None
  3265.           
  3266.           
  3267.           Command Key: VR
  3268.           Function   : Answers Voting Question
  3269.           CString    : # of voting question - Will Prompt if zero
  3270.           
  3271.           
  3272.           Command Key: VS
  3273.           Function   : Shows Results to Voting Question
  3274.           CString    : # of voting question - Will Prompt if zero
  3275.           
  3276.           
  3277.           
  3278.           
  3279.           
  3280.           -------------------------------------------------------------
  3281.                                   + = Color Setting Commands
  3282.           -------------------------------------------------------------
  3283.           
  3284.           
  3285.           Command Key: +1
  3286.           Function   : Sets Regular Color
  3287.           CString    : Color (ie 15 would set to white)
  3288.           
  3289.           
  3290.           Command Key: +2
  3291.           Function   : Sets Prompt Color
  3292.           CString    : Color
  3293.           
  3294.           
  3295.           Command Key: +3
  3296.           Function   : Sets Input Color
  3297.           CString    : Color
  3298.           
  3299.           
  3300.           Command Key: +4
  3301.           Function   : Sets Inverse Color
  3302.           CString    : Color
  3303.           
  3304.           
  3305.           Command Key: +5
  3306.           Function   : Sets Stat Color
  3307.           CString    : Color
  3308.           
  3309.           
  3310.           Command Key: +6
  3311.           Function   : Sets Box Color
  3312.           CString    : Color
  3313.           
  3314.           
  3315.           Command Key: +S
  3316.           Function   : Sets your colors to the default colors defined
  3317.                      : in the System Configuration
  3318.           CString    : None
  3319.           
  3320.           
  3321.           -------------------------------------------------------------
  3322.                               Oblivion/2 Menu Editor
  3323.           -------------------------------------------------------------
  3324.           
  3325.                Oblivion/2's Menu Editor is much like Telegard /
  3326.           Renegade's Menu editing system.  There are some expanded
  3327.           functions that should be known.
  3328.           
  3329.           The main menu editing interface consists of 9 commands.
  3330.           A sample of the interface is shown below. (Scaled down)
  3331.           
  3332.           ╒═══════════════════════════════════════════════════════════╕
  3333.           │ Command :           (Q)uit      Oblivion/2 Menu Editor    │
  3334.           ╘═══════════════════════════════════════════════════════════╛
  3335.           ╒═══════════════════════════════════════════════════════════╕
  3336.           │ (A) Name           : BBS List                             │
  3337.           │ (B) Password       :                                      │
  3338.           │ (C) Fallback Menu  :                                      │
  3339.           │ (D) Help ID        : BBSLIST                              │
  3340.           │ (E) Name In Prompt : BBS List                             │
  3341.           │ (F) Menu Title     : BBS List                             │
  3342.           │ (G) Pulldown ANSI  :                                      │
  3343.           │ (H) Edit Options                                          │
  3344.           │ (I) Generic Menus                                         │
  3345.           ╘═══════════════════════════════════════════════════════════╛
  3346.           
  3347.                (A) The first command is plain and simple... The name of
  3348.                    the menu. It is there for the user's reference.
  3349.                (B) A Password for the menu can be specified.
  3350.                (C) A Fallback menu.  This is the menu that will be used
  3351.                    as a return of fallback.  If no fallback is
  3352.                    specified, then the system will make the last menu
  3353.                    in the stack as the default fallback.
  3354.                (D) This is the ID for the file to be hardcoded when
  3355.                    Menu Libraries are coded. (ie: MAIN = MAIN.ANS in a
  3356.                    menu LIB file)
  3357.                (E) Menu Title To Be Displayed in the menu prompt.
  3358.                (F) (Reserved) There may be utilities that may use them
  3359.                    such as ones that will generate generic menus that
  3360.                    look half-way decent. That is if anyone gets around
  3361.                    to writing the utility.
  3362.                (G) Pulldown Ansi.  This option will be explained
  3363.                    further in the documentation.
  3364.                (H) Allows Editing of the menu's actual options
  3365.                (I) Displays a generic menu.
  3366.           
  3367.                   Most of these options are pretty much self
  3368.                   explanitory, so if you don't understand what one does
  3369.                   - experiment.
  3370.           
  3371.           
  3372.           
  3373.           -------------------------------------------------------------
  3374.                   (H) Edit Options.  The following is a sample screen
  3375.                       of the option editor.
  3376.           
  3377.           
  3378.           1  FIRSTCMD        D* 2  A*              -A 3  A*          DA
  3379.           4  D*              DD 5  L*              DL 6  S*          DS
  3380.           7  Q*              -\
  3381.           (A)dd (C)hange (D)elete (M)ove (Q)uit :
  3382.           
  3383.           
  3384.                From this menu there isn't all that much to do.  You
  3385.           can simply add, delete, move, or change menu
  3386.           functions.
  3387.           
  3388.           
  3389.                To Edit an option, hit C then the option number.
  3390.           The following screen will be displayed.
  3391.           
  3392.           
  3393.           ╒═══════════════════════════════════════════════════════════╕
  3394.           │Command :           (Q)uit    Oblivion/2 Command Editor    │
  3395.           ╘═══════════════════════════════════════════════════════════╛
  3396.           ╒═══════════════════════════════════════════════════════════╕
  3397.           │ (A) Option Name    :                                      │
  3398.           │ (B) ACS            :                                      │
  3399.           │ (C) Hidden         : No                                   │
  3400.           │ (D) Command Keys   : D*                                   │
  3401.           │ (E) Keys           : *D                                   │
  3402.           │ (F) Command String : 1                                    │
  3403.           │ (G) Pulldown ID    : 0                                    │
  3404.           │ (+) Next Option                                           │
  3405.           │ (-) Previous Option                                       │
  3406.           ╘═══════════════════════════════════════════════════════════╛
  3407.           
  3408.           
  3409.                    (A) Option Name - Name Of the option the way you
  3410.                        want it displayed in a generic menu.  (This is
  3411.                        also used in a pulldown menu.  SEE Pullown Menus
  3412.                        for more)
  3413.                    (B) ACS - Access Level, Flag, or other restriction
  3414.                        to use for this option.
  3415.                    (C) Hidden - Determines if the option name will be
  3416.                        displayed in a generic menu.  (This is also used
  3417.                        in pulldown menus)
  3418.                    (D) Command Keys - The actual Command that will be
  3419.                        executed.
  3420.                    (E) Keys - this is the key, or keys used to execute
  3421.                        the command. You can put FIRSTCMD to execute the
  3422.                        command when the user goes to the menu or EACH
  3423.                        to do it before the prompt is drawn, every time
  3424.                        the user is at the menu.
  3425.                    (F) Command String - Some commands will allow the
  3426.                        use of a command string.  See each command for a
  3427.                        command string(s) if any.
  3428.                    (G) Pulldown ID - This is used in pulldown menus.
  3429.                        (SEE Pulldown Menus for more)
  3430.           
  3431.           -------------------------------------------------------------
  3432.           
  3433.           In the Pulldown Filename, there can be the following:
  3434.           
  3435.           <blank>
  3436.             Draws Menu Prompt with the name in the prompt in the prompt
  3437.             and does standard input
  3438.           
  3439.           ::X
  3440.             Where X is a letter in the alphabet. Randomly picks a
  3441.             letter from A to X, and will act as if the user pressed
  3442.             that key.
  3443.           
  3444.             Example: Random Matrices
  3445.             The above command can be used to easily make random
  3446.             matrices. Say that you have 4 matrices that you want to
  3447.             randomize. Since D is the 4th letter of the alphabet, your
  3448.             pulldown filename will be ::D. (Without the period) In your
  3449.             MATRIX.MNU, you'll have need to have four commands with the
  3450.             'Key' Field set to A,B,C,D. Now, for each command, you'll
  3451.             want it to go to a different menu. That new menu will be
  3452.             one of your matrices. Here's an example of one command that
  3453.             you'll have in the MATRIX.MNU.
  3454.           
  3455.           Description : Go to DOS Matrix
  3456.           Hidden      : No
  3457.           Command Keys: -^   (GOTO Menu)
  3458.           Key         : A
  3459.           CString     : DOSMAT
  3460.           
  3461.             Do the same thing for the other 3 letters. Note that you
  3462.             can't have other commands in the menu as they won't be
  3463.             executed. Only commands that will be executed will be the
  3464.             ones with the keys A-D.
  3465.           
  3466.           N
  3467.             Writes the Name in the Prompt alone
  3468.           
  3469.               May Contain:
  3470.           
  3471.                   ^R - Regular Color      ^S - Status Color
  3472.                   ^P - Prompt Color       ^E - Input Color
  3473.                   ^V - Inverse Color      ^X - Box Color
  3474.                   ^M - Goes down a line
  3475.           
  3476.               Using The Following To End:
  3477.                   / Yes/No Bar Prompt beginning with No
  3478.                   \ Yes/No Bar Prompt beginning with Yes
  3479.                   = Yes/No/Quit Bar Prompt Beginning with Yes
  3480.                   | Yes/No/Quit Bar Prompt Beginning with No
  3481.                   @ Yes/No/Quit Bar Prompt Beginning with Quit
  3482.                   * Inputs String
  3483.                   : Inputs String with a : in a different color
  3484.                   # Hotkey without Echo
  3485.                   ) Hotkey with Echo
  3486.                   ( Sets the string equal to the Input Question
  3487.                     varaible set with -I, -J, or -M
  3488.           
  3489.           All pipe codes are also applicable in this prompt.
  3490.           
  3491.               This command is used to make menus that ask questions,
  3492.           create hotkeyed type menus, or get input from users.
  3493.           
  3494.           Bx
  3495.             Does Bar selection menu with x number of columns
  3496.           
  3497.           R
  3498.             Uses a one-line bar menu. When creating command stacks,
  3499.             make sure to only put a description on the first option in
  3500.             the stack, otherwise your whole command stack will appear
  3501.             on this menu. Also, make sure that all options don't exceed
  3502.             80 colums, as this is a ONE line bar menu. If your options
  3503.             exceed the 80 column limit, use the bar menus.
  3504.           
  3505.           
  3506.           <filename.ext>
  3507.           
  3508.               With this option in the menu editor, you can create your
  3509.           own pulldown menus! You'll need to create an ansi design for
  3510.           your menu and add in a few MCI codes to tell the BBS where to
  3511.           place information. There are two types of MCI codes that
  3512.           you'll need to use for this menu. The first, |xx, tells the
  3513.           BBS where to put the highlight bar. The second type is the
  3514.           %xx, this tells the BBS what color to use when the option is
  3515.           not highlighted. When you place these codes in your ansi, it
  3516.           becomes practical to place them next to each other like this.
  3517.           |xx%xx.
  3518.           
  3519.               These xx's must be replaced by numbers so that the BBS
  3520.           knows which option to execute. Thats where the pulldown ID
  3521.           field of the menu editor comes into play. You need to give
  3522.           each one of your options a unique ID#. Start at 1 for the
  3523.           first option, and then use 2 for the second option and so on.
  3524.           If you're stacking commands for a certain part of your menu,
  3525.           only give the first command a pulldown ID.
  3526.           
  3527.               So, say you want to make a pulldown matrix with 5
  3528.           options. Logon, Check, Apply, Feedback, and Logoff. Create
  3529.           your MATRIX.MNU, and add in each of these 5 options. (Look at
  3530.           the above documentation for all of the menu commands to use).
  3531.           After that is done, go back and place a pulldown ID for each
  3532.           option. Since you have 5 options, and no command stacking,
  3533.           just give login a pulldown ID of 1, Check a 2, Apply a 3,
  3534.           Feedback a 4, and Logoff a 5. After you've done this, create
  3535.           your ANSI for the pulldown menu. Put in the MCI codes as
  3536.           described above, and your menu is all ready to go.
  3537.           
  3538.               Now, say that you wanted to make that same matrix but you
  3539.           wanted to use some type of command stacking in it. For
  3540.           example: Say that you want the BBS to login a user after
  3541.           they've checked and found out that they have access. This is
  3542.           done by using the failflag and a few menu commands. Since
  3543.           this option requires more than one menu command, it's called
  3544.           a command 'stack'. Now, the first option in this stack is
  3545.           going to be the check command. Only use the pulldown ID for
  3546.           this command, and not for any other command in the stack.
  3547.           (For this example, the other command would be the Drop into
  3548.           BBS menu command {X. Make sure not to give that a pulldown
  3549.           ID.)
  3550.           
  3551.               Now, you're probably wondering why you only put an ID on
  3552.           the first command in the stack. Think about it this way, you
  3553.           only want the pulldown bar to go onto the options that the
  3554.           user can execute, and not commands that you've customized to
  3555.           perform more than one function. Only the first function
  3556.           should have the ID.
  3557.           
  3558.               Instead of only using up and down in your pulldowns, you
  3559.           can use left and right. Below are the sybmols that you'll
  3560.           need to use in the "Keys" field for the BBS to recognize left
  3561.           and right.
  3562.           
  3563.           Left : ╦  (ALT-203)
  3564.           Right: ═  (ALT-205)
  3565.           
  3566.           If you want to use left/right, make the option(s) hidden, and
  3567.           give them a pulldown ID of 0.
  3568.           
  3569.               Another handy option that you might consider using is the
  3570.           hidden flag. You can make a hidden option that doesn't appear
  3571.           on the pulldown menu, but that the user can execute via
  3572.           hotkey. So, give your hidden option a pulldown ID of 0, and
  3573.           turn on the hidden flag, and the command will become
  3574.           hotkeyed, and you'll be able to execute it w/o using the bar.
  3575.           
  3576.           
  3577.             There is wildcarding for menu commands:
  3578.           
  3579.               If you set the Key to X*, then you can put * in the
  3580.               Cstring and that will put what follows the X in the
  3581.               Cstring. This is advisable for such cases as file
  3582.               conference jumping such as J* with would do JM with a
  3583.               Cstring of * so one could J1,J2, etc.
  3584.           
  3585.             Also a possibility for CString is & in which is set to the
  3586.           input gotten with -I, -J, or set with -*.
  3587.           
  3588.                There are a few special menus in the editor. One, called
  3589.           MATRIX.MNU, is your logon matrix. You can call other menus
  3590.           with it, but your starting menu must be MATRIX.MNU. A second
  3591.           important menu is called GLOBAL.MNU. In this menu, every
  3592.           command will you add will be valid on every other menu.
  3593.           (Example, adding a goodbye command into the GLOBAL.MNU will
  3594.           allow your users to hang up at any menu.)
  3595.           
  3596.                A second thing you'll see mentioned in the menu editor
  3597.           is called 'Command Stacking'. Think of this as command
  3598.           linking. One command can do more than one operation. For
  3599.           example, you can have a command that clears the screen (-L),
  3600.           and prints a file to the screen (-F). To do this, you need to
  3601.           make your 'Keys' Field in the menu editor identical. Example:
  3602.           Create a command with 'Keys' as "T". Make one command with
  3603.           the 'Command Keys' as -L, and another with 'Command Keys' as
  3604.           -F. Make sure the 'Keys' field is "T" in both. Notice now,
  3605.           that the command will first clear the screen (-L), and then
  3606.           print a file (-F) (Enter a filename in the Cstring of the -F
  3607.           command). This is a simple example, but the idea is the same.
  3608.           Stacks get bigger and more complicated, but the general idea
  3609.           stays the same. (Notice examples below)
  3610.           
  3611.           
  3612.             Examples:
  3613.               GOODBYE.MNU - Pulldown Logoff Verify Menu
  3614.           
  3615.           ╒═══════════════════════════════════════════════════════════╕
  3616.           │ Command :           (Q)uit       Oblivion/2 Menu Editor   │
  3617.           ╘═══════════════════════════════════════════════════════════╛
  3618.           ╒═══════════════════════════════════════════════════════════╕
  3619.           │ (A) Name           :                                      │
  3620.           │ (B) Password       :                                      │
  3621.           │ (C) Fallback Menu  :                                      │
  3622.           │ (D) Help ID        :                                      │
  3623.           │ (E) Name In Prompt :                                      │
  3624.           │ (F) Menu Title     :                                      │
  3625.           │ (G) Pulldown ANSI  : LOGOFF.ANS                           │
  3626.           │ (H) Edit Options                                          │
  3627.           │ (I) Generic Menus                                         │
  3628.           ╘═══════════════════════════════════════════════════════════╛
  3629.           
  3630.           Use Pulldown Ansi LOGOFF.ANS
  3631.           
  3632.           ╒═══════════════════════════════════════════════════════════╕
  3633.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3634.           ╘═══════════════════════════════════════════════════════════╛
  3635.           ╒═══════════════════════════════════════════════════════════╕
  3636.           │ (A) Option Name    :                                      │
  3637.           │ (B) ACS            :                                      │
  3638.           │ (C) Hidden         : Yes                                  │
  3639.           │ (D) Command Keys   : [G                                   │
  3640.           │ (E) Keys           : Y                                    │
  3641.           │ (F) Command String :                                      │
  3642.           │ (G) Pulldown ID    : 0                                    │
  3643.           │ ([) Previous Option                                       │
  3644.           │ (]) Next Option                                           │
  3645.           ╘═══════════════════════════════════════════════════════════╛
  3646.           
  3647.           Y as a hotkey to logoff
  3648.           
  3649.           ╒═══════════════════════════════════════════════════════════╕
  3650.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3651.           ╘═══════════════════════════════════════════════════════════╛
  3652.           ╒═══════════════════════════════════════════════════════════╕
  3653.           │ (A) Option Name    :                                      │
  3654.           │ (B) ACS            :                                      │
  3655.           │ (C) Hidden         : Yes                                  │
  3656.           │ (D) Command Keys   : -\                                   │
  3657.           │ (E) Keys           : N                                    │
  3658.           │ (F) Command String :                                      │
  3659.           │ (G) Pulldown ID    : 0                                    │
  3660.           │ ([) Previous Option                                       │
  3661.           │ (]) Next Option                                           │
  3662.           ╘═══════════════════════════════════════════════════════════╛
  3663.           
  3664.           N as a hotkey to go back
  3665.           
  3666.           ╒═══════════════════════════════════════════════════════════╕
  3667.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3668.           ╘═══════════════════════════════════════════════════════════╛
  3669.           ╒═══════════════════════════════════════════════════════════╕
  3670.           │ (A) Option Name    :  Yes                                 │
  3671.           │ (B) ACS            :                                      │
  3672.           │ (C) Hidden         : No                                   │
  3673.           │ (D) Command Keys   : [G                                   │
  3674.           │ (E) Keys           : 1                                    │
  3675.           │ (F) Command String :                                      │
  3676.           │ (G) Pulldown ID    : 1                                    │
  3677.           │ ([) Previous Option                                       │
  3678.           │ (]) Next Option                                           │
  3679.           ╘═══════════════════════════════════════════════════════════╛
  3680.           
  3681.           " Yes" will appear in pulldown option 1 and when selected it
  3682.           will do a logoff.
  3683.           
  3684.           ╒═══════════════════════════════════════════════════════════╕
  3685.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3686.           ╘═══════════════════════════════════════════════════════════╛
  3687.           ╒═══════════════════════════════════════════════════════════╕
  3688.           │ (A) Option Name    :  No                                  │
  3689.           │ (B) ACS            :                                      │
  3690.           │ (C) Hidden         : No                                   │
  3691.           │ (D) Command Keys   : -\                                   │
  3692.           │ (E) Keys           : 2                                    │
  3693.           │ (F) Command String :                                      │
  3694.           │ (G) Pulldown ID    : 2                                    │
  3695.           │ ([) Previous Option                                       │
  3696.           │ (]) Next Option                                           │
  3697.           ╘═══════════════════════════════════════════════════════════╛
  3698.           
  3699.           " No" will appear in pulldown option 1 and when selected it
  3700.           will go back.
  3701.           
  3702.           Another example, the not very nice case.  This was devised by
  3703.           me, Darkened Enmity for Whiplash.  He wanted to use a
  3704.           pulldown menu to select file conferences. I got the idea of
  3705.           the -* command and the use of & in the CString.  I knew that
  3706.           would work, and the next day I wrote out the codes. This is
  3707.           the CONFHAND.MNU for you to look at since it is complex,
  3708.           but will allow you to understand how things are done. There
  3709.           is a menu called CONFSEL.MNU that will select the file
  3710.           conference in a pulldown.  CONFHAND is called like this:
  3711.           
  3712.           Command 1 in Stack:
  3713.           Command Keys  : -*
  3714.           Keys          : T*
  3715.           Command String: *
  3716.           
  3717.           Command 2 in Stack:
  3718.           Command Keys  : -/
  3719.           Keys          : T*
  3720.           Command String: CONFHAND
  3721.           
  3722.           Now here is CONFHAND.MNU:
  3723.           ╒═════════════════════════════════════════════════════════╕
  3724.           │ Command :           (Q)uit     Oblivion/2 Menu Editor   │
  3725.           ╘═════════════════════════════════════════════════════════╛
  3726.           ╒═════════════════════════════════════════════════════════╕
  3727.           │ (A) Name           :                                    │
  3728.           │ (B) Password       :                                    │
  3729.           │ (C) Fallback Menu  :                                    │
  3730.           │ (D) Help ID        :                                    │
  3731.           │ (E) Name In Prompt :                                    │
  3732.           │ (F) Menu Title     :                                    │
  3733.           │ (G) Pulldown ANSI  :                                    │
  3734.           │ (H) Edit Options                                        │
  3735.           │ (I) Generic Menus                                       │
  3736.           ╘═════════════════════════════════════════════════════════╛
  3737.           
  3738.           Not very interesting, but then the user does not even know
  3739.           that it is doing anything.
  3740.           
  3741.           ╒═══════════════════════════════════════════════════════════╕
  3742.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3743.           ╘═══════════════════════════════════════════════════════════╛
  3744.           ╒═══════════════════════════════════════════════════════════╕
  3745.           │ (A) Option Name    :                                      │
  3746.           │ (B) ACS            :                                      │
  3747.           │ (C) Hidden         : No                                   │
  3748.           │ (D) Command Keys   : -S                                   │
  3749.           │ (E) Keys           : FIRSTCMD                             │
  3750.           │ (F) Command String : -B                                   │
  3751.           │ (G) Pulldown ID    : 0                                    │
  3752.           │ ([) Previous Option                                       │
  3753.           │ (]) Next Option                                           │
  3754.           ╘═══════════════════════════════════════════════════════════╛
  3755.           
  3756.           Turns off the B user flag.  It will be used later in the menu
  3757.           as an indicator.
  3758.           
  3759.           ╒═══════════════════════════════════════════════════════════╕
  3760.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3761.           ╘═══════════════════════════════════════════════════════════╛
  3762.           ╒═══════════════════════════════════════════════════════════╕
  3763.           │ (A) Option Name    :                                      │
  3764.           │ (B) ACS            :                                      │
  3765.           │ (C) Hidden         : No                                   │
  3766.           │ (D) Command Keys   : -M                                   │
  3767.           │ (E) Keys           : FIRSTCMD                             │
  3768.           │ (F) Command String :                                      │
  3769.           │ (G) Pulldown ID    :  0                                   │
  3770.           │ ([) Previous Option                                       │
  3771.           │ (]) Next Option                                           │
  3772.           ╘═══════════════════════════════════════════════════════════╛
  3773.           
  3774.           Compares the inputted variable with a blank string.
  3775.           Remember, before CONFHAND was called, the inputted variable
  3776.           was set to what was entered after T by the -* command.  If
  3777.           what was entered was blank, the failflag is false, otherwise
  3778.           it is true.
  3779.           
  3780.           ╒══════════════════════════════════════════════════════════╕
  3781.           │ Command :           (Q)uit    Oblivion/2 Command Editor  │
  3782.           ╘══════════════════════════════════════════════════════════╛
  3783.           ╒══════════════════════════════════════════════════════════╕
  3784.           │ (A) Option Name    :                                     │
  3785.           │ (B) ACS            : \                                   │
  3786.           │ (C) Hidden         : No                                  │
  3787.           │ (D) Command Keys   : -S                                  │
  3788.           │ (E) Keys           : FIRSTCMD                            │
  3789.           │ (F) Command String : +B                                  │
  3790.           │ (G) Pulldown ID    : 0                                   │
  3791.           │ ([) Previous Option                                      │
  3792.           │ (]) Next Option                                          │
  3793.           ╘══════════════════════════════════════════════════════════╛
  3794.           
  3795.           This command will be executed if the failflag is true, in
  3796.           other words, what was entered after T was not blank.
  3797.           Therefore, if the user had type T1, then
  3798.           B will be set, otherwise it remain blank.
  3799.           
  3800.           ╒═══════════════════════════════════════════════════════════╕
  3801.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3802.           ╘═══════════════════════════════════════════════════════════╛
  3803.           ╒═══════════════════════════════════════════════════════════╕
  3804.           │ (A) Option Name    :                                      │
  3805.           │ (B) ACS            : fB                                   │
  3806.           │ (C) Hidden         : No                                   │
  3807.           │ (D) Command Keys   : JF                                   │
  3808.           │ (E) Keys           : FIRSTCMD                             │
  3809.           │ (F) Command String : &                                    │
  3810.           │ (G) Pulldown ID    : 0                                    │
  3811.           │ ([) Previous Option                                       │
  3812.           │ (]) Next Option                                           │
  3813.           ╘═══════════════════════════════════════════════════════════╛
  3814.           
  3815.           If flag B is set, the BBS will do a file conference jump to
  3816.           that conference. A trace through up until this point: User
  3817.           enters Txxx  xxx is put into the input variable  The BBS
  3818.           compares xxx to a blank string They are not equal, flag B is
  3819.           set The BBS joins relative file conference xxx
  3820.           
  3821.           ╒═══════════════════════════════════════════════════════════╕
  3822.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3823.           ╘═══════════════════════════════════════════════════════════╛
  3824.           ╒═══════════════════════════════════════════════════════════╕
  3825.           │ (A) Option Name    :                                      │
  3826.           │ (B) ACS            : fB                                   │
  3827.           │ (C) Hidden         : No                                   │
  3828.           │ (D) Command Keys   : -C                                   │
  3829.           │ (E) Keys           : FIRSTCMD                             │
  3830.           │ (F) Command String :                                      │
  3831.           │ (G) Pulldown ID    : 0                                    │
  3832.           │ ([) Previous Option                                       │
  3833.           │ (]) Next Option                                           │
  3834.           ╘═══════════════════════════════════════════════════════════╛
  3835.           
  3836.           Turns failflag off, thats necessary to know if the next
  3837.           command failed.
  3838.           
  3839.           
  3840.           ╒═══════════════════════════════════════════════════════════╕
  3841.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3842.           ╘═══════════════════════════════════════════════════════════╛
  3843.           ╒═══════════════════════════════════════════════════════════╕
  3844.           │ (A) Option Name    :                                      │
  3845.           │ (B) ACS            : fB                                   │
  3846.           │ (C) Hidden         : No                                   │
  3847.           │ (D) Command Keys   : FI                                   │
  3848.           │ (E) Keys           : FIRSTCMD                             │
  3849.           │ (F) Command String :                                      │
  3850.           │ (G) Pulldown ID    : 0                                    │
  3851.           │ ([) Previous Option                                       │
  3852.           │ (]) Next Option                                           │
  3853.           ╘═══════════════════════════════════════════════════════════╛
  3854.           
  3855.           Tries doing a file initialization.  If its successful, fail
  3856.           flag is still false.
  3857.           
  3858.           
  3859.           ╒══════════════════════════════════════════════════════════╕
  3860.           │ Command :           (Q)uit    Oblivion/2 Command Editor  │
  3861.           ╘══════════════════════════════════════════════════════════╛
  3862.           ╒══════════════════════════════════════════════════════════╕
  3863.           │ (A) Option Name    :                                     │
  3864.           │ (B) ACS            : fB~\                                │
  3865.           │ (C) Hidden         : No                                  │
  3866.           │ (D) Command Keys   : -^                                  │
  3867.           │ (E) Keys           : FSCAN                               │
  3868.           │ (F) Command String :                                     │
  3869.           │ (G) Pulldown ID    : 0                                   │
  3870.           │ ([) Previous Option                                      │
  3871.           │ (]) Next Option                                          │
  3872.           ╘══════════════════════════════════════════════════════════╛
  3873.           
  3874.           If flag B is set and the file init was successful, the BBS
  3875.           will go to FSCAN, the menu that asks if you want to scan the
  3876.           file bases.
  3877.           
  3878.           
  3879.           ╒═══════════════════════════════════════════════════════════╕
  3880.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3881.           ╘═══════════════════════════════════════════════════════════╛
  3882.           ╒═══════════════════════════════════════════════════════════╕
  3883.           │ (A) Option Name    :                                      │
  3884.           │ (B) ACS            : fB                                   │
  3885.           │ (C) Hidden         : No                                   │
  3886.           │ (D) Command Keys   : -^                                   │
  3887.           │ (E) Keys           : FIRSTCMD                             │
  3888.           │ (F) Command String : MAIN                                 │
  3889.           │ (G) Pulldown ID    : 0                                    │
  3890.           │ ([) Previous Option                                       │
  3891.           │ (]) Next Option                                           │
  3892.           ╘═══════════════════════════════════════════════════════════╛
  3893.           
  3894.           If flag B is set, meaning the BBS would have tried initing
  3895.           the file section and was not successful, and the BBS is still
  3896.           reading CONFHAND, then the BBS will go to the main menu.
  3897.           
  3898.           
  3899.           ╒═══════════════════════════════════════════════════════════╕
  3900.           │ Command :           (Q)uit    Oblivion/2 Command Editor   │
  3901.           ╘═══════════════════════════════════════════════════════════╛
  3902.           ╒═══════════════════════════════════════════════════════════╕
  3903.           │ (A) Option Name    :                                      │
  3904.           │ (B) ACS            :                                      │
  3905.           │ (C) Hidden         : No                                   │
  3906.           │ (D) Command Keys   : -^                                   │
  3907.           │ (E) Keys           : FIRSTCMD                             │
  3908.           │ (F) Command String : CONFSEL                              │
  3909.           │ (G) Pulldown ID    : 0                                    │
  3910.           │ ([) Previous Option                                       │
  3911.           │ (]) Next Option                                           │
  3912.           ╘═══════════════════════════════════════════════════════════╛
  3913.           
  3914.           If you are still in this menu, meaning that the user did not
  3915.           enter anything at the prompt, then go right ahead to CONFSEL.
  3916.           
  3917.           Yeah, a complex example that does not do much physically,
  3918.           yeah, I know, but it demonstrates a lot, plus it shows some
  3919.           similarities between high-level menu editing and assembly.
  3920.           
  3921.                       SECTION 14: MESSAGE / FILE BASE SETUP
  3922.                       ─────────────────────────────────────
  3923.           
  3924.                Setting up message and file bases is quite easy. Both
  3925.           message and file bases have editors for easy changing of
  3926.           options. In the message menu, the editor looks just like
  3927.           this:
  3928.           
  3929.           ╒═══════════════════════════════════════════════════════════╕
  3930.           │ Command :           (Q)uit       Oblivion/2 Base Editor   │
  3931.           ╘═══════════════════════════════════════════════════════════╛
  3932.           ╒═══════════════════════════════════════════════════════════╕
  3933.           │ (A) Base Name      : System News                          │
  3934.           │ (B) Access ACS     : S30                                  │
  3935.           │ (C) Post ACS       : S255                                 │
  3936.           │ (D) Allow Anonymous: No                                   │
  3937.           │ (E) Sponsor        : Lord Tracer                          │
  3938.           │ (F) Origin Line    :                                      │
  3939.           │ (G) EchoMail Dir   :                                      │
  3940.           │ (H) NetMail        : No                                   │
  3941.           │ (I) Node           :                                      │
  3942.           │ (J) QWKName        : SYSNEWS                              │
  3943.           │ (K) Autodelete     : 200                                  │
  3944.           │ (L) Real Names     : No                                   │
  3945.           │ (M) Base File Name : NEWS                                 │
  3946.           │ (N) Mandatory      : Yes                                  │
  3947.           │ (O) Allow Private  : No                                   │
  3948.           ╘═══════════════════════════════════════════════════════════╛
  3949.           
  3950.           
  3951.           Base Name           - Name of message base.
  3952.           Access ACS          - ACS required to get into message base.
  3953.           Post ACS            - ACS required to post in message base.
  3954.           Allow Anonymous     - Can users post anonymously in this
  3955.                                 message base?
  3956.           Sponsor             - Pseudo-SysOp. Can delete all messages,
  3957.                                 read all messages in the current base.
  3958.           Origin Line         - Line BBS adds to the end of a
  3959.                                 echomailed message. Usually showed BBS
  3960.                                 name and #. Pipe codes supported.
  3961.           Echomail directory  - Directory where echomail MSG files
  3962.                                 will be held, imported, and exported
  3963.                                 from.
  3964.           Netmail             - Should this base support private
  3965.                                 netmail through Fidonet mail. For this
  3966.                                 option to work, you must compile a copy
  3967.                                 of your nodelist and place it in your
  3968.                                 Echomail directory. Compile the
  3969.                                 nodelist as filename nodelist.dat, and
  3970.                                 using BINKLEY6 format. The reason you
  3971.                                 must compile the nodelist in the
  3972.                                 echomail directory is for the nodelist
  3973.                                 lookup function of the BBS. The BBS
  3974.                                 will allow users to search the nodelist
  3975.                                 for the node that they wish to send
  3976.                                 netmail to.
  3977.           Node                - Assigned to you by your network
  3978.                                 moderator. Basically shows location.
  3979.                                 Form varies, but usually its X:XXX/XXX.
  3980.           QWKName             - Shortened name of the message base to
  3981.                                 be displayed to users in their offline
  3982.                                 readers. Most offline readers cannot
  3983.                                 support message base names over 10-12
  3984.                                 spaces. Use this option so that users
  3985.                                 can better recognize which base they
  3986.                                 are in from their reader.
  3987.           Autodelete          - How many total messages do you want in
  3988.                                 the message base. When the # of
  3989.                                 messages in the base is equal to the
  3990.                                 number in this field, 5 messages will
  3991.                                 be erased. This keeps your message base
  3992.                                 files from growing increasingly large.
  3993.           Real names          - Should the user's real name be used in
  3994.                                 place of a handle in this message base?
  3995.           Base filename       - This is an up to 8 character filename
  3996.                                 that the BBS will use to store your
  3997.                                 messages in.
  3998.           Mandatory           - When this flag is set to Yes, all the
  3999.                                 messages in this base will be forced.
  4000.                                 Users must read these messages. Use
  4001.                                 message bases like this for news.
  4002.           Allow private       - Should users be able to post private
  4003.                                 messages in this base. Use this flag if
  4004.                                 the network you're in supports private
  4005.                                 echomailing.
  4006.           
  4007.                Using the base filename, you can create a 'shared'
  4008.           message base. What this means is that you can have the same
  4009.           message base in more than one conference, or if you run
  4010.           multiple Systems, can have it on two different boards. (ie:
  4011.           System one, and System two can have identical message bases
  4012.           if the sysop should wish). To create a shared message base,
  4013.           use the same base filename in two message areas. They will
  4014.           then be shared. Once you post a message in one area, it will
  4015.           appear in both, and vice versa. When you wish to remove a
  4016.           shared message base, you have an option. You can either
  4017.           delete the data file, or leave it. By deleting the data file
  4018.           in a shared area, both message bases that were sharing that
  4019.           data file will lose all of their messages. By leaving the
  4020.           data file there, you can remove the base from one place, but
  4021.           keep it in another.
  4022.           
  4023.                To create a message base for system news, it takes a few
  4024.           simple steps. First, create a message base, and name it
  4025.           System news, or whatever you want. Fill out the rest of the
  4026.           questions. When you come to 'Mandatory', turn it to Yes. When
  4027.           a user logs on, the BBS will check this message base for new
  4028.           posts, and then proceed to show them to the user. (Look at
  4029.           the example screen for the message base editor. This is an
  4030.           ideal setup for news.)
  4031.           
  4032.                Another thing to be clear about: If you ever have a base
  4033.           that you are using for echomail, and want to turn off
  4034.           echomail, do this: Edit the Import/Export directory setting,
  4035.           and then press 'CTRL-Y'. The field will be cleared. Press
  4036.           enter. Now, this base is no longer an echomail base, but now
  4037.           a normal message base.
  4038.           
  4039.                When going to edit a file base, you will be presented
  4040.           with a similar looking editor. It looks a little like this:
  4041.           
  4042.           ╒═══════════════════════════════════════════════════════════╕
  4043.           │ Command :           (Q)uit       Oblivion/2 Area Editor   │
  4044.           ╘═══════════════════════════════════════════════════════════╛
  4045.           ╒═══════════════════════════════════════════════════════════╕
  4046.           │ (A) Area Name      : New Uploads                          │
  4047.           │ (B) Access ACS     : S25                                  │
  4048.           │ (C) Upload ACS     : S25                                  │
  4049.           │ (D) Download ACS   : S25                                  │
  4050.           │ (E) List ACS       : S25                                  │
  4051.           │ (F) Sponsor        : Lord Tracer                          │
  4052.           │ (G) Password       :                                      │
  4053.           │ (H) Area File Name : UPLOADS                              │
  4054.           │ (I) Path           : C:\UPLOAD\                           │
  4055.           │ (J) Default Sort   : F                                    │
  4056.           ╘═══════════════════════════════════════════════════════════╛
  4057.           
  4058.           Area Name           - The name of the current file area.
  4059.           Access ACS          - ACS required to enter the file area.
  4060.           Upload ACS          - ACS required to upload to the area.
  4061.           Download ACS        - ACS required to download from the area.
  4062.           List ACS            - ACS required to list files in the area.
  4063.           Sponsor             - Pseudo SysOp of the file area. User
  4064.                                 gets extended functions.
  4065.           Password            - Password required to enter file area.
  4066.           Area filename       - Filename (w/o extension) that the BBS
  4067.                                 will use to store file information for
  4068.                                 the current area.
  4069.           Path                - Path to the files for this area.
  4070.           Default sort        - Sort type to use when sorting the file
  4071.                                 areas. (example: F=filename,
  4072.                                 E=extension etc..)
  4073.           
  4074.                You may also create 'shared' file areas. Read the above
  4075.           paragraphs for explanations on how to do this.
  4076.           
  4077.           
  4078.                           SECTION 15: THE UPLOAD CHECKER
  4079.                           ──────────────────────────────
  4080.           
  4081.                The upload checker will check all uploaded files for CRC
  4082.           errors, viruses, age, and can optionally add/delete files, or
  4083.           add a comment to your uploaded files. Operation of the
  4084.           checker is quite simple. It only requires the creation of one
  4085.           screen.  This screen, called ULCHECK.ANS, will be the display
  4086.           to the user when files are being checked. Making this screen
  4087.           is really easy, there are a few MCI codes to use in the
  4088.           screen.  They are as follows:
  4089.           
  4090.           |FN  - Filename
  4091.           |B1  - ■ in CRC Checking.
  4092.           |M1  - Strings displayed during CRC checking.
  4093.           |B2  - ■ in virus scanning.
  4094.           |M2  - Strings displayed in virus scanning.
  4095.           |B3  - ■ in age tests.
  4096.           |M3  - Strings displayed during age testing.
  4097.           |B4  - ■ in deleting files from archive.
  4098.           |M4  - Strings displayed during deleting.
  4099.           |B5  - ■ in adding files.
  4100.           |M5  - Strings displayed in adding files.
  4101.           |B6  - ■ in comment adding.
  4102.           |M6  - Strings displayed when adding comments.
  4103.           |B7  - ■ in file maintainence. (MAINTAIN.BAT)
  4104.           |M7  - Strings displayed when running MAINTAIN.BAT.
  4105.           
  4106.                These codes are pretty easy to figure out. Each option
  4107.           has a blinking ■ that is displayed when that operation is in
  4108.           process. When the option completes, the ■ will stop blinking.
  4109.           The |Bx MCI goes where you want the ■ to go for each option.
  4110.           The |Mx MCI codes go where you want any progress/error
  4111.           messages displayed about the current operation. All of these
  4112.           messages can be configured via the string editor.
  4113.           
  4114.                All of the setup for the upload checker is done in the
  4115.           CONFIG program, specifically under 'System Options #2'. You
  4116.           can completely toggle off the checker, or certain operations
  4117.           of it by leaving the field blank. For example, if you don't
  4118.           want to add any files to your checked files, then leave
  4119.           'Files to add' in the CONFIG blank. The same goes for
  4120.           commenting, or scanning.
  4121.           
  4122.                A nice feature of the upload checker is that it can
  4123.           perform age constraint testing on your uploaded files. In
  4124.           System Options #2, there is a date field. Set this to
  4125.           whatever you want, and if the newest file is older than the
  4126.           date specified, the file will fail the upload checking.
  4127.           
  4128.                The unique part of the upload checker is that you can
  4129.           perform additional maintainence via a batch file called
  4130.           MAINTAIN.BAT. (Note: FILE_ID.DIZ checking is now internal to
  4131.           the upload checker, so you don't have to create a special
  4132.           maintain.bat that will extract FILE_ID.DIZ). There are two %
  4133.           codes that can be used in the maintain.bat. These are %1 for
  4134.           filename, and %2 for path of the work directory. Note that %2
  4135.           will also include the trailing backslash of the work
  4136.           directory's path.
  4137.           
  4138.           
  4139.                         SECTION 16: CONFIGURABLE ARCHIVERS
  4140.                         ──────────────────────────────────
  4141.           
  4142.                The configurable archiver system allows the SysOp to
  4143.           setup multiple archivers, and allow the BBS to use these
  4144.           archivers for various operations. You can configure as many
  4145.           archivers as you want, and the users will be able to choose
  4146.           which archiver they want to use. The BBS will then use their
  4147.           default choice to pack QWK packets, pack message captures,
  4148.           pack filelists etc, View Files, Extract Files etc..
  4149.           
  4150.                Another good thing about the archiver system is that it
  4151.           can automatically detect what type of archive it's working
  4152.           with. It doesn't use the extension, but it uses the signature
  4153.           to find out what type of archive is present. A signature is a
  4154.           certain identification string that lets you identify what
  4155.           type of archive is being used. More on this will be explained
  4156.           later.
  4157.           
  4158.                Editing, and adding archivers is quite simple. The menu
  4159.           command for configurable archivers is *Z. Once you're in the
  4160.           archiver editor, the screen will look a bit like this:
  4161.            
  4162.           ╒═══════════════════════════════════════════════════════════╕
  4163.           │ Command :           (Q)uit   Oblivion/2 Archiver Editor   │
  4164.           ╘═══════════════════════════════════════════════════════════╛
  4165.           ╒═══════════════════════════════════════════════════════════╕
  4166.           │ (A) Archive Name   : PKZIP                                │
  4167.           │ (B) Archive Ext.   : ZIP                                  │
  4168.           │ (C) Use Zip Viewer : Yes                                  │
  4169.           │ (D) Swap for Coms  : Yes                                  │
  4170.           │ (E) Compress Com   : PKZIP.EXE %1 %2                      │
  4171.           │ (F) Extract Com    : PKUNZIP.EXE %1 %3 %2                 │
  4172.           │ (G) View Com       : VIEWZIP.BAT                          │
  4173.           │ (H) Make SFX Com   : ZIP2EXE.EXE %1                       │
  4174.           │ (I) Test Com       : PKUNZIP.EXE -T %1                    │
  4175.           │ (J) Add Comment Com: ADDCOM.BAT                           │
  4176.           │ (K) Add Files Com  : PKZIP.EXE -A %1 %2                   │
  4177.           │ (L) Sig String     : PK                                   │
  4178.           │ (M) Sig Location   : 1                                    │
  4179.           │ (N) List Prefix    : @                                    │
  4180.           │ (=) Insert Archiver                                       │
  4181.           │ (-) Delete Archiver                                       │
  4182.           └═══════════════════════════════════════════════════════════╛
  4183.           
  4184.           The above commands will be explained here:
  4185.           
  4186.           
  4187.           Archive name        - Enter the name of the archiver.
  4188.           Archive extension   - Enter the extension that this archiver
  4189.                                 produces.
  4190.           Use ZIP viewer      - This toggles the use of the Obv/2
  4191.                                 internal ZIP viewer. Only turn this on
  4192.                                 if the archiver is ZIP compatible.
  4193.           Swap for commands   - If you want the BBS to swap to DISK/EMS
  4194.                                 XMS before running archiver commands,
  4195.                                 turn this option on.
  4196.           Compression command - Place the command that the archive uses
  4197.                                 to compress files. %1 = Path and
  4198.                                 filename, and %2 = wildcard. (All of
  4199.                                 this will be filled in by the BBS.)
  4200.           Extraction command  - Place the command that the archive uses
  4201.                                 to extract files. %1 = Path and
  4202.                                 filename, %2 = wildcard, and %3 = Path
  4203.                                 to your work directory.
  4204.           View command        - Place the command that the archive uses
  4205.                                 to view files. You must force output to
  4206.                                 a file using DOS redirection commands,
  4207.                                 BUT you must do this using a batch file
  4208.                                 .  The file that contains the output
  4209.                                 from the archiver must be named
  4210.                                 ARCLIST.  and it must be in your work
  4211.                                 directory.  %1 = Path and filename, %2
  4212.                                 = wildcard, and %3 = path to your work
  4213.                                 directory. Here is an example batch
  4214.                                 file:
  4215.                                 @%2..\PKUNZIP.EXE -V %1>%2ARCLIST.
  4216.                                 See the example above if you don't
  4217.                                 understand how to redirect the output
  4218.                                 of the archiver.
  4219.           Make SFX command    - This is the command that the archive
  4220.                                 uses to create Self-Extracting (.EXE)
  4221.                                 archives. %1 = Path and filename, %2 =
  4222.                                 wildcard, and %3 = path to your work
  4223.                                 directory.
  4224.           Add comment command - This is the command that the archive
  4225.                                 uses to add comments to the archive.
  4226.                                 Again, you must follow the above
  4227.                                 example of redirection with a batch
  4228.                                 file.  %1 = Path and filename, and %2 =
  4229.                                 Comment file.  You can setup this file
  4230.                                 in the CONFIG under System Options #2.
  4231.           Add files command   - This is the command that the archive
  4232.                                 uses to add additional files to an
  4233.                                 archive. %1 = Path and filename, and %2
  4234.                                 = the files to add to the archive. This
  4235.                                 also can be configured via System
  4236.                                 Options #2 in the CONFIG.
  4237.           Signature String    - This is the signature identification of
  4238.                                 the archiver. Each archiver has a
  4239.                                 certain ID string that it uses to
  4240.                                 identify archives that it made. For
  4241.                                 example, PKZIP puts a PK in the first
  4242.                                 two bytes of its files. This lets PKZIP
  4243.                                 know that any file with a PK in the
  4244.                                 first two bytes was created by PKZIP.
  4245.                                 If this ID changes, like in LHA, you
  4246.                                 can use a ? in the signature location
  4247.                                 to signify a wildcard. You MUST have
  4248.                                 other letters that the program can
  4249.                                 search for. DO NOT JUST PUT ? in the
  4250.                                 sig string! You must enter all of the
  4251.                                 signature ID's in HEX format. So, go
  4252.                                 into a hex editor, and find the
  4253.                                 signature and its location, then enter
  4254.                                 the string in HEX.
  4255.           Signature location   - This is the location in bytes of the
  4256.                                  starting location of the signature
  4257.                                  string.  So, if the first two letters
  4258.                                  of the archive are PK, then you'd put
  4259.                                  1 in this field.
  4260.           List prefix          - Many archivers use a certain charater
  4261.                                  when you want the program to read in a
  4262.                                  list of files from a textfile. IE: In
  4263.                                  PKZIP, you can ZIP a group of files
  4264.                                  that you specify in a textfile like
  4265.                                  this: PKZIP OBV2-210.ZIP
  4266.                                  @C:\OBV2\OBV2.LST  It will ZIP up all
  4267.                                  of the files in OBV2.LST. Well, as you
  4268.                                  can see, you had to preceed that file
  4269.                                  by a @. This @ is the list character.
  4270.                                  Enter the list character in this
  4271.                                  field.
  4272.           Add/Insert Archiver  - Self-Explanatory.
  4273.           
  4274.           
  4275.                The members of the Oblivion/2 team, and all Oblivion/2
  4276.           SysOps would like to thank you for your interest in
  4277.           Oblivion/2. I hope this documentation helped you resolve many
  4278.           of your problems with the BBS. Thank you for your support of
  4279.           Oblivion/2, the leader in telecommunications excellence!
  4280.