com.ibm.cics.model
Interface IDynamicStorageArea

All Superinterfaces:
ICICSObject, ICICSResource, com.ibm.cics.model.meta.ITypedObject

public interface IDynamicStorageArea
extends ICICSResource

generated from CICS resourcetable CICSDSA


Nested Class Summary
static class IDynamicStorageArea.AccesstypeValue
          Enumeration type for field ACCESSTYPE
static class IDynamicStorageArea.LocationValue
          Enumeration type for field LOCATION
static class IDynamicStorageArea.RntpgprotectValue
          Enumeration type for field RNTPGPROTECT
static class IDynamicStorageArea.StgprotectValue
          Enumeration type for field STGPROTECT
static class IDynamicStorageArea.TrnisolationValue
          Enumeration type for field TRNISOLATION
 
Method Summary
 IDynamicStorageArea.AccesstypeValue getAccesstype()
          Getter for field ACCESSTYPE
 java.lang.Long getAsactive()
          Getter for field ASACTIVE
 java.lang.Long getAsubtotl()
          Getter for field ASUBTOTL
 java.lang.Long getAtbcushlimit()
          Getter for field ATBCUSHLIMIT
 java.lang.Long getAtbcushrels()
          Getter for field ATBCUSHRELS
 java.lang.Long getCumcmnssusrs()
          Getter for field CUMCMNSSUSRS
 java.lang.Long getCumunqssusrs()
          Getter for field CUMUNQSSUSRS
 java.lang.Long getCurcmnssusrs()
          Getter for field CURCMNSSUSRS
 java.lang.Long getCurralloc()
          Getter for field CURRALLOC
 java.lang.Long getCurunqssusrs()
          Getter for field CURUNQSSUSRS
 java.lang.Long getCushion()
          Getter for field CUSHION
 java.lang.Long getDsubtotl()
          Getter for field DSUBTOTL
 java.lang.Long getExtentsadded()
          Getter for field EXTENTSADDED
 java.lang.Long getExtentscurr()
          Getter for field EXTENTSCURR
 java.lang.Long getExtentsdeltd()
          Getter for field EXTENTSDELTD
 java.lang.Long getFremtotl()
          Getter for field FREMTOTL
 java.lang.Long getGdsaactive()
          Getter for field GDSAACTIVE
 java.lang.Long getGetmtotl()
          Getter for field GETMTOTL
 java.lang.Long getGetstorsize()
          Getter for field GETSTORSIZE
 java.lang.Long getHwmalloc()
          Getter for field HWMALLOC
 java.lang.Long getHwmasactive()
          Getter for field HWMASACTIVE
 java.lang.Long getHwmcmnssusrs()
          Getter for field HWMCMNSSUSRS
 java.lang.Long getHwmfree()
          Getter for field HWMFREE
 java.lang.Long getHwmgdsaactiv()
          Getter for field HWMGDSAACTIV
 java.lang.Long getHwmunqssusrs()
          Getter for field HWMUNQSSUSRS
 java.lang.Long getLimit()
          Getter for field LIMIT
 IDynamicStorageArea.LocationValue getLocation()
          Getter for field LOCATION
 java.lang.Long getLwmfree()
          Getter for field LWMFREE
 java.lang.Long getMemlimit()
          Getter for field MEMLIMIT
 java.lang.String getName()
          Getter for field NAME
 java.lang.Long getNstgcurr()
          Getter for field NSTGCURR
 java.lang.Long getNstgtotl()
          Getter for field NSTGTOTL
 java.lang.String getPctfree()
          Getter for field PCTFREE
 java.lang.Long getPgmoniu()
          Getter for field PGMONIU
 java.lang.String getPoolpctfree()
          Getter for field POOLPCTFREE
 java.lang.Long getReqswaitmvs()
          Getter for field REQSWAITMVS
 IDynamicStorageArea.RntpgprotectValue getRntpgprotect()
          Getter for field RNTPGPROTECT
 java.lang.Long getSize()
          Getter for field SIZE
 java.lang.Long getStgcrelc()
          Getter for field STGCRELC
 java.lang.Long getStgfsize()
          Getter for field STGFSIZE
 java.lang.Long getStghwm()
          Getter for field STGHWM
 java.lang.Long getStglsize()
          Getter for field STGLSIZE
 java.lang.Long getStgnsubp()
          Getter for field STGNSUBP
 IDynamicStorageArea.StgprotectValue getStgprotect()
          Getter for field STGPROTECT
 java.lang.Long getStgpwcnt()
          Getter for field STGPWCNT
 java.lang.Long getStgshwm()
          Getter for field STGSHWM
 java.lang.Long getStgsosc()
          Getter for field STGSOSC
 java.lang.String getStgsost()
          Getter for field STGSOST
 java.lang.Long getStgstotl()
          Getter for field STGSTOTL
 java.lang.Long getStgvtotl()
          Getter for field STGVTOTL
 java.lang.String getTimewaitmvs()
          Getter for field TIMEWAITMVS
 IDynamicStorageArea.TrnisolationValue getTrnisolation()
          Getter for field TRNISOLATION
 
Methods inherited from interface com.ibm.cics.model.ICICSResource
getCICSRelease, getRegionName
 
Methods inherited from interface com.ibm.cics.model.ICICSObject
getCICSType, getObjectType
 

Method Detail

getName

java.lang.String getName()
Getter for field NAME

Dynamic storage area (DSA)

The name of the dynamic storage area, as one of the following:

RDSA, UDSA, CDSA, SDSA, ERDSA, EUDSA, ECDSA, ESDSA, ETDSA, GCDSA

Specified by:
getName in interface ICICSObject

getSize

java.lang.Long getSize()
Getter for field SIZE

Subpool size

The size of the dynamic storage area in bytes.


getCushion

java.lang.Long getCushion()
Getter for field CUSHION

Cushion size

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


getPgmoniu

java.lang.Long getPgmoniu()
Getter for field PGMONIU

Storage occupied by not-in-use programs

The amount of storage in this dynamic storage area that is occupied by Not-In-Use (NIU) programs.


getGetmtotl

java.lang.Long getGetmtotl()
Getter for field GETMTOTL

Number of GETMAIN requests

The number of GETMAIN requests from this dynamic storage area.


getFremtotl

java.lang.Long getFremtotl()
Getter for field FREMTOTL

Number of FREEMAIN requests

The number of FREEMAIN requests for this dynamic storage area.


getAsubtotl

java.lang.Long getAsubtotl()
Getter for field ASUBTOTL

Number of Add Subpool requests

The number of requests to create a domain or task subpool from this dynamic storage area.


getDsubtotl

java.lang.Long getDsubtotl()
Getter for field DSUBTOTL

Number of Delete Subpool requests

The number of requests to delete a domain or task subpool from this dynamic storage area.


getNstgtotl

java.lang.Long getNstgtotl()
Getter for field NSTGTOTL

Number of times NOSTORAGE returned

The number of times a GETMAIN request with SUSPEND(NO) returned an insufficient storage condition.


getStgstotl

java.lang.Long getStgstotl()
Getter for field STGSTOTL

Number of times requests were suspended

The number of times a GETMAIN request with SUSPEND(YES) was suspended because of insufficient storage.


getNstgcurr

java.lang.Long getNstgcurr()
Getter for field NSTGCURR

Number of current suspended storage requests

The number of GETMAIN requests currently suspended for insufficient storage.


getStgshwm

java.lang.Long getStgshwm()
Getter for field STGSHWM

Peak number of suspended storage requests

The maximum number of GETMAIN requests suspended for insufficient storage at any one time.


getStgpwcnt

java.lang.Long getStgpwcnt()
Getter for field STGPWCNT

Number of tasks purged while waiting

The number of GETMAIN requests that were purged while suspended for insufficient storage.


getStgcrelc

java.lang.Long getStgcrelc()
Getter for field STGCRELC

Number of times cushion released

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.


getStgsosc

java.lang.Long getStgsosc()
Getter for field STGSOSC

Short on storage count

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.


getStgsost

java.lang.String getStgsost()
Getter for field STGSOST

Total time CICS was short on storage

The total amount of time that CICS has been short on storage (SOS) in this dynamic storage area.


getStgnsubp

java.lang.Long getStgnsubp()
Getter for field STGNSUBP

Number of current subpools

The current number of domain or task subpools in this dynamic storage area.


getStgfsize

java.lang.Long getStgfsize()
Getter for field STGFSIZE

Free storage size

The amount of free storage, including the cushion, in this dynamic storage area.


getStglsize

java.lang.Long getStglsize()
Getter for field STGLSIZE

Largest free area size

The length in bytes of the largest contiguous free area in this dynamic storage area.


getStgvtotl

java.lang.Long getStgvtotl()
Getter for field STGVTOTL

Number of storage violations

The number of storage violations recorded in this dynamic storage area.


getLocation

IDynamicStorageArea.LocationValue getLocation()
Getter for field LOCATION

Dynamic storage area (DSA) location

Indicates where this dynamic storage area is located, either above or below the 16MB line, or above the bar.


getAccesstype

IDynamicStorageArea.AccesstypeValue getAccesstype()
Getter for field ACCESSTYPE

Storage key

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.


getStghwm

java.lang.Long getStghwm()
Getter for field STGHWM

Peak size of DSA

The peak size of the DSA.


getLimit

java.lang.Long getLimit()
Getter for field LIMIT

Limit of storage for DSAs

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


getPoolpctfree

java.lang.String getPoolpctfree()
Getter for field POOLPCTFREE

Percentage of available pool storage

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.


getPctfree

java.lang.String getPctfree()
Getter for field PCTFREE

Percentage of available total storage

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.


getStgprotect

IDynamicStorageArea.StgprotectValue getStgprotect()
Getter for field STGPROTECT

Storage protection status

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.


getRntpgprotect

IDynamicStorageArea.RntpgprotectValue getRntpgprotect()
Getter for field RNTPGPROTECT

Reentrant program protection status

Specifies whether Reentrant Program Protection was chosen for this execution of CICS. It protects CICS loaded programs from being written to directly.


getTrnisolation

IDynamicStorageArea.TrnisolationValue getTrnisolation()
Getter for field TRNISOLATION

Transaction isolation status

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.


getHwmfree

java.lang.Long getHwmfree()
Getter for field HWMFREE

Peak amount of free storage available

The largest amount of storage that was free at any one time.


getLwmfree

java.lang.Long getLwmfree()
Getter for field LWMFREE

Smallest amount of free storage available

The smallest amount of storage that was free at any one time.


getCurunqssusrs

java.lang.Long getCurunqssusrs()
Getter for field CURUNQSSUSRS

Current tasks allocated a unique subspace

The current number of unique subspace user requests.


getCumunqssusrs

java.lang.Long getCumunqssusrs()
Getter for field CUMUNQSSUSRS

Cumulative number of unique subspace users

The cumulative number of unique subspace task requests for this CICS execution.


getHwmunqssusrs

java.lang.Long getHwmunqssusrs()
Getter for field HWMUNQSSUSRS

Peak number of unique subspace users

The largest number of unique subspace user requests at any one time.


getCurcmnssusrs

java.lang.Long getCurcmnssusrs()
Getter for field CURCMNSSUSRS

Current number of common subspace users

The current number of common subspace user requests.


getCumcmnssusrs

java.lang.Long getCumcmnssusrs()
Getter for field CUMCMNSSUSRS

Cumulative number of common subspace users

The cumulative number of common subspace user requests for this CICS execution.


getHwmcmnssusrs

java.lang.Long getHwmcmnssusrs()
Getter for field HWMCMNSSUSRS

Peak number of common subspace users

The largest number of common subspace user requests at any one time.


getCurralloc

java.lang.Long getCurralloc()
Getter for field CURRALLOC

Current DSA allocation

The current amount of DSA allocated.


getHwmalloc

java.lang.Long getHwmalloc()
Getter for field HWMALLOC

Peak DSA allocation

The largest amount of DSA allocated at any one time.


getExtentscurr

java.lang.Long getExtentscurr()
Getter for field EXTENTSCURR

Number of extents allocated to DSA

The number of extents allocated to the DSA.


getExtentsadded

java.lang.Long getExtentsadded()
Getter for field EXTENTSADDED

Number of extents added to DSA

The number of extents added to the DSA.


getExtentsdeltd

java.lang.Long getExtentsdeltd()
Getter for field EXTENTSDELTD

Number of extents deleted from page pool

The number of extents deleted from the page pool.


getTimewaitmvs

java.lang.String getTimewaitmvs()
Getter for field TIMEWAITMVS

Total time waiting for MVS storage

The total amount of time that CICS has been waiting for storage in this dynamic storage area.


getReqswaitmvs

java.lang.Long getReqswaitmvs()
Getter for field REQSWAITMVS

Number of requests for MVS storage causing wait

The number of requests for MVS storage causing waits.


getMemlimit

java.lang.Long getMemlimit()
Getter for field MEMLIMIT

Maximum amount of above the bar storage

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.


getGetstorsize

java.lang.Long getGetstorsize()
Getter for field GETSTORSIZE

The GETSTOR request size

The amount of storage that has been requested displayed as bytes.


getAsactive

java.lang.Long getAsactive()
Getter for field ASACTIVE

Current address space storage that is addressable

The current address space storage that can be addressed.


getHwmasactive

java.lang.Long getHwmasactive()
Getter for field HWMASACTIVE

The HWM address space that can be addressed

The peak address space storage that could be addressed.


getGdsaactive

java.lang.Long getGdsaactive()
Getter for field GDSAACTIVE

The current GDSA active

The amount of storage available for use above the bar.


getHwmgdsaactiv

java.lang.Long getHwmgdsaactiv()
Getter for field HWMGDSAACTIV

The peak GDSA active

The peak amount of storage available for use above the bar.


getAtbcushrels

java.lang.Long getAtbcushrels()
Getter for field ATBCUSHRELS

Number of GCDSA cushion releases

The number of cushion releases associated with this DSA.


getAtbcushlimit

java.lang.Long getAtbcushlimit()
Getter for field ATBCUSHLIMIT

Cushion limit

The size in bytes of the cushion for this DSA. The cushion is the amount of storage below which CICS goes short on storage.



Copyright 2008-2009 IBM Corp. All Rights Reserved.