INQUIRE CONNECTION

The INQUIRE CONNECTION command retrieves information about a connection from your local XCICS region to another system. A CONNECTION definition is sometimes known as a "system entry."

Options

CONNECTION(DATA-VALUE)

specifies the 4-character identifier of the remote system or region about which you are inquiring (that is, the name assigned to its CONNECTION definition).

CONNSTATUS(DATA-AREA)

returns a CVDA value identifying the state of the connection between CICS and the remote system. The remote system can be an APPC partner or a CICS MRO partner; CONNSTATUS is not applicable to EXCI or LU6.1 connections. The ACQUIRED and RELEASED CVDA values are common to both APPC and MRO; the others are unique to APPC. CVDA values are:

ACQUIRED: The connection is acquired. The criteria for ACQUIRED for VTAM links are:

OBTAINING: (APPC only) The connection is being acquired. The connection remains in the OBTAINING state until all the criteria for ACQUIRED have been met.

RELEASED: The connection is RELEASED. Although it may also be in INSERVICE status, it is not usable.

NETNAME(data-area)

returns the 8-character name by which the remote system is known to the network (from the NETNAME value specified in the CONNECTION definition).

SERVSTATUS(cvda)

returns a CVDA value indicating whether data can be sent and received on the connection. CVDA values are:

INSERVICE: Data can be sent and received.

OUTSERVICE: Data cannot be sent and received.