User fields

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