o NUMVEC (Display or set number of vector facilities) o PANTITLE (Display or set console window title) o PGMPRDOS (Set LPP license setting) o PLANT (Display or set STSI plant code) o PTP (Enable / disable PTP debugging) o QCPUID (
Display CPU ID) o QPFKEYS (Display the current PF key settings) o QPID (Display process ID of Hercules) o QPORTS (Display TCP/IP ports in use) o QPROC (Display processors type and utilization) o QSTOR (Display main and expanded storage values) o QUITMOUT (Display or set quit timeout value) o SCPECHO (Display or set echo to console and history of SCP replies) o SCPIMPLY (Display or set option to pass non-Hercules commands to the SCP) o SHCMDOPT (Display or set shell command option) o SHRDPORT (Set shared device server port) o SRVPRIO (Display or set server threads process priority) o SYMPTOM (Instruction trace display option) o SYSEPOCH (Set base date for TOD clock) o TODPRIO (Display or set timer thread process priority) o TZOFFSET (Set TOD clock offset from GMT) o XPNDSIZE (Display or set expanded storage size) o YROFFSET (Set TOD clock offset from actual date) The description of the Hercules Utilities has been moved to the “Operations and Utilities Guide”. Chapter 12 ( The Run-Commands File ) added. Chapter 13 ( The “Hercules Automatic Operator” (HAO) Facility ) added. Chapter 14 ( REXX Support ) added. Appendix D. Hercules Command Groups added. Appendix E. Build Options for System Parameters and Console Commands added. Appendix F. Environment Variables added. Appendix H. Links : List of links updated. Many additional examples have been added. Most output samples from console commands have been replaced.

4. Hercules Configuration File

4.1 The Configuration File

This chapter describes the configuration file for the Hercules Emulator. By default the configuration file is
named “hercules.cnf” or “hercules.conf”. It is located in the configuration directory, refer to the Hercules
Installation Guide for details of the directory structure. The configuration file contains the processor defini-
tions in the system parameters section, the device layout in the device definitions section and Hercules
runtime parameters also in the system parameters section.

The configuration file - especially the device definition part - is roughly equivalent to the IOCDS definitions
found on a real mainframe environment. It is an ASCII text file that is read and interpreted by the Hercules
Emulator during its initialization phase.

4.2 System Parameters

The system parameters describe the processor definition and some Hercules internal runtime parame-
ters.

The processor definitions include the processor model, CPU serial number, memory configuration and
architecture mode. They describe the processor hardware that is to be emulated.

The Hercules runtime parameters define values that Hercules requires as an emulated environment.
These parameters include values like port numbers, directory paths and priorities.

The following table shows an overview of all valid system parameters. Please note that the availability of
certain system parameters depends on the build options used when Hercules was compiled. For a list of
all build options and the related system parameters please consult “