Retrieve information about a connection involved in a unit of work.
INQUIRE 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).
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.
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.
For TYPE values other than IIOP, HOST returns blanks.