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

Appendix E. Build Options for System
Parameters and Console Commands
”.

System Parameter

Description

#

Comment line

*

Comment line

ARCHLVL

Set architecture level

ARCHMODE

Set initial architecture mode (alias for ARCHLVL
system parameter)

ASN_AND_LX_REUSE / ALRF

ESAME ASN and LX REUSE feature (deprecated,
use ARCHLVL instead)

AUTO_SCSI_MOUNT

Automatic SCSI tape mounts (deprecated, use
SCSIMOUNT instead)

AUTOINIT

Automatic creation of empty tape files

AUTOMOUNT

Tape automount root directory

CAPPING

CPU capping feature

Previous Page Next Page

Extracted Text (may have errors)

o $TEST (Custom test command) o $ZAPCMD (Enable or disable system parameters and console commands) o ARCHLVL (Set architecture level) o AUTOINIT (Display or set the automatic creation of empty tape files) o CACHESTATS (Display cache statistics) o CAPPING (Display or set CPU capping value) o CMDLEVEL (Display or set current command group) o CMDSEP (Display or set current command line separator) o CNSLPORT (Display or set console port) o CODEPAGE (Display or set codepage conversion table) o CP_UPDT (Create or modify user character conversion table) o CPUIDFMT (Display or set format BASIC / 0 / 1 STIDP generation) o CPUMODEL (Display or set CPU model number) o CPUPRIO (Display or set CPU thread process priority) o CPUSERIAL (Display or set CPU serial number) o CPUVERID (CPU version code) o DEFSTORE (Display or define main and expanded storage values) o DEVPRIO (Display or set device threads process priority) o DIAG8CMD (Display or set DIAGNOSE 8 command option) o DIR (Display file and directory listing) o ENGINES (Set processor engines type) o EXEC (Execute a REXX script) o FCB (Display current FCB or load new FCB image) o HERCPRIO (Display or set Hercules process priority) o HTTP (Start, stop, modify and display HTTP server) o ICOUNT (Display individual instruction counts) o KD (Clear held messages) o LEGACYSENSEID (Display or set SENSE ID CCW (x'E4') feature) o LS (Display file and directory listing) o MAINSIZE (Display or set main storage size) o MANUFACTURER (Display or set STSI manufacturer code) o MAXCPU (Display or set maximum number of CPUs) o MEMLOCK (Lock Hercules memory) o MODEL (Display or set STSI model code) o MODPATH (Display or set dynamic load module path) o MSGLEVEL (Display or set the current message display output) o MT (Control magnetic tape operation) o NUMCPU (Display or set number of emulated CPUs)
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.

Help

loading