Storage manager: Dynamic storage areas statistics
You can retrieve storage manager dynamic storage area statistics by using the EXEC CICS EXTRACT STATISTICS STORAGE system command. They are mapped by the DFHSMSDS DSECT.
The dynamic storage areas statistics are collected for each DSA.
Note: All the fields, except NOT IN THE DFHSETUP REPORT, are mapped by the SMSBODY DSECT within
the DFHSMSDS DSECT. The SMSBODY DSECT is repeated for each DSA in the CICS® region (SMSNPAGP).
| DFHSTUP name | Field name | Description |
|---|---|---|
| NOT IN THE DFHSTUP REPORT | SMSNPAGP | The number of DSAs in the CICS region.
There are 12 DSAs:
Reset characteristic: Not reset
|
| Header in DFHSTUP report | SMSDSANAME | Name of the DSA that this record
represents. The value can be CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA,
ESDSA, ERDSA, ETDSA, GCDSA, GUDSA, or GSDSA. Reset characteristic: Not reset
|
| NOT IN THE DFHSTUP REPORT | SMSDSAINDEX | A unique identifier for the dynamic
storage area that this subpool is allocated from. Values can be:
Reset characteristic: Not reset
|
| NOT IN THE DFHSTUP REPORT | SMSLOCN | The location of this DSA. The assembler
DSECT field name has the following values:
Reset characteristic: Not reset
|
| Current DSA Size | SMSDSASZ | The current size
of the DSA. For the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, ERDSA,
and ETDSA, this value is expressed in bytes. For the GCDSA, GUDSA,
and GSDSA, this value is expressed in megabytes. Reset characteristic: Not reset
|
| Peak DSA Size | SMSHWMDSASZ | The peak size
of the DSA since the last time that statistics were recorded. For
the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, ERDSA, and ETDSA,
this value is expressed in bytes. For the GCDSA, GUDSA, and GSDSA,
this value is expressed in megabytes. Reset characteristic: Reset to current value
|
| Cushion Size | SMSCSIZE | The size of the
cushion. The cushion forms part of each DSA and is the amount of storage
below which CICS goes short on storage (SOS). For the CDSA,
UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, ERDSA, and ETDSA, this value
is expressed in bytes. For the GCDSA, GUDSA, and GSDSA, this value
is expressed in megabytes. Reset characteristic: Not reset
|
| Free storage (inc. cushion) | SMSFSTG | The amount of free
storage in this DSA; that is, the number of free pages multiplied
by the page size. For the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA,
ERDSA, and ETDSA, the page size is 4 KB and this value is expressed
in bytes. For the GCDSA, GUDSA, and GSDSA, the page size is 1 MB and
this value is expressed in megabytes. Reset characteristic: Not reset
|
| Percentage free storage | The percentage of the storage that is free. This value is
calculated offline by DFHSTUP and is, therefore, not accessible from the EXEC CICS
EXTRACT STATISTICS command. This field does not apply to the GCDSA, GUDSA, and GSDSA. Reset characteristic: Not reset
|
|
| Peak free storage | SMSHWMFSTG | The peak amount
of free storage in this DSA since the last time that statistics were
recorded. Free storage is the number of free pages multiplied by the
page size. For the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, ERDSA,
and ETDSA, the page size is 4 KB and this value is expressed in bytes.
For the GCDSA, GUDSA, and GSDSA, the page size is 1 MB and this value
is expressed in megabytes. Reset characteristic: Reset to current value
|
| Lowest free storage | SMSLWMFSTG | The smallest
amount of free storage in this DSA since the last time that statistics
were recorded. Free storage is the number of free pages multiplied
by the page size. For the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA,
ERDSA, and ETDSA, the page size is 4 KB and this value is expressed
in bytes. For the GCDSA, GUDSA, and GSDSA, the page size is 1 MB and
this value is expressed in megabytes. Reset characteristic: Reset to current value
|
| Largest free area | SMSLFA | The length of the largest contiguous
free area in this DSA. For the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA,
ESDSA, ERDSA, and ETDSA, this value is expressed in bytes. For the
GCDSA, GUDSA, and GSDSA, this value is expressed in megabytes. For
an indication of the storage fragmentation in this DSA, compare this
value with Free storage(SMSFSTG) in the DSA. If the ratio is large, this DSA is fragmented. Reset characteristic: Not reset
|
| Getmain Requests | SMSGMREQ | The number of GETMAIN
requests from the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, ERDSA,
ETDSA, GCDSA, GUDSA, or GSDSA. Reset characteristic: Reset to zero
|
| Freemain Requests | SMSFMREQ | The number of FREEMAIN
requests from the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, ERDSA,
ETDSA, GCDSA, GUDSA, or GSDSA. Reset characteristic: Reset to zero
|
| Add Subpool Requests | SMSASR | The number of ADD_SUBPOOL
requests to create a subpool (domain or task) from the CDSA, UDSA,
SDSA, RDSA, ECDSA, EUDSA, ESDSA, ERDSA, ETDSA, GCDSA, GUDSA, or GSDSA. Reset characteristic: Reset to zero
|
| Delete Subpool Requests | SMSDSR | The number of DELETE_SUBPOOL
requests (domain or task) from the CDSA, UDSA, SDSA, RDSA, ECDSA,
EUDSA, ESDSA, ERDSA, ETDSA, GCDSA, GUDSA, or GSDSA. Reset characteristic: Reset to zero |
| Current no of Subpools | SMSCSUBP | The current number
of subpools (domain and task) in the CDSA, UDSA, SDSA, RDSA, ECDSA,
EUDSA, ESDSA, ERDSA, ETDSA, GCDSA, GUDSA, or GSDSA. Reset characteristic: Not reset
|
| Times no storage returned | SMSCRISS | The number of times
a GETMAIN request with SUSPEND(NO) returned the condition INSUFFICIENT_STORAGE. Reset characteristic: Reset to zero
|
| Times request suspended | SMSUCSS | The number of times
a GETMAIN request with SUSPEND(YES) was suspended because of insufficient
storage to satisfy the request at that moment. Reset characteristic: Reset to zero
|
| Current suspended | SMSCSS | The number of GETMAIN
requests that are currently suspended for storage. Reset characteristic: Not reset
|
| Peak requests suspended | SMSHWMSS | The peak number
of GETMAIN requests that were suspended for storage. Reset characteristic: Reset to current value
|
| Purged while waiting | SMSPWWS | The number of requests
that were purged while suspended for storage. Reset characteristic: Reset to zero
|
| Times cushion released | SMSCREL | The number of times
a GETMAIN request caused the storage cushion to be released. The cushion
is said to be released when the number of free pages drops below the
number of pages in the cushion and there are no more free extents
available to increase the size of this DSA. Reset characteristic: Reset to zero
|
| Times went short on storage | SMSSOS | The number of times CICS went
SOS in this DSA, where SOS means that the cushion is currently in
use, or at least one task is suspended for storage, or both. This
field applies to CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, ERDSA,
ETDSA, GCDSA, GUDSA, and GSDSA. Reset characteristic: Reset to zero
|
| Total time SOS | SMSTSOS | The accumulated
time that CICS has been SOS in this DSA. The DFHSTUP
report expresses this time as days:hours:minutes: seconds.decimals.
The DSECT field contains the time as a store clock (STCK) value. Reset characteristic: Reset to zero
|
| Storage violations | SMSSV | The number of storage
violations recorded in the DSA. Reset characteristic: Reset to zero
|
| Access | SMSACCESS | The type of access
of the DSA. Values are CICS, USER, READONLY, or TRUSTED. If storage
protection is not active, storage areas revert to an access type of
CICS, except for those in the RDSA or ERDSA.
Reset characteristic: Not reset
|
| Current extents | SMSEXTS | The number of extents
currently allocated to this DSA. Reset characteristic: Not reset
|
| Extents added | SMSEXTSA | The number of extents
added to the DSA since the last time statistics were recorded. Reset characteristic: Reset to zero
|
| Extents released | SMSEXTSR | The number of extents
that were released from the DSA since the last time statistics were
recorded. Reset characteristic: Reset to zero
|