home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / lm2_100.lzh / lm2.doc < prev   
Text File  |  1994-09-11  |  5KB  |  145 lines
  1.  
  2.              __/            __/        __/        __/    __/__/__/
  3.             __/            __/ __/ __/__/       __/    __/    __/
  4.            __/            __/   __/  __/      __/          __/
  5.           __/            __/        __/     __/        __/
  6.          __/__/__/__/   __/        __/    __/        __/__/__/__/
  7.  
  8.                   -+- -+- -+-  LogManager/2  -+- -+- -+-
  9.                                   v 1.00
  10.  
  11.                               By Chris Snell
  12.                                  1:387/710
  13.                            Deadicated  Software
  14.                             San Antonio, Texas
  15.  
  16.               With Help From Edward Walker and Doug Palmer
  17.  
  18.  o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o--o
  19.  
  20. -*-  About LogManager/2
  21.  
  22. Howdy!
  23.  
  24. Welcome to the first useful thing that I have ever programmed, LogManager/2!!! This program has
  25. been designed to keep your logfiles trimmed down and to store them in a manner that will allow
  26. you to find them when you want to!  This utility renames your logfiles into a format which
  27. contains the current date, along with a 3-letter code that will help you identify which log is
  28. which.
  29. This program is designed to take your daily logfiles (from a bbs or mailer)
  30. and rename them into a format in which they can be easily stored or located
  31. for future use.
  32.  
  33.    The format is:
  34.  
  35.               MmDdYyyy.XXX
  36.  
  37. Where Mm is the two-number abbreviation for the current month,
  38.       Dd is the current day (in number format),
  39.       Yyyy is the current year,
  40.       and XXX is a three-letter code.
  41.  
  42. The three-letter code is most similar to those three-letter airport
  43. identification codes.  For my logfiles, I use:
  44.  
  45. BNK  for BinkleyTerm's Log (BINKLEY.LOG)
  46. SQH  for Squish's Log (SQUISH.LOG)
  47. ND1  for Node 1 of the Terrapin Station BBS (NODE1.LOG)
  48. ND2  for Node 2 of the Terrapin Station BBS (NODE2.LOG)
  49. GLD  for GoldED's Log (GOLDED.LOG)
  50.  
  51. If today's date is July 1, 1994, LM/2 would rename my BINKLEY.LOG logfile to
  52. 07011994.BNK.
  53.  
  54. -*-  How to use Log Manager/2
  55.  
  56. To use LogManager/2, you should:
  57.  
  58.  1) Put all the files contained in this archive in their own directory.  I use
  59.     D:\LM2.
  60.  2) Set up an OS/2 Batch File (.CMD) that copies the log files every night
  61.     to LogManager's directory.  Here is a sample .CMD file (COPYLOGS.CMD) that
  62.     I use:
  63.  
  64.         copy D:\BINK\BINKLEY.LOG D:\LM2
  65.         del D:\BINKLEY.LOG
  66.         copy D:\MAX\NODE*.LOG D:\LM2
  67.         del D:\MAX\NODE*.LOG
  68.         copy D:\SQUISH\SQUISH.LOG D:\LM2
  69.         del D:\SQUISH\SQUISH.LOG
  70.  
  71.   3)  Remember that the logfiles cannot be copied/deleted while in use by
  72.       another program.  Be sure to have your mailer/bbs/tosser terminate
  73.       before doing log management.
  74.   4)  Run LogManager/2 nightly (preferably from an OS/2 Command File)
  75.  
  76.  
  77. -*-  The Configuration File
  78.  
  79. LogManager/2 uses a simple configuration file to control it's management.
  80.  
  81.                 ***-( NOTE! )-***
  82.  
  83. The configuration file MUST BE NAMED LM2.CFG !!!!
  84.  
  85. Look at and edit the sample LM2.CFG to set this up.  It's pretty easy!
  86.  
  87.  
  88. -*-  Archiving Your Logs
  89.  
  90. For an unknown reason, I could not get REXX to read the filename of an
  91. executable archive utility from my LM2.CFG without puking so no archiver
  92. support is included at the present time.  It is quite easy, however, to set up
  93. a simple OS/2 Batch File (.CMD) to do this automatically.  This archiving
  94. batch file (I call mine ARCLOGS.CMD) should contain a simple command line
  95. for and archiver and use wildcards to select the logfiles.  Here is how I did
  96. mine:
  97.  
  98. -- clip here ---
  99.  
  100. lh32 A OLDLOGS.LZH *.BNK *.ND1 *.ND2 *.GLD *.SQH
  101. del *.bnk
  102. del *.sqh
  103. del *.gld
  104. del *.nd1
  105. del *.nd2
  106.  
  107. --- clip here ---
  108.  
  109. This would tell my archiver (lh32.exe) to add all files ending .BNK, .SQH,
  110. .GLD, .ND1, and .ND2 to an archive file (OLDLOGS.LZH) which I keep all my old
  111. logs in.  After the archiver has added them, my batch file deletes them.  Very
  112. simple.
  113.  
  114.  
  115. -*-  DISCLAIMER AND DISTRIBUTION INFORMATION
  116.  
  117. LM/2 IS PROVIDED FREE OF CHARGE TO ANYONE WHO WISHES TO USE IT.  YOU
  118. ***CANNOT*** DISTRIBUTE A MODIFIED VERSION OF THIS SOFTWARE WITHOUT WRITTEN
  119. PERMISSION FROM THE AUTHOR, CHRIS SNELL.  YOU ARE, HOWEVER, FREE TO MODIFY
  120. FOR YOUR PERSONAL USAGE AS LONG ANS YOU DO NOT DISTRIBUTE IT IN MODIFIED FORM.
  121. IF YOU DISTRIBUTE THE FULL RELEASE VERSION, PLEASE ENSURE THAT IT CONTAINS THE
  122. DOCUMENTATION AND CONFIGURATION FILES.  CHRIS SNELL ASSUMES ABSOLUTELY NO
  123. LIABILITY FOR ANY DAMAGE INCURRED IN THE DISTRIBUTION OR THE USE OF LM/2.
  124.  
  125. YOU GET WHAT YOU PAY FOR.  :-)
  126.  
  127. -*-  FreeWare Notice
  128.  
  129. This program is freeware and can be used indefinitely without any payment to
  130. the author.  The only thing I ask you to do is to send me an e-mail message
  131. and tell me what you think of LM/2.  Tell me how you use it to archive
  132. Grandma's bowling league scores, journals of your llama-breeding business, or
  133. any other use that you can concieve.  If you find bugs or just want to say
  134. "Howdy!", just drop me a line.  Here are my e-mail addresses:
  135.  
  136. Chris J. Snell
  137.  
  138. FidoNet    Joey Snell @ 1:387/710
  139. Internet   Joey.Snell@lchance.sat.tx.us
  140.  
  141.  
  142.  
  143. Thanks for using my program!  If you like it, send it (in its original archive)
  144. to a friend! :-)
  145.