The CICS® transaction
CLER allows you to display all the current Language Environment runtime
options for a region, and to modify a subset of these options. The
CLER transaction can be used to:
- Display the current runtime options in effect for the region.
- Modify the following subset of the region runtime options:
- ALL31(ON|OFF)
- CBLPSHPOP(ON|OFF)
- CHECK(ON|OFF)
- HEAPZONES(0-1024,QUIET|MSG|TRACE|ABEND)
- INFOMSGFILTER(ON|OFF)
- RPTOPTS(ON|OFF)
- RPTSTG(ON|OFF)
- TERMTHDACT(QUIET|MSG|TRACE|DUMP|UAONLY|UATRACE| UADUMP|UAIMM)
- TRAP(ON|OFF)
- Write the current region runtime options to the CESE queue for printing.
The CLER transaction is conversational; it presents the user with commands for the terminal display. The runtime options that can be modified with this transaction are only in effect for the duration of the running region.
The CLER transaction must be defined in the CICS CSD (CICS System
Definition file). The following definitions are required, and are
in the Language Environment CEECCSD
job in the SCEESAMP data set. Use the CEECCSD job to activate these
definitions, or you must define them dynamically with the CICS CEDA transaction.
DEFINE PROGRAM(CEL4RTO) GROUP(CEE) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
DEFINE MAPSET(CELCLEM) GROUP(CEE)
DEFINE MAPSET(CELCLRH) GROUP(CEE)
DEFINE TRANS(CLER) PROG(CEL4RTO) GROUP(CEE) Note: If the runtime option ALL31 is modified to OFF, the stack is
forced to BELOW. When the stack is modified to BELOW, it will remain
below for the duration of the region, even if you set ALL31 back to
ON. A warning message, asking if you want to continue, is presented
on the panel if the runtime option ALL31 is set to OFF or CBLPSHPOP,
RPTOPTS, and RPTSTG are set to ON.
To send the runtime option report to the CESE queue for output display or printing, press PF10 on the panel which displays the runtime option report.
For detailed information on the use of CLER, select PF1 from the main menu that is displayed when the CLER transaction is invoked.