Storage above 2 GB report

The Storage above 2 GB report provides information about the use of MVS™ and CICS® virtual storage. It contains the information you require to understand the use of 64-bit virtual storage, also known as storage above the bar. This report helps you to verify the allocation of storage for the CICS dynamic storage areas above the bar (GDSA) and for the CICS functions that use 64-bit storage.

This report is produced using the EXEC CICS COLLECT STATISTICS STORAGE command. The statistics data is mapped by the DFHSMSDS DSECT.

Table 1. Fields in the Storage above 2 GB report (part 1)
Field Heading Description
MEMLIMIT Size 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.

Source field: SMSMEMLIMIT

MEMLIMIT Set By
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.

Source field: SMSMEMLIMITSRC

Current Address Space active (bytes) The current address space available above the bar. This value is expressed in bytes.

Source field: (SMSASACTIVE x 1048576)

Current Address Space active The current address space available above the bar. This value is expressed in megabytes.

Source field: SMSASACTIVE

Peak Address Space active The peak amount of address space available above the bar. This value is expressed in megabytes.

Source field: SMSHWMASACTIVE

MEMLIMIT minus Current Address Space active The value of the z/OS® MEMLIMIT parameter minus the current address space available above the bar. This value is expressed in megabytes.

Source field: (SMSMEMLIMIT - SMSASACTIVE)

MEMLIMIT minus allocated to Private Memory Objects The value of the z/OS MEMLIMIT parameter minus the amount of storage allocated from large virtual memory in private memory objects. This value is expressed in megabytes.

When rounded down to units of GB, it represents the number of extra GDSA 1 GB extents that can be allocated by CICS currently.

Source field: (SMSMEMLIMIT - (SMSLVABYTES / 1048576))

Number of Private Memory Objects The number of private memory objects allocated.1

Source field: SMSLVNMEMOBJ

....minus Current® GDSA extents The number of private memory objects allocated minus the number of extents that are currently allocated to this DSA.

Source field: (SMSLVNMEMOBJ - SMSEXTS)

Bytes allocated to Private Memory Objects The number of bytes allocated from large virtual memory in private memory objects. This value is expressed in megabytes and bytes.1

Source field: SMSLVABYTES

....minus Current GDSA allocated The number of bytes allocated from large virtual memory in private memory objects minus the total storage that is currently allocated to the DSAs above the bar. This value is expressed in megabytes and bytes.

Source field: (SMSLVABYTES - SMSGDSAALLOC)

Bytes hidden within Private Memory Objects The number of bytes hidden in large virtual memory private memory objects. This value is expressed in megabytes and bytes.1

Source field: SMSLVHBYTES

....minus Current GDSA hidden The number of bytes hidden in large virtual memory private memory objects minus the storage that is allocated to the DSAs above the bar that is not currently active. This value is expressed in megabytes and bytes.

Source field: (SMSLVHBYTES - (SMSGDSAALLOC - SMSGDSAACTIVE))

....minus CICS Internal Trace Table hidden The number of bytes hidden in large virtual memory private memory objects minus the storage that is allocated to the DSAs above the bar that is not currently active, and minus the size of the CICS internal trace table. This value is expressed in megabytes.

Source field: (SMSLVHBYTES - ((SMSGDSAALLOC - SMSGDSAACTIVE) + EXEC CICS INQUIRE TRACEDEST TABLESIZE)) / 1048756

Bytes usable within Private Memory Objects The number of usable bytes in large virtual memory private memory objects, that is, the number of bytes allocated minus the number of bytes hidden in large virtual memory private memory objects. This value is expressed in megabytes and bytes.

Source field: (SMSLVABYTES - SMSLVHBYTES)

Peak bytes usable within Private Memory Objects The high-water mark of usable bytes in large virtual memory private memory objects. This value is expressed in megabytes and bytes.1

Source field: SMSLVGBYTES

Current GDSA Allocated The total amount of storage currently allocated to the DSAs above the bar. This value is expressed in megabytes and bytes.

Source field: SMSGDSAALLOC

Peak GDSA Allocated The peak amount of storage allocated to the DSAs above the bar. This value is expressed in megabytes.

Source field: SMSHWMGDSAALLOC

Current GDSA Active The current storage in use above the bar. This value is expressed in megabytes and bytes.

Source field: SMSGDSAACTIVE

Peak GDSA Active The peak amount of storage in use above the bar. This value is expressed in megabytes.

Source field: SMSHWMGDSAACTIVE

Current GDSA Used The current amount of storage used in this DSA, expressed in megabytes.

Source field: (SMSDSASZ - SMSFSTG)

Number of Shared Memory Objects The number of shared memory objects allocated.1

Source field: SMSLVSHRNMEMOBJ

Bytes allocated to Shared Memory Objects The number of shared bytes allocated from high virtual memory. This value is expressed in megabytes and bytes.1

Source field: SMSLVSHRBYTES

Peak bytes usable within Shared Memory Objects The high-water mark for the number of shared bytes in large virtual memory objects. This value is expressed in megabytes and bytes.1

Source field: SMSLVSHRGBYTES

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

Source field: SMSHVAUXSLOTS

HWM Auxiliary Slots backing Private Memory Object The high-water mark of auxiliary storage slots that are used to back 64-bit private memory objects.1

Source field: SMSHVGAUXSLOTS

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

Source field: SMSHVPAGESINREAL

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

Source field: SMSHVGPAGESINREAL

Number of Large Memory Objects Allocated The number of large memory objects allocated by this address space.1

Source field: SMSLARGEMEMOBJ

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

Source field: SMSLARGEPAGESINREAL

CICS Internal Trace table size (bytes) The current size set for the CICS internal trace table, expressed in bytes.

Source field: EXEC CICS INQUIRE TRACEDEST TABLESIZE

CICS Internal Trace table size The current size set for the CICS internal trace table, expressed in KB.

Source field: (EXEC CICS INQUIRE TRACEDEST TABLESIZE) / 1024

IARV64 GETSTOR request size The GETSTOR request size. This value is expressed in megabytes.

Source field: SMSGETSTORSIZE

Number of IARV64 FROMGUARD failures 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.

Source field: SMSFROMGUARDFAIL

Largest IARV64 FROMGUARD failure size 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.

Source field: SMSFROMGUARDFAILSIZE

Table 2. Fields in the Storage above 2 GB report (part 2)
Field Heading Description
MEMLIMIT Size 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.

Source field: SMSMEMLIMIT

MEMLIMIT Set By
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.

Source field: SMSMEMLIMITSRC

Current Address Space active The current address space available above the bar. This value is expressed in megabytes.

Source field: SMSASACTIVE

Peak Address Space active The peak amount of address space available above the bar. This value is expressed in megabytes.

Source field: SMSHWMASACTIVE

Current GDSA Allocated The total amount of storage currently allocated to the DSAs above the bar. This value is expressed in megabytes.

Source field: SMSGDSAALLOC

Peak GDSA Allocated The peak amount of storage allocated to the DSAs above the bar. This value is expressed in megabytes.

Source field: SMSHWMGDSAALLOC

Current GDSA Active The current storage in use above the bar. This value is expressed in megabytes.

Source field: SMSGDSAACTIVE

Peak GDSA Active The peak amount of storage in use above the bar. This value is expressed in megabytes.

Source field: SMSHWMGDSAACTIVE

CICS Internal Trace table size (bytes) The current size set for the CICS internal trace table, expressed in bytes.

Source field: EXEC CICS INQUIRE TRACEDEST TABLESIZE

CICS Internal Trace table size The current size set for the CICS internal trace table, expressed in KB.

Source field: (EXEC CICS INQUIRE TRACEDEST TABLESIZE) / 1024

Number of Private Memory Objects The number of private memory objects allocated.1

Source field: SMSLVNMEMOBJ

Bytes allocated to Private Memory Objects The number of bytes allocated from large virtual memory in private memory objects.1

Source field: SMSLVABYTES

Bytes hidden within Private Memory Objects The number of bytes hidden in large virtual memory private memory objects.1

Source field: SMSLVHBYTES

Peak bytes usable within Private Memory Objects The high-water mark of usable bytes in large virtual memory private memory objects.1

Source field: SMSLVGBYTES

Current DSA Size The current size of the GCDSA, GUDSA, or GSDSA, expressed in megabytes.

Source field: (SMSDSASZ / 1024)

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

Source field: (SMSDSASZ - SMSFSTG)

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 megabytes.

Source field: SMSHWMPS

Peak DSA Size The peak size of this DSA, expressed in megabytes.

Source field: (SMSHWMDSASZ / 1024)

Cushion Size The size of the cushion for this DSA, expressed in megabytes. The cushion forms part of each DSA and is the amount of storage below which CICS goes SOS.

Source field: SMSCSIZE

Free Storage (inc. Cushion) The amount of free storage in this DSA; that is, the number of free pages multiplied by the page size (1 MB), expressed in megabytes.

Source field: SMSFSTG

Peak Free Storage The largest amount of storage that is free in this DSA since the last time that statistics were recorded, expressed in megabytes.

Source field: SMSHWMFSTG

Lowest Free Storage The smallest amount of storage that is free in this DSA since the last time that statistics were recorded, expressed in megabytes.

Source field: SMSLWMFSTG

Largest Free Area The length of the largest contiguous free area in this DSA, expressed in megabytes.

Source field: SMSLFA

Largest Free Area as % of DSA The largest contiguous free area in this DSA, expressed as a percentage of the current DSA Size.

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

Largest Free/Free Storage 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 number of extents currently allocated to this DSA.

Source field: SMSEXTS

Number of extents added The number of extents added to the DSA since the last time statistics were recorded.

Source field: SMSEXTSA

Number of extents released The number of extents that were released from the DSA since the last time statistics were recorded.

Source field: SMSEXTSR

Getmain Requests The number of GETMAIN requests from this DSA.

Source field: SMSGMREQ

Freemain Requests The number of FREEMAIN requests from this DSA.

Source field: SMSFMREQ

Current number of Subpools The current number of subpools (domain and task) in this DSA.

Source field: SMSCSUBP

Add Subpool Requests The number of ADD_SUBPOOL requests to create a subpool (domain or task) from this DSA.

Source field: SMSASR

Delete Subpool Requests The number of DELETE_SUBPOOL requests (domain or task) from this DSA.

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 that moment.

Source field: SMSUCSS

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

Source field: SMSCSS

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

Source field: SMSHWMSS

Requests purged while waiting The number of requests that 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 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.

Source field: SMSCREL

Times Short-On-Storage 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.

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 DSA.

Source field: SMSSV

Access The type of access of this DSA. Values are CICS or USER. If storage protection is not active, storage areas revert to an access type of CICS.
  • CICS - access is CICS key
  • USER - access is user key

Source field: SMSACCESS

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.


dfht3_stats_stgmgr_0stat_above2GB.html | Timestamp icon Last updated: Monday, 5 June 2017