home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / BOPDAT05.ZIP / BOP-DATE.DOC < prev    next >
Encoding:
Text File  |  1992-02-21  |  4.3 KB  |  112 lines
  1.                                 
  2.                                 BOP-Date.Doc
  3.  
  4.  
  5. WHY ...
  6.  
  7. Several message editors and utilities that create Fido *.Msg type messages
  8. put an invalid creation marker in the message header.  When exported, these
  9. messages may generate a warning message that is returned, or the message
  10. itself may be returned as 'bad'.  The marker may be invalid in several ways,
  11. the most common are incorrect spacing, and improper field termination.  Any 
  12. other mangling of the creation field is untreatable and is probably so badly
  13. damaged that the rest of the message header is invalid anyway.
  14.  
  15. BOP-Date remedies these conditions by scanning any newly entered messages on
  16. your system for correct format, then corrects any errors before exporting 
  17. takes place.
  18.  
  19.  
  20. TECHNICAL ...
  21.  
  22. BOP-Date modifies only messages that are LOCAL, and haven't been SENT.  These 
  23. markers are located in the message header attribute byte.  SEA-Dog creation
  24. entries are recognised and left unchanged.  BOP-Date should be run whenever 
  25. 1) a user logs off and has left echo messages (or NetMail) on your BBS, or 
  26. 2) you leave echo or NetMail messages with a mail reader.  Alternatively, it 
  27. can be run before your mailer does it's exporting.  Determining how and when 
  28. to run BOP-Date is left to you.  Not all BBS packages write bad creation 
  29. fields; same for message readers.  
  30.  
  31.  
  32. HOW-TO ...
  33.  
  34. Most installations will use:
  35. BOP-Date /d<path to your netmail area>
  36. With this option set, BOP_Date will scan your NetMail area, then your echo 
  37. areas that have any new messages to be exported.  The echo information is 
  38. found in ConfMail.Out and Areas.Bbs (type) files.
  39.  
  40.  
  41. OPERATIONS ...
  42.  
  43. There are a few options BOP-Date recognises.  They are:
  44.  
  45. /? a reminder screen
  46.  
  47. /a allows an alternate echo control file to be matched with the toss log;
  48. default is Areas.Bbs; should be in ConfMail/QM style.
  49.  
  50. /f specifies an alternate echo toss log file; default is ConfMail.Out.  
  51. Simply a listing of echos that have had new messages posted.
  52.  
  53. /h[1|2] sez to use that high water mark to scan new messages from.  Useful in
  54. multi-node or multitasking setups.  Default is 1, the one mailers normally
  55. use.
  56.  
  57. /d MUST be last option on command line; it specifies additional areas to scan
  58. such as NetMail.  NetMail isn't recorded in a ConfMail.Out file, so it has to 
  59. be specified seperately.  Example: 'BOP-Date /dD:\Fido\NetMail' will scan 
  60. NetMail area first, then process echo areas normally.  
  61.  
  62. /r rewrites ALL messages scanned, regardless of correctness.
  63.  
  64. /t TEST MODE recognises messages with bad creation fields, but does not 
  65. change them.  Incorporates delays to make reading a little easier.
  66.  
  67.  
  68. ERRORLEVELS ...
  69.  
  70. 0 - normal exit
  71. 1 - error finding a data file NOTE: This is normal for scanning a specified 
  72.     directory and no echo areas.
  73. 2 - help screen displayed
  74.  
  75.  
  76. WARRANTY ...
  77.  
  78. You're kidding, right?  No warranty, no guarantees, period.  If it breaks
  79. something, you get to keep the pieces.  BOP-Date is free to use and 
  80. distribute.
  81.  
  82.  
  83. THANKS ...
  84.  
  85. If you like the program (that implies using it!) please drop a line to Remus
  86. at FidoNet 1:106/167.  I'd like to keep track of it's usefulness.
  87.  
  88.  
  89. HISTORY ...
  90.  
  91. 0.01 -- 07/23/1991 -- For Cal; first release, no options.  4 hours from an 
  92.                       idea to implementation; not bad at all.
  93.  
  94. 0.02 -- 09/20/1991 -- Added the options, changed file calls to DOS level in 
  95.                       some areas.  Put a hexdump in the debugging version.
  96.  
  97. 0.03 -- 09/21/1991 -- Forgot some utilities put xFF as TimeDate terminator; 
  98.                       now anything other than a NULL gets rewritten.  Added 
  99.                       option /t.  And the Docs finally appeared.
  100.  
  101. 0.04 -- 09/24/1991 -- Messages are now counted before processing.  If 
  102.                       messages #5, #6, #7, #8, and #9 are entered, then #7 
  103.                       was deleted before export processing occured, BOP-Date 
  104.                       would stop after #6.
  105.  
  106. 0.04a - 10/08/1991 -- Typo fix where 'no messages!' display left '#0' on
  107.                       screen, and changed warning to 'no new messages'.
  108.  
  109. 0.05 -- 02/21/1991 -- Increased length of filenames.  Against better judgement,
  110.                       added -r option to rewrite ALL messages in directory.
  111.                       Changed compiler to TC++.
  112.