IBM SC34-6814-04 User Manual

Page 275

Advertising
background image

Each time an XZIQUE global user exit program returns with a request to purge a
queue, CICS increments a new field in either the system entry or mode entry
connection statistics. These fields are:

A14EQPCT

The count of the number of times the queue has been purged for the
connection as a whole.

A20EQPCT

The count of the number of times the mode group queue has been purged.

For detailed information about statistics fields, what they contain and how they are
updated, see ISC/IRC system entry: Resource statistics, in the CICS Performance
Guide
.

Exit XZIQUE:

When invoked

Whenever:

1. An allocate request for a session is about to be queued

2. An allocate request succeeds following previous suppression of

queuing.

Exit-specific parameters

UEPZDATA

Address of the 70-byte area containing the information listed below.
This area is mapped by the DSECT in copybook DFHXZIDS.

Area addressed by UEPZDATA

UEPSYSID

The 4-byte SYSID of the connection.

UEPREQ

A 2-byte origin-of-request code, which can have the following
values:

TR

Transaction routing

FS

Function shipping (includes distributed program link)

AL

Other kinds of intercommunication (for example, distributed
transaction processing (DTP) or CPI Communications).

UEPREQTR

The 4-byte identifier of the requesting transaction (applicable only
when the origin-of-request code is FS or AL).

UEPTRAN

The 4-byte identifier of the transaction being routed (applicable only
when origin of request is TR).

UEPFLAG

A 1-byte flag indicating whether a return code 8 or return code 12
was issued last time the exit was invoked.

UEPRC8

The exit program returned control to CICS on the previous
invocation with return code 8.

UEPRC12

The exit program returned control to CICS on the previous
invocation with return code 12.

Chapter 1. Global user exit programs

253

Advertising