Storage manager: Global statistics

You can retrieve storage manager global statistics by using the EXEC CICS EXTRACT STATISTICS STORAGE system 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 storage and extended user region storage

These statistics are collected for MVS user region storage and extended user region storage.

Table 2. Storage manager: Global statistics for user region storage and extended user region storage
DFHSTUP name Field name Description
Last monitor sample time SMSMVSMONSAMPLELASTTIMELOCAL The local time the MVS monitor system task last sampled MVS storage

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

Reset characteristic: Not reset
User region storage statistics    
State SMSMVS24STATE User region state
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
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 user region SOS condition was detected

Reset characteristic: Reset to zero
NOT IN THE DFHSTUP REPORT SMSMVS24LASTSOSTIMEGMT The GMT when the last user region SOS condition was detected

Reset characteristic: Reset to zero
Time tasks waited because SOS SMSMVS24WAITTIME The time tasks waited because of the SOS or constrained state in the user region storage

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 user region storage

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 user region storage

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 user region storage

Reset characteristic: Reset to zero
Extended user region storage statistics    
State SMSMVS31STATE Extended user region state
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
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 extended user region SOS condition was detected

Reset characteristic: Reset to zero
NOT IN THE DFHSTUP REPORT SMSMVS31LASTSOSTIMEGMT The GMT when the last extended user region SOS condition was detected

Reset characteristic: Reset to zero
Time tasks waited because SOS SMSMVS31WAITTIME The time tasks waited because of the SOS or constrained state in extended user region storage

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 extended user region storage

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 extended user region storage

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 extended user region storage

Reset characteristic: Reset to zero