ISIC gate, INQUIRE_IPCONN_BY_APPLID function
Get information about an IPCONN with the given APPLID.
Input Parameters
- APPLID
- 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.
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
- AUTOCONNECT
- Optional Parameter
- Values for the parameter are:
- AUTOCONNECT_NO
- AUTOCONNECT_YES
- 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).
- IPCONN
- The name of the IPCONN definition; that is, the name by which CICS knows the remote system.
- 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
- TCPIPSERVICE
- Optional Parameter
- The name of the PROTOCOL(IPIC) TCPIPSERVICE definition that defines the attributes of the inbound processing for this connection.