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

System Parameter

Description

CCKD

Compressed CKD DASD options

CMDLEVEL

Set command group

CMDLVL

Set command group (alias for CMDLEVEL)

CMDSEP

Command line seperator

CNSLPORT

Console port

CODEPAGE

Codepage conversion table

CONKPALV

Console and telnet clients keep-alive option

CP_UPDT

User character conversion table

CPUIDFMT

Set format BASIC / 0 / 1 STIDP generation

CPUMODEL

CPU model number

CPUPRIO

CPU thread process priority

CPUSERIAL

CPU serial number

CPUVERID

CPU version code

DEFSTORE

Define main and expanded storage

DEFSYM

Define a symbol

DEVPRIO

Device threads process priority

DEVTMAX

Maximum number of device threads

DIAG8CMD

DIAGNOSE 8 command option

ECPSVM

ECPS:VM support status (VM)

ENGINES

Processor engines type

HAO

Hercules Automatic Operator

HERCLOGO

Hercules logo file

HERCPRIO

Hercules process priority

HTTP

HTTP server configuration

HTTPPORT

HTTP server port (deprecated, use HTTP instead)

HTTPROOT

HTTP server root directory (deprecated, use HTTP
instead)

Previous Page Next Page