CEBT PERFORM commands

The CEBT PERFORM commands allow you to:

Related tasks
Using CICS supplied transactions
CEBT--master terminal (alternate CICS)
CEBT INQUIRE and SET commands

CEBT PERFORM SHUTDOWN

Function

Shut down the alternate CICS system in an XRF complex.

Description

If you enter CEBT PERFORM SHUTDOWN, all active system tasks are allowed to finish, and the alternate CICS system signs off normally from the CICS availability manager (CAVM) data set.

Read syntax diagramSkip visual syntax diagramCEBT PERFORM SHUTDOWN
 
>>-CEBT Perform SHutdown--Dump--Immediate----------------------><
 

Options

Dump
causes a dynamic storage dump to be produced when the shutdown is complete.
Immediate
causes the alternate CICS system to be shut down immediately, terminating all active tasks. The alternate CICS signs off abnormally from the CAVM data set. This can cause the primary (active) CICS system to abend if tasks are still running.

CEBT PERFORM SNAP

Function

Cause a "snapshot" dump of the alternate CICS system to be taken while CICS continues to run.

All CEBT PERFORM SNAP requests result in an SDUMP on an MVS SYS1.DUMPnn data set.

The use of CEBT PERFORM SNAP prevents all other tasks from running on the alternate system, and could delay takeover or recovery after takeover.

Syntax

Read syntax diagramSkip visual syntax diagramCEBT PERFORM SNAP
 
>>-CEBT Perform SNap-------------------------------------------><
 

CEBT PERFORM TAKEOVER

Function

The CEBT PERFORM TAKEOVER command initiates a takeover by the alternate CICS system, causing the active CICS system to sign off abnormally.

Syntax

Read syntax diagramSkip visual syntax diagramCEBT PERFORM TAKEOVER
 
>>-CEBT Perform Takeover--Dump---------------------------------><
 

Options

Dump
sends a message to the active CICS system requesting it to take a system dump from the CAVM data set. This request is not honored if the active CICS fails before the dump can be taken.
Dump
sends a message to the active CICS system requesting it to take a system dump from the CAVM data set. This request is not honored if the active CICS fails before the dump can be taken.

CEBT SET AUXTRACE

Function

Change auxiliary tracing options.

Description

You can start, stop, or pause tracing, and specify that automatic switching of the auxiliary data set is to occur when needed. You can use the switch option to change the data set.

Instead of using the SET command, you can overtype your changes on the INQUIRE screen after tabbing to the appropriate field (see Overtyping a display).

For information about using traces, see the CICS® Problem Determination Guide.

Syntax

Press the Clear key to clear the screen. There are two ways of commencing this transaction:

Read syntax diagramSkip visual syntax diagramCEBT SET AUXTRACE
 
>>-CEBT Set Auxtrace--+-------+--+----------+--SWitch----------><
                      +-STArt-+  +-NOswitch-+
                      +-Pause-+  +-NExt-----+
                      '-STOp--'  '-All------'
 

Options

All
Specifies that automatic switching between the two auxiliary trace data sets is to occur as necessary until the end of this CICS session, without the need for operator intervention.
NExt
Automatic switching of the auxiliary trace data set is to occur when the current trace data set is full, but not subsequently.
NOswitch
Switching between the auxiliary trace data sets is not to occur without operator intervention.
Pause
Auxiliary tracing is to stop, but the data set is to remain open. A subsequent START request causes trace entries to be written immediately following those that were written before the PAUSE request.
STArt
CICS is to start auxiliary tracing and open the auxiliary trace data set if it is currently closed.
STOp
CICS is to stop auxiliary tracing and close the auxiliary trace data set. A subsequent START request causes new trace entries to be written at the start of the data set, thereby overwriting the trace entries that were written before the STOP request.
SWitch
specifies that an immediate switch from the current auxiliary trace data set is to be made to the alternate trace data set.

CEBT SET DUMP

Function

Change the attributes of a CICS dump data set.

Description

Using CEBT SET DUMP, you can open or close the active CICS dump data set, and specify whether or not the automatic switch to the inactive dump data set is to occur when the active dump data set is full. Instead of using the SET command, you can overtype your changes on the INQUIRE screen after tabbing to the appropriate field (see Overtyping a display).

For information about using dumps, see the CICS Problem Determination Guide.

Syntax

Press the Clear key to clear the screen. There are two ways of commencing this transaction:

Read syntax diagramSkip visual syntax diagramCEBT SET DUMP
 
>>-CEBT Set Dump--+--------+--+--------------+-----------------><
                  +-Open---+  +-Autoswitch---+
                  +-CLosed-+  '-Noautoswitch-'
                  '-Switch-'
 

Options

Autoswitch
The switch occurs only when the active dump data set is full, but not subsequently.
CLosed
The active CICS dump data set is closed.
Noautoswitch
When the active dump data set is full, there is not to be an automatic switch to the inactive dump data set.
Open
The active CICS dump data set is opened.
Switch
The currently active dump data set is to become inactive, and the currently inactive data set is to become active.

CEBT SET GTFTRACE

Function

Change the status of GTF tracing

Description

CEBT SET GTFTRACE allows you to switch CICS tracing to the MVS Generalized Tracing Facility (GTF) on and off.

This command is intended for use at terminals that do not support the CETR full-screen tracing transaction.

For information about using GTF tracing, see the CICS Problem Determination Guide.

Syntax

Press the Clear key to clear the screen. There are two ways of commencing this transaction:

Read syntax diagramSkip visual syntax diagramCEBT SET GTFTRACE
 
>>-CEBT Set Gtftrace--+-------+--------------------------------><
                      +-STArt-+
                      '-STOp--'
 

Options

STArt
CICS tracing to the MVS Generalized Tracing Facility (GTF) is started.
STOp
CICS tracing to the MVS Generalized Tracing Facility (GTF) is stopped.

CEBT SET INTTRACE

Function

Switch CICS internal tracing on or off.

Description

This command is intended for use at terminals that do not support the full-screen tracing transaction CETR.

Syntax

Press the Clear key to clear the screen. There are two ways of commencing this transaction:

Read syntax diagramSkip visual syntax diagramCEBT SET INTTRACE
 
>>-CEbt Set Inttrace--+-------+--------------------------------><
                      +-STArt-+
                      '-STOp--'
 

Options

STArt
CICS internal tracing is started.
STOp
CICS internal tracing is stopped.

CEBT SET SURVEILLANCE

Function

Set surveillance (or tracking) of the active CICS by the alternate CICS on or off.

Syntax

Read syntax diagramSkip visual syntax diagramCEBT SET SURVEILLANCE
 
>>-CEBT Set Surveillance--+-----+------------------------------><
                          +-OFf-+
                          '-ON--'
 

Options

OFf
Surveillance of the active CICS system by the alternate CICS is to be stopped.
ON
Surveillance of the active CICS system by the alternate CICS is to be started.
For more information about surveillance, see the
CICS/ESA 3.3 XRF Guide.

CEBT SET TAKEOVER

Function

Set takeover from the active CICS system by the alternate CICS system to be automatic, manual, or command-driven.

Syntax

Press the Clear key to clear the screen. There are two ways of commencing this transaction:

Read syntax diagramSkip visual syntax diagramCEBT SET TAKEOVER
 
>>-CEBT Set Takeover--+-----------+----------------------------><
                      +-Automatic-+
                      +-Command---+
                      '-Manual----'
 

Options

Automatic
Takeover is to occur automatically.
Command
Takeover is to be by command.
Manual
Takeover is to be manual.

The CICS/ESA 3.3 XRF Guide tells you more about these command options.

[[ Contents Previous Page | Next Page Index ]]