home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / logsave / logsave.doc next >
Text File  |  1992-04-01  |  5KB  |  147 lines
  1.      
  2.      
  3.      
  4.      
  5.      
  6.      
  7.      
  8.                                 LogSave
  9.      
  10.                        Log File Archiving Utility
  11.                                       
  12.                               Version 1.02
  13.                                       
  14.                                       
  15.                                       
  16.                                       
  17.                                       
  18.                                       
  19.                                       
  20.                                       
  21.                                       
  22.                                       
  23.                                       
  24.                                       
  25.                                       
  26.                               Dave Fisher
  27.                                       
  28.                        LiveNet, 1:170/110@fidonet
  29.      
  30.      
  31.      
  32.      Description
  33.      
  34.      LogSave is a program that can be run on a daily basis to
  35.      automatically save log files to an archive.  The files will be
  36.      inserted to the archive in the format of <basename>.nnn, where
  37.      'nnn' is the next number in sequence if there are already
  38.      previous logs in the file, and 'basename' is the original name
  39.      of the log file (less, of course, the file extension).
  40.      
  41.      Currently, it is not possible to choose your favorite
  42.      archiver.  It is fixed to use PKZIP, which must exist in your
  43.      current directory, or a directory specified in the PATH
  44.      environment variable.
  45.      
  46.      LogSave is a 'bound' program, so it can run in either DOS or
  47.      OS/2 with no modification.
  48.      
  49.      
  50.      Usage
  51.      
  52.          LogSave [Archive_File_Name]
  53.              /LogFiles=( LogFileName, LogFileName, ... )
  54.              /[No]Backup                Default: NoBackup
  55.              /[no]Quiet                 Default: NoQuiet
  56.              /[no]Kill                  Default: NoKill
  57.              /TempFile=<filename>       Default: LogSave.$$$
  58.      
  59.      Notes on the syntax:
  60.      
  61.           Qualifiers can appear in any order, and are only
  62.           significant to four characters.  Thus, /TempFile is the
  63.           same as /Temp.
  64.           
  65.      
  66.      Disclaimer!
  67.      
  68.      This program is shareware.  There is absolutely no warranty
  69.      for this program or guarantee that it will work.  The user of
  70.      the program assumes all risk.  While I feel confident that
  71.      this program will not harm your system in any way, by using
  72.      this program, you agree to assume full responsibility for any
  73.      adverse effect to your system.
  74.      
  75.      Ok.  Now with that out of the way -- please send me mail and
  76.      let me know if you are using LogSave!  I'd like to get an idea
  77.      of whether this program has been useful for others, as it has
  78.      been for me.  Also, please send any comments and/or problem
  79.      reports.  I can be reached at:
  80.      
  81.           Dave Fisher
  82.           1:170/110@fidonet.org
  83.           
  84.      
  85.      Parameters
  86.      
  87.      
  88.      LogFileName
  89.      ----------------------------------------------
  90.      
  91.      This parameter is a fully qualified path of the log file, or
  92.      if the log file is in the current directory, just the log name
  93.      itself.
  94.      
  95.      You can include up to 25 different log file specifications.
  96.      Separate each log file with a comma.
  97.      
  98.      
  99.      /[no]backup
  100.      ----------------------------------------------
  101.      
  102.      If you specify /Backup, LogSave will create a <logfile>.BAK
  103.      file after the successful archival of the log file.  I run
  104.      LogSave each day at midnight, and have found this useful if I
  105.      want to quickly look at yesterday's log, and not have to
  106.      bother to uncompress it from the archive.  The backup file
  107.      will be created in the same directory as the original log
  108.      file.
  109.      
  110.      /[no]quiet
  111.      ----------------------------------------------
  112.      
  113.      This qualifier controls whether the program should emit an
  114.      printed output.  If /Quiet, the only output will be the
  115.      program copyright line.  The default is /NoQuiet.
  116.      
  117.      
  118.      /[no]Kill
  119.      ----------------------------------------------
  120.      
  121.      If LogSave detects a successful compression of the log file,
  122.      you can specify /Kill to have LogSave automatically delete the
  123.      log file.  The file will *not* be deleted if it was not
  124.      successfully archived.
  125.      
  126.      
  127.      /[no]TempFile
  128.      ----------------------------------------------
  129.      
  130.      LogSave needs the use of a temporary file.  It will normally
  131.      be very small, and will be deleted after LogSave is finished
  132.      with it.
  133.      
  134.      
  135.      Example
  136.      
  137.      The following example is broken apart on several lines for
  138.      display reasons.  It would be entered on one line when
  139.      actually executed.
  140.      
  141.      LogSave c:\bbs\logs\logs.zip
  142.          /kill
  143.          /logfiles=( c:\bbs\max\system\max01.log,
  144.                      c:\bbs\logs\binkley.log,
  145.                      c:\bbs\logs\bbs.log )
  146.      
  147.