SMAD gate, ADD_SUBPOOL function
The ADD_SUBPOOL function of the SMAD gate is used to create a new subpool with given attributes.
Input Parameters
- BOUNDARY
- is the boundary on which all elements within the subpool must be aligned. The boundary must be a power of two in the range 8 through 4096.
- ELEMENT_CHAIN
- indicates whether a chain of the addresses and lengths of the elements is to be kept.
- Values for the parameter are:
- NO
- YES
- ELEMENT_TYPE
- indicates whether the subpool elements are of fixed or variable length.
- Values for the parameter are:
- FIXED
- VARIABLE
- INITIAL_FREE
- is the size of the initial free storage area for the subpool.
- LOCATION
- specifies whether all elements within the subpool must be allocated below the maximum 24-bit address, or may be allocated anywhere.
- Values for the parameter are:
- ANY
- BELOW
- SUBPOOL_NAME
- is the 8-character name by which the subpool is known.
- USAGE
- indicates whether the subpool is for task or domain use.
- Values for the parameter are:
- DOMAIN
- TASK
- ACCESS
- Optional Parameter
- The type of storage access required.
- Values for the parameter are:
- CICS
- READ_ONLY
- USER
- FIXED_LENGTH
- Optional Parameter
- is the element length for a fixed-length subpool.
- LOCK_POOL
- Optional Parameter
- Indicates if access to the subpool is to be controlled by a lock.
- Values for the parameter are:
- NO
- YES
- STORAGE_CHECK
- Optional Parameter
- indicates whether storage zone checking is to be enabled for this subpool.
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- INSUFFICIENT_STORAGE
- The following values are returned when RESPONSE is INVALID:
- DUPLICATE_SUBPOOL_NAME
- INVALID_BOUNDARY
- INVALID_FIXED_LENGTH
- INVALID_INITIAL_FREE
- INVALID_SUBPOOL_NAME
- LOCK_FAILED
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- SUBPOOL_TOKEN
- is the token identifying the newly created subpool.
- DSA_NAME
- Optional Parameter
- is the name of the CICS dynamic storage area (DSA) in which the subpool resides.
- Values for the parameter are:
- CDSA
- ECDSA
- ERDSA
- ESDSA
- EUDSA
- RDSA
- SDSA
- UDSA