IBM SC33-1686-02 Server User Manual


 
CEMT INQUIRE DSNAME
Quiescestate
displays the RLS quiesce state of the data set. The
information is obtained from the ICF catalog entry for the
data set. The values displayed are:
Quiesced
A data set has been quiesced. It means that RLS
ACBs cannot open against the data set and no
CICS region has an RLS ACB currently open
against this data set. However, the data set can
be opened in non-RLS mode.
UNQuiesced
This is the normal value for a data set that is not
quiescing or has not been quiesced. It indicates
that RLS or non-RLS ACBs can be opened
against the data set, the mode being established
by the first open. After an ACB is opened in one
mode, other ACBs can be opened only in the
same mode.
If a data set is quiescing because a SET DSNAME
QUIESCE command was issued in the same region as
the CEMT I DSN command, the words “BEING
QUIESCED” are displayed.
If a data set is quiescing, the words “BEING
QUIESCED” are displayed for the CICS region in which
the command was issued.
If quiesce does not apply (for example, for a BDAM data
set), nothing is displayed.
Quiescestate can be reset by specifying
Quiesced|Unquiesced or:
Immquiesced
Causes all existing CICS open RLS ACBs
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 ACBs, causing in-flight UOWs to back out.
Any OUWs that fail backout are shunted. No RLS
ACBs can open against this data set, but non-RLS
open requests are permitted.
Uowaction (
input only field
)
specifies the action to be taken for all shunted units of
work that reference this data set. The values are:
Backout
Specifies that all shunted in-doubt units of work
that hold locks on the data set should be backed
out.
Commit
Specifies that all shunted in-doubt units of work
that hold locks on the data set should be
committed. Specifies that all shunted in-doubt
units of work that hold locks on the data set
should be forced to BACKOUT or COMMIT, as
specified by the ACTION attribute on the
transaction resource definition.
BASEDsname(
value
) (VSAM only)
When PATH is displayed as well, this is the name of the
base data set with which this path is associated.
When BASE is displayed as well, this is the same as the
name shown in the Dsn(
value
) field.
FWDRECOVLsn(
value
)
displays the name of the log stream that is used to log
the updates if this data set is defined as forward
recoverable. CICS returns nulls if the data set is not
forward recoverable.
The log stream name returned is either:
The log stream name specified directly in the ICF
catalog, or
For a non-RLS access mode data set that does not
have forward recovery attributes in the ICF catalog,
it is a log stream name identified by CICS through a
journal name generated from the FWDRECOVLOG
value.
78 CICS Supplied Transactions