beautypg.com

IBM CICS Transaction Server for OS/390 SC33-1686-02 User Manual

Page 165

background image

CEMT INQUIRE UOWDSNFAIL

See the section on moving data sets in the

CICS

Recovery and Restart Guide.

DEAdlock (

non-rls data sets only)

A deadlock was detected. This may go away if the
UOW is retried.

DELexiterror

Backout of a write to an ESDS failed because a
logical delete global user exit program was not
enabled, or a logical delete global user exit
program decided not to execute the logical delete.

Failedbkout

This occurs as a result of a severe error being
identified, and is possibly an error in either CICS
or VSAM. The problem may go away if the UOW
is retried. Note that CICS performs some
first-failure data capture (FFDC) at the point where
the error is first detected.

INDExrecfull

A larger alternate index record size needs to be
defined for the data set. See the section on
moving data sets in the

CICS Recovery and

Restart Guide.

This error can also occur when a unique alternate
index key, for a non-RLS data set, has been
reused and CICS is now backing out the request
which had removed that key value.

INDOubt

The unit of work had issued recoverable requests
against the data set, and has now failed in-doubt.
The connection to the coordinating system needs
to be reestablished.

IOerror

A hard I/O error occurred. To correct this error,
restore a full backup copy of the data set and
perform forward recovery. If you use CICSVR as
your forward recovery utility, the backout is
automatically retried for an RLS data set. For a
non-RLS data set, use the RETRY option of the
SET DSNAME command to drive the backout
retry.

Lckstrucfull

An attempt to acquire a lock during backout of an
update to this data set failed because the RLS
lock structure was full. You must allocate a larger
lock structure in an available coupling facility and
rebuild the existing lock structure into it, then use
the SET DSNAME (...) RETRY command to drive
the backout retry.

Notapplic

The value for CAUSE is not CONNECTION,
RLSSERVER, or DATASET.

Openerror

Error on opening the file for backout. A console
message notifies you of the reason for the open

error. One likely reason could be that the data set
was quiesced.

RLSGone

An error occurred when backing out the UOW
because the RLS server is down. This may also
be the reason why the UOW went into backout
originally. This is an error that can be resolved by
recycling the server (which should happen
automatically). Generally, when the server
recovers, the UOWs are retried automatically. In
very exceptional circumstances, it may be
necessary to issue a SET DSNAME(...) RETRY
command to retry UOWs that were not retried
when the server returned.

RRCommitfail

An error occurred whilst RLS locks for the unit of
work were being released. For this data set, the
locks being released were all repeatable read
locks so, if the failure was due to the RLS server
being unavailable, the locks will have been
released. If the failure was due to some other
error from the SMSVSAM server, the locks may
still be held.

RRIndoubt

The unit of work had issued repeatable read
requests against the data set, and has now failed
indoubt. The locks will have been released, so this
failure does not prevent you from running a batch
job against the data set. However, if you want to
open the data set in non-RLS mode from CICS,
you need to resolve the in-doubt failure before you
can define the file as having RLSACCESS(NO). If
the unit of work has updated any other data sets,
or any other resources, you should try to resolve
the in-doubt correctly. If the unit of work has only
performed repeatable reads against VSAM data
sets and has made no updates to other resources,
it is safe to force the unit of work using the SET
DSNAME or SET UOW commands.

Each Reason corresponds to only one Cause value, as
shown in the following table:

Cause

Reason

CACHE

NOTAPPLIC

CONNECTION

INDOUBT

CONNECTION

RRINDOUBT

DATASET

BACKUPNONBWO

DATASET

DELEXITERROR

DATASET

DATASETFULL

DATASET

DEADLOCK

DATASET

FAILEDBKOUT

DATASET

INDEXRECFULL

DATASET

IOERROR

DATASET

LCKSTRUCFULL

DATASET

OPENERROR

RLSSERVER

COMMITFAIL

RLSSERVER

RLSGONE

RLSSERVER

RRCOMMITFAIL

UNDEFINED

Not applicable

Chapter 11. Master terminal CEMT

147