home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ibm1 / rtmr101.arj / RTIMER.DOC < prev    next >
Encoding:
Text File  |  1992-05-14  |  5.7 KB  |  137 lines
  1.  
  2.  
  3.  
  4.      RTIMER V1.01 Copyright (c) 1992 Copy Con Incorporated           Page 1
  5.  
  6.  
  7.      OVERVIEW
  8.      --------
  9.      RTIMER returns the errorlevel and elapsed time of any DOS program,
  10.      batch file, or internal command, with up to 1/100 second accuracy.
  11.      RTIMER can search the DOS path for files, can run COM and EXE files
  12.      without reloading the command processor, and can use any command
  13.      processor for batch files and internal commands.
  14.  
  15.  
  16.      DISCLAIMER
  17.      ----------
  18.      RTIMER is distributed on an "AS IS" basis without warranty, expressed
  19.      or implied. Considerable testing effort has been expended, but the
  20.      user is advised to check the program's suitability before relying on
  21.      it. The user assumes full risk as to the results of using this
  22.      program. Any liability of the author will be limited exclusively to
  23.      product replacement. In no event shall the author be liable for any
  24.      incidental or consequential damages arising from the use, or inability
  25.      to use this program.
  26.  
  27.  
  28.      OPERATION
  29.      ---------
  30.      RTIMER is activated from the command line, using the format
  31.  
  32.        RTIMER [path]command [command options]
  33.  
  34.      The command can be any executable COM or EXE file, BAT batch file, or
  35.      internal DOS command. File extensions are usually not necessary; if no
  36.      extension is given, RTIMER will search the current directory and the
  37.      DOS path for a COM file, then an EXE file, and then a BAT file.
  38.  
  39.      There is a ten option limit for batch files and internal commands, and
  40.      no limit for COM and EXE files (aside from the DOS limitation of a 128
  41.      character command line).
  42.  
  43.      If a path is not specified with the command, RTIMER will first check
  44.      the current directory for the file, and then search the DOS path. The
  45.      search for the command will be included in the elapsed time, so for
  46.      more accurate timing, the full path and filename should be specified.
  47.  
  48.      RTIMER will not reload the command processor to execute COM and EXE
  49.      files. For batch files and internal commands, RTIMER will check the
  50.      DOS environment for COMSPEC=, and use the processor that follows. If
  51.      COMSPEC= is not found, RTIMER will search the path for COMMAND.COM.
  52.      Again, the search for the processor will be included in the elapsed
  53.      time, so for more accurate timing, use the SET COMSPEC command first,
  54.      and specify the full pathname (ex. SET COMSPEC=C:\DOS\COMMAND.COM).
  55.  
  56.      The elapsed time will be displayed onscreen, followed by the error-
  57.      level. Note that on some systems, the resolution of the system clock
  58.      is about 5/100 second, and a few systems can only return full seconds.
  59.      The returned errorlevel will be displayed onscreen, and will also be
  60.      returned to DOS.
  61.  
  62.  
  63.  
  64.      RTIMER V1.01 Copyright (c) 1992 Copy Con Incorporated           Page 2
  65.  
  66.  
  67.      OPERATION (continued)
  68.      ---------------------
  69.      The other executable, STIMER, works exactly like RTIMER, except that
  70.      it uses the SPAWNO routines by Ralf Brown to minimize memory use while
  71.      running other programs. Where RTIMER uses approximately 16 kilobytes
  72.      of memory, STIMER uses less than 1/2 kilobyte. STIMER will first try
  73.      to swap itself to EMS or XMS memory, and will then attempt to swap to
  74.      the current disk directory. The swap directory can can be changed by
  75.      setting the environment variable SWAPDIR, TEMP, or TMP to the desired
  76.      directory. Unavoidably, the swap time is included in the elapsed time,
  77.      so for more accurate timing, swap to EMS/XMS memory, or a RAM disk.
  78.  
  79.  
  80.      ERROR MESSAGES
  81.      --------------
  82.      Path or file name not found
  83.        Either the specified file was not in the path, or the command
  84.        processor could not be found to launch the batch/internal command.
  85.        Make sure the PATH and/or COMSPEC settings are valid.
  86.  
  87.      Out of conventional or stack memory
  88.        RTIMER does not have enough conventional or stack memory to process
  89.        the command. Make sure the command has enough conventional memory to
  90.        run without RTIMER. If it does, try STIMER. If STIMER gives the same
  91.        message, please contact us, with detailed info on your DOS version,
  92.        how the memory is configured, and the exact command line.
  93.  
  94.  
  95.      EXAMPLES
  96.      --------
  97.      RTIMER xcopy a: b:
  98.        will show how long it takes XCOPY to copy files from one drive to
  99.        another. This time can be compared with the internal COPY command
  100.        to see which one is faster, compared to itself after disk caching
  101.        software has been installed, etc.
  102.  
  103.      RTIMER pause
  104.        will call the internal DOS pause command, which waits for a
  105.        keypress, and will show the elapsed time from program start to
  106.        finish. Expensive stopwatch.
  107.  
  108.      RTIMER c:\bbs\bbs.bat
  109.        will run a batch file that starts a bulletin board system, and upon
  110.        exit, will show how long it has been running, and if it ran ok. The
  111.        elapsed time will be as accurate as the system clock.
  112.  
  113.  
  114.  
  115.      RTIMER V1.01 Copyright (c) 1992 Copy Con Incorporated           Page 3
  116.  
  117.  
  118.      CORRESPONDENCE
  119.      --------------
  120.      If you have questions, comments, suggestions, bug reports, etc.,
  121.      feel free to contact us by one of the following methods:
  122.  
  123.      1: By modem at The Programmer's Corner (301-596-1180 or 410-995-3744).
  124.         Send a message to user number 3000, and check back in a couple of
  125.         work days for a reply.
  126.  
  127.      2: By U.S. Mail:
  128.  
  129.         Copy Con Incorporated
  130.         PO Box 23255
  131.         Baltimore MD 21203-5255
  132.  
  133.         If you would like a reply, please include a self-addressed, stamped
  134.         envelope.
  135.  
  136.      We look forward to hearing from you.
  137.