PUSH HANDLE

Suspend the stack.

Read syntax diagramSkip visual syntax diagram
PUSH HANDLE

>>-PUSH HANDLE-------------------------------------------------><

This command is threadsafe.

 

Description

PUSH HANDLE enables you to suspend the current effect of IGNORE CONDITION, HANDLE ABEND, HANDLE AID, and HANDLE CONDITION commands. This can be useful, for example, during a branch to a subroutine embedded in a main program.

Normally, when a CICS® program calls a subroutine at the same logical level, the program or routine that receives control inherits the current HANDLE commands. These commands may not be appropriate within the called program. The called program can use PUSH HANDLE to suspend existing HANDLE commands.

Note: When a CICS program uses EXEC CICS LINK to call another CICS program, the HANDLE CONDITION options are NOT inherited by the linked-to program, but CICS will search preceding logical levels for a HANDLE ABEND exit. See CICS Application Programming Guide for further details about the relationship between LINK and HANDLE ABEND.

You can nest PUSH HANDLE ... POP HANDLE command sequences within a task. Each PUSH HANDLE command stacks a set of specifications.

The C language does not support PUSH HANDLE.