POP HANDLE

Summary

Syntax
Error Conditions

Restores the stack. POP HANDLE command used to restore the current effect of the HANDLE CONDITION, IGNORE CONDITION, HANDLE ABEND and HANDLE AID commands to the before state a PUSH HANDLE command was executed at the current link level.

In general, 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 inherited commands may not be appropriate in the called program.

The called program can use PUSH HANDLE to suspend existing HANDLE commands and can restore the original commands using the POP HANDLE command before returning control to the calling program. If a POP HANDLE is coded for PUSH HANDLE, all the conditions that are suspended will get restored.

Syntax -

POP HANDLE

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.

Error Conditions -

Below are the list of error conditions may occur in combination. If more than one occurs, only the first is passed to the application program.

Error Condition	RESP2, Description & Solution	System Action
16 INVREQ	Occurs if no matching PUSH HANDLE command has been executed at the current link level. Solution -Modify the application program to remove the currently executing POP HANDLE command. Every PUSH HANDLE should have corresponding POP HANDLE, not more or not less.	Task abnormally terminated