8.115 PANTITLE (Display or set console window title)

8.115.1 Function

The PANTITLE command displays or sets 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 dif-
ferent Hercules sessions when running more than one instance of Hercules on the same machine. Given
without an argument the PANTITLE command displays the current console window title.

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 a disabled wait state.

AMBER One or more CPUs are not running.

GREEN Everything is working correctly.

8.115.2 Syntax

Descriptive

[text "text text text" ""

Diagram

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




¬¬¬¬¬ text ¬¬¬¬¬¬¬¬¬«




"text text text" ¬¬¬«




""

8.115.3 Parameter

text

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

8.115.4 Examples

Example 1:

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

HHC00013I Herc command: 'pantitle "Hercules Emulator HMC"'

HHC02204I pantitle set to Hercules Emulator HMC

Figure 222: PANTITLE command (set a new console window title)

Example 2:

Remove the current window console title.

HHC00013I Herc command: 'pantitle ""'

HHC02204I pantitle set to (none)

Figure 223: PANTITLE command (remove console window title)

Previous Page Next Page