home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / HATCH / NETED154.ZIP / NETPURGE.DOC < prev    next >
Text File  |  1996-04-15  |  5KB  |  97 lines
  1. NETPURGE - Network program to return undeliverable E-mail  - Version 1.54.
  2.  
  3. The program may be installed anywhere in the DOS path as long as it is run
  4. from the main BBS directory (or any other directory where a copy of CONFIG.DAT
  5. is located).  If a filename is named as a parameter, it will process the named
  6. uncompressed network data file.  Otherwise, it will process DEAD.NET.
  7.  
  8. What the program will do is go through a pending network message file and
  9. return all undeliverable E-mail to the sender.  Note that the entire file is
  10. considered undelivered.  NETPURGE will not send a previously NETPURGE'd
  11. message (if it recognizes a message as such).
  12.  
  13. NETPURGE will operate in the multi-network environment of WWIV 4.24/NET35+
  14. but only on one network at a time.  It will read both the environment variable
  15. and the network data file, taking the environment as priority.  However,
  16. a command line parameter designating the network will override both.
  17.  
  18. The best place for the program is as part of the beginday event.  It is
  19. suggested that it be invoked from a batch file and followed with a
  20. "DEL DEAD.NET" command.
  21.  
  22. Version 1.54 will detect and abort processing when compressed packets are in
  23. use.  This is because NETPURGE cannot process compressed packets.  Some
  24. enhancements to speed and non-ANSI displays were also added.  There are
  25. additional command line parameters which may be used.  They are:
  26.  
  27.      .#, where # is the network to purge pending files from.  Obviously, this
  28. parameter is only of use in the multiple network environment of WWIV.
  29.  
  30.      -#D, where # is the number of days old a message is.  This will preserve
  31. all messages younger than the specified number of days.  Only messages older
  32. than the amount will be purged.  If no entry is specified, all messages are
  33. purged.
  34.  
  35.      -#K, where # is the maximum number of kilobytes which may be returned
  36. from the original e-mail message.  The allowable range of values is from 0Kb
  37. to 32Kb, with 32Kb being the default.
  38.  
  39.      -#L, where # is the maximum number of lines which may be returned from the
  40. original e-mail message. The allowable range of values is from 0 lines to 1000
  41. lines, with 0 lines being the default.  Take note that 0 lines does not mean
  42. delete the entire message, but means that no truncation to the message will
  43. occur because of the number of lines (i.e. 0 lines means unlimited # of lines).
  44.  
  45.      -#P, where # is 0 or 1.  If the value is 0 or omitted, NETPURGE will
  46. dead message area posts by sending a drop request for all recipient nodes.
  47. NETPURGE will scan the SUBS.LST file(s) for the first message type listed that
  48. matches the type of the packet and use that information to identify the host
  49. of the message area.  If it cannot find the host in SUBS.LST, it will blindly
  50. send the drop request to the node originating the message, on the premise that
  51. eventually it will "hit" the sub-host.  If there are two (or more) message
  52. areas in a given network sharing the same sub-type, NETPURGE will use the one
  53. found first in SUBS.LST.  Considering that it may take some time to search
  54. for hosts, this feature is disabled by default.
  55.  
  56. Both "-K" and "-L" may be specified together and multiple times on the same
  57. command line, in either upper or lower case.  The parameters will only effect
  58. processing of pending files whose names follow it (or DEAD.NET if no filenames
  59. are specified at all).  "/" may be used in place of "-" anytime.
  60.  
  61. NETPURGE will take the message headers and reorganize them so that the purged
  62. message headers will not mix with the return headers.  However, for the node
  63. routing audit trail, NETPURGE moves the old records to the top of the message
  64. and adds its own marker, therefore providing a continuous set of routing
  65. headers for the message as it returns.
  66.  
  67. This program is distributed on an "as is" basis, with no warranty, expressed or
  68. implied.  The author assumes no responsibility for the loss of data while using
  69. this program, whether intentional or accidental.
  70.  
  71.      To report any bugs or problems, please e-mail me at 1@1180.WWIVNet.
  72.      BBS:  (310) 470-6869 supporting 28,800 baud V.34 Baud Modems.
  73.  
  74.      A donation of $5.00 would be appreciated.  Please send the donation
  75. (which is really a registration fee or license) to the author at:
  76.  
  77.      D. Stussy
  78.      12444 Rochedale Lane
  79.      Los Angeles, CA     90049-1900440
  80.  
  81. Note that no donation is required for registering NETPURGE if the user has
  82. registered another BDE program (i.e. NETEDIT or BBS_DIR).  NETPURGE is meant
  83. to be distributed as part of the NETEDIT package, but it may be registered
  84. separately from NETEDIT for $5.00.
  85.  
  86. Disclaimer:  By using the name "Black Dragon Enterprises," the author in no way
  87. is attempting to deceive, discredit, or evade any or all possible taxes levied
  88. by any unit of the United States Government or any political subdivision, nor
  89. is attempting to deceive the public at large in any way.  This program remains
  90. the property of the author and upon registration, the property of the licensee
  91. jointly at all times, regardless of where it may be transmitted, exchanged, or
  92. otherwise stored, including but not limited to other computer or BBS systems.
  93.  
  94. NETPURGE is a trademarks of Black Dragon Enterprises.
  95. WWIV is a trademark of WWIV Software Services and Wayne Bell.
  96. 
  97.