Storage Reports

The Storage below 16MB report provides information on the use of MVS™ and CICS® virtual storage. It contains the information you need to understand your current use of virtual storage below 16MB and helps you to verify the size values used for the CDSA, UDSA, SDSA, and RDSA and the value set for the DSA limit. Figure 64 shows the format of the Storage Below 16MB Report. This report is produced using the EXEC CICS COLLECT STATISTICS STORAGE command. The statistics data is mapped by the DFHSMSDS DSECT. The field headings and contents are described in Table 188.

Figure 64. The Storage Report BELOW 16MB
Applid IYK2Z1V1  Sysid CJB3  Jobname CI07CJB1    Date 12/17/2004   Time 10:06:37                 CICS 6.4.0             PAGE     2

  Region size established from REGION= parameter. . . :       9,192K
Storage BELOW 16MB

  Private Area Region size below 16Mb . . . . . . . . :       9,192K      MVS PVT Size. . . . . . . . . :       9,216K
    Max LSQA/SWA storage allocated below 16Mb (SYS) . :         500K      MVS CSA Size / Allocated. . . :       3,656K /     828K
    Max User storage allocated below 16Mb (VIRT). . . :       5,420K      MVS SQA Size / Allocated. . . :       1,288K /   1,290K
    System Use. . . . . . . . . . . . . . . . . . . . :          20K
    RTM . . . . . . . . . . . . . . . . . . . . . . . :         250K
  Private Area storage available below 16Mb . . . . . :       3,002K
                                                                          Current DSA Limit . . . . . . :       5,120K
                                                                          Current Allocation for DSAs . :       1,024K
  VIRT minus Current DSA Limit. . . . . . . . . . . . :         300K      Peak Allocation for DSAs. . . :       1,024K
                                             CDSA             UDSA             SDSA             RDSA           Totals
  Current DSA Size. . . . . . . :             512K               0K             256K             256K           1,024K
  Current DSA Used. . . . . . . :             400K               0K               8K             180K             588K
  Current DSA Used as % of DSA. :              78%               0%               3%              70%              57% of DSA Size
* Peak DSA Used . . . . . . . . :             412K               0K               8K             180K
  Peak DSA Size . . . . . . . . :             512K               0K             256K             256K
  Cushion Size. . . . . . . . . :              64K               0K              64K              64K
  Free Storage (inc. Cushion) . :             112K               0K             248K              76K
* Peak Free Storage . . . . . . :             312K               0K             256K             256K
* Lowest Free Storage . . . . . :             100K               0K             248K              76K
  Largest Free Area . . . . . . :              80K               0K             248K              76K
  Largest Free Area as % of DSA :              15%               0%              96%              29%
  Largest Free/Free Storage . . :            0.71             0.00             1.00             1.00
  Current number of extents . . :               2                0                1                1                4
  Number of extents added . . . :               2                0                1                1                4
  Number of extents released. . :               0                0                0                0                0
  Getmain Requests. . . . . . . :             461                0                1               17
  Freemain Requests . . . . . . :             375                0                0                0
  Current number of Subpools. . :              31               12                7                4               54
  Add Subpool Requests. . . . . :              60               41                7                4
  Delete Subpool Requests . . . :              29               29                0                0
  Times no storage returned . . :               0                0                0                0
  Times request suspended . . . :               0                0                0                0
  Current requests suspended. . :               0                0                0                0
  Peak requests suspended . . . :               0                0                0                0
  Requests purged while waiting :               0                0                0                0
  Times Cushion released. . . . :               0                0                0                0                0
  Times Short-On-Storage. . . . :               0                0                0                0                0
  Total time Short-On-Storage . :  00:00:00.00000   00:00:00.00000   00:00:00.00000   00:00:00.00000
  Average Short-On-Storage time :  00:00:00.00000   00:00:00.00000   00:00:00.00000   00:00:00.00000
  Storage Violations. . . . . . :               0                0                0                0                0
  Access. . . . . . . . . . . . :            CICS             USER             USER         READONLY
  '*' indicates values reset on last DSA Size change

Table 188. Fields in the Storage Below 16MB Report
Field Heading Description
Region size established from REGION= parameter The region size established from the REGION= parameter in the JCL. If the region requested was greater than 16 megabytes, the region established resides above 16 megabytes, and this field will be a minimum value of 32 megabytes.
Storage BELOW 16MB
Private Area Region size below 16MB The private area size below 16MB expressed in Kbytes.
MVS PVT Size The maximum MVS private area (PVT) size below 16MB expressed in Kbytes.
MVS CSA Size / Allocated The MVS common system area (CSA) size and the amount of the MVS CSA allocated below 16MB expressed in Kbytes.
MVS SQA Size / Allocated The MVS system queue area (SQA) size and the amount of the MVS SQA allocated below 16MB expressed in Kbytes.
Max LSQA/SWA storage allocated below 16MB (SYS) The maximum amount of virtual storage allocated from the local system queue area (LSQA) and the SWA subpools below 16MB expressed in Kbytes.
Max User storage allocated below 16MB (VIRT) The maximum amount of virtual storage allocated from the user subpools below 16MB expressed in Kbytes.
System Use is an amount of virtual storage available for system use.
RTM is an amount of virtual storage available for use by the MVS recovery and termination manager included for calculation purposes, which could be allocated during a CICS region recovery and termination.
Private Area Storage available below 16MB The amount of storage below 16MB that could be allocated by increasing the DSALIM parameter or by MVS storage GETMAINs.
Current DSA Limit The current DSA Limit, expressed in Kbytes.

Source field: (SMSDSALIMIT / 1024)

Current Allocation for DSAs The current amount of storage allocated to the DSAs below 16MB, expressed in Kbytes. This value may be smaller or larger than the current DSA limit.

Source field: (SMSDSATOTAL / 1024)

VIRT minus Current DSA Limit The total amount of user storage allocated/used below 16MB minus the current DSA limit. This indicates the amount of user storage that is allocated below 16MB, and is not allocated to the DSA.

Source field: ((VIRT - SMSDSALIMIT) / 1024)

Peak Allocation for DSAs The peak amount of storage allocated to the DSAs below 16MB, expressed in Kbytes. This value may be smaller or larger than the current DSA limit.

Source field: (SMSHWMDSATOTAL / 1024)

Current DSA Size The current size of the CDSA, UDSA, SDSA, or the RDSA, expressed in Kbytes.

Source field: (SMSDSASZ / 1024)

Current DSA Used The current amount of storage used in this DSA expressed in Kbytes.

Source field: ((SMSDSASZ - SMSFSTG) / 1024)

Current DSA Used as % of DSA The current amount of storage used in this DSA expressed as a percentage of the current DSA size.

Source field: (((SMSDSASZ - SMSFSTG) / SMSDSASZ) * 100)

Peak DSA Used The peak amount of storage used in this DSA expressed in Kbytes.

Source field: (SMSHWMPS / 1024)

Peak DSA Size The peak size of the CDSA, UDSA, SDSA, or the RDSA, expressed in Kbytes.

Source field: (SMSHWMDSASZ / 1024)

Cushion Size The size of the cushion, expressed in Kbytes. The cushion forms part of the CDSA, UDSA, SDSA, or the RDSA, and is the amount of storage below which CICS goes SOS.

Source field: (SMSCSIZE / 1024)

Free Storage (inc. Cushion) The current amount of free storage in this DSA, expressed in Kbytes.

Source field: (SMSFSTG / 1024)

Peak Free Storage The peak amount of free storage in this DSA, expressed in Kbytes.

Source field: (SMSHWMFSTG / 1024)

Lowest Free Storage The lowest amount of free storage in this DSA, expressed in Kbytes.

Source field: (SMSLWMFSTG / 1024)

Largest Free Area The length of the largest contiguous free area in the CDSA, UDSA, SDSA, or RDSA, expressed in bytes.

Source field: (SMSLFA / 1024)

Largest Free Area as % of DSA The largest contiguous free area in the CDSA, UDSA, SDSA, or RDSA, expressed as a percentage of the current DSA Size.

Source field: ((SMSLFA / SMSDSASZ) * 100)

Largest Free/Free Storage is an indication of the storage fragmentation in this DSA. This value is calculated by dividing the "Largest Free Area" (SMSLFA) by the "Free storage" (SMSFSTG). If the ratio is small, this DSA is fragmented.

Source field: (SMSLFA / SMSFSTG)

Current number of extents The current number of extents allocated to this DSA.

Source field: SMSEXTS

Number of extents added The number of extents added to this DSA.

Source field: SMSEXTSA

Number of extents released The number of extents released from this DSA.

Source field: SMSEXTSR

Getmain Requests The number of GETMAIN requests from the CDSA, UDSA, SDSA, or RDSA.

Source field: SMSGMREQ

Freemain Requests The number of FREEMAIN requests from the CDSA, UDSA, SDSA, or RDSA.

Source field: SMSFMREQ

Current number of Subpools The current number of subpools (domain and task) in the CDSA, UDSA, SDSA, or RDSA.

Source field: SMSCSUBP

Add Subpool Requests The number of ADD_SUBPOOL requests to create a subpool (domain or task) from the CDSA, UDSA, SDSA, or RDSA.

Source field: SMSASR

Delete Subpool Requests The number of DELETE_SUBPOOL requests (domain or task) from the CDSA, UDSA, SDSA, or RDSA.

Source field: SMSDSR

Times no storage returned The number of times a GETMAIN request with SUSPEND(NO) returned the condition INSUFFICIENT_STORAGE.

Source field: SMSCRISS

Times request suspended The number of times a GETMAIN request with SUSPEND(YES) was suspended because of insufficient storage to satisfy the request at the moment.

Source field: SMSUCSS

Current requests suspended The number of GETMAIN requests currently suspended for storage.

Source field: SMSCSS

Peak requests suspended The peak number of GETMAIN requests suspended for storage.

Source field: SMSHWMSS

Requests purged while waiting The number of requests which were purged while suspended for storage.

Source field: SMSPWWS

Times cushion released The number of times a GETMAIN request caused the storage cushion to be released. The cushion is said to be released when the amount of free storage drops below the cushion size.

Source field: SMSCREL

Times Short-On-Storage The number of times CICS went SOS in this DSA (CDSA, UDSA, SDSA, or RDSA), where SOS means either that the cushion is currently in use and/or there is at least one task suspended for storage.

Source field: SMSSOS

Total time Short-On-Storage The accumulated time that CICS has been SOS in this DSA.

Source field: SMSTSOS

Average Short-On-Storage time The average time that CICS has been SOS in this DSA.

Source field: (SMSTSOS / SMSSOS)

Storage Violations The number of storage violations recorded in the CDSA, UDSA, SDSA, or the RDSA.

Source field: SMSSV

Access The type of access of the DSA. It will either be CICS, USER, or READONLY. If storage protection is not active, all storage areas will revert to CICS except those in the RDSA.
  • CICS - access is CICS key
  • USER - access is USER key
  • READONLY - access is read-only protection.

Source field: SMSACCESS

The Storage Above 16MB Report provides information on the use of MVS and CICS virtual storage. It contains the information you need to understand your current use of virtual storage above 16MB and helps you to verify the size values used for the ECDSA, EUDSA, ESDSA, and ERDSA and the value set for the EDSA limit. Figure 65 shows the format of the Storage Above 16MB Report. This report is produced using the EXEC CICS COLLECT STATISTICS STORAGE command. The statistics data is mapped by the DFHSMSDS DSECT. The field headings and contents are described in Table 189.

Figure 65. The Storage Report ABOVE 16MB
Applid IYK2Z1V2  Sysid CJB2  Jobname CI07CJB2    Date 12/17/2004   Time 08:44:37       CICS 6.4.0        PAGE     6
 
Storage ABOVE 16MB
 
  Private Area Region size above 16Mb . . . . . . . . :   1,837,056K      MVS EPVT Size . . . . . . . . :   1,837,056K
    Max LSQA/SWA storage allocated above 16Mb (SYS) . :      10,084K      MVS ECSA Size / Allocated . . :     151,020K /     29,320K
    Max User storage allocated above 16Mb (EXT) . . . :      71,704K      MVS ESQA Size / Allocated . . :      32,536K /     29,320K
  __________________________________________________________________
  Private Area storage available above 16Mb . . . . . :   1,755,268K
                                                                          Requests for MVS storage causing waits . :               0
                                                                          Total time waiting for MVS storage . . . :  00:00:00.00000
                                                                          Current EDSA Limit. . . . . . :      65,536K
  CICS Trace table size . . . . . . . . . . . . . . . :       2,000K      Current Allocation for EDSAs. :      17,408K
  EXT minus Current EDSA Limit. . . . . . . . . . . . :       6,168K      Peak Allocation for EDSAs . . :      17,408K
 
 
                                            ECDSA            EUDSA            ESDSA            ERDSA           Totals
  Current DSA Size. . . . . . . :           5,120K           1,024K           1,024K          10,240K          17,408K
  Current DSA Used. . . . . . . :           4,984K           1,024K              12K           9,648K          15,668K
  Current DSA Used as % of DSA. :              97%             100%               1%              94%              90% of EDSA Size
* Peak DSA Used . . . . . . . . :           5,044K           1,024K              12K           9,648K
  Peak DSA Size . . . . . . . . :           5,120K           1,024K           1,024K          10,240K
  Cushion Size. . . . . . . . . :             128K               0K             128K             256K
  Free Storage (inc. Cushion) . :             136K               0K           1,012K             592K
* Peak Free Storage . . . . . . :             292K           1,024K           1,024K             920K
* Lowest Free Storage . . . . . :              76K               0K           1,012K             592K
  Largest Free Area . . . . . . :             116K               0K           1,012K             452K
  Largest Free Area as % of DSA :               2%               0%              98%               4%
  Largest Free/Free Storage . . :            0.85             0.00             1.00             0.76
 
  Current number of extents . . :               5                1                1                9               16
  Number of extents added . . . :               0                0                1                0                1
  Number of extents released. . :               0                0                0                0                0
 
  Getmain Requests. . . . . . . :           1,618               24                3                4
  Freemain Requests . . . . . . :           1,503               23                0                0
 
  Current number of Subpools. . :             236                9                4                3              252
  Add Subpool Requests. . . . . :              12               10                0                0
  Delete Subpool Requests . . . :               9                9                0                0
 
  Times no storage returned . . :               0                0                0                0
  Times request suspended . . . :               0                0                0                0
  Current requests suspended. . :               0                0                0                0
  Peak requests suspended . . . :               0                0                0                0
  Requests purged while waiting :               0                0                0                0
 
  Times Cushion released. . . . :               0                0                0                0                0
  Times Short-On-Storage. . . . :               0                0                0                0                0
  Total time Short-On-Storage . :  00:00:00.00000   00:00:00.00000   00:00:00.00000   00:00:00.00000
  Average Short-On-Storage time :  00:00:00.00000   00:00:00.00000   00:00:00.00000   00:00:00.00000
 
  Storage Violations. . . . . . :               0                0                0                0                0
 
  Access. . . . . . . . . . . . :            CICS             USER             USER         READONLY
 
  '*' indicates values reset on last DSA Size change
 

Table 189. Fields in the Storage Above 16MB Report
Field Heading Description
Storage ABOVE 16MB
Private Area Region size above 16MB The private area size above 16MB expressed in Kbytes.
Max LSQA/SWA storage allocated above 16MB (SYS) The maximum amount of virtual storage allocated from the local system queue area (LSQA) and the SWA subpools above 16MB expressed in Kbytes.
MVS EPVT size The maximum extended MVS private area (EPVT) size above 16MB expressed in Kbytes.
MVS ECSA Size / Allocated The MVS extended common system area (ECSA) size and the amount of the MVS CSA allocated above 16MB expressed in Kbytes.
MVS ESQA Size / Allocated The MVS extended system queue (ESQA) size and the amount of the MVS SQA allocated above 16MB expressed in Kbytes.
Max User storage allocated above 16MB (EXT) The maximum amount of virtual storage allocated from the user subpools above 16MB expressed in Kbytes.
Private Area Storage available above 16MB The amount of storage above 16MB that could be allocated by increasing the EDSALIM parameter or by MVS storage GETMAINs.
Requests for MVS storage causing waits The number of MVS storage requests waiting for MVS storage above 16MB.

Source field: SMSMVSSTGREQWAITS

Total time waiting for MVS storage The total time MVS storage requests have spent waiting for MVS storage above 16MB.

Source field: SMSTIMEWAITMVS

Current EDSA Limit The current EDSA Limit, expressed in Kbytes.

Source field: (SMSEDSALIMIT / 1024)

CICS Trace table size The current size of the CICS trace table.

Source field: EXEC CICS INQUIRE TRACEDEST TABLESIZE

Current Allocation for EDSAs The current amount of storage allocated to the DSAs above 16MB, expressed in Kbytes. This value may be smaller or larger than the current EDSA limit.

Source field: (SMSEDSATOTAL / 1024)

EXT minus Current EDSA Limit The total amount of user storage allocated/used above 16MB minus the current EDSA limit. This indicates the amount of user storage that is allocated above 16MB, but is not allocated to the EDSA.

Source field: ((EXT - SMSEDSALIMIT) / 1024)

Peak Allocation for EDSAs The peak amount of storage allocated to the DSAs above 16MB, expressed in Kbytes. This value may be smaller or larger than the current EDSA limit.

Source field: (SMSHWMEDSATOTAL / 1024)

Current DSA Size The current size of the ECDSA, EUDSA, ESDSA, or the ERDSA, expressed in Kbytes.

Source field: (SMSDSASZ / 1024)

Current DSA Used The current amount of storage used in this DSA expressed in Kbytes.

Source field: ((SMSDSASZ - SMSFSTG) / 1024)

Current DSA Used as % of DSA The current amount of storage used in this DSA expressed as a percentage of the current DSA size.

Source field: (((SMSDSASZ - SMSFSTG) / SMSDSASZ) * 100)

Peak DSA Used The peak amount of storage used in this DSA expressed in Kbytes.

Source field: (SMSHWMPS / 1024)

Peak DSA Size The peak size of the ECDSA, EUDSA, ESDSA, or the ERDSA, expressed in Kbytes.

Source field: (SMSHWMDSASZ / 1024)

Cushion Size The size of the cushion, expressed in Kbytes. The cushion forms part of the ECDSA, EUDSA, ESDSA, or the ERDSA, and is the amount of storage below which CICS goes SOS.

Source field: (SMSCSIZE / 1024)

Free Storage (inc. Cushion) The current amount of free storage in this DSA, expressed in Kbytes.

Source field: (SMSFSTG / 1024)

Peak Free Storage The peak amount of free storage in this DSA, expressed in Kbytes.

Source field: (SMSHWMFSTG / 1024)

Lowest Free Storage The lowest amount of free storage in this DSA, expressed in Kbytes.

Source field: (SMSLWMFSTG / 1024)

Largest Free Area The length of the largest contiguous free area in the ECDSA, EUDSA, ESDSA, or ERDSA, expressed in Kbytes.

Source field: SMSLFA

Largest Free Area as % of DSA The largest contiguous free area in the ECDSA, EUDSA, ESDSA, or ERDSA, expressed as a percentage of the current DSA Size.

Source field: ((SMSLFA / SMSDSASZ) * 100)

Largest Free/Free Storage is an indication of the storage fragmentation in this DSA. This value is calculated by dividing the "Largest Free Area" (SMSLFA) by the "Free storage" (SMSFSTG). If the ratio is small, this DSA is fragmented.

Source field: (SMSLFA / SMSFSTG)

Current number of extents The current number of extents allocated to this DSA.

Source field: SMSEXTS

Number of extents added The number of extents added to this DSA.

Source field: SMSEXTSA

Number of extents released The number of extents released from this DSA.

Source field: SMSEXTSR

Getmain Requests The number of GETMAIN requests from the ECDSA, EUDSA, ESDSA, or ERDSA.

Source field: SMSGMREQ

Freemain Requests The number of FREEMAIN requests from the ECDSA, EUDSA, ESDSA, or ERDSA.

Source field: SMSFMREQ

Current number of Subpools The current number of subpools (domain and task) in the ECDSA, EUDSA, ESDSA, or ERDSA.

Source field: SMSCSUBP

Add Subpool Requests The number of ADD_SUBPOOL requests to create a subpool (domain or task) from the ECDSA, EUDSA, ESDSA, or ERDSA.

Source field: SMSASR

Delete Subpool Requests The number of DELETE_SUBPOOL requests (domain or task) from the ECDSA, EUDSA, ESDSA, or ERDSA.

Source field: SMSDSR

Times no storage returned The number of times a GETMAIN request with SUSPEND(NO) returned the condition INSUFFICIENT_STORAGE.

Source field: SMSCRISS

Times request suspended The number of times a GETMAIN request with SUSPEND(YES) was suspended because of insufficient storage to satisfy the request at the moment.

Source field: SMSUCSS

Current requests suspended The number of GETMAIN requests currently suspended for storage.

Source field: SMSCSS

Peak requests suspended The peak number of GETMAIN requests suspended for storage.

Source field: SMSHWMSS

Requests purged while waiting The number of requests which were purged while suspended for storage.

Source field: SMSPWWS

Times cushion released The number of times a GETMAIN request caused the storage cushion to be released. The cushion is said to be released when the amount of free storage drops below the cushion size.

Source field: SMSCREL

Times Short-On-Storage The number of times CICS went SOS in this DSA (ECDSA, EUDSA, ESDSA, or ERDSA), where SOS means either that the cushion is currently in use and/or there is at least one task suspended for storage.

Source field: SMSSOS

Total time Short-On-Storage The accumulated time that CICS has been SOS in this DSA.

Source field: SMSTSOS

Average Short-On-Storage time The average time that CICS has been SOS in this DSA.

Source field: (SMSTSOS / SMSSOS)

Storage Violations The number of storage violations recorded in the ECDSA, EUDSA, ESDSA, or the ERDSA.

Source field: SMSSV

Access The type of access of the page pool. It will either be CICS, USER, or READONLY. If storage protection is not active, all storage areas will revert to CICS except those in the ERDSA.
  • CICS - access is CICS key
  • USER - access is USER key
  • READONLY - access is read-only protection

Source field: SMSACCESS

Related reference
Back to full list of DFH0STAT reports
The DFH0STAT reports
Interpreting these statistics
Interpreting storage manager statistics
Full listing and DFHSTUP reports for these statistics
Storage manager statistics
[[ Contents Previous Page | Next Page Index ]]