home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / DOCS25.ZIP / MAIN.DOC < prev    next >
Text File  |  1990-03-11  |  278KB  |  6,777 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.       ---/   Telegard Bulletin Board System -- Version 2.5 Standard   \---
  30.      ---(      Copyright 1988,89,90 by Eric Oman, Martin Pollard,      )---
  31.       ---\           and Todd Bolitho - All Rights Reserved           /---
  32.        ------------------------------------------------------------------
  33.  
  34.                                Main Documentation
  35.                                  March 11, 1990
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                Telegard Bulletin Board System Main Documentation
  54.       Copyright 1988,89,90 by Eric Oman, Martin Pollard, and Todd Bolitho.
  55.                               All rights reserved.
  56.  
  57.      No  part  of  this publication may be  reproduced  without  the  prior
  58.      written consent of the copyright holders.  All brand and product names
  59.      mentioned in this publication are trademarks or registered  trademarks
  60.      of their respective copyright holders.
  61.  
  62.  
  63.  
  64.                  Original documentation written by Bill Schram.
  65.           Additional documentation provided by Eric Oman, Bill Schram,
  66.                         John Dixon, and Martin Pollard.
  67.  
  68.  
  69.  
  70.      The  Telegard development team wishes to extend special thanks to  the
  71.      following individuals:
  72.  
  73.           Bill  Schram, whose extensive work on the original  documentation
  74.                provided the major portion of this work;
  75.  
  76.           John Dixon, who provided much information on the use of  Telegard
  77.                and US Robotics high-speed modems;
  78.  
  79.      and  all  the other individuals who assisted in  making  Telegard  the
  80.      product it is today.
  81.  
  82.  
  83.  
  84.  
  85.                       ___________________________________
  86.  
  87.                        T A B L E   O F   C O N T E N T S
  88.                       ___________________________________
  89.  
  90.  
  91.      Introduction ..................................................... 1
  92.         Installing a New System ....................................... 1
  93.         Updated Releases .............................................. 1
  94.         Source Code Availability ...................................... 2
  95.         Warranty and Copyright Information ............................ 2
  96.         Additional Information and Help ............................... 2
  97.      System Startup and the WFC Screen ................................ 3
  98.      SysOp Function Keys .............................................. 7
  99.      The ACS System ................................................... 10
  100.      The MCI Code System .............................................. 13
  101.         MCI Codes for Prompts ......................................... 13
  102.         MCI Codes for Door Commands ................................... 14
  103.         MCI Codes for Messages and Text Files ......................... 15
  104.         MCI Color Codes ............................................... 16
  105.      System Configuration ............................................. 17
  106.         Modem Configuration ........................................... 18
  107.         File Paths & BBS Configuration ................................ 21
  108.         System ACS Settings ........................................... 24
  109.         General Variables ............................................. 26
  110.         General Flagged Functions ..................................... 29
  111.         File Section Configuration .................................... 33
  112.            Archive Configuration ...................................... 35
  113.         New User & Auto-Validation Settings ........................... 38
  114.         Miscellaneous Configuration ................................... 41
  115.         FidoNet Configuration ......................................... 42
  116.         String Configuration .......................................... 45
  117.         Default Colors ................................................ 50
  118.         Time Limitations .............................................. 51
  119.         Call Allowances Per Day ....................................... 52
  120.         UL/DL Number of Files Ratio ................................... 52
  121.         UL/DL Kilobytes Ratio ......................................... 52
  122.      Modem Information ................................................ 53
  123.         Sample Initialization Strings ................................. 53
  124.         High-Speed Modems ............................................. 53
  125.            The US Robotics Dual Standard Modem ........................ 54
  126.         Using a FOSSIL Communications Driver .......................... 54
  127.            The History of FOSSIL ...................................... 55
  128.            How a FOSSIL Driver Benefits Telegard ...................... 56
  129.            Installing a FOSSIL Driver With Telegard ................... 56
  130.      The User Editor .................................................. 57
  131.      The File Base Editor ............................................. 62
  132.      The Message Base Editor .......................................... 67
  133.      The Protocol Editor .............................................. 73
  134.      The Menu Editor .................................................. 79
  135.         The Main Editor Menu .......................................... 79
  136.         Menu Command Modification ..................................... 81
  137.         Menu Information Modification ................................. 83
  138.         Special Global Menu Commands .................................. 85
  139.         The Help-File Menu System ..................................... 86
  140.         The Generic Menu System ....................................... 88
  141.         Linking Menu Commands ......................................... 89
  142.         Menu Commands Available in Telegard ........................... 90
  143.  
  144.  
  145.  
  146.  
  147.      The Scheduled Event Editor ....................................... 91
  148.      Mini-DOS ......................................................... 95
  149.         Mini-DOS Commands ............................................. 95
  150.         The Mini-DOS Text Editor ...................................... 97
  151.      The InfoForm Questionnaire System ................................ 99
  152.         How InfoForm Questionnaires Are Constructed ................... 99
  153.         The New User Questionnaire .................................... 99
  154.         Asking and Reading InfoForm Questionnaires .................... 99
  155.         InfoForm Questionnaire Commands ............................... 100
  156.         A Sample InfoForm Questionnaire ............................... 101
  157.      Run-Time Errors .................................................. 103
  158.         DOS Errors .................................................... 104
  159.         I/O Errors .................................................... 104
  160.         Critical Errors ............................................... 104
  161.         Fatal Errors .................................................. 105
  162.  
  163.                    Telegard Main Documentation - Version 2.5
  164.  
  165.  
  166.                                  ______________
  167.  
  168.                                   INTRODUCTION
  169.                                  ______________
  170.  
  171.  
  172.      Thank  you for choosing Telegard as your bulletin board  system  (BBS)
  173.      software  of  choice.   We  feel  that  Telegard  represents  the  BBS
  174.      community  as a nice, user friendly software package that is  easy  to
  175.      set up, yet powerful enough to set it apart from other software in its
  176.      class.
  177.  
  178.      Telegard  was  written and compiled using the Turbo  Pascal  compiler,
  179.      version  5.5,  from Borland International.  Main testing was  provided
  180.      by Eric Oman, Martin Pollard, and Todd Bolitho.
  181.  
  182.  
  183.      -----------------------
  184.      INSTALLING A NEW SYSTEM
  185.      -----------------------
  186.  
  187.      Telegard  was  designed to be used with the following  minimum  system
  188.      configuration:
  189.  
  190.           -    IBM PC/XT/AT (or true compatible) or PS/2
  191.           -    Hard disk drive (10 megabytes minimum)
  192.           -    384K RAM (more is preferable)
  193.           -    80 column monochrome or color monitor
  194.           -    Modem (300 baud or greater; Hayes compatible is preferred)
  195.           -    PC-DOS or MS-DOS version 3.2 or later
  196.  
  197.      A  start-up package is distributed under the name INITxxxx.ZIP,  where
  198.      "xxxx"  indicates  the  version  number  in  question.   This  archive
  199.      contains complete documentation concerning the setup of a new system.
  200.  
  201.  
  202.      ----------------
  203.      UPDATED RELEASES
  204.      ----------------
  205.  
  206.      Alpha  and Beta sites (as well as most Standard sites) will  have  the
  207.      latest  Standard release, and will distribute them at no  cost  (other
  208.      than  the  phone call to download the program!).   Hopefully,  updates
  209.      will  be  released on a regular basis, but we are unable to  give  any
  210.      kind of schedule.
  211.  
  212.      Since  Alpha  and  Beta sites perform testing  of  newer  versions  of
  213.      Telegard before it is released Standard, you might want to call  those
  214.      boards  to keep up with the latest features.  We are adding  them  all
  215.      the time!
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.                                    - Page 1 -
  225.  
  226.                    Telegard Main Documentation - Version 2.5
  227.  
  228.  
  229.      ------------------------
  230.      SOURCE CODE AVAILABILITY
  231.      ------------------------
  232.  
  233.      The  source code for Telegard is not available for the general  public
  234.      under any circumstances.  This may go "against the grain" of  seasoned
  235.      programmers, but the Telegard development team has had much trouble in
  236.      the  past with the source code "floating around," and doesn't want  to
  237.      repeat the same mistakes in the future.
  238.  
  239.      A  software  developer's toolkit is available for Turbo Pascal  and  C
  240.      programmers  who wish to write support utilities for  Telegard.   This
  241.      toolkit  contains  the record structures for  Telegard's  data  files.
  242.      Contact the Telegard development team for further details.
  243.  
  244.  
  245.      ----------------------------------
  246.      WARRANTY AND COPYRIGHT INFORMATION
  247.      ----------------------------------
  248.  
  249.      Telegard  is  not  public domain software; it is  copyrighted  by  the
  250.      Telegard  development  team.   However,  we grant  you  the  right  to
  251.      distribute as many copies of the Standard release version as you wish,
  252.      provided the following restrictions are kept in mind:
  253.  
  254.           -    Only distribute the Standard release version in its original
  255.                form, with all of its related files intact.  We will allow
  256.                the archives to be converted to a different format, but that
  257.                is the extent of it.
  258.           -    Do not accept ANY kind of payment for the program.  The
  259.                exception would be computer clubs and other organizations
  260.                that charge a nominal price for disk copying, mailing, etc.
  261.           -    Do not alter the program in any manner.
  262.           -    Do not use the program in a commercial environment.  If you
  263.                wish to do so, contact the development team for details.
  264.  
  265.      Telegard is guaranteed only to take up disk space.  No other  warranty
  266.      or responsibility is implied; the development team is not  responsible
  267.      for  damages  resulting  from  the use (or  misuse)  of  the  Telegard
  268.      software.  In plain English:  It works for us, but if it doesn't  work
  269.      for  you... c'est la vie.  (Or, in the immortal words of  Wynn  Wagner
  270.      III:   "Run  at  your  own  risk, but  if  it  breaks,  YOU  have  the
  271.      pieces...")
  272.  
  273.  
  274.      -------------------------------
  275.      ADDITIONAL INFORMATION AND HELP
  276.      -------------------------------
  277.  
  278.      Experiment; it's a big system, and you're not going to learn it all in
  279.      one sitting.  If you need help and/or information concerning the setup
  280.      and  operation  of  a  Telegard system, you may  contact  one  of  the
  281.      Telegard  Alpha or Beta sites.  Since the installed base  of  Telegard
  282.      systems  is growing by leaps and bounds, you should check the list  of
  283.      Telegard  systems  (included with every Standard release) for  a  site
  284.      near you.
  285.  
  286.  
  287.                                    - Page 2 -
  288.  
  289.                    Telegard Main Documentation - Version 2.5
  290.  
  291.  
  292.                       ___________________________________
  293.  
  294.                        SYSTEM STARTUP AND THE WFC SCREEN
  295.                       ___________________________________
  296.  
  297.  
  298.      To  start  the BBS, change to the main BBS directory and  execute  the
  299.      "BBS"  program.   Assuming  that  the  main  BBS  directory  is  named
  300.      "C:\BBS", you would type the following commands:
  301.  
  302.           CD C:\BBS
  303.           BBS
  304.  
  305.      Alternatively, you may place these commands into a batch file, and use
  306.      the batch file to start the BBS.  This has several advantages, not the
  307.      least  of  which  is  the ability to  interpret  the  ERRORLEVEL  code
  308.      returned  from  the program.  Normal termination, critical  errors  or
  309.      external system events can be identified and appropriate action taken,
  310.      depending  on  the  ERRORLEVEL value.
  311.  
  312.      There  are also several command line options you can use to alter  the
  313.      functioning  of  the system.  These options can be entered  in  either
  314.      upper or lower case:
  315.  
  316.           -Bxxxxx   Answer the phone and force the baud rate to "xxxxx".
  317.                     Note that the "answer phone" string is NOT sent to the
  318.                     modem.  This option will find the most use when
  319.                     executing the system from a front-end mailer (refer to
  320.                     "Using Telegard With FidoNet" for more information).
  321.           -EExxx    If a critical error occurs during the operation of the
  322.                     BBS, it aborts to DOS with an ERRORLEVEL value of 254.
  323.                     This option can be used to change that value.
  324.           -ENxxx    Normally, when you perform a normal exit back to DOS,
  325.                     the program returns an ERRORLEVEL value of 255.  This
  326.                     option can be used to change that value.
  327.           -K        Operate the BBS in local mode only (don't send anything
  328.                     out to the modem, and don't respond to incoming calls).
  329.           -P        Pack the message bases and return to DOS.  This option
  330.                     can be useful when using Telegard with a front-end
  331.                     mailer (refer to "Using Telegard With FidoNet");
  332.                     message base packing can be performed from the command
  333.                     line during a front-end event.  Thus, you don't have to
  334.                     mess around with two event systems (you can perform all
  335.                     external events through the front-end if you like).
  336.           -Q        Quit to DOS after the next user logs off.
  337.  
  338.      Telegard  will then perform various initialization functions (such  as
  339.      loading data files and initializing the modem) before arriving at  the
  340.      Wait  For Caller (WFC) screen.  The WFC screen is where the  BBS  sits
  341.      while  waiting for the next caller.  The commands available from  this
  342.      screen  are  displayed, as well as  the  following  constantly-updated
  343.      information:
  344.  
  345.           Time - The current time and date.
  346.           Mail - The number of Email messages the SysOp has waiting.
  347.           DLs - The number of files and kilobytes downloaded for the day.
  348.  
  349.  
  350.                                    - Page 3 -
  351.  
  352.                    Telegard Main Documentation - Version 2.5
  353.  
  354.  
  355.           ULs - The number of files and kilobytes uploaded for the day.
  356.           % Activity - The percentage of activity for the day.
  357.           Disk Space - The total amount of remaining disk space.
  358.           Last Active - How long ago the BBS was last active.
  359.           Last Caller - The name of the last remote caller.
  360.  
  361.      The  commands  available from the WFC screen are explained  in  detail
  362.      below.   In most cases, there is a chapter in this manual  devoted  to
  363.      the  command in question (such as the message and file  base  editors,
  364.      and the system configuration command).
  365.  
  366.           A         Sends the "answer phone" command to the modem.  It is
  367.                     used mainly for situations where you have your system
  368.                     "hard-wired" to another system for testing purposes.
  369.                     In most cases, the BBS will automatically answer the
  370.                     phone by itself.
  371.  
  372.           B         Enters the message base editor, where you can enter and
  373.                     modify the bases used to store public messages.
  374.  
  375.           C         Displays a list of callers for the day.
  376.  
  377.           D         Shells to DOS, allowing you to perform maintenance and
  378.                     other functions that aren't available through Mini-DOS.
  379.                     To return to the WFC menu, use the DOS "EXIT" command.
  380.  
  381.           E         Enters the scheduled event editor, where you can enter
  382.                     and modify the various scheduled events used to perform
  383.                     system maintenance (and other functions).
  384.  
  385.           F         Enters the file base editor, where you can enter and
  386.                     modify the bases used to store files for uploading and
  387.                     downloading by users.
  388.  
  389.           G         Enters the text file base editor, where you can enter
  390.                     and modify the bases used to store user-viewable text
  391.                     (and ANSI) files, as well as add and delete entries in
  392.                     each base.
  393.  
  394.           H         Sends the "initialization" command to the modem, which
  395.                     serves to hang up the phone if it is offhook (usually
  396.                     via the "O" command).
  397.  
  398.           I         Enters the voting editor, where you can enter and
  399.                     modify the voting booth questions.
  400.  
  401.           L         Displays the SysOp logs.  You can display today's log,
  402.                     or the logs of previous days (up to the number of days
  403.                     specified in the system configuration).
  404.  
  405.           M         Allows viewing of ALL Email messages that have been
  406.                     posted.  It does not allow for the viewing of a
  407.                     specific individual's Email (use the "R" command for
  408.                     that).
  409.  
  410.  
  411.  
  412.  
  413.                                    - Page 4 -
  414.  
  415.                    Telegard Main Documentation - Version 2.5
  416.  
  417.  
  418.           N         Enters the Mini-DOS text editor, allowing you to create
  419.                     and edit any text file in the AFILES directory.  (This
  420.                     editor is very similar to the DOS "EDLIN" editor.)
  421.  
  422.           O         Sends the "offhook" command to the modem, which makes
  423.                     the line busy to all remote callers.  Use the "H" or
  424.                     "+" commands to hang up the phone.
  425.  
  426.           P         Enters the system configuration, where you can perform
  427.                     most of the major changes and modifications to the BBS.
  428.  
  429.           Q         Exits the BBS and returns to DOS with the "normal
  430.                     exit" ERRORLEVEL value (discussed earlier).
  431.  
  432.           R         Allows you to read a specific individual's Email
  433.                     messages.
  434.  
  435.           S         Displays the current status of the BBS (chat status,
  436.                     number of users, etc.).
  437.  
  438.           T         If a batch file named "TERM.BAT" exists, Telegard will
  439.                     execute it.  This is mainly used to call an external
  440.                     terminal program (such as MiniTerm, which is available
  441.                     separately).
  442.  
  443.           U         Enters the user editor, where you can modify the
  444.                     modify the information for each user of the BBS.
  445.  
  446.           V         Creates a text file containing the current questions in
  447.                     the voting booth, along with the current statistics of
  448.                     each answer (percentages, who voted for which answer,
  449.                     etc.), which can optionally be displayed on the screen.
  450.  
  451.           W         Allows you to send Email messages to other users,
  452.                     either individually or via various mass mail criteria.
  453.  
  454.           X         Enters the protocol editor, where you can enter and
  455.                     modify the definitions of the file transfer protocols
  456.                     used to upload and download files.
  457.  
  458.           Z         Displays the usage log information contained in the
  459.                     ZLOG.DAT file, which contains a record of all general
  460.                     system activity (number of posts, number of uploads
  461.                     and downloads, etc.).
  462.  
  463.           #         Enters the menu editor, where you can create and modify
  464.                     the BBS online menus.
  465.  
  466.           !         Enters Mini-DOS, which is a DOS-like environment that
  467.                     can be used for system maintenance functions.  Unlike
  468.                     the full DOS shell, Mini-DOS has security restrictions
  469.                     on many of its commands.
  470.  
  471.           +         Sends the "initialization" command to the modem, used
  472.                     to initialize the modem.  (This also serves to hang up
  473.                     the phone if the line was taken offhook via the "O"
  474.  
  475.  
  476.                                    - Page 5 -
  477.  
  478.                    Telegard Main Documentation - Version 2.5
  479.  
  480.  
  481.                     command.)
  482.  
  483.           [SPACE]   Allows  you  to  log on to the BBS  locally.   You  can
  484.                     choose to log on normally (by pressing "Y") or log on
  485.                     quickly  (by  pressing "F").  Logging on  quickly  will
  486.                     bypass the shuttle logon menu, all the text and ANSI
  487.                     files, the auto-message, and the bulletin menu (some or
  488.                     all of which may already be disabled by you via the
  489.                     system configuration).
  490.  
  491.           1 to 9    Executes batch files called "WFCBATx.BAT", where "x" is
  492.                     the digit that you pressed (1 to 9).
  493.  
  494.      There  is  a  secondary  WFC screen that is  displayed  if  the  local
  495.      security  function  is  enabled in the  system  configuration;  it  is
  496.      called,  appropriately  enough, the WFC security  screen.   When  this
  497.      screen is displayed, only two commands are allowed:  [SPACE] and  "Q".
  498.      "Q"  will,  obviously, exit to DOS with the "normal  exit"  ERRORLEVEL
  499.      value.   Pressing  [SPACE]  will  bring up a  prompt  for  the  system
  500.      password;  entering the correct password will display the  normal  WFC
  501.      screen, allowing the use of all WFC menu commands.
  502.  
  503.      Note that both the normal and security WFC screens can be modified  to
  504.      suit  your taste.  The image of both of these screens is contained  in
  505.      two ANSI files, WFCMENU.ANS (the normal screen) and WFCMENU0.ANS  (the
  506.      security  screen).   Modifying one of these files  will  automatically
  507.      regenerate  the WFCMENU.DAT and WFCMENU0.DAT files (which contain  the
  508.      raw screen images), and will give your system a more customized look.
  509.  
  510.      Lines 1-23 of the security WFC screen, and lines 6-23 of the main  WFC
  511.      screen, are available for your images.  (Lines 24 and 25 are  reserved
  512.      for information that the BBS displays.)  Some further notes about  the
  513.      normal WFC screen:
  514.  
  515.           -    If you turn the WFC logo off in the system configuration,
  516.                lines 1-5 also become available for your images.
  517.  
  518.           -    Be careful of the portion of the screen that displays the
  519.                constantly updated information.  Make sure that whatever
  520.                image you create isn't affected by the information that will
  521.                be displayed.  For simplicity, it is suggested that you
  522.                leave that portion of the image alone (this is, of course,
  523.                entirely up to you).
  524.  
  525.      ANSI  files can be created using a Shareware program  called  TheDraw,
  526.      which is an ANSI picture editor and animator.  Look for TheDraw on one
  527.      of  the  BBSes  in your area; it is a  very  popular  program,  widely
  528.      regarded as the best in its class.  (It is usually under the  filename
  529.      "TDRAWxxx.ZIP"; the "xxx" depends on the current version number.)
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.                                    - Page 6 -
  540.  
  541.                    Telegard Main Documentation - Version 2.5
  542.  
  543.  
  544.                              _____________________
  545.  
  546.                               SYSOP FUNCTION KEYS
  547.                              _____________________
  548.  
  549.  
  550.      There  are  many functions available to you via  function  keys,  both
  551.      while  a  user is online (or while you are online locally)  and  while
  552.      you're performing local maintenance.  These function keys are used  to
  553.      perform  maintenance, change a user's security information, and  other
  554.      operations.
  555.  
  556.      The following function keys are available only when a user is online:
  557.  
  558.           [F1]           Allows modification of the user's security
  559.                          information (SL, DSL, AR & AC flags, file points).
  560.                          Prints the "SysOp working" message while this
  561.                          window is displayed.
  562.  
  563.           [Shift-F1]     Same as [F1] except that the "SysOp working"
  564.                          message is not displayed.
  565.  
  566.           [F2]           Switches the SysOp information windows between the
  567.                          normal 5-line window and the extended 11-line
  568.                          window.  If the window is not on, [F2] will turn
  569.                          it on.
  570.  
  571.           [Shift-F2]     Toggles the SysOp window on and off.
  572.  
  573.           [F3]           Toggles the user's keyboard on and off.  This
  574.                          doesn't actually disable the user's keyboard, it
  575.                          only tells the system to ignore any keystrokes
  576.                          coming from the user (which has the EFFECT of
  577.                          disabling the user's keyboard).  Ever been in chat
  578.                          mode and couldn't get a word in edgewise?  This is
  579.                          the function key for you!
  580.  
  581.           [Shift-F3]     Toggles the user's screen on and off.  Again, this
  582.                          doesn't actually disable the user's screen, it
  583.                          only tells the system not to send any output to
  584.                          the user (which has the EFFECT of disabling the
  585.                          user's screen).
  586.  
  587.           [Alt-F3]       Toggles the local screen on and off.  Like
  588.                          [Shift-F3], it doesn't disable the screen, it only
  589.                          suspends output to the screen (which has the
  590.                          EFFECT of disabling the local screen).
  591.  
  592.           [F4]           Turns off the "user attempted to chat" flag
  593.                          (shown on the SysOp window as a blinking "-CHAT-"
  594.                          message).
  595.  
  596.           [Alt-F4]       Performs a local shell to DOS.  Prints the "SysOp
  597.                          has shelled to DOS" message before entering DOS,
  598.                          and the "thank you for waiting" message after
  599.                          returning from DOS.
  600.  
  601.  
  602.                                    - Page 7 -
  603.  
  604.                    Telegard Main Documentation - Version 2.5
  605.  
  606.  
  607.           [Ctrl-F4]      Performs a "warm" reboot of the computer.  (A
  608.                          "warm" reboot skips the memory test and other
  609.                          self-checks normally associated with a first-time,
  610.                          or "cold" boot.)
  611.  
  612.           [F5]           Hangs up on a user immediately and returns to the
  613.                          WFC menu.
  614.  
  615.           [Shift-F5]     Allows you to select a hangup message to display
  616.                          (HANGUP0.MSG through HANGUP9.MSG) before hanging
  617.                          up on the user and returning to the WFC menu.
  618.  
  619.           [Alt-F5]       Prints fake "line noise" (random ASCII characters)
  620.                          before hanging up on the user and returning to
  621.                          the WFC menu.
  622.  
  623.           [Ctrl-F5]      Prints fake "line noise" but does NOT hang up on
  624.                          the user.  Used mainly to drive users crazy!  (Who
  625.                          says being a SysOp isn't fun?!)
  626.  
  627.           [F6]           Redraws the SysOp window, if active.
  628.  
  629.           [F7]           Subtracts five minutes from a user's total time
  630.                          left.
  631.  
  632.           [Shift-F7]     Subtracts a specified amount of time from a user's
  633.                          total time left.
  634.  
  635.           [F8]           Adds five minutes to a user's total time left.
  636.  
  637.           [Shift-F8]     Adds a specified amount of time to a user's total
  638.                          time left.
  639.  
  640.           [F9]           Toggles temporary SysOp access for a user.  If
  641.                          temporary SysOp access is still active when the
  642.                          user logs off, the user's statistics are returned
  643.                          to normal.  USE ONLY WITH TRUSTED USERS!!!
  644.  
  645.           [Alt-F9]       Sends a continuous stream of ASCII bell characters
  646.                          (7 decimal) to a user, which will produce a
  647.                          continuous stream of beeps until the user presses
  648.                          a key on his keyboard (or hangs up).  Used to get
  649.                          a daydreaming user's attention!
  650.  
  651.           [F10]          Toggles chat mode on and off, allowing you to
  652.                          "talk" to a user via the keyboard.
  653.  
  654.           [Shift-F10]    Toggles "beep-after-end" on and off.  This feature
  655.                          will, when activated, take the phone offhook and
  656.                          sound an alarm when the user logs off, thus
  657.                          letting you know that the system is available.
  658.  
  659.           [Alt][F10]     Displays the chat reason on the top line of the
  660.                          local screen.
  661.  
  662.  
  663.  
  664.  
  665.                                    - Page 8 -
  666.  
  667.                    Telegard Main Documentation - Version 2.5
  668.  
  669.  
  670.           [Home]         Toggles the chat capture buffer on and off (used
  671.                          while in chat mode).
  672.  
  673.           [Alt-G]        Allows enabling and disabling of activity trapping
  674.                          and chat capturing for a user.
  675.  
  676.           [Alt-J]        An alternative to [Alt-F4] to shell to DOS.  The
  677.                          [Alt-J] sequence is the same one used by Telix and
  678.                          other communications programs to shell to DOS,
  679.                          thus it provides ease of use for SysOps that use
  680.                          those particular programs.
  681.  
  682.           [Alt-L]        Clears the local screen.  If the SysOp window is
  683.                          active, only the user area is cleared.
  684.  
  685.           [Alt-T]        Toggles the SysOp window display between the top
  686.                          and bottom of the local screen.
  687.  
  688.           [Alt-V]        Validates a user while he/she is online, using the
  689.                          validation settings specified in the system
  690.                          configuration.
  691.  
  692.      The  following  function keys are available anywhere  in  the  system,
  693.      whether or not a user is online:
  694.  
  695.           [Alt-=]        Toggles "DOS exit after user logoff" on and off.
  696.                          This means that the system will return to DOS
  697.                          after the current caller has logged off or, if
  698.                          toggled on while at the WFC menu (or elsewhere),
  699.                          when the NEXT caller has logged off.
  700.  
  701.           [Alt-x]        Executes a batch file called "GLOBATx.BAT", where
  702.                          "x" is a number from 1 to 9.
  703.  
  704.           [Scroll Lock]  Toggles the "SysOp available for chat" flag on and
  705.                          off.  When the [Scroll Lock] light on the keyboard
  706.                          is off, the SysOp is available; when the light is
  707.                          on, the SysOp is unavailable.
  708.  
  709.           [Ctrl]         Provides for an immediate exit from the BBS,
  710.           [Print Scrn]   returning the "critical error" ERRORLEVEL value.
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                                    - Page 9 -
  729.  
  730.                    Telegard Main Documentation - Version 2.5
  731.  
  732.  
  733.                                 ________________
  734.  
  735.                                  THE ACS SYSTEM
  736.                                 ________________
  737.  
  738.  
  739.      ACS  stands for Access Condition String, and is a powerful new  method
  740.      of  stating  the requirements and conditions under which  a  user  has
  741.      access to something -- whether it be a file area, a menu command, or a
  742.      text file in the text file section.
  743.  
  744.      The ACS system combines security levels (SL and DSL), AR and AC  flags
  745.      and several other unique features into a string of twenty  characters.
  746.      It  is ALMOST like a miniature programming language.  (I know some  of
  747.      you probably flinched at the word "programming"!)
  748.  
  749.      There  are 12 different functions in the ACS system, and all  of  them
  750.      have the same basic syntax:  A letter followed by the parameter of the
  751.      function,  all of which can be specified in upper or lower case.   The
  752.      following is a list of all possible functions.
  753.  
  754.           Function   :   "Annn"
  755.           Description:   Age of user
  756.           Access req.:   Must be as old as "nnn".
  757.  
  758.           Function   :   "Bnnn"
  759.           Description:   Baud rate, without last two zeros ("00")
  760.           Access req.:   Must be connected at "nnn" baud.
  761.  
  762.           Function   :   "Dnnn"
  763.           Description:   DSL
  764.           Access req.:   Must have DSL of "nnn" or higher.
  765.  
  766.           Function   :   "Fx"
  767.           Description:   AR flag
  768.           Access req.:   Must have AR flag "x" (A to Z).
  769.  
  770.           Function   :   "Gx"
  771.           Description:   Gender
  772.           Access req.:   Must have gender "x" (M or F).
  773.  
  774.           Function   :   "Pnnnnn"
  775.           Description:   File points
  776.           Access req.:   Must have AT LEAST "nnnnn" file points.
  777.  
  778.           Function   :   "Rx"
  779.           Description:   AC flag
  780.           Access req.:   Must have AC flag "x" (LCVBA*PEKM1234).
  781.  
  782.           Function   :   "Snnn"
  783.           Description:   SL level
  784.           Access req.:   Must have SL of "nnn" or higher.
  785.  
  786.           Function   :   "Tnnnnn"
  787.           Description:   Time left
  788.           Access req.:   Must have AT LEAST "nnnnn" minutes of time left.
  789.  
  790.  
  791.                                    - Page 10 -
  792.  
  793.                    Telegard Main Documentation - Version 2.5
  794.  
  795.  
  796.           Function   :   "Unnnn"
  797.           Description:   User number
  798.           Access req.:   Must be user number "nnnn".
  799.  
  800.           Function   :   "VV"
  801.           Description:   Validation
  802.           Access req.:   Must be a validated user.
  803.  
  804.           Function   :   "Ynnnn"
  805.           Description:   Time of day
  806.           Access req.:   Must be AT LEAST "nnnn" minutes after midnight.
  807.  
  808.      The following are a few examples:
  809.  
  810.           "A21"  - Must be 21 years old to have access.
  811.           "B96"  - Must be connected at 9600 or higher baud rate.
  812.           "FS"   - Must have AR flag "S".
  813.           "T20"  - Must have at least 20 minutes time left.
  814.           "Y360" - Must be later than 6:00 am.
  815.  
  816.      There  are five logical operators that can be used in ACS, only  three
  817.      of which (the first three) are used frequently:
  818.  
  819.           "&" - Logical AND
  820.           "|" - Logical OR
  821.           "!" - Logical NOT
  822.           "^" - Logical TRUE
  823.           "%" - Logical FALSE
  824.  
  825.      The  default  operator  between  any  two  functions  is  AND.   Thus,
  826.      functions  can  be strung together without any operators  in  between.
  827.      For  example,  "S20D50"  (aka "S20&D50") requires SL 20  and  DSL  50.
  828.      "A21FSD255" (aka "A21&FS&D255") requires that the user be 21 or older,
  829.      AR flag "S", and DSL 255.
  830.  
  831.      The OR operator is simple to use.  For example, "S20|FA" requires that
  832.      the user have either SL 20 *OR* AR flag "A".  In either case, the user
  833.      meets the access requirement.
  834.  
  835.      The  NOT  operator is also easy to use.  Just place  a  "!"  character
  836.      before any function to reverse it's meaning.  For example: "!FA" means
  837.      the  user  must NOT have AR flag "A" to have access.   IMPORTANT:   Be
  838.      sure  to  remember  that,  in  numeric  functions,  the  NOT  operator
  839.      COMPLETELY  REVERSES THE MEANING of the function.  Thus,  "!S30"  does
  840.      NOT  mean "SL less than or equal to 30"; it means "SL less  than  30",
  841.      *without* the "equal to".
  842.  
  843.      The  TRUE and FALSE operators are used to give everyone access, or  to
  844.      not  give  anyone access.  "^" means all users have  access,  and  "%"
  845.      means  no users at all have access.  They are NOT meant to be used  in
  846.      combination with other ACS operators!
  847.  
  848.      To  provide  for  even more complex ACS's,  parentheses  are  allowed.
  849.      "(S20FA)|(D255)" means, for example, that the user must have SL 20 and
  850.      AR flag "A", *OR* DSL 255, to have access.
  851.  
  852.  
  853.  
  854.                                    - Page 11 -
  855.  
  856.                    Telegard Main Documentation - Version 2.5
  857.  
  858.  
  859.      Here are some more examples:
  860.  
  861.           S50            User must have SL 50 to 255.
  862.           !S50           User must have SL 0 to 49.
  863.           VV|U1          User must be validated, or be user #1, to have
  864.                          access.
  865.           A21FAS50       User must be 21 years old, have AR flag "A", and
  866.                          and have 50 SL.
  867.           !(A21FAS50)    User has access so long as they do NOT have all of
  868.                          the following:  21 years old, AR flag "A", and
  869.                          SL 50.
  870.           !A21!FA!S50    User has access SO LONG AS they have NONE of the
  871.                          three.
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.                                    - Page 12 -
  918.  
  919.                    Telegard Main Documentation - Version 2.5
  920.  
  921.  
  922.                              _____________________
  923.  
  924.                               THE MCI CODE SYSTEM
  925.                              _____________________
  926.  
  927.  
  928.      Telegard provides a powerful system for displaying and handling system
  929.      and  user  information, in prompts, command lines and  text  messages.
  930.      This  is  done  using  a set of  codes  called  MCI  (Message  Command
  931.      Interpreter).  These codes are entered with the character "@" followed
  932.      by  a specific ASCII character.  Changing colors in text  messages  is
  933.      accomplished through a special system that is described later.
  934.  
  935.  
  936.      ---------------------
  937.      MCI CODES FOR PROMPTS
  938.      ---------------------
  939.  
  940.      The following MCI codes may be used in the various prompt strings that
  941.      can  be configured through the system configuration.  These codes  may
  942.      also  be used in the "To:" and "Subject:" fields in  public  messages,
  943.      but  a  user may only see the results of these codes if  the  MCI  ACS
  944.      field for the particular message base allows it.
  945.  
  946.      Unless stated otherwise, information displayed by these MCI codes  are
  947.      displayed using the current MCI color.
  948.  
  949.           @A        Displays the current message board number in the format
  950.                     "#xxx".
  951.  
  952.           @B        Displays the current message board name.  If the name
  953.                     contains MCI color codes, it will be displayed using
  954.                     those colors; otherwise, it is displayed in MCI color
  955.                     #5 (default: yellow) if Local, or MCI color #0
  956.                     (default: bold white) if EchoMail or GroupMail.
  957.  
  958.           @C        Displays the current file board number in the format
  959.                     "#xxx".
  960.  
  961.           @D        Displays the current file board name.  If the name
  962.                     contains MCI color codes, it will be displayed using
  963.                     those colors; otherwise, it is displayed in MCI color
  964.                     #5 (default: yellow).
  965.  
  966.           @F        Displays the current user's real first name.
  967.  
  968.           @G        Sounds a beep (on the user's side only).
  969.  
  970.           @H        Displays the current user's user name minus the user
  971.                     number.
  972.  
  973.           @K        Displays the number of kilobytes (K) available on the
  974.                     drive of the current file board's upload path.
  975.  
  976.           @L        Displays the current user's real last name.
  977.  
  978.  
  979.  
  980.                                    - Page 13 -
  981.  
  982.                    Telegard Main Documentation - Version 2.5
  983.  
  984.  
  985.           @M        Displays a carriage return/linefeed.
  986.  
  987.           @N        Displays the current user's user name and number.
  988.  
  989.           @P        Displays the number of file points remaining to the
  990.                     current user.
  991.  
  992.           @R        Displays the current user's entire real name.
  993.  
  994.           @T        Displays the amount of time online remaining to the
  995.                     current user in the format "HH:MM:SS".
  996.  
  997.           @U        Displays the message number that the current user is
  998.                     reading.
  999.  
  1000.           @V        Displays the commands that are accessible to the
  1001.                     current user at the current menu.
  1002.  
  1003.           @W        Displays the number of messages in the current message
  1004.                     board.
  1005.  
  1006.           @X        Displays the maximum number of lines allowed for a
  1007.                     message in the current message board.
  1008.  
  1009.           @Y        Displays the current message board name and number.  If
  1010.                     the name contains MCI color codes, it will be displayed
  1011.                     using those colors; otherwise, it is displayed in MCI
  1012.                     color #5 (default: yellow) if Local, or MCI color #0
  1013.                     (default: bold white) if EchoMail or GroupMail.  The
  1014.                     number is ALWAYS displayed with MCI color #5 or #0.
  1015.  
  1016.           @Z        Displays the string entered when the current user
  1017.                     requested a chat with the SysOp (the "chat reason").
  1018.  
  1019.  
  1020.      ---------------------------
  1021.      MCI CODES FOR DOOR COMMANDS
  1022.      ---------------------------
  1023.  
  1024.      The  following MCI codes may be used for the command lines  passed  to
  1025.      DOS  when executing an external program (a "door").  Note that  though
  1026.      many of these codes duplicate information returned from the MCI prompt
  1027.      codes, these codes can ONLY be used with door command lines.  Any  MCI
  1028.      color codes that may be present are removed before the information  is
  1029.      passed.
  1030.  
  1031.           @N        Returns the current user's user name.
  1032.  
  1033.           @F        Returns the current user's first name.
  1034.  
  1035.           @L        Returns the current user's last name.
  1036.  
  1037.           @T        Returns the amount of time online remaining to the
  1038.                     current user (in minutes).
  1039.  
  1040.  
  1041.  
  1042.  
  1043.                                    - Page 14 -
  1044.  
  1045.                    Telegard Main Documentation - Version 2.5
  1046.  
  1047.  
  1048.           @G        Returns a "1" if the current user has ANSI graphics
  1049.                     enabled, "0" if disabled.
  1050.  
  1051.           @R        Returns the current user's user number.
  1052.  
  1053.           @B        Returns the baud rate that the current user logged on
  1054.                     with.  Local keyboard logons are indicated with a "0"
  1055.                     (meaning no baud rate).
  1056.  
  1057.           @D        Returns the current file base's download directory
  1058.                     pathname.
  1059.  
  1060.           @I        Returns the current file base's *.DIR filename and
  1061.                     pathname.
  1062.  
  1063.  
  1064.      -------------------------------------
  1065.      MCI CODES FOR MESSAGES AND TEXT FILES
  1066.      -------------------------------------
  1067.  
  1068.      The  following  MCI codes may be used in .MSG text  files  and  public
  1069.      messages.   Note that if the current user's setup does not  match  the
  1070.      requirements for the MCI ACS field for a particular message base, that
  1071.      user cannot use these codes; they will instead be shown as "@1", "@2",
  1072.      etc.   (This does not apply to text files.)  The rules  regarding  MCI
  1073.      colors for MCI prompt codes also apply here.
  1074.  
  1075.           @1        Displays the current user's user name.
  1076.  
  1077.           @2        Displays the current user's real name.
  1078.  
  1079.           @3        Displays the current user's phone number.
  1080.  
  1081.           @4        Displays the current user's city & state.
  1082.  
  1083.           @5        Displays the current user's street address.
  1084.  
  1085.           @6        Displays the current user's postal zip code.
  1086.  
  1087.           @7        Clears the screen.
  1088.  
  1089.           @8        Provides a few seconds' delay.
  1090.  
  1091.           @9        Displays the "pause" string (defined in System
  1092.                     Configuration) and waits for the current user to press
  1093.                     a key.
  1094.  
  1095.           @!        Toggles the current user's ability to abort the message
  1096.                     or text file to OFF until it is finished being
  1097.                     displayed.
  1098.  
  1099.           @#        Toggles the "pause when screen is full" feature to OFF
  1100.                     (if enabled for the current user) until the message or
  1101.                     text file is finished being displayed.
  1102.  
  1103.  
  1104.  
  1105.  
  1106.                                    - Page 15 -
  1107.  
  1108.                    Telegard Main Documentation - Version 2.5
  1109.  
  1110.  
  1111.      ---------------
  1112.      MCI COLOR CODES
  1113.      ---------------
  1114.  
  1115.      The  ability  to display any of the ten MCI colors in  messages,  text
  1116.      files,  prompt strings, etc., is provided via two methods.  The  first
  1117.      method  is usable almost everywhere in Telegard:  At the  point  where
  1118.      you wish to change to another MCI color, press [Ctrl-P] (hold down the
  1119.      [Ctrl] key and press the "P" key, then release both) and then press  a
  1120.      number  key  ("0" through "9").  From then on, the current  MCI  color
  1121.      will  be  the one corresponding to the number you pressed,  until  the
  1122.      color  is changed again either by the system or by another  MCI  color
  1123.      code  sequence.
  1124.  
  1125.      (Technical  note:   The color code is stored as a  two-byte  sequence,
  1126.      "03" hexadecimal followed by "00" through "09" hexadecimal,  depending
  1127.      on  the  number  you selected.  This is why you  sometimes  see  funny
  1128.      characters  when  you TYPE a Telegard .MSG file from  DOS;  more  than
  1129.      likely, that file contains MCI color codes.)
  1130.  
  1131.      The  second method is to enter, at the point where you wish to  change
  1132.      colors,  a "^" character followed by a number character  ("0"  through
  1133.      "9").  For example, if you wished to change to MCI color #3, you would
  1134.      enter "^3".  This method is usable only in a few areas, which  include
  1135.      the system configuration string configuration section and the  prompts
  1136.      and strings in the menu editor's menu configuration section.
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.                                    - Page 16 -
  1170.  
  1171.                    Telegard Main Documentation - Version 2.5
  1172.  
  1173.  
  1174.                              ______________________
  1175.  
  1176.                               SYSTEM CONFIGURATION
  1177.                              ______________________
  1178.  
  1179.  
  1180.      At  the heart of Telegard is the system configuration feature.  It  is
  1181.      here  that  the entire operation of the system is set up,  from  modem
  1182.      configuration to file archiving options to time allowances and  upload
  1183.      and  download  restrictions.   This section is  selected  by  the  "P"
  1184.      command  at both the Wait For Caller (WFC) screen and the  SysOp  Menu
  1185.      (while executing the BBS).
  1186.  
  1187.      Once selected, the following menu is displayed:
  1188.      ______________________________________________________________________
  1189.  
  1190.      System configuration:
  1191.  
  1192.      A. Modem Configuration
  1193.      B. File paths & BBS configuration
  1194.      C. System ACS settings
  1195.      D. General variables
  1196.      E. General flagged functions
  1197.      F. File section configuration
  1198.      G. New user and Auto-Validation settings
  1199.      H. Miscellaneous configuration
  1200.      I. FidoNet configuration
  1201.      S. String configuration
  1202.      Z. Default Colors
  1203.  
  1204.      1. Time limitations
  1205.      2. Call allowance/day
  1206.      3. UL/DL # files ratio
  1207.      4. UL/DL K-bytes ratio
  1208.      5. Post/Call ratio
  1209.  
  1210.      Enter selection (A-I,SZ,1-5) [Q]uit :
  1211.      ______________________________________________________________________
  1212.  
  1213.      Selecting one of the keys will take you to the appropriate section  of
  1214.      the system configuration.  Pressing "Q" will take you back to the  WFC
  1215.      screen (or the SysOp Menu).
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.                                    - Page 17 -
  1233.  
  1234.                    Telegard Main Documentation - Version 2.5
  1235.  
  1236.  
  1237.      -------------------
  1238.      MODEM CONFIGURATION
  1239.      -------------------
  1240.  
  1241.      Modem  Configuration allows you to set up how the modem  and  Telegard
  1242.      communicate.  It is here that the COM port, modem commands and  result
  1243.      codes are configured.
  1244.  
  1245.      Note   that  the  default  settings  that  are  installed   with   the
  1246.      initialization  package are suitable for most standard modems (300  to
  1247.      2400  baud).   However,  as is the case with  most  things  concerning
  1248.      computers,  one configuration will simply not do for every  situation.
  1249.      This  is  especially true concerning modems.  That is why there  is  a
  1250.      special  section for modem information (called, appropriately  enough,
  1251.      "Modem  Information").  This section includes alternate  configuration
  1252.      strings,  information for setting up Telegard with various  9600  baud
  1253.      modems, and how to use Telegard with a FOSSIL communications driver.
  1254.  
  1255.      By  default, Telegard is set up for use with a Hayes compatible  modem
  1256.      (whatever that means nowadays).  If you modem does not fall into  this
  1257.      category -- older modems from Radio Shack, for instance, use their own
  1258.      command  sets -- you will have to make modifications to the  settings.
  1259.      Consult the manual for your modem for the correct information.
  1260.  
  1261.      Upon selecting this option, the following menu is displayed:
  1262.      ______________________________________________________________________
  1263.  
  1264.      Modem configuration
  1265.  
  1266.      1. Maximum baud rate    : 1200
  1267.      2. COM port number      : 1
  1268.      3. Modem initialization string:
  1269.         "ATH0Q0V0E0M0X1S0=0S2=1S10=40&C1"
  1270.      4. Modem answer string  : "ATA"
  1271.      5. Modem hangup string  : "~~~^A^A^A~~~ATH0"
  1272.      6. Modem offhook string : "ATH1M0"
  1273.      7. No call init. time   : 30
  1274.      A. 9600 ARQ rate baud   : 9600 baud
  1275.      F. Forced baud rates?   : Yes
  1276.      R. Modem result codes:
  1277.                           Case 1    Case 2 (ARQ)
  1278.         R1. NO CARRIER :  3
  1279.         R2. NO DIALTONE:  6
  1280.         R3. BUSY       :  7
  1281.         R4.  300 BAUD  :  1         0
  1282.         R5. 1200 BAUD  :  5         15
  1283.         R6. 2400 BAUD  :  10        16
  1284.         R7. 4800 BAUD  :  0         0
  1285.         R8. 9600 BAUD  :  13        17
  1286.  
  1287.      Enter selection or (Q)uit :
  1288.      ______________________________________________________________________
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.                                    - Page 18 -
  1296.  
  1297.                    Telegard Main Documentation - Version 2.5
  1298.  
  1299.  
  1300.      Note  that  the  command strings can  contain  the  following  special
  1301.      characters:
  1302.  
  1303.           "|"       Sends a carriage return to the modem.  Note that all
  1304.                     strings are automatically terminated with a carriage
  1305.                     return, so this character is not needed at the end of
  1306.                     the strings.
  1307.  
  1308.           "^x"      Sends a control character to the modem.  The "x" is an
  1309.                     uppercase letter (A-Z), and will correspond to control
  1310.                     codes 1 through 26.
  1311.  
  1312.           "~"       Performs a half-second delay before sending the next
  1313.                     character to the modem.
  1314.  
  1315.      Each menu option is described in detail below.
  1316.  
  1317.           1    This is the baud rate that Telegard will use when waiting
  1318.                for calls at the WFC menu.  This should be set to the
  1319.                modem's maximum baud rate, at either 300, 1200, 2400, 4800,
  1320.                9600, 19200 or 38400 baud.
  1321.  
  1322.           2    This is the COM port that your modem is connected to, which
  1323.                can be COM1 through COM4.
  1324.  
  1325.           3    This is the command that initializes the modem.  This is
  1326.                VERY important, as it tells the modem how to operate under
  1327.                the BBS environment.  If your modem does not respond using
  1328.                the default command, consult the "Modem Information" section
  1329.                for more information (or "play" with the command until you
  1330.                get it just right).
  1331.  
  1332.           4    This is the command that enables the modem to answer an
  1333.                incoming call.
  1334.  
  1335.           5    This is the command that hangs up the modem.
  1336.  
  1337.           6    This is the command that places the modem offhook (when you
  1338.                wish to have SOME access to your computer!).  This has the
  1339.                same effect as taking the receiver off the hook on your
  1340.                telephone.
  1341.  
  1342.           7    This sets the time (in minutes) in which the modem will be
  1343.                reinitialized if no one has called.  Do NOT set this option
  1344.                to zero (0); if you do, the modem will be constantly
  1345.                reinitialized, and will not let anyone call in (nor will it
  1346.                let you regain control of the system until you press the
  1347.                Reset button!).
  1348.  
  1349.           A    This sets the ARQ baud rate used with 9600 baud (or higher)
  1350.                modems.  Consult your modem's manual for more details on the
  1351.                ARQ feature.
  1352.  
  1353.           F    This option sets the forced baud rate used with 9600 baud
  1354.                (or higher) modems.
  1355.  
  1356.  
  1357.  
  1358.                                    - Page 19 -
  1359.  
  1360.                    Telegard Main Documentation - Version 2.5
  1361.  
  1362.  
  1363.           R    These are the result codes returned by the modem when the NO
  1364.                CARRIER, NO DIALTONE, BUSY and various baud rate conditions
  1365.                are encountered.  Case 1 result codes are the main codes
  1366.                returned by the modem.  Case 2 result codes are provided for
  1367.                persons using MNP class modems (such as the USR Courier
  1368.                HST), which are designed to filter more noise and give a
  1369.                better grade connection, in the ARQ mode.
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.                                    - Page 20 -
  1422.  
  1423.                    Telegard Main Documentation - Version 2.5
  1424.  
  1425.  
  1426.      ------------------------------
  1427.      FILE PATHS & BBS CONFIGURATION
  1428.      ------------------------------
  1429.  
  1430.      This area is where many of the various BBS options are configured,  as
  1431.      well  as  the required file paths that the program needs to  find  its
  1432.      files.
  1433.  
  1434.      Upon selecting this option, the following menu is displayed (the  menu
  1435.      has been slightly compressed to fit onto the page):
  1436.      ______________________________________________________________________
  1437.  
  1438.      BBS configuration and file paths
  1439.  
  1440.      A. BBS name & number  :Telegard BBS (000-000-0000)
  1441.      B. SysOp's name/alias :<System Operator>
  1442.      C. SysOp chat hours   :*None*          G. 300 baud hours    :Always...
  1443.      D. Regular DL hours   :Always allowed  H. 300 baud DL hours :Always...
  1444.      E. Shuttle Logon is   :In-active       I. New users are     :Accepted
  1445.      !. LOCKOUT 300 BAUD   :No              J. Snow checking is  :In-active
  1446.      F. BBS Passwords                       K. Pre-event warning :60
  1447.  
  1448.       1. Main data files dir.    :"C:\BBS\GFILES\"
  1449.       2. Alternate text file dir.:"C:\BBS\AFILES\"
  1450.       3. Priv/pub msgs directory :"C:\BBS\MSGS\"
  1451.       4. Menu file directory     :"C:\BBS\MENUS\"
  1452.       5. Text-file section dir.  :"C:\BBS\TFILES\"
  1453.       6. Trap/log/chat directory :"C:\BBS\TRAP\"
  1454.       7. Temporary directory     :"C:\BBS\TEMP\"
  1455.       8. Last text-file edit date:04/21/89
  1456.  
  1457.      Enter selection (A-K,!,1-8) [Q]uit :
  1458.      ______________________________________________________________________
  1459.  
  1460.      Each option is described in detail below.
  1461.  
  1462.           A    This option allows you to enter the name and the phone
  1463.                number of your BBS, which is used as a general string during
  1464.                the logon procedure.  MCI color codes are allowed.
  1465.  
  1466.           B    This option allows you to enter the name or the handle of
  1467.                the SysOp (you!), which is used in various places throughout
  1468.                the program.
  1469.  
  1470.           C    This option allows you to declare your chat hours.  When
  1471.                someone pages you during these hours, a bell will sound to
  1472.                inform you that a user wishes to chat.  Also, during the
  1473.                logon procedure, a message is displayed that indicates the
  1474.                status of the SysOp.  If a user logs on within the chat
  1475.                hours, the SysOp is declared "available to chat", otherwise
  1476.                the SysOp is declared "unavailable to chat".
  1477.  
  1478.                Alternately, you may leave the chat hours as "undefined."
  1479.                This allows the use of a special feature associated with the
  1480.                [Scroll Lock] key.  When [Scroll Lock] is active, the BBS
  1481.                declares that the SysOp is unavailable; when inactive, the
  1482.  
  1483.  
  1484.                                    - Page 21 -
  1485.  
  1486.                    Telegard Main Documentation - Version 2.5
  1487.  
  1488.  
  1489.                BBS declares that the SysOp is available.  This allows you
  1490.                to control the chat status via the keyboard.
  1491.  
  1492.           D    This option defines the hours that file downloading is
  1493.                allowed.  Some SysOps prefer to have certain hours set aside
  1494.                for non-file related activities (posting messages, etc.);
  1495.                this option allows that.  The default is to always allow
  1496.                file downloading.
  1497.  
  1498.           E    This option toggles the status of the shuttle logon.  The
  1499.                shuttle logon provides an extra layer of security for the
  1500.                BBS, which is desired by some SysOps.
  1501.  
  1502.           !    This option allows you to lock out 300 baud users.  Some
  1503.                SysOps do not wish to tie up their systems with users that
  1504.                use slow (and outdated) 300 baud modems.  The default is NO.
  1505.                If this feature is activated, and a 300 baud user tries to
  1506.                log on, the message NO300.* is displayed during the logon
  1507.                procedure and the BBS will hang up.
  1508.  
  1509.           F    This option defines the SysOp, new user and shuttle logon
  1510.                passwords.
  1511.  
  1512.           G    This option defines the hours that 300 baud callers may log
  1513.                on.  Some SysOps prefer to restrict the hours available to
  1514.                users of 300 baud modems.  The default is to always allow
  1515.                300 baud callers.  If these hours are defined, and a 300
  1516.                baud caller tries to log on, the file 300HOURS.* is
  1517.                displayed during the logon procedure and the BBS will hang
  1518.                up.
  1519.  
  1520.                Note that this option is pretty much useless if 300 baud
  1521.                users are locked out (the "!" option).
  1522.  
  1523.           H    This option defines the hours that 300 baud callers may
  1524.                download files.  Again, some SysOps prefer to restrict the
  1525.                activities of user with 300 baud modems (due to their
  1526.                slowness).  The default is to always allow 300 baud callers
  1527.                to download files.
  1528.  
  1529.                Once again, note that this option is useless if 300 baud
  1530.                users have been locked out (with the "!" option).
  1531.  
  1532.           I    This option allows you to accept or lock out new users.  The
  1533.                default is to always accept new users.  If you decide you
  1534.                have enough users, or you wish to run a private board where
  1535.                only certain people are permitted access, you should set
  1536.                this option to lock out new users.
  1537.  
  1538.           J    This option toggles video snow checking.  This option is
  1539.                mainly for systems using a Color Graphics Adapter (CGA),
  1540.                which is susceptible to video "snow" during direct writes to
  1541.                the screen.  (Systems with monochrome adapters, Enhanced
  1542.                Graphics Adapters [EGA] or Video Graphics Array [VGA]
  1543.                adapters usually do not have this problem.)  The default is
  1544.                no snow checking.
  1545.  
  1546.  
  1547.                                    - Page 22 -
  1548.  
  1549.                    Telegard Main Documentation - Version 2.5
  1550.  
  1551.  
  1552.           K    This options sets the number of seconds before a scheduled
  1553.                event is run in which the user is warned.  This gives the
  1554.                user time to finish up and log off.  The default is 60
  1555.                seconds (one minute).
  1556.  
  1557.           1    This option defines the directory in which your main data
  1558.                files are stored.  These include the file directory (*.DIR)
  1559.                and miscellaneous system (*.DAT, *.LST) files.
  1560.  
  1561.           2    This option defines the directory in which your text files
  1562.                are stored.  These files include ANSI (*.ANS), text (*.MSG),
  1563.                and InfoForm question (*.INF) and answer (*.ASW) files.
  1564.  
  1565.           3    This option defines the directory in which your public
  1566.                and private message files (*.BRD, *.MIX, *.TRE) are stored.
  1567.  
  1568.           4    This option defines the directory in which the menu files
  1569.                (*.MNU) are stored.
  1570.  
  1571.           5    This option defines the directory in which the text file
  1572.                system (Tfiles) files are stored.  These files may be viewed
  1573.                by various users, and their contents can cover a wide range
  1574.                of interests and topics.  (See the section on Tfiles for
  1575.                more information on this feature.)
  1576.  
  1577.           6    This option defines the directory in which the trap files
  1578.                (TRAP*.MSG), system log files (SYSOP*.LOG) and capture chat
  1579.                files (CHAT*.MSG) are stored.
  1580.  
  1581.           7    This option defines the directory in which temporary files
  1582.                are stored.  During the course of BBS operation, this
  1583.                directory is used for:  Holding incoming batch uploads until
  1584.                the queue is empty; converting archive files between
  1585.                different formats (ARC, LZH, PAK, ZIP, ZOO, or other user-
  1586.                defined formats); holding files processed using the
  1587.                "(E)xtract to Temp" and "(W)ork on Temp" commands from the
  1588.                File Transfer menu (more on this later); and so on.  It is
  1589.                recommended that this path point to a drive that has plenty
  1590.                of space available (at least 1MB is recommended).
  1591.  
  1592.           8    This option defines the date in which your text files
  1593.                (Tfiles) were last edited and/or updated.
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.                                    - Page 23 -
  1611.  
  1612.                    Telegard Main Documentation - Version 2.5
  1613.  
  1614.  
  1615.      -------------------
  1616.      SYSTEM ACS SETTINGS
  1617.      -------------------
  1618.  
  1619.      These  settings define how many of the features of the BBS will  oper-
  1620.      ate, from posting features to file transfer ratio/file point  checking
  1621.      to Co-SysOp and SysOp access levels.  Each setting is set up using the
  1622.      Access  Condition String (ACS) system (refer to the "The  ACS  System"
  1623.      section for more information).
  1624.  
  1625.      Upon selecting this option, the following menu is displayed (the  menu
  1626.      has been slightly compressed to fit on the page):
  1627.      ______________________________________________________________________
  1628.  
  1629.      System ACS settings:
  1630.  
  1631.      A. Full SysOp              :"s255"  B. Full Co-SysOp           :"s250"
  1632.      C. Message base SySop      :"s199"  D. File base SysOp         :"s230"
  1633.      E. SysOp Password at logon :"s250"  F. See passwords remotely  :"s255"
  1634.      G. Post normal public mail :"s11"   H. Send normal private mail:"s11"
  1635.      I. See who posted anon     :"s100"  J. See who Emailed anon    :"s100"
  1636.      K. Post on ANY base anon   :"s100"  L. Email anon              :"s100"
  1637.      M. See unvalidated files   :"s50"   N. DL unvalidated files    :"s230"
  1638.      O. No UL/DL ratio checking :"s255"  P. No post/call ratio check:"s200"
  1639.      R. No file point checking  :"s255"  S. ULs auto-credited       :"s21"
  1640.  
  1641.      Enter selection (A-S) [Q]uit :
  1642.      ______________________________________________________________________
  1643.  
  1644.      Each option is described in detail below.
  1645.  
  1646.           A    This setting defines the security level for a full SysOp.
  1647.  
  1648.           B    This setting defines the security level for a full Co-SysOp.
  1649.  
  1650.           C    This setting defines the security level for a message base
  1651.                SysOp.
  1652.  
  1653.           D    This setting defines the security level for a file base
  1654.                SysOp.
  1655.  
  1656.           E    This setting defines the security level in which the SysOp
  1657.                password must be specified during the logon process.
  1658.  
  1659.           F    This setting defines the security level in which a user can
  1660.                view passwords remotely.
  1661.  
  1662.           G    This setting defines the security level required to post
  1663.                normal public mail.
  1664.  
  1665.           H    This setting is similar to option G, except that it pertains
  1666.                to normal Email.
  1667.  
  1668.           I    This setting defines the security level that allows a user
  1669.                to see who posted public messages anonymously.
  1670.  
  1671.  
  1672.  
  1673.                                    - Page 24 -
  1674.  
  1675.                    Telegard Main Documentation - Version 2.5
  1676.  
  1677.  
  1678.           J    This setting defines the security level that allows a user
  1679.                to see who posted Email anonymously.
  1680.  
  1681.           K    This setting defines the security level that allows a user
  1682.                to post anonymously on ANY message base, regardless of the
  1683.                settings of the anonymous flags for the message bases.
  1684.  
  1685.           L    This setting is similar to option K, except that it pertains
  1686.                to Email.
  1687.  
  1688.           M    This setting defines the security level that allows a user
  1689.                to see unvalidated files when listing the files in the file
  1690.                bases.
  1691.  
  1692.           N    This setting defines the security level that allows a user
  1693.                to download unvalidated files.
  1694.  
  1695.           O    This setting defines the security level at which upload/
  1696.                download ratio checking is suppressed.
  1697.  
  1698.           P    This setting defines the security level at which the post/
  1699.                call ratio check is suppressed.
  1700.  
  1701.           R    This setting defines the security level at which file point
  1702.                checking is suppressed.
  1703.  
  1704.           S    This setting defines the security level at which uploaded
  1705.                files are automatically credited to the uploader.  (Setting
  1706.                the security level to a value higher than that for normal
  1707.                users will prevent uploading of "garbage" in order to
  1708.                balance an UL/DL ratio for further downloading, thereby
  1709.                preventing "leeching" of the file sections.)
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.                                    - Page 25 -
  1737.  
  1738.                    Telegard Main Documentation - Version 2.5
  1739.  
  1740.  
  1741.      -----------------
  1742.      GENERAL VARIABLES
  1743.      -----------------
  1744.  
  1745.      This  section controls various numeric values and limits for the  BBS,
  1746.      such  as  the  maximum number of lines per message,  number  of  logon
  1747.      attempts,  and  the  number of minutes of inactivity  before  the  WFC
  1748.      screen is blanked.
  1749.  
  1750.      Upon selecting this option, the following menu is displayed:
  1751.      ______________________________________________________________________
  1752.  
  1753.      General variables:
  1754.  
  1755.      A. Max private sent per call:20      B. Max feedback sent per call:5
  1756.      C. Max public posts per call:20      D. Max chat attempts per call:3
  1757.      E. Normal max mail waiting  :15      F. CoSysOp max mail waiting  :50
  1758.      G. Normal max lines/message :120     H. CoSysOp max lines/message :160
  1759.      I. Number of logon attempts :4       J. Backspace delay           :20
  1760.      K. SysOp chat color         :4       L. User chat color           :3
  1761.      M. Min space for posts      :10      N. Min space for uploads     :100
  1762.      O. Back SysOp Log keep days :7       P. Blank WFC menu minutes    :0
  1763.      R. Default video page width :80      S. Default video page length :25
  1764.  
  1765.      Enter selection (A-S) [Q]uit :
  1766.      ______________________________________________________________________
  1767.  
  1768.      Each option is described in detail below.
  1769.  
  1770.           A    This option sets the limit for the amount of Email that
  1771.                any single caller can leave during a visit (as it can be
  1772.                distracting AND FRUSTRATING when some guy finds the need to
  1773.                mass mail every caller three times a week!).
  1774.  
  1775.           B    This option sets the limit for the number of feedback
  1776.                messages that any single caller can send during a visit.
  1777.                This option should usually be kept low, the reason being
  1778.                that feedback comes to YOU, the SysOp, and if you have 40
  1779.                callers a day, and every one leaves 20 messages to you, soon
  1780.                you no longer have any room on your hard drive!
  1781.  
  1782.           C    This option sets the limit for the number of public messages
  1783.                that any single caller can send during a visit.  This option
  1784.                is RARELY exceeded (unfortunately!).
  1785.  
  1786.           D    This option sets the limit for the number of chat attempts
  1787.                that any single caller can make during a visit.  Again, this
  1788.                number is usually kept rather low, as a SysOp has a life
  1789.                besides the BBS (usually!), and some callers constantly page
  1790.                for chat when he has other things that need to be done.
  1791.  
  1792.           E    This option sets the limit for the amount of Email that can
  1793.                be kept waiting for a given caller.  It keeps a limit so
  1794.                that people are ENCOURAGED to discard old Email to save disk
  1795.                space.
  1796.  
  1797.  
  1798.  
  1799.                                    - Page 26 -
  1800.  
  1801.                    Telegard Main Documentation - Version 2.5
  1802.  
  1803.  
  1804.           F    This option sets the limit for the amount of Email that can
  1805.                be kept waiting for a Co-SysOp.  This number should be
  1806.                relatively high compared to that of an average user, as a
  1807.                remote has duties that may include file requests, system
  1808.                questions and new user validations.
  1809.  
  1810.           G    This option sets the limit for the number of lines allowed
  1811.                in any given message for a normal user.
  1812.  
  1813.           H    This option sets the limit for the number of lines allowed
  1814.                in any given message for the Co-SysOp.  Again, a Co-SysOp
  1815.                deserves more as, though most questions are short, some may
  1816.                go into VERY lengthy explanations and replies.
  1817.  
  1818.           I    This option sets the limit for the number of attempts a user
  1819.                can make to log on to the BBS, before the system automatic-
  1820.                ally hangs up on the caller.
  1821.  
  1822.           J    This option sets the delay value between the time the system
  1823.                erases the "Saving message..." string and prints the
  1824.                "Message posted on..." string when posting a message.
  1825.                Setting this option to zero (0) eliminates the delay
  1826.                completely.
  1827.  
  1828.           K    This option sets the SysOp chat color, which can be 0 to 9
  1829.                (corresponding to the Telegard MCI colors, explained later).
  1830.                For those users that can view ANSI colors, this color is
  1831.                used while the SysOp is typing.  Note that if a SysOp chat
  1832.                color filter is defined (more on this later), this setting
  1833.                is ignored.
  1834.  
  1835.           L    This is analogous to option K, except that it pertains to
  1836.                the user chat color.  (The reason for different chat colors
  1837.                for the SysOp and the user is primarily for visual ease and
  1838.                differentiation of the conversation.)  Same rules and
  1839.                restrictions apply.
  1840.  
  1841.           M    This option sets the minimum amount of hard drive space (in
  1842.                kilobytes, or K) that MUST be available in order to post a
  1843.                public message or Email.  It is designed as a safeguard, as
  1844.                problems can result if there is not enough space available
  1845.                (result can be a runtime error and/or a locked-up system).
  1846.  
  1847.           N    This is analogous to option M, except that it specifies the
  1848.                minimum amount of hard drive space (again, in kilobytes)
  1849.                that MUST be available to upload a file.  This is another
  1850.                safeguard so people can't fill up the drive.
  1851.  
  1852.           O    This option sets the number of days that the SysOp back logs
  1853.                are kept.  The maximum is 15, so that the SysOp has a
  1854.                running record of up to approximately two weeks to review
  1855.                BBS activity.
  1856.  
  1857.           P    This option sets the number of minutes of inactivity before
  1858.                the WFC screen is blanked.  This is provided as a safeguard
  1859.                against "burning in" the image of the WFC screen onto the
  1860.  
  1861.  
  1862.                                    - Page 27 -
  1863.  
  1864.                    Telegard Main Documentation - Version 2.5
  1865.  
  1866.  
  1867.                phosphor of the CRT.  (Pressing the [Enter] key will
  1868.                redisplay the WFC screen.)  Setting this option to zero (0)
  1869.                will disable the blanking feature.
  1870.  
  1871.           R    This option defines the default number of video columns set
  1872.                for the user during the new user logon process.
  1873.  
  1874.           S    This option defines the default number of video rows set for
  1875.                the user during the new user logon process.
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.                                    - Page 28 -
  1926.  
  1927.                    Telegard Main Documentation - Version 2.5
  1928.  
  1929.  
  1930.      -------------------------
  1931.      GENERAL FLAGGED FUNCTIONS
  1932.      -------------------------
  1933.  
  1934.      These options control various functions of the BBS, from clearing  the
  1935.      screen  before displaying messages to allowing handles to  controlling
  1936.      various actions during the logon procedure.
  1937.  
  1938.      Upon selection this option, the following menu is displayed:
  1939.      ______________________________________________________________________
  1940.  
  1941.      General flagged functions:
  1942.  
  1943.      A. Special effects          :On      B. Use FOSSIL comm driver    :Off
  1944.      C. Handles allowed on system:On      D. Phone number in logon     :On
  1945.      E. Local security protection:Off     F. Local screen security     :Off
  1946.      G. Global activity trapping :Off     H. Auto chat buffer open     :On
  1947.      I. AutoMessage in logon     :On      J. Bulletins in logon        :On
  1948.      K. Last few callers in logon:On      L. "Your Info" in logon      :On
  1949.      M. BBS is multi-tasking     :Off     N. Offhook in local logon    :On
  1950.      O. Mandatory voting         :Off     P. Compress file/msg numbers :Off
  1951.      R. UL duplicate file search :Off     S. SysOp Log type      :File Only
  1952.      T. Strip color off SysOp log:Off     U. Use WFC menu logo         :On
  1953.      V. Use BIOS for video output:On      W. Suppress snow on CGA      :Off
  1954.      X. Use EMS for overlay file :Off
  1955.  
  1956.      1. New user message sent to :1       2. Guest user number         :Off
  1957.      3. Mins before timeout bell :2       4. Mins before timeout       :5
  1958.  
  1959.      Enter selection (A-X,1-4) [Q]uit :
  1960.      ______________________________________________________________________
  1961.  
  1962.      Each option is described in detail below.
  1963.  
  1964.           A    This option controls the "special effects" feature of the
  1965.                WFC screen (the rotating colors in the "TELEGARD" logo).
  1966.  
  1967.           B    This option specifies whether or not to use a FOSSIL
  1968.                communications driver instead of the built-in communications
  1969.                routines.  (Refer to the "Modem Information" section for
  1970.                more details about FOSSIL drivers.)  If this option is
  1971.                enabled, and Telegard does not detect a FOSSIL driver, the
  1972.                built-in communications routines will be used.
  1973.  
  1974.           C    This option specifies whether or not handles are allowed on
  1975.                the system.  Having this option active enables users to be
  1976.                expressed by a pseudonym or alias (their real name is asked
  1977.                for during the new user logon process).  Disabling this
  1978.                option allows only the user's real name to be used
  1979.                (primarily for businesses and SysOps who wish callers to use
  1980.                their real names).
  1981.  
  1982.           D    This option specifies whether or not the user's phone number
  1983.                is asked for during the logon process.  This acts as an
  1984.                extra security feature just in case someone has illegally
  1985.                acquired someone else's password.
  1986.  
  1987.  
  1988.                                    - Page 29 -
  1989.  
  1990.                    Telegard Main Documentation - Version 2.5
  1991.  
  1992.  
  1993.           E    This option controls local security protection.  When set
  1994.                to ON, it prevents the SysOp (and anyone else that may be
  1995.                present) from seeing the caller type his password and phone
  1996.                number (if active).  Good for "friends" that visit you and
  1997.                may try something stupid.
  1998.  
  1999.           F    This option controls local screen security.  When set to
  2000.                ON, the SysOp will see a "Baud = nnnnn" message in the upper
  2001.                left hand corner of the screen as usual.  However, that is
  2002.                ALL that will remain, in addition to the status line... in
  2003.                effect, you CANNOT see what is going on at ALL.
  2004.  
  2005.           G    This option controls global activity trapping.  If set to
  2006.                ON, the BBS will make a trap file for EVERY caller (in the
  2007.                form of TRAP*.MSG).  This is useful in the event of numerous
  2008.                system errors, runtime errors or BBS crashes, in order to
  2009.                find a solution to the problem.
  2010.  
  2011.           H    This option specifies whether or not to automatically open
  2012.                the chat buffer.  If set to ON, the chat is automatically
  2013.                recorded in the CHAT*.MSG file when the SysOp initiates
  2014.                chat, without having to press the [Home] key first.
  2015.  
  2016.           I    This option specifies whether or not the auto-message is
  2017.                displayed during the logon process.  Enables you to make the
  2018.                auto-message totally optional or mandatorily viewed by all
  2019.                callers.
  2020.  
  2021.           J    This option specifies whether or not the bulletin menu is
  2022.                presented during the logon process, enabling the SysOp to
  2023.                display dated bulletins that are of special interest to
  2024.                callers, such as BBS lists, online game scores, file request
  2025.                lists, and so on.
  2026.  
  2027.           K    This option specifies whether or not the last few callers
  2028.                are displayed during the logon process.  If set to ON, the
  2029.                last few callers will be displayed right after the
  2030.                automessage (if present).
  2031.  
  2032.           L    This option specifies whether or not the user's individual
  2033.                statistics are shown during the logon process.  This feature
  2034.                was left over from early versions of Telegard, and has been
  2035.                made optional by request of various SysOps and users that
  2036.                did not appreciate it being automatically displayed.
  2037.  
  2038.           M    This option specifies whether or not the BBS is running
  2039.                under a multi-tasking environment.  (This feature has not
  2040.                yet been implemented.)
  2041.  
  2042.           N    This option specifies whether or not the phone should be
  2043.                taken off-hook during local logon, so that the SysOp can use
  2044.                the BBS without worrying about a user trying to log on.
  2045.  
  2046.           O    This option specifies whether or not to force all users to
  2047.                vote on all unanswered voting questions before they may
  2048.                enter the BBS.
  2049.  
  2050.  
  2051.                                    - Page 30 -
  2052.  
  2053.                    Telegard Main Documentation - Version 2.5
  2054.  
  2055.  
  2056.           P    This option controls the "compression" of file and message
  2057.                base numbers.  This feature takes a little explaining, so an
  2058.                example is in order:
  2059.  
  2060.                Say that you have defined ten message bases (1-10), and that
  2061.                bases 5, 7 and 8 are restricted from certain users.  Now,
  2062.                normally, when the list of message areas is displayed, those
  2063.                areas will not be shown, leaving a gap in the message base
  2064.                numbers (1, 2, 3, 4, 6, 9, 10).  If this option is set to
  2065.                ON, all the message base numbers are made contiguous (1, 2,
  2066.                3, 4, 5, 6, 7) to the user.  THIS, HOWEVER, DOES NOT CHANGE
  2067.                THE PHYSICAL BASE NUMBERS!  This feature takes some getting
  2068.                used to, so you should experiment with it to make yourself
  2069.                more familiar with it.
  2070.  
  2071.           R    This option controls the search for duplicate files during
  2072.                the uploading process.  If set to ON, the BBS will search
  2073.                the file directories for the same file that the user is
  2074.                attempting to upload.  The BBS will also perform "partial"
  2075.                searches (if the same file is uploaded with a different
  2076.                extension, i.e. "FILE.ZIP" already exists and the user tries
  2077.                to upload "FILE.ARC").  In this case, if the preexisting
  2078.                file is in a base accessible to the user, the user will be
  2079.                asked if the upload is still wanted.  If the preexisting
  2080.                file is in a base that the user does NOT have access to, the
  2081.                upload will be rejected outright.
  2082.  
  2083.           S    This option controls the operation of the SysOp log.  When
  2084.                this option is selected, you can choose one of three types:
  2085.  
  2086.                     File only -- Saves the day's events in the SYSOPxx.LOG
  2087.                          file in the TRAP directory.
  2088.  
  2089.                     Printer & file -- Saves the data in the SYSOPxx.LOG
  2090.                          file and spools the output to the printer
  2091.                          throughout the day as activity continues.
  2092.  
  2093.                     Printer only -- Spools the information only to the
  2094.                          printer, providing a hardcopy record, but no file
  2095.                          record, of daily activity.
  2096.  
  2097.           T    This option specifies whether or not Telegard's MCI color
  2098.                codes will be stripped from the SysOp log.  If set to ON,
  2099.                the color codes are stripped (leaving pure ASCII text).
  2100.  
  2101.           U    This option specifies whether or not the "TELEGARD" logo is
  2102.                displayed at the WFC menu.  If set to OFF, a full-screen WFC
  2103.                screen can be created (it releases an extra five lines at
  2104.                the top of the screen for use).
  2105.  
  2106.           V    This option specifies whether or not ROM BIOS routines are
  2107.                to be used for all local screen output.  If disabled, screen
  2108.                output is written directly to video memory.  Enabling this
  2109.                option is useful on systems that aren't 100% compatible with
  2110.                the IBM PC standard (for instance, the Tandy 2000).
  2111.  
  2112.  
  2113.  
  2114.                                    - Page 31 -
  2115.  
  2116.                    Telegard Main Documentation - Version 2.5
  2117.  
  2118.  
  2119.           W    This option specifies whether or not "snow checking" is
  2120.                required for Color Graphics Adapters (CGAs).  On most CGAs,
  2121.                interference will result if characters are stored in video
  2122.                memory outside the horizontal retrace intervals, resulting
  2123.                in "snow" (this does not occur with Monochrome Display
  2124.                Adapters [MDAs], Enhanced Graphics Adapters [EGAs], or Video
  2125.                Graphics Array adapters [VGAs]).  Enabling this option will
  2126.                make all screen writes occur only during the horizontal
  2127.                retrace intervals.  (This option has no effect if option V
  2128.                is enabled to select BIOS output.)
  2129.  
  2130.           X    This option specifies whether or not the BBS.OVR file is to
  2131.                be stored in, and accessed from, EMS (expanded) memory.  If
  2132.                the overlay can't be stored in EMS (no EMS present, not
  2133.                enough EMS RAM available, etc.), Telegard will access the
  2134.                overlay from disk as usual.  NOTE:  Any changes to this
  2135.                option require that Telegard be exited and restarted for
  2136.                the change to take effect.  Also, you will need enough EMS
  2137.                memory to hold the entire overlay file in order for this
  2138.                feature to work.
  2139.  
  2140.           1    This option defines the number of the user that will receive
  2141.                "new user" messages.  The default is user 1 (the SysOp), but
  2142.                can be changed if you have another user who handles the
  2143.                validation of new users.
  2144.  
  2145.           2    This option specifies whether or not a "guest user"
  2146.                account is to be used.  If toggled on, a generic account
  2147.                with low access is created called "GUEST", so that new
  2148.                callers have the option of investigating the BBS before
  2149.                deciding to join as an active user.  The default password is
  2150.                "GUEST" (which can be changed in the "BBS Configuration and
  2151.                File Paths" section) and the default phone number is "0000".
  2152.  
  2153.           3    This option specifies the number of minutes before a bell
  2154.                is sounded to alert the user that the system is about to
  2155.                "time out" and hang up.  Handy for users who fall asleep at
  2156.                the keyboard!
  2157.  
  2158.           4    This option specifies the number of minutes that are allowed
  2159.                to pass with no activity before the system "times out" and
  2160.                hangs up.  This value should, obviously, be set higher than
  2161.                the "time out bell" value in option 3!
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.                                    - Page 32 -
  2178.  
  2179.                    Telegard Main Documentation - Version 2.5
  2180.  
  2181.  
  2182.      --------------------------
  2183.      FILE SECTION CONFIGURATION
  2184.      --------------------------
  2185.  
  2186.      File  Section  Configuration  allows you to  control  various  options
  2187.      associated with the file transfer section.  In addition, it allows the
  2188.      definition and maintenance of Telegard's built-in archive manipulation
  2189.      settings, one of the system's most powerful features!
  2190.  
  2191.      Upon selecting this option, the following menu is displayed:
  2192.      ______________________________________________________________________
  2193.  
  2194.      File section configuration
  2195.  
  2196.      A. Archive configuration
  2197.      B. Upload/download ratio           :Active
  2198.      C. Auto file point compensation    :In-active
  2199.      D. File point compensation ratio   :3 to 1
  2200.      E. Base file size per 1 file point :10k
  2201.      F. Upload time refund percent      :100%
  2202.      G. "To-SysOp" file base            :0
  2203.      H. Auto-validate ALL files ULed?   :No
  2204.      I. Remote DOS re-direction device  :COM1
  2205.      J. Max k-bytes allowed in TEMP\3\  :500
  2206.      K. Min k-bytes to save for resume  :100
  2207.  
  2208.      Enter selection (A-K) [Q]uit :
  2209.      ______________________________________________________________________
  2210.  
  2211.      Each option is described in detail below.
  2212.  
  2213.           A    This option takes you into the archive configuration
  2214.                section, which will be discussed in the latter part of this
  2215.                section.
  2216.  
  2217.           B    This option specifies whether or not upload/download ratio
  2218.                checking is active.  If active, a user must have uploaded X
  2219.                amount (in kilobytes) of files in order to download a file.
  2220.  
  2221.           C    This option specifies whether or not automatic file point
  2222.                compensation is active.  If active, files are automatically
  2223.                given X amounts of points per X amount of kilobytes
  2224.                uploaded, as determined by the setting of option D.
  2225.  
  2226.           D    This option works in conjunction with option C, and defines
  2227.                how many points a user is entitled to download in files,
  2228.                divided by the number of points uploaded (works similar to
  2229.                the upload/download ratio system).
  2230.  
  2231.           E    This option also works in conjunction with option C, and
  2232.                defines how many file points should be rewarded for a given
  2233.                upload, based on the number of kilobytes in the given
  2234.                upload.
  2235.  
  2236.           F    This option defines the percentage of time that a user is
  2237.                refunded after uploading a file.  It calculates an amount of
  2238.  
  2239.  
  2240.                                    - Page 33 -
  2241.  
  2242.                    Telegard Main Documentation - Version 2.5
  2243.  
  2244.  
  2245.                time in hours, minutes and sections, that a user is to have
  2246.                restored to their remaining time online after the upload, as
  2247.                a token from the SysOp.  The default is 100%, or the same
  2248.                amount of time lost uploading the file.  Raising the value
  2249.                will award more time, lowering the value will restore less
  2250.                time.
  2251.  
  2252.                Note that if an event is scheduled during the user's time
  2253.                online, the amount of time is NOT refunded to the user until
  2254.                after the event has taken place (when they next log on).
  2255.  
  2256.           G    This option defines the file base that is designated as
  2257.                "SysOp only".  This is for SysOp-only uploads, performed in
  2258.                the file transfer area by preceding the uploaded file's
  2259.                description with a backslash ("\").  The default is area 0.
  2260.                It is recommended that you set aside area 0 for SysOp-only
  2261.                uploads, because if you define another file area as such,
  2262.                and change this option to point to it, then add or delete
  2263.                other file areas before it, you will have to constantly
  2264.                change this option.
  2265.  
  2266.           H    This option specifies whether or not all uploaded files are
  2267.                to be auto-validated.  This option defaults to NO, which is
  2268.                preferred by many SysOps (that way, they can view the file
  2269.                and determine its worth, and also check it for possible
  2270.                viruses that may cause unwanted anguish to a user or a
  2271.                fellow SysOp).
  2272.  
  2273.           I    This option defines the remote DOS re-direction device.
  2274.                Normally, activity in DOS is tailored for the local user,
  2275.                and a remote who may need to edit a batch file, etc., would
  2276.                have a hardship in doing so.  Thus, a re-direction device
  2277.                will show DOS activity through the CTTY device using the re-
  2278.                direction device.
  2279.  
  2280.                Got all that?  No?  Here's the short version:  It allows
  2281.                both the local and remote users to see what's going on when
  2282.                the remote user has shelled to DOS, as long as a device
  2283.                driver that redirects video output has been installed using
  2284.                CONFIG.SYS.
  2285.  
  2286.                (An excellent driver for this purpose is GATEWAY2.SYS, which
  2287.                is installed using CONFIG.SYS, and can be configured for use
  2288.                with COM1 [GATE1] or COM2 [GATE2].  GATEWAY2.SYS should be
  2289.                available from any local system as GATEWAY2.ZIP; if not, it
  2290.                is available from the Telegard Alpha sites.)
  2291.  
  2292.           J    This option defines the maximum number of kilobytes allowed
  2293.                in the temporary archive working directory.
  2294.  
  2295.           K    This option defines the minimum number of kilobytes that
  2296.                must have been sent during an upload before it can be saved
  2297.                for a resume-later upload operation, in the event that the
  2298.                upload is aborted.
  2299.  
  2300.  
  2301.  
  2302.  
  2303.                                    - Page 34 -
  2304.  
  2305.                    Telegard Main Documentation - Version 2.5
  2306.  
  2307.  
  2308.      ARCHIVE CONFIGURATION
  2309.  
  2310.      As  described  above,  option  A  will  take  you  into  the   archive
  2311.      configuration  section.   This  section defines  the  various  archive
  2312.      formats   supported  by  Telegard's  internal   archive   manipulation
  2313.      functions.   These functions will, among other  things,  automatically
  2314.      convert  uploaded  files  from  one archive  format  to  another  (for
  2315.      example,  convert to ZIP format all archives uploaded in ARC  format).
  2316.      It  is a feature that, until now, has not existed on any BBS  software
  2317.      package!  (See the "File Base Editor" section for more information  on
  2318.      this feature.)
  2319.  
  2320.      Upon selection, the following menu is displayed:
  2321.      ______________________________________________________________________
  2322.  
  2323.      Archive configuration edit
  2324.  
  2325.      1. Archive comment: Telegard BBS  000-000-0000
  2326.      2. Archive comment: *None*
  2327.      3. Archive comment: *None*
  2328.  
  2329.       NN:Ext:Compression cmdline     :Decompression cmdline :Success Code
  2330.       ==:===:========================:======================:============
  2331.      +1  ZIP PKZIP -aex @F @I         PKUNZIP @F @I           0
  2332.      -2  ARC PKPAK a @F @I            PKUNPAK @F @I           0
  2333.      -3  ZOO ZOO aP: @F @I            ZOO x @F @I             0
  2334.      -4  PAK PAK a @F @I              PAK e @F @I             -1 (ignores)
  2335.      -5  LZH LHARC A @F @I            LHARC X @F @I           0
  2336.  
  2337.      Archive edit (Q,?=help) :
  2338.      ______________________________________________________________________
  2339.  
  2340.      Pressing "?" will display the functions allowed at this menu:
  2341.  
  2342.           <CR>Redisplay screen
  2343.           1-3:Archive comments
  2344.           (I)nsert archive  (D)elete archive
  2345.           (M)odify archives (Q)uit and save
  2346.  
  2347.      Each option is described below:
  2348.  
  2349.           1-3:Archive comments -- Allows the definition of up to three
  2350.                different archive comments, which can be added to archive
  2351.                files automatically after they have been uploaded.  Note
  2352.                that not all archive formats support archive comments.
  2353.  
  2354.           (I)nsert archive -- Creates a new entry in the archive format
  2355.                table.
  2356.  
  2357.           (D)elete archive -- Remove an entry from the archive format
  2358.                table.
  2359.  
  2360.           (M)odify archives -- Allows modification of the archive format
  2361.                table entries (more on that later).
  2362.  
  2363.           (Q)uit and save -- Saves the table and returns to the File
  2364.  
  2365.  
  2366.                                    - Page 35 -
  2367.  
  2368.                    Telegard Main Documentation - Version 2.5
  2369.  
  2370.  
  2371.                Section Configuration menu.
  2372.  
  2373.      When  you select the (M)odify command, you will be asked which  format
  2374.      you  wish  to modify.  After you select one, the following  screen  is
  2375.      displayed (the ZIP format is used as an example):
  2376.      ______________________________________________________________________
  2377.  
  2378.      Archive #1 of 5
  2379.  
  2380.      1. Active                 : Yes
  2381.      2. Extension name         : ZIP
  2382.      3. Interior list method   : "/1" - *Internal* ZIP viewer
  2383.      4. Compression cmdline    : PKZIP -aex @F @I
  2384.      5. Decompression cmdline  : PKUNZIP @F @I
  2385.      6. Integrity check cmdline: PKUNZIP -t @F
  2386.      7. Add comment cmdline    : PKZIP -z @F
  2387.      8. Errorlevel for success : 0
  2388.      Q. Quit
  2389.  
  2390.      Edit menu: (1-8,[,],Q) :
  2391.      ______________________________________________________________________
  2392.  
  2393.      The  "["  and "]" keys will allow you to move back and  forth  between
  2394.      each entry in the archive format table.  Options 1-8 are described  in
  2395.      detail   below.   Pressing  "Q"  will  return  you  to   the   Archive
  2396.      Configuration Edit screen.
  2397.  
  2398.           1    This option specifies whether or not the archive format is
  2399.                active.  If inactive, then Telegard will not allow any
  2400.                operation on archive files in this format, such as integrity
  2401.                checking or viewing its contents (the uploading of such
  2402.                files, however, will not be impaired).
  2403.  
  2404.           2    This option specifies the extension used for files saved in
  2405.                the particular archive format.  For example, "ZIP" is used
  2406.                as an extension for archive files created by the PKZIP
  2407.                archiving program.  In common usage, the file extension
  2408.                usually describes the archive format itself (ZIP format, ARC
  2409.                format, ZOO format, etc.).
  2410.  
  2411.           3    This option defines the method used to view the contents of
  2412.                archive files in the particular format.  The following
  2413.                entries are allowed:
  2414.  
  2415.                     /1 - Uses the internal ZIP file viewer
  2416.                     /2 - Uses the internal ARC/PAK file viewer
  2417.                     /3 - Uses the internal ZOO file viewer
  2418.                     /4 - Uses the internal LZH file viewer
  2419.  
  2420.                If you have defined an archive format that is not supported
  2421.                internally, you may use this option to define the command
  2422.                line required to view the archive's contents, using the
  2423.                actual archiving program itself (which usually provides a
  2424.                method of viewing the contents of archives it creates).  The
  2425.                archiving program must reside somewhere in your DOS PATH in
  2426.                order for this feature to work.
  2427.  
  2428.  
  2429.                                    - Page 36 -
  2430.  
  2431.                    Telegard Main Documentation - Version 2.5
  2432.  
  2433.  
  2434.                When defining the command line, substitute the "@F" MCI
  2435.                where the actual archive filename  would normally be placed.
  2436.                Telegard will automatically replace the MCI with the
  2437.                intended filename.
  2438.  
  2439.           4    This option defines the command line used to create or
  2440.                update an archive file using this format, using the actual
  2441.                archiving program itself.  The archiving program must reside
  2442.                somewhere in your DOS PATH in order for this feature to
  2443.                work.
  2444.  
  2445.                When defining the command line, substitute the "@F" and "@I"
  2446.                MCIs where the actual archive filename and file to be
  2447.                archived, respectively, would normally be placed.  Telegard
  2448.                will automatically replace the MCIs with the proper
  2449.                information.  Consult the documentation for the particular
  2450.                archiving program for the command line options required to
  2451.                create or update an archive file.
  2452.  
  2453.           5    This option is similar to option 4, except that it defines
  2454.                the command line used to extract files from an archive file.
  2455.                All rules and restrictions mentioned above also apply.
  2456.  
  2457.           6    This option is also  similar to  option 4, except that it
  2458.                defines the command line used to check the integrity of an
  2459.                archive file.  All rules and restrictions mentioned above
  2460.                also apply (except that the "@I" MCI will more than likely
  2461.                not be needed).  If the archiving program does not support
  2462.                integrity testing, this option can be set to NULL (in which
  2463.                case the BBS will not check the integrity of the archive
  2464.                file after it has been uploaded).
  2465.  
  2466.           7    This option is also similar to option 4, except that it
  2467.                defines the command line used to add a comment to an archive
  2468.                file.  All rules and restrictions mentioned above also apply
  2469.                (except that, as in option 6, the "@I" MCI will more than
  2470.                likely not be needed).  If the archiving program and/or
  2471.                archive format does not support archive comments, this
  2472.                option should be set to NULL.
  2473.  
  2474.           8    This option defines the ERRORLEVEL value that the archiving
  2475.                program returns when an operation has been successfully
  2476.                completed.  Most archiving programs return an ERRORLEVEL of
  2477.                0 in this case.  However, some do not return an ERRORLEVEL
  2478.                value at all.  In situations like these, setting this option
  2479.                to "-1" will ignore any value returned from the program, and
  2480.                assume that all operations were successful.
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.                                    - Page 37 -
  2493.  
  2494.                    Telegard Main Documentation - Version 2.5
  2495.  
  2496.  
  2497.      -----------------------------------
  2498.      NEW USER & AUTO-VALIDATION SETTINGS
  2499.      -----------------------------------
  2500.  
  2501.      This  section  defines the security levels and flags  given  to  users
  2502.      before and after they have been validated.
  2503.  
  2504.      Upon selecting this option, the following screen is displayed:
  2505.      ______________________________________________________________________
  2506.  
  2507.      New user configuration             Auto-validation command
  2508.  
  2509.      A. SL :20                          F. SL :50
  2510.      B. DSL:20                          G. DSL:50
  2511.      C. AR :--------------------------  H. AR :--------------------------
  2512.      D. AC :-----*--K-/----             I. AC :----------/----
  2513.      E. #FP:0
  2514.  
  2515.      Enter selection (A-I) [Q]uit :
  2516.      ______________________________________________________________________
  2517.  
  2518.      Each option is described in detail below.
  2519.  
  2520.           A    This option defines the security level (SL) of a new user,
  2521.                which is the status they are trusted with as user and is
  2522.                usually periodically upgraded as the individual proves
  2523.                himself worthy of higher access.  This is the beginning
  2524.                access level on your BBS, before a user is validated.
  2525.  
  2526.           B    This option defines the download security level (DSL) of a
  2527.                new user.  The DSL is analogous to the SL, except that it is
  2528.                used primarily in the file transfer section.
  2529.  
  2530.           C    This option defines the area flags (AR flags) for a new
  2531.                user.  Telegard currently has 26 AR flags, which correspond
  2532.                to the letters of the alphabet (A-Z).  They are used for
  2533.                special accesses, like special interest groups (SIGs), high
  2534.                security file bases, text file areas, etc.  For the most
  2535.                part, a new users should not have ANY access to these
  2536.                features until you have reviewed their information and
  2537.                validation letter to determine what their interests are.
  2538.                When used in conjunction with the ACS system, AR flags can
  2539.                create a powerful security and special-interest system.
  2540.  
  2541.           D    This option defines the access flags (AC flags) for a new
  2542.                user.  AC flags are rather generic in nature, and not
  2543.                configurable like the AR flags.  They are designed for both
  2544.                "problem users" and "special users".  As a SysOp, from time
  2545.                to time you will run into persons who abuse features of the
  2546.                system, and without lowering their access level, AC flags
  2547.                are the GREAT denominator.  The possible flags available at
  2548.                any given time are as follows:
  2549.  
  2550.                     LCVBA*PEKM/1234
  2551.  
  2552.                However, no user will have all of these, as the first subset
  2553.  
  2554.  
  2555.                                    - Page 38 -
  2556.  
  2557.                    Telegard Main Documentation - Version 2.5
  2558.  
  2559.  
  2560.                consists of "penalty" flags, whereas the second subset
  2561.                consists of "reward" flags.  Each flag is defined as
  2562.                follows:
  2563.  
  2564.                L    Can logon ONLY once/day -- Does not allow a given
  2565.                          caller to have more than one BBS logon in a given
  2566.                          day.  Used for callers who tie up your BBS all day
  2567.                          and don't allow other callers a fair opportunity
  2568.                          for system time.
  2569.  
  2570.                C    Can't page SysOp -- Does not allow the caller to use
  2571.                          the CHAT commands throughout the BBS.  Some
  2572.                          callers choose to constantly page the SysOp for
  2573.                          rather unimportant reasons; they become extremely
  2574.                          annoying, as well as extremely time consuming!
  2575.  
  2576.                V    Posts marked unvalidated -- Marks all public messages
  2577.                          as "unvalidated" until the SysOp decides to
  2578.                          either validate or delete them.  Used for callers
  2579.                          who leave abusive or off-topic messages, despite
  2580.                          repeated warnings to the contrary.
  2581.  
  2582.                B    Back/downspacing restricted -- Back/downspacing is a
  2583.                          Telegard MCI subset that allows the user to do
  2584.                          various "tricks", such as spinning the cursor and
  2585.                          moving the cursor all over the screen.  This flag
  2586.                          is used to prevent callers from tying up the
  2587.                          message base with fancy, yet childish (and
  2588.                          useless) posts.
  2589.  
  2590.                A    Can't add to BBS list -- This flag prevents the caller
  2591.                          from using the (A)dd command in the BBS list menu.
  2592.                          Primarily used for callers who keep adding the
  2593.                          same BBS, false boards, voice phone numbers, etc.
  2594.                          to the BBS list.
  2595.  
  2596.                *    Can't post/send anon. -- This flag prevents the caller
  2597.                          from being able to post public or Email messages
  2598.                          anonymously.  Used for callers who like to
  2599.                          verbally assault other users; with this
  2600.                          restriction, all parties are aware of EXACTLY who
  2601.                          posts the message(s) in question.
  2602.  
  2603.                P    Can't post at all -- This flag prevents a user from
  2604.                          posting any messages in the message base.  Used
  2605.                          for callers who abuse the message bases wither
  2606.                          with blank posts on a post/call ratio oriented
  2607.                          system, excessive profanity, inane comments,
  2608.                          verbal assaults, etc.
  2609.  
  2610.                E    Can't send Email -- This flag prevents the caller from
  2611.                          sending ANY Email to another user.  Used for
  2612.                          callers who harass other users and don't stop,
  2613.                          despite SysOp intervention.
  2614.  
  2615.  
  2616.  
  2617.  
  2618.                                    - Page 39 -
  2619.  
  2620.                    Telegard Main Documentation - Version 2.5
  2621.  
  2622.  
  2623.                K    Can't vote -- Does not allow the caller to have access
  2624.                          to the voting booth.  Basically, this is the most
  2625.                          harmless restriction, as only the SysOp and
  2626.                          trusted users have designed the voting questions
  2627.                          (however, some users don't deserve ANY breaks!
  2628.                          <hehehe>).
  2629.  
  2630.                M    Automatic mail deletion -- This flag will force the BBS
  2631.                          to automatically delete a caller's Email.
  2632.                          Primarily used as a harassment tool for persons
  2633.                          who have previously abused the Email system and
  2634.                          have lost the privilege.
  2635.  
  2636.                1    No UL/DL ratio check -- This flag will suppress the
  2637.                          mandatory upload/download ratio check.  Used for
  2638.                          favored callers as a reward, and for remote
  2639.                          SysOps.
  2640.  
  2641.                2    No post/call ratio check -- This flag will suppress the
  2642.                          post/call ratio check on systems which implement
  2643.                          this feature.  Used for remotes who may have other
  2644.                          important tasks, such as user and file
  2645.                          validations, and it proves to be a hindrance.
  2646.  
  2647.                3    No file points check -- This flag will suppress the
  2648.                          checking of a user's file points when requesting a
  2649.                          download of a file.  Used as a reward to a good
  2650.                          uploader on a file points oriented system, or to a
  2651.                          remote.
  2652.  
  2653.                4    Protection from deletion -- This flag will prevent a
  2654.                          user's account from being deleted, until it is
  2655.                          toggled off.  Good for the SysOp, remote SysOps,
  2656.                          message base SysOps and all other high security
  2657.                          users.
  2658.  
  2659.           E    This option sets the initial number of file points awarded
  2660.                to new users.  The value here is determined, basically, by
  2661.                the generosity of the SysOp!
  2662.  
  2663.           F    This option sets the SL value for a validated user.  This
  2664.                value should be greater than that of a new users, because
  2665.                they passed your ideals of what a valid user should be.
  2666.                Permits higher access in the message base and other areas of
  2667.                the system.
  2668.  
  2669.           G    This option is similar to option F, except that it pertains
  2670.                to the DSL value.  Permits higher access in the file
  2671.                transfer section.
  2672.  
  2673.           H    This option defines the AR flags for a validated user.  See
  2674.                option C above for a complete description of AR flags.
  2675.  
  2676.           I    This option defines the AC flags for a validated user.  See
  2677.                option D above for a complete description of AC flags.
  2678.  
  2679.  
  2680.  
  2681.                                    - Page 40 -
  2682.  
  2683.                    Telegard Main Documentation - Version 2.5
  2684.  
  2685.  
  2686.      ---------------------------
  2687.      MISCELLANEOUS CONFIGURATION
  2688.      ---------------------------
  2689.  
  2690.      This section is for miscellaneous configuration options that don't fit
  2691.      anywhere else in the System Configuration.
  2692.  
  2693.      Upon selecting this option, the following menu is displayed:
  2694.      ______________________________________________________________________
  2695.  
  2696.      Miscellaneous configuration
  2697.  
  2698.      A. System start-out menu       :MAIN
  2699.      B. SysOp chat color-filter     :
  2700.      C. User chat color-filter      :
  2701.      D. Default bulletin prefix file:BULLET
  2702.  
  2703.      Enter selection (A-D) [Q]uit :
  2704.      ______________________________________________________________________
  2705.  
  2706.      Each option is described in detail below.
  2707.  
  2708.           A    This option defines the menu that is loaded first when a
  2709.                user logs on, which must be defined and must reside in the
  2710.                MENUS directory.  The default is MAIN, or the main menu.
  2711.                This option is useful for forcing users to start out at a
  2712.                different menu (the file transfer menu, the on-line programs
  2713.                menu, a user-defined menu, etc.).
  2714.  
  2715.           B    This option defines the color filter configuration file used
  2716.                during chat for the SysOp's input.  The file must reside in
  2717.                the AFILES directory.  If undefined, the SysOp chat color
  2718.                defined in the General Variables section is used.
  2719.  
  2720.           C    This option is similar to option B, except that it defines
  2721.                the color filter configuration file used during chat for the
  2722.                user's input.  Same rules and restrictions apply.
  2723.  
  2724.           D    This option defines the prefix name used for bulletin files.
  2725.                One to seven characters may be input, which would allow for
  2726.                seven- to one-character selections at the bulletin menu.
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.                                    - Page 41 -
  2745.  
  2746.                    Telegard Main Documentation - Version 2.5
  2747.  
  2748.  
  2749.      ---------------------
  2750.      FIDONET CONFIGURATION
  2751.      ---------------------
  2752.  
  2753.      This  section  defines the information required for  use  by  external
  2754.      FidoNet  message  processing utilities.  This  includes  your  FidoNet
  2755.      address,  a  default origin line, and options used  when  tossing  and
  2756.      scanning messages.  (If you are not a FidoNet node, then you can  skip
  2757.      this  information.)  Except for the FidoNet address,  all  information
  2758.      specified  here is used as defaults when creating a new  message  base
  2759.      (and, in the case of the origin line, if an individual origin line  is
  2760.      not specified).
  2761.  
  2762.      Upon selecting this option, the following menu is displayed:
  2763.      ______________________________________________________________________
  2764.  
  2765.      FidoNet configuration
  2766.  
  2767.      A. FidoNet address : 0:0/0.0
  2768.      B. Origin line     : Telegard BBS
  2769.  
  2770.      C. Strip IFNA kludge lines : Yes     1. Color of standard text : 1
  2771.      D. Strip SEEN-BY lines     : Yes     2. Color of quoted text   : 3
  2772.      E. Strip origin lines      : No      3. Color of tear line     : 9
  2773.      F. Strip centering codes   : Yes     4. Color of origin line   : 5
  2774.      G. Strip box codes         : Yes
  2775.      H. Center box/center lines : Yes
  2776.      I. Add tear/origin lines   : Yes
  2777.  
  2778.      Enter selection (A-I,1-4) [Q]uit :
  2779.      ______________________________________________________________________
  2780.  
  2781.      Each option is described in detail below.
  2782.  
  2783.           A    Defines your given FidoNet address.  You will be prompted
  2784.                for each individual component of the address (zone, net,
  2785.                node and point numbers); pressing [ENTER] at any prompt will
  2786.                leave that component unchanged.
  2787.  
  2788.                The FidoNet address is displayed in various places in the
  2789.                system (including the "Welcome to..." line during logon).
  2790.                However, if the net number is equal to "0", then the address
  2791.                is NOT displayed (since there is no such thing as Net 0 in
  2792.                FidoNet).
  2793.  
  2794.           B    Defines the origin line placed at the bottom of outgoing
  2795.                messages.  Do not put your FidoNet address in the origin
  2796.                line; Telegard (as well as external message processing
  2797.                utilities) will add it automatically.  This origin line is
  2798.                used if an individual origin line is not specified for a
  2799.                message base (and if THIS origin line isn't defined, then
  2800.                the first 50 characters of the BBS name are used).
  2801.  
  2802.           C    Toggles stripping of IFNA kludge lines from incoming
  2803.                messages.  Kludge lines begin with the ^A code (1 decimal),
  2804.                and are not normally needed.  Applicable to both EchoMail
  2805.  
  2806.  
  2807.                                    - Page 42 -
  2808.  
  2809.                    Telegard Main Documentation - Version 2.5
  2810.  
  2811.  
  2812.                and GroupMail bases.
  2813.  
  2814.           D    Toggles stripping of SEEN-BY lines from incoming messages.
  2815.                SEEN-BY lines define which nodes have received the message,
  2816.                and are not normally needed once the message has been
  2817.                received.  Useful only for EchoMail bases, as GroupMail
  2818.                messages don't have SEEN-BY lines.
  2819.  
  2820.           E    Toggles stripping of origin lines from incoming messages.
  2821.                The origin line identifies the system that originated the
  2822.                message, and is usually desirable.  Applicable to both
  2823.                EchoMail and GroupMail bases (though GroupMail messages
  2824.                aren't required to have origin lines).
  2825.  
  2826.           F    Toggles stripping of "center line" codes from lines in
  2827.                outgoing messages.  The centering code (^B, or 2 decimal)
  2828.                tells Telegard to display the line in the center of the
  2829.                screen according to the current screen width.  Unless you
  2830.                are communicating strictly with another Telegard system,
  2831.                this code has no meaning in FidoNet messages.  Applicable to
  2832.                both EchoMail and GroupMail bases.
  2833.  
  2834.           G    Toggles stripping of "box line" codes from lines in outgoing
  2835.                messages.  The box code ("`#[") tells Telegard to enclose
  2836.                the text in a box, centered on the screen according to the
  2837.                current screen width.  Unless you are communicating strictly
  2838.                with another Telegard system, this code has no meaning in
  2839.                FidoNet messages.  Applicable to both EchoMail and GroupMail
  2840.                bases.
  2841.  
  2842.           H    Toggles centering of boxed/centered lines in outgoing
  2843.                messages.  If enabled, lines that start with a box or center
  2844.                code will be centered on an 80-column line by padding the
  2845.                line to the left with spaces.  (This is only done if box
  2846.                and/or centering codes are being stripped.)  Applicable to
  2847.                both EchoMail and GroupMail bases.
  2848.  
  2849.           I    Toggles the automatic addition of tear and origin lines to
  2850.                messages posted in FidoNet bases.  The tear line will use
  2851.                the BBS version number ("--- Telegard v2.5", for example).
  2852.                Applicable mainly to GroupMail bases, as GroupMail messages
  2853.                aren't required to have tear and origin lines (they are
  2854.                mandatory, however, for EchoMail messages).
  2855.  
  2856.           1    Defines the color used to display normal text.  The default
  2857.                is MCI color #1 (cyan in the default setup).  Applicable to
  2858.                both EchoMail and GroupMail bases.
  2859.  
  2860.           2    Defines the color used to display quoted text.  Quoted text
  2861.                lines usually start with a ">" character, and serve to
  2862.                quote portions of a previous message.  If the line contains
  2863.                a ">" character anywhere in positions 1 through 5, it is
  2864.                displayed using this color, which defaults to MCI color #3
  2865.                (bright cyan in the default setup).  Applicable to both
  2866.                EchoMail and GroupMail bases.
  2867.  
  2868.  
  2869.  
  2870.                                    - Page 43 -
  2871.  
  2872.                    Telegard Main Documentation - Version 2.5
  2873.  
  2874.  
  2875.           3    Defines the color used to display the tear line.  The tear
  2876.                line defines the program used to process the message on the
  2877.                originating system; it begins with "--- ", followed by the
  2878.                name of the program.  The default is MCI color #9 (bright
  2879.                green in the default setup).  Applicable to both EchoMail
  2880.                and GroupMail bases (though GroupMail messages aren't
  2881.                required to have a tear line).
  2882.  
  2883.           4    Defines the color used to display the origin line.  As
  2884.                explained above, the origin line identifies the system that
  2885.                the message originated on; it begins with " * Origin: ",
  2886.                followed by a message defined by the SysOp of the
  2887.                originating system.  The default is color #5 (yellow in the
  2888.                default setup).  Applicable to both EchoMail and GroupMail
  2889.                bases (though GroupMail messages aren't required to have an
  2890.                origin line).
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.                                    - Page 44 -
  2934.  
  2935.                    Telegard Main Documentation - Version 2.5
  2936.  
  2937.  
  2938.      --------------------
  2939.      STRING CONFIGURATION
  2940.      --------------------
  2941.  
  2942.      This section will allow you to add different colors and special  codes
  2943.      to,  and  generally  change the appearance of,  many  of  the  strings
  2944.      displayed throughout the system.  The String Configuration section  is
  2945.      currently  comprised of five (5) pages of information; upon  selecting
  2946.      this option, the first page will be displayed.
  2947.  
  2948.      Following  is a display of all five pages, with descriptions  of  each
  2949.      field.  Three command keys are available at all screens:  "[" to  move
  2950.      to  the  previous screen, "]" to move to the next screen, and  "Q"  to
  2951.      return  to  the  System  Configuration  section.   With  only  a   few
  2952.      exceptions,  all  strings  defined below have a maximum  limit  of  80
  2953.      characters,  and  may contain ASCII text, MCI commands  or  MCI  color
  2954.      codes.
  2955.  
  2956.      ______________________________________________________________________
  2957.  
  2958.      String configuration - page 1 of 5
  2959.  
  2960.      A. Ansi logon Q.:Display ANSI logon?
  2961.      B. Logon note #1:Enter your Telegard NAME or USER NUMBER
  2962.         Logon note #2:* NEW USERS, enter "NEW" *
  2963.      C. Logon prompt :Logon :
  2964.      D. Echo chr     :X
  2965.      E. SysOp IN     :The SysOp is probably around!
  2966.      F. SysOp OUT    :The SysOp is NOT here, or doesn't want to chat
  2967.      G. Engage chat  :@MThe SysOp brings you into chat!
  2968.      H. Exit chat    :The SysOp returns you to the BBS....@M
  2969.      I. SysOp working:{-Please Wait-}
  2970.      J. Pause screen :(* pause *)
  2971.  
  2972.      Enter selection (A-J,[,]),(Q)uit :
  2973.      ______________________________________________________________________
  2974.  
  2975.           A    This question is asked of ALL callers, both off-site and
  2976.                local (except when the SysOp is in fast logon mode).  If the
  2977.                user enters "Yes", an ANSI picture (WELCOME.ANS) is
  2978.                displayed.  If the user enters "No", a text file
  2979.                (WELCOME.MSG) is displayed.
  2980.  
  2981.           B    These lines are provided as an aid to callers, especially to
  2982.                new users to a Telegard system who may not know how to log
  2983.                on as a new user.
  2984.  
  2985.           C    This is displayed just before the input area, and is usually
  2986.                a prompt such as "Logon:" that lets the caller know that the
  2987.                system is ready to log them on.
  2988.  
  2989.           D    This is the character that is echoed to the screen when the
  2990.                caller types his password and phone number.  Designed as a
  2991.                security feature so nobody standing behind the caller's back
  2992.                can steal their account.
  2993.  
  2994.  
  2995.  
  2996.                                    - Page 45 -
  2997.  
  2998.                    Telegard Main Documentation - Version 2.5
  2999.  
  3000.  
  3001.           E    This string tells the user that the SysOp is available and
  3002.                ready to chat.  This is displayed ONLY during the defined
  3003.                chat hours (defined in the "BBS Configuration and File
  3004.                Paths" section).
  3005.  
  3006.           F    This string is displayed when the SysOp is not available to
  3007.                chat (or doesn't wish to!).  It works according to the
  3008.                defined chat hours and is displayed at all times EXCEPT
  3009.                during chat hours.
  3010.  
  3011.           G    This string is displayed when the SysOp has engaged the Chat
  3012.                mode.
  3013.  
  3014.           H    This string is displayed as the SysOp disengages the Chat
  3015.                mode.
  3016.  
  3017.           I    This string is displayed when the SysOp is performing a
  3018.                function while a user is online (such as editing a user's
  3019.                security information).
  3020.  
  3021.           J    This works off the default screen size, established during
  3022.                the new user logon (and configurable at the Personal
  3023.                Information menu).  For instance, the default number of
  3024.                lines on an IBM-compatible system is 25.  So, after every 25
  3025.                lines of text is printed, the user is temporarily paused to
  3026.                allow viewing of the text.  This message is displayed when
  3027.                the pause is active; pressing [ENTER] releases the pause and
  3028.                continues normal operations.
  3029.      ______________________________________________________________________
  3030.  
  3031.      String configuration - page 2 of 5
  3032.  
  3033.      A. Message entry L#1:Enter message now.  You have @X lines maximum.
  3034.      B. Message entry L#2:Enter /S to save.  /? for a list of commands.
  3035.      C. NewScan start    :[@Y - @W msgs] NewScan began.@M
  3036.      D. NewScan done     :[@Y - @W msgs] NewScan complete.@M
  3037.      E. Read msgs prompt :[@Y]@M[@U] Read (1-@W,<CR>,T,Q,P,A,R,B,W,D) :
  3038.      F. Automessage by   :AutoMessage by:
  3039.      G. Auto border char.:-
  3040.  
  3041.      Enter selection (A-G,[,]),(Q)uit :
  3042.      ______________________________________________________________________
  3043.  
  3044.           A    This is the first line of the description for entering
  3045.                public messages and Email, displayed just after the header
  3046.                information is entered.
  3047.  
  3048.           B    This is the second line of the description for entering
  3049.                public messages and Email.  Both lines may contain color and
  3050.                MCI commands.
  3051.  
  3052.           C    This message is displayed at the start of each message base
  3053.                during a global NewScan for new messages.
  3054.  
  3055.           D    This message is displayed at the end of each message base
  3056.                during a global NewScan for new messages.
  3057.  
  3058.  
  3059.                                    - Page 46 -
  3060.  
  3061.                    Telegard Main Documentation - Version 2.5
  3062.  
  3063.  
  3064.           E    This prompt is displayed after each scanned or NewScanned
  3065.                message, and provides a list of available commands that may
  3066.                be used in the reading of messages.
  3067.  
  3068.           F    This message is displayed as the header of the automessage.
  3069.                It can be either straight ASCII text, or colorized text
  3070.                using the MCI colors.
  3071.  
  3072.           G    This character is a straight uncolored ASCII character.  It
  3073.                surrounds the text in the automessage at both the top and
  3074.                the bottom of the message.
  3075.      ______________________________________________________________________
  3076.  
  3077.      String configuration - page 3 of 5
  3078.  
  3079.      A. Shell to DOS L#1 :>> System Operator has Shelled to DOS, please wai
  3080.      t ...
  3081.      B. Shell to DOS L#2 :>> Thank you for waiting
  3082.      C. Chat call L#1    :Paging System Operator for chat, please wait.....
  3083.      D. Chat call L#2    : >><*><<
  3084.      E. Guest user info  :Enter "GUEST" as your user name to be a guest use
  3085.      r on the system.
  3086.      F. Name not found   :That name is NOT found in the user list.
  3087.      G. Bulletin line    :Enter Bulletin Selection (XX,?,Q=Quit) :
  3088.      H. Thanks for voting:Thanks for taking the time to vote!
  3089.  
  3090.      Enter selection (A-H,[,]),(Q)uit :
  3091.      ______________________________________________________________________
  3092.  
  3093.           A    This message is displayed when the SysOp has performed a
  3094.                local shell to DOS.  While the SysOp is in DOS, the caller
  3095.                is prevented from doing anything.
  3096.  
  3097.           B    This message is displayed when the SysOp has returned from
  3098.                dropping to DOS.
  3099.  
  3100.           C    This message is displayed when a user pages the SysOp for
  3101.                chat during declared chat hours.
  3102.  
  3103.           D    This message is displayed while the BBS is paging the SysOp
  3104.                during chat hours.  It is displayed nine times, with a beep
  3105.                occurring once prior to each display and once after.  A high
  3106.                pitched beeping sound on the local end is used to alert the
  3107.                SysOp that a user wishes to chat.
  3108.  
  3109.           E    This line is displayed with the logon lines at the time of
  3110.                logon, if a guest user account has been defined (see the
  3111.                "General Flagged Functions" section for more information
  3112.                about this feature).
  3113.  
  3114.           F    This message is displayed if the user name entered during
  3115.                the logon process is not present in the NAMES.LST file.  It
  3116.                serves to warn the user that either they entered their name
  3117.                wrong, or they have not signed onto the BBS before.
  3118.  
  3119.  
  3120.  
  3121.  
  3122.                                    - Page 47 -
  3123.  
  3124.                    Telegard Main Documentation - Version 2.5
  3125.  
  3126.  
  3127.           G    This message is displayed below the list of the BBS
  3128.                bulletins.  It contains commands that are present in the
  3129.                bulletin menu.
  3130.  
  3131.           H    This string is displayed after a user has accessed the
  3132.                voting booth and changed one ore more questions, or answered
  3133.                new questions.
  3134.      ______________________________________________________________________
  3135.  
  3136.      String configuration - page 4 of 5
  3137.  
  3138.      A. List line        :List files - P to pause
  3139.      B. File NewScan line:Search for new files -
  3140.      C. Search line      :Search all directories for a file mask -
  3141.      D. Find Descrip. L#1:Search descriptions and filenames for a keyword -
  3142.      E. Find Descrip. L#2:Enter the string to search for:
  3143.      F. Download line    :Download - You have @P file points.
  3144.      G. Upload line      :Upload - @Kk free on this drive
  3145.      H. View content line:View archive interior files -@MP to Pause, N for
  3146.      Next file
  3147.      I. Insuff. file pts :Access denied: Insufficient points to download.
  3148.      J. Bad UL/DL ratio  :Access denied: Your UL/DL ratio is out of balance
  3149.      :
  3150.  
  3151.      Enter selection (A-J,[,]),(Q)uit :
  3152.      ______________________________________________________________________
  3153.  
  3154.           A    This message is displayed when the user selects the command
  3155.                to list files at the file transfer menu.
  3156.  
  3157.           B    This message is displayed when the user selects the command
  3158.                to scan for new files at the file transfer menu.
  3159.  
  3160.           C    This message is displayed when a user searches for a
  3161.                particular file or files.
  3162.  
  3163.           D    This is the first line of the message that is displayed when
  3164.                a user selects the command to search for a text string to
  3165.                match a description or filename at the file transfer menu.
  3166.  
  3167.           E    This is the second line of the message described in option
  3168.                D.
  3169.  
  3170.           F    This message is displayed when a user attempts to download a
  3171.                file in either regular or batch mode.
  3172.  
  3173.           G    This message is displayed when a user attempts to upload a
  3174.                file in either regular or batch mode.
  3175.  
  3176.           H    This message is displayed when a user attempts to view the
  3177.                contents of an archive file available for downloading.
  3178.  
  3179.           I    This message is displayed when a user attempts to download a
  3180.                file that is worth more file points than they have credit
  3181.                for.  Used only on BBSes that use the file point system.
  3182.  
  3183.  
  3184.  
  3185.                                    - Page 48 -
  3186.  
  3187.                    Telegard Main Documentation - Version 2.5
  3188.  
  3189.  
  3190.           J    This message is displayed when a user attempts to download a
  3191.                file when their upload/download ratio is out of balance.
  3192.                Used only on BBSes that use the UL/DL ratio system.
  3193.      ______________________________________________________________________
  3194.  
  3195.      String configuration - page 5 of 5
  3196.  
  3197.      A. P/N file info    :P to Pause, N for next directory.
  3198.      B. Get filespec L#1 :[Enter]=All files
  3199.      C. Get filespec L#2 :File mask:
  3200.      D. Add to batch     :File added to batch queue.
  3201.  
  3202.      Enter selection (A-D,[,]),(Q)uit :
  3203.      ______________________________________________________________________
  3204.  
  3205.           A    This message is displayed when a NewScan of the file bases
  3206.                has begun.  Pressing "P" will pause during a file listing.
  3207.                Pressing "N" will stop the current base being scanned and
  3208.                start scanning the next available file base, if present.
  3209.  
  3210.           B    This is the first line of the message displayed when a file
  3211.                search is being attempted.
  3212.  
  3213.           C    This is the second line of the message displayed when a file
  3214.                search is being attempted.
  3215.  
  3216.           D    This message is displayed when a user has added a file to
  3217.                the upload or download queue for batch uploading or
  3218.                downloading.
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.  
  3248.                                    - Page 49 -
  3249.  
  3250.                    Telegard Main Documentation - Version 2.5
  3251.  
  3252.  
  3253.      --------------
  3254.      DEFAULT COLORS
  3255.      --------------
  3256.  
  3257.      This option is used to edit the colors for prompts, messages, etc., to
  3258.      add color and attractiveness to your BBS.  You can edit either  black-
  3259.      and-white  or ANSI colors.  The default colors are the ones  used  for
  3260.      new  users;  once set, the user can change his  defined  colors  while
  3261.      online.
  3262.  
  3263.      Below is a list of the standard color table:
  3264.  
  3265.           0. Other            Used for miscellaneous messages
  3266.           1. Default          Used for public message and Email text
  3267.           2. Unused           Unused
  3268.           3. Yes/No           Used for responses to Yes/No questions
  3269.           4. Prompts          Used for prompts
  3270.           5. Note             Used for file descriptions
  3271.           6. Input line       Used for keyboard input responses
  3272.           7. Y/N question     Used for Yes/No prompts
  3273.           8. Blinking         Used for unvalidated files and warnings
  3274.           9. Other            Used for miscellaneous messages
  3275.  
  3276.      The  color  editor itself is pretty self-explanatory, so  the  details
  3277.      will  not  be  presented here.  (In a nutshell,  both  foreground  and
  3278.      background  colors, and blinking, can be selected from the  full  ANSI
  3279.      color  set for each of the ten items in the color table.)  Suffice  it
  3280.      to  say  that  experimentation is in order if you  wish  to  redo  the
  3281.      standard color scheme, until you attain a combination to your liking.
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.                                    - Page 50 -
  3312.  
  3313.                    Telegard Main Documentation - Version 2.5
  3314.  
  3315.  
  3316.      ----------------
  3317.      TIME LIMITATIONS
  3318.      ----------------
  3319.  
  3320.      This  section defines the maximum amount of time (in minutes)  that  a
  3321.      user can remain online for each security level (SL) setting.
  3322.  
  3323.      Upon selecting this option, the following screen is displayed  (screen
  3324.      has been shortened for simplicity):
  3325.      ______________________________________________________________________
  3326.  
  3327.      Editing: Time limitations
  3328.  
  3329.      0:1     20:20   40:50    60:90    80:110  100:130  120:130  140:130
  3330.      1:1     21:20   41:50    61:90    81:110  101:130  121:130  141:130
  3331.        .       .       .        .        .        .        .         .
  3332.        .       .       .        .        .        .        .         .
  3333.        .       .       .        .        .        .        .         .
  3334.      19:10   39:40   59:80    79:100   99:120  119:130  139:130  159:130
  3335.  
  3336.      Range settings (S)et (T)oggle (Q)uit :
  3337.      ______________________________________________________________________
  3338.  
  3339.      The three commands available here are:
  3340.  
  3341.           (S)et - Sets the SL values for a range of SL settings.  You are
  3342.                asked to enter the starting and ending SL settings, and the
  3343.                new value to be placed in those settings.  Available SL
  3344.                settings are 0-255.
  3345.  
  3346.           (T)oggle - Switches the display between showing SL settings 0-159
  3347.                and 160-255.  Note that this does not affect the setting of
  3348.                SL values; the (S)et command can change values anywhere in
  3349.                the 0-255 SL range without necessarily having them currently
  3350.                displayed on the screen.
  3351.  
  3352.           (Q)uit - Returns you to the System Configuration menu.
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370.  
  3371.  
  3372.  
  3373.  
  3374.                                    - Page 51 -
  3375.  
  3376.                    Telegard Main Documentation - Version 2.5
  3377.  
  3378.  
  3379.      -----------------------
  3380.      CALL ALLOWANCES PER DAY
  3381.      -----------------------
  3382.  
  3383.      This  section  works  off  the  exact  same  principle  as  the   Time
  3384.      Limitations   section,  therefore  the  above  example  should   prove
  3385.      sufficient.   This  section sets the number of calls  allowed  in  any
  3386.      given day for a particular security level (SL).
  3387.  
  3388.  
  3389.      ---------------------------
  3390.      UL/DL NUMBER OF FILES RATIO
  3391.      ---------------------------
  3392.  
  3393.      This  section  works  off  the  exact  same  principle  as  the   Time
  3394.      Limitations   section,  therefore  the  above  example  should   prove
  3395.      sufficient.   This  section sets the number of files that a  user  can
  3396.      download  for every ONE file that the user uploads, for  a  particular
  3397.      security level (SL).
  3398.  
  3399.  
  3400.      ---------------------
  3401.      UL/DL KILOBYTES RATIO
  3402.      ---------------------
  3403.  
  3404.      This  section  works  off  the  exact  same  principle  as  the   Time
  3405.      Limitations   section,  therefore  the  above  example  should   prove
  3406.      sufficient.  This section sets the number of kilobytes that a user can
  3407.      download  for  every  ONE  KILOBYTE  that  the  user  uploads,  for  a
  3408.      particular security level (SL).
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.                                    - Page 52 -
  3438.  
  3439.                    Telegard Main Documentation - Version 2.5
  3440.  
  3441.  
  3442.                               ___________________
  3443.  
  3444.                                MODEM INFORMATION
  3445.                               ___________________
  3446.  
  3447.  
  3448.      Telegard  can operate with a wide variety of modems... which is  good,
  3449.      considering  the wide variety of modems out there!  Therein,  however,
  3450.      lies  the  problem... since modems vary so widely,  one  configuration
  3451.      cannot  hope  to  work with all modems.   Hopefully,  the  information
  3452.      presented  here  will  help you get your modem  up  and  running  with
  3453.      Telegard.   Also  presented is information on using  Telegard  with  a
  3454.      FOSSIL communications driver.
  3455.  
  3456.  
  3457.      -----------------------------
  3458.      SAMPLE INITIALIZATION STRINGS
  3459.      -----------------------------
  3460.  
  3461.      Shown  below  are some sample initialization strings.  If  your  modem
  3462.      does not respond to the default string, try using one of these.
  3463.  
  3464.           Tested and verified using the Everex Evercom EX-920 and the
  3465.           Avatex 1200 1200 baud modems:
  3466.  
  3467.                "ATH0Q0V0E0M1X1S0=0S2=1S10=45"
  3468.  
  3469.           Tested and verified using the Avatex 2400 and the Tektoniks 2400
  3470.           2400 baud modems:
  3471.  
  3472.                "ATH0Q0V0E0M1S0=0S2=1S7=45S9=3"
  3473.  
  3474.           Tested and verified using the Cardinal Technologies MB2450 2400
  3475.           baud modem:
  3476.  
  3477.                "ATH0Q0V0E0M0X1S0=0S2=1S7=45S10=40&C1&D2"
  3478.  
  3479.           Tested (but not fully) with Tandy Hayes-compatible modems:
  3480.  
  3481.                "ATH0Q0V0E0M0X1S2=1S10=40"
  3482.  
  3483.      Note  that  just because the description states that it works  with  a
  3484.      certain  brand  at a certain speed, it doesn't mean that it  will  not
  3485.      work with YOUR modem.  The only way to be sure is to try.
  3486.  
  3487.  
  3488.      -----------------
  3489.      HIGH-SPEED MODEMS
  3490.      -----------------
  3491.  
  3492.      In the world of the IBM PC, modems that run at 300, 1200 and 2400 baud
  3493.      are pretty standard; they use the same data transmission formats,  and
  3494.      they are -- for the most part -- compatible with the Hayes SmartModem.
  3495.  
  3496.      The  world  of 9600 baud (and higher) modems is  a  different  matter.
  3497.      Several  different  data transmission standards exist -- the  HST  and
  3498.  
  3499.  
  3500.                                    - Page 53 -
  3501.  
  3502.                    Telegard Main Documentation - Version 2.5
  3503.  
  3504.  
  3505.      V.32 standards are the most common -- as well as different  variations
  3506.      on the Hayes command set.  Other features, such as baud locking,  make
  3507.      using  a  high-speed  modem on BBS systems a  formidable  task.   This
  3508.      chapter is devoted to "clearing the air" about such matters.
  3509.  
  3510.      Current information is sparse, as high-speed modems are relatively new
  3511.      to  the market (and just coming into the price range of most  computer
  3512.      users).  When we receive more information about high-speed modems,  we
  3513.      will be updating our information and informing you, the user, as  soon
  3514.      as we have all the facts.
  3515.  
  3516.      Note  that  we DO NOT GUARANTEE that this information will  work  with
  3517.      your  modem!  We are providing it to serve as a starting point; if  it
  3518.      works  perfect  with your high-speed modem, all the  better.   If  you
  3519.      absolutely  cannot  get your high-speed modem to work  with  Telegard,
  3520.      contact one of the Alpha or Beta sites near you for assistance.
  3521.  
  3522.  
  3523.      THE US ROBOTICS DUAL STANDARD MODEM
  3524.  
  3525.      Below  is  the  configuration information for  the  US  Robotics  Dual
  3526.      Standard  modem  (set  up in the Modem Configuration  section  of  the
  3527.      system  configuration),  allowing baud locking at 19,200  baud.   This
  3528.      setup  should also work -- with a little modification -- with  the  US
  3529.      Robotics HST 9600 modem (though it hasn't been tested).
  3530.  
  3531.      1. Maximum baud rate    : 38400
  3532.      2. COM port number      : 1
  3533.      3. Modem initialization string:
  3534.         "ATB0E0H0M0V0X6&A1&B2&D0&H3&I5&K1&M4&N0&R2|"
  3535.      4. Modem answer string  : "ATA"
  3536.      5. Modem hangup string  : "~~~+++~~~ATH0"
  3537.      6. Modem offhook string : "ATH1M0"
  3538.      7. No-call init time    : 15
  3539.      A. 9600 ARQ rate baud   : 38400 baud
  3540.      F. Comm flags: CTS check ON, DSR check ON, XON/XOFF OFF, Normal
  3541.      carrier
  3542.      $. Force baud rates?    : Yes
  3543.      R. Modem result codes:
  3544.                           Case 1   Case 2 (ARQ)
  3545.          R1. NO CARRIER : 3
  3546.          R2. NO DIALTONE: 6
  3547.          R3. BUSY       : 7
  3548.          R4.  300 BAUD  : 4        14
  3549.          R5. 1200 BAUD  : 5        15
  3550.          R6. 2400 BAUD  : 10       16
  3551.          R7. 4800 BAUD  : 18       19
  3552.          R8. 9600 BAUD  : 13       17
  3553.  
  3554.  
  3555.      ------------------------------------
  3556.      USING A FOSSIL COMMUNICATIONS DRIVER
  3557.      ------------------------------------
  3558.  
  3559.      FOSSIL  stands  for Fido/Opus/SEAdog Standard Interface  Layer,  which
  3560.      specifies  a  generic  telecommunication  interface  for  IBM  PC  and
  3561.  
  3562.  
  3563.                                    - Page 54 -
  3564.  
  3565.                    Telegard Main Documentation - Version 2.5
  3566.  
  3567.  
  3568.      compatible  -- and less-than-compatible -- systems.  Due to  the  fact
  3569.      that it is a standard specification, the FOSSIL driver has gained wide
  3570.      acceptance  in the FidoNet community, and is used in various  FidoNet-
  3571.      related products.  It allows systems that are similar to the IBM PC --
  3572.      but with wide-ranging architecture -- to use the same software without
  3573.      modification.
  3574.  
  3575.  
  3576.      THE HISTORY OF FOSSIL
  3577.  
  3578.      To  better  explain  the history of FOSSIL, here is  an  excerpt  from
  3579.      "Fundamentals  of FOSSIL Implementation and Use, Version 5",  by  Rick
  3580.      Moore:
  3581.  
  3582.      "For  those  people who were not lucky enough to have an IBM PC  or  a
  3583.      system  nearly  completely  compatible, the world has  not  been  very
  3584.      friendly.  With his implementation of the Generic Fido(tm) driver, Tom
  3585.      Jennings made it possible for systems that had nothing in common  with
  3586.      an  IBM PC except an 808x-class processor, and the ability to run  MS-
  3587.      DOS Version 2 and above, to run his Fido(tm) software.  That was a lot
  3588.      to ask, and a lot of people though it was enough.
  3589.  
  3590.      "But not everyone.  While Thom Henderson was debugging version 4.0  of
  3591.      his SEAdog(tm) mail package, an 'extended' Generic driver was designed
  3592.      (in  cooperation with Bob Hartman) as a quick kludge to help  him  get
  3593.      past  a  problem with certain UART chips.  The new  hook  was  quickly
  3594.      pounced  upon  by  Vince Perriello, who, with  almost  DAILY  prodding
  3595.      (ouch! it still hurts) by Ken Kaplan, had been working with  Henderson
  3596.      to get DEC Rainbow support into SEAdog.  Vince then coded a driver  to
  3597.      use  this hook and - Voila! - SEAdog 4.0 started working like a  champ
  3598.      on the Rainbow.
  3599.  
  3600.      "At  the same time something was rotten in the state of  Texas.   Wynn
  3601.      Wagner  started  encountering some serious difficulties  in  his  Opus
  3602.      development effort.  Specifically, he couldn't force the Greenleaf(tm)
  3603.      Communications  Libraries  to behave in exactly the way he  felt  Opus
  3604.      required.   Enter Bob Hartman.  Having already enjoyed success in  the
  3605.      effort  with Thom Henderson, he suggested to Wynn that with  very  few
  3606.      extensions,  any  driver that was already  SEAdog(tm)  4.0  compatible
  3607.      could  drive  Opus  as well.  About that time, Vince  called  Wynn  to
  3608.      discuss porting Opus to the DEC Rainbow.  Wynn called Bob, Bob  called
  3609.      Vince, and the FOSSIL driver came into existence.
  3610.  
  3611.      "To  say  that the concept has gained wide acceptance in  the  FidoNet
  3612.      community  would be an understatement.  Henk Weavers' DUTCHIE  package
  3613.      uses  the  FOSSIL communications services.  Ron Bemis'  OUTER  package
  3614.      uses  FOSSIL  services for everything it does and as a  result  it  is
  3615.      completely generic.  There are already FOSSIL implementations for  the
  3616.      Tandy   2000,  Heath/Zenith  100,  Sanyo  555  and   other   'non-IBM'
  3617.      architectures.   With each new 'port' of the spec, the potential of  a
  3618.      properly coded FOSSIL application grows!"
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.                                    - Page 55 -
  3627.  
  3628.                    Telegard Main Documentation - Version 2.5
  3629.  
  3630.  
  3631.      HOW A FOSSIL DRIVER BENEFITS TELEGARD
  3632.  
  3633.      Using a FOSSIL driver with Telegard has several advantages.  First and
  3634.      foremost, Telegard can now be used with IBM PC-type systems that don't
  3635.      use  the  exact  same communications  standard.   Also,  since  FOSSIL
  3636.      drivers are time-proven, reliable, and -- best of all -- FAST,  system
  3637.      performance is increased.  Most FOSSIL drivers will also work reliably
  3638.      with  COM  ports  3,  4, and higher.   Finally,  FOSSIL  drivers  work
  3639.      splendidly with high-speed modems.  Thus, if you can't get your  high-
  3640.      speed  modem to work reliably with Telegard's  built-in  communication
  3641.      routines and/or with COM port 3 or higher, try using a FOSSIL driver.
  3642.  
  3643.      Telegard  will take care of enabling and disabling the  FOSSIL  driver
  3644.      when  needed; it will not be left "hanging" when you shell to DOS  (to
  3645.      execute a door, etc.) or exit the BBS.  It is completely reliable.
  3646.  
  3647.  
  3648.      INSTALLING A FOSSIL DRIVER WITH TELEGARD
  3649.  
  3650.      Below  are the steps necessary to use Telegard with a  FOSSIL  driver.
  3651.      If  one  FOSSIL driver doesn't work to your  satisfaction,  try  using
  3652.      another; there are plenty of them out there.  If you have any  trouble
  3653.      getting  a  FOSSIL driver to work with Telegard, contact  one  of  the
  3654.      Alpha or Beta sites near you.
  3655.  
  3656.           1.   Get a FOSSIL driver.  If you own a true IBM compatible,
  3657.                there are several drivers to choose from:  X00.SYS,
  3658.                Opus!Comm, and BNUcom are just three of them.  (For the
  3659.                following examples, X00.SYS is assumed.)
  3660.  
  3661.           2.   Install the FOSSIL driver into your AUTOEXEC.BAT (if it is a
  3662.                COM or EXE program) or CONFIG.SYS (if it is a SYS driver)
  3663.                file.  Make sure it is set up to work with ONE
  3664.                communications port.  (For example, installing X00.SYS would
  3665.                use "DEVICE=X00.SYS E 1" in your CONFIG.SYS file.)
  3666.  
  3667.                It is a good idea to use a small transmit buffer (if your
  3668.                FOSSIL driver supports it), say around 1024 bytes or less.
  3669.                If a larger buffer is used, it will fill up too fast, and
  3670.                users will not be able to abort displays very easily.  (If
  3671.                you are using a high-speed modem, you may actually WANT to
  3672.                use a larger buffer for better performance.  You'll have to
  3673.                experiment with it.)
  3674.  
  3675.           3.   Reboot your system so the FOSSIL driver will be installed.
  3676.  
  3677.           4.   Start up the BBS, go into the system configuration, and
  3678.                enter the General Flagged Functions section.  Toggle option
  3679.                "B" ("Use FOSSIL comm. driver") to YES.  This will tell
  3680.                Telegard to use the FOSSIL driver instead of the built-in
  3681.                communications routines.
  3682.  
  3683.                Don't worry about messing things up if you enable this
  3684.                option without a FOSSIL driver installed; Telegard is smart
  3685.                enough to recognize whether or not a FOSSIL driver actually
  3686.                exists, and to use the built-in routines if it doesn't.
  3687.  
  3688.  
  3689.                                    - Page 56 -
  3690.  
  3691.                    Telegard Main Documentation - Version 2.5
  3692.  
  3693.  
  3694.                                _________________
  3695.  
  3696.                                 THE USER EDITOR
  3697.                                _________________
  3698.  
  3699.  
  3700.      Telegard's  user editor is a feature you will use in conjunction  with
  3701.      others  to determine who has access to various parts of  your  system.
  3702.      In addition, all sorts of information about each user is kept here for
  3703.      you.
  3704.  
  3705.      Upon  entry  to  the user editor, you will see  the  following  screen
  3706.      (which has been compressed slightly to fit on the page):
  3707.      ______________________________________________________________________
  3708.  
  3709.      User #1 of 1     Status:None            SL:255   DSL:255
  3710.      User name:SysOp                         AR:ABCDEFGHIJKLMNOPQRSTUVWXYZ
  3711.      Real name:System Operator               AC:----------/1234
  3712.      Address      :Unknown                   Sex/Age :M00 (00/00/00)
  3713.      City / State :Unknown, MI               Zip-code:00000
  3714.      Computer Type:IBM PC                    Phone # :000-000-0000
  3715.      SysOp note   :                          Last/1st:01/01/80 (01/01/80)
  3716.      Occupation   :SysOp                     Lockfile:inactive
  3717.      BBS reference:                          Password:SYSOP
  3718.      Call records- TC:1        TT:1          CT:0    TL:32761    Tbank:0
  3719.      Mail records- Pub:0       Priv:0        Fback:0     Wait:0
  3720.      File records- DL:0        UL:0-0k             Pts:0
  3721.  
  3722.      Option :
  3723.      ______________________________________________________________________
  3724.  
  3725.      Each command available in the user editor is detailed below.
  3726.  
  3727.           ;    Toggles between "long" and "short" display modes.  The long
  3728.                mode is shown above.  The short mode displays only the user
  3729.                record number, user status, SL and DSL, user name, real
  3730.                name, AR flags, and AC flags.
  3731.  
  3732.           :    Used to "turn off" the display of the user account records.
  3733.                This speeds things up considerably when you already know
  3734.                what you intend to do next.  However, [ENTER] will still
  3735.                redisplay the account if needed.
  3736.  
  3737.           [    Allows editing of the record previous to the current one.
  3738.                If you are at the first record, this command will move to
  3739.                the last record.
  3740.  
  3741.           ]    Allows editing of the record after the current one.  If you
  3742.                are at the last record, this command will move to the first
  3743.                record.
  3744.  
  3745.           =    This command restores the original information for the
  3746.                current record, IF you have not moved to another record or
  3747.                exited the user editor.  In effect, the information in the
  3748.                current record is not recorded UNTIL you move to another
  3749.                record or exit the user editor.  (Think of "=" as an "undo"
  3750.  
  3751.  
  3752.                                    - Page 57 -
  3753.  
  3754.                    Telegard Main Documentation - Version 2.5
  3755.  
  3756.  
  3757.                or "oops!" feature.)
  3758.  
  3759.           {    Searches backwards in the user file for all users matching
  3760.                the criteria declared in "O" (search options).  If at the
  3761.                lowest matching user, the highest matching user will be
  3762.                displayed.  If no criteria has been declared, this command
  3763.                acts the same as "[".
  3764.  
  3765.           }    Searches forward in the user file for all users matching the
  3766.                criteria declared in "O" (search options).  If at the
  3767.                highest matching user, the lowest matching user will be
  3768.                displayed.  If no criteria has been declared, this command
  3769.                acts the same as "]".
  3770.  
  3771.           *    Automatically validates a new user with the SL, DSL, AR
  3772.                flags, and restrictions as defined in the system
  3773.                configuration.
  3774.  
  3775.           ~    This command will trap (record) EVERY single action of a
  3776.                user from logon to logoff, including file scans, message
  3777.                scans, posts, etc.  It is far more comprehensive than the
  3778.                SYSOP.LOG file (explained later) and is used to record the
  3779.                actions of "problem users" or to reconstruct events if
  3780.                there has been some type of a common crash occurring with
  3781.                numerous callers.
  3782.  
  3783.                When this is toggled to ON, it will prompt for whether or
  3784.                not to trap, and whether or not to send it to a separate
  3785.                file.  If it is sent to a separate file, the status bar in
  3786.                the user record will say "Trapping (Separate)", and the
  3787.                trapping will be sent to a file called TRAPxxxx.MSG with the
  3788.                "xxxx" corresponding to the user's record number.  If the
  3789.                trapping is NOT separate, then it will go to a common file
  3790.                called TRAP.MSG.
  3791.  
  3792.           @    This option allows a user to be "locked out" from the BBS;
  3793.                the user will not be allowed to log back on under that name
  3794.                or handle.  You will be prompted for a lockout filename,
  3795.                which can contain your own personal message to that special
  3796.                someone you would like to repay for all his/her kindness.
  3797.                If a filename is entered, that text is displayed each time
  3798.                the user tries to call.  If no special file is chosen, it
  3799.                displays a common one called LOCKOUT.MSG and then hangs up.
  3800.  
  3801.           !    Toggles the "alert" status of the user.  If on, an "ALERT!"
  3802.                message is displayed in the SysOp window and a siren will
  3803.                sound (until you press [F9] to shut it off).
  3804.  
  3805.           A    Alters the user's address.
  3806.  
  3807.           C    Alters the user's city and state/province.
  3808.  
  3809.           D    Alters the user's download security level (DSL).
  3810.  
  3811.           E    Allows toggling of the user's AC flags.  The various flags
  3812.                are explained in detail in the system configuration section
  3813.  
  3814.  
  3815.                                    - Page 58 -
  3816.  
  3817.                    Telegard Main Documentation - Version 2.5
  3818.  
  3819.  
  3820.                (under "New User and Auto-Validation Settings").
  3821.  
  3822.           F    Allows toggling of the user's AR flags, which can allow (or
  3823.                restrict) access to various sections of the BBS.  These
  3824.                flags are not defined with a specific purpose; their use is
  3825.                entirely controlled by you.
  3826.  
  3827.           G    Alters the user's date of birth.
  3828.  
  3829.           I    Alters the user's "occupation" comment.
  3830.  
  3831.           K    Alters the comment field.  This field can be used as a
  3832.                "scratch pad" for keeping notes on the user.
  3833.  
  3834.           L    Alters the date that the user last called the BBS.
  3835.  
  3836.           M    Alters the status of the user's mailbox.  If the mailbox is
  3837.                closed, no Email can be sent to that particular user.  (The
  3838.                only exception is the user that is designated to receive
  3839.                validation letters from new users.  New user validation
  3840.                letters will be "forced" into the mailbox, even if it is
  3841.                closed).  If the mailbox is open, the option exists to route
  3842.                the mail to another user.
  3843.  
  3844.           N    Alters the user's name.  If the BBS allows handles, this
  3845.                name can be different from the user's real name.
  3846.  
  3847.           O    Specifies certain criteria for searching for users.  The
  3848.                following criteria are defined:
  3849.  
  3850.                     General text
  3851.                     ACS
  3852.                     SL
  3853.                     DSL
  3854.                     AR flags
  3855.                     AC flags
  3856.                     Status (alert, chat buffering, deleted, locked out,
  3857.                          separate SysOp log, trapping)
  3858.                     Days since last on
  3859.                     Days since first on
  3860.                     Number of calls
  3861.                     User age
  3862.                     User gender
  3863.                     # 1/10's call/post
  3864.                     #k DL/1k UL
  3865.                     # DLs/1 UL
  3866.  
  3867.                In addition, there are several commands that can be used
  3868.                while in this sub-menu:
  3869.  
  3870.                     (L)ist options - List the current definitions for
  3871.                          each option.
  3872.  
  3873.                     (T)oggle options on/off - Toggle an option on/off.
  3874.  
  3875.                     (C)lear options - Make all options inactive.
  3876.  
  3877.  
  3878.                                    - Page 59 -
  3879.  
  3880.                    Telegard Main Documentation - Version 2.5
  3881.  
  3882.  
  3883.                     (U)sers who match - List all users who match the
  3884.                          defined criteria.
  3885.  
  3886.                     (Q)uit - Return to the user editor.
  3887.  
  3888.           P    Alters the user's telephone number.
  3889.  
  3890.           R    Alters the user's real name.
  3891.  
  3892.           S    Alters the user's security level (SL).
  3893.  
  3894.           T    Alters the user's computer type.
  3895.  
  3896.           U    Moves directly to another user's record.  You may enter the
  3897.                user number, the user name, or a partial search string (the
  3898.                user file will be searched for every user name that contains
  3899.                the search string, and you will be prompted one by one).
  3900.  
  3901.           W    Alters the "heard about this BBS from?" comment field.
  3902.  
  3903.           Y    Assigns the user as a message base SysOp for up to five
  3904.                message bases.  Remember to alter this if you delete and/or
  3905.                move message bases via the message base editor!
  3906.  
  3907.           Z    Alters the user's postal zip code.
  3908.  
  3909.           $    Alters the user's password.
  3910.  
  3911.           \    Allows viewing of the separate SysOp log for this user (if
  3912.                one has been set up).
  3913.  
  3914.           1    Allows alteration of the user's calling records, both daily
  3915.                and cumulative values.  The total calls, total time on,
  3916.                calls today, time left today, and illegal logon attempts
  3917.                fields can be changed.
  3918.  
  3919.           2    Allows alteration of the user's cumulative mail records.
  3920.                The total public posts, total private posts (Email), total
  3921.                feedback sent, and mail waiting fields can be changed.
  3922.  
  3923.           3    Allows alteration of the user's cumulative UL/DL records.
  3924.                The number of uploaded files, number of downloaded files,
  3925.                total upload kilobyte value, and total download kilobyte
  3926.                value fields can be changed.
  3927.  
  3928.           '    Alters the user's personal color setup.  Both color and
  3929.                black-and-white setups can be changed.
  3930.  
  3931.           #    Alters the user's file points.
  3932.  
  3933.           &    Alters the amount of time in minutes that the user has in
  3934.                the Time Bank.  The maximum amount of time allowed is 600
  3935.                minutes total.
  3936.  
  3937.           ^    Toggles deletion of a user's record.  In the event a user is
  3938.                deleted, all voting records and Email (both to and from the
  3939.  
  3940.  
  3941.                                    - Page 60 -
  3942.  
  3943.                    Telegard Main Documentation - Version 2.5
  3944.  
  3945.  
  3946.                user) are deleted.
  3947.  
  3948.           -    Allows viewing of the user's answers to the NEWUSER.INF
  3949.                InfoForm questionnaire (stored in NEWUSER.ASW), if one was
  3950.                used.
  3951.  
  3952.           _    Allows viewing of the user's answers to any InfoForm
  3953.                questionnaire.  You will be prompted to enter the filename
  3954.                of the InfoForm questionnaire; the answers will be extracted
  3955.                from the corresponding *.ASW file.
  3956.  
  3957.           Q    Exits the user editor and returns to the WFC menu (or the
  3958.                BBS if online).
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.  
  3986.  
  3987.  
  3988.  
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.  
  4004.                                    - Page 61 -
  4005.  
  4006.                    Telegard Main Documentation - Version 2.5
  4007.  
  4008.  
  4009.                              ______________________
  4010.  
  4011.                               THE FILE BASE EDITOR
  4012.                              ______________________
  4013.  
  4014.  
  4015.      The file base editor serves a valuable purpose in that it sets up your
  4016.      file  bases, which are ESSENTIAL for the uploading and downloading  of
  4017.      files on the BBS.
  4018.  
  4019.      Upon  entering the file base editor, a screen similar to  the  example
  4020.      shown below will be displayed (it has been compressed slightly to  fit
  4021.      on the page):
  4022.      ______________________________________________________________________
  4023.  
  4024.      NNN:File base name           :Flags:ACS     :UL ACS:Name ACS:Maxf:Dep
  4025.      ===:=========================:=====:========:======:========:====:===
  4026.      0   SysOp                     ----- s200d200 U1              100  0
  4027.      1   General                   ---N- d50             s50      50   0
  4028.      2   IBM Games                 ----- d50fG                    200  0
  4029.      3   Communications Programs   ----- d60                      50   0
  4030.      4   GIF Pictures [VGA ONLY]   -G--- d60                      500  0
  4031.      ______________________________________________________________________
  4032.  
  4033.      The following commands are available from this screen:
  4034.  
  4035.           <CR>Redisplay screen
  4036.           (D)elete base (I)nsert base
  4037.           (M)odify base (P)osition base
  4038.           (Q)uit        (T)oggle display format
  4039.  
  4040.      and are explained in detail below.
  4041.  
  4042.           <CR>Redisplay screen -- It will redisplay the listing of file
  4043.                bases when pressed.
  4044.  
  4045.           (D)elete -- Used to remove a file base.  You will be prompted
  4046.                WHICH base you want to delete.  File bases number from 0 to
  4047.                the highest; Telegard currently has provisions for 97 file
  4048.                bases.  When you delete a file board, it will move all
  4049.                following file bases up one in position.  Also, the filename
  4050.                that described the files present in the directory is erased
  4051.                (you are prompted with "Delete it (Y/N)?", just in case you
  4052.                wish to abort the deletion.
  4053.  
  4054.           (I)nsert -- Used to insert another file board in your file
  4055.                system.  It will prompt you with "File base to insert before
  4056.                (0-xx)?", with "xx" being the highest base currently.  Also,
  4057.                Telegard has a maximum of 97 file bases ranging from (0-96).
  4058.                Inserting a file board will move all subsequent boards up
  4059.                one in position.
  4060.  
  4061.                NOTE: Telegard uses "<<Not Used>>" as the default
  4062.                description, NEWDIR as the default filename, and "C:DLOADS\"
  4063.                as the default file path when you insert a board.
  4064.  
  4065.  
  4066.  
  4067.                                    - Page 62 -
  4068.  
  4069.                    Telegard Main Documentation - Version 2.5
  4070.  
  4071.  
  4072.           (M)odify -- Allows changes to be made to the security setting of
  4073.                the file base, the file path, the board name, maximum number
  4074.                of files, and the filename, which stores the data of the
  4075.                file descriptions of that particular file board.  Details of
  4076.                this command are presented later.
  4077.  
  4078.           (P)osition -- Moves the file boards around in position.  For
  4079.                example, if you recently created a file base 0, and wished
  4080.                for it to be after file board 2, then you would change the
  4081.                position from 0 to 3.
  4082.  
  4083.           (T)oggle -- Toggles the file board editor between three display
  4084.                modes.  The common and default one is illustrated at the
  4085.                beginning of the file editor discussion.
  4086.  
  4087.           (Q)uit -- Exits the file base editor.
  4088.  
  4089.      Now, for an explanation of how to modify individual file bases.   When
  4090.      you select the (M)odify command, you will be asked which base you wish
  4091.      to modify.  After you make your selection, you will be shown a  screen
  4092.      similar to the following example:
  4093.      ______________________________________________________________________
  4094.  
  4095.      1. Name        : General Files
  4096.      2. Filename    : GENERAL
  4097.      3. DL/UL path  : C:\BBS\DLOADS\GENERAL\  /Same
  4098.      4. ACS required: "s50d50fG"
  4099.      5. UL/Name ACS : "" / ""
  4100.      6. Max files   : 50
  4101.      7. Password    : ""
  4102.      8. Arc/cmt type: ZIP/1
  4103.      9. Dir depth   : 0
  4104.         Flags       : -----
  4105.         P-Index     : 27
  4106.      Q. Quit
  4107.  
  4108.      Enter selection (1-9) [Q]uit :
  4109.      ______________________________________________________________________
  4110.  
  4111.      The commands available from this screen are:
  4112.  
  4113.           <CR>Redisplay screen
  4114.           1-8:Modify item
  4115.           ([)Back entry        (])Forward entry
  4116.           (J)ump to entry      (F)irst entry in list
  4117.           (Q)uit and save      (L)ast entry in list
  4118.  
  4119.           Toggles:
  4120.           (N)oRatio            (U)nhidden
  4121.           (D)ir-header         (I)*.DIR file in DLPATH
  4122.           (G)ifSpecs
  4123.  
  4124.      and are explained in detail below.
  4125.  
  4126.           1    Allows you to rename the current file base.  It stores the
  4127.                name as ASCII text, with a maximum of 40 characters (less if
  4128.  
  4129.  
  4130.                                    - Page 63 -
  4131.  
  4132.                    Telegard Main Documentation - Version 2.5
  4133.  
  4134.  
  4135.                MCI colors are used, which take up 2 characters each).
  4136.  
  4137.           2    Allows you to alter the directory filename, which stores the
  4138.                information on each file in the file base (description, file
  4139.                points, date uploaded, length, etc.).  The respective files
  4140.                are stored in the GFILES path as ".DIR" files (or in the
  4141.                upload path if the "(I)*.DIR file in DLPATH" flag is set).
  4142.  
  4143.           3    Allows you to reconfigure the path to which your files are
  4144.                stored in.  The default is "C:DLOADS\", but Telegard will
  4145.                accept any logical drive that DOS supports, if present.  If
  4146.                the DL and UL paths are the same, "Same" is displayed for
  4147.                the UL path.  The option of separate paths is provided to
  4148.                aid the SysOp if, for example, the SysOp has one directory
  4149.                for all new files; until validation, they can be sent there.
  4150.  
  4151.           4    This is a security feature of the file system, designed for
  4152.                different security levels, with primary emphasis on HIGHER
  4153.                security levels.  The user must be able to satisfy the
  4154.                specified Access Condition String in order to have access to
  4155.                that file base.
  4156.  
  4157.           5    A user must be able to satisfy the specified ACS in order to
  4158.                be allowed to upload files to that particular directory.
  4159.                The name ACS is used as a secondary security option so that
  4160.                only persons satisfying the name ACS will be able to see the
  4161.                uploader's name in the secondary list option.  Also, it will
  4162.                not list the uploader's name when the user attempts to
  4163.                download a file from that particular file base, if the user
  4164.                does not satisfy the ACS requirements.
  4165.  
  4166.           6    This is the maximum number of files allowable in a file
  4167.                board.  If a user tries to upload a file when the maximum
  4168.                number of files is achieved, it will NOT allow the transfer.
  4169.                This value usually starts at 50 and may increase to 32,767
  4170.                files, depending on the need, and it relates to the number
  4171.                of individual files in the base and the number of individual
  4172.                descriptions in the filename.
  4173.  
  4174.           7    Another security feature, in that the user must enter a
  4175.                password each time they attempt to access the file board.
  4176.                Passwords may be 10 characters in length, and are
  4177.                alphanumeric in nature.  (The default password is "" [null],
  4178.                or no password.)
  4179.  
  4180.           8    This enables file bases to be set up with different
  4181.                compression types, as defined in the system configuration
  4182.                (the "Archive Configuration" sub-menu of the "File
  4183.                "Configuration" section).  You may have a few different
  4184.                file comments floating around, such as "Call [BBS]" or "From
  4185.                Another Fine Telegard Near You!".  (The default is the ZIP
  4186.                compression method and the first comment.)
  4187.  
  4188.           9    The directory depth feature has not been implemented (it is
  4189.                for future expansion).
  4190.  
  4191.  
  4192.  
  4193.                                    - Page 64 -
  4194.  
  4195.                    Telegard Main Documentation - Version 2.5
  4196.  
  4197.  
  4198.           [    Displays the previous file base.  If at the first file base,
  4199.                this command has no effect.
  4200.  
  4201.           ]    Displays the next file base.  If at the last file base, this
  4202.                command has no effect.
  4203.  
  4204.           F    Displays the first file base.
  4205.  
  4206.           J    Displays the specified file base.
  4207.  
  4208.           L    Displays the last file base.
  4209.  
  4210.           Q    Exits the file base editor and returns to the WFC menu (or
  4211.                the BBS if online).
  4212.  
  4213.      The bottom two fields are defined as follows:
  4214.  
  4215.           Flags -- Five flags are present for toggling that regulate file
  4216.                viewing and ratios.  These flags are:
  4217.  
  4218.                     N - No ratio checking
  4219.                     U - File base is unhidden
  4220.                     D - [not implemented]
  4221.                     I - *.DIR file in DLPATH
  4222.                     G - Automatically insert GIFspecs on *.GIF files
  4223.  
  4224.                These flags are explained in more detail below.
  4225.  
  4226.           P-Index -- A "permanent index number" for the file base number
  4227.                that can NOT be changed.  It stays with the base from
  4228.                creation, regardless of insertions, deletions, and movements
  4229.                of file bases.
  4230.  
  4231.      The available flags are toggled with the following commands:
  4232.  
  4233.           N    Sets the file base in question so that there are no UL/DL
  4234.                ratio or file points checks.
  4235.  
  4236.           U    If toggled on, it will display a file base in an area
  4237.                listing regardless of whether or not the user has access to
  4238.                that base.  If the user lacks access, it will show in the
  4239.                list with a name but no base number and it will be
  4240.                inaccessible.
  4241.  
  4242.           D    This feature is not implemented (it is for future
  4243.                expansion).
  4244.  
  4245.           I    If toggled on, the *.DIR file for the particular file base
  4246.                will be stored in the download path instead of the GFILES
  4247.                directory.  An example of using this feature would be to
  4248.                store groups of files on floppy diskettes (with *.DIR files
  4249.                on each diskette).  That way, the disks can be "rotated"
  4250.                every once in a while (useful for GIF picture files, which
  4251.                can take up a LOT of space before you know it!).
  4252.  
  4253.  
  4254.  
  4255.  
  4256.                                    - Page 65 -
  4257.  
  4258.                    Telegard Main Documentation - Version 2.5
  4259.  
  4260.  
  4261.           G    Speaking of GIF files... this flag is used for directories
  4262.                containing GIF pictures, and if toggled on, the BBS will,
  4263.                upon uploading, insert in the description the size and color
  4264.                information taken directly from the GIF file.  It is saved
  4265.                in the following format:
  4266.  
  4267.                     (xpixels,ypixels,colors)
  4268.  
  4269.                where "xpixels" is the width of the picture (the X axis),
  4270.                "ypixels" is the height of the picture (the Y axis), and
  4271.                "colors" is the number of colors used in display.
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.                                    - Page 66 -
  4320.  
  4321.                    Telegard Main Documentation - Version 2.5
  4322.  
  4323.  
  4324.                            _________________________
  4325.  
  4326.                             THE MESSAGE BASE EDITOR
  4327.                            _________________________
  4328.  
  4329.  
  4330.      The message base editor is used to structure the message system in all
  4331.      features  such as data file name, maximum number of messages,  message
  4332.      base  security  levels  for viewing and posting,  and  other  security
  4333.      features.
  4334.  
  4335.      Upon  entry  to  the  message base editor, a  screen  similar  to  the
  4336.      examplebelow will appear (it has been compressed slightly to fit  onto
  4337.      the page):
  4338.      ______________________________________________________________________
  4339.  
  4340.      NNN Base name           :Flag:ACS       :Post ACS  :MCI ACS   :MaxM:An
  4341.      === ====================:====:==========:==========:==========:====:==
  4342.      1   General              L--- s10        s10        %          100  Y
  4343.      2   Telegard News!       L--- s10        s10        %          100  N
  4344.      3   Dear Abby            L--- s20        s20        %          50   A
  4345.      4   Star Trek Echo       ER-A s20        s20        %          500  N
  4346.      5   GroupMail Support    GR-A s20        s20        %          100  N
  4347.      ______________________________________________________________________
  4348.  
  4349.      The available commands from this screen are:
  4350.  
  4351.           <CR>Redisplay screen
  4352.           (D)elete base (I)nsert base
  4353.           (M)odify base (P)osition base
  4354.           (Q)uit        (T)oggle display format
  4355.  
  4356.      and are described as follows:
  4357.  
  4358.           <CR>Redisplay screen -- This will redisplay the list of message
  4359.                bases available for editing.
  4360.  
  4361.           (D)elete -- This command will delete a message base and move all
  4362.                the subsequent message bases up one entry.  If you try to
  4363.                delete a message base, as a warning it will display a string
  4364.                of ASCII text:  "[Base Name] Delete it?".
  4365.  
  4366.           (I)nsert -- Serves to insert a new message base and move all the
  4367.                subsequent bases down one in the listing.
  4368.  
  4369.           (M)odify -- Allows you to make modifications to the individual
  4370.                message bases that include things such as file names,
  4371.                security features, and the name of that message base.  This
  4372.                process is described in detail later.
  4373.  
  4374.           (P)osition -- Moves the message bases around in position.  For
  4375.                example, if you recently created a message base 0, and
  4376.                wished for it to be after message base 2, then you would use
  4377.                this command to change the position from 0 to 3.
  4378.  
  4379.  
  4380.  
  4381.  
  4382.                                    - Page 67 -
  4383.  
  4384.                    Telegard Main Documentation - Version 2.5
  4385.  
  4386.  
  4387.           (T)oggle display format -- This will cause the message base
  4388.                editor to toggle between four different screens covering
  4389.                everything associated with the structure of a message base:
  4390.                Security, names, file paths, permanent index numbers, etc.
  4391.                The first and most common toggle mode is shown above.
  4392.  
  4393.           (Q)uit -- Exits the message base editor.
  4394.  
  4395.      When  you  select the (M)odify command, you are asked which  base  you
  4396.      wish  to modify.  After entering your selection, a screen  similar  to
  4397.      the following example is displayed:
  4398.      ______________________________________________________________________
  4399.  
  4400.      1. Name        : General
  4401.      2. Filename    : GENERAL
  4402.      3. Base type   : Local
  4403.         Message path: Unused  -OR-  <message directory path>
  4404.      4. ACS req.    : "s30"
  4405.      5. Post/MCI ACS: "s30" / "%"
  4406.      6. Max Mess    : 50
  4407.      7. Anonymous   : Yes
  4408.      8. Password    : ""
  4409.      C. Colors      : Unused  -OR-  Text=1, Quote=3, Tear=9, Origin=5
  4410.      M. Flags       : Unused  -OR-  KS-CB/MT
  4411.      O. Origin line : Unused  -OR-  "<origin line text>"
  4412.         Flags       : ---
  4413.         P-Index     : 0
  4414.      Q. Quit
  4415.      ______________________________________________________________________
  4416.  
  4417.      Each field and command is described in detail below.
  4418.  
  4419.           1    The name of the message base.  It is in straight ASCII text
  4420.                and has a maximum of 40 characters.  MCI colors and other
  4421.                commands may be used in the base name.
  4422.  
  4423.           2    The name of the message files.  Three files are created
  4424.                using this name:  "name.BRD" (the actual messages), "NAME.
  4425.                MIX" (index into the BRD file), and "name.TRE" (similar to
  4426.                MIX except for ReplyTree mode); the files are stored in the
  4427.                message directory defined in the system configuration.
  4428.  
  4429.           3    Designates the message base type.  Three types are currently
  4430.                available:
  4431.  
  4432.                     Local -- Allows the exchange of messages only between
  4433.                          the users of the BBS.
  4434.  
  4435.                     EchoMail -- Allows the exchange of messages, via the
  4436.                          FidoNet system, between users of BBSes linked
  4437.                          across the country and around the world.
  4438.  
  4439.                     GroupMail -- Similar in concept to EchoMail, but with
  4440.                          a different distribution method that, in many
  4441.                          cases, is faster and more reliable than EchoMail.
  4442.  
  4443.  
  4444.  
  4445.                                    - Page 68 -
  4446.  
  4447.                    Telegard Main Documentation - Version 2.5
  4448.  
  4449.  
  4450.                When a base is defined as EchoMail or GroupMail, you will be
  4451.                prompted for the FidoNet message path.  This is required for
  4452.                Telegard-specific FidoNet mail processing utilities; it is
  4453.                used to store temporary files.  For EchoMail messages, you
  4454.                can define the path off the message directory, using the
  4455.                same name as the message base filename.  (For example, if
  4456.                the base filename was "TREK", and the BBS message path was
  4457.                "C:\BBS\MSGS", you could define the directory path as
  4458.                "C:\BBS\MSGS\TREK".)
  4459.  
  4460.                For GroupMail messages, you'll have to use the paths created
  4461.                off the GROUP directory (as created by SEA's GROUP utility).
  4462.                For example, if the base filename was "BLATZ", and the
  4463.                GroupMail message path was "C:\BBS\GROUP", you must define
  4464.                the directory path as "C:\BBS\GROUP\BLATZ".  Consult the
  4465.                manual for the GROUP utility for more information, as well
  4466.                as the section "Using Telegard With FidoNet" in this manual.
  4467.  
  4468.                If a base is defined as Local, then "Unused" is shown as
  4469.                the message path in the "Message path:" field.  Otherwise,
  4470.                the actual directory pathname is shown.
  4471.  
  4472.           4    The ACS requirements that the user must meet in order to
  4473.                access the message base.  A caller that does not satisfy the
  4474.                requirements will notice a board is missing -- unless it is
  4475.                designated as "unhidden" -- but will have no clues as to
  4476.                what it is.  (If the "compress message/file bases" feature
  4477.                is enabled in the system configuration, then the user won't
  4478.                even know the base is missing!)
  4479.  
  4480.           5    For the post ACS, the user must satisfy the requirements in
  4481.                order to post messages on that base.  In some cases, users
  4482.                will be able to read messages, but be lacking in security to
  4483.                post.  For the MCI ACS, the user must satisfy the
  4484.                requirements in order to use MCI codes within messages.
  4485.  
  4486.                For non-local bases, it is recommended that you disable the
  4487.                MCI feature by specifying "%" for the ACS, as non-Telegard
  4488.                systems will see the MCI codes (@1, @2, etc.) with no idea
  4489.                what they mean.
  4490.  
  4491.           6    This is the maximum number of messages that can be posted on
  4492.                the base.  The default is 50, with a maximum of 32767.  When
  4493.                the number of messages exceeds this limit, and the message
  4494.                bases are packed, old posts start getting removed (with the
  4495.                exception of messages that have been flagged "permanent").
  4496.  
  4497.           7    This determines the anonymity level of the message base.
  4498.                Available anonymity levels are:
  4499.  
  4500.                     (Y)es, anonymous allowed, selectively
  4501.                     (N)o, anonymous not allowed
  4502.                     (F)orced anonymous
  4503.                     (D)ear Abby
  4504.                     (A)ny Name
  4505.  
  4506.  
  4507.  
  4508.                                    - Page 69 -
  4509.  
  4510.                    Telegard Main Documentation - Version 2.5
  4511.  
  4512.  
  4513.                and are defined as follows:
  4514.  
  4515.                     (Y)es, anonymous allowed, selectively -- Anonymous
  4516.                           posts are allowed on the board on an optional
  4517.                          basis.  After a user has posted a message, it will
  4518.                          prompt for "save", then it will feed another
  4519.                          prompt "Post anonymous?".  If the caller enters
  4520.                          "Y", the message will be anonymous and will be
  4521.                          unviewable EXCEPT to users that satisfy the ACS
  4522.                          for the "see anonymous public posts" setting in
  4523.                          in the system configuration.
  4524.  
  4525.                     (N)o, anonymous not allowed -- Anonymous posts are NO
  4526.                          allowed on that base by ANY user, no matter what
  4527.                          SL level they have.
  4528.  
  4529.                     (F)orced Anonymous -- This automatically makes every
  4530.                          post on the base anonymous, but can be viewed by
  4531.                          users under the conditions stated above for the
  4532.                          (Y)es setting.
  4533.  
  4534.                     (D)ear Abby -- This is for a "Dear Abby" problem
  4535.                          solving message base.  A user may post a message
  4536.                          under ANY one of these three possibilities:
  4537.  
  4538.                               "Problemed User" -- Posted by a user with
  4539.                                    personal problems, who wants help, but
  4540.                                    wishes to remain anonymous.
  4541.  
  4542.                               "Abby" -- Allows another user to respond to a
  4543.                                    problem post, with anonymity.
  4544.  
  4545.                               User name and number -- Allows a caller to
  4546.                                    post a problem/suggestion under THEIR
  4547.                                    handle and user number.
  4548.  
  4549.                     (A)ny Name -- Allows users to post messages using
  4550.                          either their own user name and number OR anything
  4551.                          they like.
  4552.  
  4553.                For non-local bases, it is recommended that the anonymous
  4554.                level be set to "NO", as anonymous messages are frowned upon
  4555.                on most EchoMail and GroupMail conferences (also, standard
  4556.                FidoNet message files can't support anonymous messages).
  4557.  
  4558.           8    A security feature that, if activated, will prompt the user
  4559.                for a password which must be entered correctly in order to
  4560.                access that message base.
  4561.  
  4562.           C    Defines the colors used for standard text, quoted text,
  4563.                tear, and origin lines when EchoMail and GroupMail messages
  4564.                are tossed into the message base.  Refer to the "FidoNet
  4565.                Configuration" section in "System Configuration" for more
  4566.                information.  NOTE:  This option cannot be selected if the
  4567.                base is defined as Local.
  4568.  
  4569.  
  4570.  
  4571.                                    - Page 70 -
  4572.  
  4573.                    Telegard Main Documentation - Version 2.5
  4574.  
  4575.  
  4576.           M    Defines the various flag settings used when tossing,
  4577.                scanning, and posting EchoMail and GroupMail messages.  The
  4578.                currently available flags are:
  4579.  
  4580.                     K - Strip IFNA kludge lines.
  4581.                     S - Strip SEEN-BY lines (EchoMail only).
  4582.                     O - Strip origin lines.
  4583.                     C - Strip Telegard "center line" codes.
  4584.                     B - Strip Telegard "box line" codes.
  4585.                     M - Center boxed/centered lines with spaces.
  4586.                     T - Add tear and origin lines to posted messages.
  4587.  
  4588.                Refer to the "FidoNet Configuration" section in "System
  4589.                Configuration" for more information.  NOTE:  This option
  4590.                cannot be selected if the base is defined as Local.
  4591.  
  4592.           O    Defines the origin line placed at the bottom of EchoMail and
  4593.                GroupMail messages.  If an origin line is not defined here,
  4594.                the default origin line is used.  Refer to the "FidoNet
  4595.                Configuration" section in "System Configuration" for more
  4596.                information.  NOTE:  This option cannot be selected if the
  4597.                base is defined as Local.
  4598.  
  4599.           Q    Exits the message base editor.
  4600.  
  4601.      The last two fields are defined as follows:
  4602.  
  4603.           Flags -- Defined as follows:
  4604.  
  4605.                R - Real names only.
  4606.                U - Unhidden.
  4607.                A - Remove ANSI and 8-bit ASCII.
  4608.  
  4609.           P-Index -- The "permanent index" acts the same as the permanent
  4610.                index in the file system.  When a message base is created it
  4611.                is assigned the next highest index number and regardless of
  4612.                insertions, deletions, or movements of message boards, this
  4613.                number will stay the same.
  4614.  
  4615.      The flags are toggled with the following commands:
  4616.  
  4617.           R    If enabled, real names are stored in the "From:" and "To:"
  4618.                fields of each message, regardless of whether or not the
  4619.                BBS allows handles.  This is the preferred setting for Echo-
  4620.                Mail and GroupMail bases, as most conferences frown upon the
  4621.                use of handles (and some prohibit them outright).
  4622.  
  4623.           U    If enabled, it will display a message base in an area
  4624.                listing regardless of whether or not the user has access to
  4625.                that base.  If the user lacks access, it will show in the
  4626.                list with a name but no base number and it will be
  4627.                inaccessible.
  4628.  
  4629.           A    If enabled, ANSI codes and 8-bit ASCII characters (127-255)
  4630.                are removed from messages before they are posted.  (The
  4631.                enter ANSI sequence itself isn't removed; only the leading
  4632.  
  4633.  
  4634.                                    - Page 71 -
  4635.  
  4636.                    Telegard Main Documentation - Version 2.5
  4637.  
  4638.  
  4639.                ESC character is stripped.  This renders the rest of the
  4640.                sequence useless.  Also, ASCII character 127 is defined as
  4641.                DEL in the ASCII standard, which can cause problems for some
  4642.                systems.)  Enabling this option is recommended for EchoMail
  4643.                and GroupMail bases, as ANSI and 8-bit ASCII characters are
  4644.                usually prohibited to provide compatibility with non-IBM
  4645.                systems.
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.  
  4693.  
  4694.  
  4695.  
  4696.  
  4697.                                    - Page 72 -
  4698.  
  4699.                    Telegard Main Documentation - Version 2.5
  4700.  
  4701.  
  4702.                              _____________________
  4703.  
  4704.                               THE PROTOCOL EDITOR
  4705.                              _____________________
  4706.  
  4707.  
  4708.      The  protocol  editor  allows you to set up  different  protocols  for
  4709.      transferring  files.   The most common protocols  are  ASCII,  Xmodem,
  4710.      Ymodem  and  Zmodem;  they have already been set up  for  you  in  the
  4711.      protocol editor.  All you need to do is place the appropriate  program
  4712.      into any directory that is part of your DOS PATH statement.
  4713.  
  4714.      In order to enable the default protocols, you will need a copy of  the
  4715.      DSZ program.  It is available from most BBSes as "DSZnnnn.ZIP",  where
  4716.      "nnnn" is the release date.  Extract the DSZ.COM program, place it  in
  4717.      a directory contained in your PATH, and you'll be all set.
  4718.  
  4719.      The main screen of the protocol editor looks similar to the one  shown
  4720.      below:
  4721.      ______________________________________________________________________
  4722.  
  4723.       NNN:ACS       :Description
  4724.       ===:==========:======================================================
  4725.      +0              (Q) Quit - abort transfer
  4726.      +1              (Q) Quit - abort batch transfer
  4727.      +2              (Q) Quit - abort resume transfer
  4728.      +3              (B) Batch transfer
  4729.      +4              (N) Skip to next file
  4730.      +5              (A) ASCII
  4731.      +6              (X) Xmodem
  4732.      +7              (C) Xmodem-CRC
  4733.      +8              (Y) Ymodem
  4734.      +9              (Y) Ymodem batch
  4735.      +10             (Y) Ymodem resume
  4736.      +11             (Z) Zmodem
  4737.      +12             (Z) Zmodem batch
  4738.      +13             (Z) Zmodem resume
  4739.  
  4740.      Protocol editor (?=help) :
  4741.      ______________________________________________________________________
  4742.  
  4743.      The  commands available from this menu (displayed by pressing the  "?"
  4744.      key) are:
  4745.  
  4746.           <CR>Redisplay screen
  4747.           (D)elete protocol (I)nsert protocol
  4748.           (M)odify protocol (P)osition protocol
  4749.           (Q)uit
  4750.  
  4751.      and are detailed below:
  4752.  
  4753.           <CR>Redisplay screen -- Displays the menu again, in case
  4754.                something you wished to see scrolled off the screen.
  4755.  
  4756.           (D)elete protocol -- Removes an entry from the protocol list.
  4757.                You will be prompted for the entry number to delete.
  4758.  
  4759.  
  4760.                                    - Page 73 -
  4761.  
  4762.                    Telegard Main Documentation - Version 2.5
  4763.  
  4764.  
  4765.           (I)nsert protocol -- Inserts a new entry in the protocol list.
  4766.                You will be prompted for the entry number that the new entry
  4767.                should be inserted before, and the number of new entries to
  4768.                insert.
  4769.  
  4770.           (M)odify protocol -- Allows you to change an entry in the
  4771.                protocol list.  Details on modifying entries are given
  4772.                later.
  4773.  
  4774.           (P)osition protocol -- Moves an entry from one position to
  4775.                another.  You will be prompted for the entry number to move
  4776.                and the entry number that it will precede.
  4777.  
  4778.           (Q)uit -- Exits the protocol editor.
  4779.  
  4780.      When  you  select the (M)odify command, you will be prompted  for  the
  4781.      entry number to modify.  After you make your selection, a menu similar
  4782.      to the following example will be displayed:
  4783.      ______________________________________________________________________
  4784.  
  4785.      Protocol #11 of 24
  4786.      !. Type/protocl:Active - Batch protocol
  4787.      1. Keys/descrip:"Z" / "(Z) Zmodem"
  4788.      2. ACS required: ""
  4789.      3. Temp. log   : "%C\dsztemp.log"
  4790.      4. <U>L log    : "%C\xfer.log"
  4791.         <D>L log    : "%C\xfer.log"
  4792.      5. <U>L command: "dsz port %P speed %B rz"
  4793.         <D>L command: "dsz port %P speed %B sz @%L"
  4794.      6. Codes mean  :Transfer bad
  4795.      7. <U>L codes  :(1)""    (2)""    (3)""    (4)""    (5)""    (6)""
  4796.         <D>L codes  :(1)"E"   (2)"e"   (3)"L"   (4)"l"   (5)""    (6)""
  4797.      E. Environ. cmd: "set DSZLOG=%T"
  4798.      I. DL File list: "%C\fi.lst"
  4799.      C. Max DOS chrs:128   P. Log position: Filename: 51 - Status: 1
  4800.  
  4801.      Edit menu (?=help) :
  4802.      ______________________________________________________________________
  4803.  
  4804.      Notice  that  some  of the strings in the above example  have  a  "%x"
  4805.      sequence  of characters.  These are special protocol codes,  and  they
  4806.      are defined as follows:
  4807.  
  4808.           %B        Specifies the current baud rate, as a string of ASCII
  4809.                     digits ("300", "1200", "2400", etc.).
  4810.  
  4811.           %C        Specifies the pathname of the main BBS directory.  Note
  4812.                     that a backslash ("\") is NOT automatically appended,
  4813.                     so it will have to be specified if necessary.
  4814.  
  4815.           %F        Specifies the filename(s) to be transferred.  In the
  4816.                     case of a batch transfer, this MCI indicates where
  4817.                     multiple filenames may be inserted, up to the allowable
  4818.                     length of the command line (defined in option C,
  4819.                     below).
  4820.  
  4821.  
  4822.  
  4823.                                    - Page 74 -
  4824.  
  4825.                    Telegard Main Documentation - Version 2.5
  4826.  
  4827.  
  4828.           %L        Specifies the name of the file that contains a list of
  4829.                     filenames to be batch downloaded (defined in option I,
  4830.                     below).
  4831.  
  4832.           %T        Specifies the name of the transfer result temporary log
  4833.                     file (defined in option 3, below).
  4834.  
  4835.      Note  that all protocol code MUST BE SPECIFIED IN UPPER CASE, or  they
  4836.      will  NOT work!  These codes are shown on the video display using  MCI
  4837.      color #3 (bright cyan in the default setup).
  4838.  
  4839.      The  commands available from this menu (displayed by pressing the  "?"
  4840.      key) are:
  4841.  
  4842.            #:Modify item   <CR>Redisplay screen
  4843.           ([)Back entry    (])Forward entry
  4844.           (J)ump to entry  (F)irst entry in list
  4845.           (Q)uit and save  (L)ast entry in list
  4846.  
  4847.      and are described below:
  4848.  
  4849.           <CR>Redisplay screen -- Redisplays the menu.
  4850.  
  4851.           ([)Back entry -- Moves the pointer to the previous entry in the
  4852.                protocol list.  If the pointer is at the first entry, this
  4853.                command is ignored.
  4854.  
  4855.           (])Forward entry -- Moves the pointer to the next entry in the
  4856.                protocol list.  If the pointer is at the last entry, this
  4857.                command is ignored.
  4858.  
  4859.           (J)ump to entry -- This command moves the pointer to the user
  4860.                specified entry in the protocol list.  You will be prompted
  4861.                for the entry number to move to.
  4862.  
  4863.           (F)irst entry in list -- Moves the pointer to the first entry in
  4864.                the protocol list.
  4865.  
  4866.           (L)ast entry in list -- Moves the pointer to the last entry in
  4867.                the protocol list.
  4868.  
  4869.           (Q)uit and save -- Saves the current protocol list and returns to
  4870.                the main protocol editor menu.
  4871.  
  4872.      In  addition, you can modify any of the entries shown on  the  screen.
  4873.      They are defined as follows:
  4874.  
  4875.           !    This option allows you to define the type and availability
  4876.                of the current protocol.  The protocol can be enabled,
  4877.                disabled or set to one of the following types:
  4878.  
  4879.                     Single - The protocol will only transfer a single file.
  4880.  
  4881.                     Batch - The protocol will transfer multiple files with
  4882.                          one command.
  4883.  
  4884.  
  4885.  
  4886.                                    - Page 75 -
  4887.  
  4888.                    Telegard Main Documentation - Version 2.5
  4889.  
  4890.  
  4891.                     Resume - The protocol will transfer one file, and
  4892.                          resume the transfer where it left off (if the
  4893.                          previous transfer was aborted).  For example,
  4894.                          DSZ.COM support Ymodem and Zmodem resume
  4895.                          transfers.
  4896.  
  4897.           1    This option defines the command keys required to select the
  4898.                protocol and a description that will be displayed when a
  4899.                list of protocols is requested.  The description may contain
  4900.                MCI color codes.
  4901.  
  4902.           2    This option defines the ACS requirements that the user must
  4903.                satisfy in order to use the protocol.
  4904.  
  4905.           3    This option defines the name of the file that holds the
  4906.                result log of a file transfer operation.  This temporary log
  4907.                is then used to build the permanent result logs (defined in
  4908.                option 4) and to determine the transfer status after a batch
  4909.                transfer.  Note that not all protocol drivers support a
  4910.                result log.
  4911.  
  4912.           4    This option defines the names of the permanent result log
  4913.                files for both upload and download operations.  Data from
  4914.                the temporary result log file (defined in option 3) are used
  4915.                to build these permanent logs.  Separate log files can be
  4916.                specified for upload and download operations, or a common
  4917.                log file can be used.
  4918.  
  4919.           5    This option defines the commands required to perform file
  4920.                uploading and downloading.  When selected, you will be asked
  4921.                which command (upload or download) to define.  Then, you are
  4922.                asked what type of command it will be.  The four different
  4923.                types are defined as follows:
  4924.  
  4925.                     (A)SCII -- The protocol is used for pure ASCII file
  4926.                          transfers.  In this event, almost all other
  4927.                          options for this protocol (transfer logs, result
  4928.                          codes, etc.) are ignored, as they aren't needed.
  4929.  
  4930.                     (C)ommand -- The entry is assigned to a special
  4931.                          function.  The two functions available are:
  4932.  
  4933.                          Batch -- The entry will not actually transfer a
  4934.                               file, but instead will add the file to the
  4935.                               batch transfer queue.
  4936.  
  4937.                          Next -- The selected file is skipped and the next
  4938.                               file (if a wildcard operation is being
  4939.                               performed) is selected.
  4940.  
  4941.                     (E)xternal -- Allows you to define the actual DOS
  4942.                          command line used in conjunction with the protocol
  4943.                          driver.  Refer to the above list of protocol MCIs
  4944.                          and the documentation for the protocol driver to
  4945.                          create the command necessary to perform the file
  4946.                          transfer.  (Note that the upload command should be
  4947.  
  4948.  
  4949.                                    - Page 76 -
  4950.  
  4951.                    Telegard Main Documentation - Version 2.5
  4952.  
  4953.  
  4954.                          defined with the protocol driver's "receive file"
  4955.                          option, and the download command should be defined
  4956.                          with the driver's "send file" option.)
  4957.  
  4958.                     (O)ff -- Disables that particular function for the
  4959.                          protocol.  This may be necessary on some protocol
  4960.                          drivers that, for example, allow batch transfers
  4961.                          in one direction but not the other (Ymodem batch,
  4962.                          for example; batch downloading is permitted, but
  4963.                          not batch uploading).
  4964.  
  4965.           6    This option toggles the meaning of the error result codes
  4966.                defined in option 7 (below).  The meaning can be set to
  4967.                "transfer okay" or "transfer bad", depending on the
  4968.                requirements of the protocol driver.
  4969.  
  4970.           7    This option defines the error result codes (for both
  4971.                uploading and downloading) returned by the protocol driver
  4972.                after completing transmission of a file.  Since some drivers
  4973.                can return more than one result code upon completion of a
  4974.                successful (or unsuccessful) operation, up to six codes can
  4975.                be defined.  If there are less than six, fill the remaining
  4976.                entries with a duplicate code (for example, most drivers
  4977.                return only a single value, zero, when an operation is
  4978.                successful; thus, all six entries would contain "0").
  4979.                Telegard will use these codes to determine the success or
  4980.                failure of a transfer operation.
  4981.  
  4982.                If you have defined a result log file, this option defines
  4983.                the strings that Telegard should compare when determining
  4984.                if a batch transfer is successful.  (This is used in
  4985.                conjunction with option P, below.)
  4986.  
  4987.           E    This option defines the command that sets up an environment
  4988.                string, for protocol drivers that require environment
  4989.                variables to be set up in certain ways.  For example, "SET
  4990.                DSZLOG=%T" would set the DSZ.COM temporary result log
  4991.                filename to the name defined in option 3.  If no environment
  4992.                setup is necessary, this string should be set to NULL ("").
  4993.  
  4994.                *IMPORTANT*:   IF YOU DEFINE AN ENVIRONMENT SETUP COMMAND
  4995.                               WITH THIS OPTION, MAKE SURE THAT IT IS ALSO
  4996.                               DEFINED IN YOUR AUTOEXEC.BAT FILE, OR FILE
  4997.                               TRANSFERS WILL NOT WORK PROPERLY!  (For
  4998.                               example, if you have the result log filename
  4999.                               set to "%C\dsztemp.log", and this option set
  5000.                               to "SET DSZLOG=%T", place "SET DSZLOG=
  5001.                               C:\BBS\DSZTEMP.LOG" in your AUTOEXEC.BAT
  5002.                               file.  Naturally, you should use the name of
  5003.                               your main BBS directory if it's not C:\BBS.)
  5004.  
  5005.           I    This option defines the name of a file in which Telegard
  5006.                will store the filenames to be transferred in a batch
  5007.                upload operation (for those programs that require it, as
  5008.                opposed to specifying the names of the files directly on the
  5009.                command line).  If a file list file is not required, this
  5010.  
  5011.  
  5012.                                    - Page 77 -
  5013.  
  5014.                    Telegard Main Documentation - Version 2.5
  5015.  
  5016.  
  5017.                string should be set to NULL ("").
  5018.  
  5019.           C    This option defines the maximum number of characters allowed
  5020.                on the DOS command line.  The default is 128, which is the
  5021.                normal amount allowed by DOS.  Some DOS enhancement
  5022.                programs, however, allow for more characters on a command
  5023.                line.  If you are using one of these enhancement programs,
  5024.                you may wish to modify this field to contain the number of
  5025.                characters allowed by the enhancement program.
  5026.  
  5027.           P    This option defines the positions, on a single line of the
  5028.                temporary result log, of the filename and return status
  5029.                (starting from position #1).  If no temporary result log is
  5030.                defined, then these values are ignored.  This is used (in
  5031.                conjunction with option 7, above) to determine the status of
  5032.                batch transfer operations.
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.  
  5041.  
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047.  
  5048.  
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  
  5055.  
  5056.  
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.  
  5065.  
  5066.  
  5067.  
  5068.  
  5069.  
  5070.  
  5071.  
  5072.  
  5073.  
  5074.  
  5075.                                    - Page 78 -
  5076.  
  5077.                    Telegard Main Documentation - Version 2.5
  5078.  
  5079.  
  5080.                                _________________
  5081.  
  5082.                                 THE MENU EDITOR
  5083.                                _________________
  5084.  
  5085.  
  5086.      Telegard's  menu system is the base of the entire system's  structure;
  5087.      almost  every  command that a user will ever enter  can  be  modified,
  5088.      added to, and deleted from your BBS with the use of the menu editor.
  5089.  
  5090.      The menu system is broken up into individual menu FILES, each of which
  5091.      define  the different menus of your system.  The menu files all  exist
  5092.      in  your  MENUS directory, and all have the file extension  of  "MNU".
  5093.      One  advantage  of having a multiple menu-file system, over  a  single
  5094.      menu-file  system,  is  that other people who  write  Telegard  add-on
  5095.      utilities, such as online doors, can include the menu file with  their
  5096.      programs, minimizing the total amount of work necessary on the SysOp's
  5097.      part.
  5098.  
  5099.  
  5100.      --------------------
  5101.      THE MAIN EDITOR MENU
  5102.      --------------------
  5103.  
  5104.      Upon  entry  to the Menu Editor, you will be presented with  a  screen
  5105.      similar to the following (compressed slightly to fit onto the page):
  5106.      ______________________________________________________________________
  5107.  
  5108.      Telegard Menu Editor
  5109.  
  5110.       Directory of  C:\BBS\MENUS\*.mnu
  5111.  
  5112.      ARCHIVE  MNU  AUTO     MNU  BATCH    MNU  BBSLIST  MNU  FILE     MNU
  5113.      GOODBYE  MNU  MAIN     MNU  MSG      MNU  ONLINE   MNU  PERSONAL MNU
  5114.      SHUTTLE  MNU  SYSOP    MNU
  5115.             12 File(s)    nnnnnn bytes free
  5116.  
  5117.      Menu editor (?=help) :
  5118.      ______________________________________________________________________
  5119.  
  5120.      The commands available at this screen are:
  5121.  
  5122.           (D)elete menu file - This command allows you to erase any of the
  5123.                *.MNU files in the MENUS directory.
  5124.  
  5125.           (I)nsert menu file - This command will generate a new *.MNU file
  5126.                in the MENUS directory with just one menu command on it, all
  5127.                ready to be used.
  5128.  
  5129.           (M)odify menu file - This is where you get to load in one of the
  5130.                *.MNU files and modify the menu commands and structure of
  5131.                the menu.
  5132.  
  5133.           (Q)uit - Exits the menu editor.
  5134.  
  5135.  
  5136.  
  5137.  
  5138.                                    - Page 79 -
  5139.  
  5140.                    Telegard Main Documentation - Version 2.5
  5141.  
  5142.  
  5143.      When you execute the (M)odify command, you will be asked for the  menu
  5144.      to  modify.  In this case, we are using the main menu ("MAIN")  as  an
  5145.      example.   When you enter the name of the menu, the following menu  is
  5146.      displayed (again, compressed to fit onto the page):
  5147.      ______________________________________________________________________
  5148.  
  5149.      Modifying menu: MAIN
  5150.  
  5151.      NN KK-Typ-MString         NN KK-Typ-MString         NN KK-Typ-MString
  5152.      -- ---------------------- -- ---------------------- -- ---------------
  5153.      1  *  -/  sysop           10 N  ME  1               19 Y  OY
  5154.      2  A  -/  auto            11 O  -/  goodbye         20 .  -/  online
  5155.      3  B  -/  bbslist         12 /O HM                  21 $  O$  60;600
  5156.      4  C  OC  1               13 P  -/  personal        22 !  MA  17
  5157.      5  I  OI                  14 S  OS                  23 !  -/  md
  5158.      6  F  -^  file            15 T  -S  *> Entered TFil 24 CLE-^  main;C
  5159.      7  H  OM                  16 T  OT                  25 XXXDD  activity
  5160.      8  L  -F  user.log        17 V  OV
  5161.      9  M  -^  msg             18 X  OP  22
  5162.  
  5163.      Menu editor (?=help) : ?
  5164.      ______________________________________________________________________
  5165.  
  5166.      In  this display, the command number ("NN"), the keys used to  execute
  5167.      the  command  by users ("KK"), the type of command  ("Typ"),  and  the
  5168.      command  data  ("MString") are all displayed at once.   Other  display
  5169.      formats are available, and are explained later on in this section.
  5170.  
  5171.      The following are descriptions of the commands available here:
  5172.  
  5173.           (D)elete command - Removes one of the menu commands from the
  5174.                current menu loaded.  There is a 50 command limitation for
  5175.                each menu, so get into the habit of deleting commands that
  5176.                are no longer useful.
  5177.  
  5178.           (I)nsert command - Inserts new menu commands somewhere in the
  5179.                menu.  It is possible to insert more than one menu command
  5180.                at once using this option, rather than repeating the same
  5181.                (I)nsert sequence several times.
  5182.  
  5183.           (L)ong generic menu - Displays how the current menu's generic
  5184.                tutorial looks currently.  An alternative to repeatedly
  5185.                modifying the menu, exiting the menu-editor, looking at the
  5186.                menu, re-entering the menu, etc, etc.
  5187.  
  5188.           (M)odify commands - This command allows you to modify the menu
  5189.                command information of a menu command in the current menu,
  5190.                whether newly created or old.  Menu modification is
  5191.                discussed in detail later.
  5192.  
  5193.           (P)osition menu commands - This command allows you to rearrange
  5194.                the order of the menu commands on the menu.  Although useful
  5195.                for linking commands (see the special section on linking
  5196.                commands), it is *especially* useful for making a good,
  5197.                finished product out of your generic menus (if you use
  5198.                them).
  5199.  
  5200.  
  5201.                                    - Page 80 -
  5202.  
  5203.                    Telegard Main Documentation - Version 2.5
  5204.  
  5205.  
  5206.           (S)hort generic menu - Shows how the current menu's normal
  5207.                generic menu looks currently.  Again, as with the (L)ong
  5208.                command, it is a speed alternative to repeatedly exiting the
  5209.                menu editor to check how the menu looks after each
  5210.                modification.
  5211.  
  5212.           (T)oggle display type - There are two formats which Telegard will
  5213.                use to output the listing of menu commands on the current
  5214.                menu; this command is used to toggle between the two.  One
  5215.                of them is shown up above; it is more concise, and takes up
  5216.                less space than the alternate one (which is more
  5217.                descriptive).
  5218.  
  5219.           (X)Menu data/command data display mode toggle - Toggles between
  5220.                either of the two menu command list modes in (T), and
  5221.                another, separate list of information about the current menu
  5222.                (which is described in detail later).
  5223.  
  5224.      -------------------------
  5225.      MENU COMMAND MODIFICATION
  5226.      -------------------------
  5227.  
  5228.      When you execute the (M)odify command, you will be asked which command
  5229.      to modify.  After you enter the command number, the following menu  is
  5230.      displayed:
  5231.      ______________________________________________________________________
  5232.  
  5233.      Menu filename: MAIN
  5234.      Command #1 of 25
  5235.  
  5236.      1. Long descript :(*)SysOp Menu - Perform system maintenance
  5237.      2. Short descript:(*)SysOp Menu
  5238.      3. Cmd letters   :*
  5239.      4. ACS required  :"s200"
  5240.      5. Cmdkeys       :-/
  5241.      6. MString       :sysop
  5242.      7. Flags         :None
  5243.      Q. Quit
  5244.  
  5245.      Edit menu: (1-8,[,],F,J,L,Q,?) :
  5246.      ______________________________________________________________________
  5247.  
  5248.      This  is probably starting to get confusing right about now!   If  you
  5249.      ARE  getting confused, don't worry; you'll understand it soon  enough,
  5250.      after  a  little  usage.  From here, the  following  modification  and
  5251.      movement commands are available:
  5252.  
  5253.           1    This field stores a long description of the menu command,
  5254.                used when listing a generic tutorial of the current menu.
  5255.  
  5256.           2    This field stores a shorter description of the menu command,
  5257.                and is used when the BBS generates a generic menu.  If the
  5258.                short description is longer than the column size of the
  5259.                generic menu, the description is shortened to fit neatly
  5260.                into the space allocated to it.  A large sized description
  5261.                field is provided to allow the SysOp to put whatever kind of
  5262.  
  5263.  
  5264.                                    - Page 81 -
  5265.  
  5266.                    Telegard Main Documentation - Version 2.5
  5267.  
  5268.  
  5269.                colors he wants into it (color changes take up two
  5270.                characters each in this and ALL strings).
  5271.  
  5272.           3    This is the actual string that the user enters when he wants
  5273.                to execute the command.  If the command letters field has
  5274.                only one character in it, the command will be executed
  5275.                immediately after the user presses the one character; he
  5276.                need not even press [ENTER] afterwards.
  5277.  
  5278.                If the first character of the command letters is a slash
  5279.                character ("/"), the command letters must be two characters
  5280.                in length.  The user must enter the slash character ("/"),
  5281.                and the second character of the command letters to execute
  5282.                the command.  After that, [ENTER] does not need to be
  5283.                pressed; the command automatically continues.  For example:
  5284.                if the command letters are "/O", the user must enter "/O",
  5285.                but does NOT need to press [ENTER].
  5286.  
  5287.                If the command letters have more than one character in them,
  5288.                and the first character of the command letters is NOT a
  5289.                slash character ("/"), the user must enter two slashes in a
  5290.                row ("//"), and then the rest of the command, and press
  5291.                [ENTER].  For example, if the command letters are "YELL",
  5292.                the user must enter "//YELL", and then press [ENTER].
  5293.  
  5294.           4    This is the ACS requirement that the user must satisfy in
  5295.                order to have access to the command.  You may set up two or
  5296.                more menu entries to execute different menu commands for
  5297.                opposite or varying access conditions (see the section on
  5298.                linking commands).
  5299.  
  5300.           5    This is the type of command to be executed.  A full
  5301.                explanation of EVERY possible type of menu command is in the
  5302.                "Menu System Commands" section.  This field must be two
  5303.                characters long, or nothing will be executed.
  5304.  
  5305.           6    This string contains miscellaneous command-particular
  5306.                information; each command uses this information differently.
  5307.                The MString used by each command is defined alongside the
  5308.                command keys in the "Menu System Commands" section, along
  5309.                with a short 5-10 line description of the command, what it
  5310.                does, and what all is possible with it.
  5311.  
  5312.           7    There are several functions for each command which may be
  5313.                flagged on or off according to how they should be set up.
  5314.                When you press the "7" key from this section, the following
  5315.                flags can be changed:
  5316.  
  5317.                     (H)idden command - This makes the command "hidden".
  5318.                          This means that whether the user has access to the
  5319.                          command or not, the command will NEVER be
  5320.                          displayed on ANY generic menu.
  5321.  
  5322.                     (U)nhidden command - This makes the command "unhidden".
  5323.                          This means that the command will always be
  5324.                          displayed to all users on any generic menus,
  5325.  
  5326.  
  5327.                                    - Page 82 -
  5328.  
  5329.                    Telegard Main Documentation - Version 2.5
  5330.  
  5331.  
  5332.                          whether they have access to the command or not.
  5333.                          If they do not have access to it, the command
  5334.                          letters are displayed in generic color #1 (the
  5335.                          same color as the surrounding brackets).
  5336.  
  5337.                Note that if neither flag is set, the default method
  5338.                (display the command if the user has access to it, and hide
  5339.                the command if the user doesn't) is used.  If *BOTH* flags
  5340.                are set, the results are unpredictable!
  5341.  
  5342.           [    Displays the previous menu command.  If at the first
  5343.                command, this command does nothing.
  5344.  
  5345.           ]    Displays the next menu command.  If at the last command,
  5346.                this command does nothing.
  5347.  
  5348.           F    Displays the first menu command.
  5349.  
  5350.           J    Displays the specified menu command.
  5351.  
  5352.           L    Displays the last menu command.
  5353.  
  5354.  
  5355.      -----------------------------
  5356.      MENU INFORMATION MODIFICATION
  5357.      -----------------------------
  5358.  
  5359.      When  you execute the "X" command at the main editor menu, you  switch
  5360.      the display to show the other menu information:
  5361.      ______________________________________________________________________
  5362.  
  5363.      Menu filename: MAIN
  5364.      1. Menu name     :**> Telegard Bulletin Board System <**
  5365.                       :Main Menu
  5366.      2. Help files    :MAIN@S / *Generic*
  5367.      3. Prompt        :^4Time Left: [^3@T^4] (^3?^4=^3help^4)@M^4Main Menu
  5368.      ^2:^6
  5369.      (Time Left: [01:00:00] (?=help)
  5370.      Main Menu :)
  5371.      4. ACS required  :""
  5372.      5. Password      :*None*
  5373.      6. Fallback menu :MAIN
  5374.      7. Forced ?-level:None
  5375.      8. Generic info  :4 cols - 3/5/4
  5376.      9. Flags         :-----
  5377.      Q. Quit
  5378.  
  5379.      Menu editor (?=help) :
  5380.      ______________________________________________________________________
  5381.  
  5382.      The following commands are available from this menu:
  5383.  
  5384.           1    This field contains a description of the current menu
  5385.                (example: "Telegard BBS Main Menu").  One to three
  5386.                description lines can be defined.
  5387.  
  5388.  
  5389.  
  5390.                                    - Page 83 -
  5391.  
  5392.                    Telegard Main Documentation - Version 2.5
  5393.  
  5394.  
  5395.           2    This command inputs the TWO filenames which make up the
  5396.                menus of your menu system.  The generic menus are specified
  5397.                in EITHER case by setting the strings to NULL ("").  NEITHER
  5398.                filename should have a file extension.  Telegard
  5399.                automatically searches for and displays MSG, 40C, ANS, or
  5400.                ANx, depending on the situation at hand (the user's
  5401.                account).
  5402.  
  5403.                The first filename is the NORMAL help display, and the
  5404.                second filename is the tutorial help display.  If a "@S"
  5405.                occurs in either of these two filenames, it is replaced with
  5406.                the current user's SL, and THAT file is displayed.  If that
  5407.                file is not found, the "@S" is taken out and THAT is
  5408.                displayed.  If that file is still not present, a generic
  5409.                menu is displayed.  Example:  The filename is "MAIN@S", and
  5410.                the user's SL is 60.  If MAIN60.* does not exist, and MAIN.*
  5411.                does not exist, a generic menu will be displayed.
  5412.  
  5413.                Note that tutorial menus can be turned off entirely on any
  5414.                menu by entering the string "*OFF*" (without quotes) as the
  5415.                tutorial filename.
  5416.  
  5417.           3    This field contains the actual menu prompt that is displayed
  5418.                before it will accept commands from the user online.  It can
  5419.                be up to 120 characters long, allowing many SysOp's to
  5420.                design VERY creative prompt strings.  Prompt MCI is
  5421.                available in this field.
  5422.  
  5423.           4    This is the ACS requirement that the user must satisfy in
  5424.                order to access the menu.  If the user does not have access,
  5425.                and he/she enters the menu, they will be sent back to the
  5426.                fallback menu (specified by option 6).
  5427.  
  5428.           5    If a menu has a password attached to it and a user attempts
  5429.                to enter the menu in any way, the password will be prompted
  5430.                for.  If correctly entered, the user enters the menu;
  5431.                otherwise, the fallback menu is loaded.
  5432.  
  5433.           6    This is a legal menu file which is loaded whenever the user
  5434.                does not have access to the current menu (see options 4 and
  5435.                5) or some type of critical menu error occurs.
  5436.  
  5437.           7    The help level setting that is forced when the user enters
  5438.                the menu.  The help levels are:
  5439.  
  5440.                     0 -- No help level forcing.
  5441.                     1 -- Expert level (only the prompt is shown).
  5442.                     2 -- Normal level (the normal menu, or the short
  5443.                               generic menu, is displayed).
  5444.                     3 -- Novice level (the tutorial menu, or the long
  5445.                               generic menu, is displayed).
  5446.  
  5447.           8    This entry includes all the information that is used to
  5448.                generate the generic menus.  The number of columns to use,
  5449.                and the three colors used to colorize the menu command
  5450.                descriptions, are included here.
  5451.  
  5452.  
  5453.                                    - Page 84 -
  5454.  
  5455.                    Telegard Main Documentation - Version 2.5
  5456.  
  5457.  
  5458.           9    There are several functions for each menu that may be
  5459.                flagged on or off.  The available flags are:
  5460.  
  5461.                     (C)lear screen before menu - This tells Telegard to
  5462.                          clear the screen every time the normal generic
  5463.                          menu or generic tutorial menu is displayed.  It
  5464.                          should be used in conjunction with the "(P)Force
  5465.                          pause before menu display" toggle, so that user
  5466.                          gets a chance to see important information before
  5467.                          the screen clears if he/she is not in expert mode.
  5468.  
  5469.                     (D)on't center the menu titles - This tells Telegard to
  5470.                          leave the menu titles uncentered (i.e. left
  5471.                          justified).  This ONLY affects the three menu
  5472.                          titles at the top, not any of the Generic sub
  5473.                          titles.
  5474.  
  5475.                     (N)o menu prompt toggle - This can be used if you want
  5476.                          to put the menu prompt for the menu RIGHT IN
  5477.                          THE .MSG OR .ANS file.  Telegard will not display
  5478.                          any menu prompt whatsoever, and will totally
  5479.                          ignore the current menu prompt, whatever it is.
  5480.  
  5481.                     (P)Force pause before menu display - The screen will be
  5482.                          paused before the menu is displayed, if this
  5483.                          option is toggled on.  This allows the user to see
  5484.                          information from the previous command entered, if
  5485.                          the menu clears the screen.
  5486.  
  5487.                     (T)Auto-time display toggle - If this is set to ON, a
  5488.                          "time-left" string will be inserted DIRECTLY
  5489.                          before the prompt of the current menu.  The format
  5490.                          is as follows:
  5491.  
  5492.                               "[<Time Left - HH:MM:SS>]"
  5493.  
  5494.                          Many people find it more desirable to use the @T
  5495.                          MCI command to insert a HH:MM:SS type format time
  5496.                          left string into their menu-prompt, being able to
  5497.                          customize the system even further.
  5498.  
  5499.  
  5500.      ----------------------------
  5501.      SPECIAL GLOBAL MENU COMMANDS
  5502.      ----------------------------
  5503.  
  5504.      There are several internal commands that may be used from ANY menu  on
  5505.      the BBS (excepting the shuttle logon menu, SHUTTLE.MNU); their command
  5506.      letters therefore cannot be used in any menu command.  These  commands
  5507.      are:
  5508.  
  5509.           ?         Pressing "?" will ALWAYS get help on ANY menu.
  5510.                     Pressing it will raise the help level of the user by
  5511.                     one.  Since there are only three help levels, pressing
  5512.                     it at the third one has no effect.  Help level 1 is
  5513.                     where no help whatsoever is displayed (expert mode).
  5514.  
  5515.  
  5516.                                    - Page 85 -
  5517.  
  5518.                    Telegard Main Documentation - Version 2.5
  5519.  
  5520.  
  5521.                     Help level 2 is where the main help is displayed
  5522.                     (normal mode).  Help level 3 is when the tutorial help
  5523.                     is displayed (novice mode).  Hitting [ENTER] will drop
  5524.                     the help level down to the user's normal level again.
  5525.                     Available to all users.
  5526.  
  5527.           =         This command will display a list of ALL the menu
  5528.                     commands on the current menu loaded, and the contents
  5529.                     of the current menu "stack" (used by the "-/", "-\",
  5530.                     and "-^" menu commands).  Available only to users with
  5531.                     Co-SysOp access or higher.
  5532.  
  5533.           |         This command will display the current version info, the
  5534.                     date the BBS.EXE and BBS.OVR files were last compiled
  5535.                     on by the authors, and the registration information, if
  5536.                     available.  Available to all users.
  5537.  
  5538.           //\\      When these characters precede a command, the rest of
  5539.                     the command is executed just like a normal menu
  5540.                     command; the command keys are the first two characters
  5541.                     immediately afterwards, and the rest of the command is
  5542.                     the MString of the command.  For example, "//\\OC1;WHY
  5543.                     DO YOU WANT TO CHAT?!" would execute the Chat menu
  5544.                     command, with chat-reason question "WHY DO YOU WANT TO
  5545.                     CHAT?!", sending mail to user #1 if the SysOp does not
  5546.                     respond to the call.  Available only to users with SL
  5547.                     255.
  5548.  
  5549.           ;         When the ";" character is pressed, the rest of the
  5550.                     command is treated as a command macro.  Every other
  5551.                     occurrence of ";" in the command is replaced with a
  5552.                     <CR>.  For example, entering ";MPThis is a test;SysOp;"
  5553.                     from the main or file menus would ("M") enter the
  5554.                     message menu, ("P") post a message, ("This is a test")
  5555.                     enter the subject of the message, (";") include a <CR>
  5556.                     at the end, and "address" the message to "All" (the
  5557.                     last ";").
  5558.  
  5559.  
  5560.      -------------------------
  5561.      THE HELP-FILE MENU SYSTEM
  5562.      -------------------------
  5563.  
  5564.      Telegard  has  a  VERY  complicated way of  displaying  text  files  -
  5565.      particularly  the menus.  Here is a list of possible  file  extensions
  5566.      and their meanings:
  5567.  
  5568.           MSG       Contains Telegard color codes.  Displayed with colors
  5569.                     to those who have ANSI, but with NO color to those
  5570.                     without ANSI.
  5571.  
  5572.           40C       Displayed to users with less than 80 column screen
  5573.                     displays.
  5574.  
  5575.           ANS       Displayed to those users who have ANSI.
  5576.  
  5577.  
  5578.  
  5579.                                    - Page 86 -
  5580.  
  5581.                    Telegard Main Documentation - Version 2.5
  5582.  
  5583.  
  5584.           AN1-AN9   If a file with an extension of AN1 exists, Telegard
  5585.                     will RANDOMLY pick and display a file somewhere in the
  5586.                     range of <ANS, AN1-AN9>.  For example, if WELCOME.ANS,
  5587.                     WELCOME.AN1, and WELCOME.AN2 all exist, Telegard will
  5588.                     randomly choose one of them to display when WELCOME.*
  5589.                     needs to be displayed by the system.
  5590.  
  5591.           A0S-A6S   These ANSIs are displayed on different days of the
  5592.                     week, ranging from 0:Sunday to 6:Saturday.  They can be
  5593.                     used in conjunction with the random ANSIs, too.  (For
  5594.                     example, WELCOME.A01 means the first (1) random ANSI
  5595.                     displayed on Sundays).  Don't worry if this system
  5596.                     seems to be too complicated.  A better system is on the
  5597.                     way.
  5598.  
  5599.      The  above is what is meant whenever you see something like  WELCOME.*
  5600.      or  SL50.*,  etc.   Telegard  will search  for  any  of  these  highly
  5601.      specialized files, depending on the user's account.
  5602.  
  5603.      Therefore,  the  menu system can be VERY complicated if  you  want  to
  5604.      provide for all of the possibilities.  It doesn't end THERE,  however!
  5605.      Security-sensitive  menus are possible through Telegard.  In the  help
  5606.      filename  configuration  of the menus, you can specify a  "@S"  to  be
  5607.      replaced  with the user's SL, and displayed.  If their  particular  SL
  5608.      file does not exist, it will display a common one, which replaces "@S"
  5609.      with a null string (i.e. "MAIN@S" would become "MAIN").  You can  have
  5610.      a  MSG, 40C, and 10 ANSI text files for EACH of the  security  levels!
  5611.      While  it's doubtful all these options will ever be used all at  once,
  5612.      they  provide  some real interesting configuration abilities  for  the
  5613.      system.
  5614.  
  5615.      The  following  is  an  explanation of  what  goes  on  under  several
  5616.      different  conditions,  for a sample configuration of the  main  menu.
  5617.      Here's the logic of this, if a user with ANSI and 255 SL is on and the
  5618.      main menu file is set to "MAIN@S":
  5619.  
  5620.           If (MAIN255.ANS exists) then
  5621.           {
  5622.                If (MAIN255.AN1 exists) then
  5623.                {
  5624.                     The system chooses a random MAIN255.AN?, where "?" is
  5625.                     either an "S" or "1"-"9".
  5626.                }
  5627.                Otherwise
  5628.                     MAIN255.ANS is displayed.
  5629.           }
  5630.           Otherwise
  5631.                If (MAIN255.MSG exists) then
  5632.                     MAIN255.MSG is displayed
  5633.                Otherwise
  5634.                {
  5635.                     It repeats the ENTIRE process again, searching this
  5636.                     time for MAIN.*.  If no files were found THEN, it will
  5637.                     display a generic menu.
  5638.                }
  5639.  
  5640.  
  5641.  
  5642.                                    - Page 87 -
  5643.  
  5644.                    Telegard Main Documentation - Version 2.5
  5645.  
  5646.  
  5647.      -----------------------
  5648.      THE GENERIC MENU SYSTEM
  5649.      -----------------------
  5650.  
  5651.      The  generic menu system in Telegard is just another name for a  self-
  5652.      generated  menu system.  Telegard will automatically generate its  own
  5653.      help  menus  in two cases: if the menu help files specified  the  menu
  5654.      editor do not already exist, or if the SysOp explicitly uses the  menu
  5655.      editor to configure Telegard to generate them.
  5656.  
  5657.      Many  other  BBS  programs use generic menus,  and  unfortunately,  it
  5658.      shows:   They  are usually very rigid, allowing very little  room  for
  5659.      creativity (making it a carbon-copy of other systems, and giving it  a
  5660.      "bland"  look).   Telegard solves this problem by making  the  generic
  5661.      menus extremely configurable.
  5662.  
  5663.      First of all, the number of columns the BBS uses to generate the menus
  5664.      is  configurable.   The REALLY nice feature,  however,  is  Telegard's
  5665.      ability  to colorize menu command descriptions automatically, with  no
  5666.      effort  on the SysOp's part.  If you want to change the  ENTIRE  color
  5667.      scheme  of  a  certain  menu,  all you have to  do  is  change  a  few
  5668.      parameters  in the menu editor.  Each menu can have a different  color
  5669.      scheme, as well.
  5670.  
  5671.      When  normal  generic menus are displayed, they are displayed  in  the
  5672.      following format (this is an example using the 4 column size):
  5673.  
  5674.                                <<< Menu Title >>>
  5675.  
  5676.      [ Column #1     ][ Column #2     ][ Column #3     ][ Column #4     ]
  5677.      [ Column #1     ][ Column #2     ][ Column #3     ][ Column #4     ]
  5678.      [ Column #1     ][ Column #2     ]
  5679.  
  5680.      All columns are left-justified, meaning they begin at column 1 of  the
  5681.      screen.   Descriptions  which are too long to fit  neatly  within  the
  5682.      columns are shortened.
  5683.  
  5684.      The  furthest position any of the menu description lines go out to  on
  5685.      the right of the screen is used to calculate the position of the  menu
  5686.      titles;  they  are centered on the screen according  to  this  (unless
  5687.      centering has been disabled with the "(D)on't center the menu  titles"
  5688.      flag).
  5689.  
  5690.      When  generic  menu tutorials are displayed, they are  displayed  like
  5691.      this:
  5692.  
  5693.                                <<< Menu Title >>>
  5694.  
  5695.      [ Command #1 ........                           Max length = 70 chrs ]
  5696.      [ Command #2 ........                                                ]
  5697.      [ Command #3 ........                                                ]
  5698.        .
  5699.        .
  5700.        .
  5701.  
  5702.  
  5703.  
  5704.  
  5705.                                    - Page 88 -
  5706.  
  5707.                    Telegard Main Documentation - Version 2.5
  5708.  
  5709.  
  5710.      The menu titles are ALWAYS centered, using the same formula as in  the
  5711.      normal generic menu displays (unless centering has been disabled  with
  5712.      the "(D)on't center the menu titles" flag).
  5713.  
  5714.      When colorizing the menu descriptions (short or long, in the normal or
  5715.      tutorial  menus,  respectively),  Telegard  uses  the  three  "generic
  5716.      colors"  specified in the menu by the menu editor.  The  command  keys
  5717.      (key  sequences used to execute the command) are searched out, and  if
  5718.      found  in the description string, they are colorized using  color  #2.
  5719.      The  "bracket" characters around the command keys are colorized  using
  5720.      color  #1, and all other characters in the description  are  colorized
  5721.      using color #3.  Note that if an online user does NOT have access to a
  5722.      command, and it is an unhidden command, the command WILL be displayed,
  5723.      but   with   the  command-keys  colorized  using   color   #1.    This
  5724.      differentiates on the screen between commands the user HAS access  to,
  5725.      and those they DO NOT.
  5726.  
  5727.      Note that the "bracket" characters need not be brackets.  They can  be
  5728.      any types of characters:  Parentheses ("(" and ")"), dashes ("-"),  or
  5729.      any  of the characters from the IBM extended character set.   Whatever
  5730.      they are, Telegard will simply colorize whatever is on either side  of
  5731.      the   command  key  sequence.   Telegard  has  no  problems   handling
  5732.      descriptions such as "F)ile section", either, which have brackets only
  5733.      on ONE side of the command key sequence ("F").
  5734.  
  5735.      The following diagram should help clear all this up:
  5736.  
  5737.            ________________ Color #1 (the "(" and ")" characters)
  5738.           | |
  5739.           (F)ile section
  5740.            | ^^^^^^^^^^^\__ Color #3 (all other characters - "ile section")
  5741.            |_______________ Color #2 (the "F" character)
  5742.  
  5743.      When  a  command with command letters of "GTITLE"  is  encountered  by
  5744.      Telegard,  it is treated as a generic sub-title.  This means that  the
  5745.      description  is centered and placed on a separate line.  For  example,
  5746.      you  could put the words "SysOp Commands" as a sub-title  before  your
  5747.      listing  of SysOp commands in the file section.  Telegard looks for  a
  5748.      NEW  set  of  Generic color codes in the MString,  in  the  format  of
  5749.      "<Color1>;<Color2>;<Color3>".  If they DO exist, all commands for  the
  5750.      remainder  of  the  menu will be displayed in the new  set  of  colors
  5751.      (unless, of course, another "GTITLE" is encountered).
  5752.  
  5753.      That's  just about all there is to the colorizing methods!   A  rather
  5754.      simple system, but it tends to encourage creativity on the part of the
  5755.      SysOp  --  more, probably, than any other  comparable  self-generating
  5756.      menu system.
  5757.  
  5758.  
  5759.      ---------------------
  5760.      LINKING MENU COMMANDS
  5761.      ---------------------
  5762.  
  5763.      One  of the most powerful features of the Telegard menu system is  its
  5764.      ability  to chain, or "link", different menu commands together.   Many
  5765.      things are possible using this feature.
  5766.  
  5767.  
  5768.                                    - Page 89 -
  5769.  
  5770.                    Telegard Main Documentation - Version 2.5
  5771.  
  5772.  
  5773.      Telegard's method of linked commands is the simplest possible  method,
  5774.      as  any  programmer would attest to.  When Telegard  executes  a  menu
  5775.      command,  it will execute all commands which have the command  letters
  5776.      which were entered by the user.  Therefore, if two different  commands
  5777.      both  have the same command letters in them, both commands are  simply
  5778.      executed  in  the order in which they are placed in  the  menu  editor
  5779.      (this is one of the purposes of the P:osition command).
  5780.  
  5781.      One possibility of linking commands is to display a text file (Cmdkeys
  5782.      -F)  and then prompt the user whether he wants to send mail to a  user
  5783.      on  your BBS (Cmdkeys ME).  This can be used for "SIGs" on your  board
  5784.      that require users to "sign up" to receive access to them.
  5785.  
  5786.      Another possibility is to link the file section's area-change  command
  5787.      with the current file section statistic's lister command (Cmdkeys F$).
  5788.      This  will show the stats on the file base you have changed to,  every
  5789.      time you change areas using the "A" command.
  5790.  
  5791.      Think  of the menu editor as a kind of limited  programming  language.
  5792.      MANY, MANY things are possible, if you only use your imagination!
  5793.  
  5794.      You  should  remember  one  important  thing  when  linking   commands
  5795.      together.  ONLY put a short and long description on the FIRST  command
  5796.      in  the chain of commands, and leave the rest set to NULL.  This  will
  5797.      prevent  a  command from being displayed several  times  when  generic
  5798.      menus are displayed.
  5799.  
  5800.      One  final feature:  If a command (or several commands)  with  command
  5801.      letters "FIRSTCMD" are encountered in any menu, after it has just been
  5802.      loaded  (either  "loaded", "called", or "returned to"), they  will  be
  5803.      executed  *first*,  before  the  user is  allowed  to  enter  commands
  5804.      themselves.   This can be useful in the file section to  remind  users
  5805.      that they still have files left in their upload/download batch  queues
  5806.      (with  the "B?" command keys), and for many other such  things.   With
  5807.      the  powerful  ACS system, you could even have  Telegard  remind  (for
  5808.      example)  user  #50 that they should read their mail, on  the  message
  5809.      menu.
  5810.  
  5811.  
  5812.      -----------------------------------
  5813.      MENU COMMANDS AVAILABLE IN TELEGARD
  5814.      -----------------------------------
  5815.  
  5816.      Due  to the fact that there are so many available commands,  and  that
  5817.      thorough  descriptions  of  each command take up so  much  space,  the
  5818.      available  commands  are described in a separate  documentation  file,
  5819.      MENU.DOC.   Consult  MENU.DOC for descriptions of  all  menu  commands
  5820.      available in Telegard.
  5821.  
  5822.  
  5823.  
  5824.  
  5825.  
  5826.  
  5827.  
  5828.  
  5829.  
  5830.  
  5831.                                    - Page 90 -
  5832.  
  5833.                    Telegard Main Documentation - Version 2.5
  5834.  
  5835.  
  5836.                           ____________________________
  5837.  
  5838.                            THE SCHEDULED EVENT EDITOR
  5839.                           ____________________________
  5840.  
  5841.  
  5842.      The Scheduled Event Editor allows you to define "events" that are  run
  5843.      at defined times throughout the day/week/month.  Various events can be
  5844.      run,  such  as BBS enhancements (updating bulletins,  performing  file
  5845.      section maintenance, packing the message bases, etc.) or DOS utilities
  5846.      (Norton Speed Disk, etc.).
  5847.  
  5848.      How do scheduled events affect users, specifically their time on-line?
  5849.      If  a  user  logs on, and the amount of time allowed  will  overlap  a
  5850.      scheduled   event,  the  user's  allowed  time  online  is   decreased
  5851.      accordingly.    If  a  user  is  online  and  a  scheduled  event   is
  5852.      approaching, he will be alerted prior to the event.
  5853.  
  5854.      The  Event Editor can be accessed through the WFC menu and  the  SysOp
  5855.      menu.  Upon executing, the following screen is displayed:
  5856.      ______________________________________________________________________
  5857.  
  5858.       NN:Description                :Typ:Bsy:Time :Len:Days   :ExecData
  5859.       ==:===========================:===:===:=====:===:=======:============
  5860.      -1  A NEW Telegard Event        DOS 5   00:00 1   ------- event.bat
  5861.  
  5862.      Event editor (?=help) :
  5863.      ______________________________________________________________________
  5864.  
  5865.      The following commands are available from this screen:
  5866.  
  5867.            <CR>Redisplay menu
  5868.            (D)elete   (I)nsert
  5869.            (M)odify   (P)osition
  5870.            (Q)uit
  5871.  
  5872.           <CR>Redisplay menu -- This will redisplay the listing of events
  5873.                that are present.
  5874.  
  5875.           (D)elete -- This will allow you to delete an undesirable system
  5876.                event from the listing.
  5877.  
  5878.           (I)nsert -- This will insert another event in the list of defined
  5879.                system events.
  5880.  
  5881.           (M)odify -- This will allow you to modify an existing event.
  5882.                More on this command later.
  5883.  
  5884.           (P)osition -- This will move an event from one position to
  5885.                another in the list of events.
  5886.  
  5887.           (Q)uit -- Exits the Event Editor and returns to the point you
  5888.                entered (the WFC menu or the SysOp menu).
  5889.  
  5890.  
  5891.  
  5892.  
  5893.  
  5894.                                    - Page 91 -
  5895.  
  5896.                    Telegard Main Documentation - Version 2.5
  5897.  
  5898.  
  5899.      When  you  select the (M)odify command, you are asked  to  select  the
  5900.      event  that you would like to modify.  Upon selecting, the event  data
  5901.      is displayed:
  5902.      ______________________________________________________________________
  5903.  
  5904.      Event #1 of 1
  5905.  
  5906.      !. Active     : No
  5907.      1. Description: A NEW Telegard Event
  5908.      2. Sched. type: DOS shell
  5909.      3. Event data : event.bat
  5910.      4. Busy time  : 5 minutes
  5911.      5. Exec time  : 00:00
  5912.      6. Busy during: Yes
  5913.      7. Duration   : 1
  5914.      8. Days active: -------
  5915.  
  5916.      Edit menu (?=help) :
  5917.      ______________________________________________________________________
  5918.  
  5919.      The  item numbers and available commands at this screen are  explained
  5920.      in detail below.
  5921.  
  5922.           !    This determines whether or not the event will be executed at
  5923.                the scheduled time.  The default is "no".  If it is toggled
  5924.                to "yes", it acts according to the specifications defined
  5925.                for the event.
  5926.  
  5927.           1    This field describes the event.  Up to 80 characters are
  5928.                allowed, as well as MCI color codes.
  5929.  
  5930.           2    This is the type of event that will be executed.  There are
  5931.                four possibilities, outlined below:
  5932.  
  5933.                     ACS -- These events are regulated by the ACS system.
  5934.                          It is designed to enable only certain callers to
  5935.                          access the BBS at a specified time of the day.
  5936.                          The BBS will prompt for a user name or number, and
  5937.                          if that user number is not defined in the current
  5938.                          ACS event, that user will not be able to log on.
  5939.                          The connection is terminated after a 20 second
  5940.                          "grace period".
  5941.  
  5942.                     Chat -- Not implemented yet.
  5943.  
  5944.                     DOS -- By far, the most common event, this is activated
  5945.                          by performing a shell to the DOS level and
  5946.                          executing files defined in the Event Data (usually
  5947.                          batch files).  Note that this event type should
  5948.                          NOT be used for programs that require a lot of
  5949.                          memory (for example, disk de-fragmenting programs
  5950.                          such as Norton Utilities Speed Disk or PC Tools
  5951.                          Compress).
  5952.  
  5953.                     External -- This requires a batch file for execution,
  5954.                          which is used to detect an ERRORLEVEL value
  5955.  
  5956.  
  5957.                                    - Page 92 -
  5958.  
  5959.                    Telegard Main Documentation - Version 2.5
  5960.  
  5961.  
  5962.                          (returned upon exiting the BBS) to determine the
  5963.                          operation to be performed.  This will TOTALLY exit
  5964.                          the BBS, using the ERRORLEVEL value defined in the
  5965.                          Event Data field.
  5966.  
  5967.                     Pack -- This event packs the message bases by removing
  5968.                          all deleted messages and adjusting the number of
  5969.                          messages in each base to conform to the maximum
  5970.                          limit set in the message base editor (by removing
  5971.                          old, non-permanent messages).  You should define
  5972.                          AT LEAST ONE packing event; if you don't, your
  5973.                          message bases will "grow out of control"!
  5974.  
  5975.           3    The contents of this field will vary with the type of event
  5976.                being executed:
  5977.  
  5978.                     DOS -- The name of a batch file to be executed when
  5979.                          dropping to DOS, or the name of a program to be
  5980.                          executed.
  5981.  
  5982.                     External -- The ERRORLEVEL value to be used to detect
  5983.                          the type of event to execute.  The value is
  5984.                          restricted to the range 0-255.  (It is recommended
  5985.                          that you do NOT use either 0 or 255.)
  5986.  
  5987.                     ACS -- The ACS requirement that users must satisfy in
  5988.                          order to log on to the BBS.
  5989.  
  5990.                     All others -- Not used; the event data field will be
  5991.                          ignored.
  5992.  
  5993.           4    This is the time prior to an event that the BBS will appear
  5994.                busy.  Telegard will take the Exec Time and subtract the
  5995.                Busy Time to determine this value.  When the time is
  5996.                encountered, the modem is taken off-hook using the "modem
  5997.                off-hook" command (defined in the Modem Configuration
  5998.                section in System Configuration), and will remain off-hook
  5999.                until the event time is reached.  Then, depending on the
  6000.                setting of the Busy During field, the modem will either
  6001.                remain off-hook or it will be initialized.  Setting this
  6002.                field to zero (0) allows users to remain online until the
  6003.                exact time of the scheduled event (at which time they are
  6004.                unceremoniously logged off!).
  6005.  
  6006.           5    This is the time of day that the particular scheduled event
  6007.                will occur.  It is defined in both hours and minutes, on a
  6008.                24-hour clock.
  6009.  
  6010.           6    This field determines whether or not the modem will be taken
  6011.                off-hook during the scheduled event (the default is "yes").
  6012.                If the value is "no", the modem will stay on-hook during the
  6013.                event (useful for ACS and Chat events).
  6014.  
  6015.           7    This is a specified time in minutes that will be necessary
  6016.                for the event to occur.  This field will usually be set to
  6017.                one (1) minute.  Unless you know PRECISELY how many minutes
  6018.  
  6019.  
  6020.                                    - Page 93 -
  6021.  
  6022.                    Telegard Main Documentation - Version 2.5
  6023.  
  6024.  
  6025.                an event will take, you should ALWAYS set this field to 1.
  6026.  
  6027.           8    These are the days of either the regular week, or the whole
  6028.                month, that the scheduled event will occur:
  6029.  
  6030.                     Weekly -- This will occur at least once every single
  6031.                          week.  A bar with the current days active will be
  6032.                          displayed as follows:
  6033.  
  6034.                               Current: SMTWTFS
  6035.  
  6036.                          Modify by entering "X"'s under the days.  If it
  6037.                          is not currently active, typing "X" under the day
  6038.                          will make it active, and vice versa.
  6039.  
  6040.                     Monthly -- This will occur only one day in the month.
  6041.                          The default is the first day of the month.  This
  6042.                          is common for such routines as a hard drive backup
  6043.                          program.
  6044.  
  6045.           [    This will jump back one entry in the list of events.  If it
  6046.                is positioned at the first entry, this command is ignored.
  6047.  
  6048.           ]    This will move forward one entry in the list of events.  If
  6049.                it is positioned at the last entry, this command is ignored.
  6050.  
  6051.           F    This will move to the first entry in the list of events.
  6052.  
  6053.           L    This will move to the last entry in the list of events.
  6054.  
  6055.           J    This will jump to a specified entry in the list of events.
  6056.  
  6057.           Q    Saves all entries in the list of events and returns to the
  6058.                main editor screen.
  6059.  
  6060.  
  6061.  
  6062.  
  6063.  
  6064.  
  6065.  
  6066.  
  6067.  
  6068.  
  6069.  
  6070.  
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.  
  6080.  
  6081.  
  6082.  
  6083.                                    - Page 94 -
  6084.  
  6085.                    Telegard Main Documentation - Version 2.5
  6086.  
  6087.  
  6088.                                    __________
  6089.  
  6090.                                     MINI-DOS
  6091.                                    __________
  6092.  
  6093.  
  6094.      Mini-DOS is a security sensitive DOS shell that is common to many  BBS
  6095.      programs.   It runs as an "internal door" and works according to  that
  6096.      user's  ACS.  Mini-DOS in Telegard is usually accessed either via  the
  6097.      WFC  menu  in local access mode, or remotely through the  SysOp  menu.
  6098.      When  Mini-DOS  is  executed, it automatically shells  to  the  AFILES
  6099.      directory  defined in the system configuration.  Upon  execution,  the
  6100.      following appears:
  6101.  
  6102.           Type "EXIT" to return to Telegard.
  6103.  
  6104.           Telegard(R) Mini-DOS(R)  Version 2.5
  6105.                    (C)Copyright 1988,89,90 The Telegard Team
  6106.  
  6107.           <C:\BBS\AFILES>
  6108.  
  6109.      and you are ready to go to work.
  6110.  
  6111.  
  6112.      -----------------
  6113.      MINI-DOS COMMANDS
  6114.      -----------------
  6115.  
  6116.      The command set that is resident in MiniDOS is as follows:
  6117.  
  6118.           x:        This command is synonymous to DOS' ability to change
  6119.                     between drives being accessed at the DOS level.  For
  6120.                     example, if you are currently in drive C and type "E:",
  6121.                     control will switch to drive E.  This works much the
  6122.                     same as DOS, in that it accepts only logical drives A-E
  6123.                     (or the highest drive specified in the "LASTDRIVE"
  6124.                     parameter of CONFIG.SYS).
  6125.  
  6126.           CD        This works almost the same as the CD (or CHDIR) command
  6127.                     in DOS, in that it enables the user to go to different
  6128.                     paths within the file directory tree.  The only
  6129.                     noticeable difference is that the Mini-DOS CD command
  6130.                     requires a space between the command and the directory
  6131.                     name (i.e., although ".." can be used just like in DOS
  6132.                     to go to the parent directory, you must use "CD .."
  6133.                     instead of "CD..").
  6134.  
  6135.           CLS       Works the same as DOS' CLS command, in that it erases
  6136.                     the current screen and places the prompt at the upper
  6137.                     left corner.
  6138.  
  6139.           COPY      This works almost the same as DOS' COPY command with
  6140.                     the exception that you can't have wildcards appear in
  6141.                     the destination filename.  The copy format is as
  6142.                     follows:
  6143.  
  6144.  
  6145.  
  6146.                                    - Page 95 -
  6147.  
  6148.                    Telegard Main Documentation - Version 2.5
  6149.  
  6150.  
  6151.                          COPY [destination] 'to' [target]
  6152.  
  6153.                     Thus the following formats are valid:
  6154.  
  6155.                          COPY A:EXAMPLE.TXT D:EXAMPLE.TXT
  6156.                          COPY A:*.* D:
  6157.                          COPY A:*.GIF D:
  6158.  
  6159.           DEL       This will physically erase files from the storage
  6160.                     media, and it acts the same as DOS' internal delete
  6161.                     command and will delete one or more files.  It can
  6162.                     support wildcards, and if the file in question is not
  6163.                     present or has a read only attribute, the following
  6164.                     text will be displayed:
  6165.  
  6166.                          <Filename> Could not delete
  6167.  
  6168.           DIR       This is the same as DOS' DIR command that displays a
  6169.                     listing of files, and it can use wildcard formats,
  6170.                     including "*" and "?".
  6171.  
  6172.           EDIT      This command invokes the internal text editor, which
  6173.                     can be used to edit standard ASCII text or Telegard
  6174.                     *.MSG files.
  6175.  
  6176.           EXIT      Exits out of Mini-DOS and returns to the WFC menu (or
  6177.                     the BBS if online).
  6178.  
  6179.           EXT       Allows a user with SysOp access to execute an external
  6180.                     DOS command or program.  The syntax is:
  6181.  
  6182.                          EXT <Command>
  6183.  
  6184.                     where <Command> is a DOS command or program executed
  6185.                     exactly the same was as if it were being executed from
  6186.                     DOS itself.  Note that while Telegard is loaded, there
  6187.                     is not much memory available to do anything extensive.
  6188.  
  6189.           IFL       Displays a list of files inside an archive file.  The
  6190.                     syntax is:
  6191.  
  6192.                          IFL <Filename>
  6193.  
  6194.                     where <Filename> is the name of an archive file in ARC,
  6195.                     LZH, PAK, ZIP or ZOO format.  If you do not specify a
  6196.                     filename, a help screen will be displayed.
  6197.  
  6198.           MD        This command is the same as the external DOS command,
  6199.                     in that it will make a new directory.
  6200.  
  6201.           MOVE      This command functions the same as COPY, except that
  6202.                     the source files are deleted once they have been copied
  6203.                     to their destination.
  6204.  
  6205.           RD        This command is the same as the external DOS command,
  6206.                     in that it will remove a directory (as long as it is
  6207.  
  6208.  
  6209.                                    - Page 96 -
  6210.  
  6211.                    Telegard Main Documentation - Version 2.5
  6212.  
  6213.  
  6214.                     empty, and no files or directories are contained within
  6215.                     it).
  6216.  
  6217.           REN       This is the same as the external DOS command that will
  6218.                     rename a file or a wildcard of files to a different
  6219.                     filename(s).
  6220.  
  6221.           SEND      Enables a high security level user to download files
  6222.                     (usually BBS or DOS related) not present on the system,
  6223.                     that may be essential. The caller will enter "SEND
  6224.                     filename" and choose a file transfer protocol to use to
  6225.                     download the file.  The file is then transferred and
  6226.                     the Mini-DOS prompt will return.
  6227.  
  6228.           TYPE      This command operates almost exactly the same as DOS'
  6229.                     TYPE command, except that (1) the display will pause
  6230.                     when it has filled according to the user's setup, and
  6231.                     (2) if a *.MSG file is displayed that contains MCI
  6232.                     color codes, the file will be displayed in color (or
  6233.                     not, again according to the user's setup).
  6234.  
  6235.           VER       Displays information about the current version of Mini
  6236.                     DOS and Telegard being used.  For example, Mini-DOS for
  6237.                     version 2.5 displays the following text:
  6238.  
  6239.                     Telegard(R) MiniDos(R)  Version 2.5
  6240.                                 (C)Copyright 1988,89,90 The Telegard Team
  6241.  
  6242.           ?         Displays a list of all available Mini-DOS commands.
  6243.  
  6244.  
  6245.      ------------------------
  6246.      THE MINI-DOS TEXT EDITOR
  6247.      ------------------------
  6248.  
  6249.      Telegard  has a special built in text editor that can be used to  edit
  6250.      standard ASCII text files or Telegard *.MSG files.  This editor  works
  6251.      similarly to DOS' EDLIN text editor, in that it works on one line at a
  6252.      time.
  6253.  
  6254.      Upon  entering  the text editor (either from the WFC menu  or  through
  6255.      Mini-DOS), you are given a command line and must enter the name of the
  6256.      file you wish to edit.  The default path is your AFILES directory, and
  6257.      when  you request help in the text editor, by pressing "?" for a  list
  6258.      of commands, you are presented with the following menu:
  6259.  
  6260.           (+)Forward line    (-)Back line
  6261.           (T)op              (B)ottom
  6262.           (P)rint line       (L)ist
  6263.           (I)nsert lines     (D)elete lines
  6264.           (R)eplace line     (C)lear all
  6265.           (Q)uit (abort)     (S)ave
  6266.           (*)Center line
  6267.  
  6268.  
  6269.  
  6270.  
  6271.  
  6272.                                    - Page 97 -
  6273.  
  6274.                    Telegard Main Documentation - Version 2.5
  6275.  
  6276.  
  6277.      These commands are explained below:
  6278.  
  6279.           (+)Forward line -- Will move the current line of editing up one
  6280.                in position, unless it is at the end, then it will say [end
  6281.                line].  For example, if you are currently editing line
  6282.                number 5 and at the ":" prompt, you hit a "+", you are moved
  6283.                to line 6 of the text.
  6284.  
  6285.           (-)Back line -- Moves the current text being edited back one in
  6286.                position, unless at the beginning in which case it will
  6287.                automatically stay at line 1.
  6288.  
  6289.           (T)op -- Automatically moves the line being edited from the
  6290.                current one to line 1.
  6291.  
  6292.           (B)ottom -- Automatically moves the line being edited from the
  6293.                current one to the last line of the text.
  6294.  
  6295.           (P)rint line -- Display the current line.
  6296.  
  6297.           (L)ist -- Will list the line being edited and all subsequent
  6298.                lines in the file.  Therefore, if you have a 26 line text
  6299.                file, and are currently editing line 6, the list will be
  6300.                from 6 to 26.
  6301.  
  6302.           (I)nsert lines -- Enables you to insert lines either blank or
  6303.                containing text, until you type "." at the beginning of a
  6304.                line to save the file.
  6305.  
  6306.           (D)elete lines -- Enables you to delete the current line being
  6307.                edited in the file.
  6308.  
  6309.           (R)eplace lines -- In the event you wish to replace lines, this
  6310.                command will show the original line and then provides a
  6311.                blank line for changes and alterations.
  6312.  
  6313.           (C)lear all -- Clears the screen and makes the file in memory
  6314.                appear blank.  Basically, used ONLY when a file has been
  6315.                damaged so bad, there is no salvaging it.
  6316.  
  6317.           (Q)uit (abort) -- Used to abort the edit.  Does NOT save the file
  6318.                in memory to disk.  Used when you made a mistake and decide
  6319.                that the previous version of the file was better. Returns
  6320.                you to the point of entry (the WFC menu, the BBS, or Mini-
  6321.                DOS).
  6322.  
  6323.           (S)ave -- Used to save the file in memory to disk, then it will
  6324.                exit and return to the point of entry (the WFC menu, the
  6325.                BBS, or Mini-DOS).
  6326.  
  6327.           (*)Center line -- This command will center the line being edited.
  6328.                Be careful with this command; since it does not remove any
  6329.                previous centering code, you could end up "stacking"
  6330.                multiple centering codes on the line (making it look not at
  6331.                all like you want!).
  6332.  
  6333.  
  6334.  
  6335.                                    - Page 98 -
  6336.  
  6337.                    Telegard Main Documentation - Version 2.5
  6338.  
  6339.  
  6340.                       ___________________________________
  6341.  
  6342.                        THE INFOFORM QUESTIONNAIRE SYSTEM
  6343.                       ___________________________________
  6344.  
  6345.  
  6346.      The  InfoForm questionnaire system is one of Telegard's most  powerful
  6347.      information-gathering   features.   Using  just  a  few  commands   --
  6348.      scattered in an ordinary text file -- the SysOp can gather volumes  of
  6349.      information  about  users:  Who they are, what they  want,  what  they
  6350.      DON'T  want.   The  uses for the  InfoForm  questionnaire  system  are
  6351.      virtually endless.
  6352.  
  6353.  
  6354.      -------------------------------------------
  6355.      HOW INFOFORM QUESTIONNAIRES ARE CONSTRUCTED
  6356.      -------------------------------------------
  6357.  
  6358.      InfoForm questionnaires are really nothing more than plain text  files
  6359.      with certain commands, meaningful only to the InfoForm system,  placed
  6360.      throughout.   Think of the InfoForm system as a miniature  batch  file
  6361.      language, but whose emphasis is placed on user input.
  6362.  
  6363.      The  InfoForm  questionnaire is stored in the AFILES directory,  in  a
  6364.      file  with  the extension ".INF".  When users  answer  the  questions,
  6365.      their answers are also stored in the AFILES directory, in a file  with
  6366.      the  same  name as the InfoForm questionnaire but with  the  extension
  6367.      ".ASW" (for "AnSWers").  Answers from different users are appended  to
  6368.      the  end of the *.ASW file; thus, you have a complete record  of  each
  6369.      user's responses (until you delete the *.ASW file).
  6370.  
  6371.  
  6372.      --------------------------
  6373.      THE NEW USER QUESTIONNAIRE
  6374.      --------------------------
  6375.  
  6376.      A special InfoForm questionnaire, if present, is always given to a new
  6377.      user during the new user logon process.  The file is NEWUSER.INF, with
  6378.      the answers stored in NEWUSER.ASW.  Like all InfoForm  questionnaires,
  6379.      NEWUSER.INF can contain any questions you like; however, the new  user
  6380.      questionnaire  is  usually  used to  ask  for  additional  information
  6381.      (information  that  isn't requested during the normal new  user  logon
  6382.      process).  Answers to the new user questionnaire can be read from  the
  6383.      user editor, or through a menu command (discussed below).
  6384.  
  6385.  
  6386.      ------------------------------------------
  6387.      ASKING AND READING INFOFORM QUESTIONNAIRES
  6388.      ------------------------------------------
  6389.  
  6390.      Constructing  a command to ask an InfoForm questionnaire is  simply  a
  6391.      matter  of  adding a new command to a menu.  The  command  should  use
  6392.      Cmdkeys "-Q", with the InfoForm questionnaire filename in the  MString
  6393.      field.  For example:
  6394.  
  6395.  
  6396.  
  6397.  
  6398.                                    - Page 99 -
  6399.  
  6400.                    Telegard Main Documentation - Version 2.5
  6401.  
  6402.  
  6403.           Long descript :(Q)uestionnaire - Ask user some questions
  6404.           Short descript:(Q)uestionnaire
  6405.           Cmd letters   :Q
  6406.           ACS required  :"s20"
  6407.           Cmdkeys       :-Q
  6408.           MString       :question.inf
  6409.           Flags         :None
  6410.  
  6411.      Reading an InfoForm answer file is just as easy.  Construct a  command
  6412.      using  Cmdkeys "-R", with the InfoForm questionnaire filename  in  the
  6413.      MString field:
  6414.  
  6415.           Long descript :(R)ead Answers - Read answers to questionnaire
  6416.           Short descript:(R)ead Answers
  6417.           Cmd letters   :R
  6418.           ACS required  :"s20"
  6419.           Cmdkeys       :-R
  6420.           MString       :question.inf
  6421.           Flags         :None
  6422.  
  6423.      Alternately,  you could leave the MString field blank, in  which  case
  6424.      Telegard  will prompt you for the InfoForm questionnaire  filename  in
  6425.      which to read the answers.
  6426.  
  6427.  
  6428.      -------------------------------
  6429.      INFOFORM QUESTIONNAIRE COMMANDS
  6430.      -------------------------------
  6431.  
  6432.      Below  are  listed all the InfoForm questionnaire  commands  currently
  6433.      supported  by Telegard.  All commands must start on a  separate  line,
  6434.      beginning  with a ";" (semicolon) character.  Labels (used by the  "G"
  6435.      and  "I"  commands)  start on a separate line, beginning  with  a  ":"
  6436.      (colon)  character and followed by a string of  characters.   Anything
  6437.      else is treated as displayable text.
  6438.  
  6439.           Command:  A<string>*
  6440.           Function: Upper and lower case string input.  Displays <string>,
  6441.                     then inputs the string at the "*" character.  NOTE:
  6442.                     All characters after the "*" character are completely
  6443.                     ignored!
  6444.  
  6445.           Command:  B<string>*
  6446.           Function: Similar to the "A" command, except all input is upper
  6447.                     case only.
  6448.  
  6449.           Command:  C"chars"<string>*
  6450.           Function: Multiple-choice input.  Displays string, then inputs
  6451.                     a single character at the "*" character.  Accepted
  6452.                     answers are any character between the quote marks ("").
  6453.  
  6454.           Command:  Dx<string>
  6455.           Function: Open door.  Outputs a door file (depending on "x"),
  6456.                     then executes <string>.  All rules for standard door
  6457.                     commands apply (refer to the menu documentation).
  6458.                     Allowable values for "x":
  6459.  
  6460.  
  6461.                                    - Page 100 -
  6462.  
  6463.                    Telegard Main Documentation - Version 2.5
  6464.  
  6465.  
  6466.                          -    None (no door file written)
  6467.                          C    CHAIN.TXT (WWIV)
  6468.                          D    DORINFO1.DEF (RBBS-PC)
  6469.                          G    DOOR.SYS (GAP)
  6470.                          S    SFDOORS.DAT (Spitfire)
  6471.                          W    CALLINFO.BBS (Wildcat!)
  6472.  
  6473.           Command:  G<label>
  6474.           Function: Goto statement.  Returns to beginning of file and
  6475.                     searches for the first label of <label>.  If none
  6476.                     exists, the end of the questionnaire file is reached
  6477.                     and the questionnaire completes.
  6478.  
  6479.           Command:  H
  6480.           Function: Hang up.  Terminate questionnaire and hang up on user.
  6481.  
  6482.           Command:  I<string>,<label>
  6483.           Function: Conditional goto statement.  Branches to <label> if
  6484.                     <string> was the last value input from a "A", "B", "C",
  6485.                     or "Y" command.  No distinction is made between upper
  6486.                     and lower case.
  6487.  
  6488.           Command:  K
  6489.           Function: Abort.  Terminate questionnaire without saving answers
  6490.                     in answer file.
  6491.  
  6492.           Command:  L<string>
  6493.           Function: Outputs <string> to the questionnaire answer file, but
  6494.                     not to the user's display.
  6495.  
  6496.           Command:  Q
  6497.           Function: Quit.  Terminate questionnaire and save answers in
  6498.                     answer file.
  6499.  
  6500.           Command:  T<filename>
  6501.           Function: Displays the file <filename>.
  6502.  
  6503.           Command:  Y<string>*
  6504.           Function: Yes or No question.  Displays <string>, then accepts
  6505.                     either a "Y" for Yes, or an "N" for No, at the "*"
  6506.                     character.
  6507.  
  6508.           Command:  ;<string>
  6509.           Function: Comment.  It is neither displayed, nor output to the
  6510.                     questionnaire answer file.
  6511.  
  6512.  
  6513.      -------------------------------
  6514.      A SAMPLE INFOFORM QUESTIONNAIRE
  6515.      -------------------------------
  6516.  
  6517.      Below  is listed a small InfoForm questionnaire as an example of  what
  6518.      the InfoForm system can do.  This questionnaire is suitable for use as
  6519.      a new user questionnaire (NEWUSER.INF); with a little modification, it
  6520.      can be enhanced to ask whatever questions you wish.
  6521.  
  6522.  
  6523.  
  6524.                                    - Page 101 -
  6525.  
  6526.                    Telegard Main Documentation - Version 2.5
  6527.  
  6528.  
  6529.           Okay... just one more series of questions to answer, and then
  6530.           you'll be on your way!  It is essential for validation purposes
  6531.           and security measures that you answer the following questions
  6532.           as completely and accurately as possible.  There are no trick
  6533.           questions, so don't worry... it's not a test!
  6534.  
  6535.           ;AAbout how long have you been BBSing? *
  6536.           ;YAre you a SysOp of any BBS? (Y/N) : *
  6537.           ;INO,NOSYSOP
  6538.  
  6539.           Enter the BBS number in the following format:
  6540.  
  6541.             ###-###-####
  6542.           ;A: *
  6543.  
  6544.           Now enter the BBS name:
  6545.  
  6546.             -BBS-Name---------------------------------------------------
  6547.           ;A: *
  6548.  
  6549.           ;AWhat type of BBS software do you run? *
  6550.           ;AHow long has your BBS been running for? *
  6551.           ;GNOSYSOP1
  6552.  
  6553.           :NOSYSOP
  6554.           Oh well, someone's gotta do it, eh!
  6555.  
  6556.           :NOSYSOP1
  6557.           Do you know any of the current users on this BBS, or any other
  6558.           good users that could recommend you?  (2 lines)
  6559.  
  6560.            1: *
  6561.            2: *
  6562.  
  6563.           Well, that completes our little survey.  Hope it wasn't too
  6564.           painful!
  6565.  
  6566.  
  6567.  
  6568.  
  6569.  
  6570.  
  6571.  
  6572.  
  6573.  
  6574.  
  6575.  
  6576.  
  6577.  
  6578.  
  6579.  
  6580.  
  6581.  
  6582.  
  6583.  
  6584.  
  6585.  
  6586.  
  6587.                                    - Page 102 -
  6588.  
  6589.                    Telegard Main Documentation - Version 2.5
  6590.  
  6591.  
  6592.                                _________________
  6593.  
  6594.                                 RUN-TIME ERRORS
  6595.                                _________________
  6596.  
  6597.  
  6598.      Certain  errors  at  run  time cause Telegard to  exit  back  to  DOS.
  6599.      Whenever  this  occurs, the ENTIRE screen image is output  to  a  file
  6600.      called "ERR.LOG" in your main BBS directory, along with certain pieces
  6601.      of  vital  information such as time, date, error number,  BBS  version
  6602.      number, the user who was on and what baud rate they were on at.
  6603.  
  6604.      Here is what each screen image entry LOOKS like in ERR.LOG:
  6605.  
  6606.           RT #XXX at MM/DD/YY HH:MM:SS  BBS-Ver: 1.7b Standard
  6607.           User "BLACK ADEPT #1" was on at 2400 baud
  6608.  
  6609.      after  which  follows the "picture" of the screen at the time  of  the
  6610.      error.
  6611.  
  6612.      Also,  a  message is output to the SysOp log, and the  user's  screen,
  6613.      when a run-time error occurs.  This is output to the SysOp log:
  6614.  
  6615.           *>> Runtime error XXX at MM/DD/YY HH:MM:SS <<*
  6616.           (Check ERR.LOG in main BBS dir)
  6617.  
  6618.      and this is output to the user's screen:
  6619.  
  6620.           *>> System error occurred at MM/DD/YY HH:MM:SS <<*
  6621.  
  6622.      Note  that WHENEVER a run-time error occurs, it is a bug in  Telegard.
  6623.      Telegard  is NOT supposed to have run-time errors in it.  Please  note
  6624.      the information at the top of the ERR.LOG file:
  6625.  
  6626.           Critical Error Log file - Contains screen images at instant of
  6627.           Error.  The "X" character shows the cursor position at time of
  6628.           error.  Note: You may periodically delete this file with no harm
  6629.           to the system, but note the following information:
  6630.  
  6631.           Please notify Eric Oman that you have encountered a Critical
  6632.           Error.  You will need to send this file to him, along with a
  6633.           short message stating - briefly - what events led up to the
  6634.           Critical Error, and whether or not the error was repeatable, and
  6635.           under what circumstances.
  6636.  
  6637.      The  run-time errors are divided into four categories:  DOS errors  1-
  6638.      99;  I/O errors, 100-149; critical errors, 150-199; and fatal  errors,
  6639.      200-255.   Please remember that run-time errors should  NEVER  HAPPEN!
  6640.      When  they  do, it is an indication that something in  the  BBS  isn't
  6641.      working correctly.
  6642.  
  6643.      The following is a listing of all run-time errors.  You might be  able
  6644.      to figure out the problem, and correct it, by referring to this  list.
  6645.      If  you can't, don't get discouraged.  Just call one of the  Alpha  or
  6646.      Beta  sites  near you, and they'll be happy to help  you  through  any
  6647.      problem you might encounter.
  6648.  
  6649.  
  6650.                                    - Page 103 -
  6651.  
  6652.                    Telegard Main Documentation - Version 2.5
  6653.  
  6654.  
  6655.      ----------
  6656.      DOS ERRORS
  6657.      ----------
  6658.  
  6659.      2 File not found.
  6660.      3 Path not found.
  6661.      4 Too many open files.
  6662.  
  6663.           This error may indicate that you do NOT have a FILES=xx entry in
  6664.           your CONFIG.SYS file.  You should have the following lines in
  6665.           your CONFIG.SYS file:
  6666.  
  6667.                BUFFERS=40
  6668.                FILES=30
  6669.  
  6670.      5 File access denied.
  6671.      6 Invalid file handle.
  6672.  
  6673.           This error is reported if an invalid file handle is passed to a
  6674.           DOS system call.  It should never occur; if it does, it is an
  6675.           indication that the file variable is somehow trashed.  This may
  6676.           come about if you edit a file that has been opened by Telegard.
  6677.  
  6678.      12 Invalid file access code.
  6679.      15 Invalid drive number.
  6680.      16 Cannot remove current directory.
  6681.      17 Cannot rename across drives.
  6682.  
  6683.  
  6684.      ----------
  6685.      I/O ERRORS
  6686.      ----------
  6687.  
  6688.      100 Disk read error.
  6689.  
  6690.           Reported if Telegard attempts to read past the end of a file.
  6691.  
  6692.      101 Disk write error.
  6693.  
  6694.           Reported if the disk becomes full.
  6695.  
  6696.      102 File not assigned.
  6697.      103 File not open.
  6698.      104 File not open for input.
  6699.      105 File not open for output.
  6700.      106 Invalid numeric format.
  6701.  
  6702.  
  6703.      ---------------
  6704.      CRITICAL ERRORS
  6705.      ---------------
  6706.  
  6707.      These  errors usually indicate a hardware problem.  Double-check  your
  6708.      system for faults (especially your hard and/or floppy disks).
  6709.  
  6710.      150 Disk is write-protected.
  6711.  
  6712.  
  6713.                                    - Page 104 -
  6714.  
  6715.                    Telegard Main Documentation - Version 2.5
  6716.  
  6717.  
  6718.      151 Unknown unit.
  6719.      152 Drive not ready.
  6720.      153 Unknown command.
  6721.      154 CRC error in data.
  6722.      155 Bad drive request structure length.
  6723.      156 Disk seek error.
  6724.      157 Unknown media type.
  6725.      158 Sector not found.
  6726.      159 Printer out of paper.
  6727.      160 Device write fault.
  6728.      161 Device read fault.
  6729.      162 Hardware failure.
  6730.  
  6731.  
  6732.      ------------
  6733.      FATAL ERRORS
  6734.      ------------
  6735.  
  6736.      These errors always immediately terminate the program.
  6737.  
  6738.      200 Division by zero.
  6739.      201 Range check error.
  6740.      202 Stack overflow error.
  6741.      203 Heap overflow error.
  6742.      204 Invalid pointer operation.
  6743.      205 Floating point overflow.
  6744.      206 Floating point underflow.
  6745.      207 Invalid floating point operation.
  6746.      208 Overlay manager not installed.
  6747.      209 Overlay file read error.
  6748.  
  6749.           If you run Norton Utilities Speed Disk or PC Tools Compress (or
  6750.           some other hard disk organizer/defragmenter) as an event, and run
  6751.           it as a DOS Shell event, this error can occur sometimes, because
  6752.           Speed Disk/Compress will probably move the BBS.OVR file somewhere
  6753.           else.  The solution is to run Speed Disk/Compress as an
  6754.           "External" event.  (Any program of that nature should be run as
  6755.           an "External" event  anyway, to give them all the memory they
  6756.           want to operate!)
  6757.  
  6758.  
  6759.  
  6760.  
  6761.  
  6762.  
  6763.  
  6764.  
  6765.  
  6766.  
  6767.  
  6768.  
  6769.  
  6770.  
  6771.  
  6772.  
  6773.  
  6774.  
  6775.  
  6776.                                    - Page 105 -
  6777.