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

Page 168

Advertising
background image

CEMT INQUIRE UOWENQ


RLen(

value)

displays the length of the data, in the range 0 through
255, displayed in the RESOURCE field.

RESource(

value)

displays a 1- through 255-character string containing the
name of the resource associated with the enqueue lock.
The data displayed depends on the type of enqueue, as
shown in Table 3.

Note: Nondisplayable characters appear as periods.

You can use PF2 on the expanded panel: to see
the value in hexadecimal.

State

displays the state that the enqueue is held in. The
values are:

ACtive

The enqueue is held in active state.

RETained

The enqueue is held in retained state. Its owning
UOW has been shunted, or is in the process of
being shunted.

TAskid(

value)

displays the number of the task associated with the
UOW. If the UOW is shunted, it is the task number
associated with the UOW before it was shunted.

TRansid(

value)

displays the 4-character identifier of the transaction
associated with the UOW. If the UOW is shunted, it is
the identifier of the transaction associated with the UOW
before it was shunted.

Type

displays the type of resource being enqueued upon. The
values are:

Dataset

The resource is a record in a VSAM data set (or a
CICS-maintained data table). RESOURCE
contains the name of the data set and QUALIFIER
contains the record identifier.

File

The resource is a record in either a BDAM file or a
user-maintained data table. RESOURCE contains
the name of the file and QUALIFIER contains the
record identifier.

When the file is a BDAM file then the record
identifier is prefixed by the BDAM block identifier.

Note that truncation occurs if this combination
exceeds 255 characters.

EXecenq

The resource is associated with an EXEC CICS
ENQ request. RESOURCE contains the enqueue
argument passed on the request.

ADdrexecenq

The resource is associated with an EXEC CICS
ENQ request. RESOURCE contains the address
enqueue argument passed on the request (that is,
the LENGTH parameter was omitted on the
request)

TDq The resource is a logically-recoverable transient

data queue. RESOURCE contains the name of the
queue. QUALIFIER contains either the string
“FROMQ” or “TOQ,” indicating whether a read or
write lock is held for the queue.

A READQ TD request acquires the “FROMQ” lock,
whereas a WRITEQ TD request acquires the
“TOQ” lock associated with the queue. A
DELETEQ TD request acquires both the “TOQ”
and the “FROMQ” locks.

TSq

The resource is a recoverable temporary storage
queue. RESOURCE contains the name of the
queue.

The data displayed in the RESOURCE and QUALIFIER
fields depends on the resource type, as shown in
Table 3.

Uow(

value)

displays the 16-character local identifier of the
associated unit of work.

Table 3. Data displayed in RESOURCE and QUALIFIER

Type

Resource

Qualifier

DATASET

Dataset name

Record identifier

EXECENQ

EXEC enqueue
argument

None

ADDREXECENQ

Address of EXEC
enqueue
argument

None

FILE

File name

Record identifier

TDQ

TD queue name

FROMQ or TOQ

TSQ

TS queue name

None

150

CICS Supplied Transactions

Advertising