home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / BATCH / DAT13.ZIP / DAT.DOC < prev    next >
Encoding:
Text File  |  1990-10-28  |  6.1 KB  |  184 lines
  1.  
  2.  
  3.                                   DAT, v1.3
  4.                                 -------------
  5.                                 from TifaWARE
  6.  
  7.  
  8.  
  9.  
  10. What's New
  11. ----------
  12.  
  13.  
  14.      With version 1.3 I have substantially reorganized DAT's source code,
  15. placing commonly-used routines in libraries and useful equates and macros
  16. in separate files. From the user's point of view, however, there should be
  17. no change in the program. Sharing code, equates and macros in this way
  18. will make it easier for me to both develop and maintain other assembly
  19. language programs.
  20.  
  21.      Many of the principal functions in DAT have been completely rewritten
  22. for version 1.2. These changes will make it easier for me to revise the
  23. program. From the user's point of view, though, nothing will have changed.
  24.  
  25.      New to version 1.1 is the '-n' option to suppress display of the final
  26. newline sequence. It will come in handy if you wish to mix output from both
  27. DAT and some other program.
  28.  
  29.  
  30.  
  31.  
  32. Introduction
  33. ------------
  34.  
  35.  
  36.      Ever wished you could keep track of program usage? Ever wanted to
  37. display the current date and time without having to hit <Enter>? Ever
  38. hoped for something better than "ECHO.|DATE" and "ECHO.|TIME", something
  39. that would give you more control over the output format? If so then DAT is
  40. the answer for you.
  41.  
  42.      DAT is a simple assembly language utility to display the current date
  43. and/or time preceeded by an optional message. Its output can be easily
  44. redirected to a file so a log can be kept of program or system usage.
  45.  
  46.  
  47.  
  48.  
  49. Usage
  50. -----
  51.  
  52.  
  53.      Running this program is a breeze.  Assuming you've placed DAT.COM 
  54. where DOS can find it, type DAT -? to display a brief help message similar
  55. to the following:
  56.  
  57.      TifaWARE DAT, v1.3a, 08/28/90 - displays the current date and time.
  58.      Usage: dat [-options] [msg]
  59.      
  60.      Options:
  61.        -d = display date
  62.        -n = suppress final newline sequence
  63.        -t = display time
  64.        -? = display this help message
  65.      
  66.      msg is an optional message to display before the date or time.
  67.  
  68. [If you don't remember anything else from reading the documentation, at
  69. least remember how to display this help message.]
  70.  
  71.      If you invoke it with at least one argument, DAT will display neither
  72. the date nor the time unless you explicitly tell it to (with the options 
  73. '-d' and/or '-t'). Also by default, DAT adds a final newline (CR/LF)
  74. sequence unless you tell it not to via the '-n' option. These options, if
  75. specified, must appear before any message text. As a special case, "DAT"
  76. is equivalent to "DAT -d -t".
  77.  
  78.      You can redirect DAT's output to a file, printer, or even another
  79. program using DOS' redirection characters '>', '>>', and '|'. For example,
  80. you could log usage of Quattro Pro with the following batch file:
  81.  
  82.                echo off
  83.                DAT -dt QPro session started: >> QPro.Log
  84.                Q
  85.                DAT -dt QPro session ended:   >> QPro.Log
  86.  
  87. Notice that you should use '>>' rather than '>' unless you don't mind
  88. overwriting whatever might already be in QPro.Log.
  89.  
  90.  
  91.  
  92.  
  93. If You Have Any Trouble
  94. -----------------------
  95.  
  96.  
  97.      DAT will attempt to let you know of any problems that arise. Here is
  98. the only error message you might see and how you should deal with it:
  99.  
  100.      dat: illegal option -- x.
  101.           - Type "DAT -?" for a list of valid options.
  102.  
  103.  
  104. This message is written to the standard error device. In this way, it
  105. won't disappear down a pipe or into a file when redirecting DAT's output.
  106.  
  107.      Additionally, DAT uses a return code to convey information about the
  108. success or failure of its operation.  Possible return values are:
  109.  
  110.      Code      Meaning
  111.      ----      -------
  112.      0         Program completed successfully
  113.      1         Help message was displayed
  114.  
  115. You can test for these codes using the ERRORLEVEL variable in a batch file. 
  116.  
  117.  
  118.  
  119.  
  120. Requirements
  121. ------------
  122.  
  123.  
  124.      TifaWARE DAT runs on machines operating under MS-DOS v2.xx or later,
  125. and requires practically no memory.  It does not use BIOS calls, make
  126. direct writes to video RAM, or otherwise require machines to be
  127. "PC-compatible".  In fact, DAT even runs properly on a DEC Rainbow!
  128.  
  129.  
  130.  
  131.  
  132. Who Owns It?
  133. ---------------
  134.  
  135.  
  136.      I am releasing this implementation of DAT into the public domain. 
  137. Since my involvement with MS-DOS began in 1984, I've been a heavy user of
  138. public domain software.  Public domain software is a terrific idea.  For
  139. the most part, programs are useful and the source code instructive, all at
  140. no cost! With this small contribution to the public domain I hope to pay
  141. back, in some sense, my gratitude to those other programmers who have made
  142. my computing so much easier. 
  143.  
  144.      As a public domain program, DAT carries no obligation on my part to
  145. support users or provide future upgrades.  I have tried to write clean code
  146. and believe it to be "bug-free".  Nevertheless, you must use this program
  147. ***AT YOUR OWN RISK***.  I strongly urge you to scan the source code
  148. yourself, make any desired changes, and recompile the program, if this is
  149. possible.  If you make this standard practice with newly acquired public
  150. domain software, you'll not only protect your system from worms and viruses
  151. but also get a better feel for exactly how each program works!
  152.  
  153.      As author of DAT, I ask of you two things: First, if you distribute
  154. this program, please keep together my original source code, documentation,
  155. and executable.  This just makes it easier for others to use the software. 
  156. Second, let me hear what you think of DAT.  You don't have to send any
  157. money, just comments and suggestions. 
  158.  
  159.  
  160.  
  161.  
  162. Kudos
  163. -----
  164.  
  165.  
  166.      Thanks to Ron Brandt of SATALINK BBS who inspired me to develop this
  167. program. Ron runs a fantastic bulletin board system; give it a call at
  168. +1 215 364 3324.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                           George A. Theall
  175.  
  176.                              TifaWARE
  177.                        506 South 41st St., #3M
  178.                       Philadelphia, PA.  19104
  179.                               U.S.A.
  180.  
  181.                         +1 215 662 0558
  182.  
  183.               GTHEALL@PENNDRLS.UPENN.EDU (ARPA Internet)
  184.