Resource Manager Interface Program Exits Xrmiin And Xrmiout - IBM SC34-6814-04 Customization Manual

Cics transaction server for z/os
Table of Contents

Advertisement

XPI calls

Resource manager interface program exits XRMIIN and XRMIOUT

Exit XRMIIN
When invoked
Exit-specific parameters
Return codes
UERCBYP
Suppress the dump call.
UERCPURG
Task purged during XPI call.
All can be used.
Before a task-related user exit program is invoked due to an application
program issuing an RMI API request.
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:
DFHUEXIT TYPE=EP,ID=XRMIIN
DFHUEXIT TYPE,TYPE=RM
The statements must be coded in this order.
The 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.
Chapter 1. Global user exit programs
193

Advertisement

Table of Contents
loading

Table of Contents