Dynamic storage areas - CICSDSA
The Dynamic storage area (CICSDSA) views display information about dynamic storage areas (DSAs) within each CICS system.
Supplied views
To access from the main menu, click:
| View | Notes |
|---|---|
| Dynamic storage areas EYUSTARTCICSDSA.DETAIL1 |
Detailed information about a selected dynamic storage area. |
| Dynamic storage areas EYUSTARTCICSDSA.DETAILED |
Detailed information about a selected dynamic storage area. |
| Dynamic storage areas EYUSTARTCICSDSA.SET |
Set CICS DSA attributes according to the new values specified in input fields. |
| Dynamic storage areas EYUSTARTCICSDSA.TABULAR |
Tabular information about dynamic storage areas (DSAs) within each CICS system. |
Actions
| Action | Description |
|---|---|
| SET | Set CICS DSA attributes according to the new values specified in input fields. |
Fields
| Field | Attribute name | Description |
|---|---|---|
| Storage key | ACCESSTYPE | The type of access for this dynamic storage area (CICS, USER, READONLY,TRUSTED). If storage protection is not active, all storage areas have an access type of CICS except those in the ERDSA. |
| Current address space storage that is addressable | ASACTIVE | The current address space storage that can be addressed. |
| Number of Add Subpool requests | ASUBTOTL | The number of requests to create a domain or task subpool from this dynamic storage area. |
| Cushion limit | ATBCUSHLIMIT | The size in bytes of the cushion for this DSA. The cushion is the amount of storage below which CICS goes short on storage. |
| Number of GCDSA, GUDSA or GSDSA cushion releases | ATBCUSHRELS | The number of cushion releases associated with GDSA. |
| Cumulative number of common subspace users | CUMCMNSSUSRS | The cumulative number of common subspace user requests for this CICS execution. |
| Cumulative number of unique subspace users | CUMUNQSSUSRS | The cumulative number of unique subspace task requests for this CICS execution. |
| Current number of common subspace users | CURCMNSSUSRS | The current number of common subspace user requests. |
| Current DSA allocation | CURRALLOC | The current amount of DSA allocated. |
| Current tasks allocated a unique subspace | CURUNQSSUSRS | The current number of unique subspace user requests. |
| Cushion size | CUSHION |
The size in bytes of the cushion for this dynamic storage area. The cushion is the amount of storage below
which CICS goes short on storage. Input Values: 0 - DSASIZE value |
| Number of Delete Subpool requests | DSUBTOTL | The number of requests to delete a domain or task subpool from this dynamic storage area. |
| Number of extents added to DSA | EXTENTSADDED | The number of extents added to the DSA. |
| Number of extents allocated to DSA | EXTENTSCURR | The number of extents allocated to the DSA. |
| Number of extents deleted from page pool | EXTENTSDELTD | The number of extents deleted from the page pool. |
| Number of FREEMAIN requests | FREMTOTL | The number of FREEMAIN requests for this dynamic storage area. |
| The current GDSA active | GDSAACTIVE | The amount of storage available for use above the bar. |
| Number of GETMAIN requests | GETMTOTL | The number of GETMAIN requests from this dynamic storage area. |
| The GETSTOR request size | GETSTORSIZE | The amount of storage that has been requested displayed as bytes. |
| Peak DSA allocation | HWMALLOC | The largest amount of DSA allocated at any one time. |
| The HWM address space that can be addressed | HWMASACTIVE | The peak address space storage that could be addressed. |
| Peak number of common subspace users | HWMCMNSSUSRS | The largest number of common subspace user requests at any one time. |
| Peak amount of free storage available | HWMFREE | The largest amount of storage that was free at any one time. |
| The peak GDSA active | HWMGDSAACTIV | The peak amount of storage available for use above the bar. |
| Peak number of unique subspace users | HWMUNQSSUSRS | The largest number of unique subspace user requests at any one time. |
| Limit of storage for DSAs | LIMIT |
The maximum amount of storage, as a total number of bytes, within which CICS can dynamically allocate storage for all
of the DSAs residing on the same side of the 16MB boundary. The value shown is either the DSA limit for the RDSA, UDSA, CDSA and SDSA, or the EDSA limit for the ERDSA, EUDSA, ECDSA, ESDSA, and ETDSA. It is zero for DSAs located above the bar. If you set a new value lower than the current limit, CICS might not implement the new limit immediately, but attempts to do so over time as storage is freed. CICS rounds up the value you supply to the next multiple of 256KB for the DSA limit and to the next multiple of 1MB for the EDSA limit. Input Values for the DSA limit: 2,097,152 to 16,777,216 Input Values for the EDSA limit: 50,331,648 to 2,146,435,072 |
| Dynamic storage area (DSA) location | LOCATION | Indicates where this dynamic storage area is located, either above or below the 16MB line, or above the bar. |
| Smallest amount of free storage available | LWMFREE | The smallest amount of storage that was free at any one time. |
| Maximum amount of above the bar storage | MEMLIMIT |
The current upper limit of the total amount of storage within which CICS can allocate the individual DSAs that reside
above the bar. A value of 'N/A' means there is no limit to the amount of storage above the bar that CICS can use. |
| Dynamic storage area (DSA) | NAME |
The name of the dynamic storage area, as one of the following: RDSA, UDSA, CDSA, SDSA, ERDSA, EUDSA, ECDSA, ESDSA, ETDSA, GCDSA, GUDSA, GSDSA |
| Number of current suspended storage requests | NSTGCURR | The number of GETMAIN requests currently suspended for insufficient storage. |
| Number of times NOSTORAGE returned | NSTGTOTL | The number of times a GETMAIN request with SUSPEND(NO) returned an insufficient storage condition. |
| Percentage of available total storage | PCTFREE | Available percent of total space of DSA calculated from the DSA or EDSA limit size value. This data has no meaning for above the bar storage. |
| Storage occupied by not-in-use programs | PGMONIU | The amount of storage in this dynamic storage area that is occupied by Not-In-Use (NIU) programs. |
| Percentage of available pool storage | POOLPCTFREE | Available amount of space from all DSA pool allocations above or below the 16M line. This data has no meaning for above the bar storage. |
| Number of requests for MVS storage causing wait | REQSWAITMVS | The number of requests for MVS storage causing waits. |
| Reentrant program protection status | RNTPGPROTECT | Specifies whether Reentrant Program Protection was chosen for this execution of CICS. It protects CICS loaded programs from being written to directly. |
| Subpool size | SIZE | The size of the dynamic storage area in bytes. |
| Number of times cushion released | STGCRELC | The number of times a GETMAIN request caused the storage cushion to be released. The cushion is considered released when the number of free pages drops below the number of pages in the cushion. |
| Free storage size | STGFSIZE | The amount of free storage, including the cushion, in this dynamic storage area. |
| Peak size of DSA | STGHWM | The peak size of the DSA. |
| Largest free area size | STGLSIZE | The length in bytes of the largest contiguous free area in this dynamic storage area. |
| Number of current subpools | STGNSUBP | The current number of domain or task subpools in this dynamic storage area. |
| Storage protection status | STGPROTECT | Specifies whether the Storage Protection option was chosen for this execution of the CICS system. If storage protection is active CICS observes storage and execution keys that are specified in system and resource definitions. |
| Number of tasks purged while waiting | STGPWCNT | The number of GETMAIN requests that were purged while suspended for insufficient storage. |
| Peak number of suspended storage requests | STGSHWM | The maximum number of GETMAIN requests suspended for insufficient storage at any one time. |
| Short on storage count | STGSOSC | The number of times CICS went short on storage (SOS) in this dynamic storage area. SOS means that the cushion is currently in use and/or there is at least one task suspended for storage. |
| Total time CICS was short on storage | STGSOST | The total amount of time that CICS has been short on storage (SOS) in this dynamic storage area. |
| Number of times requests were suspended | STGSTOTL | The number of times a GETMAIN request with SUSPEND(YES) was suspended because of insufficient storage. |
| Number of storage violations | STGVTOTL | The number of storage violations recorded in this dynamic storage area. |
| Total time waiting for MVS storage | TIMEWAITMVS | The total amount of time that CICS has been waiting for storage in this dynamic storage area. |
| Transaction isolation status | TRNISOLATION | The task-lifetime storage of programs that are defined with EXECKEY(USER) are protected from other EXECKEY(USER) programs both reading and writing if this is active. |