ISIC gate, INQUIRE_IPCONN function

Get information about an IPCONN.

Input Parameters

IPCONN
The name of the IPCONN definition; that is, the name by which CICS knows the remote system.
CERTIFICATE
Optional Parameter

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • NOT_FOUND
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces
Values for the parameter are:
  • OK
  • EXCEPTION
  • DISASTER
  • INVALID
  • KERNERROR
  • PURGED
APPLID
Optional Parameter
The application identifier (applid) of the remote system. (If the remote system is a CICS region, its applid is specified on the APPLID parameter of its system initialization table.)
AUTOCONNECT
Optional Parameter
Values for the parameter are:
  • AUTOCONNECT_NO
  • AUTOCONNECT_YES
CIPHER_COUNT
Optional Parameter
The number of cipher suites that are available to negotiate with clients during the SSL handshake.
CIPHER_SUITES
Optional Parameter
The list of cipher suites that is used to negotiate with clients during the SSL handshake.
CONNSTATUS
Optional Parameter
The current status of the connection.
Values for the parameter are:
  • ACQUIRED
  • FREEING
  • OBTAINING
  • RELEASED
HOST
Optional Parameter
The host name of the remote system (for example, abc.example.com), or its dotted decimal IP address (for example, 9.20.181.3).
MAXQTIME
Optional Parameter
The maximum time, in seconds, for which allocate requests may be queued on this connection.
NETWORKID
Optional Parameter
The network ID of the remote system.
PENDSTATUS
Optional Parameter
Indicates whether there are any pending units of work for this connection.
Values for the parameter are:
  • NOTPENDING
  • PENDING
PORTNUMBER
Optional Parameter
The port number used for outbound requests on this connection; that is, the number of the port on which the remote system is listening.
QUEUELIMIT
Optional Parameter
The maximum number of allocate requests that can be queued for this connection.
RECEIVECOUNT
Optional Parameter
The number of receive sessions defined for this connection.
RECOVSTATUS
Optional Parameter
Recovery status of the remote connection.
Values for the parameter are:
  • NORECOVDATA
  • NRS
  • RECOVDATA
SECURITYNAME
Optional Parameter
Link userid used for this connection.
SENDCOUNT
Optional Parameter
The number of send sessions defined for this connection.
SERVSTATUS
Optional Parameter
Service status.
Values for the parameter are:
  • INSERV
  • OUTSERV
SSLTYPE
Optional Parameter
Indicates whether the Secure Sockets Layer (SSL) is being used to secure communications for this transaction.
Values for the parameter are:
  • SSL_NO
  • SSL_YES
TCPIPSERVICE
Optional Parameter
The name of the PROTOCOL(IPIC) TCPIPSERVICE definition that defines the attributes of the inbound processing for this connection.
USERAUTH
Optional Parameter
The level of attach-time user security used for the connection.
Values for the parameter are:
  • CERTIFICAUTH
  • IDENTIFY
  • LOCAL
  • USERAUTH_NO
  • VERIFY


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