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:

Monitoring views > CICS region monitoring views > Monitor data for DSA

Table 1. Views in the supplied Monitor data for DSA (MCICSDSA) view set
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

Table 2. Actions available for MCICSDSA views
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

Table 3. Fields in MCICSDSA views
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:
  • CDSA, UDSA, ECDSA, EUDSA, ERDSA
  • RDSA, SDSA, ESDSA, GCDSA
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.


eyua4f3.html | Timestamp icon Last updated: Sunday, 4 June 2017