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

Page 169

Advertising
background image

CEMT INQUIRE UOWLINK

CEMT INQUIRE UOWLINK

Function:

Retrieve information about connections involved

in units of work.

Description:

INQUIRE UOWLINK returns information

about a connection involved in a unit of work. The connection
can be to a remote system, or to a task-related user exit. If it
is to a remote system, INQUIRE UOWLINK displays the
netname of the connection, its sysid, and whether it is the
coordinator or subordinate. If it is to a task-related user exit,
INQUIRE UOWLINK displays the exit’s entry name and
qualifier.

Input:

Press the Clear key to clear the screen. There are

two ways of commencing this transaction:

Type

CEMT INQUIRE UOWLINK

(the minimum abbreviation

is

CEMT I UOWL

). You get a display that lists all the

current UOW-links.

Type

CEMT INQUIRE UOWLINK

(

CEMT I UOWL

) followed by

as many of the other attributes as are necessary to limit
the range of information that you require. So, for
example, if you enter

cemt i uowl rmi

, the resulting

display will show you details only of UOW-links to
external resource managers.

─ALl─────

─CEMT Inquire UOWLink

─┼

─────────

─────────

─(value)

─┬

────────────

─┬

────────────

─────────────

─UOw(value)

─CONnection─

─RMI────────

─┬

─────────────

─┬

─────────────

───────────

─LInk(value)

─COOrdinator─

─SUbordinate─

─UNKnown─────

─┬

───────────

─┬

─────────────

─────────────

─Irc───────

─COLdstart───

─APpc──────

─STarting────

─LU61──────

─Warmstart───

─NOtapplic─

─UNAvailable─

|

─Rrms──────

─UNConnected─

─NOtapplic───

─┬

──────────────

─┬

───────────────

────────

─SYsid(value)

─RMIQfy(value)

─┬

─────────────────

─NEtuowid(value)

(

value)

is an 8-byte token identifying the UOW-link for which
data is to be returned.

ALl

is the default.

Sample screen

I UOWL
STATUS:

RESULTS - OVERTYPE TO MODIFY

Uowl( 184

9) Uow(AC142A977E6F32 4) Con Lin(IYLX1

)

Coo Appc War Sys(ISC1)

Net(..GBIBMIYA.IYCWTC13..p...

Uowl( 1C4

6) Uow(AC142A977E6F32 4) Con Lin(IYLX3

)

Sub Irc

War Sys(MRO3)

Net(..GBIBMIYA.IYCWTC13..p...

Figure 135. CEMT INQUIRE UOWLINK 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 136.

I UOWL

RESULT - OVERTYPE TO MODIFY

Uowlink( 184

9)

Uow(AC142A977E6F32 4)

Type(Connection)

Link(IYLX1)

Action(

)

Role(Coordinator)

Protocol( )

Resyncstatus( )

Sysid( )

Rmiqfy( )

Netuowid( )

|

Urid

Figure 136. The expanded display of an individual entry

Displayed fields

LInk(

value)

displays, for a TYPE value of CONNECTION, the
8-character netname of the remote system. For a TYPE
value of RMI, LINK displays the entry name of the
task-related user exit. For a TYPE value of CFTABLE,
LINK displays the 8–character name of the coupling
facility data table pool.

NEtuowid(

value)

displays a 27-character string containing the
network-wide LU6.2 name for the UOW.

Note: Nondisplayable characters appear as periods.

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

Protocol

displays the communication protocol used by the
connection. The values are:

Irc

Inter-Region Communication. This is an MRO
connection.

Chapter 11. Master terminal CEMT

151

Advertising