Hercules V4.00.0 - User Reference Guide

8.192 VERSION (Display version information)

8.192.1 Function

The version command is used to display various version and build information about the Hercules
emulator.

8.192.2 Syntax

Descriptive

Diagram

¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ ¬¬¬¬¬¬¬¬¬ÊÍ

8.192.3 Parameter

None.

8.192.4 Examples

Example 1:

Display the Hercules version information.

HHC00013I Herc command: 'version'

HHC01413I Hercules version 3.07-svn-6583

HHC01415I Built on Sep 24 2010 at 23:46:56

HHC01416I Build information:

HHC01417I Windows (MSVC) build for i386

HHC01417I Modes: S/370 ESA/390 z/Arch

several lines not displayed

HHC01417I Regular Expressions support

HHC01417I Automatic Operator support

HHC01417I Machine dependent assists: cmpxchg1 cmpxchg4 cmpxchg8 fetch_dw store_dw

HHC01417I Running on GOOFY Windows-6.1.7600. 7 Ultimate Edition, 32-bit i686 MP=8

Figure 343: VERSION command

8.193 XPNDSIZE (Display or set expanded storage size)

8.193.1 Function

The XPNDSIZE command is used to specify the size of the main storage in megabytes. Given without an
argument the XPNDSIZE command displays the current size of the expanded storage. Storage is alloca-
ted in megabytes, unless a specific unit is specified. The actual upper limit of the expanded 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 lower limit is 0.

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).

When increasing the expanded size Hercules attempts to allocate first the new storage. If the new allo-
cation is successful then the previously allocated memory will be freed. This is to prevent a situation
where the old memory is freed first, then the new allocation fails and a reallocation of the memory in the
previous size also fails because of storage fragmentation and therefore leaving Hercules without memory.

When decreasing the expanded storage the memory will stay allocated in the previous size but the
storage size will appear as decreased. Subsequent increases will not reallocate memory unless they go
over the already allocated amount.

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 XPNDSIZE. Once storage is locked, any
subsequent change to the expanded storage size will honor the existing lock state of memory unless the
lock state is specified again on the XPNDSIZE command.

Caution: Do not lock expanded storage unless sufficient real memory is available to back up the request.
Failure to do so may require the host system to be rebooted.