5.60.4 Examples

Example 1:

Set the console window title-bar string to “Hercules Emulator HMC”.

PANTITLE "Hercules Emulator HMC"

Example 2:

Set the console window title-bar string to “Hercules_HMC”.

PANTITLE Hercules_HMC

5.61 PGMPRDOS (LPP license setting)

5.61.1 Function

PGMPRDOS specifies whether or not Hercules will run licensed program product (LPP) ESA or
z/Architecture operating systems.

5.61.2 Syntax

Descriptive

Diagram

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

5.61.3 Parameter

RESTRICTED

When PGMPRDOS is set to RESTRICTED, Hercules will stop all CPUs when a
licensed program product operating systems is detected. RESTRICTED is the
default.

LICENSED

Setting PGMPRDOS to LICENSED will allow you to run licensed program product
operating systems normally. This parameter has no effect on Linux/390, Linux for
z/Series, or any 370-mode operating system.

If you are running Hercules under the Windows GUI a pop up window appears
during startup which must be acknowledged before the startup continuous.

5.61.4 Examples

Example 1:

Allow licensed program product operating systems to run normally.

PGMPRDOS LICENSED

Example 2:

Disallow licensed program product operating systems to run.

PGMPRDOS RESTRICTED

Previous Page Next Page

Extracted Text (may have errors)

5.60.4 Examples

Example 1:

Set the console window title-bar string to “Hercules Emulator HMC”.

PANTITLE "Hercules Emulator HMC"

Example 2:

Set the console window title-bar string to “Hercules_HMC”.

PANTITLE Hercules_HMC

5.61 PGMPRDOS (LPP license setting)

5.61.1 Function

PGMPRDOS specifies whether or not Hercules will run licensed program product (LPP) ESA or
z/Architecture operating systems.

5.61.2 Syntax

Descriptive

Diagram

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

5.61.3 Parameter

RESTRICTED

When PGMPRDOS is set to RESTRICTED, Hercules will stop all CPUs when a
licensed program product operating systems is detected. RESTRICTED is the
default.

LICENSED

If you are running Hercules under the Windows GUI a pop up window appears
during startup which must be acknowledged before the startup continuous.

5.61.4 Examples

Example 1:

Allow licensed program product operating systems to run normally.

PGMPRDOS LICENSED

Example 2:

Disallow licensed program product operating systems to run.

PGMPRDOS RESTRICTED

Help

Destination page number Search scope Search Text

loading

Example 2:

Set the panel refresh rate to 50 milliseconds.

PANRATE FAST

PANRATE 50

Example 3:

Set the panel refresh rate to 500 milliseconds.

PANRATE SLOW

PANRATE 500

5.60 PANTITLE (Console window title)

5.60.1 Function

PANTITLE specifies an optional console window title-bar string to be used in place of the default title
supplied by the windowing system. This option allows one to distinguish between different Hercules
sessions when running more than one instance of Hercules on the same machine.

The PANTITLE option takes effect only when the Hercules console is displayed on an ‘xterm’ terminal
(commonly used on Unix systems) or in a Windows command prompt window. Note that this option has
no effect when Hercules is run under the control of the Hercules Windows GUI since Hercules's console
window is hidden in favour of using the GUI's window instead.

The default console title is a string consisting of the following information:

“ LPARNAME – SYSTYPE * SYSNAME * SYSPLEX – System Status: colour”

SYSTYPE, SYSNAME and SYSPLEX are populated by the system call SCLP Control Program Identi-
fication. If any of these values is blank, then that field is not presented in the console title. The system
status colour has following meanings:

RED One or more CPUs are in wait state.

AMBER One or more CPUs are not running.

GREEN Everything is working correctly.

5.60.2 Syntax

Descriptive

text "text text text" ""

Diagram

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

"text text text" ¬¬¬«

¬¬¬¬¬¬¬¬
"" ¬¬¬¬¬¬¬¬¬

5.60.3 Parameter

text

Specifies the console window title-bar string to be used. If the value contains any
blanks it must be enclosed within double-quotes ("). An empty string ("") will remove
the default console title.

Previous Page Next Page

Extracted Text (may have errors)

Example 2:

Set the panel refresh rate to 50 milliseconds.

PANRATE FAST

PANRATE 50

Example 3:

Set the panel refresh rate to 500 milliseconds.

PANRATE SLOW

PANRATE 500

5.60 PANTITLE (Console window title)

5.60.1 Function

The default console title is a string consisting of the following information:

“ LPARNAME – SYSTYPE * SYSNAME * SYSPLEX – System Status: colour”

RED One or more CPUs are in wait state.

AMBER One or more CPUs are not running.

GREEN Everything is working correctly.

5.60.2 Syntax

Descriptive

text "text text text" ""

Diagram

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

"text text text" ¬¬¬«

¬¬¬¬¬¬¬¬
"" ¬¬¬¬¬¬¬¬¬

5.60.3 Parameter

text

Specifies the console window title-bar string to be used. If the value contains any
blanks it must be enclosed within double-quotes ("). An empty string ("") will remove
the default console title.

5.62 PLANT (STSI plant code)

5.62.1 Function

PLANT specifies the plant name returned by the STSI instruction.

5.62.2 Syntax

Descriptive

name

Diagram

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

name

5.62.3 Parameter

name

Any name with a maximum length of four characters. Valid characters are A-Z and
0-9. If PLANT is not specified in the configuration file then the default name is ZZ.

5.62.4 Examples

Example 1:

Specify “HERC” as the plant name returned by the STSI instruction.

PLANT HERC

5.63 QUITMOUT (Quit timeout value)

5.63.1 Function

QUITMOUT is used for setting the timeout value for a second QUIT, EXIT or SSD command if Hercules is
built with the option “OPTION_SHUTDOWN_CONFIRMATION”. If Hercules is built without this option,
then the QUITMOUT system parameter cannot be specified in the configuration file.

5.63.2 Syntax

Descriptive

Diagram

ÊÊ¬¬¬ ¬¬¬ nn ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

5.63.3 Parameter

This specifies the timeout value where nn must be in the range of 2 to 60 seconds.
If the timeout value is 0 then no second QUIT, EXIT or SSD command is neces-
sary.

5.63.4 Examples

Example 1:

Set the quit timeout value to 30 seconds.

QUITMOUT 30

Previous Page Next Page

Extracted Text (may have errors)

5.62 PLANT (STSI plant code)

5.62.1 Function

PLANT specifies the plant name returned by the STSI instruction.

5.62.2 Syntax

Descriptive

name

Diagram

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

name

5.62.3 Parameter

name

Any name with a maximum length of four characters. Valid characters are A-Z and
0-9. If PLANT is not specified in the configuration file then the default name is ZZ.

5.62.4 Examples

Example 1:

Specify “HERC” as the plant name returned by the STSI instruction.

PLANT HERC

5.63 QUITMOUT (Quit timeout value)

5.63.1 Function

5.63.2 Syntax

Descriptive

Diagram

ÊÊ¬¬¬ ¬¬¬ nn ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

5.63.3 Parameter

This specifies the timeout value where nn must be in the range of 2 to 60 seconds.
If the timeout value is 0 then no second QUIT, EXIT or SSD command is neces-
sary.

5.63.4 Examples

Example 1:

Set the quit timeout value to 30 seconds.

QUITMOUT 30

5.60.4 Examples

5.61 PGMPRDOS (LPP license setting)

5.61.1 Function

5.61.2 Syntax

5.61.3 Parameter

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