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,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 desired, 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.