Hercules – User Reference Guide

1 Hercules System/370, ESA/390, z/Architecture Emulator Hercules user Reference Guide Version 3 Release 07 Contents Contents ..2 Tables ..14 1. Preface ..15 Edition information ..15 What this book is Who should read this book ..15 What you need to know to understand this How to use this Revision Notice ..15 Readers Comments ..16 Legal Trademarks ..16 Acknowledgements ..17 2. Related Publications ..18 Hercules Emulator General Information ..18 Hercules Emulator Installation Guide ..18 Hercules Emulator user Reference Guide ..18 Hercules Emulator Messages and Hercules Emulator Reference Summary.

2 18 3. Hercules Configuration The Configuration System Device Definitions ..21 Coding Record Format ..23 Sample Configuration Symbol Substitution ..26 Enhanced Symbol Substitution ..28 4. System Parameter # or * (Comment lines) ..30 ARCHMODE (Initial architecture mode) ..31 ASN_AND_LX_REUSE / ALRF (ESAME ASN and LX REUSE feature) ..32 AUTOMOUNT (Tape automount root directory) ..34 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts)..36 CCKD (Compressed CKD DASD options)..37 CNSLPORT (Telnet client port) ..42 CODEPAGE (Codepage conversion table).

3 43 CONKPALV (Console and telnet clients keep-alive option) ..45 CPUMODEL (CPU model) ..47 CPUPRIO (CPU thread process priority) ..48 CPUSERIAL (CPU serial number) ..49 CPUVERID (CPU version code) ..50 DEFSYM (Define symbol) ..51 DEVPRIO (Device threads process priority) ..52 DEVTMAX (Maximum number of device threads) ..53 DIAG8 CMD (DIAGNOSE 8 command setting) ..55 ECPSVM (ECPS:VM support status (VM)) ..57 ENGINES (Processor engine type) ..59 HERCLOGO ( Hercules 3270 logo) ..61 HERCPRIO ( Hercules process priority) ..62 HTTPPORT (HTTP server port) ..63 HTTPROOT (HTTP server root directory).

4 65 IGNORE (Ignore subsequent INCLUDE errors)..66 INCLUDE (Include configuration file) ..67 Hercules Emulator user Reference Guide Page 2 IODELAY (I/O interrupt wait time (LINUX)) ..68 LDMOD (Additional dynamic load modules)..69 LEGACYSENSEID (SENSE ID CCW (x'E4') feature)..70 LOADPARM (IPL parameter) ..71 LOGOPT (Log options) ..72 LPARNAME (LPAR name returned by DIAG x'204') ..73 LPARNUM (LPAR identification number)..74 MAINSIZE (Main storage in MB) ..75 MANUFACTURER (Manufacturer name returned by STSI instruction)..76 MAXCPU (Maximum number of CPUs).

5 77 MODEL (Model names returned by STSI instruction)..78 MODPATH (Dynamic load module path) ..80 MOUNTED_TAPE_REINIT (Control tape initialization) ..81 NUMCPU (Number of emulated CPUs) ..82 NUMVEC (Number of vector facilities) ..83 OSTAILOR (Intended operating system) ..84 PANRATE (Panel refresh rate) ..86 PANTITLE ( Hercules console window title) ..87 PGMPRDOS (LPP license setting) ..88 PLANT (Plant name returned by STSI instruction) ..89 SCLPROOT (SCLP base directory) ..90 SHCMDOPT (Shell command option)..91 SHRDPORT (Shared device server port) ..92 SYSEPOCH (Base date for TOD clock).

6 93 TIMERINT (Internal timer update interval) ..94 TODDRAG (TOD clock drag factor) ..95 TODPRIO (Timer thread process priority)..96 TRACEOPT (Instruction trace display option)..97 TZOFFSET (TOD clock offset from GMT) ..98 XPNDSIZE (Expanded storage in MB)..99 YROFFSET (TOD clock offset from actual date) ..100 Process and Thread Priorities ..101 5. Device Definition Descriptions ..103 Local non-SNA 3270 Devices ..103 Integrated 3270 (SYSG) Console ..106 Console Printer-Keyboard Integrated Console Printer-Keyboard Devices ..110 Card Reader Card Punch Devices.

7 113 Line Printer Devices ..115 Emulated Tape Devices ..118 Channel-to-Channel Adapters ..131 FBA DASD CKD DASD Devices ..141 Communication Lines (Preliminary 2703 BSC Support) ..145 6. Hercules Console ..148 Hercules Hardware Console ..148 Web browser interface ..150 Using the keyboard ..151 Log formats ..153 Hercules Console Commands (sorted alphabetically)..156 Hercules Console Commands (grouped by functionality)..161 7. Console Command !message (SCP priority message) ..167 # or * (Log comment to syslog) ..168 .reply (SCP command)..169 ? (List all commands / command specific help).

8 170 AEA (Display AEA tables) ..172 Hercules Emulator user Reference Guide Page 3 AIA (List AIA fields) ..173 AR (Display access registers)..174 ARCHMODE (Set architecture mode) ..175 ATTACH (Configure device) ..177 AUTOMOUNT (Show or update allowable tape automount directories)..179 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts) ..181 B (Set breakpoint)..183 B+ (Set breakpoint) ..184 B- (Delete breakpoint) ..185 CACHE (Cache command) ..186 CCKD (CCKD command) ..188 CD (Change directory) ..194 CF (Configure CPU online or offline)..195 CFALL (Configure all CPUs online or offline).

9 197 CLOCKS (Display TOD clock and CPU timer)..199 CMDTGT (Specify the command target)..200 CONKPALV (Display / alter console TCP/IP keep-alive settings) ..202 CPU (Define target CPU for console displays and commands)..204 CR (Display or alter control registers) ..205 CSCRIPT (Cancel a running script thread) ..207 CTC (Enable / disable debug packet tracing) ..208 DEFINE (Rename device)..211 DEFSYM (Define symbol) ..212 DETACH (Remove device) ..214 DEVINIT (Reinitialize device) ..215 DEVLIST (List device or all devices) ..217 DEVTMAX (Display or set maximum device threads).

10 219 DS (Display subchannel) ..221 ECPSVM (ECPS:VM commands) ..224 EXIT (Terminate the emulator)..227 EXT (Generate external interrupt) ..229 F{+/-} (Mark frames usable or unusable)..230 FPC (Display floating point control register)..232 FPR (Display floating point registers)..233 G (Turn off instruction stepping and start CPU) ..235 GPR (Display or alter general purpose registers) ..236 HAO ( Hercules Automatic Operator)..238 HELP (List all commands / command specific help) ..241 HERC (Send Hercules command) ..243 HERCLOGO (Read new logo file)..244 HST (History of commands).