home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / BBS / TG27.ZIP / UPGRADE.DOC < prev    next >
Text File  |  1991-12-15  |  73KB  |  1,720 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.       |
  21.       |
  22.       |  Telegard Bulletin Board System
  23.       |
  24.       |  Copyright 1988-1991 by Martin Pollard.  All rights reserved.
  25.       |
  26.       |
  27.       |  Version 2.7 Upgrade Information
  28.       |
  29.       |  Release Date:  15 Dec 1991
  30.       |
  31.       |
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                               ___________________
  43.  
  44.                                TABLE OF CONTENTS
  45.                               ___________________
  46.  
  47.       Introduction .................................................... 1
  48.         Existing Systems .............................................. 1
  49.         New Systems ................................................... 1
  50.         Compatibility Notes ........................................... 1
  51.         Structures for Data Files ..................................... 1
  52.       Converting Your Existing System ................................. 2
  53.         Before You Begin .............................................. 2
  54.         Performing the Conversion ..................................... 2
  55.       Installing a New System ......................................... 4
  56.         Before You Begin .............................................. 4
  57.         Performing the Installation ................................... 5
  58.         Starting Up the System ........................................ 6
  59.         System Configuration .......................................... 7
  60.         Modem Configuration ........................................... 7
  61.         Logging On .................................................... 7
  62.         Additional Customization ...................................... 8
  63.         Replacing a Corrupt STATUS.DAT File ........................... 9
  64.       Changes and Enhancements ........................................ 10
  65.         New Features .................................................. 10
  66.         Changes ....................................................... 12
  67.         Bug Fixes ..................................................... 15
  68.         Using Existing Telegard Utilities ............................. 16
  69.         Message System Changes ........................................ 17
  70.           The Message Base Editor...................................... 17
  71.           Message System Menu Commands ................................ 18
  72.           Writing Messages ............................................ 21
  73.           NetMail ..................................................... 22
  74.           Full-Screen Editor .......................................... 24
  75.         Conferencing .................................................. 25
  76.           Conferencing Examples ....................................... 26
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.                       ____________________________________
  87.  
  88.                        BORING (BUT NECESSARY) LEGAL STUFF
  89.                       ____________________________________
  90.  
  91.  
  92.  
  93.       WARRANTY
  94.  
  95.            This  program is provided as-is, without warranty of any  kind,
  96.            either  expressed or implied, and is only guaranteed to  occupy
  97.            disk  space.  In no event will the author be liable to  you  or
  98.            anyone else for any damages, including (but not limited to) any
  99.            lost profits, lost savings or other incidental or consequential
  100.            damages  arising out of the use of, or inability to  use,  this
  101.            program.
  102.  
  103.            In short:  You're on your own.  If it works for you, great;  if
  104.            not,  or if it breaks something, c'est la vie.  As  the  saying
  105.            goes,  "Use it at your own risk, but if it breaks,  *YOU*  have
  106.            the pieces."
  107.  
  108.  
  109.  
  110.       COPYRIGHT
  111.  
  112.            This program is provided at no cost to you.  However, it is NOT
  113.            public  domain; it is copyrighted by the author.  You may  dis-
  114.            tribute  this program freely, so long as all files in the  dis-
  115.            tribution archive remain intact, without any changes or modifi-
  116.            cations.   The distribution archive is in ZIP format;  however,
  117.            you  may convert the archive to any format you choose, so  long
  118.            as the above requirements are met.
  119.  
  120.  
  121.  
  122.       CREDITS
  123.  
  124.            All  brand  and product names referenced in this  document  are
  125.            trademarks,  registered  trademarks, or  copyrighted  works  of
  126.            their respective holders.
  127.                   Telegard BBS Version 2.7 Upgrade Information
  128.  
  129.  
  130.                                  ______________
  131.  
  132.                                   INTRODUCTION
  133.                                  ______________
  134.  
  135.       Version  2.7  represents a major upgrade over previous  releases  of
  136.       Telegard (version 2.5i and earlier).  This document will attempt  to
  137.       detail  the changes and additions in this version, and provide  con-
  138.       version  and installation instructions.  Please read  this  document
  139.       carefully, as it provides much vital information that is not in  the
  140.       main documentation.
  141.  
  142.  
  143.       EXISTING SYSTEMS
  144.       ~~~~~~~~~~~~~~~~
  145.       To  convert  your existing system, use the CONVERT.EXE  utility  en-
  146.       closed in the distribution archive.  Refer to the section on  system
  147.       conversion elsewhere in this document for more information.
  148.  
  149.  
  150.       NEW SYSTEMS
  151.       ~~~~~~~~~~~
  152.       To  install a new system from scratch, use the  INSTALL.EXE  utility
  153.       enclosed  in  the  distribution archive.  Refer to  the  section  on
  154.       system installation elsewhere in this document for more information.
  155.  
  156.  
  157.       COMPATIBILITY NOTES
  158.       ~~~~~~~~~~~~~~~~~~~
  159.       Several  files have had their formats changed, some  slightly,  some
  160.       severely.   As such, there will be many utilities which  worked  for
  161.       previous versions of Telegard, but will not work with this  version.
  162.       Refer to the section on system changes and enhancements elsewhere in
  163.       this document for more information.
  164.  
  165.  
  166.       STRUCTURES FOR DATA FILES
  167.       ~~~~~~~~~~~~~~~~~~~~~~~~~
  168.       To  assist programmers in their efforts to write (or upgrade)  Tele-
  169.       gard utilities, the structures for Telegard's data files are provid-
  170.       ed   in   the  distribution  archive.   Two  files   are   included,
  171.       TELEGARD.INC (for Turbo Pascal version 5.0 and later) and TELEGARD.H
  172.       (for most C compilers).  Information on how to use these  structures
  173.       is beyond the scope of this document; refer to the Telegard Software
  174.       Development Kit for more information.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.                                    - Page 1 -
  186.                   Telegard BBS Version 2.7 Upgrade Information
  187.  
  188.  
  189.                        _________________________________
  190.  
  191.                         CONVERTING YOUR EXISTING SYSTEM
  192.                        _________________________________
  193.  
  194.       This  section describes the procedure for converting  your  existing
  195.       version  2.5i or 2.5k system.  The CONVERT.EXE utility (included  in
  196.       the  distribution archive) is used to perform the  required  conver-
  197.       sion.
  198.  
  199.  
  200.       BEFORE YOU BEGIN
  201.       ~~~~~~~~~~~~~~~~
  202.       MAKE A COMPLETE BACKUP OF YOUR PRESENT SETUP.  Although the  conver-
  203.       sion  utility  will attempt to retain the original versions  of  the
  204.       data files it converts by renaming them to *.OLD, it's always a good
  205.       idea  to have a backup just in case something  catastrophic  happens
  206.       (Murphy's Law is a fundamental rule of the Universe).
  207.  
  208.       MAKE SURE YOU HAVE ENOUGH DISK SPACE TO PERFORM THE CONVERSION.  How
  209.       do you know how much you'll need?  Since the message bases are being
  210.       converted in addition to several data files, the best way is to look
  211.       in your MSGS directory, find the largest *.BRD and *.MIX files,  and
  212.       assume you'll need at least that much space (more is preferable).
  213.  
  214.       PROCESS ALL ECHOMAIL AND GROUPMAIL.  The conversion utility will set
  215.       all  messages to "sent" status, so it's a good idea to  process  any
  216.       and  all pending EchoMail or GroupMail first (outbound  messages  in
  217.       particular).
  218.  
  219.  
  220.       PERFORMING THE CONVERSION
  221.       ~~~~~~~~~~~~~~~~~~~~~~~~~
  222.       1.   Copy the CONVERT.EXE file into your main BBS directory.
  223.  
  224.       2.   Type  CONVERT  and press <ENTER>, and read the  opening  screen
  225.            carefully.   If  you do not wish to perform the  conversion  at
  226.            this time, press <ESC>.  Otherwise, press <ENTER> to start  the
  227.            process.
  228.  
  229.       3.   If  there are no errors, CONVERT will display "Conversion  com-
  230.            plete!" and return to DOS.  If, however, there was an error,  a
  231.            message will be displayed to that effect.  If this is the case,
  232.            reinstall  the backup you made of your old setup,  correct  the
  233.            problem, and try again.
  234.  
  235.       4.   Copy  the new TELEGARD.EXE file into your main  BBS  directory,
  236.            and delete the old BBS.EXE and BBS.OVR files.
  237.  
  238.       At this point, you should be all set.  During the conversion, sever-
  239.       al  converted files are left in the main BBS and GFILES  directories
  240.       with an *.OLD extension.  These can be deleted once you've  verified
  241.       that the new setup is operating properly.
  242.  
  243.  
  244.                                    - Page 2 -
  245.                   Telegard BBS Version 2.7 Upgrade Information
  246.  
  247.  
  248.       Since there have been several changes to the SysOp function keys and
  249.       the  Wait For Caller menu commands, new versions of SYSFUNC.ANS  and
  250.       WFCMENU.ANS  are included in the distribution archive.  If you  wish
  251.       to  upgrade  these screens, simply copy the files into  your  AFILES
  252.       directory.  When the BBS is next started up, the new screens will be
  253.       automatically generated.
  254.  
  255.       (If  you already have a custom WFC menu ANSI created, you  can,  in-
  256.       stead  of  replacing it, make appropriate changes to  your  existing
  257.       WFCMENU.ANS  file by referring to the "Changes" and  "New  Features"
  258.       sections of this document.)
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.                                    - Page 3 -
  304.                   Telegard BBS Version 2.7 Upgrade Information
  305.  
  306.  
  307.                            _________________________
  308.  
  309.                             INSTALLING A NEW SYSTEM
  310.                            _________________________
  311.  
  312.       This  section describes how to install a new Telegard  system  using
  313.       the INSTALL.EXE utility (included in the distribution archive).   By
  314.       using this program, most of the work of setting up a Telegard BBS is
  315.       taken  care  of for you, leaving only the job of  customization  and
  316.       "tweaking" various settings to your satisfaction.
  317.  
  318.  
  319.       BEFORE YOU BEGIN
  320.       ~~~~~~~~~~~~~~~~
  321.       The  following lines MUST be added to your CONFIG.SYS file  (usually
  322.       found  in the root directory of your C: drive).  If CONFIG.SYS  does
  323.       not  exist, create a new one.
  324.  
  325.                      DEVICE=ANSI.SYS
  326.                      FILES=30
  327.                      BUFFERS=40
  328.  
  329.       DEVICE=ANSI.SYS loads the ANSI video display driver that comes  with
  330.            DOS.   (If  ANSI.SYS does not reside in  your  root  directory,
  331.            either  place a copy there, or add the pathname where  ANSI.SYS
  332.            resides to the DEVICE= line.)
  333.  
  334.            Due  to the proliferation of "ANSI viruses" (programs that  use
  335.            the  ANSI  driver to redefine keys on the keyboard  to  perform
  336.            various  deadly functions, like reformat your hard  drive),  we
  337.            suggest  you  use an ANSI driver that does not  allow  keyboard
  338.            redefinition.  One such driver is ZANSI.SYS; others are  avail-
  339.            able.  (These drivers usually have an additional advantage,  in
  340.            that they are much faster than the ANSI.SYS driver.)
  341.  
  342.       FILES=30  specifies the maximum number of files that can be open  at
  343.            any  one  time.  Since Telegard works with a lot of  files,  30
  344.            will  usually do the job quite nicely.  (If a FILES=  statement
  345.            already  exists, make sure that it is defined to AT LEAST  30.)
  346.            More files may be required, depending on your system configura-
  347.            tion, so experiment.
  348.  
  349.       BUFFERS=40  specifies  the number of I/O buffers to be used  by  DOS
  350.            when  reading from and writing to disk.  Again, since  Telegard
  351.            performs a lot of disk I/O, 40 buffers will do the job.  (If  a
  352.            BUFFERS= statement already exists, make sure that it is defined
  353.            to  AT LEAST 40.)  More buffers may be required,  depending  on
  354.            your system configuration, so experiment.
  355.  
  356.            Note  that if you are using disk caching software, such as  PC-
  357.            Cache  (part of Central Point Software's PC Tools Deluxe),  you
  358.            should *NOT* include a BUFFERS= line in CONFIG.SYS, as it  will
  359.            degrade the performance of the caching program.
  360.  
  361.  
  362.                                    - Page 4 -
  363.                   Telegard BBS Version 2.7 Upgrade Information
  364.  
  365.  
  366.       You  will also  need to obtain  the latest version of Omen Technolo-
  367.       gies'  DSZ.   DSZ  is  a  file transfer  protocol utility that  sup-
  368.       ports  the  Xmodem, Ymodem, and  Zmodem protocols.   Telegard  comes
  369.       configured  for  these three protocols, and  if you  wish  to  allow
  370.       users  to  upload and download files, you will need  DSZ.   (DSZ  is
  371.       widely  distributed,  and will usually be available on  many   BBSes
  372.       near you.)
  373.  
  374.       Finally, you will have to obtain a FOSSIL driver.  FOSSIL stands for
  375.       Fido/Opus/SEAdog  Standard  Interface Layer, and is a  standard  for
  376.       telecommunications in most of the IBM PC BBS world.  Several drivers
  377.       exist; two of the more popular ones are David Nugent's BNU, and  Ray
  378.       Gwinn's  X00.  Either or both of these drivers should  be  available
  379.       from  a system near you.  (Telegard *REQUIRES* the use of  a  FOSSIL
  380.       driver; if you do not use one, Telegard will not be able to communi-
  381.       cate  with  your  modem.)   Consult  the  FOSSIL  documentation  for
  382.       specific information on how to install it into your system.
  383.  
  384.  
  385.       PERFORMING THE INSTALLATION
  386.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  387.       1.   Create  a directory that will serve as the base  directory  for
  388.            the  rest of the BBS (using the MKDIR command), then go  to  it
  389.            (using the CHDIR command).  We suggest using a name that is NOT
  390.            as obvious as, say, "BBS" or "BOARD" or "SYSTEM" or  "TELEGARD"
  391.            (these  are  the first things tried by someone  with  malicious
  392.            intent)!  Try to choose a unique name that only you will know.
  393.  
  394.       2.   Unpack  the distribution archive or -- if you have unpacked  it
  395.            already -- move the files into this directory.  Among the files
  396.            should  be  INSTALL.EXE and INSTALL.MJP.   INSTALL.EXE  is  the
  397.            installation program itself; INSTALL.MJP is the archive (creat-
  398.            ed with PKWARE's PKZIP) that contains many of the files  neces-
  399.            sary to create a new BBS setup.
  400.  
  401.       3.   Type INSTALL and press <ENTER> to run the installation utility.
  402.            You will be shown a short menu:
  403.  
  404.                 1.   Change pathnames
  405.                 2.   Configure parameters
  406.                 3.   Begin installation
  407.                 4.   Create new STATUS.DAT file
  408.                 Q.   Exit to DOS
  409.  
  410.            If, at this time, you wish to abort the installation, press "Q"
  411.            to return to DOS.
  412.  
  413.       4.   Select  option  1.   At this menu, you will be  shown  all  the
  414.            pathnames that will serve as the default setup.  If you wish to
  415.            change  any of these, now is the time to do it.  Once  you  are
  416.            satisfied  with the configuration, press "Q" to return  to  the
  417.            main menu.
  418.  
  419.  
  420.  
  421.                                    - Page 5 -
  422.                   Telegard BBS Version 2.7 Upgrade Information
  423.  
  424.  
  425.       5.   Select  option  2.   At this menu, you will  be  shown  several
  426.            configuration options, including:
  427.  
  428.                 System name
  429.                 System phone number
  430.                 SysOp name
  431.                 SysOp alias
  432.  
  433.            as  well  as items associated  with  FidoNet style  networking.
  434.            Make  any appropriate changes, then press "Q" to return to  the
  435.            main  menu.  (If you are not interested in networking  at  this
  436.            time, you can skip the second set of options.)
  437.  
  438.       6.   Select  option  3 to begin the installation.   If,  during  any
  439.            point  in the installation, an error occurs, the  program  will
  440.            abort the installation process.
  441.  
  442.            Note that PKWARE's PKUNZIP.EXE program *MUST* be located in the
  443.            current  directory,  or in a directory specified in  your  PATH
  444.            statement,  for  the  installation procedure to  work,  as  the
  445.            program uses this utility to unpack the INSTALL.MJP archive.
  446.  
  447.            When  the  installation  procedure  is  finished,  the  message
  448.            "Installation  complete!" is displayed.  At this  point,  press
  449.            <ENTER> to return to the main menu.
  450.  
  451.       7.   Once installation is complete, press "Q" to return to DOS.
  452.  
  453.       8.   Add the following line to your AUTOEXEC.BAT file:
  454.  
  455.                 SET DSZLOG=C:\BBS\DSZTEMP.LOG
  456.  
  457.            This is necessary when using DSZ (described previously); it  is
  458.            the log that DSZ writes whenever a file is transferred.   Tele-
  459.            gard  uses  this log to determine the success or failure  of  a
  460.            file upload or download.
  461.  
  462.       9.   Reboot  your  system  so that the  changes  in  CONFIG.SYS  and
  463.            AUTOEXEC.BAT will be in place.
  464.  
  465.       A  default Telegard BBS is now installed and configured,  ready  for
  466.       you to customize!  (Refer to the section on customizing Telegard for
  467.       more information.)
  468.  
  469.  
  470.       STARTING UP THE SYSTEM
  471.       ~~~~~~~~~~~~~~~~~~~~~~
  472.       Make   sure  your system time and date are set correctly;  they  are
  473.       ALWAYS  used by Telegard during EVERY logon.  (It is suggested  that
  474.       you  obtain a hardware  clock/calendar if your system does  not  al-
  475.       ready  have  one;  IBM PC/ATs, PS/2s, and compatibles  usually  have
  476.       one built-in.)
  477.  
  478.  
  479.  
  480.                                    - Page 6 -
  481.                   Telegard BBS Version 2.7 Upgrade Information
  482.  
  483.  
  484.       To start the system, go to the main BBS directory and type:
  485.  
  486.                 TELEGARD <ENTER>
  487.  
  488.       After  loading  in  data files and performing several  boot   steps,
  489.       the  system  will attempt to initialize the modem.  If after  a  few
  490.       seconds  the system is still trying to initialize the  modem,  press
  491.       the space bar to abort the initialization process.
  492.  
  493.       The  screen  you  see before you is called the  Waiting  For  Caller
  494.       screen  (also known as the WFC screen or WFC menu).  From here,  you
  495.       can choose several options to configure and control your system,  as
  496.       we  as log on locally.  Most of these are briefly covered here;  for
  497.       full details, refer to the Telegard documentation.
  498.  
  499.  
  500.       SYSTEM CONFIGURATION
  501.       ~~~~~~~~~~~~~~~~~~~~
  502.       To  configure  the system to your particular wants and  needs,   use
  503.       the System Configuration command ("P" at the WFC screen).  Look over
  504.       each  section   carefully and modify whatever  you  feel  necessary.
  505.       (The Telegard documentation contains detailed information about each
  506.       function.)   After you are finished, press "Q" to return to the  WFC
  507.       screen.
  508.  
  509.  
  510.       MODEM CONFIGURATION
  511.       ~~~~~~~~~~~~~~~~~~~
  512.       The installation program configures Telegard for use with a 2400 BPS
  513.       modem on communications port 1 (COM1).  If you are using a different
  514.       COM  port, or have something other than a 2400 BPS modem,  you  will
  515.       need  to enter the Modem Configuration section ("A" from the  System
  516.       Configuration menu) and modify the BPS rate and COM port options  to
  517.       match your system configuration.
  518.  
  519.  
  520.       LOGGING ON
  521.       ~~~~~~~~~~
  522.       1.   From the WFC menu, press the space bar to locally logon.  Press
  523.            "Y" at the prompt to perform a full logon.
  524.  
  525.       2.   After the title screen is displayed you will be asked to  enter
  526.            your  user  name or ID number.  The  installation  program  has
  527.            already  created the SysOp account (user #1).  At this  prompt,
  528.            you may enter "1", or the SysOp alias you defined using  option
  529.            2 of the installation program (the default is "SYSOP").
  530.  
  531.       3.   At  the Password prompt, enter "SYSOP".  This is  the  password
  532.            assigned by the installation program; we suggest you change  it
  533.            immediately,  as this one is the first one a person with  mali-
  534.            cious  intent  will try.  (Use the User Editor,  and  choose  a
  535.            password that will be familiar only to you.)
  536.  
  537.  
  538.  
  539.                                    - Page 7 -
  540.                   Telegard BBS Version 2.7 Upgrade Information
  541.  
  542.  
  543.       4.   At  the phone number prompt, enter the last four digits of  the
  544.            phone  number  you defined using option 2 of  the  installation
  545.            program (the default is "0000").
  546.  
  547.       Using the documentation and the provided sample files, the  customi-
  548.       zation of your system should be fairly easy to figure out.
  549.  
  550.  
  551.       ADDITIONAL CUSTOMIZATION
  552.       ~~~~~~~~~~~~~~~~~~~~~~~~
  553.       The cardinal rule is, experiment!!!  It's a big system; don't expect
  554.       to learn it all in one sitting.
  555.  
  556.       Things to do to a new system:
  557.  
  558.            Find the SysOp menu.  All the SysOp commands are located there.
  559.            While  logged  on, this menu is entered by  pressing  "*"  from
  560.            almost  any other menu.  The commands in the SysOp menu  mirror
  561.            most of the WFC screen commands almost exactly, and offer a few
  562.            commands not available from the WFC screen.
  563.  
  564.            Modify the system configuration for your system.
  565.  
  566.            Modify  the SysOp account (user #1) using the User Editor  ("U"
  567.            from the SysOp menu and WFC screen).
  568.  
  569.            Check  over  the menus and command access levels  in  the  Menu
  570.            Editor ("#" from the SysOp menu and WFC screen).
  571.  
  572.            Add/modify the message bases with the Message Base Editor  ("B"
  573.            from the SysOp menu and WFC screen).
  574.  
  575.            Add/modify  the file bases with the File Base Editor ("F"  from
  576.            the SysOp menu and WFC screen).
  577.  
  578.            Create  a  voting board using the Voting Editor ("I"  from  the
  579.            SysOp menu and WFC screen).
  580.  
  581.            Post mail in each message section describing what it is.
  582.  
  583.            Set  up  any games or other online programs  you  wish.   RBBS,
  584.            WWIV,  Wildcat!,  DOOR.SYS, and Spitfire doors  are  supported.
  585.            See the section on menu commands in the main documentation.
  586.  
  587.            Use  the  Protocol  Editor ("X" from the  SysOp  menu  and  WFC
  588.            screen) to add new protocols to your BBS, or to delete the ones
  589.            in  the default setup.  (Xmodem, Ymodem, and  Zmodem  protocols
  590.            are  already set up for single file, batch, and  resume  trans-
  591.            fers.)  Also, make sure the programs that implement the  proto-
  592.            cols (example: DSZ.COM) are somewhere on your DOS PATH!
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                    - Page 8 -
  599.                   Telegard BBS Version 2.7 Upgrade Information
  600.  
  601.  
  602.       REPLACING A CORRUPT STATUS.DAT FILE
  603.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  604.       The  STATUS.DAT  file, located in the main BBS  directory,  contains
  605.       most of the information necessary for Telegard to function.  It goes
  606.       without  saying  that if this file is somehow  corrupted,  your  BBS
  607.       suddenly  becomes  nothing  more than a  meaningless  collection  of
  608.       files!
  609.  
  610.       Normally, if/when this happens, you would have to reinstall the  BBS
  611.       from  scratch.  Option 4 in the installation program, however,  will
  612.       create a brand-new STATUS.DAT file in your main BBS directory,  thus
  613.       saving  you  countless  hours of work.  (It  will  use  the  default
  614.       configuration  specified  in options 1 and 2, so if you  were  using
  615.       defaults  other  than the ones specified, you'd better  change  them
  616.       before you use this option.)
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                    - Page 9 -
  658.                   Telegard BBS Version 2.7 Upgrade Information
  659.  
  660.  
  661.                            __________________________
  662.  
  663.                             CHANGES AND ENHANCEMENTS
  664.                            __________________________
  665.  
  666.       Telegard  has undergone quite an extensive refit; this  section  de-
  667.       scribes  the  changes,  enhancements, and bug  fixes  over  previous
  668.       versions.
  669.  
  670.  
  671.       NEW FEATURES
  672.       ~~~~~~~~~~~~
  673.       *    The  message  system  has been completely  rewritten  from  the
  674.            ground up.  Refer to the section on the message system later in
  675.            this document for detailed information.
  676.  
  677.       *    Conferencing!  Yes, finally you can separate message bases  AND
  678.            FILE BASES, as well as anything else you care to dream up, into
  679.            individual  categories.  Refer to the section  on  conferencing
  680.            later in this document for detailed information.
  681.  
  682.       *    Menu command OL was added, which clears the screen.
  683.  
  684.       *    After  a  door exits, Telegard will read the user  record  from
  685.            disk  and incorporate certain information into the user's  cur-
  686.            rent data.  This information includes:
  687.  
  688.                 SL             # downloads              # public posts
  689.                 DSL            Amount uploaded (K)      # private posts
  690.                 AR flags       Amount downloaded (K)    # NetMail posts
  691.                 AC flags       NetMail credit           Time in Time Bank
  692.                 File points    NetMail debit
  693.                 # uploads      NewScan/hi-msg pointers
  694.  
  695.            Previously,  if a door wrote this information to a  user's  re-
  696.            cord,  it was lost when the user logged off  (because  Telegard
  697.            didn't reread the user record to obtain it).  This should  make
  698.            writers of callback verifiers and offline mail programs  happi-
  699.            er!
  700.  
  701.            (Note that this is done ONLY when a door is executed via the Dx
  702.            Cmdkeys, NOT via LOGON.BAT or LOGOFF.BAT.)
  703.  
  704.       *    The  system  batch files (LOGON.BAT, LOGOFF.BAT, etc.)  can  be
  705.            disabled  via  option  X in  System  Configuration  -->  System
  706.            Flagged  Functions.  This way, if you don't use them,  you  can
  707.            protect your system from jerks who might attempt to crash  your
  708.            system.
  709.  
  710.            Note that the conversion program WILL SET THIS FLAG SO THAT THE
  711.            BATCH  FILES ARE DISABLED!  Thus, if you _do_ use them,  you'll
  712.            have to toggle the flag after you convert... be warned!
  713.  
  714.  
  715.  
  716.                                    - Page 10 -
  717.                   Telegard BBS Version 2.7 Upgrade Information
  718.  
  719.  
  720.       *    Telegard  now  supports the 7200, 12000, and  14400  BPS  rates
  721.            returned  by V.32bis modems (as well as USRobotics' latest  HST
  722.            modems)...  sort  of.  What this means is  that  Telegard  will
  723.            RECOGNIZE  the  codes, but it won't actually set the  BPS  rate
  724.            specified,  since the FOSSIL driver doesn't support  these  new
  725.            rates  (7200  will be sent as 9600, and 12000 & 14400  will  be
  726.            sent as 19200).  This shouldn't be too much of a problem, since
  727.            these codes are normally only sent with a V.32bis modem,  which
  728.            means that the port should be locked for peak performance  (and
  729.            locking will take care of the BPS rate).
  730.  
  731.       *    Telegard will now create empty files ("semaphore files") in the
  732.            main BBS directory under certain conditions, for use by  exter-
  733.            nal  utilities.  (Note that Telegard does not itself use  these
  734.            files; it merely creates them.)  The currently supported  sema-
  735.            phore files are:
  736.  
  737.                 TGMSCAN.NOW    Created if a message has been entered in  a
  738.                                NetMail, EchoMail, or GroupMail base.
  739.                 TGMBASE.NOW    Created if message bases have been changed,
  740.                                inserted, deleted, or repositioned.
  741.                 TGFBASE.NOW    Created  if file bases have  been  changed,
  742.                                inserted, deleted, or repositioned.
  743.  
  744.       *    Pathnames  to your archive utilities and protocol  drivers  can
  745.            now be defined in System Configuration --> File System Configu-
  746.            ration.   These paths will be prefixed onto every  archive  and
  747.            protocol command, which should prevent unscrupulous people from
  748.            using these security holes to do damage to your system.
  749.  
  750.       *    Menu command OF added to set/reset/toggle AR flags.
  751.  
  752.                 Cmdkeys:       OF
  753.                 Description:   AR flag set/reset/toggle
  754.                 MString:       [ <function><flag> [...] ]
  755.  
  756.                      <flag> is a flag letter from A to Z.  <function>  may
  757.                      be one of the following:
  758.  
  759.                           +    Set flag
  760.                           -    Reset flag
  761.                           !    Toggle flag
  762.  
  763.                      More  than  one  function/flag  combination  may   be
  764.                      specified.  Case is ignored.
  765.  
  766.            An  example would be "+A+G-E!Z-M", which would set flags A  and
  767.            G, reset flags E and M, and toggle the status of flag Z.  (Note
  768.            that  the flags are saved in the user's record when  that  user
  769.            logs off.)
  770.  
  771.  
  772.  
  773.  
  774.  
  775.                                    - Page 11 -
  776.                   Telegard BBS Version 2.7 Upgrade Information
  777.  
  778.  
  779.       *    New  ACS command "X" added, which tests  various  miscellaneous
  780.            information.   The command format is "X<item>"; valid items  at
  781.            this time are:
  782.  
  783.                 A         TRUE if user in ANSI video mode.
  784.                 C         TRUE if user in color mode.
  785.                 L         TRUE if user logged on locally.
  786.                 T         TRUE if user in TTY video mode.
  787.                 V         TRUE if user in AVATAR video mode.
  788.  
  789.            Any other parameter will return FALSE.
  790.  
  791.       *    The post/call ratio (PCR) system is FINALLY implemented... in a
  792.            slightly different manner than you might expect.
  793.  
  794.            To set the PCR values for each security level, choose option  5
  795.            (Post/Call  Ratio Settings) at the System  Configuration  menu.
  796.            For  each SL, define the number of calls a user must  make  for
  797.            every public message posted.  The PCR configuration works  just
  798.            like the time allowed, UL/DL ratio, etc. configuration areas.
  799.  
  800.            To  use  the  PCR system, the new ACS command  "VP"  should  be
  801.            placed  in menu commands, file base definitions, or  any  place
  802.            else you wish to force PCR compliance.  Thus, if a user doesn't
  803.            meet  the  PCR, the command/feature/etc.  is  made  unavailable
  804.            until the user meets the PCR assigned for his/her SL.
  805.  
  806.       *    The  extension  used for batch files may now  be  specified  in
  807.            System  Configuration  -->  Miscellaneous  Configuration.   The
  808.            default  is BAT (used by COMMAND.COM).  Telegard will use  this
  809.            extension for all internally-generated batch files, as well  as
  810.            external batch files like LOGON.BAT, WFCBATx.BAT, etc.  This is
  811.            especially  handy for users of 4DOS, as Telegard can  now  make
  812.            use  of  its memory batch file feature  (*.BTM)  for  increased
  813.            system performance.
  814.  
  815.  
  816.       CHANGES
  817.       ~~~~~~~
  818.       *    The Waiting For Caller screen has been modified.  Several  com-
  819.            mands  have been removed, others have been reassigned or  relo-
  820.            cated, and others are new:
  821.  
  822.                 K    Pack Message Bases       *RELOCATED*
  823.                 M    Read All Mail            *REASSIGNED*
  824.                 R    Read Email               *REMOVED*
  825.                 W    Write Email              *REMOVED*
  826.                 $    Conference Editor        *NEW*
  827.  
  828.            The  Quick  Message feature ("M" from the  WFC  screen)  allows
  829.            almost  complete access to every message system  function,  in-
  830.            cluding  reading, writing, and removing messages,  and  packing
  831.            the  message bases.  (All messages are accessed and  posted  as
  832.  
  833.  
  834.                                    - Page 12 -
  835.                   Telegard BBS Version 2.7 Upgrade Information
  836.  
  837.  
  838.            user #1, with appropriate access.  Switching to another user is
  839.            not  provided  at this time.)  SysOps can now  perform  message
  840.            maintenance without ever having to log on to the BBS.
  841.  
  842.       *    Color filters have been removed, pending their possible  return
  843.            (in  an altered form) in a future version.  This  allowed  some
  844.            optimization  of the character/string display code  (also,  the
  845.            color filter system was slow as heck!).
  846.  
  847.       *    The code that handles MCI codes has been revamped, specifically
  848.            the code that interprets MCI color codes.  Most  significantly,
  849.            color codes may no longer be specified using ^0..^9; they  must
  850.            be  entered  using Ctrl-P 0..9.  Not only did this  allow  some
  851.            code streamlining, it also returned the use of the carat  ("^")
  852.            to  prompts  and  messages.  (The sole exception  is  the  menu
  853.            system; ^0..^9 can still be specified in menu prompts and such.
  854.            The  menu code will take care of converting  them  internally.)
  855.            Also,  the @ character may now be used in prompts and  messages
  856.            as long as it is not followed by a valid MCI code character.
  857.  
  858.            Be  warned that such massive changes may cause  some  anomalous
  859.            behavior;  keep  an eye out for it, and be sure to  report  any
  860.            problems.
  861.  
  862.       *    The  logon  prompt that asks for the last four  digits  of  the
  863.            user's  telephone number has been changed from "Complete  phone
  864.            #" to "Enter last four digits of phone #".  There was much user
  865.            confusion  reported  by many Telegard SysOps  over  the  former
  866.            prompt;  hopefully,  the latter prompt will  make  things  much
  867.            clearer.
  868.  
  869.       *    Some of the obnoxiousness has been removed from the user infor-
  870.            mation  prompts (when a user makes a mistake entering  the  re-
  871.            quested information).
  872.  
  873.       *    The B AC flag, which prevented using the arrow keys when enter-
  874.            ing  messages, has been removed, due to the fact that the  mes-
  875.            sage  system  no  longer allows the use of arrow  keys  at  all
  876.            (explained later).  It has been replaced with the N flag, which
  877.            is used to prohibit a user from posting NetMail messages.
  878.  
  879.       *    The (F)ast Logon feature (used when logging on locally from the
  880.            WFC  screen)  will  now  skip the  password  and  phone  number
  881.            prompts, allowing an even faster local logon.  (The user number
  882.            is  still requested in case you wish to log on locally using  a
  883.            different user account.)
  884.  
  885.       *    The  -B  command  line switch will not only  accept  the  7200,
  886.            12000,  and  14400 BPS rates, it will now  IGNORE  any  invalid
  887.            rates  that  are  passed.  (Before, Telegard  used  to  blindly
  888.            accept whatever rate happened to be passed.)
  889.  
  890.  
  891.  
  892.  
  893.                                    - Page 13 -
  894.                   Telegard BBS Version 2.7 Upgrade Information
  895.  
  896.  
  897.       *    When  deleting a user in the User Editor, messages in the  Pri-
  898.            vate  Message base which are to or from that user are  deleted.
  899.            Note  that if you restore (un-delete) a user, the messages  are
  900.            NOT restored, since there is no guarantee that they will  still
  901.            be there.
  902.  
  903.       *    The internal archive viewer has been radically changed.  First,
  904.            it  now supports Robert K. Jung's ARJ format.  Second,  it  now
  905.            supports the new compression types used in PKWARE's PKZIP  2.0.
  906.            Finally, the archive to be viewed is no longer required to have
  907.            one  of  the extensions defined in the archive  table,  as  the
  908.            viewer  will now automatically determine the archive type.   (A
  909.            viewer  defined  in the archive table will still  override  the
  910.            internal  viewer,  provided the extension on the  archive  file
  911.            matches the definition in the archive table.)
  912.  
  913.       *    When packing message bases, you will now be asked if you REALLY
  914.            want  to continue, allowing you one last chance to change  your
  915.            mind.
  916.  
  917.       *    After a file base is sorted, one of two characters will  appear
  918.            at  the end of the base description: ".", indicating  that  the
  919.            base  was  not sorted, or "*", indicating that it  was  sorted.
  920.            (Previously, different characters were displayed, depending  on
  921.            which  sort was used, a feature useful to almost no one  except
  922.            the programmer.)
  923.  
  924.       *    For  security purposes, the file path is now displayed only  to
  925.            users  with  Co-SysOp  or higher access when a  bad  upload  or
  926.            download file path is encountered.
  927.  
  928.       *    The  "last few callers" list now displays five entries  instead
  929.            of  four  for users with less than Co-SysOp  access.   (Persons
  930.            with Co-SysOp or higher access still see 10 entries listed.)
  931.  
  932.       *    The file base list function output has been redesigned to  look
  933.            similar to that of the message base list function.
  934.  
  935.       *    Users can no longer enter a password that is equivalent to part
  936.            (or  all) of their user name.  For example, "Joe Hacker"  can't
  937.            use  the  passwords  "HACKER", "HACK", "JOE",  etc.   (Case  is
  938.            irrelevant to the comparison.)
  939.  
  940.       *    The  number of file points deducted for unlisted  downloads  is
  941.            now  configurable.   (Previously, it was fixed  at  5  points.)
  942.            Option N in System Configuration --> File System  Configuration
  943.            controls this value, which can range from 0 to 255.
  944.  
  945.       *    The  message displayed when the multi-tasking flag  is  enabled
  946.            can  now be configured in System Configuration --> String  Con-
  947.            figuration, screen #5.
  948.  
  949.  
  950.  
  951.  
  952.                                    - Page 14 -
  953.                   Telegard BBS Version 2.7 Upgrade Information
  954.  
  955.  
  956.       *    TRASHCAN.TXT will now be read in ALL cases where it is possible
  957.            for a new user to log on (shuttle menu, logon prompt, and "NEW"
  958.            at  logon  prompt).  Also, if an entry in  TRASHCAN.TXT  starts
  959.            with  an  asterisk, the word or phrase is used  in  a  wildcard
  960.            comparison;  otherwise,  an entry must match exactly  with  the
  961.            user's input.
  962.  
  963.       *    The  current date and time is inserted into the  message  title
  964.            when  a  user leaves private mail to the SysOp after  a  failed
  965.            chat attempt.
  966.  
  967.       *    The   "performing  daily  maintenance"  display  is  now   more
  968.            informative as to what is actually happening.
  969.  
  970.       *    The  user's date of birth and telephone number  (United  States
  971.            and  Canada  only) are now checked for valid formats.   In  the
  972.            case  of  the date of birth, the input itself  is  checked  for
  973.            valid values (i.e. no obviously erroneous "21/37/00" inputs).
  974.  
  975.       *    If  the shuttle menu is active, users cannot log on as  new  at
  976.            the  main logon prompt (thus thwarting jerks who may know  your
  977.            shuttle password and try to damage your system).  This does not
  978.            apply to a local (F)ast Logon.
  979.  
  980.  
  981.       BUG FIXES
  982.       ~~~~~~~~~
  983.       *    Canadian zip codes have now been fixed.
  984.  
  985.       *    Using MCI codes as the password when logging on to the BBS will
  986.            no longer lock up the system.
  987.  
  988.       *    In System Configuration --> BBS Configuration, the system,  new
  989.            user,  and  shuttle  logon passwords may now be  set  to  NULL.
  990.            Previously,  once a password was set, it could not be  removed.
  991.            (In  practice, only the new user password should be allowed  to
  992.            be NULL; setting the shuttle logon password to NULL defeats its
  993.            purpose, and if you set the system password to NULL, you  might
  994.            as well just forget about system security altogether!)
  995.  
  996.       *    Telegard   now   allows   all  eight  archive   types   to   be
  997.            defined/modified, instead of just the first six.
  998.  
  999.       *    If a new user indicates ANSI video but no color during the  new
  1000.            user logon procedure, color is enabled anyway.
  1001.  
  1002.       *    Pathnames  in the various System Configuration menus could  not
  1003.            be  set to NULL.  Note that setting certain pathnames  to  NULL
  1004.            could have adverse effects on the operation of your system!
  1005.  
  1006.       *    Pressing  <ENTER>  at the "Filename:" prompt  would  result  in
  1007.            "Error reading file" when using the Text File Editor.
  1008.  
  1009.  
  1010.  
  1011.                                    - Page 15 -
  1012.                   Telegard BBS Version 2.7 Upgrade Information
  1013.  
  1014.  
  1015.       USING EXISTING TELEGARD UTILITIES
  1016.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1017.       As  with any program, upgrading to a new version can mean that  pro-
  1018.       grams and utilities designed for older versions may not longer work,
  1019.       and  Telegard is no exception.  Listed below are the files that  are
  1020.       changed, along with certain notations as to how older utilities will
  1021.       work with the newly changed files.
  1022.  
  1023.       For  details on the changes between the old files and the  new,  you
  1024.       should  compare  the  file formats (contained  in  the  distribution
  1025.       archive) to their older counterparts.  Programmers, take note!
  1026.  
  1027.       *.BRD          Major changes.  Utilities which use these files  will
  1028.       *.MIX          have  to be updated.  (The biggest difference  is  in
  1029.                      the  way  the message text is  stored;  specifically,
  1030.                      each  message  is now stored as one  block  of  text,
  1031.                      rather  than  smaller blocks  representing  lines  of
  1032.                      text.)
  1033.  
  1034.       BBS.EXE        No longer used, and can be safely deleted (they  have
  1035.       BBS.OVR        been replaced with TELEGARD.EXE, which combines  both
  1036.                      files into one.)
  1037.  
  1038.       BOARDS.DAT     Major  changes.  Utilities which use this  file  will
  1039.                      have to be updated.
  1040.  
  1041.       FIDONET.DAT    Major   changes,  as  well  as  a  name  change   (to
  1042.                      NETWORK.DAT).   Utilities  which use this  file  will
  1043.                      have  to  be updated.  Since this file has  been  re-
  1044.                      named, it can be safely deleted.
  1045.  
  1046.       LASTON.DAT     Major  changes.  Utilities which use this  file  will
  1047.                      have to be updated.
  1048.  
  1049.       PRHELP.*       No longer used, and can safely be deleted.
  1050.  
  1051.       STATUS.DAT     No  major changes, aside from a few reassigned  flags
  1052.                      and  fields.  Most utilities should work with  little
  1053.                      or no change.
  1054.  
  1055.       STRING.DAT     No  major changes, though data has been  appended  to
  1056.                      the  end of the file; thus, utilities which use  this
  1057.                      file might have to be updated.
  1058.  
  1059.       USER.LST       Major  changes.  Utilities which use this  file  will
  1060.                      have to be updated.
  1061.  
  1062.       ZLOG.DAT       Minor  changes.  Most utilities which use  this  file
  1063.                      should work with little to no change.
  1064.  
  1065.       ZSCAN.DAT      No longer used, and can be safely deleted (its infor-
  1066.                      mation is now stored in USER.LST).
  1067.  
  1068.  
  1069.  
  1070.                                    - Page 16 -
  1071.                   Telegard BBS Version 2.7 Upgrade Information
  1072.  
  1073.  
  1074.       Any file not mentioned here can be assumed to have no changes,  thus
  1075.       requiring no updates to existing programs.
  1076.  
  1077.  
  1078.       MESSAGE SYSTEM CHANGES
  1079.       ~~~~~~~~~~~~~~~~~~~~~~
  1080.       As stated earlier, the message system has been completely rewritten.
  1081.       This  allowed  major changes and additions to be  made  to  Telegard
  1082.       while  REDUCING the overall size of the program!  The major  changes
  1083.       to the message system include:
  1084.  
  1085.            Internal  NetMail  support, with the ability  to  select/toggle
  1086.            message status flags.
  1087.  
  1088.            Message  bases may now be declared public- or private-only,  or
  1089.            combined  public/private.  This allows use of EchoMail  confer-
  1090.            ences  in  which messages must remain private, or  which  allow
  1091.            private  messages to be distributed.  (Currently,  only  public
  1092.            and private bases may be defined; public/private will be  added
  1093.            in a future release.)
  1094.  
  1095.            The  private mail base (Email), which was  previously  accessed
  1096.            through  special  commands, is now part of the  normal  message
  1097.            base layout.  It is base #0, and unlike other bases, it  cannot
  1098.            be deleted or locked out of a user's new message scan (NewScan)
  1099.            table.   It  is declared a private-only base,  and  except  for
  1100.            certain  features, cannot be altered via the Message Base  Edi-
  1101.            tor.
  1102.  
  1103.            The Message Base Editor has been modified to take into  account
  1104.            the various changes and enhancements to the message system.
  1105.  
  1106.            The  menu  commands relating to the message  system  have  been
  1107.            simplified, with some removed and others assigned to new  func-
  1108.            tions.
  1109.  
  1110.            MCI codes are no longer processed while displaying message text
  1111.            or  from/to/subject information.  This means that the  "@"  and
  1112.            "^"  characters  may now be included in  message  text  without
  1113.            screwing up.
  1114.  
  1115.            An interface for a full-screen message editor is now available.
  1116.  
  1117.            Various  changes  and enhancements to the message  reading  and
  1118.            writing functions.
  1119.  
  1120.       These  new features and enhancements are detailed below (not  neces-
  1121.       sarily in the order presented above).
  1122.  
  1123.                              The Message Base Editor
  1124.                              ~~~~~~~~~~~~~~~~~~~~~~~
  1125.       The  Message  Base Editor works, for the most part, much as  it  did
  1126.       before.  As stated above, the Private Mail message base is now  part
  1127.  
  1128.  
  1129.                                    - Page 17 -
  1130.                   Telegard BBS Version 2.7 Upgrade Information
  1131.  
  1132.  
  1133.       of  the overall message base layout (as base #0), but  unlike  other
  1134.       bases,  it  cannot be deleted or positioned, other bases  cannot  be
  1135.       inserted  before  it, and only certain fields may be  modified.   It
  1136.       also cannot be locked out of a user's message base NewScan table.
  1137.  
  1138.       Other changes you will find:
  1139.  
  1140.            NetMail is now among the choices of message base types.
  1141.  
  1142.            A  new  option has been added to select how  messages  will  be
  1143.            posted.   Currently, you may choose between "public" and  "pri-
  1144.            vate"; a future version will also add "public/private".   (Note
  1145.            that  most  EchoMail  and GroupMail conferences  do  NOT  allow
  1146.            private messages!)
  1147.  
  1148.            As MCI codes are no longer processed in message bases, the  ACS
  1149.            for MCI codes has been removed.
  1150.  
  1151.            Message base status flags have been altered:
  1152.  
  1153.                 The  "strip box/center codes" and  "center  boxed/centered
  1154.                 lines"  flags  have  been  replaced  with  "strip  message
  1155.                 codes", which performs the functions of both flags.
  1156.  
  1157.                 "Immune  to twitting" has been added.  This  prevents  the
  1158.                 message deletion ("twit") function of TeleMail from  oper-
  1159.                 ating  on  message bases  (useful  for  EchoMail/GroupMail
  1160.                 conference moderators who HAVE to monitor all messages  in
  1161.                 a conference).
  1162.  
  1163.                 "UUCP/Internet  handling"  has been added.  This  is  only
  1164.                 useful  for  Usenet conferences that have  been  gated  to
  1165.                 EchoMail  or  GroupMail.  When this flag is  enabled,  the
  1166.                 "To:"  field is displayed ONLY if it is not  "All"  (which
  1167.                 will  be 99% of the time) when reading messages,  and  the
  1168.                 "To:" field will be forced to "All" when writing messages.
  1169.                 (This  is due to the Usenet concept that all messages  are
  1170.                 intended for everyone, and thus should not be addressed to
  1171.                 any one person.)  True UUCP handling is NOT present;  that
  1172.                 may come in a future version.
  1173.  
  1174.            The color choice for text has been replaced with a color choice
  1175.            for  FTSC  kludge lines (default color = 7).   Regular  message
  1176.            text (not including kludge, quoted, tear, and origin lines)  is
  1177.            now shown as color #1 exclusively.
  1178.  
  1179.                           Message System Menu Commands
  1180.                           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1181.       The  menu  commands  for  the message  system  have  been  radically
  1182.       changed.   You should modify your MSG menu and make any  appropriate
  1183.       changes;  you might also want to add any of the new commands  listed
  1184.       below.
  1185.  
  1186.  
  1187.  
  1188.                                    - Page 18 -
  1189.                   Telegard BBS Version 2.7 Upgrade Information
  1190.  
  1191.  
  1192.            Cmdkeys:       MA
  1193.            Description:   Message base change
  1194.            MString:       [ base# [;menu] | + | - | L ]
  1195.  
  1196.                 Allows user to change to different message base.
  1197.  
  1198.                 If MString = "base#"     Change  to specified base.  If  a
  1199.                                          menu  is specified, that menu  is
  1200.                                          loaded if it exists.
  1201.                 If MString = "+"         Change to next base
  1202.                 If MString = "-"         Change to previous base
  1203.                 If MString = "L"         Lists available bases only
  1204.                 If MString = ""          Prompts for desired base
  1205.  
  1206.            Cmdkeys:       MC
  1207.            Description:   Check for messages in Private Messages base
  1208.            MString:       None
  1209.  
  1210.                 Allows user to check for, and read, messages to him/her in
  1211.                 the Private Messages base (#0).
  1212.  
  1213.            Cmdkeys:       MD
  1214.            Description:   Delete messages in message bases
  1215.            MString:       [ base# | C | G ]
  1216.  
  1217.                 Deletes messages written by the user.
  1218.  
  1219.                 If MString = "base#"     Delete in specified base
  1220.                 If MString = "C"         Delete in current base
  1221.                 If MString = "G"         Delete in all bases
  1222.                 If MString = ""          Prompt for current or all bases
  1223.  
  1224.            Cmdkeys:       ME
  1225.            Description:   Send message to user in Private Messages base
  1226.            MString:       [ user# [ ;[*]title ] ]
  1227.  
  1228.                 Allows  user  to  post message to specified  user  in  the
  1229.                 Private Messages base (#0).
  1230.  
  1231.                 User# must specify a valid user, and cannot be locked  out
  1232.                 or deleted.  If user# is 0, the user is allowed to specify
  1233.                 the user to whom the message is intended.
  1234.  
  1235.                 If  title is specified, it cannot be  changed;  otherwise,
  1236.                 user selects own title.  MCI codes may be used when speci-
  1237.                 fying  title.  If the first character of the title  is  an
  1238.                 asterisk ("*"), the user cannot abort the message.
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.                                    - Page 19 -
  1248.                   Telegard BBS Version 2.7 Upgrade Information
  1249.  
  1250.  
  1251.            Cmdkeys:       MK
  1252.            Description:   Pack message bases
  1253.            MString:       [ base# | C | G ]
  1254.  
  1255.                 Removes  deleted messages, and removes enough messages  to
  1256.                 make  message bases conform to the maximum number of  mes-
  1257.                 sages allowed for each base.
  1258.  
  1259.                 If MString = "base#"     Pack specified base
  1260.                 If MString = "C"         Pack current base
  1261.                 If MString = "G"         Pack all bases
  1262.                 If MString = ""          Prompt for current or all bases
  1263.  
  1264.            Cmdkeys:       MN
  1265.            Description:   Scan for new messages
  1266.            MString:       [ base# | C | G ]
  1267.  
  1268.                 Allows reading of new messages entered in message bases.
  1269.  
  1270.                 If MString = "base#"     Scan specified base
  1271.                 If MString = "C"         Scan current base
  1272.                 If MString = "G"         Scan all bases
  1273.                 If MString = ""          Prompt for current or all bases
  1274.  
  1275.            Cmdkeys:       MP
  1276.            Description:   Post message in current base
  1277.            MString:       None
  1278.  
  1279.            Cmdkeys:       MR
  1280.            Description:   Read messages in current base
  1281.            MString:       None
  1282.  
  1283.                 Allows  users to read messages in current base.   Messages
  1284.                 can  be read in forward or reverse order, messages  to  or
  1285.                 from the user may be read, and new or waiting messages may
  1286.                 be read.  User is prompted as to how he/she wants to  read
  1287.                 messages.
  1288.  
  1289.            Cmdkeys:       MS
  1290.            Description:   Scan titles of messages in current base
  1291.            MString:       None
  1292.  
  1293.                 Displays  titles of messages in current base.  Good for  a
  1294.                 quick  scan  of messages without having to  actually  read
  1295.                 them.
  1296.  
  1297.            Cmdkeys:       MU
  1298.            Description:   List users with access to current base
  1299.            MString:       None
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.                                    - Page 20 -
  1307.                   Telegard BBS Version 2.7 Upgrade Information
  1308.  
  1309.  
  1310.            Cmdkeys:       MW
  1311.            Description:   Scan for new messages waiting for user
  1312.            MString:       [ base# | C | G ]
  1313.  
  1314.                 Similar to MN, except that only new messages addressed  to
  1315.                 the user are displayed.  Also contrary to the MN  command,
  1316.                 the highest read message pointers are NOT updated.
  1317.  
  1318.                 If MString = "base#"     Scan specified base
  1319.                 If MString = "C"         Scan current base
  1320.                 If MString = "G"         Scan all bases
  1321.                 If MString = ""          Prompt for current or all bases
  1322.  
  1323.            Cmdkeys:       MZ
  1324.            Description:   Toggle message base NewScan flags
  1325.            MString:       None
  1326.  
  1327.                 Allows  the  user to allow or prevent message  bases  from
  1328.                 being scanned with the MN and MW commands.  Note that  the
  1329.                 status  of  base #0 (private messages) CANNOT  be  altered
  1330.                 with this command.
  1331.  
  1332.            Cmdkeys:       M#
  1333.            Description:   Allow message base change at menu prompt
  1334.            MString:       None
  1335.  
  1336.                 If this command is present in the menu, a user may  change
  1337.                 message  bases by entering the desired base number at  the
  1338.                 menu prompt.
  1339.  
  1340.            Cmdkeys:       M$
  1341.            Description:   Show configuration of current message base
  1342.            MString:       None
  1343.  
  1344.                 Displays  the  name, type, and other  aspects  of  current
  1345.                 message  base.  Users with Co-SysOp access or higher  will
  1346.                 also be shown the base password and ACS fields.
  1347.  
  1348.                                 Writing Messages
  1349.                                 ~~~~~~~~~~~~~~~~
  1350.       Writing messages is, for the most part, the same as it was in previ-
  1351.       ous  releases  of Telegard.  The few differences that exist  do  not
  1352.       (with  two exceptions) merit inclusion here; you and your users  are
  1353.       just going to have to find out for yourselves.
  1354.  
  1355.       The one difference that merits exception is message quoting.  Listed
  1356.       here are the differences in the quoting system in this release:
  1357.  
  1358.            Quoting now works in ALL cases when replying to a message.   In
  1359.            previous versions, it would not work in some cases.
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.                                    - Page 21 -
  1366.                   Telegard BBS Version 2.7 Upgrade Information
  1367.  
  1368.  
  1369.            The  "*** Quoting ... ***" header may now be defined in  System
  1370.            Configuration  --> String Configuration, screen #5.  Two  lines
  1371.            may be defined, and four special MCI codes are available:
  1372.  
  1373.                 @F   Inserts  the name of the person in the "From:"  field
  1374.                      of the replied-to message.
  1375.                 @T   Inserts the name of the person in the "To:" field  of
  1376.                      the replied-to message.
  1377.                 @D   Inserts the date of the message.
  1378.                 @A   Inserts the origin address of the message.
  1379.  
  1380.            Quoted lines are now shown six at a time, and users can  select
  1381.            how lines are to be added:
  1382.  
  1383.                 A    Add all lines shown.
  1384.                 F    Add from specified line.
  1385.                 T    Add to specified line.
  1386.                 R    Add range of lines.
  1387.                 O    Add a single line.
  1388.                 S    Skip to next set of lines.
  1389.                 Q    Return to editing message.
  1390.  
  1391.            The initials of the person shown in the "From:" field are  used
  1392.            in  front of the ">" quoting character.  Thus, a  message  from
  1393.            Joe  Public  would have "JP> " in front of  the  quoted  lines.
  1394.            This  helps immensely in attributing text to the proper  person
  1395.            when quoting.
  1396.  
  1397.       The  other  exception  is in how one can reply to  messages.   If  a
  1398.       message  originated locally, the user is prompted as to  whether  or
  1399.       not a private reply is desired.  If so, the message is posted in the
  1400.       Private Messages base instead of the current base.
  1401.  
  1402.       A  NetMail reply function is also available for use in EchoMail  and
  1403.       GroupMail bases.  If a user wishes to send NetMail to the person who
  1404.       wrote an EM/GM message, they can use the (N)etMail Reply function at
  1405.       the  "read messages" prompt.  Note that the user must  have  NetMail
  1406.       access, as well as enough NetMail credit, for this feature to  func-
  1407.       tion.
  1408.  
  1409.                                     NetMail
  1410.                                     ~~~~~~~
  1411.       After almost two years, Telegard finally supports NetMail  internal-
  1412.       ly.   For those of you unfamiliar with the concept, NetMail is  like
  1413.       Telegard's  private message base, except that the messages are  sent
  1414.       through a network like FidoNet to a user on another system.   (Thus,
  1415.       in order to use NetMail, you have to have a front-end mailer set up,
  1416.       and you have to be in an electronic network such as FidoNet.)
  1417.  
  1418.       To  set up NetMail on your system, you must first go to  the  System
  1419.       Configuration --> Network Configuration menu.  There you must set up
  1420.       various options pertaining to NetMail:
  1421.  
  1422.  
  1423.  
  1424.                                    - Page 22 -
  1425.                   Telegard BBS Version 2.7 Upgrade Information
  1426.  
  1427.  
  1428.            The  NetMail path should be the NetMail directory used by  your
  1429.            front-end mailer.
  1430.  
  1431.            The  nodelist path should be the directory that  contains  your
  1432.            compiled nodelist files.  Telegard uses the nodelist to  verify
  1433.            addresses  when  entering  NetMail; specifically,  it  uses  an
  1434.            Opus/BinkleyTerm  Version 6 format nodelist for  this  purpose.
  1435.            If you are already using BinkleyTerm, you need do nothing more.
  1436.            If,  however, you are using a mailer like FrontDoor,  you  will
  1437.            need  to create a Version 6 nodelist; utilities like  ParseLst,
  1438.            SysNL,  and  XlaxNode  will do this for you.   (The  Version  6
  1439.            nodelist can reside in the FrontDoor nodelist directory, as the
  1440.            filenames  are  different  and will  not  interfere  with  each
  1441.            other.)   IF YOU DO NOT SPECIFY A NODELIST DIRECTORY,  TELEGARD
  1442.            WILL NOT BE ABLE TO VERIFY ADDRESSES; all addresses will appear
  1443.            to be valid.  This, however, may be desirable by some SysOps.
  1444.  
  1445.            Users  with  Co-SysOp  access or higher  can  set  the  message
  1446.            attribute status bits when entering a NetMail message.  You can
  1447.            set  three attributes -- "crash", "hold", and "kill when  sent"
  1448.            -- to default to either "yes" or "no".  (The default configura-
  1449.            tion  is  to set "crash" and "hold" to NO, and  "kill/sent"  to
  1450.            YES.)
  1451.  
  1452.            Some  SysOps may wish to hold all NetMail entered by uses  with
  1453.            less than Co-SysOp access; this allows them to be reviewed,  so
  1454.            as  to prevent users from sending hundreds of messages  halfway
  1455.            around  the  world, thereby driving up your  phone  bill.   The
  1456.            "hold  all  user NetMail" option is used for this  purpose;  it
  1457.            defaults to YES.
  1458.  
  1459.       To  create a NetMail base, use the Message Base Editor to  create  a
  1460.       new message base.  Set the base type to NetMail, and use the NetMail
  1461.       path when asked for the message path.  The posting type will default
  1462.       to  Private,  as this is usually the intended  purpose  of  NetMail:
  1463.       private communications between two people.
  1464.  
  1465.       (Note that nothing prevents you from creating more than one  NetMail
  1466.       base; TeleMail will export messages from multiple NetMail bases just
  1467.       fine.   However,  on  import, TeleMail  will  toss  inbound  NetMail
  1468.       messages to the FIRST NETMAIL BASE ENCOUNTERED.  This may change  in
  1469.       a future version of TeleMail, but for now, keep that in mind.)
  1470.  
  1471.       A credit/debit system is used to control NetMail usage.  It is  used
  1472.       in  conjunction with the "cost" field in the Version 6 nodelist  (if
  1473.       you are not using a nodelist, the cost defaults to 0).  Rather  than
  1474.       try  to explain how it works, I'll use an example.  Suppose  a  user
  1475.       has a credit limit of 10000, and 0 in the debit field.  If that user
  1476.       enters  a NetMail message that costs 10 points, 10 will be added  to
  1477.       the  debit  field.  This process continues until the user  tries  to
  1478.       enter a message that, when its points are added to the debit  field,
  1479.       would exceed the credit limit; when that happens, the user will  not
  1480.       be able to enter the message (i.e. if the credit field is 10000, the
  1481.  
  1482.  
  1483.                                    - Page 23 -
  1484.                   Telegard BBS Version 2.7 Upgrade Information
  1485.  
  1486.  
  1487.       debit  field is 9995, and the point value of the NetMail message  is
  1488.       15; 9995+15=10010, which exceeds the credit limit).  At that  point,
  1489.       you  will  have to either increase the credit field, or  reduce  the
  1490.       debit  field  (determined by how you allow NetMail  access  on  your
  1491.       system).   It looks complicated at first, but once you  start  using
  1492.       it, it's actually quite simple.
  1493.  
  1494.       Finally,  a  nodelist look-up function is  available  when  entering
  1495.       NetMail  messages.   The  user can search  by  zone,  zone:net,  and
  1496.       zone:net/node.   Searching  by SysOp name is not available  at  this
  1497.       time, since the Version 6 nodelist format doesn't contain the  SysOp
  1498.       name.
  1499.  
  1500.                                Full-Screen Editor
  1501.                                ~~~~~~~~~~~~~~~~~~
  1502.       Telegard  now  has an interface for an external  full-screen  editor
  1503.       (FSE),  which many people find convenient for creating  and  editing
  1504.       messages.
  1505.  
  1506.       One such FSE is called QuickED, written by Dror and Oren Tirosh.  It
  1507.       is  generally  available as QED120.ZIP (for version  1.2).   QuickED
  1508.       will be used in the following examples, but any external FSE  should
  1509.       work  in its place, as long as it supports a FOSSIL driver and  ANSI
  1510.       codes.
  1511.  
  1512.       To install QuickED:
  1513.  
  1514.            1.   Unpack the archive into your main BBS directory.
  1515.  
  1516.            2.   Execute the QEDINST program.  Nothing needs to be changed,
  1517.                 so simply quitting the program (thereby saving the config-
  1518.                 uration  file)  is all that needs to be  done.   (You  can
  1519.                 experiment  with  QEDINST at a later date,  once  you  are
  1520.                 satisfied that the program is running properly.)
  1521.  
  1522.            3.   Load  the BBS.  Go to Miscellaneous  Configuration  (under
  1523.                 System  Configuration)  and change the  FSE  command  line
  1524.                 (option D) to read:
  1525.  
  1526.                      QUICKED @P @B @T 300
  1527.  
  1528.                 where @P is the port, @B is the BPS rate, @T is the amount
  1529.                 of time left in minutes, and 300 is the number of  seconds
  1530.                 until  timeout (a value which is not passed  by  Telegard;
  1531.                 thus, a hard-coded value must be used).
  1532.  
  1533.       Now,  whenever a user goes to post or reply to a  message,  Telegard
  1534.       will  ask if the user wishes to use the FSE (if the user is in  ANSI
  1535.       mode).
  1536.  
  1537.       If the user is replying to a message, a file called MSGTMP (with  no
  1538.       extension)  is created for the external editor in  a  ready-to-quote
  1539.       format.   It  is  a standard ASCII file with  the  familiar  quoting
  1540.  
  1541.  
  1542.                                    - Page 24 -
  1543.                   Telegard BBS Version 2.7 Upgrade Information
  1544.  
  1545.  
  1546.       prefix  ("XX>") already inserted before each line.  (QuickED  allows
  1547.       quoting from this file using the Ctrl-K Q option if it exists.)
  1548.  
  1549.       Upon returning from the FSE, Telegard expects the message to be in a
  1550.       file  called MSGTMP (the same file as the quote file).   The  format
  1551.       expected is normal ASCII, with 8D hexadecimal (141 decimal) used  to
  1552.       indicate  a soft carriage return, and a CR/LF sequence (0D 0A  hexa-
  1553.       decimal, 13 10 decimal) to indicate a hard carriage return.
  1554.  
  1555.       If  an  ERRORLEVEL of 0 is returned from the FSE,  Telegard  assumes
  1556.       that  the  FSE  has returned normally, and will  save  the  message.
  1557.       Otherwise, the message will not be saved.
  1558.  
  1559.       Note that users CANNOT use the FSE when writing messages that  can't
  1560.       be aborted (e.g. the new user application message).
  1561.  
  1562.  
  1563.       CONFERENCING
  1564.       ~~~~~~~~~~~~
  1565.       Conferencing allows you to separate message bases, file bases,  menu
  1566.       commands, and just about anything else in the system into individual
  1567.       categories... a feature that Telegard SysOps have long awaited.  The
  1568.       conferencing system in Telegard is implemented in a slightly differ-
  1569.       ent fashion from other systems.
  1570.  
  1571.       The key lies in two places: the Conference Editor ("$" at the  SysOp
  1572.       and  WFC screen menus) and the previously unused "Cx"  ACS  command.
  1573.       The Conference Editor works much like the other editors, in that you
  1574.       can  delete,  insert, and modify new conference  designators.   Each
  1575.       conference  can  be given a description and an ACS  requirement  for
  1576.       access  to the conference.  You can have up to 26 user-defined  con-
  1577.       ferences (labeled "A" through "Z").  An additional conference,  "@",
  1578.       is  designated the Main Conference, and is permanent (it  cannot  be
  1579.       removed);  it is the conference that users have access to when  they
  1580.       log on.  Thus, the ACS definition for "@" should allow access by all
  1581.       users.
  1582.  
  1583.       In order to separate features into conferences, the "Cx" ACS command
  1584.       is  used,  with "x" being a conference designator defined  with  the
  1585.       Conference  Editor.  Place this command into the ACS fields of  mes-
  1586.       sage  bases, file bases, menu commands, and other features that  you
  1587.       wish  to separate into conferences.  Once done, users CANNOT  access
  1588.       that  feature unless they are currently joined to  that  conference.
  1589.       (Not using "Cx" means that the feature is available to all users  at
  1590.       all  times... in other words, the feature is accessed just  like  it
  1591.       always has been.)
  1592.  
  1593.       The  new OR menu command is used to allow a user access  to  confer-
  1594.       ences.  The syntax of the OR command is as follows:
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.                                    - Page 25 -
  1602.                   Telegard BBS Version 2.7 Upgrade Information
  1603.  
  1604.  
  1605.            Cmdkeys:       OR
  1606.            Description:   Change to another conference
  1607.            MString:       [ <conference tag> | ? ]
  1608.  
  1609.                 The <conference tag> can be any character from A to Z,  or
  1610.                 @ to switch to the main conference.  If the conference  is
  1611.                 not defined, nothing is done.
  1612.  
  1613.                 If  MString is "?", all conferences available to the  user
  1614.                 are displayed.
  1615.  
  1616.                 If MString is blank (""), the user is prompted as to which
  1617.                 conference is desired.
  1618.  
  1619.       The most obvious places to insert this new command are in the  MAIN,
  1620.       MSG,  and FILE menus.  The connotation "(J)oin Conference"  is  sug-
  1621.       gested.
  1622.  
  1623.       The new *R command is used to allow access to the Conference Editor.
  1624.       Its syntax is as follows:
  1625.  
  1626.            Cmdkeys:       *R
  1627.            Description:   Enter Conference Editor
  1628.            MString:       None
  1629.  
  1630.       Finally,  there  are  two new MCI codes available  to  indicate  the
  1631.       currently selected conference:
  1632.  
  1633.                 @I   Returns the conference tag (@ or A..Z).
  1634.                 @J   Returns the conference description.
  1635.  
  1636.                              Conferencing Examples
  1637.                              ~~~~~~~~~~~~~~~~~~~~~
  1638.       Here's an example to get you used to the concept.  Suppose you  have
  1639.       several message and file bases devoted to programming, and you would
  1640.       like  to separate them from the rest of the bases.  To do this,  you
  1641.       would use the Conference Editor to create a new entry:
  1642.  
  1643.            Tag: P         Description: Computer Programming
  1644.  
  1645.       You  would then use the Message Base Editor to modify  the  program-
  1646.       ming-related  message bases, and the File Base Editor to modify  the
  1647.       programming-related file bases.  Modify the ACS fields of the  bases
  1648.       to insert the command "CP" (i.e. must be joined to conference "P" to
  1649.       have access).
  1650.  
  1651.       Now,  when  a user logs on, he/she will be in  the  Main  Conference
  1652.       ("@").   The  programming message and file bases will no  longer  be
  1653.       accessible.   In  order  for that user to access  those  bases,  the
  1654.       (J)oin  Conference  command must be used to select  conference  "P".
  1655.       When that is done, the message and file bases will suddenly  appear,
  1656.       and the user can access them normally.
  1657.  
  1658.  
  1659.  
  1660.                                    - Page 26 -
  1661.                   Telegard BBS Version 2.7 Upgrade Information
  1662.  
  1663.  
  1664.       This  is,  admittedly, a simple example.  The  capabilities  of  the
  1665.       conferencing  system are virtually unlimited, due to its being  con-
  1666.       trolled via ACS.  Entire menus can be created, for instance, devoted
  1667.       to  a single conference (a FIRSTCMD can be used with command  OR  to
  1668.       switch  to  the desired conference, and the (Q)uit  command  can  be
  1669.       chained to another OR command to switch back to the Main Conference)
  1670.       by  placing  the appropriate conference command into  the  menu  ACS
  1671.       field, as well as the command that accesses the menu.
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.                                    - Page 27 -
  1720.