Language Environment CBLPSHPOP option

The CBLPSHPOP runtime option controls whether Language Environment® automatically issues an EXEC CICS® PUSH HANDLE command during initialization and an EXEC CICS POP HANDLE command during termination whenever a COBOL subroutine is called.

If your application makes many COBOL subroutine CALLs under CICS , performance is better with CBLPSHPOP(OFF) than with CBLPSHPOP(ON). You can set CBLPSHPOP on an individual transaction basis by using CEEUOPT, as explained in Defining runtime options for Language Environment.

However, because condition handling has not been stacked, be aware that:
  • If your called routine raises a condition that causes CICS to attempt to pass control to a condition handler in the calling routine, this is an error and your transaction will be abnormally terminated.
  • If you use any of the PUSHable CICS commands, HANDLE ABEND, HANDLE AID, HANDLE CONDITION, or IGNORE CONDITION, within the called routine, you will be changing the settings of your caller and this could lead to later errors.
  • If you call an assembler routine and need to suspend the current handles , and then reinstate them, the assembler routine must request the push and pop handles. The Language Environment does not do that automatically when a COBOL program calls an assembler routine.


dfhp3_cobol_cblpshpop.html | Timestamp icon Last updated: Monday, 5 June 2017