CEMT INQUIRE UOWLINK

Retrieve information about connections involved in units of work (UOW).

Description

The INQUIRE UOWLINK command 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 entry name and qualifier of the exit.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:

Type CEMT INQUIRE UOWLINK (or suitable abbreviations for the keywords). The resulting display lists all the current UOW links.
Type CEMT INQUIRE UOWLINK (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i uowl rmi, the resulting display shows details only of UOW links to external resource managers.

(value): An 8-byte token that identifies the UOW link for which data is returned.
ALL: The default.

Sample screen

Figure 1. CEMT INQUIRE UOWLINK screen

 I UOWL
 STATUS:  RESULTS - OVERTYPE TO MODIFY
  Uowl(01840009) Uow(AC142A977E6F3204) Con Lin(IYLX1   )
     Coo Appc War Sys(ISC1)                Net(..GBIBMIYA.IYCWTC13..p...
  Uowl(01C40006) Uow(AC142A977E6F3204) Con Lin(IYLX3   )
     Sub Irc  War Sys(MRO3)                Net(..GBIBMIYA.IYCWTC13..p...

Note: When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. To modify these fields, locate them by tabbing (they appear in the same sequence as in the expanded format), and overtype with an input that is valid for that field. You might find it more convenient to use the expanded format when setting one of these values.

If you place the cursor against a specific entry in the list and press Enter, CICS® displays an expanded format, as shown in Figure 2.

Figure 2. The expanded display of an individual entry

  I UOWL
  RESULT - OVERTYPE TO MODIFY
    Uowlink(01840009)
    Uow(AC142A977E6F3204)
    Type(Connection)
    Link(IYLX1)
    Action(              )
    Role(Coordinator)
    Protocol( )
    Resyncstatus( )
    Sysid( )
    Rmiqfy( )
    Netuowid( )
    Urid( )
    Host( )
    Port(00000)
    Xid( )  
    Branchqual( )

CEMT INQUIRE UOWLINK

Displayed fields

BRANCHQUAL(value)

Returns the 64 character branch qualifier of the XA transaction ID, if present. End of change

HOST(value)

For TYPE value IPCONN, displays a 255-character area into which the TCP/IP host name is returned, or a string containing the dotted decimal TCP/IP address, used to refer to the participant in the OTS transaction. Strings with fewer than 255 characters are padded with blanks. The padding is useful for identifying the participant, especially when problems occur.

For other TYPE values, this value displays blanks.

LINK(value)

The value returned depends on the TYPE returned:

CFTABLE: The 8-character name of the coupling facility data table pool.
CONNECTION: The 8-character netname of the remote system.
IPCONN: The 8-character APPLID of the remote system.
JVMSERVER: The name of the JVMSERVER that initiated the transaction to which this UOWLINK relates.
RMI: The entry name of the task-related user exit.

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.

Nondisplayable characters appear as periods. You can use PF2 on the expanded panel to see the value in hexadecimal.

PORT(value)

For TYPE value IPIC, returns the TCP/IP port number that the partner system was listening on when the connection was acquired. Port is a number in the range 1 to 65535 and will be zero for other TYPE values.

PROTOCOL

Displays the communication protocol used by the connection. The values are as follows:

IRC: Interregion Communication. This connection is an MRO connection.
APPC: Advanced Program to Program Communication.
LU61: LUTYPE 6.1.
IPIC: IPIC connection.
OTS: Object Transaction Services for Java™ programs. A link that contains the global transaction identifier (GTRID) of the XID for JTA.
RRMS: Indicates that the UOW is coordinated by RRS/MVS.

RESYNCSTATUS

Displays the resynchronization status of the connection. The values are as follows:

COLD: A cold start of the connection has been performed by the partner system. The partner can no longer coordinate any in-doubts for this system; nor can this system pass to the partner any decisions remembered for it.
STARTING: The connection is being acquired, but the exchange lognames process has not yet completed.
OK: The connection is operating normally. If the partner system has failed, the partner has been restarted and the connection can resynchronize the associated UOW.
UNAVAILABLE: The connection is not currently acquired.
UNCONNECTED: No associated connection.

RMIQFY(value)

Displays, for a connection type of RMI, the 8-character entry qualifier of the task-related user exit. For a connection type of CONNECTION, IPCONN, or CFTABLE, RMIQFY displays blanks.

ROLE

Displays the role of the connection. The values are as follows:

COORDINATOR: This connection is to the sync point coordinator for the UOW.
SUBORDINATE: This connection is to a sync point subordinate for the UOW.
UNKNOWN: The sync point role of this connection cannot be determined.

SYSID(value)

Displays, for a TYPE value of CONNECTION, the 4-character SYSID of the connection. If the connection has been discarded, or the connection type is RMI, IPCONN, or CFTABLE, or the PROTOCOL field is showing RRMS, SYSID displays blanks.

TYPE

Displays the type of connection. The values are as follows:

CFTABLE: A connection to a CFDT server.
CONNECTION: A connection defined by a CONNECTION resource definition.
IPCONN: A connection defined by an IPCONN resource definition.
JVMSERVER: A connection to a Liberty JVM server.
RMI: A connection to an external resource manager using the resource manager interface (RMI).

UOWLINK(value)

Indicates that this panel relates to an inquiry about a UOW link and displays the 8-character UOW link identifier.

UOW(value)

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

URID(value)

If the PROTOCOL field displays RRMS, this field contains the 32-byte hexadecimal representation of the RRMS unit of recovery identifier. For other values of the PROTOCOL field, including OTS, URID displays blanks.

XID(data-area)

Returns the 64-character global transaction identifier of the XA transaction ID, if present.