IBM SC33-1683-02 User Manual

Page 272

Advertising
background image

A14EALRJ: Each time an XZIQUE global user exit program returns with a request
to reject a request, CICS increments a new field in the system entry connection
statistics. This is A14EALRJ (allocate rejected) in DSECT DFHA14DS. This field is
provided to help you to tune the queue limit. Normally, if the number of sessions
and the queue limit defined for a link are correctly balanced, and there has been no
abnormal congestion on the link, the A14EALRJ should be zero. If the rejected
allocates field is non-zero it probably indicates that some action is needed.

A14EQPCT and A20EQPCT: 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 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.

VTAM working-set module exits

240

CICS TS for OS/390: CICS Customization Guide

Advertising