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
- 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 entercemt 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
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.
Displayed fields
- BRANCHQUAL(value)
- Returns the 64 character branch qualifier of the XA transaction ID, if present.
- 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.
- 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.