INQUIRE commands

The CEMT and EXEC CICS® interfaces provide a set of inquiry commands that you can use to investigate the execution of distributed units of work, and diagnose problems.

In the following list of commands, INQUIRE CONNECTION applies to MRO and ISC over SNA (APPC) connections. INQUIRE IPCONN applies to IPIC connections.

CICS Explorer graphicIn CICS Explorer®, the ISC/MRO Connections view and IPIC Connections view provide functional equivalents to the INQUIRE CONNECTION and INQUIRE IPCONN commands. See ISC/MRO Connections view in the CICS Explorer product documentation and IPIC Connections view in the CICS Explorer product documentation.

In summary, the commands are:
INQUIRE {CONNECTION | IPCONN} RECOVSTATUS
Use this command to find out whether any resynchronization work is outstanding between the local system and the connected system. The returned CVDA values are:
NORECOVDATA
Neither side has recovery information outstanding.
NOTAPPLIC
This is not an IPIC, APPC parallel-session, nor a CICS-to-CICS MRO connection, and does not support two-phase commit protocols.
NRS
CICS does not have recovery outstanding for the connection, but the partner may have.
RECOVDATA
There are indoubt units of work associated with the connection, or there are outstanding resyncs awaiting FORGET on the connection. Resynchronization takes place when the connection next becomes active, or when the UOW is unshunted.
INQUIRE {CONNECTION | IPCONN} PENDSTATUS
Use this command to discover whether there are any UOWs for which resynchronization is impossible because of an initial start by the connected system.
INQUIRE CONNECTION XLNSTATUS (APPC parallel-sessions only)
CICS Explorer graphicIn CICS Explorer, the ISC/MRO Connections view provides a functional equivalent to this command. See ISC/MRO Connections view in the CICS Explorer product documentation
Use it to discover whether the link is currently able to support syncpoint (synclevel 2) work. See The exchange lognames process for more information.
Note: XLNSTATUS is not applicable to IPCONNs.
INQUIRE UOW
Use this command to discover why a unit of work is waiting or shunted. If the reason is a connection failure (the WAITCAUSE option returns a CVDA value of CONNECTION), the SYSID and LINK options return the sysid and netname of the remote system that caused the UOW to wait or be shunted.

Note that INQUIRE UOW returns information about a local UOW: that is, for a distributed UOW it returns information only about the work required on the local system. You can assemble information about a distributed UOW by matching the network-wide identifier returned in the NETUOWID field against the identifiers of local UOWs on other systems. For an example of how to do this, see Resolving a resynchronization failure.

INQUIRE UOWLINK
This command allows you to inquire about the resynchronization needs of individual UOWs. Use it to discover information about connections involved in a distributed UOW.
For a local UOW, INQUIRE UOWLINK returns a list of tokens (UOW-links) representing connections to the systems that are involved in the distributed UOW. For each UOW-link, INQUIRE UOWLINK returns:
  • The CONNECTION name
  • The resynchronization status of the connection
  • Whether the connection is to a coordinator or a subordinate system.

For examples of the use of these commands to diagnose problems with distributed units of work, see Problem determination examples.



dfht1c00239.html | Timestamp icon Last updated: Monday, 5 June 2017