PUSH HANDLE

Suspends existing HANDLE commands.

Syntax

PUSH HANDLE

Read syntax diagramSkip visual syntax diagramPUSH HANDLE
Note: PUSH HANDLE is not supported for C or C++ programs.

 

Description

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

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

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