home *** CD-ROM | disk | FTP | other *** search
/ Windows NT Super Tune-Up Kit / PIE-WindowsNTSuperTuneUpKit-1997.iso / RESRCKIT / NT31 / PERFTOOL / PERF.EXE / PERFTOOLS / MEASTOOL / README.TXT
Text File  |  1993-09-08  |  6KB  |  208 lines
  1.  
  2.  
  3.                            Optimizing Windows NT
  4.  
  5.                              Measurement Tools
  6.  
  7.  
  8. 1.  Overview
  9.  
  10.     This directory tree contains a number of tools which may be useful
  11.     in the measurement and analysis of Windows NT computers. These
  12.     are documented in the book "Optimizing Windows NT," and also
  13.     briefly here.
  14.  
  15.  
  16. 2.  Directory Organization
  17.  
  18.     There are three sub-directories: "i386" which contains the x86
  19.     executables, "MIPS" which contains the MIPS executables, and
  20.     "ALPHA" which contains the ALPHA executables.
  21.  
  22.     Depending on which platform you are on, you should add the
  23.     corresponding directory to your path.  Alternatively, you can copy
  24.     the files from the corresponding directory into a directory on your
  25.     path.
  26.  
  27.  
  28. 3.  Measurement Tools
  29.  
  30.     The following sections discuss the different tools.  The sections
  31.     are listed in alphabetical order by tool name.
  32.  
  33.  
  34. 3.1.  CLEARMEM
  35.  
  36.     CLEARMEM is used to force pages out of RAM.  On Windows NT, the
  37.     working sets are allowed to grow until memory pressure forces them
  38.     to decline.  Running CLEARMEM twice will usually force most
  39.     applications out of memory.  When CLEARMEM is run, the system will
  40.     pause because of the flood of high priority activity.  To run CLEARMEM,
  41.     the computer's paging file must be at least as large as its RAM.
  42.  
  43.     Usage:
  44.  
  45.         clearmem
  46.  
  47.  
  48. 3.2.  CTRLIST
  49.  
  50.     CTRLIST is used to produce a text file containing the Performance
  51.     Monitor objects and counters together with their Explain text.
  52.     The resulting file can be searched for rapid online access to
  53.     counter details.
  54.  
  55.     Usage:
  56.  
  57.         ctrlist > output.fil
  58.  
  59.  
  60. 3.3.  KILL
  61.  
  62.     KILL is a utility for stopping applications.  You can name an
  63.     application by the name of its executable or by its Process ID.
  64.     You can determine the Process ID from TLIST or PVIEW or Performance
  65.     Monitor.  If you specify the name of the executable and more than
  66.     one copy is running, all running copies are killed.
  67.  
  68.     Usage:
  69.  
  70.     kill { PID | progname }
  71.  
  72.  
  73. 3.4  LODCTR
  74.  
  75.     LODCTR is used to load new objects, counters, and explain text
  76.     into the Registry for use by performance monitors.  See Chapter
  77.     13 of "Optimizing Windows NT" for complete instructions on its
  78.     use.
  79.  
  80.  
  81. 3.5.  NTIMER
  82.  
  83.     NTIMER is used to determine how long a program runs.  It shows
  84.     Elapsed Time (ETime), time in User Mode (UTime) and time in
  85.     Privileged Mode (KTime).  These are expressed in
  86.     hours:minutes:seconds.milliseconds.  Time is actually accurate
  87.     only to the resolution of the timer, which is 15 milliseconds
  88.     on the x86 and 10 milliseconds on the MIPS.
  89.  
  90.     Usage:
  91.  
  92.     ntimer program.exe
  93.  
  94.  
  95. 3.6.  PERFMTR
  96.  
  97.     PERFMTR is useful for watching a number of system performance
  98.     numbers during system execution.  You can select from a
  99.     number of different views of the system by entering a character
  100.     from a list presented when PERFMTR starts.
  101.  
  102.     Usage:
  103.  
  104.     perfmtr
  105.  
  106.  
  107. 3.7.  PMON
  108.  
  109.     PMON is useful for looking at a large number of memory statistics
  110.     while Windows NT is running.  All of the information in PMON is
  111.     available in the Performance Monitor.  But PMON displays the data
  112.     in a more tailored form.
  113.  
  114.     Usage:
  115.  
  116.         pmon
  117.  
  118.  
  119. 3.8.  PVIEW
  120.  
  121.     PVIEW is a convenient tool for looking at processes on a Windows
  122.     NT system.
  123.  
  124.     Usage:
  125.  
  126.         pview
  127.  
  128.  
  129. 3.9.  SETEDIT
  130.  
  131.     SETEDIT is a tool for editing Performance Monitor chart settings
  132.     files.  
  133.  
  134.     SETEDIT looks just like the Windows NT Performance Monitor, but
  135.     when you edit a legend line it permits you to type in instance
  136.     names.
  137.  
  138.     SETEDIT is particularly useful for locating instances within
  139.     Performance Monitor log files.  Since you cannot select instances
  140.     until they are alive at the start of the time window, mortal
  141.     instances can be hard to find.  You can use SETEDIT to enter the
  142.     the case-sensitive name of the instance into a settings file.
  143.     When Performance Monitor opens the settings file, it can then
  144.     locate the instance automatically.
  145.  
  146.     Usage:
  147.  
  148.         setedit [setfile.pmc]
  149.  
  150.  
  151. 3.10.  TLIST
  152.  
  153.     TLIST shows the running processes and their Process ID's.
  154.  
  155.     Usage:
  156.  
  157.     tlist
  158.  
  159.  
  160. 3.11.  UNLODCTR
  161.  
  162.     UNLODCTR is used to remove performance monitoring objects,
  163.     counters, and Explain text from the registry for extensible
  164.     objects.  If an object is being de-installed, its performance
  165.     monitor support should be removed.  Two successive runs of LODCTR
  166.     without an intervening run of UNLODCTR will result in counters
  167.     being installed that cannot easily be removed.  This wastes space
  168.     in the Registry.  See Chapter 13 of "Optimizing Windows NT" for
  169.     directions on running UNLODCTR.
  170.  
  171.  
  172. 3.12.  VADUMP
  173.  
  174.     VADUMP can be used to look within the address space of a process.
  175.     It shows the state and size of each segment of virtual address
  176.     space.  It can be used to make sure virtual address space is not
  177.     over-allocated.  It serves as a hard copy of some of the information
  178.     visible in PVIEW.
  179.  
  180.     For technical reasons beyond our control, operation of VADUMP as
  181.     described in Chapter 11 of "Optimizing Windows NT" is not available
  182.     at this time.  Use the Working Set Tuner.  The packing list
  183.     provided can be used to determine which data structures should be
  184.     grouped together.  Do this by listing the data structures accessed
  185.     by the functions that are grouped together.  Then reorganize your
  186.     data to match the access patterns implied by the packing list.
  187.  
  188.     Usage:
  189.  
  190.     vadump -p PID
  191.  
  192.     where PID is the Process ID as indicated by TLIST.
  193.  
  194.  
  195. 3.13.  WPERF
  196.  
  197.     WPERF is a simple performance monitor which has a different user
  198.     interface from Performance Montior.  It is preferable for some
  199.     applications.  Once you have started WPERF, you should enlarge
  200.     the window it is using and double click on the chart surface to
  201.     get to the menus.
  202.  
  203.     Usage:
  204.  
  205.         wperf
  206.  
  207. [End of readme.txt.]
  208.