Return and Reason Codes

When the contention exit returns control to the system, ceplretcode contains a return code.

The following table identifies return codes from a contention exit, tells what each means and the actions that XES should take.

Table 1. Return Codes for the Contention Exit
Hexadecimal
Return Code
Meaning and Action
0 Equate Symbol: IXLRCCONTEXITCONTINUEMANAGEMENT

Meaning: Contention exit complete.

Action: Continue normal management of the resource. If notify exits are to be scheduled, call the contention exit after all notify exits complete.

4 Equate Symbol: IXLRCCONTEXITSTOPMANAGEMENT

Meaning: Contention exit complete.

Action: Terminate management (assuming that no contention exists). If any notify exits are to be scheduled, do not call the contention exit after all notify exits complete if actions taken by the notify exit cause the resource to no longer be in contention.

8 Equate Symbol: IXLRCCONTEXITCALLAGAIN

Meaning: Invoke the contention exit again with the resource request queue updated to reflect the actions specified.

Action: Invoke the exit again without waiting for the arrival of a new request.

C Equate Symbol: IXLRCCONTEXITREBUILDDEFER

Meaning: Do not invoke the contention exit again for this resource until structure rebuild processing has completed.

Action: Restart the contention exit either after this connector has responded to the REBLDCLEANUP event (for a new structure) or the REBLDSTOP event (for the old structure).