home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 25D / SYSACT13.ZIP / SYSACT.DOC < prev    next >
Encoding:
Text File  |  1992-03-06  |  6.6 KB  |  197 lines
  1.  
  2. SYSACT                     PCDOS/MSDOS                    SYSACT   
  3.                            V1.3 3/6/92
  4.  
  5. NAME
  6.      SYSACT, ACTRPT, SAFMT
  7.  
  8. DESCRIPTION
  9.      This Unix-like facility is provided to help advanced PC users
  10.      analyze system activity and to identify programs that are consuming
  11.      the majority of system resources.
  12.  
  13.      System activity logging is performed by the SYSACT resident
  14.      program.  Upon termination of a process, one record is written to
  15.      the file C:\SYSACT.LOG.  The SARPT batch can summarize this data.
  16.  
  17. FILES
  18.      C:\SYSACT.LOG     system activity logging file
  19.      SYSACT.COM        system activity logger
  20.      ACTRPT.BAT        report generator batch
  21.      SAFMT.EXE         report formatter, generally called by ACTRPT
  22.      SYSACT.H          activity log file format definition
  23.      ASKYN.COM         utility used by ACTRPT batch to ask questions
  24.      QSORT.COM         a sort command with no file size limit
  25.  
  26.  
  27. DISTRIBUTION
  28.      This system activity facility is provided free of charge for
  29.      personal use only.  You may copy and distribute this package for
  30.      any non-commercial purpose.  Please contact the author for
  31.      licensing for other applications.
  32.  
  33.      This document and the associated programs are copyright material
  34.      and should not be modified or sold.
  35.  
  36.      Copyright (C) 1987, 1992 Samuel H. Smith,
  37.      All rights reserved.
  38.  
  39.      Address all inquiries to:
  40.         Samuel H. Smith
  41.         P.O. Box 4808
  42.         Panorama City, CA 91412-4808
  43.         (818) 891-6780 (Tool Shop BBS)
  44.         (818) 891-4228 (voice)
  45.  
  46.  
  47. REVISION HISTORY
  48.      01/25/87 v1.0,  Initial release.
  49.  
  50.      02/02/87 v1.1,  Added -S option to SAFMT.
  51.                      Added ACTRPT batch file.  
  52.                      Included ASKYN utility.
  53.  
  54.      02/07/87 v1.2,  Included QSORT because DOS sort command will not
  55.                      sort the activity log when it gets over 64k.
  56.                      Added -R option to ASKYN and changed ACTRPT to
  57.                      take advantage of it.
  58.  
  59.  
  60.      03/07/92 v1.3,  Recompiled SAFMT with newer compiler to correct some
  61.                      problems found when running over a network.
  62.  
  63.  
  64. SYSACT(2)                  PCDOS/MSDOS                    SYSACT(2)
  65.  
  66.  
  67. NAME
  68.      SYSACT - System activity logger
  69.  
  70. SYNOPSIS
  71.      SYSACT.COM  (called from AUTOEXEC.BAT)
  72.  
  73. FILES
  74.      C:\SYSACT.LOG   system activity log file
  75.      SYSACT.H        log file format definition
  76.  
  77. DESCRIPTION
  78.      SYSACT becomes resident and creates a system activity file, in the
  79.      form described in SYSACT.H.  This file is interpreted and reported
  80.      on by SAFMT.COM and ACTRPT.BAT.
  81.  
  82.      SYSACT should be called once during system startup.  This should
  83.      normally be done in the AUTOEXEC.BAT file.   The activity logger
  84.      becomes resident and will remain active until the system is
  85.      rebooted.
  86.  
  87.      In multi-process environments, such as DoubleDOS, the activity
  88.      logger must be started separately in each partition.  Each instance
  89.      of SYSACT consumes only about 1k of RAM.
  90.  
  91.      Here is a sample of the contents of the SYSACT.LOG file:
  92.          sort.exe     02-01-87 13:28:34 00:00:01.27 0002 0001 0005
  93.          turbo.com    02-01-87 13:28:58 00:00:44.21 0003 0000 0010
  94.          list.com     02-01-87 13:29:52 00:00:39.99 0006 0000 001B
  95.          q.com        02-01-87 13:31:39 00:01:38.92 0001 0001 0016
  96.          sort.exe     02-01-87 13:31:56 00:00:10.50 0002 0001 0005
  97.          ed.exe       02-01-87 13:43:43 00:08:10.27 0004 0001 0035
  98.  
  99.  
  100. NOTES
  101.      The DOS call counters are stored in 16 bits and will overflow to 
  102.      zero without warning. 
  103.  
  104.      SYSACT only reports on processes that have terminated.
  105.  
  106.  
  107.  
  108. ACTRPT                     PCDOS/MSDOS                    ACTRPT   
  109.  
  110.  
  111. NAME
  112.      ACTRPT - Activity report generator batch
  113.  
  114. SYNOPSIS
  115.      actrpt
  116.  
  117. DESCRIPTION
  118.      ACTRPT provides a simplified interface to the facilities of SAFMT.
  119.      It asks a series of questions and then processes the activity log
  120.      based on the operator's responses.
  121.  
  122.  
  123. DIALOGUE
  124.      Do you want a standard system activity report? (y/n)
  125.  
  126.      Do you want a system activity report that includes lines for
  127.      commands executed only once? (y/n)
  128.  
  129.      Do you want a system activity report without the I/O counts? (y/n)
  130.  
  131.      Output report to the screen? (y/n)
  132.  
  133.      Output report to the printer? (y/n)
  134.  
  135.      Do you want to replace the activity log with a summary
  136.      of it's current contents? (y/n)
  137.  
  138.  
  139. SAMPLE OUTPUT
  140.      Here is an example of a report generated by ACTRPT:
  141.  
  142.            Total    Average  -- Sys Call Averages --   
  143.            Time      Time     Reads  Writes   Misc    Runs     Command
  144.         ---------- --------- ------- ------- ------- ------ --------------
  145.            5070.4    316.90       2       3      24     16   turbo.com   
  146.            3068.5    191.78       3    2639    2757     16   **others
  147.            1747.0     75.96       3       0      19     23   list.com    
  148.             335.2     23.94       2       1    2222     14   more.com    
  149.             178.3     25.48       9       4    6852      7   vi.exe      
  150.             177.8     29.63       1     655      46      6   masm.exe    
  151.             108.1      4.32       3      22       6     25   sarpt.com   
  152.               3.6      1.19       0       0      12      3   sortall.com 
  153.               1.3      0.63       2       1       4      2   unique.com  
  154.               0.8      0.41       0       0       3      2   mode.com    
  155.  
  156.  
  157.  
  158.  
  159. SAFMT                      PCDOS/MSDOS                    SAFMT   
  160.  
  161.  
  162. NAME
  163.      SAFMT - Format command summary from system activity log records 
  164.              (usually called from ACTRPT.BAT)
  165.  
  166. SYNOPSIS
  167.      sort <c:\sysact.log | SAFMT [-i] [-j] [-v] [-s] >sumfile
  168.      actrpt
  169.  
  170. DESCRIPTION
  171.      SAFMT reads a sorted system activity file, in the form described in
  172.      SYSACT.H.  It adds all records that executed identically-named
  173.      commands and writes them to the standard output.
  174.      
  175.      The options are:
  176.  
  177.      -j  Combine all commands invoked only once under ``**others''.
  178.  
  179.      -i  Exclude columns containing the I/O counts from the output.
  180.  
  181.      -v  Exclude column headings from the output.
  182.  
  183.      -s  Produce a compact summary file to replace SYSACT.LOG.
  184.  
  185.  
  186.      A typical sequence for activity reporting is:
  187.           sort <c:\sysact.log | sarpt -j >report1
  188.           sort <report1 >report1
  189.           print report1 report2
  190.  
  191.  
  192.      A typical sequence for activity log maintenance is:
  193.           copy c:\sysact.log sysact.old
  194.           sort <c:\sysact.log | sarpt -s >c:\sysact.log
  195.  
  196.  
  197.