Hercules System/370, ESA/390, z/Architecture Emulator Hercules – User Reference Guide Version 3 Release 07 Contents Contents ........................................................................................................................................................2 Figures...........................................................................................................................................................8 Tables..........................................................................................................................................................14 1. Preface .................................................................................................................................................15 1.1 Edition information ........................................................................................................................15 1.2 What this book is about.................................................................................................................15 1.3 Who should read this book ...........................................................................................................15 1.4 What you need to know to understand this book..........................................................................15 1.5 How to use this book.....................................................................................................................15 1.6 Revision Notice .............................................................................................................................15 1.7 Readers Comments ......................................................................................................................16 1.8 Legal Advice..................................................................................................................................16 1.9 Trademarks ...................................................................................................................................16 1.10 Acknowledgements ...................................................................................................................17 2. Related Publications ............................................................................................................................18 2.1 Hercules Emulator – General Information ....................................................................................18 2.2 Hercules Emulator – Installation Guide ........................................................................................18 2.3 Hercules Emulator – User Reference Guide ................................................................................18 2.4 Hercules Emulator – Messages and Codes .................................................................................18 2.5 Hercules Emulator – Reference Summary ...................................................................................18 3. Hercules Configuration File..................................................................................................................19 3.1 The Configuration File...................................................................................................................19 3.2 System Parameters.......................................................................................................................19 3.3 Device Definitions .........................................................................................................................21 3.4 Coding Rules.................................................................................................................................22 3.5 Record Format ..............................................................................................................................23 3.6 Sample Configuration File.............................................................................................................24 3.7 Symbol Substitution ......................................................................................................................26 3.8 Enhanced Symbol Substitution.....................................................................................................28 4. System Parameter Descriptions...........................................................................................................30 4.1 # or * (Comment lines) ..................................................................................................................30 4.2 ARCHMODE (Initial architecture mode) .......................................................................................31 4.3 ASN_AND_LX_REUSE / ALRF (ESAME ASN and LX REUSE feature) .....................................32 4.4 AUTOMOUNT (Tape automount root directory) ...........................................................................34 4.5 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts).................................................................36 4.6 CCKD (Compressed CKD DASD options)....................................................................................37 4.7 CNSLPORT (Telnet client port) ....................................................................................................42 4.8 CODEPAGE (Codepage conversion table) ..................................................................................43 4.9 CONKPALV (Console and telnet clients keep-alive option) .........................................................45 4.10 CPUMODEL (CPU model) ........................................................................................................47 4.11 CPUPRIO (CPU thread process priority) ..................................................................................48 4.12 CPUSERIAL (CPU serial number) ............................................................................................49 4.13 CPUVERID (CPU version code) ...............................................................................................50 4.14 DEFSYM (Define symbol) .........................................................................................................51 4.15 DEVPRIO (Device threads process priority) .............................................................................52 4.16 DEVTMAX (Maximum number of device threads) ....................................................................53 4.17 DIAG8CMD (DIAGNOSE 8 command setting) .........................................................................55 4.18 ECPSVM (ECPS:VM support status (VM)) ...............................................................................57 4.19 ENGINES (Processor engine type)...........................................................................................59 4.20 HERCLOGO (Hercules 3270 logo) ...........................................................................................61 4.21 HERCPRIO (Hercules process priority) ....................................................................................62 4.22 HTTPPORT (HTTP server port)................................................................................................63 4.23 HTTPROOT (HTTP server root directory).................................................................................65 4.24 IGNORE (Ignore subsequent INCLUDE errors)........................................................................66 4.25 INCLUDE (Include configuration file) ........................................................................................67 Hercules Emulator – User Reference Guide Page 2 4.26 IODELAY (I/O interrupt wait time (LINUX)) ...............................................................................68 4.27 LDMOD (Additional dynamic load modules) .............................................................................69 4.28 LEGACYSENSEID (SENSE ID CCW (x'E4') feature)...............................................................70 4.29 LOADPARM (IPL parameter) ....................................................................................................71 4.30 LOGOPT (Log options) .............................................................................................................72 4.31 LPARNAME (LPAR name returned by DIAG x'204') ................................................................73 4.32 LPARNUM (LPAR identification number)..................................................................................74 4.33 MAINSIZE (Main storage in MB)...............................................................................................75 4.34 MANUFACTURER (Manufacturer name returned by STSI instruction)....................................76 4.35 MAXCPU (Maximum number of CPUs) ....................................................................................77 4.36 MODEL (Model names returned by STSI instruction)...............................................................78 4.37 MODPATH (Dynamic load module path) ..................................................................................80 4.38 MOUNTED_TAPE_REINIT (Control tape initialization) ............................................................81 4.39 NUMCPU (Number of emulated CPUs) ....................................................................................82 4.40 NUMVEC (Number of vector facilities)......................................................................................83 4.41 OSTAILOR (Intended operating system) ..................................................................................84