User fields
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)]
[,ASCEND|DESCEND]
)))]
For numeric type user fields:
CICSPA LISTX[(FIELDS(COUNT|CLOCKTIME|CLOCKCOUNT(
OWNER(owner),NUMBER(nnn)
[,ASCEND|DESCEND]
)))]
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.