Temporary Storage Report

Figure 78 shows the format of the Temporary Storage Report. This report is produced using the EXEC CICS® COLLECT STATISTICS TSQUEUE command. The statistics data is mapped by the DFHTSGDS DSECT. The field headings and contents are described in Table 202.

Figure 78. The Temporary Storage Report
Applid IYK1Z1V1  Sysid CJB1  Jobname CI07CJB1    Date 12/17/2004  Time 08:44:37       CICS 6.4.0        PAGE    51

 
 
Temporary Storage
 
  Put/Putq main storage requests . . . . . :           0
  Get/Getq main storage requests . . . . . :           0
  Peak storage used for TS Main. . . . . . :           0K
  Current storage used for TS Main . . . . :           0K
 
  Put/Putq auxiliary storage requests. . . :           5
  Get/Getq auxiliary storage requests. . . :           1
 
  Times temporary storage queue created. . :           5
  Peak temporary storage queues in use . . :           5
  Current temporary storage queues in use. :           5
  Items in longest queue . . . . . . . . . :           1
  Control interval size. . . . . . . . . . :       4,096
  Control intervals in the DFHTEMP dataset :         359
  Peak control intervals used. . . . . . . :           2
  Current control intervals in use . . . . :           2
  Available bytes per control interval . . :       4,032
  Segments per control interval. . . . . . :          63
  Bytes per segment. . . . . . . . . . . . :          64
  Writes bigger than control interval size :           0
  Largest record length written. . . . . . :         294
  Times auxiliary storage exhausted. . . . :           0
  Number Temporary storage compressions. . :           0
  Put auxiliary / compression ratio. . . . :         252.00
  Temporary storage strings. . . . . . . . :           1
  Peak Temporary storage strings in use. . :           1
  Temporary storage string waits . . . . . :           0
  Peak users waiting on string . . . . . . :           0
  Current users waiting on string. . . . . :           0
  Temporary storage buffers. . . . . . . . :           3              'TSBUFFRS' Storage Subpool

  Temporary storage buffer waits . . . . . :           0
  Peak users waiting on buffer . . . . . . :           0              Storage Subpool Location. . . . . :       ECDSA
  Current users waiting on buffer. . . . . :           0              Getmain Requests. . . . . . . . . :             20
  Temporary storage buffer reads . . . . . :           0              Freemain Requests . . . . . . . . :              0
  Temporary storage buffer writes. . . . . :           2              Current Elements. . . . . . . . . :             20
  Forced buffer writes for recovery. . . . :           2              Current Element Storage . . . . . :         81,920
  Format writes. . . . . . . . . . . . . . :           0              Current Page Storage. . . . . . . :             80K
                                                                      % of ECDSA. . . . . . . . . . . . :           0.98%
  I/O errors on the DFHTEMP dataset. . . . :           0              Peak Page Storage . . . . . . . . :             80K
  Shared Pools defined . . . . . . . . . . :           3
  Shared Pools currently connected . . . . :           2
  Shared temporary storage read requests . :           7
  Shared temporary storage write requests. :          15
Table 202. Fields in the Temporary Storage Report
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

Peak storage used for TS Main The peak value, expressed in Kbytes, of the amount of virtual storage used for temporary storage records.

Source field: (TSGSTA6F / 1024)

Current storage used for TS Main The current value, expressed in Kbytes, of the amount of virtual storage used for temporary storage records.

Source field: (TSGSTA6A / 1024)

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.

Source field: TSGQINH

Control interval size The size of VSAM’s unit of transmission between DASD and virtual storage, specified in the CONTROLINTERVALSIZE parameter in the VSAM CLUSTER definition for the temporary storage data set. In general, using large CIs permits more data to be transferred at one time, resulting in less system overhead.

Source field: TSGCSZ

Control intervals in the DFHTEMP dataset The number of control intervals (CIs) available for auxiliary 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) containing active data.

Source field: TSGNCIAH

Current control intervals in use The current number of control intervals (CIs) containing active data.

Source field: TSGNCIA

Available bytes per control interval The number of bytes available for use in a DFHTEMP data set control interval (CI).

Source field: TSGNAVB

Segments per control interval The number of segments available in a DFHTEMP data set control interval (CI).

Source field: TSGSPCI

Bytes per segment The number of bytes per segment of the DFHTEMP 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.

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 may have been suspended because of a NOSPACE condition, or (using a HANDLE CONDITION NOSPACE command) may have been forced to abend.

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 auxilliary requests to temporary storage compressions. This ratio should be as high as possible to minimise 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 may exceed the number requested.

Source field: TSGNVCA

Peak Temporary storage strings in use The peak number of concurrent I/O operations. If this is significantly less than the number specified in the SIT, consider reducing the SIT value to approach this number.

Source field: TSGNVCAH

Temporary storage string waits The number of I/O requests that were queued because no strings were available. This is zero if the number of strings is the same as the number of buffers. If this is a high percentage (over 30%) of the number of I/O requests, consider increasing the number of strings initially allocated.

Source field: TSGVWTN

Peak users waiting on string The peak number of I/O 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 I/O 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 may 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 CI has to be read from disk. Increasing the buffer allocation decreases this activity.

Source field: TSGTRDN

Temporary storage buffer writes The number of WRITEs to the temporary storage data set. This includes both WRITEs necessitated by recovery requirements (see next item) and WRITEs forced by the buffer being needed to accommodate another CI.

Source field: TSGTWTN

Forced buffer writes for recovery The subset of the total number of WRITEs caused by recovery being specified for queues. This I/O 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 temporary storage data set. A formatted write is attempted only if the current number of control intervals (CIs) available in the auxiliary data set have all been used.

Source field: TSGTWTNF

I/O errors on the DFHTEMP dataset The number of input/output errors which occurred on the temporary storage data set. This should normally 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 either in the TST with DFHTST TYPE=SHARED, or by using TSMODEL.

Source field: TSGSHPDF

Shared Pools currently connected The number of the TS pools that are actually connected to by this CICS region.

Source field: TSGSHPCN

Shared temporary storage read requests The number of TS READQs from the Shared TS Queue pool of Queueids.

Source field: TSGSHRDS

Shared temporary storage write requests The number of TS WRITEQs to the Shared TS Queue pool of Queueids.

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 left 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

Related reference
Back to full list of DFH0STAT reports
The DFH0STAT reports
Interpreting these statistics
Interpreting temporary storage statistics
Full listing and DFHSTUP reports for these statistics
Temporary storage statistics
Appendix B. Shared temporary storage queue server statistics
[[ Contents Previous Page | Next Page Index ]]