8.193.3 Parameter

size

The value of xsize must be a valid decimal number. The actual upper limit is deter-
mined 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.

Storage sizes not on a 1M boundary are rounded up to the next 1M boundary. The
lower limit and default is 0.

M

‘M’ determines that the number given is specified in megabytes (multiplier 2**20).
This is the default if no unit is appended.

G

‘G’ determines that the number given is specified in gigabytes (multiplier 2**30).

T

T’ determines that the number given is specified in terabytes (multiplier 2**40). On
32-bit machines the unit terabytes is not available.

LOCK

Attempt to lock the storage (pages locked by the host operating system).

UNLOCK

Leave the store unlocked (no pages locked by the host operating system). This is
the default.

Notes:

The actual upper limit is determined by the host system’s architecture and operating system, the guest
operating system and the amount of physical memory and available paging space.

The total of MAINSIZE and XPNDSIZE on host systems with a 32-bit architecture will be limited to less
than 4G; host systems with a 64-bit architecture will be limited to less than 16E.

Use of storage sizes greater than supported by the guest operating system may generate incorrect
results or error conditions within the guest operating system.

8.193.4 Overview Storage Allocation Units

Unit

Multiplier

Name (Symbol)

IEC Name (IEC Symbol)

Restrictions

M

2**20

Megabyte (MB)

Mebibyte (MiB)

G

2**30

Gigabyte (GB)

Gibibyte (GiB)

T

2**40

Terabyte (TB)

Tebibyte (TiB)

Not on 32-bit machines

Table 24: Storage Allocation Units

8.193.5 Examples

Example 1:

Display the current size of the expanded storage.

HHC00013I Herc command: 'xpndsize'

HHC17003I EXPANDED storage is 256 MBytes 'xpndsize'; storage is not locked

Figure 344: XPNDSIZE command (display size of expanded storage)

Example 2:

Set the size of the expanded storage to 128 MB. Do not lock the memory into the storage.

HHC00013I Herc command: 'xpndsize 128'

HHC17003I EXPANDED storage is 128 MBytes 'xpndsize'; storage is not locked

Figure 345: XPNDSIZE command (set size of unlocked expanded storage)

Example 3:

Set the size of the expanded storage to 512 MB. Lock the memory into the storage.

HHC00013I Herc command: 'xpndsize 512 lock'

HHC01428I Locking expanded storage

HHC17003I EXPANDED storage is 512 MBytes 'xpndsize'; storage is locked

Figure 346: XPNDSIZE command (set size of locked expanded storage)

Previous Page Next Page