Storage manager: Global statistics

You can retrieve storage manager global statistics by using the EXEC CICS EXTRACT STATISTICS STORAGE command. They are mapped by the DFHSMSDS DSECT.

Storage manager: Global statistics for DSA

These statistics are collected for each dynamic storage area (DSA).

Table 1. Storage manager: Global statistics for DSA
DFHSTUP name Field name Description
Storage protection SMSSTGPROT
Whether storage protection is active:
  • X'01' active
  • X'00' not active

Reset characteristic: Not reset
Transaction isolation SMSTRANISO
Whether transaction isolation is active:
  • X'01' active
  • X'00' not active

Reset characteristic: Not reset
Reentrant programs SMSRENTPGM
Whether write protection for reentrant programs is enabled:
  • X'01' PROTECT

    RDSA and ERDSA are obtained from key 0 storage.

  • X'00' NOPROTECT

    RDSA and ERDSA are obtained from key 8 storage.

Reset characteristic: Not reset
Current DSA limit SMSDSALIMIT The current limit of the CICS® dynamic storage areas, as defined by the DSALIM system initialization parameter.

Reset characteristic: Not reset
Current DSA total SMSDSATOTAL The total amount of storage currently allocated to the DSAs below 16 MB (below the line). This value might be smaller or larger than Current DSA limit.

Reset characteristic: Not reset
Peak DSA total SMSHWMDSATOTAL The peak amount of storage allocated to the DSAs below 16 MB (below the line). This value might be smaller or larger than Current DSA limit.

Reset characteristic: Reset to current value
Current EDSA limit SMSEDSALIMIT The current limit of the CICS extended dynamic storage areas, as defined by the EDSALIM system initialization parameter.

Reset characteristic: Not reset
Current EDSA total SMSEDSATOTAL The total amount of storage currently allocated to the DSAs above 16 MB but below 2 GB (above the line). This value might be smaller or larger than Current EDSA limit.

Reset characteristic: Not reset
Peak EDSA total SMSHWMESDATOTAL The peak amount of storage allocated to the DSAs above 16 MB but below 2 GB (above the line). This value might be smaller or larger than Current EDSA limit.

Reset characteristic: Reset to current value
MEMLIMIT size SMSMEMLIMIT The value of the z/OS® MEMLIMIT parameter, which limits the amount of 64-bit storage for the CICS region. This value can be in megabytes, gigabytes, terabytes, petabytes, or exabytes, depending on size. A value of NOLIMIT indicates that no upper limit is imposed.

Reset characteristic: Not reset
MEMLIMIT set by SMSMEMLIMITSRC
The source of the MEMLIMIT value:
  • SMFPRM indicates that MEMLIMIT is set by SYS1.PARMLIB(SMFPRMxx).
  • JCL indicates that MEMLIMIT is set by JCL.
  • REGION indicates that MEMLIMIT is set to NOLIMIT because REGION=0M is specified in JCL.
  • IEFUSI indicates that MEMLIMIT is set by the z/OS installation exit IEFUSI.

Reset characteristic: Not reset
GETSTOR request size SMSGETSTORSIZE The GETSTOR request size.

Reset characteristic: Not reset
Current Address Space active SMSASACTIVE The current address space available above the bar.

Reset characteristic: Not reset
Peak Address Space active SMSHWMASACTIVE The peak amount of address space available above the bar.

Reset characteristic: Reset to current value
Current GDSA active SMSGDSAACTIVE The current storage in use above the bar.

Reset characteristic: Not reset
Peak GDSA active SMSHWMGDSAACTIVE The peak amount of storage in use above the bar.

Reset characteristic: Reset to current value
MVS storage request waits SMSMVSSTGREQWAITS This field is not populated.

Reset characteristic: Reset to zero
Total time waiting for MVS storage SMSTIMEWAITMVS This field is not populated.

Reset characteristic: Reset to zero
Bytes Allocated to Private Memory Objects SMSLVABYTES The number of bytes allocated from large virtual memory in private memory objects. 1

Reset characteristic: Not reset
Bytes Hidden within Private Memory Objects SMSLVHBYTES The number of bytes hidden in large virtual memory private memory objects. 1

Reset characteristic: Not reset
Peak Bytes Usable within Private Memory Objects SMSLVGBYTES The high-water mark of usable bytes in large virtual memory private memory objects. 1

Reset characteristic: Not reset
Number of Private Memory Objects SMSLVNMEMOBJ The number of private memory objects allocated. 1

Reset characteristic: Not reset
Auxiliary Slots backing Private Memory Objects SMSHVAUXSLOTS The number of auxiliary storage slots that are used to back 64-bit private memory objects. 1

Reset characteristic: Not reset
HWM Auxiliary Slots backing Private Memory Objects SMSHVGAUXSLOTS The high-water mark of auxiliary storage slots that are used to back 64-bit private memory objects. 1

Reset characteristic: Not reset
Real Frames backing Private Memory Objects SMSHVPAGESINREAL The number of real storage frames that are used to back 64-bit private memory objects. 1

Reset characteristic: Not reset
HWM Real Frames backing Private Memory Objects SMSHVGPAGESINREAL The high-water mark for the number of real storage frames that are used to back 64-bit private memory objects. 1

Reset characteristic: Not reset
Number of Large Memory Objects Allocated SMSLARGEMEMOBJ The number of large memory objects allocated by this address space. 1

Reset characteristic: Not reset
Number of Large Pages backed in Real Storage SMSLARGEPAGESINREAL The number of large pages (1 MB pages) backed in real storage owned by this address space. 1

Reset characteristic: Not reset
Shared Bytes from Large Memory Objects SMSLVSHRBYTES The number of shared bytes allocated from high virtual memory. 1

Reset characteristic: Not reset
Peak Shared Bytes within Large Memory Objects SMSLVSHRGBYTES The high-water mark for the number of shared bytes in large virtual memory objects. 1

Reset characteristic: Not reset
Number of Shared Memory Objects SMSLVSHRNMEMOBJ The number of shared memory objects allocated.1

Reset characteristic: Not reset
Number of FROMGUARD Failures SMSFROMGUARDFAIL The number of times that a request for 64-bit storage has failed, where the request uses the z/OS IARV64 macro with the REQUEST=CHANGEGUARD, CONVERT=FROMGUARD parameters. 1

Reset characteristic: Reset to zero
FROMGUARD Failure size SMSFROMGUARDFAILSIZE The size of the largest request for 64-bit storage that has failed, in bytes, where the request uses the z/OS IARV64 macro with the REQUEST=CHANGEGUARD, CONVERT=FROMGUARD parameters. 1

Reset characteristic: Reset to zero
Current GDSA allocated SMSGDSAALLOC The total amount of storage currently allocated to the DSAs above the bar.

Reset characteristic: Not reset
Peak GDSA allocated SMSHWMGDSAALLOC The peak amount of storage allocated to the DSAs above the bar.

Reset characteristic: Reset to current value
Note:
  1. For more information about the memory that this statistic refers to, see Using the 64-bit Address Space in the z/OS MVS Programming: Extended Addressability Guide.

Storage manager: Global statistics for user region, extended user region and MEMLIMIT storage monitoring

CICS monitors unallocated z/OS storage available in the following storage areas in the CICS address space, and collects statistics on the state of unallocated z/OS storage and occurrences of SOS conditions.
  • z/OS user region storage
  • z/OS extended user region storage
  • 6.2 and later z/OS MEMLIMIT storage

For details about CICS monitoring of unallocated z/OS storage and what these SOS conditions mean, see Monitoring unallocated z/OS storage for CICS.

Table 2. Storage manager: Global statistics for user region, extended user region and MEMLIMIT storage monitoring
DFHSTUP name Field name Description
Last monitor sample time SMSMVSMONSAMPLELASTTIMELOCAL The local time the CICS z/OS storage monitor system task last sampled z/OS storage

Reset characteristic: Not reset
NOT IN THE DFHSTUP REPORT SMSMVSMONSAMPLELASTTIMEGMT The GMT when the CICS z/OS storage monitor system task last sampled z/OS storage

Reset characteristic: Not reset
User region storage    
State SMSMVS24STATE The state of the z/OS user region storage
Valid values are as follows:
NORMAL
No storage problems have been detected.
SOS
One or more of the SOS thresholds has been breached.
CONSTRAINED
None of the SOS thresholds is currently breached, but CICS has not reset the SOS state. CICS delays the resetting of the SOS state for a short period of time to allow for the region to recover from the SOS event.

Reset characteristic: Not reset
6.2 and later Times SOS SMSMVS24SOSCOUNT The number of times the z/OS user region storage was in SOS state

Reset characteristic: Reset to zero
6.2 and later SOS duration SMSMVS24SOSTIME The accumulated amount of time that CICS has been SOS in the z/OS user region storage

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
Current unallocated total SMSMVS24TOTALUNALLOC The current total amount of unallocated user region storage

Reset characteristic: Not reset
LWM unallocated total SMSMVS24TOTALUNALLOCLWM Low water mark (the lowest) of the total amount of unallocated user region storage that was recorded

Reset characteristic: Reset to current
Current unallocated largest contiguous area SMSMVS24LARGESTUNALLOC The size of the current largest contiguous storage area available in unallocated user region storage

Reset characteristic: Not reset
LWM unallocated largest contiguous area SMSMVS24LARGESTUNALLOCLWM Low water mark (the lowest) of the size of the largest contiguous storage area available in unallocated user region storage

Reset characteristic: Reset to current
Last date and time SOS SMSMVS24LASTSOSTIMELOCAL The local time the last SOS condition that occurred to the z/OS user region storage was detected

Reset characteristic: Reset to zero
NOT IN THE DFHSTUP REPORT SMSMVS24LASTSOSTIMEGMT The time in GMT of the last SOS condition that occurred to the z/OS user region storage

Reset characteristic: Reset to zero
Time tasks waited because SOS SMSMVS24WAITTIME The total amount of time all the queued tasks have spent waiting because of the SOS or constrained state in the z/OS user region storage

The DFHSTUP report expresses this time as days:hours:minutes: seconds.decimals. The DSECT field contains the time as a store clock (STCK) value.

6.2 and later This field is subject to the ZOSSOSNEWTCB=DELAY system initialization parameter. It is populated when ZOSSOSNEWTCB=DELAY is in effect, but is always zero under ZOSSOSNEWTCB=NODELAY.

Reset characteristic: Reset to zero
Current tasks waiting because SOS SMSMVS24NUMWAITS The current number of tasks that are waiting because of the SOS or constrained state in the z/OS user region storage

6.2 and later This field is subject to the ZOSSOSNEWTCB=DELAY system initialization parameter. It is populated when ZOSSOSNEWTCB=DELAY is in effect, but is always zero under ZOSSOSNEWTCB=NODELAY.

Reset characteristic: Not reset
Peak tasks waiting because SOS SMSMVS24NUMWAITSHWM The peak number of tasks that waited because of the SOS or constrained state in the z/OS user region storage

6.2 and later This field is subject to the ZOSSOSNEWTCB=DELAY system initialization parameter. It is populated when ZOSSOSNEWTCB=DELAY is in effect, but is always zero under ZOSSOSNEWTCB=NODELAY.

Reset characteristic: Reset to current
Total waits because SOS SMSMVS24TOTALNUMWAITS The total number of tasks that waited because of the SOS or constrained state in the z/OS user region storage

6.2 and later This field is subject to the ZOSSOSNEWTCB=DELAY system initialization parameter. It is populated when ZOSSOSNEWTCB=DELAY is in effect, but is always zero under ZOSSOSNEWTCB=NODELAY.

Reset characteristic: Reset to zero
Extended user region storage    
State SMSMVS31STATE The state of the z/OS extended user region storage
Valid values are as follows:
NORMAL
No storage problems have been detected.
SOS
One or more of the SOS thresholds has been breached.
CONSTRAINED
None of the SOS thresholds is currently breached, but CICS has not reset the SOS state. CICS delays the resetting of the SOS state for a short period of time to allow for the region to recover from the SOS event.

Reset characteristic: Not reset
6.2 and later Times SOS SMSMVS31SOSCOUNT The number of times the z/OS extended user region storage was in SOS state

Reset characteristic: Reset to zero
6.2 and later SOS duration SMSMVS31SOSTIME The accumulated amount of time that CICS has been SOS in the z/OS extended user region storage

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
Current unallocated total SMSMVS31TOTALUNALLOC The current total amount of unallocated extended user region storage

Reset characteristic: Not reset
LWM unallocated total SMSMVS31TOTALUNALLOCLWM Low water mark (the lowest) of the total amount of unallocated extended user region storage that was recorded

Reset characteristic: Reset to current
Current unallocated largest contiguous area SMSMVS31LARGESTUNALLOC The size of the current largest contiguous storage area available in unallocated extended user region storage

Reset characteristic: Not reset
LWM unallocated largest contiguous area SMSMVS31LARGESTUNALLOCLWM Low water mark (the lowest) of the size of the largest contiguous storage area available in unallocated extended user region storage

Reset characteristic: Reset to current
Last date and time SOS SMSMVS31LASTSOSTIMELOCAL The local time the last SOS condition that occurred to the z/OS extended user region storage was detected

Reset characteristic: Reset to zero
NOT IN THE DFHSTUP REPORT SMSMVS31LASTSOSTIMEGMT The time of GMT of the last SOS condition that occurred to the z/OS extended user region storage

Reset characteristic: Reset to zero
Time tasks waited because SOS SMSMVS31WAITTIME The total amount of time that all the queued tasks have spent waiting because of the SOS or constrained state in the z/OS extended user region storage

The DFHSTUP report expresses this time as days:hours:minutes: seconds.decimals. The DSECT field contains the time as a store clock (STCK) value.

6.2 and later This field is subject to the ZOSSOSNEWTCB=DELAY system initialization parameter. It is populated when ZOSSOSNEWTCB=DELAY is in effect, but is always zero under ZOSSOSNEWTCB=NODELAY.

Reset characteristic: Reset to zero
Current tasks waiting because SOS SMSMVS31NUMWAITS The current number of tasks that are waiting because of the SOS or constrained state in the z/OS extended user region storage

6.2 and later This field is subject to the ZOSSOSNEWTCB=DELAY system initialization parameter. It is populated when ZOSSOSNEWTCB=DELAY is in effect, but is always zero under ZOSSOSNEWTCB=NODELAY.

Reset characteristic: Not reset
Peak tasks waiting because SOS SMSMVS31NUMWAITSHWM The peak number of tasks that waited because of the SOS or constrained state in the z/OS extended user region storage

6.2 and later This field is subject to the ZOSSOSNEWTCB=DELAY system initialization parameter. It is populated when ZOSSOSNEWTCB=DELAY is in effect, but is always zero under ZOSSOSNEWTCB=NODELAY.

Reset characteristic: Reset to current
Total waits because SOS SMSMVS31TOTALNUMWAITS The total number of tasks that waited because of the SOS or constrained state in the z/OS extended user region storage

6.2 and later This field is subject to the ZOSSOSNEWTCB=DELAY system initialization parameter. It is populated when ZOSSOSNEWTCB=DELAY is in effect, but is always zero under ZOSSOSNEWTCB=NODELAY.

Reset characteristic: Reset to zero
6.2 and later MEMLIMIT storage    
State SMSMVS64STATE The state of the z/OS MEMLIMIT storage
Valid values are as follows:
NORMAL
No storage problems have been detected.
SOS
One or more of the SOS thresholds has been breached.
CONSTRAINED
None of the SOS thresholds is currently breached, but CICS has not reset the SOS state. CICS delays the resetting of the SOS state for a short period of time to allow for the region to recover from the SOS event.

Reset characteristic: Not reset
Times SOS SMSMVS64SOSCOUNT The number of times the z/OS MEMLIMIT storage was in SOS state

Reset characteristic: Reset to zero
SOS duration SMSMVS64SOSTIME The accumulated amount of time that CICS has been SOS in the z/OS MEMLIMIT storage

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
Current unallocated SMSMVS64UNALLOC The current amount, in MB, of unallocated MEMLIMIT storage.

Reset characteristic: Not reset
LWM unallocated SMSMVS64UNALLOCLWM Low water mark (the lowest) of the amount, in MB, of unallocated MEMLIMIT storage

Reset characteristic: Reset to current
Last date and time SOS SMSMVS64LASTSOSTIMELOCAL The local time the last SOS condition that occurred to the MEMLIMIT storage was detected

Reset characteristic: Reset to zero
Not in the DFHSTUP report SMSMVS64LASTSOSTIMEUTC The time in UTC of the last SOS condition that occurred to the MEMLIMIT storage

Reset characteristic: Reset to zero