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:
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:
These statistics are mapped by the DFHDBUDS DSECT.
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
|
Summary statistics are not available online.
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).
|