Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

117 lines
16 KiB

{\rtf1\ansi \deff4\deflang1033{\fonttbl{\f1\froman\fcharset2\fprq2 Symbol;}{\f2\fswiss\fcharset0\fprq2 Helv{\*\falt Arial};}{\f4\froman\fcharset0\fprq2 Times New Roman;}{\f5\fswiss\fcharset0\fprq2 Arial;}
{\f7\fswiss\fcharset0\fprq2 MS Sans Serif;}{\f9\fswiss\fcharset0\fprq2 Helvetica;}}{\colortbl;\red0\green0\blue0;\red0\green0\blue255;\red0\green255\blue255;\red0\green255\blue0;\red255\green0\blue255;\red255\green0\blue0;\red255\green255\blue0;
\red255\green255\blue255;\red0\green0\blue128;\red0\green128\blue128;\red0\green128\blue0;\red128\green0\blue128;\red128\green0\blue0;\red128\green128\blue0;\red128\green128\blue128;\red192\green192\blue192;}{\stylesheet{\nowidctlpar \f4\fs20 \snext0
Normal;}{\s1\sb240\nowidctlpar \b\f2\ul \sbasedon0\snext0 heading 1;}{\s2\sb120\nowidctlpar \b\f2 \sbasedon0\snext0 heading 2;}{\s3\li360\nowidctlpar \b\f4 \sbasedon0\snext17 heading 3;}{\s4\li360\nowidctlpar \f4\ul \sbasedon0\snext17 heading 4;}{
\s5\li720\nowidctlpar \b\f4\fs20 \sbasedon0\snext17 heading 5;}{\s6\li720\nowidctlpar \f4\fs20\ul \sbasedon0\snext17 heading 6;}{\s7\li720\nowidctlpar \i\f4\fs20 \sbasedon0\snext17 heading 7;}{\s8\li720\nowidctlpar \i\f4\fs20 \sbasedon0\snext17
heading 8;}{\s9\li720\nowidctlpar \i\f4\fs20 \sbasedon0\snext17 heading 9;}{\*\cs10 \additive Default Paragraph Font;}{\*\cs15 \additive\fs16\up6\lang1033 \sbasedon10 footnote reference;}{\s16\nowidctlpar \f4\fs20 \sbasedon0\snext16 footnote text;}{
\s17\li720\nowidctlpar \f4\fs20 \sbasedon0\snext17 Normal Indent;}{\s18\fi-240\li480\sb80\nowidctlpar\tx480 \f9 \sbasedon0\snext18 nscba;}{\s19\fi-240\li240\sa20\nowidctlpar \f9 \sbasedon0\snext19 j;}{\s20\li480\sa20\nowidctlpar \f9 \sbasedon0\snext20
ij;}{\s21\sb80\sa20\nowidctlpar \f9 \sbasedon0\snext21 btb;}{\s22\fi-240\li2400\sb20\sa20\nowidctlpar \f9\fs20 \sbasedon0\snext22 ctcb;}{\s23\fi-240\li480\sa40\nowidctlpar\tx480 \f9 \sbasedon0\snext23 ns;}{\s24\sa120\nowidctlpar \f9\fs28
\sbasedon0\snext24 TT;}{\s25\fi-240\li2400\sa20\nowidctlpar \f9 \sbasedon0\snext25 crtj;}{\s26\fi-240\li480\nowidctlpar\tx480 \f9 \sbasedon0\snext26 nsca;}{\s27\sa20\nowidctlpar \f9 \sbasedon0\snext27 bt;}{\s28\li240\sb120\sa40\nowidctlpar \f9
\sbasedon0\snext28 Hf;}{\s29\li240\sb120\sa40\nowidctlpar \f9 \sbasedon0\snext29 Hs;}{\s30\li480\sb120\sa40\nowidctlpar \f9 \sbasedon0\snext30 RT;}{\s31\fi-2160\li2160\sb240\sa80\nowidctlpar\tx2160 \f9 \sbasedon0\snext31 c;}{\s32\li2160\sa20\nowidctlpar
\f9 \sbasedon0\snext32 ct;}{\s33\li240\sa20\nowidctlpar \f9 \sbasedon0\snext33 it;}{\s34\li480\nowidctlpar \f9\fs20 \sbasedon0\snext34 nsct;}{\s35\fi-160\li400\sb80\sa40\nowidctlpar \f9 \sbasedon0\snext35 nscb;}{\s36\fi-2640\li2880\sb120\sa40\nowidctlpar
\brdrb\brdrs\brdrw15 \brdrbtw\brdrs\brdrw15 \tx2880 \f9 \sbasedon0\snext36 HC2;}{\s37\fi-2640\li2880\sb120\sa20\nowidctlpar\tx2880 \f9 \sbasedon0\snext37 C2;}{\s38\fi-240\li2400\sa20\nowidctlpar \f9\fs20 \sbasedon0\snext38 ctc;}{
\s39\li2160\sb160\nowidctlpar \f9 \sbasedon0\snext39 crt;}{\s40\li480\sb20\sa40\nowidctlpar \f9 \sbasedon0\snext40 or;}{\s41\fi-259\li360\sb40\sa40\nowidctlpar\tx360 \f7\fs20 \sbasedon0\snext41 Ln1;}{\s42\li115\sb80\sa80\nowidctlpar \f7\fs20
\sbasedon0\snext0 *Intro;}{\s43\li115\sb80\sa80\keepn\nowidctlpar \b\f7 \sbasedon3\snext42 *Title;}{\s44\fi-245\li360\sb80\nowidctlpar \f7\fs20 \snext44 *Jl;}{\s45\li360\sb40\sa40\nowidctlpar \f7\fs20 \snext0 Lp1;}{\s46\fi-1800\li1915\sb60\sl-240\slmult0
\nowidctlpar\tx1915 \f7\fs20 \sbasedon0\snext46 Tph;}{\s47\li115\sb120\sa80\nowidctlpar \b\f7\fs20 \snext41 Proch;}{\*\cs48 \additive\super \sbasedon10 endnote reference;}}{\info{\author David Broman}{\operator Bob Watson}
{\creatim\yr1993\mo11\dy4\hr18\min38}{\revtim\yr1996\mo7\dy23\hr15\min9}{\version2}{\edmins1}{\nofpages4}{\nofwords1071}{\nofchars6106}{\*\company Microsoft}{\vern57431}}\widowctrl\ftnbj\aenddoc\makebackup\hyphcaps0 \fet0\sectd \linex0\endnhere
{\*\pnseclvl1\pnucrm\pnstart1\pnindent720\pnhang{\pntxta .}}{\*\pnseclvl2\pnucltr\pnstart1\pnindent720\pnhang{\pntxta .}}{\*\pnseclvl3\pndec\pnstart1\pnindent720\pnhang{\pntxta .}}{\*\pnseclvl4\pnlcltr\pnstart1\pnindent720\pnhang{\pntxta )}}{\*\pnseclvl5
\pndec\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}{\*\pnseclvl6\pnlcltr\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}{\*\pnseclvl7\pnlcrm\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}{\*\pnseclvl8\pnlcltr\pnstart1\pnindent720\pnhang
{\pntxtb (}{\pntxta )}}{\*\pnseclvl9\pnlcrm\pnstart1\pnindent720\pnhang{\pntxtb (}{\pntxta )}}\pard\plain \s1\sb240\nowidctlpar \b\f2\ul {\cs15\f5\fs16\up6 #{\footnote \pard\plain \sl240\slmult0\widctlpar \f4\fs20 {\cs15\b\fs16\up6 #} HIDD_PDLCNFIG_DIALOG
}}{\f5\fs16 }{\f5 Perf Data Log Overview
\par }\pard\plain \sl240\slmult0\widctlpar \f4\fs20 {\f5\up6 The Perf Data Log utility consists of two components:
\par {\pntext\pard\plain\f1\fs20\up6 \'b7\tab}}\pard \fi-360\li360\sl240\slmult0\widctlpar{\*\pn \pnlvlblt\pnf1\pnstart1\pnindent360\pnhang{\pntxtb \'b7}}{\f5\up6 The }{\b\f5\up6 Configuration}{\f5\up6 property pages
\par {\pntext\pard\plain\f1\fs20 \'b7\tab}The }{\b\f5\up6 Data Collection}{\f5\up6 service}{\f5
\par }\pard \sl240\slmult0\widctlpar {\f5 The configuration property pages are used to configure the operation of the data collection service. The data collection services can also be started and stopped by the configuration property pages as well.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Features
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5
The Perf Data Log utility is a service that runs in the background on a Windows NT system to monitor and record performance data of selected system parameters. The performance data is recorded in a text format for easy manipulation by common database and
spreadsheet applications. Since the utility runs as a service it can be started automatically when the system is started or controlled manually. The log files created by the service can be renamed periodically for subsequent manipulation or archiving.
\par
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Installation
\par }\pard\plain \sl240\slmult0\widctlpar \f4\fs20 {\f5 The Perf Data Log service is installed by copying the following files the SYSTEM32 directory in the WINDOWS NT root directory.
\par {\pntext\pard\plain\b\f1\fs20 \'b7\tab}}\pard \fi-360\li1080\sl240\slmult0\widctlpar{\*\pn \pnlvlblt\pnf1\pnstart1\pnindent360\pnhang{\pntxtb \'b7}}{\b\f5 PDLCNFIG.EXE}{\f5 \endash The configuration program}{\b\f5
\par {\pntext\pard\plain\b\f1\fs20 \'b7\tab}PDLCNFIG.HLP}{\f5 \endash The configuration program help file}{\b\f5
\par {\pntext\pard\plain\b\f1\fs20 \'b7\tab}PDLCNFIG.CNT}{\f5 \endash The configuration program contents file}{\b\f5
\par {\pntext\pard\plain\b\f1\fs20 \'b7\tab}PDLSVC.EXE }{\f5 \endash The data collection service}{\b\f5
\par {\pntext\pard\plain\b\f1\fs20 \'b7\tab}PDH.DLL }{\f5 \endash The performance data interface library}{\b\f5
\par }\pard \sl240\slmult0\widctlpar {\f5 Once all these files are in place, the configuration program will install the service the first time it is run on the system.}{\b\f5
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Configuration
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5 Before the data collection service can start logging data it must be configured using the Configuration property pages. The Configuration property pages are in the PDLCNFIG application program.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Log Settings
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5
The Log Settings property page is used to select the performance counters to log and the interval between data samples. The service can also be started, stopped and set to automatic using this property page.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Log Files
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 This property page is used to configure how the data will be written. The output file can be named specifically, or it can be renamed periodically.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Operation
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5
Once the service has been configured, it can be started by either selecting the Start button on the Log Settings page, or the service can be set to start automatically the next time the system is restarted. The data files generated by the service can be v
iewed while the service is running, so long as they are not locked, preventing possible updates by the service. If this may be a problem, then the service should be stopped while the files are read or copied.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Using the Data
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5
The data from the data files is stored in a common text data format and may be imported into spreadsheet or database applications. (Microsoft Excel or Access, for example). Once in the database, the user may manipulate the data as desired.
\par }\pard\plain \s1\sb240\nowidctlpar \b\f2\ul {\f5 \page }{\cs15\f5\fs16\up6 #{\footnote \pard\plain \s16\nowidctlpar \f4\fs20 {\cs15\fs16\up6 #} HIDD_SETTINGS_PAGE}}{\f5 Log Settings
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5 The Log Settings property page is used to configure the counters to be logged, the sample interval and the status of the logging service.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Service Start
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5 The buttons in this group control the data collection service.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Automatic
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 Select this radio button to cause the service to start automatically each time the system is restarted
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Manual
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 Select this radio button to cause the service to start and stop manually. The service can be controlled by the Start and Stop buttons in this group box or by the Services Control Panel applet.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Start
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 Select this button to start the data collection service. This button is only enabled when the Manual radio button is selected and the service is not currently running.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Stop
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 Select this button to stop the data collection service. This button is only enabled when the Manual radio button is selected and the service is currently running.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Sample Interval
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5
These controls determine how often data is collected by the service. The sample interval should be as long as possible to minimize the load imposed by the data collection service. Samples can be as frequent as every second, to several days apart. The best
interval will depend on the counters being monitored.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Counters
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5 The counters that are currently selected for logging are displayed in this list box.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Add
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5
Select this push button to display the performance counter browsing dialog box. The performance counters to log are selected from this dialog box and then displayed in the Counters list box, when the browser is closed.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Remove
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5 This push button is used to remove the counters selected in the Counters list box. When this button is selected, all the selected counter entries in the list box will be removed.
\par }\pard\plain \s1\sb240\nowidctlpar \b\f2\ul {\f5 \page }{\cs15\f5\fs16\up6 #{\footnote \pard\plain \s16\nowidctlpar \f4\fs20 {\cs15\fs16\up6 #} HIDD_OUTPUT_PAGE}}{\f5 Log File
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5 The Log File property page is used to configure the properties of the log file created by the data collection service.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Log File Format
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5
The log file created by the data collection service can be formatted in one of the two ways listed below. Select the one that is appropriate for the application to read or process the data after it has been collected.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Comma Separated Variable (.CSV)
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 When this format is selected, the data will be written as values separated by a comma.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Tab Separated Variable (.TSV)
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 When this format is selected, the data will be written as values separated by a tab character.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Manual Filename Assignment
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5
Selecting this radio button will cause the data collected by the data collection service to be written to the file specified in the Output Filename edit box. NOTE: That if there is a file with this name already in existence, then the old file will be over
written by the new file.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Output Filename
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 This edit box is used to enter the desired output file for the data collection service. The [\'85
] push button to the right of this edit box can be selected to use the file browser to select the output filename and directory path.
\par }\pard\plain \s2\sb120\nowidctlpar \b\f2 {\f5 Automatic Filename Assignment
\par }\pard\plain \nowidctlpar \f4\fs20 {\f5
Selecting this radio button will cause the output file created by the data collection service to be renamed periodically. The renaming interval as well as the base name and output folder for the files can be configured by the fields in this box as well.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Rename output file every
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 These controls are used to configu
re the renaming interval of the output files. Enter the number of units directly into the edit box or use the arrows to adjust the number. The units are selected from the combo box next to the digits.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Log Folder\'85
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5
This push button is used to select the folder that the log files are to be written to. Make sure there is sufficient disk space on the drive containing that folder as the service will terminate if there is no longer enough room to write the data to the o
utput file.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Base Filename
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 This edit control
is used to specify the base file name or the left-most part of the filename. The filename used consists of the base filename followed by a sequence string specified by the Auto Format control. An example of the resulting filename is shown in the Example c
ontrol at the bottom of this group.
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Auto Format
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 This control is used to specify how the sequence string will be formatted. The letters in the string indicate data will be derived from the following :
\par }\pard \s17\li1440\nowidctlpar {\b\f5 nnnnnn}{\f5 = a decimal number that increases from 1 to 999,999 by 1 each time a new file is created
\par }{\b\f5 yy}{\f5 = the last two digits of the current year (1996 = 96)
\par }{\b\f5 mm}{\f5 = the two digits that describe the current month (Jan = 01)
\par }{\b\f5 dd}{\f5 = the two digits that describe the current day of the month
\par }{\b\f5 ddd}{\f5 = the 3 digit day of the current year (i.e. the Julian Date)
\par }{\b\f5 hh}{\f5 = the 2 digit hour of the day from 0 to 23 ( 5:00 pm = 17)
\par }\pard\plain \s3\li360\nowidctlpar \b\f4 {\f5 Example
\par }\pard\plain \s17\li720\nowidctlpar \f4\fs20 {\f5 In this control, an example of what an automatically generated name will look like using the current date and time.
\par }}