Monitor data for DSA - MCICSDSA
The Monitor dynamic storage areas (MCICSDSA) views show general information about dynamic storage areas (DSAs) within monitored CICS systems.
Supplied views
To access from the main menu, click:
| View | Notes |
|---|---|
| Monitor data for DSA EYUSTARTMCICSDSA.DETAILED |
Detailed information about a selected dynamic storage area. |
| Monitor data for DSA EYUSTARTMCICSDSA.DISCARD |
Removes a DSA from monitoring for the current sample interval and discards its accumulated statistics. |
| Monitor data for DSA EYUSTARTMCICSDSA.RESET |
Reset all Monitoring instance attributes. |
| Monitor data for DSA EYUSTARTMCICSDSA.TABULAR |
Tabular information about dynamic storage areas (DSAs) within each monitored CICS system. |
Actions
| Action | Description |
|---|---|
| DISCARD | Removes a DSA from monitoring for the current sample interval and discards its accumulated statistics. |
| RESET | Reset all Monitoring instance attributes. |
Fields
| Field | Attribute name | Description |
|---|---|---|
| Storage key | ACCESSTYPE | The type of access for this dynamic storage area (CICS, USER, or READONLY). If storage protection is not active, all storage areas have an access type of CICS except those in the ERDSA. |
| Number of Add Subpool requests | ASUBTOTL | The number of requests to create a domain or task subpool from this dynamic storage area. |
| Cumulative number of common subspace users | CUMCMNSSUSRS | The cumulative number of common subspace users. |
| Cumulative number of unique subspace users | CUMUNQSSUSRS | The cumulative number of unique subspace user requests for this CICS execution. |
| Current number of common subspace users | CURCMNSSUSRS | The current number of common subspace user requests. |
| Free storage for current sample (%) | CURFRESTG | The percentage of free storage in this dynamic storage area during the last sample period. This field is not applicable to GCDSA. |
| Current DSA allocated above/below 16M line | CURRALLOC | Current DSA size expressed in bytes. |
| 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. |
| Number of Delete Subpool requests | DSUBTOTL | The number of requests to delete a domain or task subpool from this dynamic storage area. |
| Number of FREEMAIN requests | FREMTOTL | The number of FREEMAIN requests from this dynamic storage area. |
| Number of GETMAIN requests | GETMTOTL | The number of GETMAIN requests from this dynamic storage area. |
| Peak DSA allocated above/below 16M line | HWMALLOC | Contains the peak page storage allocated to support the storage requirements of this subpool. |
| 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 | Largest amount of storage that was free for this CICS execution. This field is not applicable to GCDSA. |
| Peak number of unique subspace users | HWMUNQSSUSRS | The largest number of unique subspace user requests at any one time. |
| Interval ID | INTERVALID | The ID of the monitor interval. |
| Free storage for monitor interval (%) | INTFRESTG | The average percentage of free storage in this dynamic storage area over the monitor interval. This field is not applicable to GCDSA. |
| Maximum size of DSA | LIMIT | The maximum amount of storage, as a total number of bytes, within which CICS can dynamically allocate storage for the four individual DSAs that reside below the 16M boundary. |
| Dynamic storage area (DSA) location | LOCATION | Indicates where this dynamic storage area is located, either above or below the 16MB line. For GCDSA, the value is NOTAPPLIC. |
| Smallest amount of free storage available | LWMFREE | The smallest amount of storage that was free for this CICS execution. This field is not applicable to GCDSA. |
| Dynamic storage area (DSA) | NAME | The name of the dynamic storage area, as one of the following:
|
| Number of times NOSTORAGE returned | NSTGTOTL | The number of times a GETMAIN request with SUSPEND(NO) returned an insufficient storage condition. |
| Number of current suspended storage requests | NSTGTSUSP | The number of GETMAIN requests currently suspended for insufficient storage. |
| Percentage of available total storage | PCTFREE | Available percent of total space of DSA. This value is calculated from the DSA or EDSA limit size value. |
| 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. |
| 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. |
| DSA 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. This field is not applicable to GCDSA. |
| 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. This field is not applicable to GCDSA. |
| Number of current subpools | STGNSUBP | The current number of domain or task subpools in this dynamic storage area. |
| Storage protection active | 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 either the cushion is currently in use or there is at least one task suspended for storage. |
| Total time CICS was short on storage | STGSOST | 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. |
| 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 | Indicates if the storage of programs that are defined with EXECKEY(USER) are protected from other EXECKEY(USER) programs for the lifetime of the task. |