Example 2:

Set the MAXRATES interval to one day and and the start time for the interval timer to midnight of the
current day.

MAXRATES MIDNIGHT

5.49 MEMLOCK (Lock Hercules memory)

5.49.1 Function

The MEMLOCK system parameter is used to lock Hercules memory in storage. It defines the locking
state of the allocated Hercules memory (page lock by host operating system). If the Hercules memory is
locked in storage it cannot be paged out by the host operating system. This may result in some perfor-
mance improvements.

This system parameter is available if Hercules is built with option “_HAVE_MLOCKALL”. Currently
MEMLOCK is only supported under Linux host operating systems.

5.49.2 Syntax

Descriptive

OFF

Diagram

ÊÊ¬¬¬ ¬¬¬§¬¬¬ ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

OFF

5.49.3 Parameter

ON indicates that the memory is to be locked into storage.

OFF

OFF indicates that the memory is not to be locked into the storage.

5.49.4 Examples

Example 1:

Lock the Hercules memory in the storage.

MEMLOCK ON

Example 2:

Do not lock the Hercules memory in the storage.

MEMLOCK OFF

Previous Page Next Page

Extracted Text (may have errors)

Example 2:

Set the MAXRATES interval to one day and and the start time for the interval timer to midnight of the
current day.

MAXRATES MIDNIGHT

5.49 MEMLOCK (Lock Hercules memory)

5.49.1 Function

This system parameter is available if Hercules is built with option “_HAVE_MLOCKALL”. Currently
MEMLOCK is only supported under Linux host operating systems.

5.49.2 Syntax

Descriptive

OFF

Diagram

ÊÊ¬¬¬ ¬¬¬§¬¬¬ ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

OFF

5.49.3 Parameter

ON indicates that the memory is to be locked into storage.

OFF

OFF indicates that the memory is not to be locked into the storage.

5.49.4 Examples

Example 1:

Lock the Hercules memory in the storage.

MEMLOCK ON

Example 2:

Do not lock the Hercules memory in the storage.

MEMLOCK OFF

Help

Destination page number Search scope Search Text

loading

5.50 MODEL (STSI model code)

5.50.1 Function

MODEL specifies the model names returned by the STSI instruction. The optional second, third and the
fourth operands specify the capacity model name, the permanent capacity model name and the tempo-
rary capacity model name respectively.

The default model name, if the MODEL system parameter is not coded, is “EMULATOR”.

5.50.2 Syntax

Descriptive

LATOR hdwmod

[ capmod

[prmmod

[tmpmod ]]]

Diagram

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

hdwmod ¬¬¬¬«

¬¬¬¬¬¬¬«

¬¬¬¬¬ * ¬¬¬¬¬¬

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬¬ ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬ capmod ¬¬¬¬«
¬¬ prmmod ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬¬¬¬ ¬¬¬¬¬¬¬«
¬¬¬¬ ¬¬¬¬¬¬« ¬¬¬ tmpmod ¬¬¬«

¬¬¬¬¬¬ * ¬¬¬¬
¬¬¬¬¬ * ¬¬¬ ¬¬¬¬¬ ¬¬¬¬¬¬«

¬¬¬¬¬ * ¬¬¬

5.50.3 Parameter

hdwmodel

This specifies the hardware model name. This can be any name with a maximum
length of 16 characters. Valid characters are A-Z and 0-9. Specifying a “=” resets
the hardware model to “EMULATOR”; specifying an “*” leaves the current hardware
model name intact. If the MODEL system parameter is not specified in the configu-
ration file then the default name is “EMULATOR”.

capmodel

This optional parameter specifies the capacity model name. The capmodel can be
any name with a maximum length of 16 characters. Valid characters are A-Z and 0-
9. Specifying a “=” copies the current hardware model name to the capacity model;
specifying an “*” leaves the current capacity model name intact. The default capa-

city model name is “EMULATOR”.

prmmodel

This specifies the permanent capacity model name. The prmmodel can be any
name with a maximum length of 16 characters. Valid characters are A-Z and 0-9.
Specifying a “=” copies the current capacity model name to the permanent capacity
model; specifying an “*” leaves the current permanent capacity model name intact.
The default permanent capacity model name is a null string.

tmpmodel

This specifies the temporary capacity model name. The tmpmodel can be any
name with a maximum length of 16 characters. Valid characters are A-Z and 0-9.
Specifying a “=” copies the current permanent capacity model name to the tempo-
rary capacity model; specifying an “*” leaves the current temporary capacity model
name intact. The default temporary capacity model name is a null string.

5.50.4 Examples

Example 1:

Set the model name returned by the STSI instruction to “EMULATOR”.

MODEL EMULATOR

Example 2:

Set all model names returned by the STSI instruction to “EMULATOR”.

MODEL EMULATOR EMULATOR EMULATOR EMULATOR

MODEL EMULATOR = = =

Example 3:

Set all capacity model names returned by the STSI instruction to “HERCULES”, but leave the hardware
model name as is.

MODEL * HERCULES HERCULES HERCULES

Previous Page Next Page

Extracted Text (may have errors)

5.50 MODEL (STSI model code)

5.50.1 Function

The default model name, if the MODEL system parameter is not coded, is “EMULATOR”.

5.50.2 Syntax

Descriptive

LATOR hdwmod

[ capmod

[prmmod

[tmpmod ]]]

Diagram

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

hdwmod ¬¬¬¬«

¬¬¬¬¬¬¬«

¬¬¬¬¬ * ¬¬¬¬¬¬

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬¬ ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬ capmod ¬¬¬¬«
¬¬ prmmod ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬¬¬¬ ¬¬¬¬¬¬¬«
¬¬¬¬ ¬¬¬¬¬¬« ¬¬¬ tmpmod ¬¬¬«

¬¬¬¬¬¬ * ¬¬¬¬
¬¬¬¬¬ * ¬¬¬ ¬¬¬¬¬ ¬¬¬¬¬¬«

¬¬¬¬¬ * ¬¬¬

5.50.3 Parameter

hdwmodel

capmodel

city model name is “EMULATOR”.

prmmodel

tmpmodel

5.50.4 Examples

Example 1:

Set the model name returned by the STSI instruction to “EMULATOR”.

MODEL EMULATOR

Example 2:

Set all model names returned by the STSI instruction to “EMULATOR”.

MODEL EMULATOR EMULATOR EMULATOR EMULATOR

MODEL EMULATOR = = =

Example 3:

Set all capacity model names returned by the STSI instruction to “HERCULES”, but leave the hardware
model name as is.

MODEL * HERCULES HERCULES HERCULES

5.47.4 Examples

Example 1:

Set the maximum number of installed processor engines to 8.

MAXCPU 8

5.48 MAXRATES (MIPS/SIO rate reporting interval)

5.48.1 Function

MAXRATES sets the MIPS/SIO rate reporting interval. When the interval is expired a MAXRATES com-
mand is automatically issued. The current rates will also be displayed during shutdown of Hercules. The
default for the MAXRATES interval (if not coded in the configuration file) is 1440 minutes (1 day).

5.48.2 Syntax

Descriptive

]

Diagram

ÊÊ¬¬¬ ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬¬«

5.48.3 Parameter

1440

This is the default that takes place if there is no MAXRATES interval is specified in
the configuration file and sets the interval to 1440 minutes (1 day).

interval

This specifies the interval time in minutes. Changes to the MAXRATES interval that
are other than “MIDNIGHT” will set the current interval start time to the present; this
includes a value of “1440”.

MIDNIGHT

Sets the interval to 1440 minutes (1 day) and the start time for the interval timer to
midnight of the current day. This will cause the MAXRATE statistics to be date
aligned.

5.48.4 Examples

Example 1:

Set the MAXRATES interval to 60 minutes.

MAXRATES 60

Previous Page Next Page

5.49 MEMLOCK (Lock Hercules memory)

5.49.1 Function

5.49.2 Syntax

5.49.3 Parameter

5.49.4 Examples

Page 211. Preface click to expand contents

Page 242. Related Publications click to expand contents

Page 253. Summary of changes click to expand contents

Page 284. Hercules Configuration File click to expand contents

Page 405. System Parameter Descriptions click to expand contents

Page 1706. Device Definition Descriptions click to expand contents

Page 2327. Hercules Console click to expand contents

Page 2598. Console Command Descriptions click to expand contents