Copyright: Extensible Performance Counter List Help vers. © copyright Microsoft Corporation 1985-1997
Citation: Extensible Performance Counter List Help vers. © copyright Microsoft Corporation 1985-1997


Exctrlst Overview
Extensible Performance Counter List Overview (Exctrlst.exe)

ExCtrLst provides information on the performance counter dynamic-link libraries (DLLs) that have been installed on a computer running Microsoft Windows 2000. You can use ExCtrLst to display the services and applications that provide performance information and to disable a specific counter DLL if needed. You might want to disable a counter DLL if errors occur (these may be logged in Event Viewer).

For questions or problems with ExCtrLst, please contact:

rkinput@microsoft.com.


Notes on Using Exctlst
Notes on using ExCtrLst

When ExCtrLst is started, it scans the registry on your system to see which applications, devices, and services have registered performance counter libraries. These libraries are listed in the list box of the display along with the corresponding service or application It is possible for a single performance counter library to provide performance information for several services or devices, or it may provide data for a single application. For each software component, the following information is displayed:

DLL Name	The name of the DLL that contains the functions used by the registry.
Open Procedure	The function called once when the software component’s performance interface is first started. This function is used to initialize the DLL.
Collect Procedure	The function called repeatedly to collect the current performance data from the software component.
Close Procedure	The function that is called when the performance data from this software component is no longer needed.
Counter ID Range, Help ID Range	The starting and ending strings that identify the object and counter names and associated descriptions (help text displayed when you press Explain in the Add Counters dialog box in the Performance console). These strings are stored in the registry and referenced by a numeric index. The index values for counters are defined when the DLL is installed, usually during the application or services installation.  NOTE: Some counter DLL’s have pre-assigned index values. The index values for those counters will not be displayed.

The display also provides a hexadecimal value and numeric index for each of the following: Last System Counter ID, Last Counter Text ID, Last System Help ID, and Last Help Text ID.

Note  Counter DLL’s that are loaded using WBEMPERF can be managed using ExCtrLst; however, native WMI/WBEM counter providers cannot.


Performance Counters Enabled

For counters that have been successfully installed, this check box is selected. If you want to disable a counter, select the counter DLL in the list box by service name, file name, or counter ID, and select the check box.


Machine Name

This is the name of the computer from which the information is read. It defaults to the local computer; however, you can view any computer on the network for which you have permission to read the registry.


Refresh Button

When this button is pressed, the registry information for the selected computer is reread and the contents of the display are updated.


Sort Order

It determines the order of the items displayed in the list box just below. The default sort order is Service. If the Library File button is selected, then the list is displayed in alphabetical order by the file name of the DLL (may include the file path). When sorted by Counter ID, the hexadecimal value representing the counter appears in the left column.


Extensible Performance Counters

This list box contains the names of the applications providing performance counters and the DLL that is providing this information. The contents of columns in this list box are determined by the Sort Order selection. If the sort order is Library File, then the left column will contain the DLL file name and the right column will contain the service key entry of the service providing performance data. If the sort order is Service then the left column will contain the service key entry of the service providing the performance data and the right column will contain the DLL file name. When sorted by Counter ID, the hexadecimal value representing the counter appears in the left column.


DLL Name

The entry found in the registry for the DLL file that the Windows 2000 performance library is to load for the performance data provided by this service. For this to function correctly, either the fully-qualified path to the DLL must be provided in this field or the file must be in the system’s path. If this DLL file is not found in the system, the registry will log an error in the system’s Application Event Log.


Open Procedure

The name of the function that is found in the DLL file, which performs the initialization of the performance, functions for this service. This function must be exported by the DLL and return a successful status for the registry to collect performance data from this service. If this function is not found in the DLL or returns an error, the registry will log an error in the system’s Application Event Log.


Collect Procedure

The name of the function that is found in the DLL file which collects performance data. The registry calls this function each time an application (System Monitor, for example) requests performance data. If this function cannot be found in the DLL, or has a fault or causes an error, the registry logs an error in the system’s Application Event Log.


Close Procedure

The name of the function that is found in the DLL file, which performs any termination or clean-up when, the application requesting performance data closes the interface to the registry. If this function could not be found in the DLL, the registry will log an error in the system’s Application Event Log.


Counter ID Range

When the performance counter DLL is installed, it is assigned a range of index values for its object and counter name strings. The values that were assigned during installation are displayed here. These values must correlate correctly with the entries found in the HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Perflib\<LangID>\Counter MSZ String entry or the counters and or objects described for this service will not appear in System Monitor. Note that <LangID> in the above string corresponds to the specific entry for the default language on the computer. 009 = English, for example. If the value in this field is “N/A” then this service uses pre-assigned index values and this entry is not applicable. If the value in this field is “Not Found” then there is a problem with the entry for this service and its counters will not appear in System Monitor.


Help ID Range

When the performance counter DLL is installed, it is assigned a range of index values for its object and counter explain text strings that correspond to the corresponding counter or object name string index + 1. The values that were assigned during installation are displayed here. These values must correlate correctly with the entries found in the HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Perflib\<LangID>\Help MSZ String entry or the counters and or objects described for this service will not appear in System Monitor. Note that <LangID> in the above string corresponds to the specific entry for the default language on the computer. 009 = English, for example. If the value in this field is “N/A” then this service uses preassigned index values and this entry is Not Applicable. If the value in this field is “Not Found” then there is a problem with the entry for this service and its counters will not appear in System Monitor.