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 ..18 3. Hercules Configuration The Configuration System Device Definitions ..21 Coding Record Format ..23 Sample Configuration Symbol Substitution.

2 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) ..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).

3 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)..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).

4 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)..93 TIMERINT (Internal timer update interval) ..94 TODDRAG (TOD clock drag factor) ..95 TODPRIO (Timer thread process priority)..96 TRACEOPT (Instruction trace display option).

5 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 ..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).

6 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)..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).

7 195 CFALL (Configure all CPUs online or offline)..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)..219 DS (Display subchannel) ..221 ECPSVM (ECPS:VM commands) ..224 EXIT (Terminate the emulator)..227 EXT (Generate external interrupt).

8 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) ..245 I (Generate I/O attention interrupt for device) ..247 IODELAY (Display or set I/O delay value) ..248 IPENDING (Display pending interrupts)..250 IPL (IPL normal from device xxxx) ..252 IPLC (IPL clear from device xxxx) ..254 K (Display CCKD internal trace)..256 LDMOD (Load a module) ..258 LOADCORE (Load a core image file).

9 259 LOADPARM (Set IPL parameter)..260 LOADTEXT (Load a text deck file) ..262 LOG (Direct log output) ..263 LOGOPT (Change log options) ..264 LPARNAME (Display or set LPAR name) ..266 LPARNUM (Display or set LPAR identification number)..268 LSDEP (List module dependencies) ..270 LSMOD (List dynamic modules)..271 MAXRATES (Display maximum observed MIPS/SIO rate or define new reporting interval)..273 Hercules Emulator user Reference Guide Page 4 MESSAGE (Display message on console like VM) ..275 MOUNTED_TAPE_REINIT (Control tape initialization) ..276 MSG (Display message on console like VM) ..278 MSGHLD (Display or set timeout of held messages)..279 MSGNOH (Display message on console like VM, but without header) ..281 OSTAILOR (Specify intended operating system).

10 282 PANRATE (Display or set console refresh rate) ..284 PGMTRACE (Trace program interrupts) ..286 PR (Display prefix register) ..288 PSCP (Send system control program priority message)..289 PSW (Display or alter program status word)..290 PTT (Set / display pthread trace) ..293 PWD (Print working directory) ..297 QD (Query DASD) ..298 QUIET (Toggle automatic refresh of console display data) ..301 QUIT (Terminate the emulator) ..302 R (Display or alter real storage) ..304 RESTART (Generate restart interrupt)..306 RESUME (Resume Hercules ) ..307 RMMOD (Delete a module)..309 S (Instruction stepping) ..310 S+ (Instruction stepping on) ..312 S- (Instruction stepping off) ..314 S? (Instruction stepping query) ..315 S{+/-} dev (Turn CCW stepping on or off).