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.
- 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).
| 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.
Reset characteristic: not reset |
| Not in DFHSTUP report | ISR_USERAUTH | The type of user authentication
used.
Reset characteristic: not reset
|
| Not in DFHSTUP report | ISR_LINKAUTH | The type of link authentication
used.
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.
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.