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