ISC/IRC system entry: Resource statistics
You can retrieve ISC/IRC system entry resource statistics by using the EXEC CICS EXTRACT STATISTICS CONNECTION system command. They are mapped by the DFHA14DS DSECT,
The two types of intersystem communication, ISC over SNA and IPIC, are described in Communication between systems.
- For processing data returned for an online enquiry for a connection (EXEC CICS EXTRACT STATISTICS)
- For processing connection statistics offline (SMF)
- For processing the connection totals (the summation of all defined connections in this CICS® region).
CICS always allocates a SEND session when sending an IRC request to another region. Either a SEND or RECEIVE session can be allocated when sending requests using LU6.1 ISC, and either a contention loser or a contention winner session can be allocated when sending requests using APPC.
In LU6.1, SEND sessions are identified as secondaries, and RECEIVE sessions are identified as primaries.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Connection name | A14CNTN | corresponds to each system entry defined by a CONNECTION definition in the CSD,
or by autoinstall. Reset characteristic: not reset |
| Connection netname | A14ESID | is the name by which the remote system is known in the network—that is,
its applid. Reset characteristic: not reset |
| Access Method / Protocol | A14ACCM | is the communication access method used for this connection. The values are:
|
| Access Method / Protocol | A14EFLGS | is the communication protocol used for this connection. The values are:
|
| Autoinstalled Connection Create Time | A14AICT | is the time at which this connection was autoinstalled, in local time. The time is expressed as hours:minutes:seconds.decimals. The DSECT field contains the value as a store clock (STCK). This field is only applicable to an autoinstalled APPC connection. For all other types of connection the value will be nulls (x'00'). |
| Autoinstalled Connection Delete Time | A14AIDT | is the time at which this connection was deleted, in local time. The time is expressed as hours:minutes:seconds.decimals. The DSECT field contains the value as a store clock (STCK). This field is only set if this is an autoinstalled APPC connection that has been deleted, that is, this field is only set in an unsolicited statistics (USS) record. For all other types of connection and all other types of statistics record the value will be nulls (x'00'). |
| Send session count | A14ESECN | is the number of SEND sessions for this connection. This field applies to MRO
and LU6.1 connections only. Reset characteristic: not reset |
| Receive session count | A14EPRMN | is the number of RECEIVE sessions for this connection. This field applies to MRO
and LU6.1 connections only. Reset characteristic: not reset |
| Aids in chain | A14EALL | is the current number of automatic initiate descriptors in the AID chain.
Reset characteristic: not reset |
| Generic aids in chain | A14ESALL | is the current number of automatic initiate descriptors that are waiting for a
session to become available to satisfy an allocate request. Reset characteristic: not reset |
| Peak aids in chain | A14EAHWM | is the peak number of automatic initiate descriptors that were present in the
AID chain at any one time. Reset characteristic: not reset |
| ATIs satisfied by contention losers | A14ES1 | is the number of ATI requests (queued allocates) that have been satisfied by
contention loser sessions (primaries for LU6.1). This is always zero for IRC system entries. For
APPC, this field is zero when written to SMF, but if accessed online using the EXEC CICS
EXTRACT STATISTICS command, this field is the summation of the equivalent mode entry
statistics. Reset characteristic: reset to zero |
| ATIs satisfied by contention winners | A14ES2 | is the number of ATI requests (queued allocates) that have been satisfied by
contention winner sessions (secondaries for LU6.1). This field is the total ATIs when the system
entry is for IRC. For APPC, this field is zero when written to SMF, but if accessed online using the
EXEC CICS EXTRACT STATISTICS command, this field is the summation of the
equivalent mode entry statistics. Reset characteristic: reset to zero |
| Current contention losers | A14E1RY | is the number of contention loser sessions (primaries for LU6.1) that are
currently in use. Reset characteristic: not reset |
| Peak contention losers | A14E1HWM | is the peak number of contention loser sessions (primaries for LU6.1) that were
in use at any one time. Reset characteristic: reset to current value |
| Current contention winners | A14E2RY | is the number of contention winner sessions (secondaries for LU6.1) that are
currently in use. Reset characteristic: not reset |
| Peak contention winners | A14E2HWM | is the peak number of contention winner sessions (secondaries for LU6.1) that
were in use at any one time. Reset characteristic: reset to current value |
| Total bids sent | A14ESBID | is the total number of bids that were sent. A bid is sent on an LU6.1 RECEIVE
session only. This field is always zero for IRC entries. For APPC, this field is zero when written
to SMF, but if accessed online using the EXEC CICS EXTRACT STATISTICS command,
this field is the summation of the equivalent mode entry statistics. Reset characteristic: reset to zero |
| Current bids in progress | A14EBID | is the number of bids currently in progress. A bid is sent on an LU6.1 RECEIVE
session only. This field is always zero for IRC system entries. For APPC, this field is zero when
written to SMF, but if accessed online using the EXEC CICS EXTRACT STATISTICS
command, this field is the summation of the equivalent mode entry statistics. Reset characteristic: not reset |
| Peak bids in progress | A14EBHWM | is the peak number of bids that were in progress at any one time. A bid is sent
on an LU6.1 RECEIVE session only. Reset characteristic: reset to current value |
| Peak outstanding allocates For more information see note following this table. |
A14ESTAM | is the peak number of allocate requests that were queued for this system. For
APPC this field is incremented only for generic allocate requests. Reset characteristic: reset to current value |
| Total number of allocates For more information see note following this table. |
A14ESTAS | is the number of allocate requests against this system. For APPC:
Reset characteristic: reset to zero |
| Queued allocates For more information see note following this table. |
A14ESTAQ | is the current number of queued allocate requests against this system. An
allocate is queued due to a session not being available at this moment. This includes waiting for a
bind, a bid, or all sessions are currently in use. For APPC:
Reset characteristic: not reset |
| Failed link allocates For more information see note following this table. |
A14ESTAF | is the number of allocate requests that failed due to the connection being
released, out of service, or with a closed mode group. For APPC:
Reset characteristic: reset to zero |
| Failed allocates due to sessions in use For more information see note following this table. |
A14ESTAO | is the number of allocate requests that failed due to a session not being
currently available for use. These requests get SYSBUSY responses to the allocate. This field is
incremented for allocates failing with an AAL1 abend code. For APPC only:
Reset characteristic: reset to zero |
| Maximum queue time (seconds) | A14EMXQT | is the MAXQTIME specified on the CONNECTION definition. This value represents
the maximum time you require to process an allocate queue on this connection. If the allocate queue
would take greater than this time to process then the entire queue would be purged. This value only
takes effect if the QUEUELIMIT value (A14EALIM) has been reached. Reset characteristic: not reset |
| Allocate queue limit | A14EALIM | is the QUEUELIMIT parameter specified on the CONNECTION definition. If this
value is reached then allocates are rejected. If a QUEUELIMIT of No has been set, this field has a
value of -1.
Reset characteristic: not reset |
| Number of QUEUELIMIT allocates rejected | A14EALRJ | the total number of allocates rejected due to the QUEUELIMIT value (A14EALIM)
being reached. Reset characteristic: reset to zero |
| Number of MAXQTIME allocate queue purges | A14EQPCT | is the total number of times an allocate queue has been purged due to the
MAXQTIME value (A14EMXQT). 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 | A14EMQPC | is the total number of allocates purged due to the queue processing time
exceeding the MAXQTIME value (A14EMXQT). If sessions have not been freed after this mechanism has been invoked then any subsequent allocate requests are purged and included in this statistic as the MAXQTIME purging mechanism is still in operation. Reset characteristic: reset to zero |
| Number of XZIQUE allocates rejected | A14EZQRJ | is the total number of allocates rejected by the XZIQUE exit. Reset characteristic: reset to zero |
| Number of XZIQUE allocate queue purges | A14EZQPU | is the total number of allocate queue purges that have occurred at XZIQUE
request for this connection. If accessed online using the EXEC CICS EXTRACT STATISTICS command, this field additionally contains the summation of the equivalent mode entry statistics. Reset characteristic: reset to zero |
| Number of XZIQUE allocates purged | A14EZQPC | is the total number of allocates purged due to XZIQUE requesting that queues
should be purged (A14EZQPU) for this connection. If XZIQUE has not overridden this mechanism (by response) then any subsequent allocate requests are purged and included in this statistic as the XZIQUE purging mechanism is still in operation. If accessed online using the EXEC CICS EXTRACT STATISTICS command, this field additionally contains the summation of the equivalent mode entry statistics. Reset characteristic: reset to zero |
| File control (FC) function shipping requests | A14ESTFC | is the number of file control requests for function shipping. Reset characteristic: reset to zero |
| Interval control IC) function shipping requests | A14ESTIC | is the number of interval control requests for function shipping. Reset characteristic: reset to zero |
| Program control (PC) function shipping requests | A14ESTPC | is the number of program control link requests for function shipping.
Reset characteristic: reset to zero |
| Transient data (TD) function shipping requests | A14ESTTD | is the number of transient data requests for function shipping. Reset characteristic: reset to zero |
| Temporary storage (TS) function shipping requests | A14ESTTS | is the number of temporary storage requests for function shipping. Reset characteristic: reset to zero |
| DL/I function shipping requests | A14ESTDL | is the number of DL/I requests for function shipping. Reset characteristic: reset to zero |
| Terminal sharing requests | A14ESTTC | is the number of transaction routing commands. This number is incremented on
both regions when the transaction is routed, and when the terminal I/O request is routed between
regions. This field is not supported for LU6.1. Reset characteristic: reset to zero |
| NOT IN THE DFHSTUP REPORT | A14GACT | is the time at which this connection was autoinstalled, in GMT. The time is
expressed as hours:minutes:seconds.decimals. The DSECT field contains the value as a store
clock (STCK). This field is only applicable to an autoinstalled APPC connection. For all other types
of connection the value will be nulls (x'00'). Reset characteristic: not reset |
| NOT IN THE DFHSTUP REPORT | A14GADT | is the time at which this connection was deleted, in GMT. The time is expressed
as hours:minutes:seconds.decimals. The DSECT field contains the value as a store clock
(STCK). This field is only set if this is an autoinstalled APPC connection that has been deleted,
that is, this field is only set in an unsolicited statistics (USS) record. For all other types of
connection and all other types of statistics record the value will be nulls (x'00'). Reset characteristic: not reset |
| Terminal-sharing channel requests | A14ESTTC_CHANNEL | is the number of terminal-sharing channel requests. Reset characteristic: reset to zero |
| Number of bytes sent on terminal-sharing channel requests | A14ESTTC_CHANNEL_SENT | is the number of bytes sent on terminal-sharing channel requests. This is the
total amount of data sent on the connection, including any control information. Reset characteristic: reset to zero |
| Number of bytes received on terminal-sharing channel requests | A14ESTTC_CHANNEL_RCVD | is the number of bytes received on terminal-sharing channel requests. This is
the total amount of data sent on the connection, including any control information. Reset characteristic: reset to zero |
| Program control function-shipping LINK requests, with channels | A14ESTPC_CHANNEL | is the number of program control LINK requests, with channels, for function
shipping. This is a subset of the number in A14ESTPC. Reset characteristic: reset to zero |
| Number of bytes sent on LINK channel requests | A14ESTPC_CHANNEL _SENT | is the number of bytes sent on LINK channel requests. This is the total amount
of data sent on the connection, including any control information. Reset characteristic: reset to zero |
| Number of bytes received on LINK channel requests | A14ESTPC_CHANNEL _RCVD | is the number of bytes received on LINK channel requests. This is the total
amount of data received on the connection, including any control information. Reset characteristic: reset to zero |
| Interval control function-shipping START requests, with channels | A14ESTIC_CHANNEL | is the number of interval control START requests, with channels, for function
shipping. This is a subset of the number in A14ESTIC. Reset characteristic: reset to zero |
| Number of bytes sent on START channel requests | A14ESTIC_CHANNEL_SENT | is the number of bytes sent on START channel requests. This is the total amount
of data sent on the connection, including any control information. Reset characteristic: reset to zero |
| Number of bytes received on START channel requests | A14ESTIC_CHANNEL_RCVD | is the number of bytes received on START channel requests. This is the total
amount of data sent on the connection including any control information. Reset characteristic: reset to zero |
| Not in DFHSTUP report | A14ESTPC_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 | A14ESTPC_CHANGE_TIME |
The time stamp (STCK) in local time of CSD record change. Reset characteristic: not reset |
| Not in DFHSTUP report | A14ESTPC_CHANGE_USERID |
The user ID that ran the change agent. Reset characteristic: not reset |
| Not in DFHSTUP report | A14ESTPC_CHANGE_AGENT |
The agent that made the last change. Reset characteristic: not reset |
| Not in DFHSTUP report | A14ESTPC_INSTALL_AGENT |
The agent that installed the resource. Reset characteristic: not reset |
| Not in DFHSTUP report | A14ESTPC_INSTALL_TIME |
The time stamp (STCK) in local time when the resource was installed. Reset characteristic: not reset |
| Not in DFHSTUP report | A14ESTPC_INSTALL_USERID |
The user ID that installed the resource. Reset characteristic: not reset |
- For APPC only, if an allocate request does not specify a mode group (so it is a generic allocate request), CICS takes the first mode group within the sessions available, and the statistics for these allocates are reported against the system entry and against the mode entry (in the statistic 'Total generic allocates satisfied'). If an allocate specifically requests a mode entry (so it is a specific allocate request), the statistics for these allocates go into that mode entry.
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.