Retrieves information about a system connection.

Sintaxe:

For more information about the use of CICS-value data areas (CVDAs), see Appendix F, CVDAs recognized by the translator.

Descrição:

The INQUIRE CONNECTION command retrieves information from the runtime Communications Definitions (CD) about a named connection to a remote system.
The remote system need not be a CICS system.

Comentários:

You can also browse through all the CONNECTION definitions that are installed in your system.
Use the browse options (START, NEXT and END) on INQUIRE CONNECTION commands.

Opções:

ACCESSMETHOD(cvda)
• Returns a CVDA value that indicates the type of connection between the local system and the one about which you are inquiring.
• The CVDA values are:
  • PPC
    • The connection is used for intersystem communication (ISC) that is using peer-to-peer communication (PPC).
  • PPCGW
    • The connection is used for ISC or an CICS on Open Systems client that is using the PPC gateway.
  • RPC
    • The connection is used for an CICS on Open Systems client that is using RPC.
  • SNA
    • The connection is used for ISC or an IBM CICS Universal Client that is using SNA.
  • TCPIP
    • The connection is used for ISC or an CICS on Open Systems client that is using Transmission Control Protocol/Internet Protocol (TCP/IP).

ACQSTATUS(cvda)
• Returns the same value as does the CONNSTATUS option and is retained only for compatibility purposes.
• You should use CONNSTATUS in new applications.

AUTOCONNECT(cvda)
• Returns a CVDA value that identifies whether sessions are automatically connected.
• The CVDA values are:
  • ALLCONN
    • All sessions are connected automatically at system initialization.
  • AUTOCONN
    • Sessions are connected automatically as required.
  • NONAUTOCONN
    • Sessions are not connected automatically.
• TXSeries for Multiplatforms always returns the AUTOCONN value.

CONNECTION(data-value)
• Specifies the four-character identifier of the remote system or region about which you are inquiring.

CONNSTATUS(cvda)
• Returns a CVDA value that identifies the state of the connection between CICS and the remote system.
• The CVDA values are:
  • ACQUIRED
    • The connection is acquired.
  • FREEING
    • The connection is being released.
  • OBTAINING
    • The connection is being acquired.
    • The connection remains in the OBTAINING state until the connection is ACQUIRED.
  • RELEASED
    • The connection is RELEASED. Although it might also be in INSERVICE status, it is not usable.
    • The RELEASED status can be caused by any one of several general conditions:
      • The remote system has not yet initialized.
      • No CONNECTION definition exists on the remote system.
      • The connection on the remote system has been set out of service.
      • The SNA product definitions are incorrect.
      • The SNA product is not active.
  • NOTAPPLIC
    • The connection is not an APPC or TCP/IP connection.

CONNTYPE(cvda)
• Returns a CVDA value that identifies the type of external CICS interface (EXCI) sessions, or pipes, that is defined for this connection.
• The CVDA values are:
  • GENERIC
    • The connection is generic.
  • SPECIFIC
    • The connection is specific.
  • NOTAPPLIC
    • The connection is not an EXCI connection.
• This option is included for compatibility.
• TXSeries for Multiplatforms always returns the NOTAPPLIC value.

EXITTRACING(cvda)
• Returns a CVDA value that indicates whether the terminal exit program is tracing the sessions that are associated with this connection.
• The CVDA values are:
  • EXITTRACE
    • Tracing is on.
  • NOEXITTRACE
    • Tracing is off.
  • NOTAPPLIC
    • The connection is not APPC.
• TXSeries for Multiplatforms always returns the NOEXITTRACE value for local SNA and PPC gateway connections; the value NOTAPPLIC returns for all other connections.

NETNAME(data-area)
• Returns an eight-character string that represents the name by which the remote system is known to the network.
• This value is configured in the RemoteLUName attribute of the CD entry for the connection.

PENDSTATUS(cvda)
• Returns a CVDA value that identifies whether any units of work for synclevel 2 connections are pending.
• The CVDA values are:
  • NOTPENDING
    • No units of work are pending.
  • PENDING
    • The local system has units of work that require resynchronization with the remote system.
  • NOTAPPLIC
    • This is not an APPC connection.
• TXSeries for Multiplatforms always returns either the NOTPENDING or NOTAPPLIC value.

PROTOCOL(cvda)
• Returns a CVDA value that identifies the protocol that is in use.
• The CVDA values are:
  • APPC
    • The connection uses the LUTYPE6.2 protocol for intersystem communication.
  • NOTAPPLIC
    • The connection does not use the LUTYPE6.2 protocol.

RECEIVECOUNT(data-area)
• Returns a 32-bit binary value that gives the number of RECEIVE sessions for this connection.
• This option applies only to local CICS on Open Systems client connections; for others, a null value is returned.
• Because the actual null value that is returned depends on the format of the user-defined data area, see Null values for a full description of the different types of null values.

SENDCOUNT(data-area)
• Returns a 32-bit binary value that gives the number of SEND sessions for this connection.
• This option applies only to local CICS on Open Systems client connections, for which the value is a zero; for others, a null value is returned.
• Because the actual null value that is returned depends on the format of the user-defined data area, see Null values for a full description of the different types of null values.

SERVSTATUS(cvda)
• Returns a CVDA value that indicates whether the remote system is available for use.
• The CVDA values are:
  • GOINGOUT
    • OUTSERVICE has been requested on a SET CONNECTION command, and the request cannot be acted on until some current work has completed.
  • INSERVICE
    • Data can be sent and received.
  • OUTSERVICE
    • Data cannot be sent and received.
• When a region is started, the initial value of SERVSTATUS is determined by the InService attribute of the CD entry.
• It can be changed by the SET CONNECTION command.

XLNSTATUS(cvda)
• Returns a CVDA value that identifies the status of the exchange log names (XLN) process.
• The CVDA values are:
  • NOTAPPLIC
    • The XLN process is not applicable. This can be because the link:
      • Is released
      • Is not an APPC link
      • Does not support synchronization level 2 conversations
  • XNOTDONE
    • The XLN flow for the APPC connection has not completed successfully.
  • XOK
    • The XLN process for the APPC connection has completed successfully.
• TXSeries for Multiplatforms always returns the NOTAPPLIC value.

ZCPTRACING(cvda)
• Returns a CVDA value that indicates whether tracing is active on the sessions that are associated with this connection.
• The CVDA values are:
  • NOTAPPLIC
    • The connection is not APPC.
  • NOZCPTRACE
    • ZCP tracing is not active.
  • ZCPTRACE
    • ZCP tracing is active.
• TXSeries for Multiplatforms always returns the NOZCPTRACE value for local SNA and PPC Gateway connections; the value NOTAPPLIC returns for all other connections.

Condições:

END
• RESP2 values:
  • No more resource definitions of this type (RESP2=2) exist.

ILLOGIC
• RESP2 values:
  • You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress (RESP2=1).

SYSIDERR
• RESP2 values:
  • The connection cannot be found in the CD (RESP2=1).
• Ação pré-definida: Terminates the task abnormally.