5.23 DEFSTORE (Define main and expanded storage)
5.23.1 Function
The DEFSTORE statement is used to specify the size of the main and expanded storage. Storage is
allocated in megabytes, unless a specific unit is specified. The actual upper limit of the main and expan-
ded storage is determined by the host system's architecture, operating system, and on some systems the
amount of physical memory and paging space you have available.
The practical limit depends on the maximum amount of storage that can be obtained by the “malloc”
function (usually around 1 GB on 32-bit platforms; on 64-bit platforms the value should only be limited by
available paging space).
An additional optional argument determines the locking state of the allocated memory (page lock by host
operating system). The LOCKED option indicates that the memory is to be locked into storage while UN-
LOCKED (the default) indicates that the memory is not locked into the storage.
Please note that Hercules preserves the last locking state of DEFSTORE for each type of storage. Once
the storage is locked, any subsequent change to the storage size will honor the existing lock state of
memory unless the lock state is specified again on the DEFSTORE command.
Caution: Do not lock storage unless sufficient real memory is available to back up the request. Failure to
do so may require the host system to be rebooted.
5.23.2 Syntax
Descriptive
msize[ ] [
size[ ] [
Diagram
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
storagetype
~¬¬¬ ¬¬¬®
msize ¬¬¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬¬ ¬¬¬«
Ê xsize ¬¬¬§¬¬¬¬¬¬¬¬¬§¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬¬ ¬¬¬«
¬¬¬ ¬¬¬«
¬¬¬ T ¬¬¬
