INQUIRE UOWLINK

Retrieve information about a connection involved in a unit of work.

Read syntax diagramSkip visual syntax diagramINQUIRE UOWLINK
 
                               .-------------------------.
                               V                         |
>>-INQUIRE UOWLINK(data-area)----+-HOST(data-area)-----+-+-----><
                                 +-LINK(data-area)-----+
                                 +-NETUOWID(data-area)-+
                                 +-PROTOCOL(cvda)------+
                                 +-RESYNCSTATUS(cvda)--+
                                 +-RMIQFY(data-area)---+
                                 +-ROLE(cvda)----------+
                                 +-SYSID(data-area)----+
                                 +-TYPE(cvda)----------+
                                 +-UOW(data-area)------+
                                 '-URID(data-area)-----'
 

Conditions: END, ILLOGIC, NOTAUTH, UOWLNOTFOUND, UOWNOTFOUND

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

The INQUIRE UOWLINK command retrieves information about a connection involved in a unit of work. The connection can be to a remote system, to a task-related user exit, or to a CFDT server.

If it is to a remote system, INQUIRE UOWLINK returns 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 returns the exit’s entry name and qualifier.If it is to a CFDT server, INQUIRE UOWLINK returns the poolname.

Browsing

You can browse through all UOW-links by using the browse options (START, NEXT, and END) on INQUIRE UOWLINK commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

The browse form of the command returns the state of all the UOW-links for connections that are directly connected to the CICS from which the command is issued. It indicates which connections are unavailable, or have been cold started.

The INQUIRE UOWLINK START command positions an internal pointer at the first UOW-link in the CICS recovery manager table. It does not retrieve data for the first one, and it does not allow you to specify a start point.

The first time an INQUIRE UOWLINK NEXT command is used, it returns information about the first UOW-link. Each time the command is used again, it retrieves the ID and STATE of the next UOW-link (if there is one). You can filter the UOW-links returned by specifying a value in the UOW field.

The browse guarantees that data for each UOW-link that exists prior to the first INQUIRE NEXT, and still exists after the last INQUIRE NEXT, is returned on exactly one INQUIRE NEXT call.

Options

HOST(data-area)
retuns, for a TYPE of IIOP, the TCP/IP hostname, or a string containing the dotted decimal TCP/IP address, used to refer to the participant in the OTS transaction. This is useful for identifying the participant, especially when problems occur. This is a 255-character data-area. Strings of fewer than 255 characters are padded with blanks. Note that the UOW and the participant may belong to the same CorbaServer.

For TYPE values other than IIOP, HOST returns blanks.

LINK(data-area)
returns, for a TYPE value of CONNECTION, the 8-character netname of the remote system. For a TYPE value of RMI, LINK returns the entry name of the task-related user exit. For a TYPE value of CFTABLE, LINK returns the 8-character name of the coupling facility data table pool. For a TYPE value of IIOP, LINK returns blanks; the equivalent information for IIOP UOWLINKs is returned by the HOST attribute.
NETUOWID(data-area)
returns the 1-through 27-character network-wide LU6.2 ID of the UOW for which data is returned.
PROTOCOL(cvda)
returns a CVDA value indicating the communication protocol used by the connection. CVDA values are:
APPC
Advanced Program to Program Communication.
IRC
InterRegion Communication. This is an MRO connection.
LU61
LUTYPE 6.1.
IIOP
OTS.
NOTAPPLIC
This is a connection of type CFTABLE or RMI.
RRMS
The UOW is coordinated by RRS/MVS.
RESYNCSTATUS(cvda)
returns a CVDA value indicating the resynchronization status of the connection. CVDA values are:
COLD
The connection has been cold started by the partner system. The partner can no longer coordinate any in-doubt conditions for this system; nor can this system pass to the partner any decisions remembered for it.
NOTAPPLIC
The connection was not created using recovery protocols. It could be an RMI, an APPC single-session, an APPC synclevel 1 connection, or a CFDT server.
OK
The connection is operating normally. If there has been a failure of the partner system, the partner has been restarted and the connection is able to resynchronize the associated UOW.
STARTING
The connection is being acquired, but the exchange lognames process has not yet completed.
UNAVAILABLE
The connection is not currently acquired.
UNCONNECTED
There is no associated connection.
RMIQFY(data-area)
returns, for a TYPE value of RMI, the 8-character entry qualifier of the task-related user exit. For a TYPE of CONNECTION, CFTABLE or IIOP, RMIQFY returns blanks.
ROLE(cvda)
returns a CVDA value indicating the role of the connection. CVDA values are:
COORDINATOR
This connection is to the syncpoint coordinator for the UOW.
SUBORDINATE
This connection is to a syncpoint subordinate for the UOW.
UNKNOWN
The syncpoint role of this connection cannot be determined.
SYSID(data area)
returns, for a TYPE value of CONNECTION, the 4-character sysid of the connection. If the connection has been discarded, or the type is RMS, CFTABLE or IIOP, or the PROTOCOL option returns RRMS, SYSID returns blanks.
TYPE(cvda)
returns a CVDA value indicating the type of connection. CVDA values are:
CFTABLE
A connection to a CFDT server.
CONNECTION
A connection defined in a CONNECTION resource definition.
OTS
An OTS link.
RMI
A connection to an external resource manager using the resource manager interface (RMI).
UOW(data-area)
returns the 16-byte local identifier of the UOW for which link data is being returned. The last eight bytes are always null   (X'00').
UOWLINK(data-area)
specifies a 4-byte token identifying the UOW-link for which data is to be returned.
URID(data-area)
If the PROTOCOL field returns RRMS, this option returns the 32 byte hexadecimal representation of the RRMS unit of recovery identifier. For other values of PROTOCOL (including OTS), URID returns blanks.

Conditions

END
RESP2 values:
2
All authorized resource definitions have been retrieved.
ILLOGIC
RESP2 values:
1
For INQUIRE UOWLINK START, means that a browse of this resource type is already in progress. For INQUIRE UOWLINK NEXT and INQUIRE UOWLINK END, means that an INQUIRE UOWLINK START command has not been issued.
NOTAUTH
RESP2 values:
100
The use of this command is not authorized.
UOWLNOTFOUND
RESP2 values:
1
The named UOW-link cannot be found.
UOWNOTFOUND
RESP2 values:
1
The named UOW cannot be found.
[[ Contents Previous Page | Next Page Index ]]