PUSH HANDLE

Suspend the stack.

PUSH HANDLE

Read syntax diagramSkip visual syntax diagramPUSH HANDLE

This command is threadsafe.

Description

You can use the PUSH HANDLE command to suspend the current effect of the IGNORE CONDITION, HANDLE ABEND, HANDLE AID, and HANDLE CONDITION commands.

Restriction: This command is supported only in COBOL, PL/I, and assembler language applications (but not AMODE(64) assembler language applications). It is not supported in all other supported high level languages.

This command 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 in 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 Abnormal termination recovery 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.