This section contains the following 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.
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
|
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.
|
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
|
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.
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:-
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:-
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:
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:
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
|
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:-
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
|
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
|
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
|
Summary statistics are not available online.
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.
|
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.
|
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.
|
Summary statistics are not available online.
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:-
|
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:-
|
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:
|
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:
|
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. |
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.
|
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. |
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. |