Front end programming interface (FEPI) statistics

FEPI statistics contain data about the use of each FEPI connection, each FEPI pool, and a target in any pool.

This section contains the following statistics:

FEPI: Connection statistics

These statistics give information about each FEPI connection. The statistics are available online using the EXEC CICS® COLLECT STATISTICS NODE() TARGET() command, and are mapped by the DFHA23DS DSECT.

Table 55. FEPI: Connection statistics
DFHSTUP name Field name Description
Pool Name A23POOL is the FEPI pool name.

Reset characteristic: not reset

 

Target Name A23TARG is the FEPI target name.

Reset characteristic: not reset

 

Node Name A23NODE is the FEPI node.

Reset characteristic: not reset

 

Acquires A23ACQ is the number of times the connection was acquired.

Reset characteristic: reset to zero

 

Conversations A23CNV is the number of conversations that have used this connection.

Reset characteristic: reset to zero

 

Unsolicited Inputs A23USI is the number of times unsolicited input was received on this connection.

Reset characteristic: reset to zero

 

Characters
-Sent A23CHOUT is the number of characters of data sent on this connection.

Reset characteristic: reset to zero

 

-Received A23CHIN is the number of characters of data received on this connection.

Reset characteristic: reset to zero

 

Receive Timeouts A23RTOUT is the number of times a FEPI RECEIVE timed-out on this connection.

Reset characteristic: reset to zero

 

Error Conditions A23ERROR is the number of VTAM® error conditions raised for this connection.

Reset characteristic: reset to zero

 

FEPI: Pool statistics

These statistics give information about each FEPI pool. The statistics are available online using the EXEC CICS COLLECT STATISTICS POOL command, and are mapped by the DFHA22DS DSECT.

Table 56. FEPI: Pool statistics
DFHSTUP name Field name Description
Pool Name A22POOL is the FEPI pool name.

Reset characteristic: not reset

 

Targets A22TRGCT is the current number of targets in the pool.

Reset characteristic: not reset

 

Nodes A22NDCT is the current number of nodes in the pool.

Reset characteristic: not reset

 

Available Connections
-Current A22CONCT is the number of connections in the pool.

Reset characteristic: not reset

 

-Peak A22CONPK is the peak number of connections in the pool. This field is needed because targets and nodes may be deleted between intervals.

Reset characteristic: reset to current value (A22CONCT)

 

Allocates
-Total A22ALLOC is the number of conversations that have been allocated from this pool.

Reset characteristic: reset to zero

 

-Peak A22PKALL is the peak number of concurrent conversations allocated from this pool.

Reset characteristic: reset to current value

 

Allocate Waits
NOT IN THE DFHSTUP REPORT A22WAIT is the current number of conversations waiting to be allocated.

Reset characteristic: not reset

 

-Total A22TOTWT is the number of conversations that had to wait to be allocated.

Reset characteristic: reset to zero

 

-Peak A22PKWT is the peak number of conversations that had to wait to be allocated.

Reset characteristic: reset to current value (A22WAIT)

 

Allocate Timeouts A22TIOUT is the number of conversation allocates that timed out.

Reset characteristic: reset to zero

FEPI: Target statistics

These statistics give information about a particular target in a pool. The statistics are available online using the EXEC CICS COLLECT STATISTICS POOL() TARGET() command, and are mapped by the DFHA24DS DSECT.

Table 57. FEPI: Target statistics
DFHSTUP name Field name Description
Target name A24TARG is the FEPI target name.

Reset characteristic: not reset

 

Pool name A24POOL is the FEPI pool name.

Reset characteristic: not reset

 

Applid A24APPL is the VTAM applid of the target.

Reset characteristic: not reset

 

Nodes A24NDCT is the number of nodes connected to this target.

Reset characteristic: not reset

 

Allocates A24ALLOC is the number of conversations specifically allocated to this target in this pool.

Reset characteristic: reset to zero

 

Allocate Waits
-Total A24TOTWT is the number of conversations that had to wait to be allocated to this target in this pool.

Reset characteristic: reset to zero

 

-Wait A24WAIT is the number of current conversations waiting to be allocated to this target in this pool

Reset characteristic: reset to zero

 

-Peak A24PKWT is the peak number of conversations that had to wait to be allocated to this target in this pool.

Reset characteristic: reset to current value (A24WAIT)

 

Allocate Timeouts A24TIOUT is the number of conversation allocates to this target in this pool that timed out.

Reset characteristic: reset to zero

 

FEPI: Unsolicited connection statistics

Unsolicited connection statistics are produced when a connection is destroyed. This occurs when a DELETE POOL, DISCARD NODELIST, DISCARD POOL or DISCARD TARGETLIST command is used. The statistics are mapped by the DFHA23DS DSECT. They contain the same information as the interval statistics.

FEPI: Unsolicited pool statistics

Unsolicited pool statistics are produced when a pool is discarded. The statistics are mapped by the DFHA22DS DSECT. They contain the same information as the interval statistics.

FEPI: Unsolicited target statistics

Unsolicited target statistics are produced when a target is destroyed or removed from a pool. This occurs when a DELETE POOL, DISCARD POOL or DISCARD TARGETLIST command is used. The statistics are mapped by the DFHA24DS DSECT. They contain the same information as the interval statistics.

FEPI: Summary connection statistics

Summary statistics are not available online.

Table 58. FEPI: Summary connection statistics
DFHSTUP name Description
Pool name is the FEPI pool name.
Target name is the FEPI target name.
Node name is the FEPI node.
Acquires is the total number of times the connection was acquired.
Conversations is the total number of conversations that have used this connection.
Unsolicited Inputs is the total number of times unsolicited input was received on this connection.
Characters Sent
-Sent is the total number of characters of data sent on this connection.
-Received is the total number of characters of data received on this connection.
Receive timeouts is the total number of times a FEPI RECEIVE timed-out on this connection.
Error conditions is the total number of VTAM error conditions raised for this connection.

FEPI: Summary pool statistics

Summary statistics are not available online.

Table 59. FEPI: Summary pool statistics
DFHSTUP name Description
Pool name is the FEPI pool name.
Targets is the number of targets in the pool.
Nodes is the number of nodes in the pool.
Available connections
-Current is the number of connections in the pool.
-Peak is the highest peak number of connections in the pool.
Allocates
-Totals is the total number of conversations allocated from this pool.
-Peak is the highest peak number of concurrent conversations allocated from this pool.
Allocate waits
-Total is the total number of conversations that had to wait to be allocated.
-Peak is the highest peak number of conversations that had to wait to be allocated.
Allocate timeouts is the total number of conversation allocates that timed out.

FEPI: Summary target statistics

Summary statistics are not available online.

Table 60. FEPI: Summary target statistics
DFHSTUP name Description
Target name is the FEPI target name.
Pool name is the FEPI pool name.
Applid is the VTAM applid of the target.
Nodes is the number of nodes in the pool.
Allocates is the total number of conversations specifically allocated to this target in this pool.
Allocate waits
-Total is the total number of conversations that had to wait to be allocated to this target in this pool.
-Peak is the highest peak number of conversations that had to wait to be allocated to this target in this pool.
Allocate timeouts is the total number of conversations allocated to this target in this pool that timed out.

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tablesInterpreting these statistics
Interpreting front end programming interface (FEPI) statistics
DFH0STAT reports for these statistics
not available
[[ Contents Previous Page | Next Page Index ]]