This page describes the configuration file for the Hercules S/370 and ESA/390 emulator.
The configuration file hercules.cnf contains the processor and device layout. It is roughly equivalent to the IOCDS on a real System/390. The configuration file is an ASCII text file.
#
# System parameters
#
CPUSERIAL 000611
CPUMODEL 3090
MAINSIZE 64
XPNDSIZE 0
CNSLPORT 3270
NUMCPU 1
NUMVEC 1
LOADPARM 0120....
SYSEPOCH 1900
TZOFFSET -0500
OSTAILOR LINUX
PANRATE FAST
#
# Device definitions
#
000A 1442 adrdmprs.rdr
000C 3505 jcl.txt ascii trunc
000D 3525 pch00d.txt ascii
000E 1403 prt00e.txt
001F 3270
0120 3380 mvsv5r.120
0121 3380 mvsv5d.121
0122 3380 mvswk1.122
0140 3370 dosres.140
0141 3370 syswk1.141
0200 3270
0201 3270
0202 3270
0300 3370 sysres.300
0400 3088 0401 192.168.0.2 vmnet
0401 3088 0400 192.168.0.2 vmnet
0580 3420 ickdsf.ipl
0581 3420 /dev/st0
0582 3420 /cdrom/tapes/uaa196.tdf
Blank lines, and lines beginning with a pound sign ('#' - "hash" to Europeans) or an asterisk, are treated as comments.
System parameters may appear in any order but they must precede all device records. Each system parameter must be on a separate line. The following system parameters may be specified:
CPUID xxxxxx
CPUMODEL xxxx
MAINSIZE nnnn
nnnn
is a decimal number
in the range is 2 to 2048
XPNDSIZE nnnn
nnnn
is a decimal number
in the range is 0 to 2048
CNSLPORT nnnn
NUMCPU nn
MAX_CPU_ENGINES
in the file hercules.h has a value of more than 1.
Multiprocessor emulation works best
if your system has more than physical CPU, but you can
emulate multiple CPUs even on a uniprocessor system
and you may still achieve a small performance benefit.
There is no point in specifying NUMCPU greater than 1 unless
your operating system is able to support multiple CPUs, and
if you do not need multiprocessor emulation then setting
MAX_CPU_ENGINES to 1 at compile time may improve performance.
NUMVEC nn
LOADPARM xxxxxxxx
SYSEPOCH yyyy
SYSEPOCH 1988
is recommended.
This makes the year 2000 appear to be 1972.
TZOFFSET ±hhmm
-0500
for US Eastern Standard
Time, -0800
for US Pacific Standard Time).
For timezones east of Greenwich, specify a positive value
(example: +0100
for Central European Time,
+0930
for South Australian Time).
TODDRAG nn
OSTAILOR OS/390 | VM | LINUX
PANRATE SLOW | FAST | nn
A comment preceded by a pound sign may be appended to any system parameter statement.
The remaining statements in the configuration file are device records. There must be one device record for each I/O device. The format of the device record is:
devnum devtype [arguments]
where:
devnum
devtype
Device type | Description | Emulated by |
---|---|---|
3270 | Local non-SNA 3270 | TN3270 client connection |
1052, 3215 | Console printer-keyboards | Telnet client connection |
1442, 2501, 3505 | Card readers | Disk file (ASCII or EBCDIC) |
3525 | Card punch | Disk file (ASCII or EBCDIC) |
1403, 3211 | Line printers | Disk file (ASCII) |
3420, 3480 | Tape drives | Disk file, CDROM, or SCSI tape |
3088 | Channel-to-channel adapters | TCP socket |
3310, 3370, 9336 0671 |
FBA direct access storage devices | Disk file |
2311, 2314, 3330 3340, 3350, 3375 3380, 3390 |
CKD direct access storage devices | Disk file |
arguments
If neither
Each file on the virtual tape can be in one of three
formats:
If you have any IBM manuals in Bookmanager format on CDROM,
you can see some examples of TDF files in the
\TAPES directory on the CDROM.
ebcdic
ascii
trunc
eof
eof
is not
specified, then end of file results in unit check status
with intervention required in the sense bytes.
ebcdic
nor ascii
is
specified, then the device handler attempts to detect the
format of the card image file when the device is first accessed.
ascii
ascii
argument is not specified, the
file is written as fixed length 80-byte EBCDIC records with
no line-end delimiters.
crlf
crlf
argument is not specified, then
line-feeds only are written at the end of each line.
crlf
crlf
argument is not specified, then
line-feeds only are written at the end of each line.
TEXT
FIXED nnnnn
nnnnn
)
HEADERS
Device address
IP address
command line
A comment preceded by a pound sign may be appended to any device definition statement.
If you have a question about Hercules, see the Hercules Frequently-Asked Questions page.
Last updated 3 September 2000