Exit XNQEREQ
Exit XNQEREQ is invoked before CICS® processes an EXEC CICS ENQ or DEQ request, or attempts to match it to an installed ENQMODEL resource definition.
Exit-specific parameters
- UEPCLPS
- Address of a copy of the command parameter list. See Accessing the command-level parameter structure from exits XNQEREQ and XNQEREQC.
- UEPNQTOK
- Address of a 4-byte area which can be used to pass information between XNQEREQ and XNQEREQC for a single enqueue request.
- UEPRCODE
- Address of a 6-byte hexadecimal copy of the EIB return code EIBRCODE. For details of EIB return codes, see EIB fields.
- UEPRESP
- Address of a 4-byte binary copy of the EIB response code EIBRESP.
- UEPRESP2
- Address of a 4-byte binary copy of the EIB response code EIBRESP2.
- UEPTSTOK
- Address of a 4-byte token which can be used to pass information between successive enqueue requests within the same task (for example, between successive invocations of the XNQEREQ exit).
- 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.
- UEPSCOPE
- Address of the 4-byte ENQSCOPE name to be used.
Return codes
- UERCBYP
- Bypass this request.
- UERCNORM
- Continue processing.
- UERCPURG
- Task purged during XPI call.
- UERCSCPE
- An ENQSCOPE name has been supplied.
XPI calls
All can be used.
API and SPI calls
All can be used, except for:
- EXEC CICS SHUTDOWN
- EXEC CICS XCTL
Note: Take care when issuing recursive commands. For example, you must avoid entering a loop when
issuing an enqueue request from the XNQEREQ exit. Use of the recursion counter UEPRECUR is
recommended.