CICSplex Pagepool Details attribute group

The CICSplex Pagepool Details attribute group provides information on the use of z/OS and CICS virtual storage. It contains the information you need to understand your current use of virtual storage above and below the 16 MB line, and helps you to verify the size values and limits used for the various standard and extended Dynamic Storage Areas.

Access Type Is the type of access of the subpool. It is either CICS, USER, or READONLY. If storage protection is not active, all storage areas revert to CICS except those in the ERDSA.

CICS Region Name Indicates the job name or modify ID of the CICS region being monitored. Each CICS region in a z/OS image has a unique name. This name is an alphanumeric string, with a maximum of 8 characters, and case-sensitive. CICS region names are always in uppercase characters.

Current Subpools Is the current number of subpools (domain and task) in the CDSA, UDSA, SDSA, or RDSA.

Current Suspensions Is the number of GETMAIN requests currently suspended for storage.

Cushion Releases Is the number of times a GETMAIN request caused the storage cushion to be released. The cushion is said to be released when the amount of free storage drops below the cushion size.

Cushion Size Is the size of the cushion, expressed in bytes. The cushion forms part of the associated DSA, and is the amount of storage that CICS holds in reserve, which will only be freed to try and alleviate an ongoing short-on-storage (SOS) condition.

Cushion Size (KB) Is the current DSA storage cushion size in kilobytes. The current cushion size of the DSA size in the current CICS Region, rounded up to kilobytes.

Cushion Size (MB) Is the current DSA storage cushion size in megabytes. The current cushion size of the DSA size in the current CICS Region, rounded up to megabytes.

DSA Index Is the numeric representation of the DSA name. Values are:

DSA Name Is the name of the Dynamic Storage Area (DSA) that the domain subpool is allocated from. Values can be 'CDSA', 'UDSA', 'SDSA', 'RDSA', 'ECDSA', 'EUDSA', 'ESDSA', and 'ERDSA'.

DSA Size is the size of the current DSA expressed in bytes.

DSA Size (KB) Is the current size of DSA in kilobytes. The size of the DSA in the current CICS Region at the time of this query, rounded up to kilobytes.

DSA Size (MB) Is the current size of DSA in megabytes. The size of the DSA in the current CICS Region at the time of this query, rounded up to megabytes.

DSA Usage Is the current portion of DSA being used. The current storage use of the Dynamic Storage Area in the current CICS Region at the time of this query.

DSA Usage (KB) Is the current portion of DSA being used in kilobytes. The current storage use of the Dynamic Storage Area in the current CICS Region at the time of this query, rounded up to kilobytes.

DSA Usage (MB) Is the current portion of DSA being used in megabytes. The current storage use of the Dynamic Storage Area in the current CICS Region at the time of this query, rounded up to megabytes.

DSA Use Percentage of DSA Size Is the DSA use as a percentage of the DSA total. The current usage percentage for the four standard Dynamic Storage Areas in the current CICS Region.

Extents Is the current number of extents allocated to this DSA.

Extents added Is the number of extents added to this DSA.

Extents removed Is the number of extents released from this DSA.

FREEMAIN Is the number of FREEMAIN requests from the current DSA.

Free Storage Is the current amount of free storage in the current Subpool expressed in bytes.

Free Storage (KB) Is the total amount of free storage in kilobytes. The current amount of free storage (including the cushion) within the current DSA in this CICS Region, rounded up to kilobytes.

Free Storage (MB) Is the total amount of free storage in megabytes. The current amount of free storage (including the cushion) within the current DSA in this CICS Region, rounded up to megabytes.

GETMAIN is the number of GETMAIN requests from the current DSA.

High-Water Mark Is the peak size of the current DSA, expressed in bytes.

High-Water Mark (KB) Is the high water mark storage size in kilobytes. The highest value of the DSA size that has occurred since the current CICS Region was started, rounded up to kilobytes.

High-Water Mark (MB) Is the high water mark storage size in megabytes. The highest value of the DSA size that has occurred since the current CICS Region was started, rounded up to megabytes.

HWM Free Storage (KB) Is the total amount of HWM free storage in kilobytes. The current amount of high water mark free storage (including the cushion) within the current DSA in this CICS Region, rounded up to kilobytes.

HWM Free Storage (MB) Is the total amount of HWM free storage in megabytes. The current amount of high-water-mark free storage (including the cushion) within the current DSA in this CICS Region, rounded up to megabytes.

HWM Suspensions Is the peak number of GETMAIN requests suspended for storage.

HWM Free Storage is total amount of HWM free storage. The current amount of high-water-mark free storage (including the cushion) within the current DSA in this CICS Region.

Insufficient storage Is the number of times a GETMAIN request with SUSPEND(NO) returned the condition INSUFFICIENT_STORAGE.

Largest Free Area Is the length of the largest contiguous free area in the CDSA, UDSA, SDSA, or RDSA, expressed in bytes.

Largest Free Area (KB) Is the largest contiguous free storage size in kilobytes. The size of the largest continuous area of free storage within the current DSA in this CICS Region, rounded up to kilobytes.

Largest Free Area (MB) Is the largest contiguous free storage size in megabytes. The size of the largest continuous area of free storage within the current DSA in this CICS Region, rounded up to megabytes.

LWM Free Storage is total amount of LWM free storage. The current amount of low-water mark free storage (including the cushion) within the current DSA in this CICS Region.

LWM Free Storage (KB) is total amount of LWM free storage in kilobytes. The current amount of low-water mark free storage (including the cushion) within the current DSA in this CICS Region, rounded up to kilobytes.

LWM Free Storage (MB) is total amount of LWM free storage in megabytes. The current amount of low-water mark free storage (including the cushion) within the current DSA in this CICS Region, rounded up to megabytes.

Origin Node Is the combination of z/OS System ID (SMFID) and CICS region name. The value format is an alphanumeric string, maximum 32 bytes, and case-sensitive.

When a situation is true, the system compares the origin node name in the attribute to the names of managed systems assigned to the item. If the origin node name matches the name of a managed system, the status of the item changes accordingly. If the names of the origin node and the managed systems do not match, the status of the item remains unchanged.

SOS Occurrences Is the number of times CICS went short on storage (SOS) in this DSA, where SOS means either that the cushion is currently in use or that there is at least one task suspended for storage or both.

Storage Violations Is the number of storage violations recorded in the associated DSA.

Subpool Additions Is the number of ADD_SUBPOOL requests to create a subpool (domain or task) for the associated DSA.

Subpool Deletions Is the number of DELETE_SUBPOOL requests (domain or task) from the associated DSA.

Subpool Location Is the storage location of this domain subpool, either ABOVE or BELOW the 16 MB addressability line.

System ID Indicates the four-character name that uniquely identifies an active z/OS operating system within a given CICSplex. The value format is an alphanumeric string, maximum 4 characters, and case-sensitive. z/OS System IDs are always in uppercase characters.

Total SOS Time Is the accumulated time (in seconds accurate to thousandths of a second) that CICS has been short on storage (SOS) in this DSA. The valid format is a floating-point number, accurate to three decimal places.

Total Suspensions Is the number of times a GETMAIN request with SUSPEND(YES) was suspended because of insufficient storage to satisfy the request at that moment.

Unconditional Suspensions Is the number of requests which were purged while suspended for storage.