Exit xrmiin – IBM SC34-6814-04 User Manual

Page 215

Advertising
background image

UERCBYP

Suppress the dump call.

UERCPURG

Task purged during XPI call.

XPI calls

All can be used.

Resource manager interface program exits XRMIIN and XRMIOUT

Exit XRMIIN

When invoked

Before a task-related user exit program is invoked due to an application
program issuing 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:

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.

Return codes

Chapter 1. Global user exit programs

193

Advertising