System Generation Statements › XA STORAGE POOL Statement—Defines the 31-Bit Storage Pools › XA STORAGE POOL Statement Parameters

XA STORAGE POOL Statement Parameters

XA STOrage POOl storage-pool-number

Specifies a number that uniquely identifies a 31-bit storage pool.

Storage-pool-number must be an integer in the range 128 through 254.

Note: For more information about storage pools, see Storage Pools.

CONtains types

Specifies the types of storage the named storage pool can accommodate.

Storage types must be enclosed by parentheses. If you specify more than one storage type, each type must be separated from the next by a blank or a comma.

DATabase

Specifies the storage pool can contain storage for DMCL buffers. The DMCL buffers hold copies of database pages.

SHAred

Specifies the storage pool can contain storage that is designated shared.

SHARED-Kept

Specifies the storage pool can contain storage that is designated shared kept.

TERminal

Specifies the storage pool can contain storage for terminal buffers.

USEr

Specifies the storage pool can contain storage that is designated user.

USER-Kept

Specifies the storage pool can contain storage that is designated user kept.

ALL

Specifies the storage pool can contain all of the storage types listed above.

ALL is the default when you omit the CONTAINS TYPES parameter from the XA STORAGE POOL statement.

CUShion is storage-cushion-size

Specifies amount of free storage, in 1K bytes, to be reserved in the specified storage pool to help prevent exhausting space in the storage pool.

Storage-cushion-size must be an integer in the range 1 through 16,383. The default is 1.

Note: Users can override this parameter at runtime with the DCMT VARY STORAGE POOL CUSHION command.

PGFix

For virtual storage systems only, specifies pages are fixed in the storage pool as they are allocated.

NOPgfix

For virtual storage systems only, suppresses page fixing.

NOPGFIX is the default when you specify neither PGFIX nor NOPGFIX in the XA STORAGE POOL statement.

RELocatable threshold is

Specifies the point at which the system is to write relocatable storage in the named storage pool to the scratch area (DDLDCSCR) of the data dictionary.

threshold-percentage

Directs the system to write relocatable storage to the scratch area across a pseudo-converse when the amount of used space in the storage pool exceeds the specified threshold.

Threshold-percentage must be an integer in the range 0 through 100. A value of 0 is synonymous with YES. A value of 100 is synonymous with NO.

YES

Directs the system always to write relocatable storage to the scratch area across a pseudo-converse.

YES is the default when you omit the RELOCATABLE THRESHOLD parameter from the XA STORAGE POOL statement.

NO

Directs the system never to write relocatable storage to the scratch area across a pseudo-converse.

Note: For more information about relocatable storage, see Storage Pools.

SIZe is storage-pool-size

Specifies the amount of storage, in 1K bytes, to be made available for system and program variable storage.

Storage-pool-size must be an integer in the range 1 through 2,097,151. The default is 1.

Note: For more information about runtime storage allocation, see the CA IDMS System Operations Guide.