IPCONN: Resource statistics

You can retrieve IPCONN statistics by using the EXEC CICS EXTRACT STATISTICS system command. They are mapped by the DFHISRDS DSECT.

IPCONN statistics

You can use IPCONN statistics to detect problems with IP interconnectivity (IPIC) connections.

IPIC is described in Communication between systems.

Use the DFHISRDS DSECT to process the following information:

Data returned for an online enquiry for a connection (EXEC CICS® EXTRACT STATISTICS)
Connection statistics offline (SMF)
Connection totals (the summation of all defined connections in this CICS region).

Table 1. IPCONN: resource statistics
DFHSTUP name	Field name	Description
IPCONN Name	ISR_IPCONN_NAME	The name of an IPIC connection defined by an IPCONN definition in the CSD or by autoinstall. Reset characteristic: not reset
Autoinstalled IPCONN Create Date / Time	ISR_IPCONN_CREATE_TIME	The date and time when the IPCONN was autoinstalled. The time shown is local time. If the IPCONN was not autoinstalled, this field is not shown.
Autoinstalled IPCONN Delete Date / Time	ISR_IPCONN_DELETE_TIME	The date and time when the autoinstalled IPCONN was deleted. The time shown is local time. If the IPCONN was not autoinstalled, this field is not shown.
IPCONN Applid	ISR_APPLID	The APPLID of the remote system, as specified in its system initialization table. Reset characteristic: not reset
IPCONN Network ID	ISR_NETWORK_ID	The network ID (that is, the z/OS® Communications Server NETID or, for non-z/OS Communications Server systems, the value of the UOWNETQL system initialization parameter) of the remote system. This ID is used, in combination with the APPLID, to ensure unique naming for connecting systems. The name can be up to 8 characters in length and follows assembler language rules. It must start with an alphabetic character. This attribute is optional. If not specified, the z/OS Communications Server NETID (or, for non-z/OS Communications Server systems, the value of the UOWNETQL system initialization parameter) of the CICS on which the definition is installed is used. Reset characteristic: not reset
TCPIPSERVICE Name	ISR_TCPIP_SERVICE	The name of the PROTOCOL(IPIC) TCPIPSERVICE definition that defines the attributes of the inbound processing for this connection.
IPCONN Port Number	ISR_PORT_NUMBER	The decimal number of the port that is combined with the HOST value to specify the destination for outbound requests on this connection. Reset characteristic: not reset
IPCONN Host	ISR_HOST_NAME	The host name of the target system for this connection. Reset characteristic: not reset
IPCONN IP Family	ISR_IPCONN_IP_FAMILY	The address format of the IP Resolved Address. Reset characteristic: not reset
IPCONN IP Resolved Address	ISR_IPCONN_IP_ADDRESS	The IPv4 or IPv6 address of the host. Reset characteristic: not reset
Receive Sessions	ISR_RECEIVE_SESSIONS	The defined number of receive sessions. The actual number of receive sessions that are used depends also on the number of send sessions defined in the remote system. When the connection is established, these values are exchanged and the lower value is used. Reset characteristic: not reset
Current Receive Sessions	ISR_CURRENT_RECEIVE_SESSIONS	The current number of receive sessions in use for this connection. Reset characteristic: reset to current value
Peak Receive Sessions	ISR_PEAK_RECEIVE_SESSIONS	The peak number of receive sessions in use for this connection. Reset characteristic: reset to current value
Total Allocates	ISR_TOTAL_ALLOCATES	The total number of allocate requests for this connection. Reset characteristic: reset to zero
Current Allocates Queued	ISR_CURRENT_QUEUED_ALLOCATES	The current number of allocate requests that have been queued for this connection. Reset characteristic: reset to current value
Peak Allocates Queued	ISR_PEAK_QUEUED_ALLOCATES	The peak number of allocate requests that have been queued for this connection. Reset characteristic: reset to current value
Allocates Failed - Link	ISR_ALLOCATES_FAILED_LINK	The number of allocate requests that failed because the connection is released or out-of-service. Reset characteristic: reset to zero
Allocate queue limit	ISR_ALLOCATE_QUEUE_LIMIT	The value of the QUEUELIMIT parameter specified on the IPCONN definition. This value is the maximum number of allocate requests that CICS is to queue while waiting for free sessions.
Maximum queue time (seconds)	ISR_MAX_QUEUE_TIME	The MAXQTIME specified on the IPCONN definition. This value represents the maximum time that queued allocate requests, waiting for free sessions on a connection that appears to be unresponsive, can wait. The maximum queue time is used only if a queue limit is specified for QUEUELIMIT; and the time limit is applied only when the queue length has reached the queue limit value. Reset characteristic: not reset
Number of MAXQTIME allocate queue purges	ISR_MAXQTIME_ALLOC_QPURGES	The total number of times an allocate queue has been purged because of the MAXQTIME value. A queue is purged when the total time it would take to process a queue exceeds the MAXQTIME value. Reset characteristic: reset to zero
Number of MAXQTIME allocates purged	ISR_MAXQTIME_ALLOCS_PURGED	The total number of allocate requests purged because the queue time exceeds the MAXQTIME value. Reset characteristic: reset to zero
Number of transactions attached	ISR_TRANS_ATTACHED	The total number of transactions attached for this connection. Reset characteristic: reset to zero
Remote Terminal Starts	ISR_REMOTE_TERM_STARTS	The total number of START requests sent from a remote terminal. Reset characteristic: reset to zero
Transaction Routing requests	ISR_TR_REQUESTS	The number of transaction routing requests on this connection. Reset characteristic: reset to zero
Bytes Sent by Transaction Routing requests	ISR_TR_BYTES_SENT	The number of bytes sent on transaction routing requests. Reset characteristic: reset to zero
Bytes Rcvd by Transaction Routing requests	ISR_TR_BYTES_RECEIVED	The number of bytes received by transaction routing requests. Reset characteristic: reset to zero
Send Sessions	ISR_SEND_SESSIONS	The defined number of send sessions. The actual number of sessions used depends also on the number of receive sessions defined in the partner system. When the connection is established, these values are exchanged and the lower value is used. Reset characteristic: not reset
Current Send Sessions	ISR_CURRENT_SEND_SESSIONS	The current number of send sessions in use. Reset characteristic: reset to current value
Peak Send Sessions	ISR_PEAK_SEND_SESSIONS	The peak number of send sessions in use. Reset characteristic: reset to current value
Allocates Failed - Other	ISR_ALLOCATES_FAILED_OTHER	The number of allocate requests that failed because of other reasons. Reset characteristic: reset to zero
Number of QUEUELIMIT allocates rejected	ISR_QLIMIT_ALLOC_REJECTS	The total number of allocate requests rejected because the QUEUELIMIT value is reached. Reset characteristic: reset to zero
Number of XISQUE allocate requests rejected	ISR_XISQUE_ALLOC_REJECTS	The total number of allocate requests rejected by an XISQUE global user exit program. Reset characteristic: reset to zero
Number of XISQUE allocate queue purges	ISR_XISQUE_ALLOC_QPURGES	The total number of allocate queue purges that have occurred because of an XISQUE request for this connection. Reset characteristic: reset to zero.
Number of XISQUE allocates purged	ISR_XISQUE_ALLOCS_PURGED	The total number of allocate requests purged because XISQUE requests that allocate queues are purged (ISR_XISQUE_ALLOC_QPURGES) for this connection. If XISQUE does not subsequently cancel this instruction, any subsequent allocate requests are purged and included in this statistic, because the XISQUE purging mechanism is still in operation. Reset characteristic: reset to zero
Function Shipped Program requests	ISR_FS_PG_REQUESTS	The number of program control LINK requests for function shipping on this connection. Reset characteristic: reset to zero
Bytes Sent by Program requests	ISR_FS_PG_BYTES_SENT	The number of bytes sent on LINK requests. Reset characteristic: reset to zero
Bytes Received by Program requests	ISR_FS_PG_BYTES_RECEIVED	The number of bytes received on LINK requests. Reset characteristic: reset to zero
Function Shipped Interval Control requests	ISR_FS_IC_REQUESTS	The number of interval control requests for function shipping on this connection. Reset characteristic: reset to zero
Bytes Sent by Interval Control requests	ISR_FS_IC_BYTES_SENT	The number of bytes sent on interval control requests. Reset characteristic: reset to zero
Bytes Rcvd by Interval Control Requests	ISR_FS_IC_BYTES_RECEIVED	The number of bytes received by interval control requests. Reset characteristic: reset to zero
Function Shipped File Control requests	ISR_FS_FC_REQUESTS	The number of file control requests for function shipping on this connection. Reset characteristic: reset to zero
Bytes Sent by File Control Requests	ISR_FS_FC_BYTES_SENT	The number of bytes sent by file control requests. Reset characteristic: reset to zero
Bytes Rcvd by File Control Requests	ISR_FS_FC_BYTES_RECEIVED	The number of bytes received by file control requests. Reset characteristic: reset to zero
Function Shipped Transient Data Requests	ISR_FS_TD_REQUESTS	The number of transient data requests for function shipping on this connection. Reset characteristic: reset to zero
Bytes Sent by Transient Data Requests	ISR_FS_TD_BYTES_SENT	The number of bytes sent by transient data requests. Reset characteristic: reset to zero
Bytes Rcvd by Transient Data Requests	ISR_FS_TD_BYTES_RECEIVED	The number of bytes received by transient data requests. Reset characteristic: reset to zero
Function Shipped Temporary Storage Requests	ISR_FS_TS_REQUESTS	The number of temporary storage requests for function shipping on this connection. Reset characteristic: reset to zero
Bytes Sent by Temporary Storage Requests	ISR_FS_TS_BYTES_SENT	The number of bytes sent by temporary storage requests. Reset characteristic: reset to zero
Bytes Rcvd by Temporary Storage Requests	ISR_FS_TS_BYTES_RECEIVED	The number of bytes received by temporary storage requests. Reset characteristic: reset to zero
Unsupported Requests	ISR_UNSUPPORTED_REQUESTS	The number of attempts to route requests for unsupported function across this connection. Reset characteristic: reset to zero
Not in DFHSTUP report	ISR_IPCONN_GMT_CREATE_TIME	The date and time when the IPCONN was autoinstalled. The time shown is GMT. If the IPCONN was not autoinstalled, this field is not shown.
Not in DFHSTUP report	ISR_IPCONN_GMT_DELETE_TIME	The date and time when the autoinstalled IPCONN was deleted. The time shown is GMT. If the IPCONN was not autoinstalled, this field is not shown.
Not in DFHSTUP report	ISR_SSL_SUPPORT	Whether secure socket layer (SSL) authentication is supported. SSL_YES SSL_NO Reset characteristic: not reset
Not in DFHSTUP report	ISR_USERAUTH	The type of user authentication used. DEFAULTUSER IDENTIFY LOCAL VERIFY Reset characteristic: not reset
Not in DFHSTUP report	ISR_LINKAUTH	The type of link authentication used. CERTUSER SECUSER Reset characteristic: not reset
Not in DFHSTUP report	ISR_IPCONN_DEFINE_SOURCE	The source of the resource definition. Its value depends on the change agent. For more information, see Summary of the resource signature field values. Reset characteristic: not reset
Not in DFHSTUP report	ISR_IPCONN_CHANGE_TIME	The time stamp (STCK) in local time of the CSD record change. Reset characteristic: not reset
Not in DFHSTUP report	ISR_IPCONN_CHANGE_USERID	The user ID that ran the CHANGE_AGENT. Reset characteristic: not reset
Not in DFHSTUP report	ISR_IPCONN_CHANGE_AGENT	The agent that was used to make the last change. Reset characteristic: not reset
Not in DFHSTUP report	ISR_IPCONN_INSTALL_AGENT	The agent that installed the resource. Reset characteristic: not reset
Not in DFHSTUP report	ISR_IPCONN_INSTALL_TIME	The time stamp (STCK) in local time when the resource was installed. Reset characteristic: not reset
Not in DFHSTUP report	ISR_IPCONN_INSTALL_USERID	The user ID that installed the resource. Reset characteristic: not reset
Not in DFHSTUP report	ISR_MIRRORLIFE	The minimum lifetime of the mirror task for function-shipped requests received by this region. REQUEST TASK UOW Reset characteristic: not reset

The resource statistics fields for the resource signature

The resource signature captures details about when the resource is defined, installed, and last changed. The resource statistics field names for the resource signature end in CHANGE_AGENT, CHANGE_TIME, CHANGE_USERID, DEFINE_SOURCE, INSTALL_AGENT, INSTALL_TIME, and INSTALL_USERID. For detailed information about the content of the resource signature fields, see Summary of the resource signature field values.