Exit XPCREQ
Exit XPCREQ is invoked by the EXEC interface program before a link request is processed.
- When invoked
- By the EXEC interface program before a link request is processed.
- Exit-specific parameters
-
- UEPCLPS
- Address of the command parameter list.
- UEPPCTOK
- Address of a 4-byte token to be passed to XPCREQC. This allows you, for example, to pass a work area to exit XPCREQC.
- UEPRCODE
- Address of a 6-byte hexadecimal copy of EIBRCODE.
- 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.
- UEPRESP
- Address of a 4-byte copy of EIBRESP.
- UEPRESP2
- Address of a 4-byte copy of EIBRESP2.
- UEPTSTOK
- Address of a 4-byte token that is valid throughout the life of a task. See Using the task token UEPTSTOK.
- UEPRSRCE
- Address of an 8-character copy of the EIB resource value, EIBRSRCE.
- UEP_PC_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.
- Return codes
-
- UERCBYP
- Program control is to ignore the request.
- UERCNORM
- Continue processing.
- UERCPURG
- Task purged during XPI call.
- XPI calls
- All can be used.
Although the exit permits the use of XPI GETMAIN and FREEMAIN calls, we recommend that you use the EXEC CICS GETMAIN and FREEMAIN commands instead.
- API and SPI calls
- All can be used, except for:
- EXEC CICS SHUTDOWN
- EXEC CICS XCTL