ISC mode entry: Resource statistics

These statistics cannot be retrieved using the EXEC CICS EXTRACT STATISTICS command. They are only produced for offline processing (written to SMF). These statistics are collected only if you have an APPC connection defined in your CICS® region, and they are then produced for each mode group defined in that connection. These statistics are mapped by the DFHA20DS DSECT. This DSECT is also used to map the mode entry totals records.

Table 1. ISC mode entry: Resource statistics
DFHSTUP name Field name Description
NOT IN THE DFHSTUP REPORT A20SYSN The name of the APPC connection/system that owns this mode entry. It corresponds to the system entry, defined by a CONNECTION definition in the CSD or by autoinstall.

Reset characteristic: not reset

Mode name A20MODE The mode group name related to the the intersystem connection name (A20SYSN). This corresponds to modename in the sessions definition.

Reset characteristic: not reset

ATIs satisfied by contention losers A20ES1 The number of ATI requests (queued allocates) that have been satisfied by “contention loser” sessions belonging to this mode group.

Reset characteristic: reset to zero

ATIs satisfied by contention winners A20ES2 The number of ATI requests (queued allocates) that have been satisfied by “contention winner” sessions belonging to this mode group.

Reset characteristic: reset to zero

Current contention losers in use A20E1RY The number of contention loser sessions currently in use.

Reset characteristic: not reset

Peak contention losers A20E1HWM The peak number of “contention loser” sessions belonging to this mode group that were in use at any one time. There can be sessions not defined (by the MAXIMUM parameter) as “contention winners” or “contention losers”, and their states are dynamically decided at bind time.

Reset characteristic: reset to current value

Current contention winners in use A20E2RY The number of contention winner sessions currently in use.

Reset characteristic: not reset

Peak contention winners A20E2HWM The peak number of “contention winner” sessions belonging to this mode group that were in use at any one time. There can be sessions not defined (by the MAXIMUM parameter) as “contention winners” or “contention losers”, and their states are dynamically decided at bind time.

Reset characteristic: reset to current value

Total bids sent A20ESBID The number of bids that were sent on the sessions defined to this mode group. A bid is sent on an APPC “contention loser” session when there are no “contention winner” sessions available to allocate.

Reset characteristic: reset to zero

Current bids in progress A20EBID The number of bids that are in progress on the sessions defined to this mode group. A bid is sent on an APPC “contention loser” session when there are no “contention winner” sessions available to allocate.

Reset characteristic: not reset

Peak bids in progress A20EBHWM The peak number of bids that were in progress at any one time, on the sessions defined to this mode group. A bid is sent on an APPC “contention loser” session when there are no “contention winner” sessions available to allocate.

Reset characteristic: reset to current value

Peak outstanding allocates A20ESTAM The peak number of allocation requests that were queued for this mode group.

For more information, see note 1.

Reset characteristic: reset to current value

Total specific allocate requests A20ESTAS The number of specific allocate requests against this mode group.

For more information, see note 1.

Reset characteristic: reset to zero

Total specific allocates satisfied A20ESTAP The number of specific allocates satisfied by this mode group.

For more information, see note 1.

Reset characteristic: reset to zero

Total generic allocates satisfied A20ESTAG The number of generic allocates satisfied from this mode group. The allocates are made for APPC without the mode group being specified.

Reset characteristic: reset to zero

Queued allocates A20ESTAQ The current number of queued specific allocate requests against this mode group. An allocate is queued due to a session in this mode group not being available at this moment. This includes waiting for a bind, a bid, or all sessions are currently in use.

For more information, see note 1.

Reset characteristic: not reset

Failed link allocates A20ESTAF The number of specific allocate requests that failed due to the connection being released, out of service, or with a closed mode group.

For more information, see note 1.

Reset characteristic: reset to zero

Failed allocates due to sessions in use A20ESTAO The number of specific allocate requests that failed due to a session not being currently available for use in this mode group. These requests get SYSBUSY responses to the allocate. This field is incremented for allocates failing with an AAL1 abend code.

For more information, see note 1.

Reset characteristic: reset to zero

Number of XZIQUE allocate queue purges A20EQPCT The total number of allocate queue purges that have occurred at XZIQUE request for this mode entry.

Reset characteristic: reset to zero

Number of XZIQUE allocates purged A20EZQPC The total number of allocates purged due to XZIQUE requesting that queues should be purged (A20EQPCT) for this mode entry.

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.

Reset characteristic: reset to zero

Maximum session count A20ELMAX The maximum number of sessions that the definition of the session group permits.

Reset characteristic: not reset

Current maximum session count A20EMAXS The current number of sessions in the group (the number “bound”).

Reset characteristic: not reset

Maximum contention winners acceptable A20EMCON The maximum number of sessions that the definition of the session group permits to be contention winners.

Reset characteristic: not reset

Current CNOS contention losers A20ECONL The current number of CNOS negotiated contention loser sessions.

Reset characteristic: not reset

Current CNOS contention winners A20ECONW The current number of CNOS negotiated contention winner sessions.

Reset characteristic: not reset

Note:
  1. This field is incremented when an allocate is issued against a specific mode group. If a generic allocate request is made, the equivalent system entry statistics only are incremented.