RGINIT= parameter for procedures
Use the optional RGINIT parameter in procedures to specify a 1 to 8-character name of a Region Initialization exit. The Region Initialization exit is called during region initialization for IMS message processing regions (MPRs) and when the region recovers after an application abend.
You can set the RGINIT= parameter using the DFSOPT DD statement in IMS-supplied procedures. The syntax for the RGINIT= parameter is:
RGINIT=char str (No
default)
For more information, see DFSOPT DD in DD statements for IMS procedures.
This topic contains Product-sensitive Programming Interface information.
If the exit specified by RGINIT= cannot be loaded, message DFS4589E is issued, and the dependent region initialization continues without calling the exit.
The following subsections describe the interface between IMS and the Region Initialization exit.
Contents of registers upon entry
Upon entry, registers are set as follows:
| Register | Content |
|---|---|
| R0 | 0 |
| R1 | 0 |
| R13 | Address of caller's save area. |
| R14 | Return address of caller. |
| R15 | Entry point address of the commit exit. |
All other registers are unpredictable.
The Region Initialization exit is called in key 8, problem state.
Content of registers upon exit
The Region Initialization exit must restore all registers except for 15 before returning to IMS. R15 must contain the following return code:
| Register | Contents |
|---|---|
| 0 | Normal exit return. |
Results are unpredictable if any other value is returned for R15.