Dispatcher domain exits xdsbwt and xdsawt, Exit xdsbwt – IBM SC34-6814-04 User Manual

Page 69

Advertising
background image

Exit-specific parameters

UEPDBXR

Address of CICS XRF information for use with DBCTL. The CICS
XRF information can be mapped using the DSECT DFHDXUEP.

Return codes

UERCNOAC

Take no action.

UERCSWCH

Switch to the alternate DBCTL.

UERCABNO

Abend CICS without a dump.

UERCABDU

Abend CICS with a dump.

The return code UERCNORM is not available for use at this exit point.

XPI calls

The following must not be used:

v

INQUIRE_MONITORING_DATA

v

MONITOR

v

TRANSACTION_DUMP

v

WRITE_JOURNAL_DATA.

Dispatcher domain exits XDSBWT and XDSAWT

The XDSBWT and XDSAWT exit points are located before and after the operating
system wait. CICS services cannot be used in any exit program invoked from these
exit points.

The XDSBWT and XDSAWT exits can be used to control the swapping state of the
CICS address-space. It should be noted, however, that if the default state of the
address-space is non-swappable then these exits cannot be used to override this
state.

CICS uses a counter which is incremented for every SYSEVENT DONTSWAP
request and decremented for every SYSEVENT OKSWAP request down to a
minimum of 0. A SYSEVENT DONTSWAP request is issued when this counter goes
up from 0 to 1. A SYSEVENT OKSWAP request is issued when this counter goes
down from 1 to 0. In all other circumstances, the SYSEVENT is not issued.

Exit XDSBWT

When invoked

Before an operating system wait issued by the quasireentrant CICS TCB.

Exit-specific parameters

None.

Return codes

UERCNORM

Continue processing.

UERCSWAP

Issue SYSEVENT to allow address-space swapping.

Chapter 1. Global user exit programs

47

Advertising