IBM CICS Transaction Server for OS/390 SC33-1686-02 - Manual (Page 164)

CEMT INQUIRE UOWDSNFAIL
─ ─ ─CEMT Inquire UOWDsnfail ─ ─UOw(value) ───────
─ ─ ─DSname(value) ─ ─┬ ┬ ──────── ──────────────────
├ ┤ ─NOtrls─
└ ┘ ─RLS────
─ ─ ─┬ ┬ ──────────── ─ ─┬ ┬ ────────────── ───────────
├ ┤ ─CAche────── ├ ┤ ─Backupnonbwo─
├ ┤ ─CONnection─ ├ ┤ ─COMmitfail───
├ ┤ ─DATASET──── ├ ┤ ─DATASETFull──
├ ┤ ─RLSServer── ├ ┤ ─DEAdlock─────
└ ┘ ─UNdefined── ├ ┤ ─DELexiterror─
├ ┤ ─Failedbkout──
├ ┤ ─INDExrecfull─
├ ┤ ─IOerror──────
├ ┤ ─Openerror────
├ ┤ ─RLSGone──────
├ ┤ ─INDOubt──────
├ ┤ ─RRCommitfail─
├ ┤ ─RRIndoubt────
└ ┘ ─Lckstrucfull─
─ ─ ─┬ ┬ ────────────── ─ ─┬ ┬ ──────────────── ─
└ ┘ ─ ─Sysid(value) └ ┘ ─ ─NEtname(value)
Sample screen
INQ UOWDSN
STATUS: RESULTS
Dsn(RLS.ACCOUNTS.ESDS.DBASE1 ) Dat Del
Uow(AA6DB 8 C4 CEE 1) Rls
Dsn(RLS.ACCOUNTS.ESDS.DBASE1 ) Dat Ind
Uow(AA6DB 8AC66B4 ) Rls
Figure 131. CEMT INQUIRE UOWDSNFAIL screen
Note: There are blank fields on the screen where a value
does not apply or is ‘negative’; that is, the value
begins with ‘No’. To modify these fields, locate them
by tabbing (they appear in the same sequence as in
the expanded format), and overtype with input valid
for that field. You may find it more convenient to use
the expanded format when setting one of these
values, (negating is easier because you are
overtyping a displayed field with its negative causing
the result to become non-displayed).
If you place the cursor against a specific entry in the list and
press ENTER, CICS displays an expanded format as shown
in Figure 132.
INQ UOWDSN
RESULT
Uowdsnfail
Dsname(RLS.ACCOUNTS.ESDS.DBASE1)
Cause(Dataset)
Reason(Delexiterror)
Uow(AA6DB 8 C4 CEE 1)
Sysid()
Netname()
Rlsaccess(Rls)
Figure 132. The expanded display of an individual entry
Cause
displays which failed component has caused the UOW
to have retained locks for this data set. The values are:
CAche
A cache structure, or connection to it, has failed.
CONnection
There is an intersystem connection error, which
has caused the UOW to fail while in-doubt. The
name of the system to which connectivity was lost
is returned on the SYSID parameter and its
netname is returned on the NETNAME parameter.
CICS returns additional information in the
REASON parameter about the CONNECTION
failure.
DATASET
The backout of a UOW has failed for this data set.
The reason for the data set failure is returned in
the REASON parameter.
RLSServer
The SMSVSAM server has failed. The reason for
the data set failure is returned in the REASON
parameter.
UNdefined
The UOW is probably in-flight following an
emergency restart.
DSname( value)
displays the 44-character data set name of a data set
that has retained locks for this UOW.
NEtname( value)
displays the 8-character netname (when the cause is
CONNECTION) of the remote system to which
connectivity has been lost.
Reason
displays, when the cause is RLSSERVER,
CONNECTION, or DATASET, the specific reason for the
error against this data set. The values are:
Backupnonbwo
A non-BWO backup was in progress while the
UOW was being backed out. When the backup
completes, CICS automatically retries the UOW.
COMmitfail
An error occurred at some point when the locks
were in the process of being released. This is an
error that can normally be resolved by recycling
the server (which should happen automatically).
The locks were acquired as a result of recoverable
requests having been issued against the data set.
DATASETFull
No space is available on the direct access device
for adding records to a data set. You need to
reallocate the data set with more space. You can
then retry the backout using SET DSNAME
RETRY.
146 CICS Supplied Transactions