CEMT INQUIRE UOWDSNFAIL
distributed UOW. Values of WAITFORGET or
WAITRMI, and BACKOUT or COMMIT indicate
how the UOW was resolved on this system.
SHunted
Syncpoint processing of the UOW has been
deferred. SHUNTED further indicates that the task,
terminal and program storage have been released,
and locks have been retained.
CEMT INQUIRE UOWDSNFAIL
Function: Obtain information about failed units of work
that have updated CICS file-control-managed data sets.
Description: INQUIRE UOWDSNFAIL returns information
about UOW failures that are associated with specific data
sets. If you enter the basic command (CEMT INQUIRE
UOWDSNFAIL) without any attributes to act as a filter, CICS
displays all failed UOWs for all data sets.
Because this command returns information about UOW
failures, if a UOW that had suffered a failure is in the process
of being retried when the command is issued, the UOW will
not be displayed by INQUIRE UOWDSNFAIL (it is not
currently shunted or failed). If the retry is successful, the
UOW no longer has a failure with respect to that particular
data set. If the retry is not successful, the UOW will be
shunted again, and INQUIRE UOWDSNFAIL will display it as
failed with respect to the data set.
Alternatively, if you are interested only in those failed UOWs
for specific data sets, you can use the DSNAME parameter
as a filter by specifying either a specific or generic data set
name. You can also use other attributes as filters, such as
CONNECTION for UOWs that failed indoubt, or DATASET
for UOWs that failed during backout for some reason. See
the list of reasons for UOW failures, and the associated
causes, which you can use for filtering the results of
INQUIRE UOWDSNFAIL commands.
Input: Press the Clear key to clear the screen and enter
the basic command as CEMT INQUIRE UOWDSNFAIL. (The
minimum abbreviation is CEMT I UOWD.) You get a display of
all the failed UOWs, if any. Otherwise, CICS returns the NOT
FOUND error condition
Alternatively, enter the command with one or more valid
attributes to filter the results of the inquiry. For example, if
you enter cemt i uowd ds(applb.ᑍ), the resulting display will
show you the details of only those failed UOWs that are
associated with data sets with a high-level qualifier of
APPLB.
Chapter 11. Master terminal CEMT 145