home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / bwrf063.zip / BWREPFIX.DOC < prev    next >
Text File  |  1999-11-10  |  10KB  |  238 lines
  1.  
  2.      Program BWREPFIX
  3.      Version 0.63 Beta
  4.      R. Dale Shipp
  5.      dale@min.net
  6.      1:261/1466
  7.  
  8.   Copyright by R. Dale Shipp.  All rights reserved.
  9.   An unlimited and non-exclusive free license is granted for personal
  10.   use only.
  11.  
  12.   BWREPFIX is designed to repair QWK style reply packets that have been
  13.   mangled by BlueWave's Y2K bug.   It is designed to be run just before
  14.   BlueWave packs up the completed MSG packet into the REP packet.
  15.  
  16.   *** VERY IMPORTANT NOTE ***
  17.   When you are looking at reply messages using BLUEWAVE, the dates will
  18.   not be correct.  This is because BlueWave is persistent at mangling
  19.   dates it does not recognize as being between 1 Jan 1970 and 31 Dec
  20.   1999, even if they have been previously fixed.
  21.  
  22.   At present, this program is still considered to be in Beta -- and will
  23.   remain so until after 1 Jan 2000.  It has tested on my system under
  24.   both WIN95 and OS/2 Warp 3.  It has been tested by others on a variety
  25.   of systems and computers.  I would appreciate any and all feed back
  26.   and comments.  If a problem is found, please email me the *.REP packet
  27.   and the BWREPFIX.LOG from a run with the -d option set.
  28.  
  29.   The program is designed so that the call line to the compression
  30.   program in BlueWave configuration is replaced with a call to a batch
  31.   file.
  32.  
  33. INSTALLATION
  34.  
  35.   1. Copy the BWREPFIX.EXE and BWPACK.BAT files to your Blue Wave
  36.    directory (For advanced/experienced users, they can actually be located
  37.    anywhere on your system, as long as
  38.  
  39.     a. they are located in a directory that is listed in your PATH
  40.      environment variable,
  41.           or
  42.     b. command lines used to run them include full drive and path
  43.      specifications to their location, such as C:\UTILS\BWREPFIX.EXE or
  44.      C:\BELFRY\BWPACK.BAT.
  45.  
  46.    Since they are designed and intended for use only with Blue Wave (as
  47.    opposed to being general-purpose utilities), however, the Blue Wave
  48.    directory is usually the best place for them.).
  49.  
  50.   2. In your Blue Wave configuration, change the "Display archiver output"
  51.    option to "Yes" if it isn't already set to that.
  52.  
  53. +======================
  54. |               Global
  55. +==============+=========================+
  56. |              | Global Reader Settings  |
  57. |              | Mail Packet Options     |  <--- This Sub-Menu
  58. |              | +-------------------------------------
  59. |              | | Packet list sort field
  60. |              | | Display archiver output        Yes   <--- This Item
  61.  
  62.    During installation, testing, and early operation, this will allow you
  63.    to view the operation of the archiver function, to confirm that
  64.    BWREPFIX is installed and operating correctly.  Once you are satisfied
  65.    that that is the case, this option can be restored to its original
  66.    setting.
  67.  
  68.   3. In your Blue Wave configuration, Archivers Menu, your existing
  69.    Decompression commands can remain as is.  They should not be affected
  70.    in any way by the installation and/or operation of BWREPFIX.
  71.  
  72.   4. In your Blue Wave configuration, Archivers Menu, if you have made any
  73.    changes to Blue Wave's default Compression commands, change the
  74.    corresponding command lines in BWPACK.BAT to reflect your changes.
  75.    These could include such items as
  76.  
  77.     a. addition of a full path specification (drive:\directory\) to the
  78.      command,
  79.  
  80.     b. addition, deletion, or change of command line options and switches,
  81.           or
  82.     c. change of archiver.
  83.  
  84.    Use your text editor to make any necessary changes to BWPACK.BAT, but
  85.    do not copy the "@F" and "@I" macros from the Blue Wave Compression
  86.    command lines.  Inside the batch file, the "%2" and "%3" variables
  87.    serve the same function.
  88.  
  89.   5. In your Blue Wave configuration, Archivers Menu, change all the
  90.    compression commands you use as shown:
  91.  
  92. +=================================
  93. |                       Archivers
  94. +==========+======================
  95. |          | ZIP Compression   BWPACK.BAT ZIP @F @I
  96. |          | ZIP Decompression
  97. |          |
  98. |          | ARJ Compression   BWPACK.BAT ARJ @F @I
  99. |          | ARJ Decompression
  100. |          |
  101. |          | LHA Compression   BWPACK.BAT LHA @F @I
  102. |          | LHA Decompression
  103. |          |
  104. |          | PAK Compression   BWPACK.BAT PAK @F @I
  105. |          | PAK Decompression
  106. |          |
  107. |          | ARC Compression   BWPACK.BAT ARC @F @I
  108. |          | ARC Decompression
  109. |          |
  110. |          | AUX Compression   BWPACK.BAT AUX @F @I
  111. |          | AUX Decompression
  112. |          +====================
  113.  
  114.   6. If you use Blue Wave's "Compress Reply Cmd" Preference option to
  115.    provide an alternate Compression command for any of the systems you
  116.    use, repeat Steps 4 and 5 for that item:
  117.  
  118. +==============
  119. |  Preferences
  120. +=+==============================+=
  121. | | Default Preferences          |
  122. | | Packet Preference Override   |  <--- Select the appropriate host(s).
  123. | | +-------------------------------+
  124. | +=| Message Read Mode Preferences |
  125. |   | Message Entry Preferences     |
  126. |   | Tagline Behavior Preferences  |
  127. |   | File and String Preferences   |  <--- Select this item.
  128. |   | +-------------------------------
  129. |   +-| Signature File Name
  130. |     | Message Save File
  131. |     | Reply Save File
  132. |     | Keyword List File
  133. |     +-------------------------------
  134. |     | Default Alias Name
  135. |     | Quote Header String
  136. |     +----------------------------------------------
  137. |     | Compress Reply Cmd   BWPACK.BAT OLDZIP @F @I  <--- Enter this here.
  138. |     +----------------------------------------------
  139.  
  140.     Step 6 applies only to Blue Wave v2.20 and above.  Steps 1 through 5
  141. apply to v2.10 and above, although the specific screen illustrations apply
  142. only to v2.20 and above.  Screens for v2.10 through v2.12 may look
  143. slightly different,
  144.  
  145. [End INSTALLATION Section]
  146.  
  147.  
  148. BACKGROUND and the way the program works.
  149.  
  150.   Because of the way the program is being inserted into the compression
  151.   process, it is also called when BlueWave is compressing the QWK
  152.   packet.  The code recognizes that it is not looking at a *.MSG file
  153.   and simply passes without doing anything.
  154.  
  155.   It also checks the first record (128 bytes) of a *.MSG file to see if
  156.   it looks like the sort of header file a QWK reply packet would have,
  157.   namely 8 characters of BBS name followed by 120 characters of blanks.
  158.   This is done because the BlueWave *NEW packet also contains *.MSG
  159.   files -- which are individual messages.   If the first record does not
  160.   fit the QWK *.REP format, the processing for that session is skipped
  161.   without modification.
  162.  
  163.   There are three types of errors in messages that have been observed so
  164.   far with the BlueWave Y2K QWK Reply problem.   On the initial creation
  165.   of a message, BlueWave will output the value of YEAR-1900 into a two
  166.   digit field.  Since this will be a three digit number after 1 January
  167.   2000, it causes most of the rest of the header record to be skewed to
  168.   the right by one character.  This effects the date, the time, the TO:
  169.   field and other subsequent fields.  A second type of error is that
  170.   whenever BlueWave version 2.30 reads a reply message with a date that
  171.   it thinks is out of bounds (which would be any date with a two digit
  172.   year less than 70), it replaces the date and time fields with 01-01-70
  173.   and 00:00 respectively.  It then seems to manage to insert the correct
  174.   thing into all other fields except for the TO: field.  That field may
  175.   have a leading digit which is a left over effect from when the time
  176.   field was slid on the previous mangling of the message header by
  177.   BlueWave.   The third type of error is observed with BlueWave version
  178.   2.12.  When BW 2.12 opens a .REP packet which has dates with years of
  179.   00 and beyond, it gets very confused and converts those dates to
  180.   erroneous month/day/year figures, possibly negative.  Because of this,
  181.   a parameter "-c" has been introduced which allows the forcing of dates
  182.   to be current (within 45 days).
  183.  
  184.   The program looks for and corrects these types of errors.  In
  185.   correcting for the error which shows up as 00:00 in the time field, it
  186.   will remove a leading digit from the characters in the TO: field.
  187.   I.e., the assumption is made that a digit there is the result of a
  188.   previous error in which a digit from the time field slid into the TO:
  189.   field.
  190.  
  191.   The program is designed to run silently, i.e. without any output to
  192.   the screen or console.   It presently has a debug option that would
  193.   enable verbose prints to help track down a problem.  To invoke that
  194.   option, insert the parameter -d in the call line of the batch file
  195.   BWPACK.BAT, e.g.
  196.  
  197.   c:\bwave\bwrepfix.exe -d @I
  198.  
  199.   The debug output accumulates onto the file bwrepfix.log in the directory
  200.   where BlueWave is run.  Note that if you leave the -d flag set, that
  201.   file will quickly grow quite large.
  202.  
  203.  
  204. Possible parameters and meaning:
  205. -h or ? or none => print out a brief help file to stdout and exit
  206.  
  207. -d  => debug or verbose output to file y2k.txt
  208.     If a problem occurs, repeat the run with this flag set
  209.     Send the input *.REP file and the bwrepfix.log file to me for study
  210.  
  211. -c  => force date/time to be current.   If this parameter is present, then 
  212.     any date/time in the header that is more than 45 days in the past will 
  213.     set to the current date time.   In any case, date/times in the future,
  214.     or date/times that are negative will be set to the current date/time.
  215.  
  216. <file name, with path specified>  The full path file name of the MSG
  217.     file to be repaired.  BlueWave typically passes the @I parameter as
  218.     a wildcard specifying a directory in the REPLY directory with *.*
  219.     for the file specifier.  It is important that the full path name be
  220.     given because of the way the file search and wild cards are handled.
  221. [ END BACKGROUND SECTION]
  222.  
  223.  
  224. KNOWN ISSUES:
  225.  
  226.   If the TO: field contains an address that starts with a digit, the
  227.   program will remove the leading digit in the 00:00 case, i.e. if
  228.   BlueWave has opened the reply packet after the initial closing.  I
  229.   know of no way to avoid this at the present time, but suggestions
  230.   would be accepted.
  231.  
  232.  
  233.                             R. Dale Shipp
  234.                             dale.min.net
  235.                             (1:261/1466)
  236.  
  237.  
  238.