On invocation, XSTOUT is passed the address of a buffer containing one
or more statistics records. The buffer can contain records for various resource
types (for example, connections and modenames), and both specific and global
information (for example, loader statistics for individual programs, and loader
statistics for all programs).
Your exit program can identify the types of records in the buffer by their
STID values. (STID values are described in CICS statistics data section.)
You can use XSTOUT to prevent the contents of the statistics data buffer
being written to SMF. Note that you cannot use it to selectively suppress
individual records within the buffer. Your exit program should not modify
the values of any of the exit-specific parameters.
Note:
Some statistics records may be produced during very early
during CICS® initialization which will not be passed to XSTOUT. The earliest
that a global user exit can be enabled is during PLT processing. Before this
no exits can be invoked.
- When invoked
- Before a statistics record is written to SMF.
- Exit-specific parameters
- Fields UEPTRANID, UEPUSER, UEPTERM, and UEPPROG have meaning only for requested statistics (when using CEMT PERFORM STATISTICS RECORD
or the EXEC CICS PERFORM STATISTICS RECORD command).
- UEPTRANID
- Address of the 4-byte transaction ID.
- UEPUSER
- Address of the 8-byte user ID.
- UEPTERM
- Address of the 4-byte terminal ID.
- UEPPROG
- Address of the 8-byte application program name.
- UEPSTATS
- Address of a buffer containing one or more statistics records. For
unsolicited statistics, the buffer always contains one record; for other types
of statistics, it may contain several records. The length of the buffer is
addressed by the UEPSRLEN parameter.
- UEPSRLEN
- Address of the 4-byte hexadecimal length of the statistics record.
- UEPSTYPE
- Address of the 3-byte character field statistics type. The values of
the types are:
- INT
- Interval statistics
- EOD
- End-of-day statistics
- REQ
- Requested statistics
- RRT
- Requested reset statistics
- USS
- Unsolicited statistics.
- UEPSDATE
- Address of a 6-byte character field containing the collection date (MMDDYY).
- UEPSTIME
- Address of a 6-byte character field containing the collection time (HHMMSS).
- UEPSIVAL
- Address of a 6-byte character field containing the interval time (HHMMSS).
This field has meaning only for interval statistics.
- UEPSIVN
- Address of the 4-byte interval number. This field has meaning only for
interval statistics.
- UEPSCLD
- Address of an 8-byte character field containing the collection date
(MMDDYYYY).
- Return codes
-
- UERCNORM
- Continue processing.
- UERCBYP
- Suppress output of statistics data buffer to SMF.
- XPI calls
- WAIT_MVS can be used. Note, however, that the wait
cannot be purged using CEMT or SPI. Do not use any other
calls.

[[ Contents Previous Page | Next Page Index ]]