Scheduler service domain’s generic gates

Table 93 summarizes the scheduler services domain’s generic gates. It shows the level-1 trace point IDs of the modules providing the functions for the gates, the functions provided by the gates, and the generic formats for calls to the gates.

Table 93. Scheduler services domain’s generic gates
Gate Trace Function Format
DMDM
SH 0101
SH 0102
PRE_INITIALIZE
INITIALIZE_DOMAIN
QUIESCE_DOMAIN
TERMINATE_DOMAIN
DMDM
XMAC
SH 0121
SH 0122
INIT_XM_CLIENT
BIND_XM_CLIENT
RELEASE_XM_CLIENT
XMAC
RMDE
SH 0131
SH 0132
START_DELIVERY
DELIVER_RECOVERY
END_DELIVERY
RMDE
RMKP
SH 0131
SH 0132
TAKE_KEYPOINT
RMKP
RMRO
SH 0131
SH 0132
PERFORM_PERPARE
PERFORM_COMMIT
PERFORM_SHUNT
PERFORM_UNSHUNT
START_BACKOUT
DELIVER_BACKOUT
END_BACKOUT
RMDE
TISR
SH 0701
SH 0702
NOTIFY
TISR
KETI
SH 0701
SH 0702
NOTIFY_RESET
KETI

For descriptions of these functions and their input and output parameters, refer to the Topics dealing with the corresponding generic formats:

Functions and parameters

When invoked for the DMDM INITIALIZE_DOMAIN function scheduler services obtains its anchor block and initializes its various classes. This would include starting the scheduler services system task , CSHY and obtaining the name of the distributed routing exit program named on the DSRTPGM system initialization parameter.

When invoked by transaction manager via the XMAC generic gate, for INIT_XM_CLIENT SH domain obtains a user token in order to set up the correct transaction environment. For BIND_XM_CLIENT SH domain initializes recoverable resources, which includes setting the RM work token and logging a backout request for this UOW. SH domain also determines the name of the program to be invoked on the initial program link.

When invoked for the RMRO PERFORM_PREPARE function SH domain prepares to commit the pending request for the UOW by adding them to the local request queue (LRQ). On receipt of the RMRO PERFORM_COMMIT the schedule requests for this UOW are committed or destroyed, depending upon whether we are committing forwards or backwards.

When invoked for the RMDE DELIVER_RECOVERY function SH domain recreates the pending request queues and in the case of inflight UOWs attempts to retry the associated BTS activation.

Scheduler services makes use of the TISR functions, REQUEST_ NOTIFY_INTERVAL and NOTIFY to deal with delayed schedule requests i.e. EXEC CICS® DEFINE TIMER calls.

The KETI interface is used when the time is adjusted, causing the time at which delayed schedule requests are to expire to be recalculated.

[[ Contents Previous Page | Next Page Index ]]