1.1 Edition information ........................................................................................................................151.2 What this book is about.................................................................................................................151.3 Who should read this book ...........................................................................................................151.4 What you need to know to understand this book..........................................................................151.5 How to use this book.....................................................................................................................151.6 Revision Notice .............................................................................................................................151.7 Readers Comments ......................................................................................................................161.8 Legal Advice..................................................................................................................................161.9 Trademarks ...................................................................................................................................161.10 Acknowledgements ...................................................................................................................17
2. Related Publications ............................................................................................................................182.1 Hercules Emulator General Information ....................................................................................182.2 Hercules Emulator Installation Guide ........................................................................................182.3 Hercules Emulator User Reference Guide ................................................................................182.4 Hercules Emulator Messages and Codes .................................................................................182.5 Hercules Emulator Reference Summary ...................................................................................18
3. Hercules Configuration File..................................................................................................................193.1 The Configuration File...................................................................................................................193.2 System Parameters.......................................................................................................................193.3 Device Definitions .........................................................................................................................213.4 Coding Rules.................................................................................................................................223.5 Record Format ..............................................................................................................................233.6 Sample Configuration File.............................................................................................................243.7 Symbol Substitution ......................................................................................................................263.8 Enhanced Symbol Substitution .....................................................................................................28
4. System Parameter Descriptions...........................................................................................................304.1 # or * (Comment lines) ..................................................................................................................304.2 ARCHMODE (Initial architecture mode) .......................................................................................314.3 ASN_AND_LX_REUSE / ALRF (ESAME ASN and LX REUSE feature) .....................................324.4 AUTOMOUNT (Tape automount root directory) ...........................................................................344.5 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts).................................................................364.6 CCKD (Compressed CKD DASD options)....................................................................................374.7 CNSLPORT (Telnet client port) ....................................................................................................424.8 CODEPAGE (Codepage conversion table) ..................................................................................434.9 CONKPALV (Console and telnet clients keep-alive option) .........................................................454.10 CPUMODEL (CPU model) ........................................................................................................474.11 CPUPRIO (CPU thread process priority) ..................................................................................484.12 CPUSERIAL (CPU serial number) ............................................................................................494.13 CPUVERID (CPU version code) ...............................................................................................504.14 DEFSYM (Define symbol) .........................................................................................................514.15 DEVPRIO (Device threads process priority) .............................................................................524.16 DEVTMAX (Maximum number of device threads) ....................................................................534.17 DIAG8CMD (DIAGNOSE 8 command setting) .........................................................................554.18 ECPSVM (ECPS:VM support status (VM)) ...............................................................................574.19 ENGINES (Processor engine type) ...........................................................................................594.20 HERCLOGO (Hercules 3270 logo) ...........................................................................................614.21 HERCPRIO (Hercules process priority) ....................................................................................624.22 HTTPPORT (HTTP server port) ................................................................................................634.23 HTTPROOT (HTTP server root directory).................................................................................654.24 IGNORE (Ignore subsequent INCLUDE errors)........................................................................664.25 INCLUDE (Include configuration file) ........................................................................................67
Hercules Emulator User Reference Guide Page 2
4.26 IODELAY (I/O interrupt wait time (LINUX)) ...............................................................................684.27 LDMOD (Additional dynamic load modules) .............................................................................694.28 LEGACYSENSEID (SENSE ID CCW (x'E4') feature)...............................................................704.29 LOADPARM (IPL parameter) ....................................................................................................714.30 LOGOPT (Log options) .............................................................................................................724.31 LPARNAME (LPAR name returned by DIAG x'204') ................................................................734.32 LPARNUM (LPAR identification number)..................................................................................744.33 MAINSIZE (Main storage in MB) ...............................................................................................754.34 MANUFACTURER (Manufacturer name returned by STSI instruction)....................................764.35 MAXCPU (Maximum number of CPUs) ....................................................................................774.36 MODEL (Model names returned by STSI instruction)...............................................................784.37 MODPATH (Dynamic load module path) ..................................................................................804.38 MOUNTED_TAPE_REINIT (Control tape initialization) ............................................................814.39 NUMCPU (Number of emulated CPUs) ....................................................................................824.40 NUMVEC (Number of vector facilities) ......................................................................................834.41 OSTAILOR (Intended operating system) ..................................................................................844.42 PANRATE (Panel refresh rate) .................................................................................................864.43 PANTITLE (Hercules console window title) ..............................................................................874.44 PGMPRDOS (LPP license setting) ...................................................
