home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / qtod2.zip / qtodos2.doc < prev    next >
Text File  |  1993-04-16  |  4KB  |  109 lines
  1.  
  2.  
  3.                         QTOD (OS/2) 2.00
  4.                           Documentation
  5.  
  6.     Copyright 1990,1993, Thomas G. Harold, All Rights Reserved.
  7.  
  8.  
  9.     QTOD [/filename] [comment]
  10.         /filename - Optional filename to which QTOD will append
  11.             its output.  This may be used instead of the OS/2 >>
  12.             (append) redirection command.
  13.         comment - Optional comment which should be included with the
  14.             output string.  The comment may or may not be delimited
  15.             by quotes, and if it begins with a '-' then the comment
  16.             will precede the time string.
  17.  
  18.  
  19.     QTOD allows you to create a commented & formatted date/time 
  20. string to be placed into a file either by DOS's redirection 
  21. commands or by specifying a file.  Handy for creating log files 
  22. to track events such as automated file transfers, system backups, 
  23. file restores, or system testing.
  24.  
  25. -----------------------------------------------------------------
  26.  
  27.     QTOD is designed to output a commented/formatted time/date 
  28. string that can be appended to a log file or printed to the 
  29. screen.  QTOD's output can be redirected by using DOS's 
  30. redirection commands, (e.g. QTOD >> c:\syslog.dat), or by 
  31. specifying a log file to append to, (e.g. QTOD /c:\syslog.dat). 
  32.     QTOD comments are quite simple.  If you can fit it on the 
  33. command line, then QTOD can print it.  Normally QTOD will place 
  34. your comment after the time/date string.  This can be changed by 
  35. placing the '-' character, (minus sign), at the start of the 
  36. comment.  Comments do not have to be enclosed by quotes, but QTOD 
  37. can handle them either way.  You may have to try an idea a few 
  38. different ways before you'll get what you want.
  39.  
  40. -----------------------------------------------------------------
  41.  
  42. History:
  43.  
  44.     1.0     October 1, 1990
  45.         Original release version. (DOS)
  46.  
  47.     1.01    October 23, 1990
  48.         Changed minor details such as documentation file. (DOS)
  49.  
  50.     1.1     November 8, 1990
  51.         Changed QTOD to correctly handle the '\' character in
  52.         the comment.  (So that it is not interpreted by QTOD).
  53.         However, if the '\' appears within quotes, it still
  54.         gets tossed by DOS.
  55.  
  56.     1.21    November 24, 1990
  57.         Changed QTOD to allow a file to be specified.  Sometimes
  58.         it just isn't possible to use DOS's redirection commands
  59.         to append QTOD's output to a log file.  Rewrote 
  60.         documentation file.
  61.  
  62.     2.00    April 14, 1993
  63.         Ported to OS/2.
  64.  
  65. -----------------------------------------------------------------
  66.  
  67.     Usage of QTOD is free to individuals using it for 
  68. personal/private use.  Educational institutions are also granted 
  69. free usage.  I do ask that if QTOD is to be used by an 
  70. educational institution that I be notified for informational 
  71. purposes.  Use in a business environment or for business purposes
  72. requires a site licence.  (See SITELICN.DOC for current pricing 
  73. policy.)
  74.  
  75.                             DISCLAIMER
  76.     This program is distributed "as is".  I disclaim all 
  77.     warranties, expressed or implied, including, without 
  78.     limitation, the warranties of merchantability and of 
  79.     fitness for any purpose.  I will assume no liability for 
  80.     damages, direct or consequential, which may result from 
  81.     the use of this program. 
  82.  
  83.     Feel free to distribute this program so long as no money 
  84. changes hands except for media/connect-time costs.  Once again, I 
  85. ask that if this program is distributed by any mail-order 
  86. distribution company that I be notified.
  87.     Modifications may not be made to QTOD except for 
  88. personal/private use.  Modified copies may not be distributed in 
  89. any form.  No additions, deletions, or modifications may be made 
  90. to the contents of the archive.  The chosen archive format may
  91. be changed so long as the contents of the archive remain intact.
  92.  
  93. -----------------------------------------------------------------
  94.  
  95. Please contact me if you have any suggestions or questions about 
  96. the program.  I can be reached at the following address: 
  97.  
  98.         Thomas G. Harold
  99.         2206 Tracey's Rd.
  100.         Sparks, MD. 21152
  101.  
  102. Or by using Compuserve MAIL:
  103.  
  104.         Thomas G. Harold - 71750,3724
  105.  
  106. Please place the word "QTOD (OS/2)" where I can easily see it, 
  107. (e.g. in the subject field, or on the address label).  This will 
  108. help me to more easily attend to your correspondence.
  109.