DBCTL session termination statistics

DBCTL statistics are of the unsolicited type only. They appear on a separate report to the other types of CICS® statistics.

The DBCTL statistics exit DFHDBSTX is invoked by the CICS adapter (DFHDBAT), and CICS statistics information is collected by the statistics domain whenever DBCTL is disconnected as a result of:

Note:
If there is an immediate shutdown or abend of CICS, the latest CICS-DBCTL session statistics are lost. The function of DFHDBSTX is to invoke the statistics domain supplying the data that has been returned from the database resource adapter (DRA) relating to the individual CICS-DBCTL session.

CICS termination statistics that contain the number of DL/I calls by type, issued against each DL/I database, are not produced by CICS in the DBCTL environment. DBCTL produces this type of information.

For more information about CICS-DBCTL statistics, see the CICS IMS™ Database Control Guide.

This section contains the following statistics:

DBCTL session termination: Global statistics

These statistics are mapped by the DFHDBUDS DSECT.

Table 33. DBCTL session termination: Global statistics
DFHSTUP name Field name Description
CICS DBCTL session number STADSENO is the number of the CICS-DBCTL session and is incremented every time you connect and disconnect.

Reset characteristic: not reset

 

DBCTL identifier STATDBID is the name of the DBCTL session.

Reset characteristic: not reset

 

DBCTL RSE name STARSEN is the name of the DBCTL recoverable service element (RSE).

Reset characteristic: not reset

 

Time CICS connected to DBCTL STALCTIM is the time when CICS was connected to DBCTL. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals at local time; however, the DSECT field contains the time as a local store clock (STCK) value.

Reset characteristic: not reset

 

Time CICS disconnected from DBCTL STALDTIM is the time when CICS was disconnected from DBCTL. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals at local time; however, the DSECT field contains the time as a local store clock (STCK) value.

Reset characteristic: not reset

 

NOT IN DFHSTUP REPORT STACTIME is the time when CICS was connected to DBCTL. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals at GMT; however, the DSECT field contains the time as a GMT store clock (STCK) value.

Reset characteristic: not reset

 

NOT IN DFHSTUP REPORT STADTIME is the time when CICS was disconnected from DBCTL. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals at GMT; however, the DSECT field contains the time as a GMT store clock (STCK) value.

Reset characteristic: not reset

 

Minimum number of threads STAMITHD is the minimum value specified in the DRA startup parameter table.

Reset characteristic: not reset

 

Maximum number of threads STAMATHD is the maximum value specified in the DRA startup parameter table.

Reset characteristic: not reset

 

Times minimum threads hit STANOMITHD is the number of times the CICS-DBCTL session "collapsed" threads down to the minimum thread value.

Reset characteristic: not reset

Times maximum threads hit STANOMATHD is the number of times the CICS-DBCTL session has hit the maximum thread value.

Reset characteristic: not reset

Elapsed time at maximum threads STAELMAX is the elapsed time, expressed as hours:minutes:seconds.decimals, for which the CICS-DBCTL session is running at the maximum thread value.

Reset characteristic: none

 

Peak number of thread TCBs STAHIWAT is the highest number of thread TCBs created throughout the CICS-DBCTL session. Due to the asynchronous nature of TCB creation and deletion, it is possible for the number of TCBs to exceed the maximum number of threads, although the number of TCBs with an active thread will not exceed the maximum thread value.

Reset characteristic: not reset

 

Successful PSB schedules STAPSBSU is the number of times the CICS-DBCTL session has successfully scheduled a program specification block (PSB).

Reset characteristic: not reset

 

DBCTL session termination: Summary global statistics

Summary statistics are not available online.

Table 34. DBCTL session termination: Summary global statistics
DFHSTUP name Description
DBCTL identifier is the name of the DBCTL session.

 

DBCTL RSE name is the name of the DBCTL recoverable service element (RSE).

 

Minimum number of threads is the minimum value specified in the DRA startup parameter table.

 

Maximum number of threads is the maximum value specified in the DRA startup parameter table.

 

Times minimum threads hit is the total number of times the CICS-DBCTL session "collapsed" threads down to the minimum thread value.
Times maximum threads hit is the total number of times the CICS-DBCTL session has hit the maximum thread value.

 

Elapsed time at maximum threads is the elapsed time, expressed as days-hours:minutes:seconds.decimals, for which the CICS-DBCTL session is running at the maximum thread value.

 

Peak number of thread TCBs is the highest number of thread TCBs created throughout the CICS-DBCTL session. Due to the asynchronous nature of TCB creation and deletion, it is possible for the number of TCBs to exceed the maximum number of threads, although the number of TCBs with an active thread will not exceed the maximum thread value.

 

Successful PSB schedules is the total number of times the CICS-DBCTL session has successfully scheduled a program specification block (PSB).

 

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
not available
DFH0STAT reports for these statistics
not available
[[ Contents Previous Page | Next Page Index ]]