IPCONN report

The IPCONN report shows information and statistics about IPCONN resource definitions, which define IP interconnectivity (IPIC) connections.

The IPCONN report is produced using a combination of the EXEC CICS INQUIRE IPCONN and EXEC CICS EXTRACT STATISTICS IPCONN commands. The statistics data is mapped by the DFHISRDS DSECT.

Table 1. Fields in the IPCONN report
Field Heading Description
IPCONN Name The name of the IPCONN definition; that is, the name by which CICS knows the remote system.

Source field: ISR-IPCONN-NAME
IPCONN 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.

Source field: ISR-APPLID
IPCONN Status The state of the connection between CICS and the remote system; for example, Acquired, Freeing, Obtaining, or Released.

Source field: EXEC CICS INQUIRE IPCONN() CONNSTATUS()
IPCONN Port Number The port number used for outbound requests on this IP connection; that is, the number of the port on which the remote system is listening.

Source field: EXEC CICS INQUIRE IPCONN() PORT()
IPCONN Host The host name of the remote system or its IPv4 or IPv6 address.

Source field: EXEC CICS INQUIRE IPCONN() HOST()
IPCONN IP Resolved Address The IPv4 or IPv6 resolved address of the host.

Source field: EXEC CICS INQUIRE IPCONN() IPRESOLVED()
IPCONN IP Family The address format of the address returned in IPCONN IP Resolved Address.

Source field: EXEC CICS INQUIRE IPCONN() IPFAMILY()
SSL Authentication Whether secure socket layer (SSL) authentication is supported:
  • Yes
  • No

Source field: ISR-SSL-SUPPORT.
Link Security The type of link authentication used:
  • Certificate
  • Securityname

Source field: ISR-LINKAUTH
Receive Session Count The number of receive sessions defined for this connection.

Source field: ISR-RECEIVE-SESSIONS
Current Receive Session Count The current number of receive sessions on this connection.

Source field: ISR-CURRENT-RECEIVE-SESSIONS
Peak Receive Session Count The peak number of receive sessions in use on this connection.

Source field: ISR-PEAK-RECEIVE-SESSIONS
Total Allocates The total number of allocate requests for this connection.

Source field: ISR-TOTAL-ALLOCATES
Current Allocates Queued The current number of allocate requests queued for this connection.

Source field: ISR-CURRENT-QUEUED-ALLOCATES
Peak Allocates Queued The peak number of allocate requests queued for this connection.

Source field: ISR-PEAK-QUEUED-ALLOCATES
Allocates Failed - Link The number of allocate requests that failed because the connection is released or out-of-service.

Source field: ISR-ALLOCATES-FAILED-LINK
Allocates Failed - Other The number of allocate requests that failed because a session is not currently available for use.

Source field: ISR-ALLOCATES-FAILED-OTHER
Number of Transactions Attached The total number of transactions that have been attached on this connection.

Source field: ISR-TRANS-ATTACHED
Remote Terminal Starts The total number of START requests sent from a remote terminal.

Source field: ISR_REMOTE_TERM_STARTS
Transaction Routing
  • Requests
 The number of transaction routing requests sent across the connection.

Source field: ISR-TR-REQUESTS
Transaction Routing
  • Total Bytes Sent
 The number of bytes sent by transaction routing requests.

Source field: ISR-TR-BYTES-SENT
Transaction Routing
  • Total Bytes Received
 The number of bytes received on transaction routing requests.

Source field: ISR-TR-BYTES-RECEIVED
Function Shipping
  • Program requests
 The number of program control requests function shipped across the connection.

Source field: ISR-FS-PG-REQUESTS
Function Shipping
  • Interval Control requests
 The number of interval control requests function shipped across the connection.

Source field: ISR-FS-IC-REQUESTS
Function Shipping
  • Total requests
 The total number of function shipping requests shipped across the connection.

Source field: ISR-FS-PG-REQUESTS + ISR-FS-IC-REQUESTS + ISR-FS-FC-REQUESTS + ISR-FS-TD-REQUESTS + ISR-FS-TS-REQUESTS
Program Requests
  • Total Bytes Sent
 The number of bytes sent on program control requests.

Source field: ISR-FS-PG-BYTES-SENT
Program Requests
  • Total Bytes Received
 The number of bytes received on program control requests.

Source field: ISR-FS-PG-BYTES-RECEIVED
Interval Control Requests
  • Total Bytes Sent
 The number of bytes sent on interval control requests.

Source field: ISR-FS-IC-BYTES-SENT
Interval Control Requests
  • Total Bytes Received
 The number of bytes received on interval control requests.

Source field: ISR-FS-IC-BYTES-RECEIVED
IPCONN Network ID The network ID of the remote system.

Source field: ISR-NETWORK-ID
IPCONN Service Status Whether data can be passed on the connection:
  • Inservice
  • Outservice

Source field: EXEC CICS INQUIRE IPCONN() SERVSTATUS()
TCPIPSERVICE Name The name of the PROTOCOL(IPIC) TCPIPSERVICE definition that defines the attributes of the inbound processing for this connection.

Source field: ISR-TCPIP-SERVICE
User Authentication The type of user authentication used:
  • Defaultuser
  • Identify
  • Local
  • Verify

Source field: ISR-USERAUTH
Mirror Lifetime The minimum lifetime of the mirror task for function shipped requests received by this region. The following options are included:
  • REQUEST
  • TASK
  • UOW

Source field: EXEC CICS INQUIRE IPCONN() MIRRORLIFE()
Send Session Count The number of send sessions defined for this connection.

Source field: ISR-SEND-SESSIONS
Current Send Session Count The current number of send sessions on this connection.

Source field: ISR-CURRENT-SEND-SESSIONS
Peak Send Session Count The peak number of send sessions in use on this connection.

Source field: ISR-PEAK-SEND-SESSIONS
Allocates per second The number of allocate requests issued per second for this connection.

Source field: ISR-TOTAL-ALLOCATES / Elapsed seconds since reset
Allocate Queue Limit The maximum number of allocate requests that can be queued for this connection.

Source field: ISR-ALLOCATE-QUEUE-LIMIT
Allocates Rejected - Queue Limit The number of allocate requests that were rejected because the QUEUELIMIT value is reached.

Source field: ISR-QLIMIT-ALLOC-REJECTS
Max Queue Time (seconds) The maximum time, in seconds, for which allocate requests can be queued on this connection.

Source field: ISR-MAX-QUEUE-TIME
Max Queue Time - Allocate Queue Purge The number of times that the allocate request queue has been purged because the MAXQTIME value is reached.

Source field: ISR-MAXQTIME-ALLOC-QPURGES
Max Queue Time - Allocates Purged The total number of allocate requests purged because the queueing time exceeds the MAXQTIME value.

Source field: ISR-MAXQTIME-ALLOCS-PURGED
XISQUE - Allocates Rejected The number of allocate requests that were rejected by an XISQUE global user exit program.

Source field: ISR-XISQUE-ALLOC-REJECTS
XISQUE - Allocate Queue Purge The number of times that the allocate request queue has been purged by an XISQUE global user exit program.

Source field: ISR-XISQUE-ALLOC-QPURGES
XISQUE - Allocates Purged The total number of allocate requests purged because an XISQUE global user exit program requests that the queued allocate requests are purged.

Source field: ISR-XISQUE-ALLOC-PURGED
Transaction Routing
  • Average Bytes Sent
 The average number of bytes sent by transaction routing requests.

Source field: ISR-TR-BYTES-SENT / ISR-TR-REQUESTS
Program Requests
  • Average Bytes Sent
 The average number of bytes sent on program control requests.

Source field: ISR-FS-PG-BYTES-SENT / ISR-FS-PG-REQUESTS
Interval Control Requests
  • Average Bytes Sent
 The average number of bytes sent on interval control requests.

Source field: ISR-FS-IC-BYTES-SENT / ISR-FS-IC-REQUESTS
Function Shipping
  • File Control requests
 The number of file control requests for function shipping on this connection.

Source field: ISR_FS_FC_REQUESTS
File Control Requests
  • Total bytes sent
 The number of bytes sent by file control requests.

Source field: ISR_FS_FC_BYTES_SENT
File Control Requests
  • Total Bytes Rcvd
 The number of bytes received by file control requests.

Source field: ISR_FS_FC_BYTES_RECEIVED
Function Shipping
  • Temporary Storage Requests
 The number of temporary storage requests for function shipping on this connection.

Source field: ISR_FS_TS_REQUESTS
Temporary Storage Requests
  • Total Bytes Sent
 The number of bytes sent by temporary storage requests.

Source field: ISR_FS_TS_BYTES_SENT
Temporary Storage Requests
  • Total Bytes Rcvd
 The number of bytes received by temporary storage requests.

Source field: ISR_FS_TS_BYTES_RECEIVED

Function Shipping
  • Transient Data Requests
 The number of transient data requests for function shipping on this connection.

Source field: ISR_FS_TD_REQUESTS
Transient Data Requests
  • Total Bytes Sent
 The number of bytes sent by transient data requests.

Source field: ISR_FS_TD_BYTES_SENT
Transient Data Requests
  • Total Bytes Rcvd
 The number of bytes received by transient data requests.

Source field: ISR_FS_TD_BYTES_RECEIVED

Unsupported Requests The number of attempts to route requests for unsupported function across this connection.

Source field: ISR_UNSUPPORTED_REQUESTS