Exit XRMIIN
Exit XRMIIN is invoked before a task-related user exit program is invoked when an application program issues an RMI API request.
- Exit-specific parameters
-
- UEPTRUEN
- Address of the name of the task-related user exit program.
- UEPTRUEP
- Address of the parameter list to be passed to the task-related user exit program.
- UEP_RM_PBTOK
- Address of a 4-byte field containing the z/OS Workload Manager
(WLM) Performance Block Token. An exit program can use this token
to access information (such as the service class token, SERVCLS) in
the WLM Performance Block. To do so, it must use the WLM EXTRACT macro,
IWMMEXTR, passing the Performance Block Token as the MONTKN input
parameter. For more information about the IWMMEXTR macro, see z/OS MVS Programming: Workload Management
Services.
An exit program must not attempt to modify the Performance Block: if it does so, the results are unpredictable.
- UEPRECUR
- Address of a halfword recursion counter. The counter is set to 0 when the exit is first invoked, and is incremented for each recursive call.
Note: The task-related user exit program's parameter list is mapped by a DFHUEPAR DSECT that shares common field names with the global user exit program's DFHUEPAR parameter list. To include both DSECT definitions in your exit program, you must code:The statements must be coded in this order.DFHUEXIT TYPE=EP,ID=XRMIIN
DFHUEXIT TYPE,TYPE=RMThe two DFHUEPAR parameter lists, the global user exit's and the task-related user exit's, occupy separate areas of storage. The task-related user exit's parameter list is provided for information only; you should not amend it in any way.
- Return codes
-
- UERCNORM
- Continue processing.
- UERCPURG
- Task purged during XPI call.
- XPI calls
- All can be used.
- API and SPI commands
- All except EXEC CICS SHUTDOWN and EXEC CICS XCTL can be used. However, CALLDLI, EXEC DLI, or EXEC SQL commands must not be used.