home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / TAG / TAGD27.ZIP / NEW26F.DOC < prev    next >
Text File  |  1994-05-03  |  22KB  |  465 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                    /==============================================\
  7.                   < T.A.G. Version 2.6f New Features Documentation >
  8.                    \==============================================/
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.    /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  29.   /\/\/\/                     [>> Welcome to <<]                       \/\/\/\
  30.  |   /\/      ______________        ______          ___________         \/\   |
  31.  |  / /      /             /|      /     /|        /          /\         \ \  |
  32.  | / /       TTTTTTTTTTTTTT/       AAAAAA /|       GGGGGGGGGGG\/|         \ \ |
  33.  |/\/ /\           TT |           AA|___AA /|      GG |      GG/        /\ \/\|
  34.  |-< <  >          TT |          AA/     AA /|     GG |   _____        <  > >-|
  35.  |\/\ \/           TT |         AAAAAAAAAAAA |     GG |  /     /|       \/ /\/|
  36.  | \ \             TT |         AA |      AA |     GG |__GGGGGG |         / / |
  37.  |  \ \            TT |         AA |      AA |     GG/       GG |        / /  |
  38.  |   \/\           TT/   <>     AA/       AA/  <>   GGGGGGGGGGG/  <>    /\/   |
  39.   \/\/\/\                                                              /\/\/\/
  40.    \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                               /============================\
  59.                             / T.A.G. Bulletin Board System \
  60.                            <    Copyright (C) 1986-1993     >
  61.                             \       The T.A.G. Team        /
  62.                               \============================/
  63.  
  64.  
  65.                   /===============================================\
  66.                  < T.A.G. Version 2.6f  New Features Documentation >
  67.                   \===============================================/
  68.  
  69.    This release adds QWK support to T.A.G. internally.  Additionally, several
  70.    new features have been added for functionality, along with the usual
  71.    compliment of minor bug fixes.  To upgrade your T.A.G. version to 2.6f, you
  72.    should currently be running version 2.6d or later.  For prior version
  73.    upgrades, use the conversion programs for each interim release.
  74.  
  75.                            /=================================\
  76.                          < Highlights of T.A.G. version 2.6f >
  77.                            \=================================/
  78.  
  79.          * Internal QWK support
  80.             . Message Scanning/Packing        . LOGON/LOGOFF Screens
  81.             . New Bulletins                     .  New Files
  82.             . Netmail                            .  Special QWK files
  83.          * Automatic New Message Scan at logon for all flagged message areas
  84.          * Auto Add to Batch Download with display screens
  85.          * Include files in String Files supported
  86.          * Documented SDR codes
  87.          * Minor bug fixes
  88.  
  89.                  /=================================================\
  90.                 < Quick Start - For those that don't read the docs! >
  91.                  \=================================================/
  92.  
  93.          1.   Backup your system!  The conversion program will modify your
  94.                STATUS.DAT file and your MBOARDS.DAT file.  Make sure these are
  95.                backed up at minimum.
  96.  
  97.          2.   Run the conversion program CONV26F from your Main T.A.G.
  98.                (status.dat) directory. The conversion program will prompt you
  99.                for all new fields required, including your message base QWK
  100.                conference numbers and QWK names (read the rest of the docs for
  101.                the details on QWK additions. (Multi-node systems: Run once in
  102.                each main T.A.G. directory, but only change the Message boards
  103.                once!)
  104.  
  105.          3.   Copy the two new .BAT files (TAGARC.BAT, TAGUNARC.BAT) to your
  106.                main BBS directory.  (Multi-node systems, copy them several
  107.                times).
  108.  
  109.          4.   Copy the new default string files (TSTRDEF.TXT, MSTRDEF.TXT) to
  110.                your AFILES directory.
  111.  
  112.          5.   Compile your string files by running TAGSTR version 2.6f
  113.                (included) from your AFILES directory.
  114.  
  115.          6.   Replace your old TAG.EXE/TAG.OVR files with the new version.
  116.  
  117.          7.   Make sure your CONFIG.SYS file has at least 20 files allocated
  118.                (i.e. FILES=20).  Reboot your system if you make changes to the
  119.                CONFIG.SYS
  120.  
  121.          8.   Start the BBS, log on, and add any new commands (see the docs) to
  122.                the message (or main) menu. You can also create a "QWK" menu, and
  123.                consolidate the various QWK related commands and options on a
  124.                single menu.
  125.  
  126.  
  127.                   /===============================================\
  128.                  < T.A.G. Version 2.6f  New Features Documentation >
  129.                   \===============================================/
  130.  
  131.                              /=============================\
  132.                             < New Pkey/Pdata Commands Added >
  133.                              \=============================/
  134.  
  135.    The following is a list of all PKEYS/PDATA added to T.A.G. version 2.6f.
  136.  
  137.          Pkey  Pdata  Function
  138.          ----  -----  --------
  139.          "D"   "41"    Toggles "Logon scans all flagged message areas for NEW
  140.                         messages TO you" user flag. Message pointers are NOT
  141.                         updated. This command should be used by users to toggle
  142.                         whether a scan of all message areas is automatically
  143.                         done at logon.
  144.  
  145.          "D"   "42"    Toggles including new BULLETINS in QWK packets. If
  146.                         toggled ON, new Bulletins are automatically included in
  147.                         a users QWK packets.
  148.  
  149.          "D"   "43"    Toggles including new FILES list in QWK packets. If
  150.                         toggled ON, a new Files list will be generated and
  151.                         included in the users QWK packet.
  152.  
  153.          "N"   "T"     Scans all flagged message areas for NEW messages TO the
  154.                         user. Message pointers are NOT updated.  This is the
  155.                         same function that is automatically done at logon if the
  156.                         flag is ON for the user.
  157.  
  158.          "%"   "D"     Download QWK packet.  Scans and packs the flagged
  159.                         message bases for the user (according to access and
  160.                         system limits) and presents the file to the user for
  161.                         download. Aborted downloads are preserved in the QWK
  162.                         directory for subsequent downloading.
  163.  
  164.          "%"   "U"     Upload QWK packet.  Allows the user to upload the QWK
  165.                         replies and posts from the user, and tosses to the
  166.                         appropriate message areas as new posts, observing normal
  167.                         T.A.G. security for posts.
  168.  
  169.          "D"   <FileName>     [File Area Only] Auto Batch Download.
  170.                                  Automatically adds a list of files to the users
  171.                                  Batch Download queue.
  172.  
  173.  
  174.                   /===============================================\
  175.                  < T.A.G. Version 2.6f  New Features Documentation >
  176.                   \===============================================/
  177.  
  178.                                  /======================\
  179.                                 < New System Files Added >
  180.                                  \======================/
  181.  
  182.    Filename       Location   Description
  183.    ------------  --------    ------------------------------------------------
  184.    BULLET??.QWK  AFILES      Special QWK versions of Bulletin files.  If they
  185.                                  exist, they will be included in the user's QWK
  186.                                  packet instead of the standard BULLET??.MSG/CLR
  187.                                  files.
  188.  
  189.    LOGON.QWK      AFILES      Special QWK version of LOGON.MSG/CLR file. If it
  190.                                  exists, it will be included in the user's QWK
  191.                                  packet INSTEAD of the standard LOGON.MSG/CLR
  192.                                  files. Note: The additional (optional) LOGON*.MSG
  193.                                  or CLR files are NOT included in the QWK packets.
  194.  
  195.    LOGOFF.QWK     AFILES     Special QWK version of LOGOFF.MSG/CLR file. If it
  196.                                  exists, it will be included in the user's QWK
  197.                                  packet INSTEAD of the standard LOGOFF.MSG/CLR
  198.                                  files. Note: The additional (optional) LOGOFF*.MSG
  199.                                  or CLR files are NOT included in the QWK packets.
  200.  
  201.    TAGARC.BAT     MAIN        Batch file to pack QWK packets up for the user.
  202.                                  T.A.G. automatically shells to this batch file
  203.                                  after packing up a users messages. The parameters
  204.                                  passed to the batch file are:
  205.  
  206.                                  %1    Archive Type to use: ZIP, ARJ, LZH, PAK and
  207.                                        ARC are the only currently recognized types.
  208.  
  209.                                  %2    The name of the archive to create.  Created
  210.                                        from the BBSID field in the system config.
  211.  
  212.                                  %3    Path to the (temporary) directory where the
  213.                                        users QWK messages and control files are
  214.                                        stored.
  215.  
  216.    TAGUNARC.BAT  MAIN        Batch file to unpack QWK packets uploaded by the
  217.                                  user.  T.A.G. automatically shells to this batch
  218.                                  file after receiving an uploaded packet from the
  219.                                  user. The parameters passed to the batch file are:
  220.  
  221.                                  %1    Archive Type to use: ZIP, ARJ, LZH, PAK and
  222.                                        ARC are the only currently recognized types.
  223.  
  224.                                  %2    The path to the uploaded archive file. MUST
  225.                                        agree with the BBSID field in the system
  226.                                        config for the packet to be accepted by
  227.                                        T.A.G. for processing.
  228.  
  229.                                  %3    Path to the (temporary) directory where the
  230.                                        uploaded packet will be extracted.
  231.  
  232.  
  233.                   /===============================================\
  234.                  < T.A.G. Version 2.6f  New Features Documentation >
  235.                   \===============================================/
  236.  
  237.                         /=====================================\
  238.                        < New System Configuration fields added >
  239.                         \=====================================/
  240.  
  241.    B. System Information and Directories
  242.    =====================================
  243.  
  244.    Added "7. Board City, ST"
  245.          The City and State where your BBS is located.  This field is included
  246.          as part of the CONTROL.DAT file sent to a QWK user.
  247.  
  248.    Added "8. Board QWK ID"
  249.          This is the FILENAME (8 Char) that will be sent to the user when doing
  250.          a QWK Download. It is also imbedded into his CONTROL.DAT file sent
  251.          with the QWK packet, and it is checked on his Reply Packet.
  252.  
  253.          Reply packets without this identifier will not be tossed (i.e., a user
  254.          can't download from one board, then upload the reply packet to another
  255.          system.
  256.  
  257.    Added "G. QWK packet directory"
  258.          This is the "BASE" directory T.A.G. will use for QWK packets. For each
  259.          user, T.A.G. will create, under this "BASE" directory, a subdirectory
  260.          called "QWK####", where the #### is the (left zero padded) user
  261.          number.
  262.  
  263.          T.A.G. will automatically create and clean up this subdirectory as
  264.          necessary.
  265.  
  266.                              /=============================\
  267.                             < New Message Area Fields Added >
  268.                              \=============================/
  269.  
  270.    Message Board Editor
  271.    ====================
  272.  
  273.    Added "L. Qwk Info"
  274.          Conference=####
  275.          This is a *UNIQUE* number associated with the message area.
  276.  
  277.          Once set, this conference number should NOT be changed.  QWK uses
  278.          these conference numbers in REP (Reply) packets.
  279.  
  280.          Setting the Conference number to ZERO means that the area WILL NOT BE
  281.          QWK SCANNED, in spite of user scan settings.
  282.  
  283.          Name=<10 Character Conference Name>
  284.          This is the (short) name of the conference sent in the QWK packet.
  285.          This field is for the QWK users benefit only; T.A.G. makes no use of
  286.          it except to include it in the QWK packet.  However, if the Name field
  287.          is NOT set, the area WILL NOT BE QWK SCANNED, in spite of any user
  288.          scan settings.
  289.  
  290.  
  291.  
  292.                   /===============================================\
  293.                  < T.A.G. Version 2.6f  New Features Documentation >
  294.                   \===============================================/
  295.  
  296.                                /==========================\
  297.                               < QWK Netmail Kludge Support >
  298.                                \==========================/
  299.  
  300.    T.A.G. supports the Netmail kludge for QWK.  If the 1st line of the QWK
  301.    message (in the netmail area) is TO: <Address> the message will be posted
  302.    Netmail with the usual TAG restrictions (Credit, valid address, etc.)
  303.  
  304.                                    /===================\
  305.                                   < Auto Batch Download >
  306.                                    \===================/
  307.  
  308.          Pkey: "D"
  309.          Pdata: <FileName>  (8 Characters, No Extension)
  310.  
  311.          The file area download command (Pkey "D") has been modified to also
  312.          accept Pdata.  The pdata is an 8 character file name (no extension).
  313.  
  314.          The file name (supplied in the Pdata) refers to two separate files,
  315.          both located in the AFILES directory.  Both files must exist, or an
  316.          error message is sent to the user, and logged to the sysop log.
  317.  
  318.    <FileName>.MSG/CLR        This file is displayed to the user prior to adding
  319.                                  the files to the batch download queue.
  320.  
  321.    <FileName>.TXT             This is a list of files to add to the batch
  322.                                  download queue.  The format of each line of the
  323.                                  file is:
  324.  
  325.                                  <Absolute Pathname to File>  [NR]  [;Comment]
  326.  
  327.    The ";" character is used for comments, these are for the sysops reference
  328.    only, they are never displayed to the user.
  329.  
  330.    Each file is checked for existence prior to executing the command. If ANY
  331.    file does not exist, or any one of the files is illegal to download, the
  332.    command will fail with an error message to the user and a note in the sysop
  333.    log.
  334.  
  335.    The (optional) "NR" indicates that there is "No Ratio" for the file.
  336.  
  337.  
  338.                   /===============================================\
  339.                  < T.A.G. Version 2.6f  New Features Documentation >
  340.                   \===============================================/
  341.  
  342.                                   /====================\
  343.                                  < String Files Updated >
  344.                                   \====================/
  345.  
  346.    Several strings were added to the default string files (Most associated
  347.    with QWK). In particular, the Archive types for QWK packets are
  348.    programmable to a limited extent.  You CANNOT add other archive types;
  349.    however, you can eliminate one or more of the archive types.
  350.  
  351.    The following strings were added:
  352.  
  353.    String Name                          Displayed to user when
  354.    ------------------------------   ----------------------------------------
  355.    FILE_INTERIOR_UNKNOWN_OR_BAD      Unable to determine archive type
  356.    MESSAGE_QWK_NO_NETMAIL_ADDRESS   No TO: line in Netmail QWK message
  357.    MESSAGE_QWK_PENDING                QWK packet from prior scan exists
  358.    MESSAGE_QWK_SCAN_HEADER            Scanning/Packing QWK messages
  359.    MESSAGE_SCAN_NEW_TO_USER          New scan all flagged bases
  360.    MESSAGE_SCANNING_ABORTED          Aborted New message scan
  361.  
  362.    In addition, T.A.G. now supports an INCLUDE directive in the string files.
  363.    The syntax is:
  364.  
  365.          #INCLUDE <Path to file>
  366.  
  367.    This feature makes imbeding of ANSI, etc. much cleaner, and permits the
  368.    files to be edited.  NOTE: the included file is compiled into the *.DAT
  369.    files.  Changing the include file requires re-compiling the string files to
  370.    take effect.
  371.  
  372.                                       /===============\
  373.                                     < FILES= Required >
  374.                                       \===============/
  375.  
  376.    Because of the method T.A.G. uses for QWK packing, the minimum recommended
  377.    number for FILES= in your CONFIG.SYS file is now 20.
  378.  
  379.  
  380.  
  381.                   /===============================================\
  382.                  < T.A.G. Version 2.6f  New Features Documentation >
  383.                   \===============================================/
  384.  
  385.                                          /=========\
  386.                                         < SDR codes >
  387.                                          \=========/
  388.  
  389.    In the last release, several SDR codes were added but undocumented. Below
  390.    is a complete list of current SDR (User and System) SDR codes.
  391.  
  392.    User Info: To obtain user info, use the code Ctrl-U (For User) followed by
  393.    a letter (case insensitive) indicating the particular information required.
  394.    The code letters used were chosen to match the current "user editor" codes
  395.    as nearly as possible.
  396.  
  397.         A : Address           B : Highest Baud        C : City, State
  398.         D : DSL               E : Special Flags       F : AR Flags
  399.         G : Birthday          H : Help Level          I : Last DL Base
  400.         J : User Name         K : Sysop Note          L : Laston Date & Time
  401.         M : Mailbox Status    N : First On Date       O : Expiration date
  402.         P : Phone             Q : Unused              R : Real Name
  403.         S : Security Level    T : Computer Type       U : User's first name
  404.         V : Phone number 2    W : Unused              X : Screen (Rows x Cols)
  405.         Y : Extra info  *     Z : Zip Code
  406.  
  407.         1 : # of Downloads    2 : DL K-Bytes          3 : # of Uploads
  408.         4 : UL K-Bytes        5 : Number of Calls     6 : Total Time On
  409.         7 : Calls Today       8 : Time On Today       9 : Unused
  410.         # : User Number       $ : Debit / Credit      * : Time on (hh:mm:ss)
  411.         ^ : Points            @ : Time Bank           % : Time left (minutes)
  412.         ! : Time left (hh:mm:ss)
  413.  
  414.         *  The "Y" should be followed by a single letter:
  415.            A: Extra string 1      B: Extra string 2       C: Extra string 3
  416.            D: Extra date 1        E: Extra date 2         F: Extra number 1
  417.            G: Extra number 2      H: Extra number 3       I: Extra number 4
  418.            J: Extra character 1   K: Extra character 2    L: Extra character 3
  419.            M: Extra character 4   N: Extra phone number
  420.  
  421.    System Info: To obtain system info, use the code Ctrl-S (For System)
  422.    followed by a letter (case insensitive) indicating the particular
  423.    information required.
  424.  
  425.         A : AltPath           B : BoardName           C : LastCaller
  426.         D : Current date      E : ErrorsToday         F : Uboards.Name
  427.         G : GfilesPath        H : NusersToday         I : MailAddress
  428.         J : Current FB #      K : Current FB NoCharge L : Unused
  429.         M : ActiveMB.Name     N : CallerNum           O : Current MB #
  430.         P : BoardPhone        Q : Unused              R : Current MB # ActMsgs
  431.         S : SysopName         T : CurrentTime         U : multiuserpath
  432.         V : TAGVersion        W : MsgGroupMask        X : NumberActiveUsers
  433.         Y : FileGroupMask     Z : ChatPW
  434.  
  435.         1 : MaxBdNum          2 : MaxBuNum            3 : UlKtoday
  436.         4 : DlKtoday          5 : CallsToday          6 : MsgPostToday
  437.         7 : EmailToday        8 : FbackToday          9 : UlToday
  438.         0 : DlToday           # : MU Node Number      % : PercentActive
  439.         ! : Current Date/Time Extended Format
  440.  
  441.  
  442.                   /===============================================\
  443.                  < T.A.G. Version 2.6f  New Features Documentation >
  444.                   \===============================================/
  445.  
  446.                                         /==========\
  447.                                        < Bugs Fixed >
  448.                                         \==========/
  449.  
  450.    There has been the usual minor bug fixing, speling and gramer fixes, etc.
  451.    Here's a few that might be worth noting:
  452.  
  453.    //TimeDate prompting twice for the date.  *FIXED*
  454.  
  455.    ")" Pkey (New-New DOOR.SYS) worked, but returned a message after the shell
  456.    saying "Pkey inoperative".  *FIXED*
  457.  
  458.    The "StatusPath" command line parameter wasn't working.  *FIXED*
  459.  
  460.    "INTL" Kludge was not always added to Netmail messages, causing some
  461.    confusion with mail to other zones/networks.  *FIXED*
  462.  
  463.    Editing the system configuration "Temp DL Path" would prompt for "Current
  464.    Nodelist Directory".  *FIXED*
  465.