Temporary Storage report
The Temporary Storage report is produced using the EXEC CICS EXTRACT STATISTICS TSQUEUE command. The statistics data is mapped by the DFHTSGDS DSECT.
| Field Heading | Description |
|---|---|
| Put/Putq main storage requests | The number of records that application
programs wrote to main temporary storage. Source field: TSGSTA5F |
| Get/Getq main storage requests | The number of records that application
programs obtained from main temporary storage. Source field: TSGNMG |
| Current TSMAINLIMIT setting | The current limit for the amount
of storage that CICS® makes
available for data in main temporary storage. This amount is expressed in KB. Source field: (TSGTSMLM / 1024) |
| Times at TSMAINLIMIT | The number of times that main
temporary storage use attempted to exceed the limit for the amount
of storage allowed for data. Source field: TSGTSLHT |
| Current storage used for TSMAINLIMIT | The amount of storage that is
currently in use for data in main temporary storage. This amount is expressed in KB. Source field: (TSGTSMUS / 1024) |
| Peak storage used for TSMAINLIMIT | The peak amount of storage that
was used for data in main temporary storage. This amount is expressed in KB. Source field: (TSGTSMAX / 1024) |
| Number of queues auto deleted | The number of temporary storage queues that CICS has deleted automatically by using the clean up task. Source field: TSGTSQDL |
| Count of clean up task runs | The number of times that the clean up task, which deletes
eligible temporary storage queues automatically, has run. Source field: TSGTSCTR |
| Put/Putq auxiliary storage requests | The number of records that application
programs wrote to auxiliary temporary storage. Source field: TSGSTA7F |
| Get/Getq auxiliary storage requests | The number of records that application
programs obtained from auxiliary temporary storage. Source field: TSGNAG |
| Times temporary storage queue created | The number of times that CICS created individual temporary
storage queues. Source field: TSGSTA3F |
| Peak temporary storage queues in use | The peak number of temporary
storage queue names in use at any one time. Source field: TSGQNUMH |
| Current temporary storage queues in use | The current number of temporary
storage queue names in use. Source field: TSGQNUM |
| Items in longest queue | The peak number of items in any
one temporary storage queue, up to a maximum of 32767. Source field: TSGQINH |
| Control interval size | 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. Source field: TSGCSZ |
| Control intervals in the DFHTEMP data set | 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. Source field: TSGNCI |
| Peak control intervals in use | The peak number of control intervals
(CIs) that contain active data. Source field: TSGNCIAH |
| Current control intervals in use | The current number of control
intervals (CIs) that contain active data. Source field: TSGNCIA |
| Available bytes per control interval | The number of bytes available
for use in the temporary storage data set control interval. Source field: TSGNAVB |
| Segments per control interval | The number of segments available
in each temporary storage data set control interval. Source field: TSGSPCI |
| Bytes per segment | The number of bytes per segment
of the temporary storage data set. Source field: TSGBPSEG |
| Writes bigger than control interval size | 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. Source field: TSGSTABF |
| Largest record length written | The size, expressed in bytes,
of the longest record written to the temporary storage data set. Source field: TSGLAR |
| Times auxiliary storage exhausted | 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. Source field: TSGSTA8F |
| Number Temporary Storage compressions | The number of times that the
temporary storage buffers were compressed. Source field: TSGSTA9F |
| Put auxiliary / compression ratio | Ratio of temporary storage put auxiliary requests
to temporary storage compressions. This ratio should be as high as
possible to minimize compressions. Source field: (TSGSTA7F / TSGSTA9F) |
| Temporary storage strings | 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. Source field: TSGNVCA |
| Peak Temporary storage strings in use | 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. Source field: TSGNVCAH |
| Temporary storage string waits | 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. Source field: TSGVWTN |
| Peak users waiting on string | The peak number of input/output
requests that were queued at any one time because all strings were
in use. Source field: TSGVUWTH |
| Current users waiting on string | The current number of input/output
requests that are queued because all strings are in use. Source field: TSGVUWT |
| Temporary storage buffers | 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. Source field: TSGNBCA |
| Temporary storage buffer waits | 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. Source field: TSGBWTN |
| Peak users waiting on buffer | The peak number of requests
queued because no buffers were available. Source field: TSGBUWTH |
| Current users waiting on buffer | The current number of requests
queued because no buffers are available. Source field: TSGBUWT |
| Temporary storage buffer reads | The number of times a control
interval (CI) must be read from disk. To decrease this activity, increase
the buffer allocation. Source field: TSGTRDN |
| Temporary storage buffer writes | 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. Source field: TSGTWTN |
| Forced buffer writes for recovery | 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. Source field: TSGTWTNR |
| Format writes | 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. Source field: TSGTWTNF |
| I/O errors on the DFHTEMP data set | 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. Source field: TSGSTAAF |
| Shared Pools defined | The number of unique shared
TS queue pools defined to CICS. Source field: TSGSHPDF |
| Shared Pools currently connected | The number of the shared TS
pools that this CICS region
is connected to. Source field: TSGSHPCN |
| Shared temporary storage read requests | The number of TS READQs from
the Shared TS Queue pool of TS queues. Source field: TSGSHRDS |
| Shared temporary storage write requests | The number of TS WRITEQs to
the Shared TS Queue pool of TS queues. Source field: TSGSHWTS |
| Storage Subpool Location | Storage location of the TSBUFFRS storage subpool. Source field: SMDDSANAME |
| Getmain Requests | The number of getmain requests issued for this
TSBUFFRS storage subpool. Source field: SMDGMREQ |
| Freemain Requests | The number of freemain requests issued for this
TSBUFFRS storage subpool. Source field: SMDFMREQ |
| Current Elements | The number of elements remaining after FREEMAIN requests; that is, it is the
difference between the number of GETMAIN and FREEMAIN requests for this TSBUFFRS storage subpool.
Source field: SMDCELEM |
| Current Element Storage | The amount of storage in bytes of the current
elements. Source field: SMDCES |
| Current Page Storage | The current amount of page storage in kilobytes
for this TSBUFFRS storage subpool. Source field: SMDCPS |
| % of ECDSA | The current element storage of the TSBUFFRS
storage subpool as a percentage of the ECDSA in which it resides. Source field: ((SMDCPS / ecdsasize) * 100) |
| Peak Page Storage | The peak amount of page storage in kilobytes
for this TSBUFFRS storage subpool. Source field: SMDHWMPS |