The CEBT PERFORM commands allow you to:
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.

CEBT 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.
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

CEBT PERFORM SNAP
>>-CEBT Perform SNap-------------------------------------------><
Function
The CEBT PERFORM TAKEOVER command initiates a takeover by the alternate
CICS system, causing the active CICS system to sign off abnormally.
Syntax

CEBT 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.
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:
- Type CEBT SET AUXTRACE (the minimum abbreviation is CEBT
S AUX). You get a display that lists the current status, similar to
that obtained by CEBT INQUIRE AUXTRACE. You can then tab to the highlighted
or blank fields and overtype them with the required values.
- Type CEBT SET AUXTRACE (CEBT S AUX) followed by
one or more attribute settings that you wish to change. For example, CEBT S AUX STO will stop auxiliary tracing if it is already running.

CEBT 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.
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:
- Type CEBT SET DUMP (the minimum abbreviation is CEBT S
DU). You get a display that lists the current status, similar to that
obtained by CEBT INQUIRE DUMP. You can then tab to the highlighted or blank
fields and overtype them with the required values.
- Type CEBT SET DUMP (CEBT S DU) followed by one or
more attribute settings that you wish to change. For example, CEBT S
DU A will cause an automatic switch to the inactive dump data set if ‘noautoswitch’
was previously specified.

CEBT 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.
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:
- Type CEBT SET GTFTRACE (the minimum abbreviation is CEBT
S G). You get a display that lists the current status, similar to that
obtained by CEBT INQUIRE GTFTRACE. You can then tab to the highlighted or
blank fields and overtype them with the required values.
- Type CEBT SET GTFTRACE (CEBT S G) followed by one
or more attribute settings that you wish to change. For example, CEBT
S G STO will stop GTF tracing if it is already running.

CEBT 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.
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:
- Type CEBT SET INTTRACE (the minimum abbreviation is CEBT
S IN). You get a display that lists the current status, similar to that
obtained by CEBT INQUIRE INTTRACE. You can then tab to the highlighted or
blank fields and overtype them with the required values.
- Type CEBT SET INTTRACE (CEBT S IN) followed by one
or more attribute settings that you wish to change. For example, CEBT
S IN STO will stop internal tracing if it is already running.

CEBT SET INTTRACE
>>-CEbt Set Inttrace--+-------+--------------------------------><
+-STArt-+
'-STOp--'
Options
- STArt
- CICS internal tracing is started.
- STOp
- CICS internal tracing is stopped.
Function
Set surveillance (or tracking) of the active CICS by the alternate CICS
on or off.
Syntax

CEBT 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.
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:
- Type CEBT SET TAKEOVER (the minimum abbreviation is CEBT
S T). You get a display that lists the current status, similar to that
obtained by CEBT INQUIRE TAKEOVER. You can then tab to the highlighted or
blank fields and overtype them with the required values.
- Type CEBT SET TAKEOVER (CEBT S T) followed by one
or more attribute settings that you wish to change. For example, CEBT
S T M changes takeover to a manual operation if it was previously specified
to be automatic.

CEBT 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 ]]