These statistics are produced to aid all aspects of storage management.
Note that the terms 'DSA' (dynamic storage area), and 'pagepool', are interchangeable.
This section contains the following statistics:
These statistics can be accessed online using the EXEC CICS® COLLECT STATISTICS STORAGE command, and are mapped by the DFHSMDDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.
DFHSTUP name | Field name | Description |
---|---|---|
Subpool Name | SMDSPN | is the unique 8-character name of the domain subpool. The values of the domain subpool field are described in Appendix F. MVS and CICS virtual
storage.
Reset characteristic: Not reset
|
NOT IN THE DFHSTUP REPORT | SMDETYPE | The assembler DSECT field name has the value X'01' or X'02', indicating whether all the elements in the subpool are fixed length or variable length. For further information about subpool elements, see Appendix F. MVS and CICS virtual
storage.
Reset characteristic: Not reset
|
NOT IN THE DFHSTUP REPORT | SMDFLEN | is the length of each subpool element (applicable to FIXED length subpools only). For further information about subpool elements, see Appendix F. MVS and CICS virtual
storage.
Reset characteristic: Not reset
|
NOT IN THE DFHSTUP REPORT | SMDELCHN | The assembler DSECT field name has the value X'01' or X'02', indicating whether or not SM maintains an element chain for the subpool with the addresses and lengths of each element. For further information about element chains, see Appendix F. MVS and CICS virtual
storage.
Reset characteristic: Not reset
|
NOT IN THE DFHSTUP REPORT | SMDBNDRY | is the boundary on which each element is aligned. This is a power of 2 in the range 8 through 4096 bytes. For further information about boundaries, see Appendix F. MVS and CICS virtual
storage.
Reset characteristic: Not reset
|
NOT IN THE DFHSTUP REPORT | SMDLOCN | The storage location of this domain subpool. The assembler DSECT field name has the following values:
Reset characteristic: Not reset
|
Location | SMDDSANAME | Name of the DSA that the domain subpool is allocated from. Values can be 'CDSA', 'SDSA', 'RDSA', 'ECDSA', 'ESDSA', and 'ERDSA'.
Reset characteristic: Not reset
|
NOT IN THE DFHSTUP REPORT | SMDDSAINDEX | A unique identifier for the dynamic storage area that this subpool is allocated from. Values can be
Reset characteristic: Not reset
|
Access | SMDACCESS | is the type of access of the subpool. It will be either CICS, USER, or READONLY. If storage protection is not active, all storage areas will revert to CICS except those in the ERDSA.
Reset characteristic: Not reset
|
NOT IN THE DFHSTUP REPORT | SMDIFREE | is the size of the initial free area for the subpool (which may be zero), expressed in bytes. For further information about the initial free area, see Appendix F. MVS and CICS virtual
storage.
Reset characteristic: Not reset
|
Getmain Requests | SMDGMREQ | is the number of GETMAIN requests for the subpool.
Reset characteristic: Reset to zero
|
Freemain Requests | SMDFMREQ | is the number of FREEMAIN requests for the subpool.
Reset characteristic: Reset to zero
|
Current Elements | SMDCELEM | is the current number of storage elements in the subpool.
Reset characteristic: Not reset
|
Current Elem Stg | SMDCES | is the sum of the lengths of all the elements in the subpool, expressed in bytes.
Reset characteristic: Not reset
|
Current Page Stg | SMDCPS | is the space taken by all the pages allocated to the subpool, expressed in bytes.
Reset characteristic: Not reset
|
Peak Page Stg | SMDHWMPS | is the peak page storage allocated to support the storage requirements of this subpool.
Reset characteristic: Reset to current value
|
These statistics can be accessed online using the EXEC CICS COLLECT STATISTICS STORAGE command. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.
These statistics are collected for each DSA. They are available online, and are mapped by the DFHSMSDS DSECT.
DFHSTUP name | Field name | Description |
---|---|---|
Storage protection | SMSSTGPROT | X'01' active
X'00' not active Reset characteristic: Not reset
|
Transaction isolation | SMSTRANISO | X'01' active
X'00' not active Reset characteristic: Not reset
|
Reentrant programs | SMSRENTPGM | X'01' protect. RDSA and ERDSA obtained from key 0 storage.
X'00' no protect. RDSA and ERDSA obtained from key 8 storage. Reset characteristic: Not reset
|
Current DSA limit | SMSDSALIMIT | Current DSA limit value.
Reset characteristic: Not reset
|
Current DSA total | SMSDSATOTAL | Total amount of storage currently allocated to the DSAs below the line. This value may be smaller or larger than SMSDSALIMIT.
Reset characteristic: Not reset
|
Peak DSA total | SMSHWMDSATOTAL | The peak amount of storage allocated to the DSAs below the line. This value may be smaller or larger than SMSDSALIMIT.
Reset characteristic: Reset to current value
|
Current EDSA limit | SMSEDSALIMIT | Current EDSA limit.
Reset characteristic: Not reset
|
Current EDSA total | SMSEDSATOTAL | Total amount of storage currently allocated to the DSAs above the line. This value may be smaller or larger than SMSEDSALIMIT.
Reset characteristic: Not reset
|
Peak EDSA total | SMSHWMESDATOTAL | The peak amount of storage allocated to the DSAs above the line. This value may be smaller or larger than SMSEDSALIMIT.
Reset characteristic: Reset to current value
|
MVS™ storage request waits | SMSMVSSTGREQWAITS | The total number of MVS storage requests that have waited for MVS storage above 16MB.
Reset characteristic: Reset to zero
|
Total time waiting for MVS storage | SMSTIMEWAITMVS | The total time that MVS storage requests have spent waiting for MVS storage above 16MB.
Reset characteristic: Reset to zero
|
These statistics can be accessed online using the EXEC CICS COLLECT STATISTICS STORAGE command. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.
These statistics are collected for each DSA, and are mapped by the DFHSMSDS DSECT.
DFHSTUP name | Field name | Description |
---|---|---|
Current unique subspace users | SMSUSSCUR | Current number of unique subspace users. Number of tasks currently allocated a unique subspace.
|
Total unique subspace users | SMSUSSCUM | Total number of tasks that have been allocated a unique subspace.
|
Peak unique subspace users | SMSUSSHWM | The peak number of tasks concurrently allocated a unique subspace.
|
Current common subspace users | SMSCSSCUR | Number of tasks currently allocated to the common subspace
|
Total common subspace users | SMSCSSCUM | Total number of tasks allocated to the common subspace
|
Peak common subspace users | SMSCSSHWM | The peak number of tasks concurrently allocated to the common subspace.
|
These statistics can be accessed online using the EXEC CICS COLLECT STATISTICS STORAGE command. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.
These statistics are collected for each DSA. They are available online, and are mapped by the DFHSMSDS DSECT.
DFHSTUP name | Field name | Description |
---|---|---|
NOT IN THE DFHSTUP REPORT | SMSNPAGP | is the number of DSAs in the CICS region. There are eight DSAs: the CDSA (CICS dynamic storage area), the UDSA (user dynamic storage area), the SDSA (shared dynamic storage area), the RDSA (read-only dynamic storage area), the ECDSA (extended CICS dynamic storage area), the EUDSA (extended user dynamic storage area), the ESDSA (extended shared dynamic storage area), and the ERDSA (extended read-only dynamic storage area).
Reset characteristic: not reset
|
Note:
The following fields are mapped by the SMSBODY DSECT within the DFHSMSDS DSECT. The SMSBODY DSECT is repeated for each DSA in the CICS region (SMSNPAGP). |
||
|
||
Header in DFHSTUP report | SMSDSANAME | Name of the DSA that this record represents. Values can be 'CDSA', 'UDSA', 'SDSA', 'RDSA', 'ECDSA', 'EUDSA', 'ESDSA', and 'ERDSA'.
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 | is the location of this DSA. The assembler DSECT field name has the following values:
|
Current DSA Size | SMSDSASZ | is the current size of the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA, expressed in bytes.
Reset characteristic: Not reset
|
Peak DSA Size | SMSHWMDSASZ | is the peak size of the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA, expressed in bytes since that last time that statistics were recorded.
Reset characteristic: Reset to current value
|
Cushion Size | SMSCSIZE | is the size of the cushion, expressed in bytes. The cushion forms part of the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA, and is the amount of storage below which CICS goes SOS.
Reset characteristic: Not reset
|
Free storage (inc. cushion) | SMSFSTG | is the amount of free storage in this DSA, that is the number of free pages multiplied by the page size (4K), expressed in bytes.
Reset characteristic: Not reset
|
Percentage free storage | is the percentage of the storage that is free. This value is calculated offline by DFHSTUP and is, therefore, not accessible via the EXEC CICS COLLECT STATISTICS command.
Reset characteristic: Not reset
|
|
Peak free storage | SMSHWMFSTG | is the largest amount of storage that is free since the last time that statistics were recorded.
Reset characteristic: Not reset
|
Lowest free storage | SMSLWMFSTG | is the smallest amount of storage that is free since the last time that statistics were recorded.
Reset characteristic: Reset to current value
|
Largest free area | SMSLFA | is the length of the largest contiguous free area in the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA, expressed in bytes. To get 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 | is the number of GETMAIN requests from the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA.
Reset characteristic: Reset to zero
|
Freemain Requests | SMSFMREQ | is the number of FREEMAIN requests from the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA.
Reset characteristic: Reset to zero
|
NOT IN THE DFHSTUP REPORT | SMSASR | is the number of ADD_SUBPOOL requests to create a subpool (domain or task) from the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA.
Reset characteristic: Reset to zero
|
NOT IN THE DFHSTUP REPORT | SMSDSR | is the number of DELETE_SUBPOOL requests (domain or task) from the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA.
Reset characteristic: Reset to zero
|
NOT IN THE DFHSTUP REPORT | SMSCSUBP | is the current number of subpools (domain and task) in the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA.
Reset characteristic: Not reset
|
Times no storage returned | SMSCRISS | is the number of times a GETMAIN request with SUSPEND(NO) returned the condition INSUFFICIENT_STORAGE.
Reset characteristic: Reset to zero
|
Times request suspended | SMSUCSS | is the number of times a GETMAIN request with SUSPEND(YES) was suspended because of insufficient storage to satisfy the request at the moment.
Reset characteristic: Reset to zero
|
Current suspended | SMSCSS | is the number of GETMAIN requests currently suspended for storage.
Reset characteristic: Not reset
|
Peak requests suspended | SMSHWMSS | is the peak number of GETMAIN requests suspended for storage.
Reset characteristic: Reset to current value
|
Purged while waiting | SMSPWWS | is the number of requests which were purged while suspended for storage.
Reset characteristic: Reset to zero
|
Times cushion released | SMSCREL | is 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 | is the number of times CICS went SOS in this DSA (CDSA, UDSA, SDSA, RDSA, 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.
Reset characteristic: Reset to zero
|
Total time SOS | SMSTSOS | is the accumulated time that CICS has been SOS in this DSA. The DFHSTUP report expresses this time as days:hours:minutes: seconds.decimals; however, the DSECT field contains the time as a store clock (STCK) value.
Reset characteristic: Reset to zero
|
Storage violations | SMSSV | is the number of storage violations recorded in the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, and the ERDSA.
|
Access | SMSACCESS | is the type of access of the DSA. It will be either CICS, USER, or READONLY. If storage protection is not active, all storage areas will revert to CICS except those in the ERDSA.
Reset characteristic: Not reset
|
Current extents | SMSEXTS | is the number of extents currently allocated to a specified dynamic storage area.
Reset characteristic: Not reset
|
Extents added | SMSEXTSA | is the number of extents added to a dynamic storage area since the last time statistics were recorded.
Reset characteristic: Not reset
|
Extents released | SMSEXTSR | is the number of extents which have been released from a dynamic storage area since the last time statistics were recorded.
Reset characteristic: Not reset
|
These statistics cannot be accessed online using the EXEC CICS COLLECT STATISTICS command. They are produced only for offline processing (written to SMF).
These statistics are collected for each DSA. They are mapped by the DFHSMTDS DSECT.
Although task subpools are dynamically created and deleted for each task in the system, these statistics are the sum of all task subpool figures for the task related DSAs (CDSA, UDSA, ECDSA, and EUDSA). If further granularity of task storage usage is required, use the performance class data of the CICS monitoring facility.
DFHSTUP name | Field name | Description |
---|---|---|
NOT IN THE DFHSTUP REPORT | SMTNTASK | is the number of task subpools in the CICS region.
Reset characteristic: not reset
|
DSA Name | SMTDSANAME | Name of the dynamic storage area from which this task storage has been allocated. Values can be 'CDSA', 'UDSA', 'ECDSA',and 'EUDSA'.
Reset characteristic: not reset
|
NOT IN THE DFHSTUP REPORT | SMTDSAINDEX | A unique identifier for the dynamic storage area that these statistics refer to. Values can be:
Reset characteristic: not reset
|
NOT IN THE DFHSTUP REPORT | SMTLOCN | tells you whether the dynamic storage area is above or below the line.
Reset characteristic: not reset
|
Access | SMTACCESS | is the type of access of the subpool. It will be either CICS or USER.
Reset characteristic: not reset
|
Getmain Requests | SMTGMREQ | is the number of task subpool GETMAIN requests from this dynamic storage area.
Reset characteristic: reset to zero
|
Freemain Requests | SMTFMREQ | is the number of task subpool FREEMAIN requests from this dynamic storage area.
Reset characteristic: reset to zero
|
Current Elements | SMTCNE | is the number of elements in all the task subpools in this dynamic storage area.
Reset characteristic: not reset
|
Current Elem Stg | SMTCES | is the sum of the storage occupied by all elements in task subpools within this dynamic storage area, expressed in bytes.
Reset characteristic: not reset
|
Current Page Stg | SMTCPS | is the sum of the storage in all pages allocated to task subpools within this dynamic storage area, expressed in bytes.
Reset characteristic: not reset
|
Peak Page Stg | SMTHWMPS | is the peak page storage allocated to support task storage activity in that dynamic storage area.
Reset characteristic: reset to current value
|
Summary statistics are not available online.
DFHSTUP name | Description |
---|---|
Subpool Name | is the unique 8-character name of the domain subpool. The values of the domain subpool field are described in Appendix F. MVS and CICS virtual
storage.
|
Location | is the indicator of the subpool location (CDSA, SDSA, RDSA, ECDSA, ESDSA, or ERDSA).
|
Access | is the type of access of the subpool. It will be either CICS, USER, or READONLY. If storage protection is not active, all storage areas will revert to CICS except those in the ERDSA.
|
Getmain Requests | is the total number of GETMAIN requests for the subpool.
|
Freemain Requests | is the total number of FREEMAIN requests for the subpool.
|
Peak Elements | is the peak number of storage elements in the subpool.
|
Peak Elem Stg | is the peak amount of element storage in the subpool, expressed in bytes.
|
Peak Page Stg | is the peak amount of page storage in the subpool, expressed in bytes.
|
Summary statistics are not available online.
DFHSTUP name | Description |
---|---|
Storage protection | shows whether storage protection is 'ACTIVE' or 'NOT ACTIVE'.
|
Transaction isolation | shows whether transaction isolation is 'ACTIVE' or 'NOT ACTIVE'.
|
Reentrant programs | shows whether write protection for reentrant programs is enabled (PROTECT -- so RDSA and ERDSA are obtained from key 0 storage) or disabled (NOPROTECT -- so RDSA and ERDSA are obtained from key 8 storage).
|
Current DSA limit | is the limit of the CICS dynamic storage areas as defined by the DSALIM system initialization parameter.
|
Current DSA total | is the total amount of storage currently allocated to the DSAs below the line. This value may be smaller or larger than the value for 'Current DSA limit'.
|
Peak DSA total | is the peak amount of storage allocated to the DSAs below the line. This value may be smaller or larger than the value for 'Current DSA limit'.
|
Current EDSA limit | is the limit of the CICS extended dynamic storage areas as defined by the EDSALIM system initialization parameter.
|
Current EDSA total | is the total amount of storage currently allocated to the DSAs above the line. This value may be smaller or larger than the value for 'Current EDSA limit'.
|
Peak EDSA total | is the peak amount of storage allocated to the DSAs above the line. This value may be smaller or larger than the value for 'Current EDSA limit'.
|
MVS storage request waits | The total number of MVS storage requests that have waited for MVS storage above 16MB.
|
Total time waiting for MVS storage | The total time that MVS storage requests have spent waiting for MVS storage above 16MB.
|
Summary statistics are not available online.
DFHSTUP name | Description |
---|---|
Total unique subspace users | The total number of tasks that have been allocated a unique subspace.
|
Peak unique subspace users | The peak number of tasks concurrently allocated a unique subspace.
|
Total common subspace users | The total number of tasks allocated to the common subspace.
|
Peak common subspace users | The peak number of tasks concurrently allocated to the common subspace.
|
Summary statistics are not available online.
DFHSTUP name | Description |
---|---|
Current DSA size | is the total size of the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA, expressed in bytes.
|
Peak DSA size | is the peak size of the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA, expressed in bytes.
|
Cushion size | is the size of the cushion, expressed in bytes. The cushion forms part of the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA, and is the amount of storage below which CICS goes SOS.
|
Peak free storage | is the peak amount of free storage in this DSA, that is the number of free pages multiplied by the page size (4K), expressed in bytes.
|
Lowest free storage | is the lowest amount of free storage encountered over the summarised period in this DSA, that is the number of free pages multiplied by the page size (4K), expressed in bytes.
|
Getmain requests | is the total number of GETMAIN requests from the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA.
|
Freemain requests | is the total number of FREEMAIN requests from the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, or ERDSA.
|
Times no storage returned | is the total number of times a GETMAIN request with SUSPEND(NO) returned the condition INSUFFICIENT_STORAGE.
|
Times request suspended | is the total number of times a GETMAIN request with SUSPEND(YES) was suspended because of insufficient storage to satisfy the request at the moment.
|
Peak requests suspended | is the peak number of GETMAIN requests suspended for storage.
|
Purged while waiting | is the total number of requests which were purged while suspended for storage.
|
Times cushion released | is the total 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.
|
Times went short on storage | is the total number of times CICS went SOS in this DSA (CDSA, UDSA, SDSA, RDSA, 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.
|
Total time SOS | is the accumulated time that CICS has been SOS in this DSA. The DFHSTUP report expresses this time as days:hours:minutes:seconds.decimals.
|
Storage violations | is the total number of storage violations recorded in the CDSA, UDSA, SDSA, RDSA, ECDSA, EUDSA, ESDSA, and ERDSA.
|
Access | is the type of access of the DSA. It will be either CICS, USER, or READONLY. If storage protection is not active, all storage areas will revert to CICS except those in the ERDSA.
|
Current extents | is the number of extents currently allocated to the DSA.
|
Extents added | is the number of extents added to the DSA since the last time statistics were recorded.
|
Extents released | is the number of extents which have been released from the DSA since the last time statistics were recorded.
|
Summary statistics are not available online.
The following fields are mapped by the SMTBODY DSECT within the DFHSMTDS DSECT. The SMTBODY DSECT is repeated for each task subpool in the CICS region (SMTNTASK).
DFHSTUP name | Description |
---|---|
DSA Name | tells you whether the dynamic storage area is in the CDSA, UDSA, ECDSA, or EUDSA.
|
Access | is the type of access of the subpool. It will be either CICS, or USER.
|
Getmain Requests | is the total number of task subpool GETMAIN requests from this dynamic storage area.
|
Freemain Requests | is the total number of task subpool FREEMAIN requests from this dynamic storage area.
|
Peak Elements | is the peak of the current number of elements in all the task subpools in this dynamic storage area.
|
Peak Elem Stg | is the peak of the current amount of storage occupied by all elements in task subpools within this dynamic storage area, expressed in bytes.
|
Peak Page Stg | is the peak amount of storage in all pages allocated to task subpools within this dynamic storage area, expressed in bytes.
|