Display CPU ID)
Display CPU ID)
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.
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 “
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
Powered by Tizra® |
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)
System Parameter
Description
IGNORE
Ignore subsequent INCLUDE errors
INCLUDE
Include configuration file
IODELAY
I/O interrupt wait time (LINUX)
LDMOD
Additional dynamic load modules
LEGACYSENSEID
SENSE ID CCW (x’E4’) feature
LOADPARM
IPL parameter
LOGOPT
Logging options
LPARNAME
LPAR name returned by DIAG x'204'
LPARNUM
LPAR identification number
MAINSIZE
Main storage size
MANUFACTURER
STSI manufacturer code
MAXCPU
Maximum number of CPUs
MAXRATES
MIPS/SIO rate reporting interval
MEMLOCK
Lock Hercules memory
MODEL
STSI model code
MODPATH
Dynamic load module path
MOUNTED_TAPE_REINIT
Control tape initialization
MSGHELD
Timeout value of held messages
MSGLEVEL
Message display output
MSGLVL
Message display output (alias for MSGLEVEL)
NUMCPU
Number of emulated CPUs
NUMVEC
Number of vector facilities
OSTAILOR
Tailor trace information for specific oprating system
PANRATE
Console refresh rate
PANTITLE
Console window title
PGMPRDOS
LPP license setting
Powered by Tizra® |
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.
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 “
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)
This section describes briefly the various changes that have been made in the “User Reference Guide”
related to the previous edition. The most significant changes made in this edition of the manual are the
following:
Powered by Tizra® |
The Hercules “General Information” manual provides you an overview of the ideas and concepts of the
Hercules Emulator as well as a documentation of the emulator’s functionality. It explains what Hercules
does and does not do. It helps you decide if the software fits your needs fulfills your requirements.
The Hercules "Installation Guide" shows you how to install Hercules and all related optional and required
software components under the Microsoft Windows, Linux and Apple MacIntosh OS X operating systems.
After going through the installation guide you will have a working emulator environment ready to IPL a
S370, S/390 or z/Architecture mainframe operating system.
The Hercules “User Reference” leads you through all aspects of the emulator’s operation. It provides
instruction in the operation of the Hercules Emulator with and without the Hercules GUIs. The usage
details for the utilities are covered in the “Hercules Utilities” guide.
After reading this manual you should be able to work with Hercules, to create a configuration file and to
use Hercules commands through the console.
The Hercules “Operations and Utilities Guide” describes the operation of Hercules as well as additional
utilities that are delivered together with the emulator. Selected utilities from third-party suppliers are also
covered in this manual.
After reading this manual you should have the knowledge to operate Hercules and use the right utility for
a certain housekeeping task within the Hercules environment. You should also be able to create virtual
devices and understand backup / restore procedures.
The “Messages and Codes” manual provides a detailed explanation of all Hercules related messages. It
is the primary source for troubleshooting and debugging if you experience problems with Hercules.
The Hercules "Reference Summary" booklet lists all the system parameters, device definitions, console
commands, Hercules utilities etc. along with their arguments.
This booklet is intended as a quick reference guide for experienced users. Consult the Hercules "User
Reference Guide" and “Utilities Guide” for more detailed and additional information.
This section describes briefly the various changes that have been made in the “User Reference Guide”
related to the previous edition. The most significant changes made in this edition of the manual are the
following: