Cemt inquire uowdsnfail – IBM CICS Transaction Server for OS/390 SC33-1686-02 User Manual

Page 163

Advertising
background image

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

Advertising