User fields can be one of the following types:
- CHARACTER
- Character string
- COUNT
- Binary or Packed counter
- CLOCKTIME and CLOCKCOUNT
- The two parts of clock type fields:
- CLOCKTIME
- The elapsed time part
- CLOCKCOUNT
- The count of the number of times the condition occurred
The format of the command for requesting user fields in the Performance
List Extended report is:
For character type user fields:
CICSPA LISTX[(FIELDS(CHARACTER(OWNER(owner)
[,SUBSTR(offset,length)])))]
For numeric type user fields:
CICSPA LISTX[(FIELDS(COUNT|CLOCKTIME|CLOCKCOUNT(
OWNER(owner),NUMBER(nnn))))]
The options are:
- OWNER(owner)
- Must be specified for all user field types. It is the 1-8 character
owner of the user field, identified by the entry name in the ID= parameter
of the TYPE=EMP entry in the MCT, or the CICS-assigned default name
of USER (no entry name in the ID= parameter).
- SUBSTR(offset,length)
- Optional. Applies to character fields only. It specifies that
only part of the user field is to be reported; that part starting
at the offset position (where 1 is the first character in the
field) for the number of characters specified by length. If
SUBSTR is not specified, the default is the entire field (although
limited to 8 characters for the Performance Summary report).
- NUMBER(nnn)
- Must be specified for all numeric types (COUNT, CLOCKTIME, CLOCKCOUNT).
It specifies the three-digit number that identifies a specific count
or clock type field. For each owner, up to 256 count type and up to
256 clock type user fields can be defined to CICS®, whereas for character user fields, only
one can be defined for each owner.
For more information on specifying user fields, see Suboperands for User fields.