Exit XNQEREQ
This exit is invoked before CICS® processes an EXEC CICS ENQ or DEQ request, or attempts to match it to an installed ENQMODEL resource definition.
- When 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 The command-level parameter structure.
- 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 commands
- 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.