Transient data statistics

This section contains the following statistics:

Transient data: Global statistics

These statistics can be accessed online using the EXEC CICS® COLLECT STATISTICS TDQUEUE command, and are mapped by the DFHTQGDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.

For more information on using transient data statistics, see Optimizing the performance of the CICS transient data (TD) facility.

Table 153. Transient data: Global statistics In the statistics produced for the intrapartition data set:
DFHSTUP name Field name Description
Control interval size TQGACISZ is the size of the control interval, expressed in bytes.

Reset characteristic: not reset

 

Control intervals TQGANCIS is the number of control intervals in the intrapartition data set DFHINTRA.

Reset characteristic: not reset

 

Current control intervals in use TQGACTCI is the current number of control intervals in the intrapartition data set DFHINTRA.

Reset characteristic: not reset

 

Peak control intervals used TQGAMXCI is the peak value of the number of control intervals concurrently active in the system.

Reset characteristic: reset to current value

 

Times NOSPACE occurred TQGANOSP is the number of times that a NOSPACE condition has occurred.

Reset characteristic: reset to zero

 

Writes to intrapartition data set TQGACTPT is the number of WRITEs to the intrapartition transient data set. This includes both WRITEs needed for recovery (see below) and WRITEs forced by the buffer being needed to accommodate another CI. I/O activity caused by the latter reason can be minimized by increasing the buffer allocation.

Reset characteristic: reset to zero

 

Reads from intrapartition data set TQGACTGT is the number of times a CI has to be read from disk. Increasing the buffer allocation decreases this activity.

Reset characteristic: reset to zero

 

Formatting writes TQGACTFT is the number of times a new CI was written at the end of the data set in order to increase the amount of available space.

Reset characteristic: reset to zero

 

I/O errors TQGACTIO is the number of input/output errors that have occurred during this run of CICS.

Reset characteristic: reset to zero

 

In the statistics produced for buffer usage:

 

Intrapartition buffers TQGANBFA is the number of transient data buffers specified in the system initialization table (SIT) or in the SIT overrides. The number of buffers allocated may exceed the number requested.

Reset characteristic: not reset

 

Current buffers containing valid data TQGACNIU is the current number of intrapartition buffers that contain valid data.

Reset characteristic: not reset

 

Peak intra. buffers containing valid data TQGAMXIU is the peak number of intrapartition buffers which contain valid data.

Reset characteristic: reset to current value

 

Intrapartition accesses TQGATNAL is the number of times intrapartition buffers have been accessed.

Reset characteristic: reset to current value

 

Current concurrent buffer accesses TQGACNAL is the current value of the number of concurrent intrapartition buffer accesses.

Reset characteristic: not reset

 

Peak concurrent intrapartition accesses TQGAMXAL is the peak value of the number of concurrent intrapartition buffer accesses.

Reset characteristic: reset to current value

 

Intrapartition buffer waits TQGATNWT is the number of times a request was queued because all buffers were allocated to other tasks. A buffer wait also occurs if the required control interval is already in a locked buffer, and therefore unavailable, even if there are other buffers available.

Reset characteristic: reset to current value

 

Current intrapartition buffer waits TQGACNWT is the current number of requests queued because no buffers were available.

Reset characteristic: not reset

 

Peak intrapartition buffer waits TQGAMXWT is the peak number of requests queued because no buffers were available.

Reset characteristic: reset to current value

 

All of the intrapartition data set statistics above are printed, even if the values reported are zero.

 

CICS produces the following statistics for multiple strings:
Number of strings TQGSNSTA is the number of strings currently active.

Reset characteristic: not reset

 

Times string accessed TQGSTNAL is the number of times a string was accessed.

Reset characteristic: reset to current value

 

Current concurrent string accesses TQGSCNAL is the current number of strings concurrently accessed in the system.

Reset characteristic: not reset

 

Peak concurrent string accesses TQGSMXAL is the peak number of strings concurrently accessed in the system.

Reset characteristic: reset to current value

 

Intrapartition string waits TQGSTNWT is the number of times that tasks had to wait because no strings were available.

Reset characteristic: reset to current value

 

Current intrapartition string waits TQGSCNWT is the current number of concurrent string waits in the system.

Reset characteristic: not reset

 

Peak string waits TQGSMXWT is the peak number of concurrent string waits in the system.

Reset characteristic: reset to current value

 

In the statistics produced for buffer usage:
DFHSTUP name Field name Description
Intrapartition buffers TQGANBFA is the number of transient data buffers specified in the system initialization table (SIT) or in the SIT overrides. The number of buffers allocated may exceed the number requested.

Reset characteristic: not reset

 

Current buffers containing valid data TQGACNIU is the current number of intrapartition buffers that contain valid data.

Reset characteristic: not reset

 

Peak intra. buffers containing valid data TQGAMXIU is the peak number of intrapartition buffers which contain valid data.

Reset characteristic: reset to current value

 

Intrapartition accesses TQGATNAL is the number of times intrapartition buffers have been accessed.

Reset characteristic: reset to current value

 

Current concurrent buffer accesses TQGACNAL is the current value of the number of concurrent intrapartition buffer accesses.

Reset characteristic: not reset

 

Peak concurrent intrapartition accesses TQGAMXAL is the peak value of the number of concurrent intrapartition buffer accesses.

Reset characteristic: reset to current value

 

Intrapartition buffer waits TQGATNWT is the number of times a request was queued because all buffers were allocated to other tasks. A buffer wait also occurs if the required control interval is already in a locked buffer, and therefore unavailable, even if there are other buffers available.

Reset characteristic: reset to current value

 

Current intrapartition buffer waits TQGACNWT is the current number of requests queued because no buffers were available.

Reset characteristic: not reset

 

Peak intrapartition buffer waits TQGAMXWT is the peak number of requests queued because no buffers were available.

Reset characteristic: reset to current value

 

All of the intrapartition data set statistics above are printed, even if the values reported are zero.

 

CICS produces the following statistics for multiple strings:
DFHSTUP name Field name Description
Number of strings TQGSNSTA is the number of strings currently active.

Reset characteristic: not reset

 

Times string accessed TQGSTNAL is the number of times a string was accessed.

Reset characteristic: reset to current value

 

Current concurrent string accesses TQGSCNAL is the current number of strings concurrently accessed in the system.

Reset characteristic: not reset

 

Peak concurrent string accesses TQGSMXAL is the peak number of strings concurrently accessed in the system.

Reset characteristic: reset to current value

 

Intrapartition string waits TQGSTNWT is the number of times that tasks had to wait because no strings were available.

Reset characteristic: reset to current value

 

Current intrapartition string waits TQGSCNWT is the current number of concurrent string waits in the system.

Reset characteristic: not reset

 

Peak string waits TQGSMXWT is the peak number of concurrent string waits in the system.

Reset characteristic: reset to current value

 

Transient data: Resource statistics

These statistics are collected for each queue. You can use the information from the statistics for each queue to calculate the average number of transient data accesses per transaction. The items in this listing reflect the information you placed in the definition for the transient data queue. The statistics are available online using the EXEC CICS COLLECT STATISTICS TDQ command, and are mapped by the DFHTQRDS DSECT.

The TQRQTYPE field is not displayed in the DFHSTUP report. It signifies the queue type, which can be one of:

TQRQTYPE is reset to zero.

Transient data: Resource statistics - intrapartition transient data queues

Table 154. Transient data: Resource statistics - intrapartition transient data queues
DFHSTUP name Field name Description
Queue id TQRQID is the destination identifier (queue) that you specified in the transient data queue definition.

Reset characteristic: Not reset

 

Request Counts: Number of Writes TQRWRITE is the total number of requests to write to this queue.

Reset characteristic: Reset to zero

 

Request Counts: Number of Reads TQRREAD is the total number of requests to read from this queue.

Reset characteristic: Reset to zero

 

Request Counts: Number of Deletes TQRDELET is the total number of requests to delete this queue.

Reset characteristic: Reset to zero

 

ATI Information: Trigger level TQRTRIGL is the value of the ATI trigger level. If the number of items in this queue reaches this value the transaction id in TQRATRAN is attached to process the items in the queue.

Reset characteristic: Not reset

 

ATI Information: Tran Id TQRATRAN is the id of the transaction that will be scheduled against a terminal/session or in the background (see TQRFTYPE) when the trigger level (TQRTRIGL) has been reached.

Reset characteristic: Not reset

 

ATI Information: Facility Type TQRFTYPE is the ATI facility type for this transient data queue. This will be where and how the transaction id in TQRATRAN is attached when the ATI trigger level (TQRTRIGL) is reached. It can have the following values:-
  • TQRFTNA X'00' Not Applicable (N/A)
  • TQRFTTRM X'01' Terminal (TERM)
  • TQRFTSYS X'02' System (SYS)
  • TQRFTNTE X'03' No terminal (NONE).

Reset characteristic: Not reset

 

ATI Information: Facility Name TQRFNAME is the id of the system or terminal that the trigger transaction will be attached against. This value is blank when there is no facility.

Reset characteristic: Not reset

 

ATI Information: No. of triggers TQRTRIGN is the number of times the trigger transaction (TQRATRAN) has been scheduled, as a result of the trigger level (TQRTRIGL) being exceeded.

Reset characteristic: Reset to zero

 

Recovery: Rcvy type TQRRTYPE is the recoverable type of this transient data queue. It can have the following values:-
  • TQRRTNA X'00' Not applicable (N/A)
  • TQRRTPH X'01' Physical recoverable (PH)
  • TQRRTLG X'02' Logical recoverable (LG)
  • TQRRTNR X'03' Non-recoverable (NR)

Reset characteristic: Not reset

 

Recovery: Wait opt. TQRWAIT is an indicator of whether any transactions that use this queue will be able, in the event of losing the connection to their recovery coordinator, to wait indoubt (shunted). If the queue supports indoubt waiting (TQRWTYES) then the locks that are associated with that UOW will be held until syncpoint resolution. If not, the UOW will be committed (forward or backward) at the time of indoubt failure according to the settings in the transaction definition and the locks released as a result. This field has meaning only if the queue is logically recoverable. The indoubt wait option can have the following settings:
  • TQRWTNA X'00' Not Applicable (N/A)
  • TQRWTYES X'01' Queue supports indoubt waiting (YES)
  • TQRWTNO X'02' Does not support indoubt waiting (NO)

Reset characteristic: Not reset

 

Recovery: Wait Action TQRWAITA is an indicator of whether this transient data queue will reject or suspend subsequent requests to this queue. This can be when a UOW that has used this queue has been shunted because of an indoubt failure and is therefore retaining enqueues against this queue.

This field has no meaning if the queue is non-recoverable or does not support indoubt waiting (see TQRWAIT).

The possible values for this field are:

  • TQRWANA X'00' Not Applicable (N/A)
  • TQRWAREJ X'01' Further requests will be rejected (REJECT)
  • TQRWAQUE X'02' Further requests will be queued (QUEUE)

Reset characteristic: Not reset

 

DFHINTRA usage: Current CIs used TQRCCIUS is the number of Control intervals (CIs) that are currently in use on the DFHINTRA data set by this queue.

Reset characteristic: Not reset

 

DFHINTRA usage: Peak CIs used TQRPCIUS is the peak number of Control intervals (CIs) that have been used on the DFHINTRA data set by this queue.

Reset characteristic: Reset to current

 

DFHINTRA usage: Current items TQRCNITM is the current number of items in this intrapartition queue.

Reset characteristic: Not reset

 

Transient data: Resource statistics - extrapartition transient data queues

Table 155. Transient data: Resource statistics - extrapartition transient data queues
DFHSTUP name Field name Description
Queue ID TQRQID is the destination identifier (queue) that you specified in the transient data queue definition.

Reset characteristic: Not reset

 

DD name (assoc.) TQRDDNM is the associated DD name of this data set in the CICS start-up JCL, or as defined by under CEDA.

Reset characteristic: Not reset

 

Dataset name (Destination/origin of data) TQRDSNNM is the data set name of the extrapartition transient data queue.

Reset characteristic: Not reset

 

Member Name TQRPDSMN is the name of a member in the partitioned data set referenced by the ddname for the extrapartition transient data queue.

Reset characteristic: Not reset

 

I/O Type TQRIOTYP is an indicator of the input/output type of the extrapartition data set. It may contain one of the following values:-
  • TQRIONA X'00' Not Applicable
  • TQRIOIN X'01' Input
  • TQRIOOUT X'02' Output
  • TQRIORDB X'03' Readback (input but read backwards)

Reset characteristic: Not reset

 

No. of Writes TQRWRITE is the total number of write operations to the output data set.

Reset characteristic: Reset to zero

 

No. of Reads TQRREAD is the total number of read operations from the input data set.

Reset characteristic: Reset to zero

 

Transient data: Resource statistics - indirect transient data queues

Table 156. Transient data: Resource statistics - indirect transient data queues
DFHSTUP name Field name Description
Queue ID TQRQID is the destination identifier (queue) that you specified in the transient data queue definition.

Reset characteristic: Not reset

 

Indirect Queue id TQRIQID is the name of the indirect queue.

Reset characteristic: Not reset

 

Request Counts: Writes TQRWRITE is the total number of requests to write to this queue.

Reset characteristic: Reset to zero

 

Request Counts: Reads TQRREAD is the total number of requests to read from this queue.

Reset characteristic: Reset to zero

 

Request Counts: Deletes TQRDELET is the total number of requests to delete this queue..

Reset characteristic: Reset to zero

 

Transient data: Resource statistics - remote transient data queues

Table 157. Transient data: Resource statistics - remote transient data queues
DFHSTUP name Field name Description
Queue Id TQRQID is the destination identifier (queue) that you specified in the transient data queue definition.

Reset characteristic: Not reset

 

Remote: Queue TQRRQID is the name of the queue on the remote system (TQRRSYS).

Reset characteristic: Not reset

 

Remote: Sysid TQRRSYS is the connection id of the CICS system that actually owns this queue.

Reset characteristic: Not reset

 

Request Counts: Writes TQRWRITE is the total number of requests to write to this queue.

Reset characteristic: Reset to zero

 

Request Counts: Reads TQRREAD is the total number of requests to read from this queue.

Reset characteristic: Reset to zero

 

Request Counts: Deletes TQRDELET is the total number of requests to delete this queue.

Reset characteristic: Reset to zero

 

Transient data: Summary global statistics

Summary statistics are not available online.

Table 158. Transient data: Summary global statistics In the statistics produced for the intrapartition data set:
DFHSTUP name Description
Control interval size is the last value encountered for the size of the control interval, expressed in bytes.

 

Peak control intervals used is the peak number of control intervals concurrently in the system.

 

Times NOSPACE occurred is a total number of times that a NOSPACE condition has occurred.

 

Writes to intrapartition data set is the total number of WRITEs to the transient data data set. This includes both WRITEs needed for recovery (see below) and WRITEs forced by the buffer being needed to accommodate another CI. I/O activity caused by the latter reason can be minimized by increasing the buffer allocation.

 

Reads from intrapartition data set is the total number of times a CI has to be read from disk. Increasing the buffer allocation decreases this activity.

 

Formatting writes is the total number of times a new CI was written at the end of the data set in order to increase the amount of available space.

 

I/O errors is the total number of input/output errors that have occurred during this run of CICS.

 

In the statistics produced for buffer usage:
DFHSTUP name Description
Intrapartition buffers is the last value encountered for the number of transient data buffers specified by the TD system initialization parameter. The number of buffers allocated may exceed the number requested.

 

Peak intra. buffers containing valid data is the peak number of intrapartition buffers which contain valid data.

 

Intrapartition accesses is the total number of times that intrapartition buffers have been accessed.

 

Peak concurrent intrapartition accesses is the peak number of concurrent intrapartition buffer accesses.

 

Intrapartition buffer waits is the total number of times a request was queued because all buffers were allocated to other tasks. A buffer wait also occurs if the required control interval is already in a locked buffer, and therefore unavailable, even if there are other buffers available.

 

Peak intrapartition buffer waits is the peak number of requests queued because no buffers were available.

 

All of the intrapartition data set statistics above are printed, even if the values reported are zero.

 

CICS produces the following statistics for multiple strings:
DFHSTUP name Description
Times string accessed is the total number of times a string was accessed.

 

Peak concurrent string accesses is the peak number of strings concurrently accessed in the system.

 

Intrapartition string waits is the total number of times that tasks had to wait because no strings were available.

 

Peak string waits is the peak number of concurrent string waits in the system.

 

Transient data: Summary resource statistics

Summary statistics are not available online.

Table 159. Transient data: Summary resource statistics - intrapartition transient data queues
DFHSTUP name Description
Queue ID is the destination identifier (queue) that you specified in the transient data queue definition.

 

Request Counts: Number of Writes is the total number of requests to write to this queue.
Request Counts: Number of Reads is the total number of requests to read from this queue.
Request Counts: Number of Deletes is the total number of requests to delete this queue.

 

ATI Information: Trigger level is the value of the ATI trigger level. If the number of items in this queue reaches this value, the transaction id in 'Tran Id' is attached to process the items in the queue.
ATI Information: Tran Id is the id of the transaction that will be scheduled against a terminal/session or in the background (depending on the value of 'Facility Type'), when the trigger level ('Trigger level') has been reached.
ATI Information: Facility Type is the ATI facility type for this transient data queue. This will be where and how the transaction id in 'Tran Id' is attached when the ATI trigger level ('Trigger level') is reached. It can have the following values:-
  • N/A -- Not Applicable
  • TERM -- Terminal
  • SYS -- System
  • NONE -- No terminal.
ATI Information: Facility Name is the id of the system or terminal that the trigger transaction will be attached against. This value is blank when there is no facility.
ATI Information: No. of triggers is the number of times the trigger transaction ('Tran Id') has been scheduled, as a result of the trigger level ('Trigger level') being exceeded.

 

Recovery: Rcvy type is the recoverable type of this transient data queue. It can have the following values:-
  • N/A -- Not applicable
  • PH -- Physical recoverable
  • LG -- Logical recoverable
  • NR -- Non-recoverable
Recovery: Wait opt. is an indicator of whether any transactions that use this queue will be able, in the event of losing the connection to their recovery coordinator, to wait indoubt (shunted). If the queue supports indoubt waiting (Wait opt. = Yes) then the locks that are associated with that UOW will be held until syncpoint resolution. If not, the UOW will be committed (forward or backward) at the time of indoubt failure according to the settings in the transaction definition and the locks released as a result. This field has meaning only if the queue is logically recoverable. The indoubt wait option can have the following settings:
  • N/A -- Not Applicable
  • Yes -- Queue supports indoubt waiting
  • No -- Does not support indoubt waiting
Recovery: Wait Action

 

is an indicator of whether this transient data queue will reject or suspend subsequent requests to this queue. This can be when a UOW that has used this queue has been shunted because of an indoubt failure and is therefore retaining enqueues against this queue.

This field has no meaning if the queue is non-recoverable (Rcvy Type is NR), or does not support indoubt waiting (Wait opt. is No).

The possible values for this field are:

  • N/A -- Not Applicable
  • Reject -- Further requests will be rejected
  • Queue -- Further requests will be queued

 

DFHINTRA usage: Current CIs used is the current number of CIs used by this intrapartition queue.
DFHINTRA usage: Peak CIs used is the peak number of CIs used by this intrapartition queue.
DFHINTRA usage: Current items is the current number of items in this intrapartition queue.
Table 160. Transient data: Summary resource statistics - extrapartition transient data queues
DFHSTUP name Description
Queue ID is the destination identifier (queue) that you specified in the transient data queue definition.

 

DDNAME (assoc.) is the DDNAME of the extrapartition queue.

 

Dataset name (Destination/origin of data)

 

is the data set name of the extrapartition queue.

 

Member Name is the name of a member in the partitioned data referenced by the ddname for the extrapartition transient data queue.

 

I/O Type is the type of I/O data set. Can be one of input, output or readback.

 

No. of Writes is the total number of write operations to the output data set.

 

No. of Reads is the total number of read operations from the input data set.

 

Table 161. Transient data: Summary resource statistics - indirect transient data queues
DFHSTUP name Description
Queue ID is the destination identifier (queue) that you specified in the transient data queue definition.

 

Indirect Queue id is the name of the indirect queue.

 

Request Counts: Writes is the total number of requests to write to this queue.
Request Counts: Reads is the total number of requests to read from this queue.
Request Counts: Deletes is the total number of requests to delete this queue.
Table 162. Transient data: Summary resource statistics - remote transient data queues
DFHSTUP name Description
Queue Id is the destination identifier (queue) that you specified in the transient data queue definition.

 

Remote: Queue is the name of the remote queue.
Remote: Sysid is the name of the remote system.

 

Requset Counts: Writes is the total number of requests to write to this queue.
Request Counts: Reads is the total number of requests to read from this queue.
Request Counts: Deletes is the total number of requests to delete this queue.

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
Interpreting transient data statistics
DFH0STAT reports for these statistics
Transient Data Report
Transient Data Queues Report
Transient Data Queue Totals Report
[[ Contents Previous Page | Next Page Index ]]