Statistics domain exit xstout, Exit xstout – IBM SC33-1683-02 User Manual

Page 212

Advertising
background image

Statistics domain exit XSTOUT

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” on page 685.)

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.

Exit XSTOUT

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.

statistics domain exit

180

CICS TS for OS/390: CICS Customization Guide

Advertising