Controlling z/OS data collectors

Use the DCSTAT view to control individual z/OS data collectors.

Related topic

>W1 =DCSTAT============(ALL======*=======)yyyymmdd=13:26:54======MVMVS====D===96
C Name Id Context Data Collector Description     Status   Samp Samp Err TCB Co
- ---- -- Name     ------------------------------ -------- Rate Cnt Cnt Modul
   AOC 1E CXKEM    AutoOperator Control           Inactive
   AOC 1E DXKEM    AutoOperator Control           Inactive
   ASEV 01 CXKEM    Address Space Event            Active      1 174   0 BBM0DC
   ASEV 01 DXKEM    Address Space Event            Active      1 174   0 BBM0DC
   ASTM 02 CXKEM    Address Space Timed            Active     15   12   0 BBM0DC
   ASTM 02 DXKEM    Address Space Timed            Active     15   12   0 BBM0DC
   BPXP 52 CXKEM    USS System Parameters          Active     60    3   0 UCPM0
   BPXP 52 DXKEM    USS System Parameters          Active     60    3   0 UCPM0
   CACH 1D CXKEM    Cache                          Sleeping    1    2   0 BBM0DC
   CACH 1D DXKEM    Cache                          Sleeping    1    2   0 BBM0DC
   CFAC 1F CXKEM    Coupling Facility              Active     15   12   0 BBM0DC
   CFAC 1F DXKEM    Coupling Facility              Active     30    6   0 BBM0DC
   CPTH 0D CXKEM    Channel Path                   Active     15   12   0 BBM0DC
   CPTH 0D DXKEM    Channel Path                   Active     15   12   0 BBM0DC
   CPU 07 CXKEM    CPU                            Active     15   12   0 BBM0DC
   CPU 07 DXKEM    CPU                            Active     15   12   0 BBM0DC
   CPUD 10 CXKEM    CPU Delay                      Active      1 174   0 BBM0DC
   CPUD 10 DXKEM    CPU Delay                      Active      1 174   0 BBM0DC
   CRY 2B CXKEM    Cryptographic                  Active     10   18   0 BBM0DC
   CRY 2B DXKEM    Cryptographic                  Active     10   18   0 BBM0DC
   CSRE 27 CXKEM    Common Storage                 Active     15   12   0 BBM0DC
   CSRE 27 DXKEM    Common Storage                 Active     15   12   0 BBM0DC
   DEVX 05 CXKEM    Device                         Active      1 174   0 MDC22
   DEVX 05 DXKEM    Device                         Active      1 174   0 MDC22
   ENQ 0F CXKEM    Enqueue and Enqueue Delay      Active      1 174   0 BBM0DC
   ENQ 0F DXKEM    Enqueue and Enqueue Delay      Active      1 174   0 BBM0DC
   FMNT 51 CXKEM    Mounted Filesystems            Active     60    4   0 UCFM0
   FMNT 51 DXKEM    Mounted Filesystems            Active     60    4   0 UCFM0
   HFSG 56 CXKEM    HFS Global                     Active     30    6   0 UCHG0
   HFSG 56 DXKEM    HFS Global                     Active     30    6   0 UCHG0
   HSMD 14 CXKEM    HSM Delay                      Active      1 174   0 BBM0DC
   HSMD 14 DXKEM    HSM Delay                      Active      1 174   0 BBM0DC
   IOQ 06 CXKEM    I/O Queuing Delay              Active      1 174   0 BBM0DC
   IOQ 06 DXKEM    I/O Queuing Delay              Active      1 174   0 BBM0DC
   JESD 25 CXKEM    JES Delay                      Active      1 174   0 BBM0DC
   JESD 25 DXKEM    JES Delay                      Active      1 174   0 BBM0DC

The following table describes the DCSTAT view fields:

Field name	Description
Name	Identifies the name of the data collector
Id	Identifies the unique, internal number for the data collector, expressed as a hexadecimal number
Context Name	Identifies the context of the data collector
Data Collector Description	Identifies the type of data collected
Status	Identifies the current status of the data collector; possible values are as follows: Active—able to execute Inactive—unable to execute Error—stopped due to serious execution errors Disabled—permanently unable to execute
Samp Rate	Sampling frequency for the data collector The data collector execution cycle is one second. A sample rate of 1 means that the data collector will be invoked on every execution cycle. A sample rate of 5 means that the data collector is invoked every 5th cycle (that is, every 5 seconds).
Samp Cnt	Sampling count; the number of data collector samples taken during the current interval This count gets reset to zero at the start of every interval.
Err Cnt	Error count; the number of errors in the data collector that have been detected by the data collector driver routine
TCB Coll Module	Module (CSECT) name of the TCB portion of the data collector
TCB Coll Entry Pt	Entry Point Address for the TCB portion of the data collector; expressed in hexadecimal numbers
Service Level	Service Level of the TCB data collector module Typically a PTF number, it might also be BASExxx for modules that have received no service since the product was released.
Date and Time	Date and time that the TCB data collector module was assembled or compiled The format will vary, depending on the language in which the data collector is written.
SRB Coll Module	Module (CSECT) name of the SRB portion of the data collector If the data collector does not run in an SRB, this field will be blank.
SRB Coll Entry Pt	Entry Point Address for the for the SRB portion of the data collector; expressed in hexadecimal numbers

Using DCSTAT

Use DCSTAT to display the current status of the MVS PAS data collectors and to enable or disable any collector.

Warning

To activate a collector, the collector must have been turned off through DCSTAT after initialization of the MVS PAS. You cannot activate a collector that was not originally activated when the PAS was initialized.
In addition, because the z/OS data collectors are shared by BMC AMI Ops Monitor for z/OS and BMC AMI Ops Monitor for CMF, deactivating a collector in one product affects the other product.

The following table provides the procedure for enabling and disabling collectors through DCSTAT.

To perform this action	Follow this procedure
Activate an inactive collector	Type A next to the collector name, and then press Enter. The collector becomes active immediately. Because the collector was not active throughout the current interval, the data for the current interval might be incomplete. This action is not supported for the SHRT data collector. To start short-term data collection, enter the system command: *F mvspas,STDC=START* to start the data collection using the PARMLIB member BBDTST00 *F mvspas,STDC=xx* to start the data collection using the PARMLIB member BBDTSTxx
Deactivate a collector immediately	Type D next to the collector name, and then press Enter. The collector is deactivated immediately. This action is not supported for the SHRT data collector. To stop short-term data collection, enter the system command: *F mvspas,STDC=STOP*

To perform this action

Follow this procedure

Activate an inactive collector

Type A next to the collector name, and then press Enter.

The collector becomes active immediately.

Because the collector was not active throughout the current interval, the data for the current interval might be incomplete.

This action is not supported for the SHRT data collector. To start short-term data collection, enter the system command:

F mvspas,STDC=START to start the data collection using the PARMLIB member BBDTST00

F mvspas,STDC=xx to start the data collection using the PARMLIB member BBDTSTxx

Deactivate a collector immediately

Type D next to the collector name, and then press Enter.

The collector is deactivated immediately.

This action is not supported for the SHRT data collector. To stop short-term data collection, enter the system command:

F mvspas,STDC=STOP

Controlling z/OS data collectors

Using DCSTAT

On this page