Tables

Table 1: Hercules System Parameters ....................................................................................................... 31 Table 2: Hercules Device Definitions ......................................................................................................... 32 Table 3: Predefined symbols ...................................................................................................................... 38 Table 4: Supported codepage mappings ................................................................................................... 63 Table 5: Storage Allocation Units ............................................................................................................... 77 Table 6: Storage Allocation Units ............................................................................................................. 111 Table 7: Storage Allocation Units ............................................................................................................. 165 Table 8: Process Priority Conversions ..................................................................................................... 168 Table 9: Thread Priority Conversions ....................................................................................................... 169 Table 10: Multipliers for ‘MAXSIZE=’ and ‘EOTMARGIN=’ parameters .................................................. 204 Table 11: Default CU Types ..................................................................................................................... 227 Table 12: Normal cursor handling ............................................................................................................ 236 Table 13: Extended cursor handling ......................................................................................................... 237 Table 14: Windows event handler ............................................................................................................ 237 Table 15: Message prefix overview .......................................................................................................... 238 Table 16: Hercules Console Commands (sorted alphabetically) ............................................................. 250 Table 17: Hercules Console Commands (grouped by functionality) ........................................................ 258 Table 18: Supported codepage mappings ............................................................................................... 320 Table 19: Storage Allocation Units ........................................................................................................... 346 Table 20: Storage Allocation Units ........................................................................................................... 435 Table 21: Sense ID ................................................................................................................................... 491 Table 22: Read Device Characteristics .................................................................................................... 492 Table 23: Read Configuration Data .......................................................................................................... 492 Table 24: Storage Allocation Units ........................................................................................................... 600 Table 25: Supported CKD DASD Devices ............................................................................................... 633 Table 26: Supported FBA DASD Devices ................................................................................................ 634 Table 27: Correct CPU configuration (example 1) ................................................................................... 636 Table 28: Correct CPU configuration (example 2) ................................................................................... 636 Table 29: Correct CPU configuration (example 3) ................................................................................... 637 Table 30: Correct CPU configuration (example 4) ................................................................................... 637 Table 31: Correct CPU configuration (example 5) ................................................................................... 638 Table 32: Incorrect CPU configuration (example 6) ................................................................................. 638 Table 33: Architecture Facilities ............................................................................................................... 641 Table 34: Console commands related to command groups ..................................................................... 649 Table 35: Build options for system parameters and console commands ................................................. 651 Table 36: Environment Variables ............................................................................................................. 652 Table 37: Reading Syntax Descriptions ................................................................................................... 653 Table 38: Reading Syntax Diagrams ........................................................................................................ 656

1. Preface

1.1 Edition information

This edition applies to the Hercules S/370, ESA/390 and z/Architecture Emulator, Release 4.00.0 and to
all subsequent versions, releases and modifications until otherwise indicated in new editions. Make sure
you are using the correct edition for the level of software you are using.

1.2 What this book is about

This book is a guide for using and operating the Hercules Emulator and related additional products (both
required and optional). For guidance in installation or debugging Hercules or for a general overview,
additional manuals are available.

Please note that some information can be found in more than one manual. This redundancy is not inten-
ded to unnecessarily expand the manuals, rather to help find all necessary information in one place.

1.3 Who should read this book

This book is mainly intended for people who are responsible for operating the Hercules Emulator. It may
also be useful if you are responsible for installing the Hercules Emulator.

1.4 What you need to know to understand this book

To understand this book, you should be familiar using software under the Linux, Microsoft Windows or
Mac OS X operating systems. You should also have experience with Linux command shells or native
DOS (Microsoft Disk Operating System) and the Microsoft Windows command shell.

Last but not least you should be familiar with IBM mainframe environments (hardware and software) and
the underlying ideas and concepts as Hercules emulates IBM mainframe hardware.

1.5 How to use this book

This book is designed as a reference for all aspects the Hercules Emulator and related products. You can
go through the book chapter by chapter or you can use the book as a reference for all questions regar-
ding the operation of Hercules.