CICS PA can
access user fields in the CMF performance records. The user fields
are defined in the CICSĀ® Monitoring
Control Table (MCT) as either character type, count type, or clock
type.
The command format is:
SELECT(PERFORMANCE(EXCLUDE|INCLUDE(
CHARACTER(
OWNER(owner),
SUBSTR(offset,length),
VALUE(value list)),
COUNT|CLOCKTIME|CLOCKCOUNT(
OWNER(owner),
NUMBER(nnn),
VALUE(value list)))))
All the FIELDS operands documented in
Suboperands for User fields are
required with SELECT. These are:
- For character user fields: OWNER, SUBSTR and VALUE
- For numeric user fields: OWNER, NUMBER and VALUE
- OWNER
- The 1-8 character
name of the owner of the user field. This is the entry name in the
DFHMCT ID= macro specification for the user field, or the CICS-assigned
default name of USER.
- SUBSTR
- Specifies that
only part of the field is to be checked, from the offset position
for the given length. For example, if the character user field
contains ANIMALS, then SUBSTR(4,3) is MAL.
- NUMBER
- The three-digit
integer that identifies a specific count or clock type field.
- VALUE
- Identifies the
value used in the selection criteria. The syntax for the values for
user fields is the same as that for character, clock, and count fields.
Example:
If user fields are defined in the MCT, consider a user character
field that is set to INQUIRY whenever an INQUIRY function of the TEST
transaction is run. The following command then generates a Performance
List report containing only data for the TEST transaction INQUIRY
function where:
- Count 1 has a value between 1 and 10
- Clock 1 has an elapsed time greater than 1 second
- Clock 1 was stopped and restarted at least once
CICSPA SELECT(PERFORMANCE(INCLUDE(
TRAN(TEST),
CHARACTER(OWNER(USEREMP),SUBSTR(1,7),VALUE(INQUIRY)),
COUNT(OWNER(USEREMP),
NUMBER(001),
VALUE(1-10)),
CLOCKTIME(OWNER(USEREMP),
NUMBER(001),
VALUE(1000-999999999)),
CLOCKCOUNT(OWNER(USEREMP),
NUMBER(001),
VALUE(2-999999999))))),
LIST