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.


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