home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / BW300MAX.ZIP / WHATSNEW.300 < prev   
Text File  |  1993-07-18  |  18KB  |  413 lines
  1.  
  2.                 The Blue Wave Offline Mail Door for Maximus
  3.                                    v3.00
  4.  
  5.                    Upgrade and New Feature Documentation
  6.                 Copyright (C) 1993 by Cutting Edge Computing
  7.                             All Rights Reserved.
  8.  
  9.  
  10.   This information is provided for those people who are familiar with
  11.   previous versions of the mail door, and who do not care to comb the full
  12.   documentation to find what has been added or changed since the last
  13.   release.
  14.  
  15.   However, if you are unsure of how to use a feature that is described
  16.   here, consulting the appropriate section in the full documentation
  17.   (BWMAIL.DOC) will be necessary.
  18.  
  19.  
  20.  
  21.   INSTALLATION
  22.   ------------
  23.   Please read the file INSTALL.300, which was enclosed in the original
  24.   distribution archive (BW300MAX.ZIP).
  25.  
  26.  
  27.   This version of The Blue Wave Mail Door is being distributed with a file
  28.   called BWDOOR.USE.  This is an ASCII file that explains the use of The
  29.   Blue Wave Mail Door, what each item on the configuration menu does, how
  30.   to use The Blue Wave Bundling Commands, and more.  This is an excellent
  31.   tutorial for new users to the mail system.  It is suggested that this
  32.   file be placed online for your users to download.
  33.  
  34.  
  35.  
  36.  
  37.   NEW FEATURES
  38.   ------------
  39. * The Blue Wave Mail Door v3.00 now can use a "Version 7" Nodelist.
  40.   Support for the FrontDoor nodelist format has not been included.
  41.  
  42.  
  43. * Added support for Max's EXTENDED barricades.  Please note that "regular"
  44.   barricades are not supported, since having to enter a password at each
  45.   login to the door for every area that is barricaded is next to pointless.
  46.   If the door detects that the area contains a "regular" barricade, it will
  47.   proceed as before (the message area will not be available to the user
  48.   through the door).
  49.  
  50.   The door processes EXTENDED barricades in the same manner as Maximus.
  51.   There should not be any changes necessary to your existing setup.
  52.  
  53.  
  54.  
  55. * A new option on the door's configuration menu:  N)ew File Listings in
  56.   Packets.  Users have the option of setting this option to YES, NO, or
  57.   COLOR.  If the user chooses NO, no new file listing will be sent in the
  58.   download packet.  If the user chooses YES or COLOR, the door will scan
  59.   for new files since their successful mail download.  The door will
  60.   include ANSI sequences if COLOR is turned on.
  61.  
  62.   Some things to keep in mind about the new file list scanner:
  63.  
  64.   a)  Maximus does not store an "Upload" Date with the file.  Therefore
  65.       the file date must be used in determining if the file is "NEW" or
  66.       not.  If files are added to the BBS with an old file date, it will
  67.       not show up in the new file scan.
  68.  
  69.   b)  You must be running FB to create the FILES.* files in your file
  70.       directories.  The door processes the binary data files in the
  71.       interest of speed.  It will not use a straight "FILES.BBS".
  72.  
  73.   c)  Areas defined in your FILEAREA.CTL file with the "FileList <File>"
  74.       keyword (used mainly for CD-ROM file directory listings) will NOT be
  75.       scanned for new files.  Since it is very unlikely that new files have
  76.       been added to the CD-ROM, the door skips the area in the interest of
  77.       speed.
  78.  
  79.   d)  All of Max's PRIVS, LOCKS, and EXTENDED BARRICADES are supported in
  80.       the file areas.  If a user does not have access to a file area within
  81.       Maximus, the door will not even bother to scan the area for files.
  82.  
  83.   e)  The door creates the new files list in a file called NEWFILES.BW.
  84.       You do *not* need to put NEWFILES.BW as one of the "reader files" in
  85.       the BWUTILS->General Information Editor.
  86.  
  87.   f)  All file listings generated by the door include the file name, file
  88.       size, file date, and the full description.  The door will "wrap" long
  89.       file descriptions, up to 10 lines.
  90.  
  91.  
  92. * The entire "message upload" portion of the mail door has been rewritten.
  93.   You will probably notice a big increase in speed.  The display while
  94.   tossing uploaded messages has also been changed to be more informative.
  95.  
  96.  
  97. * Duplicate message detection has also been overhauled.  The door will now
  98.   use a file called BWDUPES.IDX to store duplicate message information.
  99.   You can safely delete the old duplicate detection file (BWDUPES.DAT)
  100.   after installing the new version.
  101.  
  102.  
  103. * The File Requesting code has been rewritten.  When looking for the files
  104.   that a user has requested, the door now finds the file through
  105.   MAXFILES.IDX in the main \MAX directory.  For this reason, you must be
  106.   running FB.EXE to create the file database in order for file requesting
  107.   to work properly.
  108.  
  109.   When locating a file, the door uses MAXFILES.IDX for a speedier search.
  110.   People running CD-ROM drives complained that it took forever and a day to
  111.   locate a file before.
  112.  
  113.  
  114. * In the BWUTILS->General Information Editor, you will notice that each
  115.   of the 5 "reader files" are now configurable by priv level and locks.  If
  116.   a user does not have sufficient access to a reader file, the dor will not
  117.   send it.  This will allow "custom" welcome screens by security level to
  118.   be passed to the reader.  By default, each of the reader files have been
  119.   assigned "DISGRACE" access with no locks required.
  120.  
  121.   In order for you to edit the PRIV/LOCKS on the reader file, you need to
  122.   first edit the name of the file (type any character in the field).
  123.  
  124.  
  125.  
  126. * BWUTILS now has a new menu item - The "Limits and Maximums" editor.  For
  127.   each BPS rate that your system supports, you can now define 2 limits on
  128.   the amount of mail that is packed by the door.  It is important to
  129.   understand how each limit works:
  130.  
  131.   MAXIMUM UNCOMPRESSED PACKET SIZE is the largest mail packet size
  132.   (uncompressed, obviously!) that a user at a certain BPS rate may
  133.   download.  Some may find this useful if they bundle messages (have their
  134.   WORK directory pointed) to a RAMdrive.  For example, I have a 2 meg
  135.   RAMdrive configured as the door's WORK directory on my system.
  136.   Therefore, I have all of the BPS rates configured for 1800K uncompressed
  137.   packet size to ensure there is always enough room to complete a
  138.   successful packing session.  If you do not care how large the
  139.   uncompressed packets are for any particular BPS rate listed, simply set
  140.   the field to -1.  This will cause the door to have no set limit (other
  141.   than disk space).
  142.  
  143.   MAXIMUM NUMBER OF MESSAGES obsoletes the old "overall Maximum Messages"
  144.   setting the door had.  The door enforces the maximum number of messages
  145.   per BPS rate, just as with the MAXIMUM UNCOMPRESSED PACKET SIZE.  If you
  146.   wish to set no limit for the maximum number of messages, simply enter
  147.   "-1" in the field.  The door will not enforce a limit for that particular
  148.   BPS rate.
  149.  
  150.   There is an important difference in the way these two limits work.  "MAX
  151.   MSGS" limits are enforced BEFORE any bundling of the messages takes
  152.   place.  The user must use the bundling commands to trim the size of their
  153.   mail packet before proceeding with a mail bundling session.  "MAX PKT
  154.   SIZE" is enforced DURING bundling.  If at any time during bundling the
  155.   door reaches the maximum packet size limits, it immediately halts the
  156.   bundling process and compresses the mail packet for the user to download.
  157.  
  158.  
  159. * In the LIMITS AND MAXIMUMS editor, you can tell the door whether or not
  160.   you will allow NEW FILE scans to take place.  If this is set to "NO",
  161.   users will not be given the option on the door's CONFIGURATION menu to
  162.   create newfiles lists.
  163.  
  164.  
  165. * In the LIMITS AND MAXIMUMS editor, you can define the maximum number of
  166.   days to "look backwards" to find new files.  If a user has not logged
  167.   into your system for 6 months, you (most likely) do not want them
  168.   receiving a NEWFILES listing containing the last 6 months worth of new
  169.   files.  You can control the maximum number of days to include in the file
  170.   list by editing this field.  A good number to use here is probably
  171.   somewhere between 10 and 30 days.
  172.  
  173.  
  174. * If you are exiting Maximus to run the door as an "Extern_Erlvl" type of
  175.   shell, Maximus creates a file called RESTAR<task>.BBS in the main \MAX
  176.   directory.  If the door finds this file after an upload session, it will
  177.   write information to the file to tell Maximus to exit with the "After
  178.   Echomail", "After Netmail", and "After Local Mail" errorlevels that you
  179.   have defined in MAX.CTL.
  180.  
  181.  
  182. * If you are running a multi-line system, the door will look for a defined
  183.   IPC directory when a user enters.  If there is an IPC directory defined,
  184.   it will edit the IPC<task>.BBS file to say "Using Blue Wave Mail Door",
  185.   instead of the "Running External Program" that Maximus leaves there.
  186.  
  187.  
  188. * Previous versions expanded "%T" in pathnames to the hexadecimal task
  189.   number that was passed to the door.  This is still true, but you can now
  190.   use a "%N", which will expand to the DECIMAL task number passed to the
  191.   door.
  192.  
  193.   Assuming you have a download directory defined as "C:\MAX\BW\DOWN%T"
  194.   Example of door running as task 10, expands to "C:\MAX\BW\DOWN0C".
  195.   Example of door running as task 1, expands to  "C:\MAX\BW\DOWN01".
  196.  
  197.   Assuming you have a download directory defined as "C:\MAX\BW\DOWN%N"
  198.   Example of door running as task 10, expands to "C:\MAX\BW\DOWN10".
  199.   Example of door running as task 1, expands to  "C:\MAX\BW\DOWN1".
  200.  
  201.  
  202. * The door now detects when it is being run under one of the following
  203.   multi-taskers, and frees time slices accordingly:
  204.  
  205.   MS-Windows Enhanced Mode
  206.   OS/2 Virtual DOS Machine
  207.   DESQview
  208.  
  209.   If time slicing is occuring for one of the above multi-taskers, a line
  210.   will be logged to the designated log file indicating which type of
  211.   slicing it has detected it should use.
  212.  
  213.  
  214. * For sysops packing mail for users in nightly events using the /K<user#>
  215.   command line parameter in conjunction with the /D (autodownload)
  216.   parameter, there is a new and preferred way to load the door in local
  217.   mode.
  218.  
  219.   bwmail /Kgeorge_hatchew /d
  220.  
  221.   will load the door in local mode, search USER.BBS for "George Hatchew",
  222.   and then perform an auto-download.  You can do the same thing with *any*
  223.   name in your user file.  Simply remember to use UNDERSCORES instead of
  224.   spaces when using this method of local login.  "Jason St. Martin" would
  225.   look like this:  /Kjason_st._martin.  The names entered on the command
  226.   line are case insensitive.
  227.  
  228.  
  229. * The BWUTILS->Protocol Editor has been rewritten to support the new
  230.   INTERNAL protocols.
  231.  
  232.  
  233. * The door now supports 8 internal protocols which can be activated and
  234.   deactivated through the BWUTILS->Protocol editor.  There is absolutely
  235.   nothing to configure for the internal protocols as far as command lines
  236.   go.  The Blue Wave Mail Door now has support for the following built-in
  237.   protocols:
  238.  
  239.   Zmodem          (Both 16 and 32 bit CRC mode)
  240.   ZedZap          (Zmodem with up to 8k subpackets, depending on BPS rate)
  241.   Ymodem          (Standard 128 byte block Ymodem-Batch)
  242.   Ymodem-G        (1024 byte blocks, no error recovery)
  243.   Ymodem-1k       (1024 byte blocks with error recovery)
  244.   Xmodem-1k       (1024 byte Xmodem blocks)
  245.   Xmodem-CRC      (Standard 128 byte block Xmodem with CRC error checking)
  246.   Xmodem-Checksum (Standard 128 byte block Xmodem with Checksum)
  247.  
  248.  
  249. * Support for external BIDIRECTIONAL protocols has been added (such as
  250.   Hydra and Bimodem).  Users can now upload their reply packets while
  251.   downloading their messages.  After the door has completed a mail
  252.   download, it will scan the defined UPLOAD directory to see if anything
  253.   has been transferred.  If there was a *.NEW file uploaded, the door will
  254.   process it immediately.
  255.  
  256.  
  257. * To aid in executing external bidirectional protocols, the protocol
  258.   command lines can now contain a "%U" parameter, which will pass the
  259.   UPLOAD DIRECTORY ONLY to the protocol.  All bidirectional protocols need
  260.   to know the upload (receive) directory when executed.
  261.  
  262.  
  263. * After the door has completed mashing a mail packet, the user now has the
  264.   following choices:
  265.  
  266.   A)bort download
  267.   C)ountdown logoff
  268.   I)mmediate logoff
  269.   P)rotocol Change (Current Protocol)  <=== New!
  270.   [ENTER] for normal download
  271.  
  272.  
  273. * "Chat Mode" has been added to the door.  To chat with an online user,
  274.   type <Alt-C> from the local keyboard.  To exit chat mode, simply press
  275.   ESCape.
  276.  
  277.  
  278. * When uploading messages, the door now places a ^aMSGID: line into the
  279.   message.
  280.  
  281.  
  282. * NEW on the door's CONFIGURATION menu -- User now has the option of
  283.   toggling the status of "U)se Numerical Packet Extensions".  If this
  284.   option is ON, packets will be named as BBSID.001 through BBSID.999.
  285.   After .999 is reached, the door recycles back to .001.  If this option is
  286.   left OFF, the original BW packet extensions are used (.SU1 - .SA9).
  287.  
  288.  
  289. * When selecting message areas for download, users now have the choice of a
  290.   default bundling action for the area:
  291.  
  292.   Personal Messages Only
  293.   Personal Messages, plus those messages addressed to "All"
  294.   Default action of all new messages.
  295.  
  296. * The mail scan screen has been changed.  Hopefully it is a bit more
  297.   readable and informative than before.  In the right-most column of the
  298.   scan screen there is a new column called "# DL'ing".  This column
  299.   indicates the number of messages that are going to be packed for
  300.   download.  You'll notice that as you enter bundling commands and select
  301.   "R" to relist the scan screen, the numbers will change depending on the
  302.   effects of the bundling command.
  303.  
  304.   Directly after the area name in the scan screen is a short phrase that
  305.   indicates the type of bundling action that will be performed on the area:
  306.  
  307.   New     -- Indicates that all messages since the last msg download will
  308.              be packed.
  309.   Pers    -- Only personal messages since the last msg download will be
  310.              packed.
  311.   P+All   -- Only personal messages, and messages addressed to "All" will
  312.              be packed.
  313.   Kwds    -- Only messages containing user keywords will be packed.
  314.   Filt    -- Messages that contain any of the filters will be skipped
  315.              during packing.
  316.   L  20   -- User issued an <area#>L20 command for this area; only the last
  317.              20 messages in the area will be packed for download.
  318.   B 100   -- User issued an <area#>B100 command for this area; only the
  319.              first 100 messages in the area will be packed for download.
  320.   Force   -- The area is being forced for download by the sysop.  No
  321.              bundling commands can be issued for this area.
  322.   None    -- User issued a -<area#> for this area, and no messages will be
  323.              packed.
  324.  
  325.  
  326. * A *NEW* Bundling command to go along with the "Personal+All" options for
  327.   downloading...  "A200" would force the door to only bundle messages in
  328.   area #200 that were PERSONAL MESSAGES, or were addressed to "ALL".  As
  329.   with all of the other bundling commands, "A*" would perform the same
  330.   action on all areas.
  331.  
  332.  
  333. * When 0 messages are found during the initial mail scan, the line:
  334.   There are 0 messages prepared for download.
  335.   is sent to the screen so that creative people using script files can have
  336.   their script skip the mail download.
  337.  
  338.  
  339. * A new command line parameter -- /NORECV -- will force the door to NOT
  340.   mark messages as "Received" when they are downloaded.  Good for sysops
  341.   who can't answer their mail right away and want to trick users into
  342.   thinking their mail hasn't been read yet :-).  This probably shouldn't be
  343.   used for normal BBS-user use.
  344.  
  345.  
  346. * When "/d" or "/u" is used with a remote user online, the following
  347.   command lines are available:
  348.  
  349.   /INSTANT     --- Causes an instant logoff after a successful auto
  350.                    download or auto upload session.
  351.   /COUNT       --- Causes a countdown logoff after a successful auto
  352.                    download or auto upload session.
  353.  
  354.  
  355.  
  356.  
  357.  
  358.   WHAT'S FIXED
  359.   ------------
  360. * The door should no longer require the use of the "SET TZ=<timezone>"
  361.   environment variable.  You can save yourself a few bytes of memory by
  362.   deleting this line from your AUTOEXEC.BAT file, if you do not have other
  363.   programs that need the TZ variable set.
  364.  
  365.  
  366. * The door should now be sorting message areas the same way that MAXIMUS
  367.   sorts them when displaying area listings.
  368.  
  369.  
  370. * Some people were experiencing trouble with portions of messages appearing
  371.   in the text body of other messages.  This was only happening on *.MSG
  372.   formatted message areas.  The problem has been fixed.
  373.  
  374.  
  375. * The mail door used to cause a SHARE violation on the OVERRIDE.IDX file,
  376.   located in the door's main directory when more than one door was active
  377.   at a time.  This has been fixed.
  378.  
  379.  
  380. * The door now asks for the user's DOOR PASSWORD (if so configured) when
  381.   entering AutoDownload and AutoUpload mode (/D and /U).
  382.  
  383.  
  384. * The mail door now echos the '*' character when entering and changing
  385.   passwords in the door.
  386.  
  387.  
  388. * The reader is limited to 5 characters for "area numbers".  Maximus is
  389.   unique in that it supports "area numbers" of up to 9 characters.
  390.   Problems have been reported when sysops have long area numbers defined
  391.   for Maximus and they are NOT UNIQUE within the first 5 characters.  One
  392.   example arose where the sysop provided Usenet newsgroups to users, using
  393.   names similar to the following:
  394.  
  395.   C-SYSBIN
  396.   C-SYSUNIX
  397.   C-SYSDOS
  398.   C-SYSOS2
  399.  
  400.   Since all of these areas begin with "C-SYS" (and that is what the reader
  401.   sees), areas were getting mixed up.  The only solution I could come up
  402.   with is to assign unique names to the areas for display in the reader.
  403.   They are STILL DISPLAYED AS THE FULL 9 CHARACTERS IN THE DOOR.
  404.  
  405.   The door now passes the following to the reader as area numbers in the
  406.   example:
  407.  
  408.   C-SY1
  409.   C-SY2
  410.   C-SY3
  411.   C-SY4
  412.  
  413.