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 are:
- CLOCKTIME
- The elapsed time part
- CLOCKCOUNT
- The count of the number of times the condition occurred
All types of user fields can be specified in the Performance Summary report. The format of the command is:
- For character type user fields:
CICSPA SUMMARY( FIELDS(CHARACTER(OWNER(owner)[,SUBSTR(offset,length)]),...))
- For count and clock type user fields:
CICSPA SUMMARY( FIELDS(COUNT|CLOCKTIME|CLOCKCOUNT( OWNER(owner),NUMBER(nnn),AVE|DEV|MAX|MIN|TOT|nn, ASCEND|DESCEND|PRIMARY,K|KB|M|MB),...))
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.
- SUBSTR(offset,length)
- Optional. Applies to CHARACTER fields only. SUBSTR specifies that only part of the user field is to be reported. Offset is the starting position (from 1) in the character field, and length is the number of characters from that position to include. If SUBSTR is not specified, the default is the entire field up to a limit of 8 characters for this 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 only one character field can be defined for each owner.
- AVE|DEV|MAX|MIN|TOT|nn|RNGCOUNT(range)|RNGPERCENT(range)
- All count and clock type fields are summarized and can be presented
using the same statistical functions available to CICS-defined fields.
However, unlike CICS-defined fields, you can specify only one function per user field. If more than one function is to be used, the entire specification must be repeated. For example, the following command generates a Performance Summary report summarized by transaction and terminal, and displaying the maximum, minimum, and average elapsed times.
CICSPA SUMMARY( FIELDS(TRAN,TERM,TASKCNT, CLOCKTIME(OWNER(USER),NUMBER(001),MAX), CLOCKTIME(OWNER(USER),NUMBER(001),MIN), CLOCKTIME(OWNER(USER),NUMBER(001))))
For more information on specifying user fields, see Suboperands for User fields.