Exit XPCREQC

Exit XPCREQC is invoked on completion of a program control link request.

When invoked
On completion of a program control link request.
Exit-specific parameters
UEPCLPS
Address of the command parameter list.
UEPPCTOK
Address of a 4-byte token passed from XPCREQ. This allows XPCREQ to, for example, pass a work area to 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_REMOTE_SYSTEM
If the request is to be sent to a remote region, is the address of an area containing the 4-byte name of the remote region. (The remote region may have been specified by, for example, the SYSID option of the EXEC CICS LINK command, function shipping, work-load management, or the REMOTESYSTEM option of the PROGRAM definition.)

If the request is to be executed on the local region, this parameter is the address of a 4-byte area containing blanks.

UEP_PC_REMOTE_NAME
If the program is to be executed in a remote system, is the address of an area containing the name of the program, as it is known in the remote system.
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
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
Note: Take care when issuing recursive commands not to cause a loop. For example, it is your responsibility to avoid entering a loop when a program control request is issued from the XPCREQ or XPCREQC exits.

Use of the recursion counter UEPRECUR is recommended.



dfha3ea.html | Timestamp icon Last updated: Monday, 5 June 2017