Temporary storage: Global statistics
You can retrieve temporary storage global statistics by using the EXEC CICS EXTRACT STATISTICS TSQUEUE system command. They are mapped by the DFHTSGDS DSECT.
| DFHSTUP name | Field name | Description |
|---|---|---|
| Put/Putq main storage requests | TSGSTA5F | The number of records that application
programs wrote to main temporary storage. Reset characteristic: reset to zero
|
| Get/Getq main storage requests | TSGNMG | The number of records that application
programs obtained from main temporary storage. Reset characteristic: reset to zero
|
| Current TSMAINLIMIT setting | TSGTSMLM | The current limit for the amount
of storage that CICS® makes
available for data in main temporary storage. This
amount is expressed in bytes. Reset characteristic: not reset
|
| Times at TSMAINLIMIT | TSGTSLHT | The number of times that main
temporary storage use attempted to exceed the limit for the amount
of storage allowed for data. Reset characteristic: reset to zero
|
| Current storage used for TSMAINLIMIT | TSGTSMUS | The amount of storage that is
currently in use for data in main temporary storage. This
amount is expressed in bytes. Reset characteristic: not reset
|
| Peak storage used for TSMAINLIMIT | TSGTSMAX | The peak amount of storage that
was used for data in main temporary storage. This
amount is expressed in bytes. Reset characteristic: reset to current value
|
| Number of queues auto deleted | TSGTSQDL | The number of temporary storage queues that CICS has deleted automatically by using the clean up task. Reset characteristic: reset to zero
|
| Count of clean up task runs | TSGTSCTR | The number of times that the clean up task, which deletes
eligible temporary storage queues automatically, has run. Reset characteristic: reset to zero
|
| Put/Putq auxiliary storage requests | TSGSTA7F | The number of records that application
programs wrote to auxiliary temporary storage. Reset characteristic: reset to zero
|
| Get/Getq auxiliary storage requests | TSGNAG | The number of records that application
programs obtained from auxiliary temporary storage. Reset characteristic: reset to zero
|
| Peak temporary storage names in use | TSGQNUMH | The peak number of temporary
storage queue names in use at any one time. Reset characteristic: reset to current value
|
| Current temporary storage names in use | TSGQNUM | The current number of temporary
storage queue names in use. Reset characteristic: not reset
|
| Number of entries in longest queue | TSGQINH | The peak number of items in any
one temporary storage queue, up to a maximum of 32767. Reset characteristic: reset to zero
|
| Times queues created | TSGSTA3F | The number of times that CICS created individual temporary
storage queues. Reset characteristic: reset to zero
|
| Control interval size | TSGCSZ | The size of the VSAM unit of transmission
between DASD and main storage, specified in the CONTROLINTERVALSIZE
parameter in the VSAM CLUSTER definition for the temporary storage
data set. In general, using large control intervals (CIs) permits
more data to be transferred at one time, resulting in less system
overhead. Reset characteristic: not reset
|
| Available bytes per control interval | TSGNAVB | The number of bytes available
for use in the temporary storage data set control interval. Reset characteristic: not reset
|
| Segments per control interval | TSGSPCI | The number of segments available
in each temporary storage data set control interval. Reset characteristic: not reset
|
| Bytes per segment | TSGBPSEG | The number of bytes per segment
of the temporary storage data set. Reset characteristic: not reset
|
| Writes more than control interval | TSGSTABF | The number of writes of records
whose length was greater than the control interval (CI) size. If the
reported value is large, increase the CI size. If the value is zero,
consider reducing the CI size until a small value is reported. Reset characteristic: reset to zero
|
| Longest auxiliary temp storage record | TSGLAR | The size, expressed in bytes,
of the longest record written to the temporary storage data set. Reset characteristic: not reset
|
| Number of control intervals available | TSGNCI | The number of control intervals
(CIs) available for auxiliary temporary storage. This is the total
available space on the temporary storage data set, expressed as a
number of control intervals. This is not the space remaining at termination. Reset characteristic: not reset
|
| Peak control intervals in use | TSGNCIAH | The peak number of control intervals
(CIs) that contain active data. Reset characteristic: reset to current value
|
| Current control intervals in use | TSGNCIA | The current number of control
intervals (CIs) that contain active data. Reset characteristic: not reset
|
| Times aux. storage exhausted | TSGSTA8F | The number of situations where
one or more transactions might have been suspended because of a NOSPACE
condition, or might have been forced to end abnormally (by using a
HANDLE CONDITION NOSPACE command). If statistics are present for this
field, increase the size of the temporary storage data set. Reset characteristic: reset to zero
|
| Number of temp. storage compressions | TSGSTA9F | The number of times that the
temporary storage buffers were compressed. Reset characteristic: reset to zero
|
| Temporary storage buffers | TSGNBCA | The number of temporary storage
buffers specified in the TS= system initialization parameter, or in
the overrides. The number of buffers allocated might exceed the number
requested. Reset characteristic: not reset
|
| Buffer waits | TSGBWTN | 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 zero
|
| Peak users waiting on buffer | TSGBUWTH | The peak number of requests
queued because no buffers were available. Reset characteristic: reset to current value
|
| Current users waiting on buffer | TSGBUWT | The current number of requests
queued because no buffers are available. Reset characteristic: not reset
|
| Buffer writes | TSGTWTN | The number of WRITEs to the temporary
storage data set. This includes both WRITEs required for recovery
(see Forced writes for recovery) and WRITEs required when the buffer
is needed to accommodate another control interval (CI). To minimize
input/output activity caused by the second situation, increase buffer
allocation. Reset characteristic: reset to zero
|
| Forced writes for recovery | TSGTWTNR | The subset of the total number
of WRITEs caused by recovery being specified for queues. This input/output
activity is not affected by buffer allocation. Reset characteristic: reset to zero
|
| Buffer reads | TSGTRDN | The number of times a control
interval (CI) must be read from disk. To decrease this activity, increase
the buffer allocation. Reset characteristic: reset to zero
|
| Format writes | TSGTWTNF | The number of times a new control
interval (CI) was successfully written at the end of the data set
to increase the amount of available space in the data set. A formatted
write is attempted only if the current number of CIs available in
the auxiliary data set have all been used. Reset characteristic: reset to zero
|
| Temporary storage strings | TSGNVCA | The number of temporary storage
strings specified in the TS= system initialization parameter, or in
the overrides. The number of strings allocated might exceed the number
requested. Reset characteristic: not reset
|
| Peak number of strings in use | TSGNVCAH | The peak number of concurrent
input/output operations. If this is significantly less than the number
specified in the system initialization table (SIT), consider reducing
the SIT value to approach this number. Reset characteristic: reset to current value
|
| Times string wait occurred | TSGVWTN | The number of input/output requests
that were queued because no strings were available. If the number
of strings is the same as the number of buffers, this number is zero.
If this number is a high percentage (over 30%) of the total number
of input/output requests (for this purpose, the sum of TSGTWTN, Buffer
writes, and TSGTRDN, Buffer reads), consider increasing the number
of strings initially allocated. Reset characteristic: reset to zero
|
| Peak number of users waiting on string | TSGVUWTH | The peak number of input/output
requests that were queued at any one time because all strings were
in use. Reset characteristic: reset to current value
|
| Current users waiting on string | TSGVUWT | The current number of input/output
requests that are queued because all strings are in use. Reset characteristic: not reset
|
| I/O errors on TS data set | TSGSTAAF | The number of input/output errors
that occurred on the temporary storage data set. Normally, this number
should be zero. If it is not, inspect the CICS and VSAM messages to determine the cause. Reset characteristic: reset to zero
|
| Shared pools defined | TSGSHPDF | The number of unique shared
TS queue pools defined to CICS. Reset characteristic: reset to zero
|
| Shared pools currently connected | TSGSHPCN | The number of the shared TS
pools that this CICS region
is connected to. Reset characteristic: reset to zero
|
| Shared read requests | TSGSHRDS | The number of TS READQs from
the Shared TS Queue pool of TS queues. Reset characteristic: reset to zero
|
| Shared write requests | TSGSHWTS | The number of TS WRITEQs to
the Shared TS Queue pool of TS queues. Reset characteristic: reset to zero
|