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.
In 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.
- 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)
In 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.