Filter
Top Products
CEMT SET DSNAME
Syntax: Press the Clear key to clear the screen. There are
two ways of commencing this transaction:
Type CEMT SET DSNAME (the minimum abbreviation is
CEMT S DSN) with either a value corresponding to a data
set name or ‘ALL’. You get a display that lists the current
status, similar to that obtained by CEMT INQUIRE
DSNAME. You can then tab to the highlighted or blank
fields and overtype them with the required values.
Type CEMT SET DSNAME (CEMT S DSN) with either a
dataset_name or ‘ALL’, followed by one or more
attributes that you wish to change. For example, cemt s
dsn(applb.ᑍ) q quiesces all data sets with a high-level
qualifier of APPLB in all CICS regions within the sysplex.
Resetting the values takes effect immediately.
─ ──CEMT Set DSName ──┬ ┬──(value) ──────────────
└┘─ALl─────
─ ──┬ ┬──────────── ──┬ ┬───────────── ────────────
├ ┤─REMOve───── ├ ┤─AVailable───
├ ┤─RECOVEREd── └ ┘─UNAvailable─
├ ┤─RESetlocks─
└ ┘─RETRy──────
─ ──┬ ┬───────────── ──┬ ┬───────── ─
├ ┤─Quiesced──── ├ ┤─BACkout─
├ ┤─UNQuiesced── ├ ┤─Commit──
└ ┘─IMmquiesced─ └ ┘─FOrce───
Options
(
value
)
specifies one or more names (1-44 characters) of an
external data set.
ALl
If you specify the ALL operand on a SET command, any
change you request is made to all resources of the
specified type that you are authorized to access.
AVailable
specifies whether the data set is to be marked in this
CICS region as available for use. This command sets
the availability indicator, which is a local flag that a CICS
region maintains in a data set name block (DSNB) for
each data set. CICS can issue either RLS or non-RLS
open requests for this data set.
BACkout
Specifies that all shunted in-doubt UOWs that hold locks
on this data set should be backed out.
Commit
Specifies that all shunted in-doubt UOWs that hold locks
on this data set should be committed.
FOrce
Specifies that all shunted in-doubt UOWs that hold locks
on this data set should be forced to BACKOUT or
COMMIT as specified by the ACTION attribute on the
transaction resource definition.
IMmquiesced
Causes all existing CICS open RLS-mode files
throughout the sysplex to be closed and the data set to
be marked as quiesced in the ICF catalog. Each CICS in
the sysplex abends all in-flight UOWs that are accessing
the data set before closing files, causing in-flight UOWs
to back out. Any UOWs that fail backout are shunted. No
RLS-mode files can open against this data set, but
non-RLS-mode open requests are permitted.
In addition to closing open files, IMMQUIESCED sets the
file state to UNENABLED if it was ENABLED. A
subsequent SET DSNAME UNQUIESCED command
restores the file state to ENABLED, if it was set
UNENABLED by a QUIESCED or IMMQUIESCED
action, but
not
if the UNENABLED state is due to some
other event. This state change is recorded in the CICS
global catalog.
Attention
Using the IMMQUIESCED option causes any tasks
currently using the data set to be terminated
immediately, using the CICS task FORCEPURGE
mechanism. In some extreme cases CICS may
terminate abnormally. For this reason, setting a data
set as quiesced using the IMMQUIESCED option
should be restricted to exceptional circumstances.
Quiesced
Causes all existing CICS files open in RLS mode
throughout the sysplex to be closed and the data set to
be marked as quiesced in the ICF catalog. Each CICS in
the sysplex waits until all in-flight UOWs that are
accessing the data set have reached syncpoint before
closing the files; that is, the UOWs are either:
Successfully committed or
Successfully backed out, or
Shunted because they failed in-doubt, or
Shunted because they failed commit, or
Shunted because they failed backout.
No files can open in RLS mode against this data set, but
non-RLS open requests are permitted.
In addition to closing open files, QUIESCED sets the file
state to UNENABLED if it was ENABLED. A subsequent
SET DSNAME UNQUIESCED command restores the file
state to ENABLED, if it was set UNENABLED by a
QUIESCED or IMMQUIESCED action, but
not
if the
UNENABLED state is due to some other event. This
state change is recorded in the CICS global catalog.
RECOVEREd
The data set has been restored from a backup version
and forward recovery has run and completed
successfully. CICS normally updates the
backup-while-open (BWO) attributes for the base cluster
data set BASEDSNAME, using MVS/DFP 3.2 Callable
Services.
Chapter 11. Master terminal CEMT 177