IBM Support

Determining LE run-time options in use by CICS TS regions

Question & Answer


Question

How do I determine what Language Environment (LE) run-time options are currently in use in my CICS Transaction Server (CICS TS) regions?

Answer

CICS programs can include a CEEUOPTS CSECT to supply Language Environment run-time options to control the program's execution. You can specify the LE option RPTOPTS(ON) in the CEEUOPTS CSECT to determine what options are in effect when a specific program runs. When the program ends this option generates a list of all the runtime options used by the program. The list is written to the CESE TD queue.

You can also specify option RPTOPTS(ON) using transaction CLER in CICS. However, turning on the RPTOPTS feature within CICS might have performance implications for the region so you should not do this in a production environment.

You can view the current settings of your LE runtime options for a particular region by doing one of the following:

In CICS:

  1. Enter transaction CLER.

  2. Enter PF5 to view the options.

  3. Enter PF8 to scroll forward through the options. To send the run-time option report to the CESE queue for output display or printing, press PF10 on the panel which displays the run-time option report. Then enter ? to the right of the CICS jobname in ISPF, to display the DDNAMEs for the CICS region including CEEMSG which is the default for CESE. CEEMSG will contain the run-time option report.

The transaction, program, and mapset resource definitions that you need to run CLER are in the CEE group. In CICS TS V2.3 and above, the definitions are added to the CSD automatically during CICS installation, as part of the DFHCOMDS job. They are also supplied in the LE SCEESAMP library.

In IPCS:
When looking at a system dump of your CICS region, enter IPCS command VERBX LEDATA 'CAA(xxxxxxxx)' where xxxxxxxx is the LE common anchor address. This address can be found in the System TCA in field TCACAAAD.

Alternatively, enter VERBX DFHPDxxx 'APS=' where xxx corresponds to your CICS release and nnnnn is a task number:

  • CICS routines call the LE verb exit and produce the same output as VERBX CEEERRIP ASID(00nn) CAA(xxxxxxxx) DSA(xxxxxxxx) ALL

  • Eliminates the need to determine the DSA address (register 13) and the CAA address (register 12)

  • Formats the Runtime options and LE storage areas (E stprag, LE Traceback, CAA, PCB, MEML, RCB, EDB, Heap control blocks, Stack storage control blocks - User and Lib, DSA, and Condition Management control blocks)

You might also be interested in the dW Answers post on Changing Language Environment runtime options for CICS TS

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"LE370","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server

Document Information

Modified date:
19 March 2015

UID

dwa1180482