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.
| 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:
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 |
| 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:
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.
Source field: SMSACCESS |
- 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.