Hercules V4.00.0 - User Reference Guide

5.44.4 Examples

Example 1:

Set the LPAR identification number to x’21’ (Format-1 CPU ID).

LPARNUM 21

Example 2:

Set the LPAR identification number to x’A’ (Format-0 CPU ID).

LPARNUM A

Example 3:

Set a basic-mode CPU ID.

LPARNUM BASIC

5.45 MAINSIZE (Main storage size)

5.45.1 Function

MAINSIZE specifies the size of the main storage. Storage is allocated in megabytes, unless a specific
unit is specified. The actual upper limit of the main storage is determined by the host system's architec-
ture, 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
“ malloc” (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 MAINSIZE. Once storage is locked, any sub-
sequent change to the main storage size will honor the existing lock state of memory unless the lock state
is specified again on the MAINSIZE command.

Caution: Do not lock main 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.45.2 Syntax

Descriptive

msize[ ]
[

Diagram

~¬¬¬ ¬¬¬®
~¬¬¬ ¬¬¬®

¬¬
msize ¬¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬¬«

K ¬¬¬«

¬¬¬«

T ¬¬¬«

P ¬¬¬«

¬¬¬
¬¬¬

5.45.3 Parameter

msize

The value of msize must be a valid decimal number. The actual upper limit is dete-
rmined by the host system's architecture, the operating system and on some sys-
tems the amount of physical memory and paging space that is available.

For storage sizes less than 16M, sizes not on a 4K boundary are rounded up to the
next 4K boundary. Otherwise, storage sizes not on a 1M boundary are rounded up
to the next 1M boundary.