home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / TAGBBS / TAGM25G.ZIP / NEW25G.DOC < prev    next >
Encoding:
Text File  |  1990-10-02  |  23.8 KB  |  556 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                       /========================================\
  10.                      < T.A.G. Version 2.5g Update Documentation >
  11.                       \========================================/
  12.  
  13.  
  14.  
  15.  
  16.  
  17.   /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  18.  /\/\/\/                     [>> Welcome to <<]                       \/\/\/\
  19. |   /\/      _____________         ______          ___________         \/\   |
  20. |  / /      /            /|       /     /|        /          /\         \ \  |
  21. | / /       TTTTTTTTTTTTTT/       AAAAAA /|       GGGGGGGGGGG\/|         \ \ |
  22. |/\/ /\           TT |           AA|___AA /|      GG |      GG/        /\ \/\|
  23. |-< <  >          TT |          AA/     AA /|     GG |   _____        <  > >-|
  24. |\/\ \/           TT |         AAAAAAAAAAAA |     GG |  /     /|       \/ /\/|
  25. | \ \             TT |         AA |      AA |     GG |__GGGGGG |         / / |
  26. |  \ \            TT |         AA |      AA |     GG/       GG |        / /  |
  27. |   \/\           TT/   <>     AA/       AA/  <>   GGGGGGGGGGG/  <>    /\/   |
  28.  \/\/\/\                                                              /\/\/\/
  29.   \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  30.  
  31.  
  32.  
  33.  
  34.  
  35.          _____________________________________________________________  
  36.         /                                                             \  
  37.        (     T.A.G. 2.5g - Copyright (C) 1986-1990 Robert Numerick,    )  
  38.         \________________     and Victor Capton.     _________________/  
  39.                          \__________________________/   
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 1
  48.  
  49.  
  50.                            ***************************
  51.                            * Changes to Version 2.5g *
  52.                            ***************************
  53.  
  54.  
  55.                                 -----------------
  56.                                 Conversion Issues
  57.                                 -----------------
  58.  
  59.      1. Changing LOGON.BAT and NEWLOGON.BAT files:
  60.  
  61.                                 *** IMPORTANT ***
  62.           A  correction  has  been made  to  the  parameters  passed to  the
  63.           LOGON.BAT and  NEWLOGON.BAT files.   They  now follow  the generic
  64.           door parameters passed  on all  door calls.   Normally you  should
  65.           have  never used parameters %1 and %2  in your batch files, so all
  66.           the  is necessary  in  most  cases is  to  subtract  two from  any
  67.           remaining parameters in your  batch file (e.g. "%5 %7  %3" becomes
  68.           "%3 %5 %1").  Please check both your LOGON.BAT and NEWLOGON.BAT to
  69.           see if they  are effected  (call back verification  doors are  one
  70.           common  program likely effected).  The generic door parameters are
  71.           as follows:
  72.  
  73.                1 = Baud rate
  74.                2 = Time remaining on-line in minutes
  75.                3 = User number
  76.                4 = First name
  77.                5 = Last name
  78.                6 = ANSI graphics (1=On, 0=Off)
  79.                7 = Communications port
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 2
  88.  
  89.  
  90.      2.   Setting "Uses custom menus" flags on existing users:
  91.  
  92.           To turn ON the new  "Uses custom menus" flag on all  your existing
  93.           users and the new user record, the following step must be taken:
  94.  
  95.                1.   Enter the user editor.
  96.                2.   Select the new user record with the "\" command.
  97.                3.   Choose  the  extended display  with  the  "N" (New  list
  98.                     mode),   "E" (Extended),    "Y" (Yes,   Autolist   mode)
  99.                     keystrokes.
  100.                4.   On the  second to  last line  just to  the right of  the
  101.                     center, check to  see if the "Custom" flag Is  "On".  If
  102.                     so, the new user  record is already correct and  you can
  103.                     proceed to step 6.  If OFF, continue with step 5.
  104.                5.   Select "+"  for the Configuration Flags  and select flag
  105.                     "A".  This  toggles the flag OFF.  Verify that Custom is
  106.                     now displayed as ON.
  107.                6.   Enter the Options Menu with the "O" command.
  108.                7.   Select "Config. flags set"  with the "+" key  and toggle
  109.                     the "A" flag.
  110.                8.   Using the "L" command, verify that the Config. flags set
  111.                     are  "A-----------------------"  and   that  all   other
  112.                     options are <<Inactive>>.
  113.                9.   Use the "T" command to tag all users with the A flag and
  114.                     select  Union by pressing "1".   All users  who have the
  115.                     Uses Custom Menus flags have now been tagged.
  116.                10.  Invert the tag  table with  the "I" command.   Now  only
  117.                     users with the A flag OFF will be tagged.
  118.                11.  Press "S" to show tagged users.   If none are found, you
  119.                     are done; otherwise continue with step 12.
  120.                12.  Press "Q" to go back to the User Editor.
  121.                13.  Press "/" for a tagged change.
  122.                14.  Select "+"  for Configuration flags, answer  the warning
  123.                     question "Y" and toggle the A  flag.  This will turn the
  124.                     flag ON for all tagged users. 
  125.  
  126.                You are done! <whew!>
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 3
  135.  
  136.  
  137.      3. Clearing any existing "C" flags on your users:
  138.  
  139.           The  "C"  special  flag  is  no  longer  used  by  the system  for
  140.           prevention  of posting the auto  message.  This restriction should
  141.           be placed on the menu command  itself if you wish to  specifically
  142.           restrict users.  To clear all existing "C" special flags following
  143.           these steps:
  144.  
  145.                1.   Enter the user editor
  146.                     WARNING:  Exit the user editor and reenter it if you are
  147.                               already there from the previous step.
  148.                2.   Select the new user record with the "\" command.
  149.                3.   On the third line on the right side, check to see if the
  150.                     "SF" flag "C" is active.  If it is "-" (not active), the
  151.                     new user record is already  correct and you can  proceed
  152.                     to step 5.  If it is active ("C") continue with step 4.
  153.                4.   Select "E"  for the special  flags and choose  flag "C".
  154.                     This toggles the flag OFF.  Verify that "SF" flag "C" is
  155.                     now displayed as "-" (inactive).
  156.                5.   Enter the Options Menu with the "O" command.
  157.                6.   Select Special flags set with the "4" key and toggle the
  158.                     "C" flag.
  159.                7.   Using the "L" command, verify that the Special flags set
  160.                     are  "--C---------------------"  and   that  all   other
  161.                     options are <<Inactive>>.
  162.                8.   Use  the "T" command to tag all users with the C special
  163.                     flag  and select Union by  pressing "1".   All users who
  164.                     have the C special flag have now been tagged.
  165.                9.   Press "S" to show tagged users.   If none are found, you
  166.                     are done; otherwise continue with step 10.
  167.                10.  Press "Q" to go back to the User Editor.
  168.                11.  Press "/" for a tagged change.
  169.                12.  Select  "E"  for  Special   flags,  answer  the  warning
  170.                     question "Y" and toggle  the C special flag.   This will
  171.                     turn the special flag C OFF for all tagged users. 
  172.  
  173.                That's it!
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 4
  182.  
  183.  
  184.      3. Setting new options in system configuration:
  185.  
  186.           Single value security settings:
  187.  
  188.                $. SL/AR/Password for the Control-U command (** IMPORTANT **)
  189.  
  190.           Optional flagged functions:
  191.  
  192.                3. Force scan before upload
  193.                4. Local logon SysOp window
  194.                5. Show files open
  195.  
  196.                NOTE:     Option 5  is a last minute  undocumented feature to
  197.                          display and log the number of open files in DOS and
  198.                          the number of open files T.A.G.
  199.  
  200.                NOTE:     You may have to toggle these options more that once
  201.                          initially  to get them in "sync" and get rid of any
  202.                          garbage information in that location.
  203.  
  204.  
  205.      4. Adding new commands to the standard menus:
  206.  
  207.           Personal Data Menu
  208.  
  209.                Long desc.   : (8)Toggle use of custom menus ON/OFF
  210.                Short desc.  : (8)Toggle menus
  211.                Key          : 8
  212.                Program key  : D
  213.                Program data : "23"
  214.  
  215.           File Transfer Menu
  216.  
  217.                Long desc.   : (/U)sers with access to the current section
  218.                Short desc.  : (/U)
  219.                Key          : /U
  220.                Program key  : M
  221.                Program data : ""
  222.  
  223.                Long desc.   : (/I)nterior listing of archives by description
  224.                Short desc.  : (/I)nteriorDesc
  225.                Key          : /I
  226.                Program key  : I
  227.                Program data : "@"
  228.  
  229.                Long desc.   : (//INTGLOB)Interior listing for all sections
  230.                Short desc.  : (//INTGLOB)al
  231.                Key          : /I
  232.                Program key  : I
  233.                Program data : "G"
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 5
  242.  
  243.  
  244.                                    ------------
  245.                                    New Features
  246.                                    ------------
  247.  
  248.      A limited number of SDR (System Data Reference) codes are now available
  249.      for  the  SysOp to  use in  text files.    These codes  are dynamically
  250.      replaced with  the current  available user/system information  when the
  251.      file is actually printed.  Be  advised!  Theses are NOT consistent with
  252.      the proposed v2.6/3.0 TAG codes.  So  the screens you do today will not
  253.      work  when Victor gets done.   But these are here  today.  See the main
  254.      documentation for detailed information on implementing SDR codes.
  255.  
  256.  
  257.      Events  have been  completely  reworked.   The  event editor  is  still
  258.      accessible  through the  normal method, either  Control-"Q"/(E)vents or
  259.      using a command  on a menu  with PKey="1" and  PData="V".  However  all
  260.      your  original events  must be  re-entered into  the new  event system.
  261.      T.A.G. now  allows you to define an unlimited number of events.  Events
  262.      fall  into  two  different categories,  Internal  and  External.   What
  263.      follows is only a brief overview of the new event system.
  264.  
  265.                                  Internal Events
  266.                                  ---------------
  267.  
  268.           An internal event is a condition defined by the SysOp  that exists
  269.           for a specified  period of time.  There are  two types of internal
  270.           events, Logon events and Chat  events.  A logon event may  be used
  271.           to modify  the user's access to  your system; a chat  event may be
  272.           used to modify the  status of the SysOp Available flag  (note this
  273.           effect will not be seen on the wait screen because events are user
  274.           dependent).   At  logon, T.A.G.  will determine  which  events are
  275.           active and make any  adjustments to the user's access  required or
  276.           allocated  time.  Both logon and chat  events can be classified as
  277.           either restriction  or permission  events.  Optional  messages are
  278.           available  when a user is  either "affected" or  "unaffected" by a
  279.           particular event.   The four different  combinations of logon/chat
  280.           and restriction/permission events are:
  281.  
  282.                1.   Internal  Logon Restriction  Events:   Logon restriction
  283.                     events are used  to prevent a  user who matches  certain
  284.                     defined criterion  (out-of-balance, baud rate,  SL, DSL,
  285.                     AR  flags) from being able to log onto your board during
  286.                     specified times.
  287.  
  288.                2.   Internal  Logon  Permission  Events:    Logon permission
  289.                     events permit the SysOp  to define that the  system will
  290.                     change a user's permissions at logon in one of two ways.
  291.                     1) By setting or clearing an AR flag, and/or 2) reducing
  292.                     his/her allocated time.
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 6
  301.  
  302.  
  303.                3.   Internal  Chat  Restriction  Event:    Chat  restriction
  304.                     events are  used to turn  off the  SysOp Available  flag
  305.                     when    a   user    who   matches    certain   criterion
  306.                     (out-of-balance, baud rate, SL, DSL, AR flags) logs onto
  307.                     your board during specified times. 
  308.  
  309.                4.   Internal Chat Permission Event:   Chat permission events
  310.                     are used to turn on the Sysop Available flag when a user
  311.                     who  matches  certain  criterion  (out-of-balance,  baud
  312.                     rate, SL, DSL,  AR flags)  logs onto  your board  during
  313.                     specified times.
  314.  
  315.                                  External Events
  316.                                  ---------------
  317.  
  318.           An external event is an activity that will be executed from T.A.G.
  319.           at a scheduled time from the wait screen.   There are two types of
  320.           external events, hard and soft events.  Hard events are similar to
  321.           T.A.G.'s original event  system -  an activity is  scheduled at  a
  322.           given  time and,  if necessary,  T.A.G. adjusts  a user's  time to
  323.           force him/her  off of the system  so that the event  will occur at
  324.           exactly the  time  specified.   Soft  events  function  like  hard
  325.           events,  except they  are  set to  occur  at the  first  available
  326.           opportunity at or after the  specified time without restricting  a
  327.           user's time.  External events are executed in one of  two ways, 1)
  328.           by halting  T.A.G. completely  and allowing the  controlling batch
  329.           program to  run a program(s) based on the error code set by T.A.G.
  330.           upon exit and, 2) through a DOS shell.
  331.  
  332.  
  333.      The  is now  another SysOp Hot  Key available  in several  areas of the
  334.      board.  The control-U key, (Dubbed "Quick User Editor") a "smart" entry
  335.      into  the user editor.   The control-U  will bring up  the user editor,
  336.      displaying the record of  the user whose message/file you  were looking
  337.      at.  If it can't find the user of interest, it brings up the  record of
  338.      the  person currently on-line.   Control-U is configured  in the system
  339.      configuration similar to the control-Q command.   Additionally there is
  340.      a YES/NO option to bypass the  normal password request.  The  Control-U
  341.      is active during the following operations:
  342.           1.   Reading private mail (yours or all)
  343.           2.   Reading public messages
  344.           3.   Browsing files
  345.           4.   Editing files
  346.           5.   Validating files
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 7
  355.  
  356.  
  357.      This upload command now optionally permits SysOp to force users to scan
  358.      for duplicates  prior  to upload.   Toggle  this option  ON/OFF in  the
  359.      system configuration  under optionally  flagged functions, option  "3".
  360.      When active, T.A.G. analyzes the upload file and intelligently modifies
  361.      it for a "best" scan.  For example, a user uploading TDRAW330.ZIP would
  362.      be given a file mask of TDRAW*.* for the scan.  The user has the option
  363.      of accepting or modifying the mask provided that s/he does  not make it
  364.      too general  or so that it  no longer matches the file  to be uploaded.
  365.      Normal  users can  abort  this scan  immediately  or during  the  scan.
  366.      However, a  user who has been  given the "C" special  flag cannot abort
  367.      the scan and must scan before uploading.
  368.  
  369.  
  370.      A new command has  been added to the file section  which allows a users
  371.      to  list  all users  with access  to the  current  file section.   This
  372.      command functions the  just like the (U)sers with access command in the
  373.      message section.
  374.  
  375.  
  376.      A new  command "(%)User History" has  been added in the  user editor to
  377.      show the a user's log  history.  This command traces back  through your
  378.      SYSOP###.LOG files and shows the activities of the user that you're
  379.      currently looking at.
  380.  
  381.  
  382.      The SysOp  can now configure the  system to leave the  SysOp window off
  383.      during local logons.
  384.  
  385.  
  386.      An "I"  sub-command has been added  on the reading public  mail menu to
  387.      allow  a user to  ignore all remaining  unread messages in  the current
  388.      base.
  389.  
  390.  
  391.      Placing a Control-P  (^P) on a line  by itself inside a  test file will
  392.      not force a pause at that point when printing the file.
  393.  
  394.  
  395.      The SYSOP.LOG now closes at the  first opportunity at or after midnight
  396.      even  when a user is on-line (rather  than waiting for the first caller
  397.      of the day).
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 8
  406.  
  407.  
  408.      A new file (placed  in the alternate directory)  called NOBOARD.MSG/CLR
  409.      has been added.   Use of this file by  the SysOp will help to  reduce a
  410.      new user's confusion  when s/he tries  to access file boards  which are
  411.      restricted solely because s/he  has not been validated.   Because a new
  412.      user can see  these boards from the "File Areas"  command, s/he may try
  413.      to access  them  only to  be  told "Invalid  board  number".   This  is
  414.      especially  a problem when the new user  does not have color and cannot
  415.      see  the  difference  between  green and  yellow  (which  distinguishes
  416.      restricted boards from  unrestricted ones).  In  addition, The internal
  417.      phrase  printed if the file is not  present has been softened to "Board
  418.      only available to validated users".
  419.  
  420.  
  421.      A new  configuration flag now exists to  allow users to optionally turn
  422.      off  custom menus  which the  SysOp may have  created and  use T.A.G.'s
  423.      internal menus.
  424.  
  425.  
  426.      The GIF resolution routines have been  modified to support Compu$erve's
  427.      new GIF89a resolution.
  428.  
  429.  
  430.      The download commands now  recognize "relaxed" file specifications like
  431.      the MOVE, EDIT, INTERIOR, SCAN and LIST commands already have.
  432.  
  433.  
  434.      The TRASHCAN.TXT  file now allows comments.  Follow the name by a space
  435.      and a semi-colon, then whatever text you like.  This will  make it easy
  436.      for you to remember why a user was put in the trash can.
  437.      Examples:
  438.        GEORGE WILBERSKIN ;Logged on 3 account names, FLIPPER, ZORRO and BUD
  439.        PETER ELBLITZ ;Tried to hack board on 7/12/90
  440.  
  441.  
  442.      There is a new option in the protocol editor.  Pressing control-<P> <R>
  443.      will produce the user's real baud rate so it can be passed  to external
  444.      protocols.   This is mainly used  to the protocols to  let the protocol
  445.      calculate the real transfer time (for locked baud systems).
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.              T.A.G. BBS Version 2.5g -  Update Documentation - Page 9
  454.  
  455.  
  456.      Custom menus  for T.A.G.  can now  be created  by SL  (security level).
  457.      Before  discussing how to  make an SL  specific menu,  let's review the
  458.      convention for a generic custom  menu.  The first part of  the filename
  459.      for the menu is derived from  the HELPID file name in the menu  when it
  460.      is created.  For  example, the name "MAIN" might  be used for a  custom
  461.      menu for  the main menu.   Then, the particular help  level is attached
  462.      (eg.  "MAIN2","MAIN3", or  "MAIN4").  Then,  the extension  is applied,
  463.      depending on whether the user's ANSI flag is on, resulting in the
  464.      full names  "MAIN2.CLR", "MAIN2.MSG" ... "MAIN4.CLR",  "MAIN4.MSG".  We
  465.      tried  to keep this  scheme.  To  create an SL  specific menu, you just
  466.      append a -<SL> to the file name.  The only problem is that you may need
  467.      to shorten your menu names to accomplish this, since "MAIN1-255" is one
  468.      character  too long.   But  "MAI1-255" is  just right.   Why  the dash?
  469.      Because it's easier  to see the SLs for which  you have designed custom
  470.      menus  when doing a directory at DOS.   One final note:  An SL specific
  471.      custom  menu overrides the normal  custom menu.   If "MAI3-100.CLR" and
  472.      "MAI3.CLR" both exist, a user with an SL of 100 will see the "MAI3-100"
  473.      at help level 3.
  474.  
  475.  
  476.      The  entire scanning/searching process has  been cleaned up  to be more
  477.      informative to users about what is going on, and what the results were.
  478.  
  479.  
  480.      Two new  versions of the interior  list command have been  added to the
  481.      system.   Previously PKey "I" in  the file section did  not take PData.
  482.      It  has been  modified so  that when  the P-Data  is "G",  the interior
  483.      listing  will be global in nature, scanning all file sections available
  484.      to the user and producing an interior listing of all files matching the
  485.      file mask.  When the PData is "@", the user will be prompted for a file
  486.      description.  The interior listing could be
  487.      global or  local in  nature, depending  on the user's  response to  the
  488.      search all areas question.
  489.  
  490.  
  491.      Two new files are  now available after file transfers.   POSTUL.MSG/CLR
  492.      and POSTDL.MSG/CLR are now optionally displayed after successful single
  493.      or batch transfers.  These files  are be used to print the  users UL/DL
  494.      status or other sort of message.
  495.  
  496.  
  497.      Added a ARFLAGS.MSG/CLR  file to display when you go to edit a users AR
  498.      flags.  This will allow a SysOp to  define a reminder to themselves and
  499.      remotes of what each flag means.
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.             T.A.G. BBS Version 2.5g -  Update Documentation - Page 10
  508.  
  509.  
  510.      Added tracking of modifications to user records. A field in each user's
  511.      record  indicates the user number  which made the  last modification to
  512.      that record.  It is  a display only option under the "9" command in the
  513.      user editor.  If the  last change user number  is the same as the  user
  514.      number, the  change was  done while  the user  was  on-line, either  by
  515.      him/her or from the keyboard.
  516.  
  517.  
  518.      A SysOp  debugging feature  now exists to  display the  number of  open
  519.      files DOS is  using in addition to the  number of open files  T.A.G. is
  520.      using.    This  feature   may  come  in  handy  for  determining  if  a
  521.      utility/door  program  is  leaving  files "open"  and  thus  eventually
  522.      exhausting  using up  all  the available  "FILES"  as defined  in  your
  523.      CONFIG.SYS.
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.             T.A.G. BBS Version 2.5g -  Update Documentation - Page 11
  532.  
  533.  
  534.                                 ------------------
  535.                                 Notable Bugs Fixed
  536.                                 ------------------
  537.  
  538.      Using the //MAILR command when no messages exist no longer causes a run
  539.      time error.
  540.  
  541.      The problem caused by entering the menu editor while on-line, modifying
  542.      a menu and  then exiting back to  the board no  longer places you at  a
  543.      random menu (//FALLBACK bug).
  544.  
  545.      The bracket  commands no longer require a section mask in order to link
  546.      additional commands.
  547.  
  548.      The parameters for LOGON.BAT now follow the generic door parameters.
  549.  
  550.      Problems with using the external editor as a  new user or from the wait
  551.      screen hopefully have been squashed this time around.
  552.  
  553.      ANSI graphics can now be used in all private mail.
  554.  
  555.      Other minor problems too numerous to mention.
  556.