The ‘logopt’ system parameter or console command has no effect when using the WinGUI. Prefixing the
messages is only influenced over the GUI settings. The following figure shows the log messages using all
prefixing options (date, time and process ID) as specified above.

.

.

.

2010/06/18 19:12:18.071 000008E4 HHC01416I Build information:

2010/06/18 19:12:18.071 000008E4 HHC01417I Windows (MSVC) build for AMD64

2010/06/18 19:12:18.071 000008E4 HHC01417I Modes: S/370 ESA/390 z/Arch

2010/06/18 19:12:18.071 000008E4 HHC01417I Max CPU Engines: 8

2010/06/18 19:12:18.071 000008E4 HHC01417I Using fthreads Threading Model

2010/06/18 19:12:18.072 000008E4 HHC01417I Using FishIO

2010/06/18 19:12:18.072 000008E4 HHC01417I Dynamic loading support

2010/06/18 19:12:18.072 000008E4 HHC01417I Using shared libraries

2010/06/18 19:12:18.072 000008E4 HHC01417I HTTP Server support

2010/06/18 19:12:18.072 000008E4 HHC01417I No SIGABEND handler

2010/06/18 19:12:18.072 000008E4 HHC01417I Regular Expressions support

2010/06/18 19:12:18.072 000008E4 HHC01417I Automatic Operator support

.

.

.

Figure 8: Message prefixing using the console of the Hercules WinGUI

7.5 Programmed Function Key (PF Key) Support

The Hercules console supports the usage of PF keys. The next sections show how to define and use PF
keys with Hercules.

7.5.1 Usage

The command to be assigned to the PF key has to be defined with a DEFSYM statement. This can be
done through a DEFSYM system parameter statement in the Hercules configuration file or through a
panel command (manually from the console or coded in the Hercules run-commands file).

On Windows systems PF keys PF01 to PF48 are assignable, on non-Windows systems PF01 to PF20.
The following special keys must be used to access the PF keys:

PF01-PF12 Press PF key only

PF13-PF24 Press SHIFT and PF key

PF25-PF36 Press CTRL and PF key

PF37-PF48 Press ALT and PF key

7.5.2 Syntax

Descriptive

nn

command [&n &* &$ [...]]"

Diagram

nn ¬¬¬¬¬¬¬¬Ê

¬¬¬
¬¬¬

command ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ " ¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬¬ ¬¬¬¬«



~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®

¬¬¬


¬¬¬ ¬¬¬§¬ ¬¬ &n ¬¬¬§¬¬¬¬¬¬

¬¬¬ &* ¬¬¬«

&$ ¬¬¬

7.5.3 Parameter

PFnn This identifies the PF key to be defined, where nn is a number from 01 to 48. This
number must be specified with the leading zero for PF keys 1 - 9 (PF01, …, PF09).

SUBST This indicates that the PF key data might contain substitution placeholders (&n, see
below).

IMMED This indicates the point in time when the PF key is processed. IMMED indicates that the
PF data is processed when the PF key is pressed.

DELAY This indicates the point in time when the PF key is processed. DELAY indicates that the
PF data is displayed on the command line when the PF key is pressed. The data may
then be modified if necessary. To finally process the PF data the “ENTER” key must be
pressed.

HERC The command target for the assigned command is the Hercules Emulator.

SCP The command target for the assigned command is the System Control Program (the
guest operating system running under Hercules).

PSCP The assigned command is a System Control Program (guest operating system) priority
command.

command This defines the command that is to be assigned to the PF key.

&n A substitution placeholder is identified by an ampersand (“&”), followed by a decimal
number from 0 to 9. If two ampersands are detected (“&&”) then a single ampersand is
substituted.

&* Variable “&*” represents all of the remaining tokens beyond the last substitution variable
used. A single space is added between each token. Tokens can be enclosed in paired
single or double quotes. The quotes are included as part of the token string.

&$ Variable “&$” represents the data remaining on the line past token 9. Variable “$*” (see
below) does include the data from “&$”.A single space is added between each token.