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


dfhs3_SMADadd_subpool.html | Timestamp icon Last updated: Monday, 5 June 2017