Hercules V4.00.0 - User Reference Guide - HEUR040000-00

Hercules System/370, ESA/390, z/Architecture Emulator

Hercules – User Reference Guide

Version 4 Release 00

Draft - November 21, 2015

Hercules System/370, ESA/390, z/Architecture Emulator

Hercules – User Reference Guide

Version 4 Release 00

First Edition, November 21, 2015
HEUR040000-00

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 intended 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 regarding the operation of Hercules.

1.6 Revision Notice

Hercules Release: Version 4 Release 00 Modification 0

Publication Number: HEUR040000

SoftCopy Name: HerculesUserReference

Revision Number: HEUR040000-00

Date: November 21, 2015

Hercules Emulator V4.00 – User Reference Guide Page 21

1.7 Readers Comments

If you like or dislike anything of this book please send a mail or email to the address below. Feel free to comment any errors or lack of clarity. Please limit your comments on the information in this specific book and also include the “Revision Notice” just above. Thank you for your help.

Send your comments by email to the Hercules-390 discussion group:
<wrap>hercules-390@yahoogroups.com</wrap>

1.8 Legal Advice

Hercules implements only the raw S/370, ESA/390, and z/Architecture instruction set, it does not provide any operating system facilities. This means that you need to provide an operating system or standalone program which Hercules can load from an emulated disk or tape device. You will have to write the operating system or standalone program yourself unless you possess a license from IBM to run one of their operating systems on your PC or use IBM programs and operating systems which have been placed in the public domain.

NOTE: It is YOUR responsibility to comply with the terms of the license for the operating system you intend to run on the Hercules Emulator.

1.9 Trademarks

The following is a list of trademark acknowledgments and copyright notices for product and company names mentioned in this book. Other product and company names in this book that are not listed below may be the trademarks or registered trademarks of their respective owners.

·IBM, System/370, ESA/390, z/Architecture, MVS, OS/390, z/OS, VM, VM/ESA, z/VM, VSE, VSE/ESA, z/VSE are trademarks or registered trademarks of International Business Machines Corporation (IBM).

·Windows XP, Windows Vista, Windows 7, Windows Server 2003, Windows Server 2008, Visual C++ Toolkit, Visual C++ Express are trademarks of Microsoft Corporation.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Linux is a trademark owned by Linus Torvalds. The Linux Mark Institute is the exclusive licensor of the Linux trademark on behalf of its owner Linus Torvalds.</wrap> <wrap>·<wrap></wrap></wrap><wrap>WinPcap is copyrighted by NetGroup, Politecnico di Torino (Italy).</wrap> <wrap>·<wrap></wrap></wrap><wrap>Cygwin is copyrighted by Red Hat, Inc.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Vista tn3270 is copyrighted by Tom Brennan Software.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Pentium, XEON are trademarks or registered trademarks of Intel Corporation.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Athlon, Opteron are trademarks or registered trademarks of Advanced Micro Devices (AMD), Inc.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Xmit Manager is copyrighted by Neal Johnston-Ward.</wrap> <wrap>·<wrap></wrap></wrap><wrap>FLEX-ES is a registered trademark of Fundamental Software, Inc.</wrap> <wrap>{{hercules:userref:bf:image010.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 22</wrap> <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image007.gif|}}</wrap>**<wrap>1.10 Acknowledgements</wrap>** <wrap>The Hercules manuals would not have been possible without the assistance of many people and I would like to thank all those who helped me. In particular I would like to thank:</wrap> <wrap>·<wrap></wrap></wrap><wrap>The Hercules developers for their documentation on various websites from which I derived a great deal of information.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Roger Bowler and Fish for proof-reading the manuals.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Loris Degoianni for allowing me to use parts of the original WinPcap documentation.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Tom Brennan for allowing me to use parts of his Vista tn3270 documentation.</wrap> <wrap>·<wrap></wrap></wrap><wrap>My colleagues for working with early previews of the documentation, beginning with just a few pages.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Mike Cairns for reviewing and editing the manuals.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Robert Allan for providing the “Linux Installation” part.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Lutz Mader for providing the “Mac OS X Installation” part.</wrap> <wrap>If anyone feels they have been forgotten on this list please let me know. \\ Peter Glanzmann</wrap> <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 23</wrap> <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image015.gif|}}</wrap>**<wrap>2. Related Publications</wrap>** <wrap>{{hercules:userref:bf:image012.gif|}}</wrap>**<wrap>2.1 Hercules – General Information</wrap>** <wrap>The Hercules “General Information” manual provides you an overview of the ideas and concepts of the Hercules Emulator as well as a documentation of the emulator’s functionality. It explains what Hercules does and does not do. It helps you decide if the software fits your needs fulfills your requirements.</wrap> <wrap>{{hercules:userref:bf:image013.gif|}}</wrap>**<wrap>2.2 Hercules – Installation Guide</wrap>** <wrap>The Hercules "Installation Guide" shows you how to install Hercules and all related optional and required software components under the Microsoft Windows, Linux and Apple MacIntosh OS X operating systems.</wrap> <wrap>After going through the installation guide you will have a working emulator environment ready to IPL a S370, S/390 or z/Architecture mainframe operating system.</wrap> <wrap>{{hercules:userref:bf:image016.gif|}}</wrap>**<wrap>2.3 Hercules – User Reference Guide</wrap>** <wrap>The Hercules “User Reference” leads you through all aspects of the emulator’s operation. It provides instruction in the operation of the Hercules Emulator with and without the Hercules GUIs. The usage details for the utilities are covered in the “Hercules Utilities” guide.</wrap> <wrap>After reading this manual you should be able to work with Hercules, to create a configuration file and to use Hercules commands through the console.</wrap> <wrap>{{hercules:userref:bf:image013.gif|}}</wrap>**<wrap>2.4 Hercules – Operations and Utilities Guide</wrap>** <wrap>The Hercules “Operations and Utilities Guide” describes the operation of Hercules as well as additional utilities that are delivered together with the emulator. Selected utilities from third-party suppliers are also covered in this manual.</wrap> <wrap>After reading this manual you should have the knowledge to operate Hercules and use the right utility for a certain housekeeping task within the Hercules environment. You should also be able to create virtual devices and understand backup / restore procedures.</wrap> <wrap>{{hercules:userref:bf:image013.gif|}}</wrap>**<wrap>2.5 Hercules – Messages and Codes</wrap>** <wrap>The “Messages and Codes” manual provides a detailed explanation of all Hercules related messages. It is the primary source for troubleshooting and debugging if you experience problems with Hercules.</wrap> <wrap>{{hercules:userref:bf:image008.gif|}}</wrap>**<wrap>2.6 Hercules – Reference Summary</wrap>** <wrap>The Hercules "Reference Summary" booklet lists all the system parameters, device definitions, console commands, Hercules utilities etc. along with their arguments.</wrap> <wrap>This booklet is intended as a quick reference guide for experienced users. Consult the Hercules "User Reference Guide" and “Utilities Guide” for more detailed and additional information.</wrap> <wrap>{{hercules:userref:bf:image010.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 24</wrap> <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image015.gif|}}</wrap>**<wrap>3. Summary of changes</wrap>** <wrap>{{hercules:userref:bf:image012.gif|}}</wrap>**<wrap>3.1 Version 4, First Edition (HEUR040000-00)</wrap>** <wrap>This section describes briefly the various changes that have been made in the “User Reference Guide” related to the previous edition. The most significant changes made in this edition of the manual are the following:</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 2 (Related Publications): New manual “Operations and Utilities Guide” added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 3 (Summary of changes) added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 4 (Hercules Configuration File): New sections for the following system parameters added:</wrap> <wrap>o<wrap></wrap></wrap><wrap>ARCHLVL (Set architecture level)</wrap> <wrap>o<wrap></wrap></wrap><wrap>AUTOINIT (Automatic creation of empty tape files)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CAPPING (CPU capping feature)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CMDLEVEL (Set current command group)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CMDSEP (Command line separator)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CP_UPDT (User character conversion table)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CPUIDFMT (Set format BASIC / 0 / 1 STIDP generation)</wrap> <wrap>o<wrap></wrap></wrap><wrap>DEFSTORE (Define main and expanded storage)</wrap> <wrap>o<wrap></wrap></wrap><wrap>HAO (Hercules Automatic Operator)</wrap> <wrap>o<wrap></wrap></wrap><wrap>HTTP (HTTP server configuration)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MAXRATES (MIPS/SIO rate reporting interval)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MEMLOCK (Lock Hercules memory)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MSGHLD (Timeout value of held messages)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MSGLEVEL (Message display output)</wrap> <wrap>o<wrap></wrap></wrap><wrap>QUITMOUT (Quit timeout value)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SCPECHO (Echo to console and history of SCP replies)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SCPIMPLY (Pass non-Hercules commands to the SCP)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SCSIMOUNT (Automatic SCSI tape mounts)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SHOWDVOL1 (Enable showing of DASD volsers in device list)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SRVPRIO (Server threads priority)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SYMPTOM (Instruction trace display option)</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 6 (Device Definition Descriptions): New section “PTP (MPCPTP/PCPTP6 Channel-to-Channel link)” added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 7 (Hercules Console): New section “Programmed Function Key (PF Key) Support” added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 8 (Console Command Descriptions): New sections for the following console commands added:</wrap> <wrap>o<wrap></wrap></wrap><wrap>$LOCATE (Display and verify Hercules control blocks)</wrap> <wrap>{{hercules:userref:bf:image007.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 25</wrap> <wrap>\\ </wrap><wrap>o<wrap></wrap></wrap><wrap>$TEST (Custom test command)</wrap> <wrap>o<wrap></wrap></wrap><wrap>$ZAPCMD (Enable or disable system parameters and console commands)</wrap> <wrap>o<wrap></wrap></wrap><wrap>ABS (Display or alter absolute storage)</wrap> <wrap>o<wrap></wrap></wrap><wrap>ARCHLVL (Set architecture level)</wrap> <wrap>o<wrap></wrap></wrap><wrap>AUTOINIT (Display or set the automatic creation of empty tape files)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CACHESTATS (Display cache statistics)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CAPPING (Display or set CPU capping value)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CMDLEVEL (Display or set current command group)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CMDSEP (Display or set current command line separator)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CNSLPORT (Display or set console port)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CODEPAGE (Display or set codepage conversion table)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CP_UPDT (Create or modify user character conversion table)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CPUIDFMT (Display or set format BASIC / 0 / 1 STIDP generation)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CPUMODEL (Display or set CPU model number)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CPUPRIO (Display or set CPU thread process priority)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CPUSERIAL (Display or set CPU serial number)</wrap> <wrap>o<wrap></wrap></wrap><wrap>CPUVERID (CPU version code)</wrap> <wrap>o<wrap></wrap></wrap><wrap>DEFSTORE (Display or define main and expanded storage values)</wrap> <wrap>o<wrap></wrap></wrap><wrap>DEVPRIO (Display or set device threads process priority)</wrap> <wrap>o<wrap></wrap></wrap><wrap>DIAG8CMD (Display or set DIAGNOSE 8 command option)</wrap> <wrap>o<wrap></wrap></wrap><wrap>DIR (Display file and directory listing)</wrap> <wrap>o<wrap></wrap></wrap><wrap>ENGINES (Set processor engines type)</wrap> <wrap>o<wrap></wrap></wrap><wrap>EXEC (Execute a REXX script)</wrap> <wrap>o<wrap></wrap></wrap><wrap>FCB (Display current FCB or load new FCB image)</wrap> <wrap>o<wrap></wrap></wrap><wrap>HERCPRIO (Display or set Hercules process priority)</wrap> <wrap>o<wrap></wrap></wrap><wrap>HTTP (Start, stop, modify and display HTTP server)</wrap> <wrap>o<wrap></wrap></wrap><wrap>ICOUNT (Display individual instruction counts)</wrap> <wrap>o<wrap></wrap></wrap><wrap>KD (Clear held messages)</wrap> <wrap>o<wrap></wrap></wrap><wrap>LEGACYSENSEID (Display or set SENSE ID CCW (x'E4') feature)</wrap> <wrap>o<wrap></wrap></wrap><wrap>LS (Display file and directory listing)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MAINSIZE (Display or set main storage size)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MANUFACTURER (Display or set STSI manufacturer code)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MAXCPU (Display or set maximum number of CPUs)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MEMLOCK (Lock Hercules memory)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MODEL (Display or set STSI model code)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MODPATH (Display or set dynamic load module path)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MSGLEVEL (Display or set the current message display output)</wrap> <wrap>o<wrap></wrap></wrap><wrap>MT (Control magnetic tape operation)</wrap> <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image007.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 26</wrap> <wrap>\\ </wrap><wrap>o<wrap></wrap></wrap><wrap>NUMCPU (Display or set number of emulated CPUs)</wrap> <wrap>o<wrap></wrap></wrap><wrap>NUMVEC (Display or set number of vector facilities)</wrap> <wrap>o<wrap></wrap></wrap><wrap>PANTITLE (Display or set console window title)</wrap> <wrap>o<wrap></wrap></wrap><wrap>PGMPRDOS (Set LPP license setting)</wrap> <wrap>o<wrap></wrap></wrap><wrap>PLANT (Display or set STSI plant code)</wrap> <wrap>o<wrap></wrap></wrap><wrap>PTP (Enable / disable PTP debugging)</wrap> <wrap>o<wrap></wrap></wrap><wrap>QCPUID (Display CPU ID)</wrap> <wrap>o<wrap></wrap></wrap><wrap>QPFKEYS (Display the current PF key settings)</wrap> <wrap>o<wrap></wrap></wrap><wrap>QPID (Display process ID of Hercules)</wrap> <wrap>o<wrap></wrap></wrap><wrap>QPORTS (Display TCP/IP ports in use)</wrap> <wrap>o<wrap></wrap></wrap><wrap>QPROC (Display processors type and utilization)</wrap> <wrap>o<wrap></wrap></wrap><wrap>QSTOR (Display main and expanded storage values)</wrap> <wrap>o<wrap></wrap></wrap><wrap>QUITMOUT (Display or set quit timeout value)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SCPECHO (Display or set echo to console and history of SCP replies)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SCPIMPLY (Display or set option to pass non-Hercules commands to the SCP)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SHCMDOPT (Display or set shell command option)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SHRDPORT (Set shared device server port)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SRVPRIO (Display or set server threads process priority)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SYMPTOM (Instruction trace display option)</wrap> <wrap>o<wrap></wrap></wrap><wrap>SYSEPOCH (Set base date for TOD clock)</wrap> <wrap>o<wrap></wrap></wrap><wrap>TODPRIO (Display or set timer thread process priority)</wrap> <wrap>o<wrap></wrap></wrap><wrap>TZOFFSET (Set TOD clock offset from GMT)</wrap> <wrap>o<wrap></wrap></wrap><wrap>XPNDSIZE (Display or set expanded storage size)</wrap> <wrap>o<wrap></wrap></wrap><wrap>YROFFSET (Set TOD clock offset from actual date)</wrap> <wrap>·<wrap></wrap></wrap><wrap>The description of the Hercules Utilities has been moved to the “Operations and Utilities Guide”.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 12 (The Run-Commands File) added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 13 (The “Hercules Automatic Operator” (HAO) Facility) added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Chapter 14 (REXX Support) added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Appendix D. Hercules Command Groups added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Appendix E. Build Options for System Parameters and Console Commands added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Appendix F. Environment Variables added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Appendix H. Links: List of links updated.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Many additional examples have been added.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Most output samples from console commands have been replaced.</wrap> <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image006.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 27</wrap> <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap>**<wrap>4. Hercules Configuration File</wrap>** <wrap>{{hercules:userref:bf:image013.gif|}}</wrap>**<wrap>4.1 The Configuration File</wrap>** <wrap>This chapter describes the configuration file for the Hercules Emulator. By default the configuration file is named “hercules.cnf” or “hercules.conf”. It is located in the configuration directory, refer to the Hercules Installation Guide for details of the directory structure. The configuration file contains the processor definitions in the system parameters section, the device layout in the device definitions section and Hercules runtime parameters also in the system parameters section.</wrap> <wrap>The configuration file - especially the device definition part - is roughly equivalent to the IOCDS definitions found on a real mainframe environment. It is an ASCII text file that is read and interpreted by the Hercules Emulator during its initialization phase.</wrap> <wrap>{{hercules:userref:bf:image007.gif|}}</wrap>**<wrap>4.2 System Parameters</wrap>** <wrap>The system parameters describe the processor definition and some Hercules internal runtime parameters.</wrap> <wrap>The processor definitions include the processor model, CPU serial number, memory configuration and architecture mode. They describe the processor hardware that is to be emulated.</wrap> <wrap>The Hercules runtime parameters define values that Hercules requires as an emulated environment. These parameters include values like port numbers, directory paths and priorities.</wrap> <wrap>The following table shows an overview of all valid system parameters. Please note that the availability of certain system parameters depends on the build options used when Hercules was compiled. For a list of all build options and the related system parameters please consult “Appendix E. Build Options for System Parameters and Console Commands”.</wrap> |<WRAP>**<wrap>System Parameter</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>#</wrap> </WRAP> |<WRAP><wrap>Comment line</wrap> </WRAP> | |<WRAP><wrap>*</wrap> </WRAP> |<WRAP><wrap>Comment line</wrap> </WRAP> | |<WRAP><wrap>ARCHLVL</wrap> </WRAP> |<WRAP><wrap>Set architecture level</wrap> </WRAP> | |<WRAP><wrap>ARCHMODE</wrap> </WRAP> |<WRAP><wrap>Set initial architecture mode (alias for ARCHLVL system parameter)</wrap> </WRAP> | |<WRAP><wrap>ASN_AND_LX_REUSE / ALRF</wrap> </WRAP> |<WRAP><wrap>ESAME ASN and LX REUSE feature (deprecated, use ARCHLVL instead)</wrap> </WRAP> | |<WRAP><wrap>AUTO_SCSI_MOUNT</wrap> </WRAP> |<WRAP><wrap>Automatic SCSI tape mounts (deprecated, use SCSIMOUNT instead)</wrap> </WRAP> | |<WRAP><wrap>AUTOINIT</wrap> </WRAP> |<WRAP><wrap>Automatic creation of empty tape files</wrap> </WRAP> | |<WRAP><wrap>AUTOMOUNT</wrap> </WRAP> |<WRAP><wrap>Tape automount root directory</wrap> </WRAP> | |<WRAP><wrap>CAPPING</wrap> </WRAP> |<WRAP><wrap>CPU capping feature</wrap> </WRAP> | <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image006.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 28</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>System Parameter</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>CCKD</wrap> </WRAP> |<WRAP><wrap>Compressed CKD DASD options</wrap> </WRAP> | |<WRAP><wrap>CMDLEVEL</wrap> </WRAP> |<WRAP><wrap>Set command group</wrap> </WRAP> | |<WRAP><wrap>CMDLVL</wrap> </WRAP> |<WRAP><wrap>Set command group (alias for CMDLEVEL)</wrap> </WRAP> | |<WRAP><wrap>CMDSEP</wrap> </WRAP> |<WRAP><wrap>Command line seperator</wrap> </WRAP> | |<WRAP><wrap>CNSLPORT</wrap> </WRAP> |<WRAP><wrap>Console port</wrap> </WRAP> | |<WRAP><wrap>CODEPAGE</wrap> </WRAP> |<WRAP><wrap>Codepage conversion table</wrap> </WRAP> | |<WRAP><wrap>CONKPALV</wrap> </WRAP> |<WRAP><wrap>Console and telnet clients keep-alive option</wrap> </WRAP> | |<WRAP><wrap>CP_UPDT</wrap> </WRAP> |<WRAP><wrap>User character conversion table</wrap> </WRAP> | |<WRAP><wrap>CPUIDFMT</wrap> </WRAP> |<WRAP><wrap>Set format BASIC / 0 / 1 STIDP generation</wrap> </WRAP> | |<WRAP><wrap>CPUMODEL</wrap> </WRAP> |<WRAP><wrap>CPU model number</wrap> </WRAP> | |<WRAP><wrap>CPUPRIO</wrap> </WRAP> |<WRAP><wrap>CPU thread process priority</wrap> </WRAP> | |<WRAP><wrap>CPUSERIAL</wrap> </WRAP> |<WRAP><wrap>CPU serial number</wrap> </WRAP> | |<WRAP><wrap>CPUVERID</wrap> </WRAP> |<WRAP><wrap>CPU version code</wrap> </WRAP> | |<WRAP><wrap>DEFSTORE</wrap> </WRAP> |<WRAP><wrap>Define main and expanded storage</wrap> </WRAP> | |<WRAP><wrap>DEFSYM</wrap> </WRAP> |<WRAP><wrap>Define a symbol</wrap> </WRAP> | |<WRAP><wrap>DEVPRIO</wrap> </WRAP> |<WRAP><wrap>Device threads process priority</wrap> </WRAP> | |<WRAP><wrap>DEVTMAX</wrap> </WRAP> |<WRAP><wrap>Maximum number of device threads</wrap> </WRAP> | |<WRAP><wrap>DIAG8CMD</wrap> </WRAP> |<WRAP><wrap>DIAGNOSE 8 command option</wrap> </WRAP> | |<WRAP><wrap>ECPSVM</wrap> </WRAP> |<WRAP><wrap>ECPS:VM support status (VM)</wrap> </WRAP> | |<WRAP><wrap>ENGINES</wrap> </WRAP> |<WRAP><wrap>Processor engines type</wrap> </WRAP> | |<WRAP><wrap>HAO</wrap> </WRAP> |<WRAP><wrap>Hercules Automatic Operator</wrap> </WRAP> | |<WRAP><wrap>HERCLOGO</wrap> </WRAP> |<WRAP><wrap>Hercules logo file</wrap> </WRAP> | |<WRAP><wrap>HERCPRIO</wrap> </WRAP> |<WRAP><wrap>Hercules process priority</wrap> </WRAP> | |<WRAP><wrap>HTTP</wrap> </WRAP> |<WRAP><wrap>HTTP server configuration</wrap> </WRAP> | |<WRAP><wrap>HTTPPORT</wrap> </WRAP> |<WRAP><wrap>HTTP server port (deprecated, use HTTP instead)</wrap> </WRAP> | |<WRAP><wrap>HTTPROOT</wrap> </WRAP> |<WRAP><wrap>HTTP server root directory (deprecated, use HTTP instead)</wrap> </WRAP> | <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image006.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 29</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>System Parameter</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>IGNORE</wrap> </WRAP> |<WRAP><wrap>Ignore subsequent INCLUDE errors</wrap> </WRAP> | |<WRAP><wrap>INCLUDE</wrap> </WRAP> |<WRAP><wrap>Include configuration file</wrap> </WRAP> | |<WRAP><wrap>IODELAY</wrap> </WRAP> |<WRAP><wrap>I/O interrupt wait time (LINUX)</wrap> </WRAP> | |<WRAP><wrap>LDMOD</wrap> </WRAP> |<WRAP><wrap>Additional dynamic load modules</wrap> </WRAP> | |<WRAP><wrap>LEGACYSENSEID</wrap> </WRAP> |<WRAP><wrap>SENSE ID CCW (x’E4’) feature</wrap> </WRAP> | |<WRAP><wrap>LOADPARM</wrap> </WRAP> |<WRAP><wrap>IPL parameter</wrap> </WRAP> | |<WRAP><wrap>LOGOPT</wrap> </WRAP> |<WRAP><wrap>Logging options</wrap> </WRAP> | |<WRAP><wrap>LPARNAME</wrap> </WRAP> |<WRAP><wrap>LPAR name returned by DIAG x'204'</wrap> </WRAP> | |<WRAP><wrap>LPARNUM</wrap> </WRAP> |<WRAP><wrap>LPAR identification number</wrap> </WRAP> | |<WRAP><wrap>MAINSIZE</wrap> </WRAP> |<WRAP><wrap>Main storage size</wrap> </WRAP> | |<WRAP><wrap>MANUFACTURER</wrap> </WRAP> |<WRAP><wrap>STSI manufacturer code</wrap> </WRAP> | |<WRAP><wrap>MAXCPU</wrap> </WRAP> |<WRAP><wrap>Maximum number of CPUs</wrap> </WRAP> | |<WRAP><wrap>MAXRATES</wrap> </WRAP> |<WRAP><wrap>MIPS/SIO rate reporting interval</wrap> </WRAP> | |<WRAP><wrap>MEMLOCK</wrap> </WRAP> |<WRAP><wrap>Lock Hercules memory</wrap> </WRAP> | |<WRAP><wrap>MODEL</wrap> </WRAP> |<WRAP><wrap>STSI model code</wrap> </WRAP> | |<WRAP><wrap>MODPATH</wrap> </WRAP> |<WRAP><wrap>Dynamic load module path</wrap> </WRAP> | |<WRAP><wrap>MOUNTED_TAPE_REINIT</wrap> </WRAP> |<WRAP><wrap>Control tape initialization</wrap> </WRAP> | |<WRAP><wrap>MSGHELD</wrap> </WRAP> |<WRAP><wrap>Timeout value of held messages</wrap> </WRAP> | |<WRAP><wrap>MSGLEVEL</wrap> </WRAP> |<WRAP><wrap>Message display output</wrap> </WRAP> | |<WRAP><wrap>MSGLVL</wrap> </WRAP> |<WRAP><wrap>Message display output (alias for MSGLEVEL)</wrap> </WRAP> | |<WRAP><wrap>NUMCPU</wrap> </WRAP> |<WRAP><wrap>Number of emulated CPUs</wrap> </WRAP> | |<WRAP><wrap>NUMVEC</wrap> </WRAP> |<WRAP><wrap>Number of vector facilities</wrap> </WRAP> | |<WRAP><wrap>OSTAILOR</wrap> </WRAP> |<WRAP><wrap>Tailor trace information for specific oprating system</wrap> </WRAP> | |<WRAP><wrap>PANRATE</wrap> </WRAP> |<WRAP><wrap>Console refresh rate</wrap> </WRAP> | |<WRAP><wrap>PANTITLE</wrap> </WRAP> |<WRAP><wrap>Console window title</wrap> </WRAP> | |<WRAP><wrap>PGMPRDOS</wrap> </WRAP> |<WRAP><wrap>LPP license setting</wrap> </WRAP> | <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image006.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 30</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>System Parameter</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>PLANT</wrap> </WRAP> |<WRAP><wrap>STSI plant code</wrap> </WRAP> | |<WRAP><wrap>QUITMOUT</wrap> </WRAP> |<WRAP><wrap>Quit timeout value</wrap> </WRAP> | |<WRAP><wrap>REXX</wrap> </WRAP> |<WRAP><wrap>REXX interpreter settings</wrap> </WRAP> | |<WRAP><wrap>SCLPROOT</wrap> </WRAP> |<WRAP><wrap>SCLP base directory</wrap> </WRAP> | |<WRAP><wrap>SCPECHO</wrap> </WRAP> |<WRAP><wrap>Echo to console and history of SCP replies</wrap> </WRAP> | |<WRAP><wrap>SCPIMPLY</wrap> </WRAP> |<WRAP><wrap>Pass non-Hercules commands to the SCP</wrap> </WRAP> | |<WRAP><wrap>SCSIMOUNT</wrap> </WRAP> |<WRAP><wrap>Automatic SCSI tape mounts</wrap> </WRAP> | |<WRAP><wrap>SHCMDOPT</wrap> </WRAP> |<WRAP><wrap>Shell command option</wrap> </WRAP> | |<WRAP><wrap>SHOWDVOL1</wrap> </WRAP> |<WRAP><wrap>Enable showing of DASD volsers in device list</wrap> </WRAP> | |<WRAP><wrap>SHRDPORT</wrap> </WRAP> |<WRAP><wrap>Shared device server port</wrap> </WRAP> | |<WRAP><wrap>SRVPRIO</wrap> </WRAP> |<WRAP><wrap>Server threads priority</wrap> </WRAP> | |<WRAP><wrap>SYMPTOM</wrap> </WRAP> |<WRAP><wrap>Instruction trace display option (alias for TRACEOPT)</wrap> </WRAP> | |<WRAP><wrap>SYSEPOCH</wrap> </WRAP> |<WRAP><wrap>Base date for TOD clock</wrap> </WRAP> | |<WRAP><wrap>TIMERINT</wrap> </WRAP> |<WRAP><wrap>Internal timer update interval</wrap> </WRAP> | |<WRAP><wrap>TODDRAG</wrap> </WRAP> |<WRAP><wrap>TOD clock drag factor</wrap> </WRAP> | |<WRAP><wrap>TODPRIO</wrap> </WRAP> |<WRAP><wrap>Timer thread process priority</wrap> </WRAP> | |<WRAP><wrap>TRACEOPT</wrap> </WRAP> |<WRAP><wrap>Instruction trace display option</wrap> </WRAP> | |<WRAP><wrap>TZOFFSET</wrap> </WRAP> |<WRAP><wrap>TOD clock offset from GMT</wrap> </WRAP> | |<WRAP><wrap>XPNDSIZE</wrap> </WRAP> |<WRAP><wrap>Expanded storage size</wrap> </WRAP> | |<WRAP><wrap>YROFFSET</wrap> </WRAP> |<WRAP><wrap>TOD clock offset from actual date</wrap> </WRAP> | **<wrap>Table 1: Hercules System Parameters</wrap>** <wrap>{{hercules:userref:bf:image016.gif|}}</wrap>**<wrap>4.3 Device Definitions</wrap>** <wrap>The device definitions describe the layout of the emulated hardware i.e: DASD, tape, terminals and printers. It is comparable with the IOCDS found in a real mainframe environment. Each emulated device must be specified in this part of the configuration file.</wrap> <wrap>The following table shows an overview of all valid devices:</wrap> <wrap>{{hercules:userref:bf:image007.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 31</wrap> <wrap>\\ </wrap> |<WRAP>**<wrap>Device Type</wrap>** </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP>**<wrap>Device</wrap>** </WRAP> |<WRAP>**<wrap>Emulated by</wrap>** </WRAP> | |<WRAP><wrap>3270, 3278</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Local non-SNA 3270 display or printer</wrap> </WRAP> |<WRAP><wrap>TN3270 client connection</wrap> </WRAP> | |<WRAP><wrap>SYSG</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Integrated 3270 (SYSG) console</wrap> </WRAP> |<WRAP><wrap>TN3270 client connection</wrap> </WRAP> | |<WRAP><wrap>1052, 3215</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Console printer-keyboards</wrap> </WRAP> |<WRAP><wrap>Telnet client connection</wrap> </WRAP> | |<WRAP><wrap>1052-C, 3215-C</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Integrated console printer- keyboards</wrap> </WRAP> |<WRAP><wrap>Integrated on Hercules console</wrap> </WRAP> | |<WRAP><wrap>1442, 2501, 3505</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Card readers</wrap> </WRAP> |<WRAP><wrap>Disk file(s), ASCII or EBCDIC</wrap> </WRAP> | |<WRAP><wrap>3525</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Card punch</wrap> </WRAP> |<WRAP><wrap>Disk file, ASCII or EBCDIC</wrap> </WRAP> | |<WRAP><wrap>1403, 3211</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Line printers</wrap> </WRAP> |<WRAP><wrap>Disk file, ASCII</wrap> </WRAP> | |<WRAP><wrap>3410, 3420, 3422,</wrap> <wrap>3490, 3590, 9347,</wrap> </WRAP> |<WRAP><wrap>3430,</wrap> <wrap>8809</wrap> </WRAP> |<WRAP><wrap>3480,</wrap> </WRAP> |<WRAP><wrap>Tape drives</wrap> </WRAP> |<WRAP><wrap>Disk file, CD-ROM or SCSI tape</wrap> </WRAP> | |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Channel-to-Channel Adapter</wrap> </WRAP> |<WRAP><wrap>“CTCT” driver</wrap> </WRAP> | |<WRAP><wrap>(( CTCI ))</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Channel-to-Channel link to host TCP/IP stack</wrap> </WRAP> |<WRAP><wrap>“CTCI” TUN/TAP driver</wrap> </WRAP> | |<WRAP><wrap>(( LCS ))</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>IBM 2216 router,</wrap> <wrap>IBM 3172 running ICP,</wrap> <wrap>IBM 8232 LCS device, LCS3172 driver of a P/390, IBM Open Systems Adapter (OSA)</wrap> </WRAP> |<WRAP><wrap>“LCS” (LAN channel station) TUN/TAP driver</wrap> </WRAP> | |<WRAP><wrap>((QETH))</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>OSA Express IP Layer 2 support only. Supported only for Linux guests. TAP adapter must be bridged to a local LAN</wrap> </WRAP> |<WRAP><wrap>“QETH” (OSA/QDIO Ethernet Adapter)</wrap> <wrap>TUN/TAP driver</wrap> </WRAP> | |<WRAP><wrap>3310, 3370, 9313,</wrap> <wrap>9335, 9336, 0671</wrap> </WRAP> |<WRAP><wrap>9332,</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>FBA direct access storage devices</wrap> </WRAP> |<WRAP><wrap>Disk file</wrap> </WRAP> | |<WRAP><wrap>2305, 2311, 2314,</wrap> <wrap>3340, 3350, 3375,</wrap> <wrap>3390, 9345</wrap> </WRAP> |<WRAP><wrap>3330,</wrap> <wrap>3380,</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>CKD direct access storage devices</wrap> </WRAP> |<WRAP><wrap>Disk file</wrap> </WRAP> | |<WRAP><wrap>2703</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Communication line</wrap> </WRAP> |<WRAP><wrap>TCP socket</wrap> </WRAP> | **<wrap>Table 2: Hercules Device Definitions</wrap>** <wrap>{{hercules:userref:bf:image010.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 32</wrap> <wrap>\\ </wrap><wrap>{{hercules:userref:bf:image005.gif|}}</wrap>**<wrap>4.4 Coding Rules</wrap>** <wrap>There are only a few rules for creating configuration files. The file must be an ASCII text file. Blank lines, or lines beginning with a hash (“#”) sign or an asterisk (“*”), are treated as comments and are not checked.</wrap> <wrap>Except for the ARCHLVL stetements, the system parameters may appear in any order but must precede any device definitions. Each system parameter must be coded on a separate line.</wrap> <wrap>The device records may also appear in any order but must follow the system parameters. There must be one device definition for each I/O device or for each group of identical I/O devices.</wrap> <wrap>{{hercules:userref:bf:image016.gif|}}</wrap>**<wrap>4.5 Record Format</wrap>** <wrap>The following sections describe the format of the Hercules configuration file records. The format is slightly different between system parameters and device definitions.</wrap> **//<wrap>4.5.1 Format of the system parameters</wrap>//** <wrap>The record format of the system parameters is as follows:</wrap> **//<wrap>system-parameter argument</wrap>//** <wrap>where:</wrap> **//<wrap>system-parameter </wrap>//**<wrap>is the name of the system parameter.</wrap> **//<wrap>argument </wrap>//**<wrap>is the value assigned to the system parameter.</wrap> **<wrap>Examples:</wrap>** <wrap>CPUMODEL 3090</wrap> <wrap>ENGINES 4*CP,2*AP,2*IP,2*IL</wrap> <wrap>HTTP ROOT /usr/local/share/hercules/ \\ PANRATE FAST</wrap> **//<wrap>4.5.2 Format of the device definitions</wrap>//** <wrap>The format of device definition is as follows: \\ </wrap>**//<wrap>devnum(s) devtype [argument(s)] \\ </wrap>//**<wrap>where:</wrap> **//<wrap>devnum(s) </wrap>//**<wrap>is either: a single devnum (see details below), a range of devnums separated by a dash (“-“), a count of devnums seperated by a dot (“.”), or a comma (“,”) separated list of devnums.</wrap> <wrap>Examples include:</wrap> <wrap>·<wrap></wrap></wrap><wrap>0200-0210</wrap> <wrap>·<wrap></wrap></wrap><wrap>0300.10</wrap> <wrap>{{hercules:userref:bf:image010.gif|}}</wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 33</wrap> <wrap>\\ </wrap><wrap>·<wrap></wrap></wrap><wrap>0400,0410</wrap> <wrap>·<wrap></wrap></wrap><wrap>0100,0110-011F</wrap> <wrap>If devnums specifies more than one device then all devices will have identical characteristics. All devices defined as a group must be defined on a single channel. A channel is defined as a continuous group of 256 (or hexadecimal 100) devices. For example devices 0010 and 0020 are on the same channel, whereas devices 0100 and 0210 are not on the same channel.</wrap> <wrap>The devnum itself is either a 1 to 4 digit hexadecimal number in the range 0000 to FFFF for ESA/390 or 0000 to 0FFF for S/370. The device number uniquely identifies each device to the operating system.</wrap> **//<wrap>devtype </wrap>//**<wrap>is the device type.</wrap> **//<wrap>argument(s) </wrap>//**<wrap>is a list of parameters depending on the device type. These parameters are explained in the sections that describe each device type.</wrap> **<wrap>Examples:</wrap>** |<WRAP><wrap>0120</wrap> </WRAP> |<WRAP><wrap>3380</wrap> </WRAP> |<WRAP><wrap>mvsv5r.120</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>0230.16</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>GROUP1 192.168.100.0</wrap> </WRAP> |<WRAP><wrap>255.255.255.0</wrap> </WRAP> | |<WRAP><wrap>0583-0587</wrap> </WRAP> |<WRAP><wrap>3420</wrap> </WRAP> |<WRAP><wrap>* maxsizeM=170 eotmargin=131072</wrap> </WRAP> | | <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>4.6 Sample Configuration File</wrap>** <wrap>The following figure shows a real example of a Hercules configuration file, used for running the MVS 3.8J operating system. Please note, that not all possible parameter and definitions are contained in this sample.</wrap> <wrap># %%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%</wrap> <wrap># Hercules V4.00.0 Emulator Control file</wrap> <wrap># MVS V3.8J</wrap> <wrap># %%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%</wrap> <wrap># ================= \\ # System parameters</wrap> <wrap># =================</wrap> <wrap>ARCHLVL S/370 # Initial architecture mode</wrap> <wrap>CAPPING 25 # CPU capping (MIPS)</wrap> <wrap>CNSLPORT 3270 # Telnet client port</wrap> <wrap>CODEPAGE DEFAULT # Codepage conversion table</wrap> <wrap>CPUMODEL 7060 # CPU model</wrap> <wrap>CPUSERIAL 001963 # CPU serial number</wrap> <wrap>DEFSYM DASDPATH D:/MVS/DASD # Define symbol for CCKD DASD device path</wrap> <wrap>DEFSYM READERPATH </wrap>[[file:///D:/MVS/READER|<wrap>D:/MVS/READER</wrap>]]<wrap> # Define symbol for READER device path</wrap> <wrap>DEFSYM PRINTPATH </wrap>[[file:///D:/MVS/PRINTER|<wrap>D:/MVS/PRINTER</wrap>]]<wrap> # Define symbol for PRINTER device path</wrap> <wrap>DEFSYM PUNCHPATH </wrap>[[file:///D:/MVS/PUNCH|<wrap>D:/MVS/PUNCH</wrap>]]<wrap> # Define symbol for PUNCH device path</wrap> <wrap>DEVTMAX 0 # Maximum number of device threads</wrap> <wrap>ENGINES CP # Processor engine types</wrap> <wrap>HERCLOGO HERCLOGO.TXT # Hercules 3270 logo file</wrap> <wrap><wrap>{{hercules:userref:bf:image018.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image018.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image018.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image018.gif|}}</wrap></wrap><wrap>HTTP PORT 8089 NOAUTH # HTTP server port / authorization data</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 34</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HTTP ROOT </wrap>[[file:///D:/Hercules/html|<wrap>D:%%\%%Hercules%%\%%html</wrap>]]<wrap> # HTTP server root directory</wrap> <wrap>HTTP START # Start the HTTP server</wrap> <wrap>LOGOPT TIMESTAMP # Hercules log options</wrap> <wrap>LPARNAME HERCULES # LPAR name returned by DIAG X'204'</wrap> <wrap>MAINSIZE 16 # Main storage in MB</wrap> <wrap>MANUFACTURER HRC # Manufacturer name returned by STSI</wrap> <wrap>MAXCPU 1 # Maximum number of CPUs</wrap> <wrap>MODEL 7060 # Model name returned by STSI</wrap> <wrap>NUMCPU 1 # Number of emulated CPUs</wrap> <wrap>OSTAILOR OS/390 # Intended operating system</wrap> <wrap>PANRATE 1000 # Panel refresh rate [ms]</wrap> <wrap>PANTITLE "Hercules Emulator HMC" # Hercules HMC window title</wrap> <wrap>PGMPRDOS RESTRICTED # Emulation of IFL hardware</wrap> <wrap>PLANT ZZ # Plant name returned by STSI</wrap> <wrap>SYSEPOCH 1900 +28 # Base date for TOD clock</wrap> <wrap>TIMERINT 50 # Internal timer update interval</wrap> <wrap>TRACEOPT TRADITIONAL # Instruction trace display option</wrap> <wrap>TZOFFSET +0000 # TOD clock offset from GMT</wrap> <wrap><wrap>{{hercules:userref:bf:image019.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image019.gif|}}</wrap></wrap><wrap># ================== \\ # Device Definitions</wrap> <wrap><wrap>{{hercules:userref:bf:image019.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image019.gif|}}</wrap></wrap><wrap># ==================</wrap> <wrap><wrap>{{hercules:userref:bf:image020.gif|}}</wrap></wrap><wrap># ---------- \\ # Card Readers</wrap> <wrap><wrap>{{hercules:userref:bf:image020.gif|}}</wrap></wrap><wrap># ---------- </wrap> <wrap>000C 3505 $(READERPATH)/DUMMY.JCL eof ascii trunk</wrap> <wrap><wrap>{{hercules:userref:bf:image020.gif|}}</wrap></wrap><wrap># ---------- \\ # Card Punches</wrap> <wrap><wrap>{{hercules:userref:bf:image020.gif|}}</wrap></wrap><wrap># ---------- </wrap> <wrap>000D 3525 $(PUNCHPATH)/PCH00D.TXT ascii crlf</wrap> <wrap><wrap>{{hercules:userref:bf:image021.gif|}}</wrap></wrap><wrap># ----------- \\ # Line Printers</wrap> <wrap><wrap>{{hercules:userref:bf:image021.gif|}}</wrap></wrap><wrap># ----------- </wrap> <wrap>000E 1403 $(PRINTPATH)/PRT00E.TXT crlf</wrap> <wrap>000F 1403 $(PRINTPATH)/PRT00F.TXT crlf</wrap> <wrap><wrap>{{hercules:userref:bf:image022.gif|}}</wrap></wrap><wrap># -------------------- \\ # Local Non-SNA Terminals</wrap> <wrap><wrap>{{hercules:userref:bf:image022.gif|}}</wrap></wrap><wrap># -------------------- </wrap> <wrap>0010 3270 * 192.168.0.101 0011 3270 * 192.168.0.101 00C0 3270 * 192.168.0.101 00C1 3270 * 192.168.0.101 00C2 3270 * 192.168.0.101</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 35</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>{{hercules:userref:bf:image024.gif|}}</wrap></wrap><wrap># -------------- \\ # CCKD DASD Devices</wrap> <wrap><wrap>{{hercules:userref:bf:image024.gif|}}</wrap></wrap><wrap># -------------- </wrap> <wrap>0130 2314 $(DASDPATH)/SORT00.CCKD 0131 2314 $(DASDPATH)/SORT01.CCKD 0132 2314 $(DASDPATH)/SORT02.CCKD 0133 2314 $(DASDPATH)/SORT03.CCKD 0134 2314 $(DASDPATH)/SORT04.CCKD 0135 2314 $(DASDPATH)/SORT05.CCKD 0140 3350 $(DASDPATH)/WORK00.CCKD 0141 3350 $(DASDPATH)/WORK01.CCKD 0142 3350 $(DASDPATH)/PRD000.CCKD 0148 3350 $(DASDPATH)/MVSRES.CCKD 0149 3350 $(DASDPATH)/MVSDLB.CCKD 0160 3340 $(DASDPATH)/PAGE00.CCKD 0161 3340 $(DASDPATH)/PAGE01.CCKD 0240 3350 $(DASDPATH)/PUB000.CCKD 0248 3350 $(DASDPATH)/SYS000.CCKD 0344 3350 $(DASDPATH)/SPOOL0.CCKD 0345 3350 $(DASDPATH)/SPOOL1.CCKD 0348 3350 $(DASDPATH)/TST000.CCKD</wrap> <wrap><wrap>{{hercules:userref:bf:image020.gif|}}</wrap></wrap><wrap># ---------- \\ # TAPE Devices</wrap> <wrap><wrap>{{hercules:userref:bf:image020.gif|}}</wrap></wrap><wrap># ---------- </wrap> <wrap>0480 3420 *</wrap> <wrap>0481 3420 *</wrap> <wrap><wrap>{{hercules:userref:bf:image025.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image025.gif|}}</wrap></wrap><wrap># ===== \\ # (EOF)</wrap> <wrap><wrap>{{hercules:userref:bf:image025.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image025.gif|}}</wrap></wrap><wrap># =====</wrap> <wrap>\\ </wrap><wrap></wrap> <wrap>\\ </wrap>**<wrap>Figure 1: Sample Configuration File</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>4.7 Symbol Substitution</wrap>** <wrap>In configuration statements, as well as in console commands and OAT files, symbols may be substituted for text. To substitute symbol //symbol //with its contents the symbol should be enclosed within parenthesis or braces and preceded by a $ sign. For example, if symbol "//foo" //contains the text string //"bar" //then "$(foo)" or "${foo}" will be substituted with the string //"bar"//.</wrap> <wrap>Symbols are defined using a DEFSYM configuration statement or a DEFSYM panel command or can be operating system environment variables. There are several predefined symbols (see table below). To resolve the symbol substitution a symbol with that name defined via DEFSYM is searched first. If none can be found then a check is made to see if an environment variable with the same name exists.</wrap> <wrap>If a symbol is not defined then an empty string will be substituted. By coding an additional default value following an equal sign (“=”) or a colon-equal-sign (":=") the default value is substituted instead of an empty string if the symbol is not defined.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 36</wrap> <wrap>\\ </wrap><wrap>Note that the default value is a literal string and no substitution is applied to it. Thus attempting to use the syntax "${foo=${bar}}" will not yield the expected results. It will not be substituted with the currently defined value of the "bar" environment variable, but rather by the literal string "${bar" followed immediately by the literal character '}'.</wrap> <wrap>Symbols created with DEFSYM or environment variables can also be used as part of panel commands. For example the command "cd $(TAPEDIR)" will change the current directory to the resolved string for the symbol TAPEDIR.</wrap> <wrap>It is important to note that symbol names, potentially being the names of environment variables, are subject to whatever case sensitivity the host operating system happens to enforce or allow. Under Windows environment variables are not case sensitive, whereas on other operating systems they may be. Thus "$(FOO)", "$(foo)" or "$(Foo)" all cause the same value to be substituted on Windows, whereas they could be substituted with completely different values under a case sensitive operating system.</wrap> **//<wrap>4.7.1 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>$(//symbol//[[:]=//default//]) \\ or</wrap> <wrap>${//symbol//[[:]=//default//]}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ $ ¬¬¬§¬¬¬ ( ¬¬¬§¬¬¬ </wrap>****//<wrap>symbol </wrap>//****<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬ ) ¬¬¬§¬¬¬¬¬¬ÊÍ</wrap>** <wrap>⡿ØØØ{ØØØ ªØØØ:=</wrap>**//<wrap>default </wrap>//**<wrap>ØØØØ« ⡿ØØØ}ØØØ¯</wrap> <wrap>⡿ØØØ=</wrap>**//<wrap>default </wrap>//**<wrap>ØØØØØ</wrap> **//<wrap>4.7.2 Parameter</wrap>//** **//<wrap>symbol </wrap>//**<wrap>This is the name of the symbol.</wrap> **//<wrap>default </wrap>//**<wrap>This is the default value that takes place if the symbol is not defined.</wrap> **//<wrap>4.7.3 Special symbols</wrap>//** **<wrap>4.7.3.1 Predefined symbols</wrap>** <wrap>The symbols according to the following table are predefined and can be used without defining the symbol through a corresponding DEFSYM configuration statement or panel command.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 37</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Symbol name</wrap>** </WRAP> |<WRAP>**<wrap>Assigned value</wrap>** </WRAP> |<WRAP>**<wrap>Example string</wrap>** </WRAP> | |<WRAP><wrap>BDATE</wrap> </WRAP> |<WRAP><wrap>Hercules build date</wrap> </WRAP> |<WRAP><wrap>‘Sep 22 2010’</wrap> </WRAP> | |<WRAP><wrap>BTIME</wrap> </WRAP> |<WRAP><wrap>Hercules build time</wrap> </WRAP> |<WRAP><wrap>’19:13:03’</wrap> </WRAP> | |<WRAP><wrap>CUU</wrap> </WRAP> |<WRAP><wrap>3 digit device number, upper case hexadecimal digits</wrap> </WRAP> |<WRAP><wrap>‘12A’</wrap> </WRAP> | |<WRAP><wrap>CUUU</wrap> </WRAP> |<WRAP><wrap>4 digit device number, upper case hexadecimal digits</wrap> </WRAP> |<WRAP><wrap>‘012A’</wrap> </WRAP> | |<WRAP><wrap>cuu</wrap> </WRAP> |<WRAP><wrap>3 digit device number, lower case hexadecimal digits</wrap> </WRAP> |<WRAP><wrap>‘12a’</wrap> </WRAP> | |<WRAP><wrap>cuuu</wrap> </WRAP> |<WRAP><wrap>4 digit device number, lower case hexadecimal digits</wrap> </WRAP> |<WRAP><wrap>‘012a’</wrap> </WRAP> | |<WRAP><wrap>DEVN</wrap> </WRAP> |<WRAP><wrap>4 digit device number, upper case hexadecimal digits</wrap> </WRAP> |<WRAP><wrap>‘012A’</wrap> </WRAP> | |<WRAP><wrap>HOSTARCH</wrap> </WRAP> |<WRAP><wrap>Host system architecture</wrap> </WRAP> |<WRAP><wrap>‘i686’</wrap> </WRAP> | |<WRAP><wrap>HOSTNAME</wrap> </WRAP> |<WRAP><wrap>Name of the host system</wrap> </WRAP> |<WRAP><wrap>‘GOOFY’</wrap> </WRAP> | |<WRAP><wrap>HOSTNUMCPUS</wrap> </WRAP> |<WRAP><wrap>The number of CPUs of the host system</wrap> </WRAP> |<WRAP><wrap>‘MP=8’</wrap> </WRAP> | |<WRAP><wrap>HOSTOS</wrap> </WRAP> |<WRAP><wrap>Host operating system</wrap> </WRAP> |<WRAP><wrap>‘Windows’</wrap> </WRAP> | |<WRAP><wrap>HOSTOSREL</wrap> </WRAP> |<WRAP><wrap>Host operating system release</wrap> </WRAP> |<WRAP><wrap>‘6.1.7600’</wrap> </WRAP> | |<WRAP><wrap>HOSTOSVER</wrap> </WRAP> |<WRAP><wrap>Host operating system version</wrap> </WRAP> |<WRAP><wrap>‘7 Ultimate Edition, 64-bit’</wrap> </WRAP> | |<WRAP><wrap>MODNAME</wrap> </WRAP> |<WRAP><wrap>Module name of the startup program</wrap> </WRAP> |<WRAP><wrap>‘hercules.exe’</wrap> </WRAP> | |<WRAP><wrap>MODPATH</wrap> </WRAP> |<WRAP><wrap>Path name of the startup program</wrap> </WRAP> |<WRAP><wrap>‘D:%%\%%Hercules%%\%%’</wrap> </WRAP> | |<WRAP><wrap>VERSION</wrap> </WRAP> |<WRAP><wrap>Hercules version</wrap> </WRAP> |<WRAP><wrap>‘3.07’</wrap> </WRAP> | **<wrap>Table 3: Predefined symbols</wrap>** **<wrap>4.7.3.2 Environment variables</wrap>** <wrap>If a symbol is not explicitly defined by a DEFSYM statement and an environment variable by the same name exists, then the string contents of that environment variable will be used for substitution.</wrap> **<wrap>4.7.3.3 Undefined symbols</wrap>** <wrap>If a symbol is not defined by an explicit DEFSYM, is not an automatically generated symbol or is not an environment variable, an empty string will be substituted.</wrap> **//<wrap>4.7.4 Escaping substitution, recursion</wrap>//** <wrap>To specify the '$’ string without incurring substitution an additional '$' sign should be used. For example, $$(FOO) will not be substituted. If substitution is required but the preceding text is to contain a '$' sign as the very last character then $$$(FOO) would be specified. Thus if symbol FOO contains "BAR", then $$(FOO) will remain "$$(FOO)" while $$$(FOO) will become "$BAR". Substitution is not recursive, only one substitution pass is made.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 38</wrap> <wrap>\\ </wrap>**//<wrap>4.7.5 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>The DEFSYM configuration statement</wrap> <wrap>DEFSYM TAPEDIR "/home/hercules/tapes"</wrap> <wrap>and the symbol substitution in the device definition</wrap> <wrap>0380 3420 $(TAPEDIR)/scratch.aws</wrap> <wrap>results in the following device definition used by Hercules</wrap> <wrap>0380 3420 /home/hercules/tapes/scratch.aws</wrap> **<wrap>Example 2:</wrap>** <wrap>The DEFSYM configuration statement</wrap> <wrap>DEFSYM DASDPATH "</wrap>[[file:///D:/HERCULES/DASD|<wrap>D:/HERCULES/DASD</wrap>]]<wrap>"</wrap> <wrap>and the following symbol substitution in the device configuration</wrap> <wrap>0148 3350 $(DASDPATH:=D:/MVS/DASD)/MVSRES.CKD</wrap> <wrap>results in the following device definition with resolved DASDPATH symbol</wrap> <wrap>0148 3350 </wrap>[[file:///D:/HERCULES/DASD/MVSRES.CKD|<wrap>D:/HERCULES/DASD/MVSRES.CKD</wrap>]]<wrap></wrap> <wrap>If however there is no symbol DASDPATH (the DEFSYM statement is missing) then the symbol in the device definition is resolved with the defined default</wrap> <wrap>0148 3350 </wrap>[[file:///D:/MVS/DASD/MVSRES.CKD|<wrap>D:/MVS/DASD/MVSRES.CKD</wrap>]]<wrap></wrap> **<wrap>Example 3:</wrap>** <wrap>The device definition using the predefined symbol "CUUU"</wrap> <wrap>0148.5 3350 </wrap>[[file:///D:/MVS/DASD/VOLSER.|<wrap>D:/MVS/DASD/VOLSER.</wrap>]]<wrap>$(CUUU)</wrap> <wrap>results in the following device definitions used by Hercules</wrap> <wrap>0148 3350 </wrap>[[file:///D:/MVS/DASD/VOLSER.0148|<wrap>D:/MVS/DASD/VOLSER.0148</wrap>]]<wrap>\\ 0149 3350 </wrap>[[file:///D:/MVS/DASD/VOLSER.0149|<wrap>D:/MVS/DASD/VOLSER.0149</wrap>]]<wrap></wrap> <wrap>014A 3350 </wrap>[[file:///D:/MVS/DASD/VOLSER.014A|<wrap>D:/MVS/DASD/VOLSER.014A</wrap>]]<wrap></wrap> <wrap>014B 3350 </wrap>[[file:///D:/MVS/DASD/VOLSER.014B|<wrap>D:/MVS/DASD/VOLSER.014B</wrap>]]<wrap></wrap> <wrap>014C 3350 </wrap>[[file:///D:/MVS/DASD/VOLSER.014C|<wrap>D:/MVS/DASD/VOLSER.014C</wrap>]]<wrap></wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 39</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap></wrap>**<wrap>5. System Parameter Descriptions</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>5.1 # (Comment line) \\ //5.1.1 Function//</wrap>** <wrap>The hash (“#”) symbol marks the beginning of a comment or a full comment line.</wrap> **//<wrap>5.1.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap># [</wrap>//<wrap>anything</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ # ¬¬¬§</wrap> //<wrap>anything</wrap>// **//<wrap>5.1.3 Parameter</wrap>//** **//<wrap>anything </wrap>//**<wrap>Any text following the asterisk symbol.</wrap> **//<wrap>5.1.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Add comment lines to the configuration file and add comment after the system parameter.</wrap> <wrap># ┌─────────────────────────────────────────┐</wrap> <wrap># │ </wrap><wrap>System Parameters </wrap><wrap>│</wrap> <wrap># └─────────────────────────────────────────┘</wrap> <wrap>NUMCPU 2 # Number of emulated CPUs</wrap> <wrap>MAINSIZE 1024 # Main storage in MB</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 40</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.2 * (Comment line) \\ //5.2.1 Function//</wrap>** <wrap>The asterisk (“*”) symbol marks the beginning of a comment or a full comment line.</wrap> **//<wrap>5.2.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>* [</wrap>//<wrap>anything</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ * ¬¬¬§</wrap> //<wrap>anything</wrap>// **//<wrap>5.2.3 Parameter</wrap>//** **//<wrap>anything </wrap>//**<wrap>Any text following the hash symbol.</wrap> **//<wrap>5.2.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Add comment lines to the configuration file and add comment after the system parameter.</wrap> <wrap>* </wrap><wrap>┌─────────────────────────────────────────┐</wrap> <wrap>* │ System Parameters │</wrap> <wrap>* └─────────────────────────────────────────┘</wrap> <wrap>NUMCPU 2 * Number of emulated CPUs</wrap> <wrap>MAINSIZE 1024 * Main storage in MB</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 41</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.3 ARCHLVL (Set architecture level) \\ //5.3.1 Function//</wrap>** <wrap>The ARCHLVL system parameter specifies the initial architecture mode. Additional ARCHLVL statements may be specified to enable or disable specific facilities, to override the STFLE (Store Facility List Extended) response and force it to return a certain (incorrect) bit pattern or to display the status (enabled or disabled) of facilities during startup. An overview of all architecture facilities can be found in “Appendix C. Architecture Facilities” on page 643.</wrap> **//<wrap>5.3.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>ARCHLVL {S/370 | ESA/390 | ESAME | </wrap>__<wrap>z/ARCH</wrap>__<wrap>}</wrap> <wrap>or</wrap> <wrap>ARCHLVL {ENABLE | DISABLE} </wrap>//<wrap>facility </wrap>//<wrap>[S/370 | ESA/390 | ESAME | z/ARCH]</wrap> <wrap>or</wrap> <wrap>ARCHLVL QUERY [</wrap>//<wrap>facility </wrap>//<wrap>| </wrap>__<wrap>ALL</wrap>__<wrap>]</wrap> <wrap>or</wrap> <wrap>ARCHLVL {ENABLE | DISABLE} </wrap>//<wrap>bitno </wrap>//<wrap>[S/370 | ESA/390 | ESAME | z/ARCH]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_ARCHLVL %%__%%_i%%__%%_ S/370 %%__%%%%__%%_i%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>I%%__%%_ ESA/390%%__%%_«</wrap> <wrap>f%%__%%_ ESAME%%__%%%%__%%_«</wrap> <wrap>L%%__%%_ </wrap>__<wrap>z/ARCH</wrap>__<wrap> %%__%%%%__%%¯</wrap> <wrap>or</wrap> <wrap>ÊÊ¬¬¬ ARCHLVL ¬¬¬§¬¬¬ ENABLE ¬¬¬¬§¬¬¬ </wrap>//<wrap>facility </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>%%__%%_ DISABLE %%__%%_ 1%%__%%_ S/370%%__%%%%__%%_« I%%__%%_ ESA/390%%__%%_« f%%__%%_ ESAME%%__%%%%__%%_« I%%__%%_ z/ARCH%%__%%%%__%%¯</wrap> |<WRAP><wrap>or</wrap> <wrap>ÊÊ¬¬¬ ARCHLVL ¬¬¬ QUERY</wrap> </WRAP> |<WRAP><wrap>~¬¬¬¬¬ ALL ¬¬¬¬¬¬®</wrap> <wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ %%__%%_</wrap>//<wrap>facility </wrap>//<wrap>%%__%%_¯</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 42</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>or</wrap> <wrap>ÊÊ¬¬¬ ARCHLVL ¬¬¬§¬¬¬ </wrap><wrap>ENABLE </wrap><wrap>¬¬¬¬§¬¬¬ </wrap>//<wrap>bitno </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿%%__%%_ DISABLE %%__%%_ ª%%__%%_ S/370 %%__%%%%__%%_« ª%%__%%_ ESA/390 %%__%%_« ª%%__%%_ ESAME %%__%%%%__%%_« ⡿%%__%%_z/ARCH%%__%%%%__%%¯</wrap> **//<wrap>5.3.3 Parameter</wrap>//** **<wrap>S/370 </wrap>**<wrap>Use S/370 for OS/360, VM/370 and MVS 3.8.</wrap> **<wrap>ESA/390 </wrap>**<wrap>Use ESA/390 for MVS/XA, MVS/ESA, OS/390, VM/ESA, VSE/ESA, Linux/390 and ZZSA. zOS can be run until version 1.2 with ESA/390 mode without installed bimodal feature or until version 1.4 if the bimodal feature is installed.</wrap> **<wrap>ESAME </wrap>**<wrap>Use ESAME (Enterprise System Architecture, Modal Extensions) for z/OS, z/VM, z/VSE and z/Linux. The ESAME mode is equivalent to z/Archtecture mode at at Architecture Level 2.</wrap> <wrap>When ESAME is specified, the machine will always be IPL’ed in ESA/390 mode but the system is capable of being switched into the z/Architecture mode after IPL. This is handled automatically by all z/Architecture operating systems.</wrap> **<wrap>z/ARCH </wrap>**<wrap>Use z/ARCH for z/OS, z/VM, z/VSE and z/Linux. z/ARCH is similar to ESAME. The z/Arch mode is equivalent to z/Architecture mode at Architecture Level 3.</wrap> **<wrap>ENABLE </wrap>**<wrap>Enable the specified facility. If no architecture mode is given as additional parameter the facility is enabled for all architecture modes.</wrap> **<wrap>DISABLE </wrap>**<wrap>Disable the specified facility. If no architecture mode is given as additional parameter the facility is disabled for all architecture modes.</wrap> **//<wrap>facility </wrap>//**<wrap>The name of the facility that has to be enabled, disabled or displayed. An overview of all architecture facilities can be found in “Appendix C. Architecture Facilities” on page 643.</wrap> **//<wrap>bitno </wrap>//**<wrap>The bit number of the facility that has to be enabled or disabled. The format of //bitno //is BIT//nn//, e.g. “BIT44” (Bit 44 = PFPO Facility Bit). An overview of all architecture facilities can be found in “Appendix C. Architecture Facilities” on page 643.</wrap> **<wrap>QUERY </wrap>**<wrap>Display the settings for the specified facility.</wrap> **<wrap>ALL </wrap>**<wrap>Specifies that all facilities have to be displayed.</wrap> **//<wrap>5.3.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the architecture level to S/370.</wrap> <wrap>ARCHLVL S/370</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 43</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Disable the ‘DECIMAL_FLOAT’ facility in z/Architecture mode.</wrap> <wrap>ARCHLVL DISABLE DECIMAL_FLOAT z/ARCH</wrap> **<wrap>Example 3:</wrap>** <wrap>Force the PFPO feature to be enabled in all architecture modes.</wrap> <wrap>ARCHLVL ENABLE BIT44</wrap> **<wrap>Example 4:</wrap>** <wrap>Display the facility settings during the Hercules startup messages.</wrap> <wrap>ARCHLVL QUERY ALL</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 44</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.4 ARCHMODE (Initial architecture mode) \\ //5.4.1 Function//</wrap>** <wrap>The ARCHMODE parameter has been deprececated. This parameter was used to specifies the initial architecture mode.</wrap> <wrap>ARCHMODE is still accepted and is treated as an alias for the new ARCHLVL system parameter. All existing ARCHMODE statements should be changed to ARCHLVL. Please see ARCHLVL for details.</wrap> **//<wrap>5.4.2 Syntax</wrap>//** <wrap>See ARCHLVL system parameter.</wrap> **//<wrap>5.4.3 Parameter</wrap>//** <wrap>See ARCHLVL system parameter.</wrap> **//<wrap>5.4.4 Examples</wrap>//** <wrap>See ARCHLVL system parameter.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 45</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.5 ASN_AND_LX_REUSE / ALRF (ESAME ASN and LX REUSE feature)</wrap>** **//<wrap>5.5.1 Function</wrap>//** <wrap>The ASN_AND_LX_REUSE (ALRF) system parameter has been deprecated and is replaced by the ARCHLVL system parameter. Use “ARCHLVL ENABLE | DISABLE ASN_LX_REUSE” instead. See ARCHLVL system parameter for details.</wrap> **//<wrap>5.5.2 Syntax</wrap>//** <wrap>See ARCHLVL system parameter.</wrap> **//<wrap>5.5.3 Parameter</wrap>//** <wrap>See ARCHLVL system parameter.</wrap> **//<wrap>5.5.4 Examples</wrap>//** <wrap>See ARCHLVL system parameter.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 46</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.6 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts) //5.6.1 Function//</wrap>** <wrap>The AUTO_SCSI_MOUNT system parameter has been deprecated and is replaced by SCSIMOUNT. See SCSIMOUNT system parameter for details.</wrap> **//<wrap>5.6.2 Syntax</wrap>//** <wrap>See SCSIMOUNT system parameter.</wrap> **//<wrap>5.6.3 Parameter</wrap>//** <wrap>See SCSIMOUNT system parameter.</wrap> **//<wrap>5.6.4 Examples</wrap>//** <wrap>See SCSIMOUNT system parameter.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 47</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.7 AUTOINIT (Automatic creation of empty tape files) //5.7.1 Function//</wrap>** <wrap>The AUTOINIT system parameter controls the automatic creation of empty tape files. AUTOINIT handles the "file not found" condition for a specified tape file. It controls if DEVINIT returns a "file not found" error or creates an empty tape file if the tape file could not be found. The default for AUTOINIT is OFF.</wrap> **//<wrap>5.7.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>AUTOINIT (ON | </wrap>__<wrap>OFF</wrap>__<wrap>}____</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_AUTOINIT %%__%%_i%%__%%_ ON </wrap> <wrap>L%%__%%_ </wrap>__<wrap>OFF</wrap>__<wrap></wrap> </WRAP> | **//<wrap>5.7.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>When AUTOINIT is set ON, DEVINIT will initialize a blank, non-labeled tape if the specified tape file is not found. Next, DEVINIT writes two tapemarks, rewinds the tape and positions the tape to the beginning.</wrap> **<wrap>OFF </wrap>**<wrap>When AUTOINIT is set OFF (which is the default), DEVINIT will return a "file not found" error if the specified tape file is not found.</wrap> **//<wrap>5.7.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Switch on the automatic creation of empty tape files.</wrap> <wrap>AUTOINIT ON</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 48</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.8 AUTOMOUNT (Tape automount root directory) \\ //5.8.1 Function//</wrap>** <wrap>Specifies the host system directory where the guest is allowed or not allowed to automatically load virtual tape volumes from. Prefix allowable directories with a '+' (plus) sign and unallowable directories with a '-' (minus) sign. The default prefix if neither is specified is the '+' sign (an allowable directory).</wrap> <wrap>All host system virtual tape volumes to be automounted by the guest must reside within one of the specified allowable host system directories or any of its subdirectories while not also being within any of the specified unallowable directories or any of their subdirectories, in order for the guest-invoked automount to be accepted.</wrap> <wrap>Specifying a disallowed automount directory does not preclude the Hercules operator from manually mounting any file via the DEVINIT console command - even one in a currently defined disallowed auto-mount directory. The AUTOMOUNT statement only controls guest-invoked automatic tape mounts and not manual tape mounts performed by the Hercules operator.</wrap> <wrap>All directories must be specified on separate statements, but as many statements as needed may be specified in order to describe the desired allowable/unallowable directories layout. For convenience, an AUTOMOUNT console command is also provided to dynamically add new or remove existing automount directories at any time.</wrap> <wrap>The automount feature is activated whenever you specify at least one allowable or unallowable directory. If only unallowable directories are specified, then the current directory becomes the only defined allowable automount directory by default.</wrap> <wrap>All specified directories are always resolved to fully-qualified absolute directory paths before being saved.</wrap> **<wrap>Caution: </wrap>**<wrap>Enabling this feature may have security consequences depending on which allowable host system directories you specify as well as how your guest operating system enforces authorized use of the Set Diagnose (X'4B') channel command code.</wrap> <wrap>Refer to the description of the virtual tape device 'NOAUTOMOUNT' option for more information.</wrap> **//<wrap>5.8.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>AUT0M0UNT </wrap><wrap>[ + </wrap><wrap>|</wrap><wrap>- ]</wrap>//<wrap>directory</wrap>// <wrap>or</wrap> <wrap>AUT0M0UNT (ADD </wrap>//<wrap>directory </wrap>//<wrap>| DEL </wrap>//<wrap>directory</wrap>//<wrap>}</wrap> |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬AUT0M0UNT</wrap> </WRAP> |<WRAP><wrap>~¬¬¬ + ¬¬¬®</wrap> <wrap>¬¬¬</wrap><wrap>¦¬¬¬¬¬¬¬¬¬¦¬¬¬ </wrap>//<wrap>directory \\ </wrap>//<wrap>⡿¬¬¬ </wrap><wrap>- </wrap><wrap>¬¬¬¯</wrap> </WRAP> | <wrap>or</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 49</wrap> <wrap>\\ </wrap>|<WRAP><wrap>ÊÊ%%__%%_AUTOMOUNT %%__%%_§%%__%%_ ADD </wrap>//<wrap>directory ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>//<wrap>L%%__%%_ DEL </wrap>//<wrap>directory </wrap>//<wrap>%%__%%_¯</wrap> </WRAP> | **//<wrap>5.8.3 Parameter</wrap>//** **<wrap>ADD or + </wrap>**<wrap>Add an entry to the list of allowable tape automount directories.</wrap> **<wrap>DEL or - </wrap>**<wrap>Delete an entry from the list of allowable tape automount directories.</wrap> **//<wrap>directory </wrap>//**<wrap>Specifies the host system directory where the guest is allowed or not to automatically load virtual tape volumes from.</wrap> **//<wrap>5.8.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify directory “D:%%\%%MVS%%\%%TAPE” as the host system directory from where the guest is allowed to automatically load virtual tape volumes.</wrap> <wrap>AUTOMOUNT +D:/MVS/TAPE</wrap> <wrap>or</wrap> <wrap>AUTOMAOUNT ADD </wrap>[[file:///D:/MVS/TAPE|<wrap>D:/MVS/TAPE</wrap>]]<wrap></wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 50</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.9 CAPPING (CPU capping feature) \\ //5.9.1 Function//</wrap>** <wrap>The CAPPING system parameter is used to cap the CPUs. If //mips //is greater than zero then all of the ‘CP’ type processors are capped to this value. If //mips //is equal to zero or “OFF” or the CAPPING system parameter is not coded in the configuration file then the capping is disabled.</wrap> <wrap>Only CPUs of type CP are capped. CPUs of type IL, AP or IP are never capped. The CPU string on the Hercules device and status panel which shows the CPU usage turns from white to red during the time the CPU is capped.</wrap> **//<wrap>5.9.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CAPPING (</wrap>//<wrap>mips </wrap>//<wrap>| </wrap>__<wrap>OFF</wrap>__<wrap> | 0}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>CAPPING </wrap><wrap>¬¬¬§¬¬¬ </wrap>//<wrap>mips </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ </wrap>__<wrap>OFF</wrap>__<wrap> ¬¬¬¬«</wrap> <wrap>⡿¬¬¬¬ 0 </wrap><wrap>¬¬¬</wrap><wrap>¬¬</wrap> **//<wrap>5.9.3 Parameter</wrap>//** **//<wrap>mips </wrap>//**<wrap>Maximum total number of MIPS for all the ‘CP’ type processors.</wrap> **<wrap>OFF </wrap>**<wrap>Disables the CPU capping.</wrap> **<wrap>0 </wrap>**<wrap>This is the same as OFF.</wrap> **//<wrap>5.9.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the CPU capping to 25 MIPS.</wrap> <wrap>CAPPING 25</wrap> **<wrap>Example 2:</wrap>** <wrap>Disable the CPU capping feature.</wrap> <wrap>CAPPING OFF</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 51</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.10 CCKD (Compressed CKD DASD options) \\ //5.10.1 Function//</wrap>** <wrap>The CCKD system parameter is used to alter CCKD processing. The CCKD system parameter supports the same options as the CCKD console command.</wrap> **//<wrap>5.10.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CCKD </wrap>//<wrap>op</wrap>////<wrap>tion=value </wrap>//<wrap>[,</wrap>//<wrap>option=value </wrap>//<wrap>[,</wrap>//<wrap>option=value </wrap>//<wrap>... ]] \\ </wrap><wrap>where option can be:</wrap> <wrap>[COMP={</wrap>__<wrap>-1</wrap>__<wrap> | </wrap>//<wrap>n</wrap>//<wrap>}]</wrap> <wrap>[,COMPPARM={</wrap>__<wrap>-1</wrap>__<wrap> | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,RA={</wrap><wrap>2 </wrap><wrap>| </wrap>//<wrap>n</wrap>//<wrap>}]</wrap> <wrap>[,RAQ={</wrap><wrap>4 </wrap><wrap>| </wrap>//<wrap>n</wrap>//<wrap>}]</wrap> <wrap>[,RAT={</wrap><wrap>2 </wrap><wrap>| </wrap>//<wrap>n</wrap>//<wrap>}]</wrap> <wrap>[,WR={</wrap><wrap>2 </wrap><wrap>| </wrap>//<wrap>n</wrap>//<wrap>}]</wrap> <wrap>[,GCINT={__10__ | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,GCPARM={0 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,NOSTRESS={0 | 1}] \\ [,FREEPEND={</wrap>__<wrap>-1</wrap>__<wrap> | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,FSYNC={0 | 1}] \\ [,TRACE={0 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,LINUXNULL={0 | 1}] \\ [,GCSTART={0 | 1}]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬¬® </wrap><wrap>ÊÊ¬¬¬ CCKD ¬¬¬°¬¬¬« //option=value //ª¬¬¬¨¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>where option can be:</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 52</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**<wrap>I</wrap>****<wrap>¬¬¬ COMP= ¬¬¬§¬¬¬ </wrap>**__<wrap>-1</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬</wrap>**//<wrap>n </wrap>//**<wrap>¬¬¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ COMPPARM= ¬¬¬§¬¬¬ </wrap>**__<wrap>-1</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬</wrap>**//<wrap>n </wrap>//**<wrap>¬¬¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ RA= ¬¬¬§¬</wrap>**<wrap>¬¬ 2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬ </wrap>**//<wrap>n </wrap>//**<wrap>¬¬¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ RAQ= ¬¬¬§¬¬</wrap>**<wrap>¬ 4 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬ </wrap>**//<wrap>n </wrap>//**<wrap>¬¬¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ RAT= ¬¬¬§¬</wrap>**<wrap>¬¬ 2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬ </wrap>**//<wrap>n </wrap>//**<wrap>¬¬¬</wrap>** **<wrap>l</wrap>****<wrap>¬¬¬ WR= ¬¬¬§¬</wrap>**<wrap>¬¬ 2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬ </wrap>**//<wrap>n </wrap>//**<wrap>¬¬¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ GCINT= ¬¬¬§¬¬¬ </wrap>****__<wrap>10</wrap>__**<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> **<wrap>⡿¬¬¬ %%__%%%%__%%%%__%%%%__%% </wrap>** //<wrap>%%__%%_ n </wrap>//<wrap>¬¬¬</wrap>**<wrap>¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ GCPARM= ¬¬¬§¬¬¬ 0 </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬ </wrap>**//<wrap>n </wrap>//**<wrap>¬¬¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ NOSTRESS= ¬¬¬§¬¬¬ 0 </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬ 1 ¬¬¬</wrap>** **<wrap>i- FREEPEND= ¬¬¬§¬</wrap>**<wrap>¬¬ </wrap>__<wrap>-1</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬</wrap>**//<wrap>n </wrap>//<wrap>¬¬¬</wrap>**<wrap>¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ FSYNC= ¬¬¬§¬¬¬ 0 </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> **<wrap>⡿¬¬¬ 1 ¬¬¬</wrap>** **<wrap>I</wrap>****<wrap>¬¬¬ TRACE= ¬¬¬§¬</wrap>**<wrap>¬¬ </wrap>**<wrap>0 </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> **<wrap>⡿¬¬</wrap>**<wrap>¬%%__%% </wrap>//<wrap>n </wrap>//**<wrap>¬¬¬</wrap>** **<wrap>i- LINUXNULL= ¬¬¬§¬¬¬ 0 </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬ 1 ¬¬¬</wrap>** |<WRAP>**<wrap>I¬¬¬ GCSTART=</wrap>** </WRAP> |<WRAP>**<wrap>¬¬¬§¬¬¬ 0 </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿¬¬¬ 1 ¬¬¬¯</wrap>** </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 53</wrap> <wrap>\\ </wrap>**//<wrap>5.10.3 Parameter</wrap>//** **<wrap>option </wrap>**<wrap>Set a CCKD option. Multiple options may be specified, separated by commas with no intervening blanks.</wrap> **<wrap>The CCKD options are:</wrap>** **<wrap>COMP=//n //</wrap>**<wrap>Specifies the compression type to be used. This overrides the compression used for all CCKD files. The default (-1) means don’t override the compression. Valid compression types are:</wrap> **<wrap>-1 </wrap>**<wrap>Default \\ **0 **None</wrap> **<wrap>1 </wrap>**<wrap>Zlib</wrap> **<wrap>2 </wrap>**<wrap>Bzip2</wrap> **<wrap>COMPPARM=//n //</wrap>**<wrap>Overrides the compression parameter. A higher value generally means more compression at the expense of CPU and/or storage. The default (-1) means don’t override the compression parameter. The value of //n //can be from -1 and 9.</wrap> **<wrap>RA=//n //</wrap>**<wrap>Sets the Number of read ahead threads. When sequential track or block group access is detected, some number (RAT=n) of tracks or block groups are queued (RAQ=n) to be read by one of the read ahead threads. The default is 2, the value of //n //can be a number from 1 to 9.</wrap> **<wrap>RAQ=//n //</wrap>**<wrap>Sets the size of the read ahead queue. When sequential track or block group access is detected, some number (RAT=n) of tracks or block groups are queued in the read ahead queue. The default is 4, the value of //n //can be a number from 0 to 16. A value of zero disables read ahead.</wrap> **<wrap>RAT=//n //</wrap>**<wrap>Sets the number of tracks or block groups to read ahead when sequential track or block group access is detected. The default is 2, the value of ratn can be a number from 0 to 16. A value of zero disables read ahead.</wrap> **<wrap>WR=//n //</wrap>**<wrap>Sets the number of writer threads. When the cache is flushed, updated cache entries are marked write pending and a writer thread is signalled. The writer thread compresses the track or block group and writes the compressed image to the emulation file.</wrap> <wrap>A writer thread is CPU-intensive while compressing the track or block group and I/O-intensive while writing the compressed image. The writer thread runs one nicer than the CPU thread(s). The default is 2, a value from 1 to 9 can be specified</wrap> **<wrap>GCINT=//n //</wrap>**<wrap>This is the number of seconds the garbage collector thread waits during an interval. At the end of an interval the garbage collector performs space recovery, flushes the cache and optionally ‘fsyncs’ the emulation file.</wrap> <wrap>However, the file will not be ‘fsynced’ unless at least 5 seconds have elapsed since the last synchronization (FSYNC). The default is 10 seconds. You can specify a number between 1 and 60.</wrap> **<wrap>GCPARM=//n //</wrap>**<wrap>A value affecting the amount of data moved during the garbage collectors space recovery routine. The garbage collector determines an amount of space to move based on the ratio of free space to used space in an emulation file and on the num-</wrap><wrap></wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 54</wrap> <wrap>\\ </wrap><wrap>ber of free spacesin the file. The garbage collector wants to reduce the free space to used space ratio and the number of free spaces.</wrap> <wrap>The value is logarithmic; a value of 8 means moving 28 the selected value while a negative value similarly decreases the amount to be moved. Normally, 256K will be moved for a file in an interval. Specifying a value of 8 can increase the amount to 64M. At least 64K will be moved. Specifying a large value (such as 8) may not increase the garbage collection efficiency correspondingly. The default is 0. You can specify a number from -8 to 8.</wrap> **<wrap>NOSTRESS=//n //</wrap>**<wrap>Indicates whether stress writes will occur or not. A track or block group may be written under stress when a high percentage of the cache is pending write or when a device I/O thread is waiting for a cache entry. When a stressed write occurs, the compression algorithm and/or compression parm may be relaxed, resulting in faster compression but usually a larger compressed image.</wrap> <wrap>If NOSTRESS is set to one, then a stressed situation is ignored. You would typically set this value to one when you want create the smallest emulation file possible in exchange for a possible performance degradation. The default is 0. You can specify 0 (enable stressed writes) or 1 (disable stressed writes).</wrap> **<wrap>FREEPEND=//n //</wrap>**<wrap>Specifies the free pending value for freed space. When a track or block group image is written, the space it previously occupied is freed. This space will not be available for future allocations until //n //garbage collection intervals have completed. In the event of a catastrophic failure, previously written track or block group images should be recoverable if the current image has not yet been written to the physical disk.</wrap> <wrap>By default the value is set to -1 which means that if FSYNC is specified then the value is 1 otherwise it is 2. If 0 is specified then freed space is immediately available for new allocations. The default is -1. You can specify a number from -1 to 4.</wrap> **<wrap>FSYNC=//n //</wrap>**<wrap>Enables or disables FSYNC. When FSYNC is enabled then the disk emulation file is synchronized with the physical hard disk at the end of a garbage collection interval (no more often than 5 seconds though).</wrap> <wrap>This means that if FREEPEND is non-zero and a catastrophic error occurs, the emulated disks should be recovered coherently. However, FSYNC may cause performance degradation depending on the host operating system and / or the host operating system level. The default is 0 (fsync disabled), you can specify 0 (disable FSYNC) or 1 (enable FSYNC).</wrap> **<wrap>TRACE=//n //</wrap>**<wrap>Specifies the number of CCKD trace entries. You would normally specify a nonzero value when debugging or capturing a problem in CCKD code. When the problem occurs, you should enter the "k" Hercules console command which will print the trace table entries. The default is 0. You can specify a number between 0 and 200000. Each trace entry represents 128 bytes. Normally, for debugging, it is recommended to use 100000.</wrap> **<wrap>LINUXNULL=//n //</wrap>**<wrap>If set to 1 then tracks written to 3390 CCKD volumes that were initialized with the //-linux //option will be checked if they are null (that is if all 12 4096 byte user records contain zeroes). This is used by the DASDCOPY utility. The default is 0.</wrap> **<wrap>GCSTART=//n //</wrap>**<wrap>If set to 1 then space recovery will become active on any emulated disks that have free space. Normally space recovery will ignore emulated disks until they have been updated. The default is 0.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 55</wrap> <wrap>\\ </wrap>**<wrap>Notes:</wrap>** <wrap>·<wrap></wrap></wrap>//<wrap>raq </wrap>//<wrap>should be at least as large as //ra//. Read ahead threads are scheduled from entries in the read ahead queue. Likewise //rat //should not exceed //raq //because only //raq //tracks or block groups can be queued at any time.</wrap> <wrap>·<wrap></wrap></wrap><wrap>The number of writer threads //wr //should usually be 1 more than the number of host processors. This is because one writer thread could be CPU-bound (compressing a track or block-group image) and the other could be i/o-bound (writing the compressed image).</wrap> <wrap>·<wrap></wrap></wrap><wrap>The garbage collection interval governs the maximum time in seconds an updated track or block group image will reside in storage before being written to the emulation file. A large value may mean more data loss if a catastrophic error occurs. A small value may mean that more CPU time is spent compressing images.</wrap> <wrap>For example, suppose that a particular image is updated several times each second. If the interval is changed from the default 5 seconds to 1 second, then that image will be compressed and written 5 times more frequently. A large value may cause more cache flushes within a garbage collection interval. These kinds of flushes mean that a read will wait because there are no available cache entries, slowing the emulated operating system. A large value will also cause more pending free space to build up (since free space is flushed each interval). This may mean that the garbage collector space recovery routine will perform more work and the resulting emulation file may be larger.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Specify //fsync=1 //and //gcint=5 //if you are seriously concerned about your data being lost due to a failure. //fsync //will ensure your data on disk is coherent. However, fsync may cause a noticeable performance degradation. Note that an fsync will not be performed more often than every 5 seconds.</wrap> **//<wrap>5.10.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the CCKD options to use bzip2 as compression method and using maximum compression.</wrap> <wrap>CCKD COMP=2,COMPPARM=9</wrap> **<wrap>Example 2:</wrap>** <wrap>Set the CCKD options to use the default compression method, as well as default compression. Disable stressed writes and set the number of trace entries to 100000.</wrap> <wrap>CCKD COMP=-1,COMPPARM=-1,NOSTRESS=1,TRACE=100000</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 56</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.11 CMDLEVEL (Set current command group) \\ //5.11.1 Function//</wrap>** <wrap>The CMDLEVEL system parameter sets the current command group(s). A plus sign preceding the command group activates the console commands of this group, whereas a preceding minus sign deactivates the commands.</wrap> <wrap>A table showing the affiliation of each console command to the various command groups can be found in ‘Appendix D. Hercules Command Groups’.</wrap> <wrap>Some console commands are always active to keep Hercules operable, independent of the current active command group. These commands are listed under command group 'NONE' in the above mentioned table. Command group ‘NONE’ is the result of a ‘CMDLVL –ALL’ command.</wrap> <wrap>The default command level is set to operator, maintenance, programmer and configuration (which corresponds to the command "CMDLEVEL -ALL +OPER +MAINT +PROG +CONFIG"). Some of the arguments can be abbreviated as shown in the syntax section below.</wrap> **//<wrap>5.11.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>CMDLEVEL {{-'- | </wrap><wrap>-</wrap><wrap>} {ALL | 0PERator | MAINT | PR0G</wrap><wrap>rammer </wrap><wrap>| C0NFIGuration | DEVEL</wrap><wrap>oper </wrap><wrap>| DEBUG} [...]}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_®</wrap> <wrap>%%__%%%%__%%_ CMDLEVEL %%__%%_°%%__%%_§%%__%%_ </wrap><wrap>+ </wrap><wrap>%%__%%_§%%__%%_§%%__%%_ ALL %%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_§%%__%%_¨%%__%%%%__%%_</wrap><wrap>%%__%%%%__%%%%__%%%%__%%_ÊÍ</wrap> <wrap>⡿%%__%%_ </wrap><wrap>- </wrap><wrap>%%__%%_¯ ª%%__%%_ 0PERator _</wrap><wrap>%%__%%%%__%%%%__%%_« </wrap><wrap>ª%%__%%_ MAINT </wrap><wrap>%%__%%%%__%%%%__%%%%__%%%%__%%_« </wrap><wrap>ª%%__%%_PR0Grammer_</wrap><wrap>%%__%%%%__%%_« </wrap><wrap>ª%%__%%_C0NFIGuration</wrap><wrap>%%__%%_« </wrap><wrap>ª%%__%%_DEVELoper</wrap><wrap>%%__%%%%__%%%%__%%_« </wrap><wrap>⡿%%__%%_DEBUG </wrap><wrap>%%__%%%%__%%%%__%%%%__%%_</wrap><wrap>%%__%%¯</wrap> **//<wrap>5.11.3 Parameter</wrap>//** **<wrap>+ </wrap>**<wrap>The plus sign activates the commands of the following command group.</wrap> **<wrap>- </wrap>**<wrap>The minus sign deactivates the commands of the following command group.</wrap> **<wrap>ALL </wrap>**<wrap>Command group ‘ALL’ contains all Hercules console commands. Specifying command group ‘+ALL’ enables all console commands whereas command group ‘-ALL’ equals to NONE. This disables all console commands with the exception of commands necessary to keep Hercules operable.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 57</wrap> <wrap>\\ </wrap>**<wrap>OPER </wrap>**<wrap>The ‘OPERator’ command group activates or deactivates all system operator commands.</wrap> **<wrap>MAINT </wrap>**<wrap>Command group ’MAINT’ activates or deactivates all system maintainer commands.</wrap> **<wrap>PROG </wrap>**<wrap>The ‘PROGrammer’ command group activates or deactivates all systems programmer commands.</wrap> **<wrap>CONFIG </wrap>**<wrap>Command group ‘CONFIGuration’ activates or deactivates all system configuration commands.</wrap> **<wrap>DEVEL </wrap>**<wrap>The ‘DEVELoper’ command group activates or deactivates all system developer commands.</wrap> **<wrap>DEBUG </wrap>**<wrap>Command group ‘DEBUG’ activates or deactivates all debugging activity commands activities.</wrap> **//<wrap>5.11.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the command group to OPERATOR and PROGRAMMER.</wrap> <wrap>CMDLEVEL –ALL +OPERATOR +PROGRAMMER</wrap> **<wrap>Example 2:</wrap>** <wrap>Allow all commands but exclude the DEBUG command group.</wrap> <wrap>CMDLEVEL +ALL -DEBUG</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 58</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.12 CMDLVL (Set current command group) \\ //5.12.1 Function//</wrap>** <wrap>CMDLVL is an alias for CMDLEVEL. The CMDLVL system parameter sets the command group(s). See CMDLEVEL system parameter for details.</wrap> **//<wrap>5.12.2 Syntax</wrap>//** <wrap>See CMDLEVEL system parameter.</wrap> **//<wrap>5.12.3 Parameter</wrap>//** <wrap>See CMDLEVEL system parameter.</wrap> **//<wrap>5.12.4 Examples</wrap>//** <wrap>See CMDLEVEL system parameter.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 59</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.13 CMDSEP (Command line separator) \\ //5.13.1 Function//</wrap>** <wrap>The CMDSEP system parameter sets the command line separator. The command line separator character is used to separate multiple panel commands on a single line. The default is OFF which means that there is no command line separator defined and therefore multiple panel commands on a single line are not supported.</wrap> **//<wrap>5.13.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CMDSEP (</wrap>//<wrap>char </wrap>//<wrap>| </wrap>__<wrap>OFF</wrap>__<wrap>}</wrap>__<wrap></wrap>__ **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>CMDSEP </wrap><wrap>¬¬¬§¬¬¬ </wrap>//<wrap>char </wrap>// <wrap>i¬¬¬ </wrap><wrap>OFF </wrap><wrap>-</wrap> **//<wrap>5.13.3 Parameter</wrap>//** **//<wrap>char </wrap>//**<wrap>Specifies a single character that is used for command separation. This character must not be the period ('.'), the exclamation mark ('!') or the hyphen ('-'). Although the command line separation character can be set to the number (hash) sign ('#'), this is not recommended because this could affect processing command lines that contain comments.</wrap> **<wrap>OFF </wrap>**<wrap>OFF disables command separation. This is the default.</wrap> **//<wrap>5.13.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the command line separator to ‘;’.</wrap> <wrap>CMDSEP ;</wrap> **<wrap>Example 2:</wrap>** <wrap>Disable command line separation.</wrap> <wrap>CMDSEP OFF</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 60</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.14 CNSLPORT (Console port) \\ //5.14.1 Function//</wrap>** <wrap>The CNSLPORT parameter specifies the port number (in decimal), on which the telnet server will listen. The statement may also have the form host:port, where the telnet console server will bind to the specified address.</wrap> **//<wrap>5.14.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CNSLP0RT (</wrap>__<wrap>3270</wrap>__<wrap> | </wrap>//<wrap>port </wrap>//<wrap>| </wrap>//<wrap>host:port</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬CNSLP0RT ¬¬¬i¬¬¬¬¬¬ </wrap>__<wrap>3270</wrap>__//<wrap> ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>// <wrap>ª¬</wrap>//<wrap>¬¬¬¬¬ port ¬¬¬¬¬«</wrap>// <wrap>⡿¬¬¬</wrap>//<wrap>host:port </wrap>//<wrap>¬¬¬</wrap> **//<wrap>5.14.3 Parameter</wrap>//** **//<wrap>host </wrap>//**<wrap>The IP address of the host to which the telnet server will bind to. If an IP address is given then it must be a valid IP address for the host system.</wrap> **//<wrap>port </wrap>//**<wrap>The port number (decimal) on which the telnet server will listen. The port number must not be in use by any other server. The port number must be in the range of 0 to 65535. Ports below 1024 cannot be used unless Hercules is running as root or is otherwise authorized to use low ports.</wrap> **//<wrap>5.14.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the port number on which the telnet server will listen to 3270.</wrap> <wrap>CNSLPORT 3270</wrap> **<wrap>Example 2:</wrap>** <wrap>Specify 192.168.1.10 as the IP address of the host to which the telnet server will bind to and set the port number on which the telnet server will listen to 3270.</wrap> <wrap>CNSLPORT 192.168.1.10:3270</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 61</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.15 CODEPAGE (Codepage conversion table) \\ //5.15.1 Function//</wrap>** <wrap>This parameter specifies the codepage conversion table used for the ASCII / EBCDIC translation. If no codepage is given the environment variable HERCULES_CP will be inspected. The default codepage used is “DEFAULT”.</wrap> **//<wrap>5.15.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>C0DEPAGE (</wrap>__<wrap>DEFAULT</wrap>__<wrap> | </wrap>//<wrap>codepage </wrap>//<wrap>| USER | MAINT </wrap>//<wrap>cmd </wrap>//<wrap>[</wrap>//<wrap>operands</wrap>//<wrap>]</wrap><wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_C0DEPAGE %%__%%_§%%__%%_ </wrap>__<wrap>DEFAULT</wrap>__<wrap> ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>F_</wrap><wrap>¬¬ </wrap>//<wrap>codepage </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>__<wrap>F</wrap>__<wrap>%%__%%_ USER%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%« i%%__%%_ MAINT %%__%%_ </wrap>//<wrap>cmd </wrap>//<wrap>¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>L%%__%%_ </wrap>//<wrap>operands </wrap>//<wrap>%%__%%_¯</wrap> **//<wrap>5.15.3 Parameter</wrap>//** **<wrap>DEFAULT </wrap>**<wrap>“DEFAULT” specifies the traditional Hercules codepage.</wrap> **//<wrap>codepage </wrap>//**<wrap>Specifies the codepage conversion table used for ASCII / EBCDIC translation. Supported codepage mappings are shown in the table below. Iconv single byte codepages may also be used (e.g. “UTF8/EBCDIC-CP-NL”).</wrap> **<wrap>USER </wrap>**<wrap>This specifies that the user specific codepage conversion tables (see CPUPDT system parameter and console command) have to be activated.</wrap> **<wrap>MAINT </wrap>**<wrap>MAINT and its arguments is the same as the CP_UPDT system parameter. Please see CP_UPDT for details.</wrap> <wrap>Supported codepage mappings:</wrap> |<WRAP>**<wrap>Mapping</wrap>** </WRAP> |<WRAP>**<wrap>ASCII</wrap>** </WRAP> |<WRAP>**<wrap>EBCDIC</wrap>** </WRAP> | |<WRAP><wrap>437/037</wrap> </WRAP> |<WRAP><wrap>437 PC United States</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada</wrap> </WRAP> | |<WRAP><wrap>437/500</wrap> </WRAP> |<WRAP><wrap>437 PC United States</wrap> </WRAP> |<WRAP><wrap>500 Latin 1</wrap> </WRAP> | |<WRAP><wrap>437/1047</wrap> </WRAP> |<WRAP><wrap>437 PC United States</wrap> </WRAP> |<WRAP><wrap>1047 Open Systems Latin 1</wrap> </WRAP> | |<WRAP><wrap>819/037</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 62</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Mapping</wrap>** </WRAP> |<WRAP>**<wrap>ASCII</wrap>** </WRAP> |<WRAP>**<wrap>EBCDIC</wrap>** </WRAP> | |<WRAP><wrap>819/037v2</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada SHARE</wrap> </WRAP> | |<WRAP><wrap>819/273</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>273 CECP Austria/Germany</wrap> </WRAP> | |<WRAP><wrap>819/277</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>277 CECP Denmark/Norway</wrap> </WRAP> | |<WRAP><wrap>819/278</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>278 CECP Finland/Sweden</wrap> </WRAP> | |<WRAP><wrap>819/280</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>280 CECP Italy</wrap> </WRAP> | |<WRAP><wrap>819/284</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>284 CECP Spain</wrap> </WRAP> | |<WRAP><wrap>819/285</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>285 CECP United Kingdom</wrap> </WRAP> | |<WRAP><wrap>819/297</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>297 CECP France</wrap> </WRAP> | |<WRAP><wrap>819/500</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>500 CECP International</wrap> </WRAP> | |<WRAP><wrap>819/1047</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>1047 Open Systems Latin 1</wrap> </WRAP> | |<WRAP><wrap>850/273</wrap> </WRAP> |<WRAP><wrap>850 PC Latin 1</wrap> </WRAP> |<WRAP><wrap>273 Austria/Germany</wrap> </WRAP> | |<WRAP><wrap>850/1047</wrap> </WRAP> |<WRAP><wrap>850 PC Latin 1</wrap> </WRAP> |<WRAP><wrap>1047 Open Systems Latin 1</wrap> </WRAP> | |<WRAP><wrap>1252/037</wrap> </WRAP> |<WRAP><wrap>1252 Windows Latin 1</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada</wrap> </WRAP> | |<WRAP><wrap>1252/037v2</wrap> </WRAP> |<WRAP><wrap>1252 Windows Latin 1</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada SHARE</wrap> </WRAP> | |<WRAP><wrap>1252/1047</wrap> </WRAP> |<WRAP><wrap>1252 Windows Latin 1</wrap> </WRAP> |<WRAP><wrap>1047 Open Systems Latin 1</wrap> </WRAP> | |<WRAP><wrap>1252/1140</wrap> </WRAP> |<WRAP><wrap>1252 Windows Latin 1</wrap> </WRAP> |<WRAP><wrap>1140 United States/Canada with Euro sign</wrap> </WRAP> | **<wrap>Table 4: Supported codepage mappings</wrap>** **//<wrap>5.15.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the codepage conversion table to the default.</wrap> <wrap>CODEPAGE DEFAULT</wrap> **<wrap>Example 2:</wrap>** <wrap>Set the codepage conversion table to 437/500.</wrap> <wrap>CODEPAGE 437/500</wrap> **<wrap>Example 3:</wrap>** <wrap>Activate the user specific codepage conversion tables.</wrap> <wrap>CODEPAGE USER</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 63</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.16 CONKPALV (Console and telnet clients keep-alive option) //5.16.1 Function//</wrap>** <wrap>The CONKPALV parameter specifies the tn3270 console and telnet clients keepalive option values that control automatic detection of disconnected tn3270/telnet client sessions.</wrap> <wrap>This is a built-in feature of TCP/IP and allows detection of unresponsive TCP/IP connections and not idle clients. That is to say, your connection will not be terminated after 3 seconds of idle time. Your 3270 session can remain idle for many minutes or hours or days without any data being transmitted. If the TCP/IP stack at the other end of the connection (not your 3270 client itself) fails to respond to the internal keepalive probe packets however, then it means that the TCP/IP stack itself is down or there has been a physical break in the connection.</wrap> <wrap>Thus, even if your 3270 client is completely idle, your system's TCP/IP stack itself should still respond to the keepalive probes sent by the TCP/IP stack at the Hercules end of the link. If it doesn't, then TCP/IP will terminate the tn3270/telnet session which will cause Hercules to disconnect the terminal.</wrap> <wrap>The three values can also be modified on-demand via the conkpalv panel command, which has the exact same syntax. Note that the syntax is very unforgiving: no spaces are allowed anywhere within the parentheses and each value must be separated from the other with a single comma.</wrap> <wrap>Please also note that not all systems support being able to modify all three values. That is, not all values may be able to be changed, and it is system dependent which values you can change and which values you cannot. On Windows for example, the //count //value is ignored and cannot be changed from its default value of 10. Other systems may ignore one or more or all three values and use platform defaults instead. This is entirely system dependent. Check you system's documentation for details regarding which values can be changed and which cannot as well as how to adjust your system's default values.</wrap> **//<wrap>5.16.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>C0NKPALV (</wrap>__<wrap>(3,1,10)</wrap>__<wrap> | </wrap><wrap>(</wrap>//<wrap>idle,intv,count</wrap>//<wrap>)</wrap><wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬C0NKPALV</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬ </wrap>__<wrap>(</wrap>____<wrap>3,1,10</wrap>____<wrap>)</wrap>__<wrap> ¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>i¬¬¬ </wrap><wrap>(</wrap>//<wrap>idle,intv,count</wrap>//<wrap>) </wrap><wrap>¬¬¬i</wrap> </WRAP> | **//<wrap>5.16.3 Parameter</wrap>//** **//<wrap>idle </wrap>//**<wrap>The //idle //value specifies the number of seconds of inactivity until the first keep-alive probe is sent. The default for the //idle //value is 3 seconds.</wrap> **//<wrap>intv </wrap>//**<wrap>The //intv //value specifies the interval in seconds between the probes if no acknow-</wrap><wrap></wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 64</wrap> <wrap>\\ </wrap><wrap>ledgement is received from the previous probe. The default for //intv //is 1 second.</wrap> <wrap>\\ </wrap>**//<wrap>count </wrap>//**<wrap>The //count //value specifies the number of unacknowledged keep-alive packets sent</wrap> <wrap>before the connection is considered to have failed. The default value is 9 for non-Windows platforms and 10 for Windows systems.</wrap> //<wrap>Note: </wrap>//<wrap>On Windows platforms the count value is ignored and cannot be changed from its default value of 10.</wrap> **//<wrap>5.16.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the tn3270 console and telnet clients keep-alive option settings on a Unix platform to the following values: 5 seconds of inactivity until the first keep-alive probe is sent, 3 seconds for the interval between the probes and to 15 unacknowledged keep-alive packets sent before the connection is considered to have failed.</wrap> <wrap>CONKPALV (5,3,15)</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 65</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.17 CP_UPDT (User character conversion table) \\ //5.17.1 Function//</wrap>** <wrap>The CP_UPDT system parameter creates or modifies the contents of the user codepage tables. The tables can be populated with a ‘CP_UPDT REFERENCE’ statement which copies one of the provided codepage tables to the user tables or by a ‘CP_UPDT IMPORT’ statement which imports a previously created and with ‘CP_UPDT EXPORT’ exported table.</wrap> <wrap>Changes in the user tables are made through one or more ‘CP_UPDT ALTER’ statements. These allow for up to 16 modifications at a time. The current contents of the user tables can be displayed on the console (and written to the log file) with ‘CP_UPDT DISPLAY’. Finally the changed user tables are activated with a ‘CODEPAGE USER’ statement.</wrap> <wrap>In all CP_UPDT statements that require the selection of a user table (EBCDIC or ASCII), the EBCDIC table refers to the ‘guest to host’ (g2h) translation and the ASCII table refers to the ‘host to guest’ (h2g) translation.</wrap> **//<wrap>5.17.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>CP </wrap><wrap>UPDT </wrap>//<wrap>command</wrap>// <wrap>where </wrap>//<wrap>command </wrap>//<wrap>can be:</wrap> <wrap>ALTER {EBCDIC | ASCII | G2H | H2G} (</wrap>//<wrap>pos</wrap>//<wrap>,</wrap>//<wrap>val</wrap>//<wrap>[,</wrap>//<wrap>pos</wrap>//<wrap>,</wrap>//<wrap>val</wrap>//<wrap>]...)</wrap> <wrap>DISPLAY {EBCDIC | ASCII | G2H | H2G}</wrap> <wrap>EXPORT {EBCDIC | ASCII | G2H | H2G} </wrap>//<wrap>filename</wrap>// <wrap>IMPORT {EBCDIC | ASCII | G2H | H2G} </wrap>//<wrap>filename</wrap>// <wrap>REFERENCE [</wrap>//<wrap>codepage</wrap>//<wrap>]</wrap> <wrap>RESET</wrap> <wrap>TEST</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CP </wrap><wrap>UPDT ¬¬¬« </wrap>//<wrap>command</wrap>// <wrap>where </wrap>//<wrap>command </wrap>//<wrap>can be:</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 66</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>~------ , ------®</wrap> <wrap>F--- ALTER </wrap><wrap>---§--- </wrap><wrap>EBCDIC </wrap><wrap>---§--- ( ---</wrap><wrap>°</wrap><wrap>--- </wrap>//<wrap>po.5</wrap>//<wrap>,</wrap>//<wrap>i1,l </wrap>//<wrap>---</wrap><wrap>¨</wrap><wrap>--- ) ---------------I</wrap> <wrap>ª---ASCII----«</wrap> <wrap>ª---G2H------«</wrap> <wrap>⡿---</wrap><wrap></wrap> <wrap>%%__%%%%__%% H2G ------</wrap><wrap></wrap> <wrap>F--- DISPLAY </wrap><wrap>---§--- </wrap><wrap>EBCDIC </wrap><wrap>---§---------------------------------------------I</wrap> <wrap>ª---ASCII----«</wrap> <wrap>ª---G2H------«</wrap> <wrap>⡿---</wrap><wrap></wrap> <wrap>%%__%%%%__%%_ H2G ------¯</wrap> <wrap>F--- EXPORT </wrap><wrap>---§--- </wrap><wrap>EBCDIC </wrap><wrap>---§--- </wrap>//<wrap>filename </wrap>//<wrap>---------------------------------I</wrap> <wrap>ª---ASCII----«</wrap> <wrap>ª---G2H------«</wrap> <wrap>⡿---</wrap><wrap></wrap> <wrap>%%__%%_ H2G ------</wrap><wrap></wrap> <wrap>F--- IMPORT </wrap><wrap>---§--- </wrap><wrap>EBCDIC </wrap><wrap>---§--- </wrap>//<wrap>filename </wrap>//<wrap>---------------------------------I</wrap> <wrap>ª---ASCII----«</wrap> <wrap>ª---G2H------«</wrap> <wrap>⡿---</wrap><wrap></wrap> <wrap>%%__%%_ H2G ------</wrap><wrap></wrap> <wrap>I- REFERENCE </wrap><wrap>---§----------------§-----------------------------------------I</wrap> <wrap>⡿---</wrap>//<wrap>codepage </wrap>//<wrap>---</wrap><wrap></wrap> <wrap>I</wrap><wrap>--- RESET </wrap><wrap>------------------------------------------------------------------__I__</wrap> <wrap>I- TEST </wrap><wrap>-------------------------------------------------------------------__I__</wrap> **//<wrap>5.17.3 Parameter</wrap>//** **<wrap>ALTER </wrap>**<wrap>Alters the user EBCDIC or ASCII table value at hex position //pos //to hex value //val//. Up to 16 pairs of hex digits may be specified within the parenthesis. ALTER can be abbreviated as ‘ALT’.</wrap> **<wrap>DISPLAY </wrap>**<wrap>Displays the user EBCDIC or ASCII codepage table. DISPLAY can be abbreviated as ‘DIS’ or ‘DSP’.</wrap> **<wrap>EXPORT </wrap>**<wrap>Exports the contents of the user EBCDIC or ASCII codepage table to file //filename//. EXPORT can be abbreviated as ‘EXP’.</wrap> **<wrap>IMPORT </wrap>**<wrap>Imports the contents of file //filename //to the user EBCDIC or ASCII codepage table. IMPORT can be abbreviated as ‘IMP’.</wrap> **<wrap>REFERENCE </wrap>**<wrap>Copies the specified codepage to the user EBCDIC and ASCII tables. If no code-page is specified, a list of valid codepages is displayed on the console. ‘REFERENCE’ can be abbreviated as ‘REF’.</wrap> **<wrap>EBCDIC </wrap>**<wrap>The target for the command is the EBCDIC table. The EBCDIC table refers to the</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 67</wrap> <wrap>\\ </wrap><wrap>‘guest to host’ translation. ‘EBCDIC’ can be abbreviated as ‘E’.</wrap> **<wrap>RESET </wrap>**<wrap>Reset the internal user tables to binary zero.</wrap> **<wrap>TEST </wrap>**<wrap>Verify that user tables are transparent, i.e. the value at position n in g2h used as an index into h2g will return a value equal n (g2h<=>h2g, h2g<=>g2h).</wrap> **<wrap>ASCII </wrap>**<wrap>The target for the command is the ASCII table. The ASCII table refers to the ‘host to guest’ translation. ‘ASCII’ can be abbreviated as ‘A’.</wrap> **<wrap>G2H </wrap>**<wrap>This is the same as ‘EBCDIC’.</wrap> **<wrap>H2G </wrap>**<wrap>This is the same as ‘ASCII’.</wrap> **//<wrap>pos </wrap>//**<wrap>Specifies the hex position within the selected table.</wrap> **//<wrap>val </wrap>//**<wrap>Specifies the hex value for the selected position.</wrap> **//<wrap>filename </wrap>//**<wrap>Specifies the file name of the file to which the specified codepage has to be exported or from which the codepage table has to be imported.</wrap> **//<wrap>codepage </wrap>//**<wrap>Specifies the codepage that has to be copied to the user tables.</wrap> **//<wrap>5.17.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Copy the Hercules default codepage to the user tables, alter the ASCII user table and activate the user tables.</wrap> <wrap>CP_UPDT REFERENCE DEFAULT</wrap> <wrap>CP_UPDT ALTER ASCII (5B,C0,5D,D0,7B,AD,7D,BD)</wrap> <wrap>CODEPAGE USER</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 68</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.18 CPUIDFMT (Set format BASIC / 0 / 1 STIDP generation) //5.18.1 Function//</wrap>** <wrap>The CPUIDFMT system parameter sets the STORE CPU ID (STIDP) format bit. The default STIDP format, if not explicitly set, is 'BASIC'. The format bit of the STIDP information specifies the format of the first two digits of the CPU identification number. When the format bit is ‘0’ then the contents of the CPU identification number identifies the CPU. When the format bit is ‘1’ then the CPU identification number identifies the system configuration as opposed to an individual CPU in the configuration and it identifies the logical partition in which the program is executed.</wrap> <wrap>When the format is ‘BASIC’ the CPU identification number has the following hexadecimal format, where 'A' is the CPU address of the CPU.</wrap> <wrap>·<wrap></wrap></wrap><wrap>x'Annnnn' (Basic Mode)</wrap> <wrap>When the format is ‘0’ the CPU identification number has the following hexadecimal format where 'L' is a logical CPU address and 'P' is a logical partition identifier.</wrap> <wrap>·<wrap></wrap></wrap><wrap>x'LPnnnn' (LPAR mode)</wrap> <wrap>When the format is ‘1’ the CPU identification number has the following hexadecimal format where 'PP' is the user partition identifier (UPID). The UPID is an eight bit unsigned binary integer bound to a logical partition.</wrap> <wrap>·<wrap></wrap></wrap><wrap>x'PPnnnn' (LPAR mode)</wrap> <wrap>In all cases //n //is a digit derived from the serial number of the CPU.</wrap> <wrap>For more information on the STORE CPU ID (STIDP) instruction and the format bit see IBMs "z/Architec-ture Principles of Operation" manual.</wrap> **//<wrap>5.18.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CPUIDFMT (__BASIC__ | 0 | 1}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>CPUIDFMT </wrap><wrap>¬¬¬§¬¬¬ </wrap>__<wrap>BASIC</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬¬¬0 </wrap><wrap>¬¬¬¬¬«</wrap> <wrap>⡿¬</wrap><wrap>¬¬¬¬ 1 ¬¬¬</wrap><wrap>¬¬</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 69</wrap> <wrap>\\ </wrap>**//<wrap>5.18.3 Parameter</wrap>//** **<wrap>BASIC </wrap>**<wrap>Set the format to 'BASIC'. The STIDP format bit is set to ‘0’.</wrap> **<wrap>0 </wrap>**<wrap>Set the format to '0'. The STIDP format bit is set to ‘0’.</wrap> **<wrap>1 </wrap>**<wrap>Set the format to '1'. The STIDP format bit is set to ‘1’.</wrap> **//<wrap>5.18.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the STORE CPU ID format to ‘1’.</wrap> <wrap>CPUIDFMT 1</wrap> **<wrap>Example 2:</wrap>** <wrap>Set the STORE CPU ID format to ‘BASIC’.</wrap> <wrap>CPUIDFMT BASIC</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 70</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.19 CPUMODEL (CPU model number) \\ //5.19.1 Function//</wrap>** <wrap>The CPUMODEL parameter specifies the 4 hexadecimal digits CPU model number stored by the STIDP instruction.</wrap> **//<wrap>5.19.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CPUM0DEL (</wrap>__<wrap>0586</wrap>__<wrap> | </wrap>//<wrap>model</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬CPUM0DEL ¬¬¬</wrap><wrap>§¬¬¬ </wrap>__<wrap>0586</wrap>__<wrap> _ </wrap> <wrap>⡿¬¬_ </wrap>//<wrap>model</wrap>// </WRAP> | **//<wrap>5.19.3 Parameter</wrap>//** **//<wrap>model </wrap>//**<wrap>Any valid 4 digit hexadecimal CPU model number. A list of the valid model numbers can be found in the Hercules Windows GUI file “cpu-types.txt”. The default (“0586”) is not a mainframe CPU model number, but is related to the underlying PC architecture.</wrap> **//<wrap>5.19.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify a 7490 CPU model.</wrap> <wrap>CPUMODEL 7490</wrap> **<wrap>Example 2:</wrap>** <wrap>Specify a 3090 CPU model.</wrap> <wrap>CPUMODEL 3090</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 71</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.20 CPUPRIO (CPU thread process priority) \\ //5.20.1 Function//</wrap>** <wrap>CPUPRIO specifies the priority of the CPU thread. See section 5.82 “Process and Thread Priorities” for details. Default is a nice value of 15, which means a low priority such that I/O can be scheduled and completed in favour of CPU cycles. On multi-CPU systems a real CPU can be “dedicated” to Hercules by giving the CPU-thread a very high dispatching priority (-20).</wrap> **<wrap>Caution: </wrap>**<wrap>CPUPRIO should not have a higher dispatching priority than the TOD clock and timer thread.</wrap> **//<wrap>5.20.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CPUPRI0 (</wrap>__<wrap>15</wrap>__<wrap> | </wrap>//<wrap>nn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬CPUPRI0 ¬¬¬§¬¬¬ </wrap>__<wrap>15 </wrap>__<wrap></wrap> <wrap>⡿¬¬¬</wrap>//<wrap>nn</wrap>// **//<wrap>5.20.3 Parameter</wrap>//** **<wrap>15 </wrap>**<wrap>Specifies a CPU thread prority of 15. This is the default</wrap> **//<wrap>nn </wrap>//**<wrap>This value specifies the priority for the CPU thread. For details on the priority values see section 5.82 (“Process and Thread Priorities”). The default is 15.</wrap> **//<wrap>5.20.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Give the CPU-thread a very high dispatching priority of -20.</wrap> <wrap>CPUPRIO -20</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 72</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.21 CPUSERIAL (CPU serial number) \\ //5.21.1 Function//</wrap>** <wrap>CPUSERIAL specifies the 6 hexadecimal digit CPU serial number stored by the STIDP instruction.</wrap> **//<wrap>5.21.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CPUSERIAL (__000001__ | </wrap>//<wrap>serial</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CPU</wrap><wrap>SERIAL </wrap><wrap>¬¬¬§¬¬¬ </wrap>__<wrap>000001</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>'¬¬¬ </wrap>//<wrap>serial </wrap>//<wrap>¬¬¬</wrap> </WRAP> | **//<wrap>5.21.3 Parameter</wrap>//** **//<wrap>serial </wrap>//**<wrap>Any valid 6 digit hexadecimal CPU serial number. In BASIC mode, the high-order digit may be replaced with the processor number when MAXCPU is greater than one. In LPAR mode, the two high-order digits are replaced with either the LPAR number or the CPU number and LPAR number with the full serial number available via the STSI instruction. The default serial number is ‘000001’.</wrap> **//<wrap>5.21.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the CPU serial number to 001963.</wrap> <wrap>CPUSERIAL 001963</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 73</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.22 CPUVERID (CPU version code) \\ //5.22.1 Function//</wrap>** <wrap>CPUVERID specifies the 2 hexadecimal digit CPU version code stored by the STIDP instruction. The default version code is “FD” when ARCHMODE S/370 or ARCHMODE ESA/390 is specified. For the z/ARCH (or ESAME architecture mode respectively) the version code is always stored as “00” and any value specified here is ignored.</wrap> **//<wrap>5.22.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>CPUVERID </wrap>__<wrap>00</wrap>__<wrap> (For z/ARCH and ESAME)</wrap> <wrap>CPUVERID (</wrap>__<wrap>FD</wrap>__<wrap> | </wrap>//<wrap>verid</wrap>//<wrap>} </wrap><wrap>(For S/370 and ESA/390)</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>For z/ARCH and ESAME:</wrap> <wrap>ÊÊ¬¬¬ CPUVERID ¬¬¬ </wrap>__<wrap>00</wrap>__<wrap></wrap> <wrap>For S/370 and ESA/390:</wrap> <wrap>ÊÊ¬¬¬ CPUVERID ¬¬¬§¬¬¬¬¬ </wrap>__<wrap>FD</wrap>__<wrap> ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿¬¬¬ </wrap>//<wrap>verid </wrap>//<wrap>¬¬¬</wrap> **//<wrap>5.22.3 Parameter</wrap>//** **//<wrap>verid </wrap>//**<wrap>Any valid 2 digit hexadecimal CPU version code. A list of valid version codes can be found in the Hercules Windows GUI file “cpu-types.txt”.</wrap> **//<wrap>5.22.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the CPU version code to FD.</wrap> <wrap>CPUVERID FD</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 74</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.23 DEFSTORE (Define main and expanded storage) \\ //5.23.1 Function//</wrap>** <wrap>The DEFSTORE statement is used to specify the size of the main and expanded storage. Storage is allocated in megabytes, unless a specific unit is specified. The actual upper limit of the main and expanded storage is determined by the host system's architecture, operating system, and on some systems the amount of physical memory and paging space you have available.</wrap> <wrap>The practical limit depends on the maximum amount of storage that can be obtained by the “malloc” function (usually around 1 GB on 32-bit platforms; on 64-bit platforms the value should only be limited by available paging space).</wrap> <wrap>An additional optional argument determines the locking state of the allocated memory (page lock by host operating system). The LOCKED option indicates that the memory is to be locked into storage while UNLOCKED (the default) indicates that the memory is not locked into the storage.</wrap> <wrap>Please note that Hercules preserves the last locking state of DEFSTORE for each type of storage. Once the storage is locked, any subsequent change to the storage size will honor the existing lock state of memory unless the lock state is specified again on the DEFSTORE command.</wrap> **<wrap>Caution: </wrap>**<wrap>Do not lock storage unless sufficient real memory is available to back up the request. Failure to do so may require the host system to be rebooted.</wrap> **//<wrap>5.23.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>DEFSTORE {[MAIN </wrap>**//<wrap>msize</wrap>//<wrap>[</wrap>**<wrap>B | K | M | G | T | P|E</wrap>**<wrap>] [</wrap>**__<wrap>UNLOCK</wrap>__****<wrap> | LOCK]] \\ [{XSTOR | EXPANDED} </wrap>**//<wrap>size</wrap>//<wrap>[</wrap>**<wrap>M | G | T</wrap>**<wrap>] [</wrap>**__<wrap>UNLOCK</wrap>__****<wrap> | LOCK]]}</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® </wrap>**<wrap>► ¬¬¬ DEFSTORE ¬¬¬°¬¬¬« </wrap>**//<wrap>storagetype </wrap>//**<wrap>ª¬¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>** |<WRAP>**<wrap>l¬¬¬ MAIN ¬¬¬ </wrap>**//<wrap>msize</wrap>// </WRAP> |<WRAP><wrap>~¬¬¬ </wrap>**<wrap>M </wrap>**<wrap>¬¬¬® </wrap>**<wrap>~¬ ¬¬ UNLOCK ¬¬¬®</wrap>** <wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê </wrap>**<wrap>ª</wrap>**<wrap>¬¬¬ </wrap>**<wrap>B </wrap>**<wrap>¬¬¬« </wrap>**<wrap>⡿¬¬¬¬ LOCK ¬¬¬¬¯</wrap>** **<wrap>ª¬¬¬K ¬¬¬« \\ ª¬¬¬G ¬¬¬« \\ ª¬¬¬T ¬¬¬« \\ ª¬¬¬P ¬¬¬« \\ ⡿¬¬¬E ¬¬¬¯</wrap>** </WRAP> | **<wrap>~¬¬¬UNLOCK ¬¬¬®</wrap>** <wrap>Ê</wrap>**<wrap>¬¬¬§¬¬¬ XSTOR ¬¬¬¬¬¬§¬¬¬</wrap>**//<wrap>xsize </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬§¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> **<wrap>⡿¬¬¬EXPANDED ¬¬¬¯ ª</wrap>**<wrap>¬¬¬ </wrap>**<wrap>M </wrap>**<wrap>¬¬¬« </wrap>**<wrap>⡿¬¬¬ LOCK ¬¬¬¬¬¯</wrap>** **<wrap>ª</wrap>**<wrap>¬¬¬ </wrap>**<wrap>G </wrap>**<wrap>¬¬¬«</wrap> **<wrap>⡿</wrap>**<wrap>¬¬¬ T ¬¬¬</wrap>**<wrap>¯</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 75</wrap> <wrap>\\ </wrap>**//<wrap>5.23.3 Parameter</wrap>//** **//<wrap>msize </wrap>//**<wrap>The value of //msize //must be a valid decimal number. The actual upper limit is determined by the host system's architecture, the operating system and on some systems the amount of physical memory and paging space that is available.</wrap> <wrap>For storage sizes less than 16M, sizes not on a 4K boundary are rounded up to the next 4K boundary. Otherwise, storage sizes not on a 1M boundary are rounded up to the next 1M boundary.</wrap> <wrap>The minimum size is 4K for architecture levels ALS0 and ALS1 (S/370 and ESA/390), and 8K for architecture level ALS2 (ESAME) and higher. A maximum of 64M may be specified for architecture level ALS0 (S/370), 2048M (2G) for ALS1 (ESA/390) and 16E for architecture level ALS2 (ESAME) and higher.</wrap> <wrap>The default on startup is 2M.</wrap> **//<wrap>xsize </wrap>//**<wrap>The value of //xsize //must be a valid decimal number. The actual upper limit is determined by the host system’s architecture, the operating system and on some systems the amount of physical memory and paging space that is available.</wrap> <wrap>Storage sizes not on a 1M boundary are rounded up to the next 1M boundary. The lower limit and default is 0.</wrap> **<wrap>B </wrap>**<wrap>‘B’ determines that the number given is specified in bytes (no multiplier). Specifying the storage in bytes is possible only for main storage.</wrap> **<wrap>K </wrap>**<wrap>‘K’ determines that the number given is specified in kilobytes (multiplier 2%%**%%10). Specifying the storage in kilobytes is possible only for main storage.</wrap> **<wrap>M </wrap>**<wrap>‘M’ determines that the number given is specified in megabytes (multiplier 2%%**%%20). This is the default if no unit is appended.</wrap> **<wrap>G </wrap>**<wrap>‘G’ determines that the number given is specified in gigabytes (multiplier 2%%**%%30).</wrap> **<wrap>T </wrap>**<wrap>‘T’ determines that the number given is specified in terabytes (multiplier 2%%**%%40). On 32-bit machines the unit terabytes is not available.</wrap> **<wrap>P </wrap>**<wrap>‘P’ determines that the number given is specified in petabytes (multiplier 2%%**%%50). Specifying the storage in petabytes is possible only for main storage. On 32-bit machines the unit petabytes is not available.</wrap> **<wrap>E </wrap>**<wrap>‘E’ determines that the number given is specified in exabytes (multiplier 2%%**%%60). Specifying the storage in exabytes is possible only for main storage. On 32-bit machines the unit exabytes is not available.</wrap> **<wrap>LOCK </wrap>**<wrap>Attempt to lock the storage (pages locked by the host operating system).</wrap> **<wrap>UNLOCK </wrap>**<wrap>Leave the store unlocked (no pages locked by the host operating system). This is the default.</wrap> **<wrap>Notes:</wrap>** <wrap>The actual upper limit is determined by the host system’s architecture and operating system and the amount of physical memory and available paging space. The total of MAINSIZE and XPNDSIZE on host systems with a 32-bit architecture will be limited to 4G; host systems with a 64-bit architecture will be limited to less than 16E.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 76</wrap> <wrap>\\ </wrap><wrap>Using minimum storage sizes, storage sizes less than or not on a 64K boundary for architecture level ALS0 (S/370) or not on a 1M boundary for architecture level ALS1 (ESA/390) and higher, it may be possible to generate error conditions not covered by the “Principles of Operations”.</wrap> <wrap>Use of storage sizes greater than supported by the guest operating system may generate incorrect results or error conditions within the guest operating system.</wrap> **//<wrap>5.23.4 Overview Storage Allocation Units</wrap>//** |<WRAP>**<wrap>Unit</wrap>** </WRAP> |<WRAP>**<wrap>Multiplier</wrap>** </WRAP> |<WRAP>**<wrap>Name (Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>IEC Name (IEC Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>Restrictions</wrap>** </WRAP> | |<WRAP><wrap>B</wrap> </WRAP> |<WRAP><wrap>None</wrap> </WRAP> |<WRAP><wrap>Byte (B)</wrap> </WRAP> |<WRAP><wrap>Byte (B)</wrap> </WRAP> |<WRAP><wrap>Main storage only</wrap> </WRAP> | |<WRAP><wrap>K</wrap> </WRAP> |<WRAP><wrap>2%%**%%10</wrap> </WRAP> |<WRAP><wrap>Kilobyte (kB)</wrap> </WRAP> |<WRAP><wrap>Kibibyte (KiB)</wrap> </WRAP> |<WRAP><wrap>Main storage only</wrap> </WRAP> | |<WRAP><wrap>M</wrap> </WRAP> |<WRAP><wrap>2%%**%%20</wrap> </WRAP> |<WRAP><wrap>Megabyte (MB)</wrap> </WRAP> |<WRAP><wrap>Mebibyte (MiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>G</wrap> </WRAP> |<WRAP><wrap>2%%**%%30</wrap> </WRAP> |<WRAP><wrap>Gigabyte (GB)</wrap> </WRAP> |<WRAP><wrap>Gibibyte (GiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>T</wrap> </WRAP> |<WRAP><wrap>2%%**%%40</wrap> </WRAP> |<WRAP><wrap>Terabyte (TB)</wrap> </WRAP> |<WRAP><wrap>Tebibyte (TiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | |<WRAP><wrap>P</wrap> </WRAP> |<WRAP><wrap>2%%**%%50</wrap> </WRAP> |<WRAP><wrap>Petabyte (PB)</wrap> </WRAP> |<WRAP><wrap>Pebibyte (PiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | |<WRAP><wrap>E</wrap> </WRAP> |<WRAP><wrap>2*60</wrap> </WRAP> |<WRAP><wrap>Exabyte (EB)</wrap> </WRAP> |<WRAP><wrap>Exbibyte (EiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | **<wrap>Table 5: Storage Allocation Units</wrap>** **//<wrap>5.23.5 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the size of the main storage to 1024 MB. Do not lock the memory into the storage.</wrap> <wrap>DEFSTORE MAIN 1024</wrap> <wrap>or</wrap> <wrap>DEFSTORE MAIN 1024 UNLOCK</wrap> <wrap>or</wrap> <wrap>DEFSTORE MAIN 1024M</wrap> <wrap>or</wrap> <wrap>DEFSTORE MAIN 1024M UNLOCK</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 77</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the size of the expanded storage to 256 MB. Do not lock the memory into the storage.</wrap> <wrap>DEFSTORE XSTORE 256</wrap> <wrap>or</wrap> <wrap>DEFSTORE XSTORE 256M</wrap> <wrap>or</wrap> <wrap>DEFSTORE XSTORE 256 UNLOCK</wrap> <wrap>or</wrap> <wrap>DEFSTORE XSTORE 256M UNLOCK</wrap> **<wrap>Example 3:</wrap>** <wrap>Set the the main storage to 2 GB, the expanded storage to 512 MB and lock the memory into the storage.</wrap> <wrap>DEFSTORE MAIN 2048 LOCK XSTORE 512 LOCK</wrap> <wrap>or</wrap> <wrap>DEFSTORE MAIN 2048M LOCK XSTORE 512M LOCK</wrap> <wrap>or</wrap> <wrap>DEFSTORE MAIN 2G LOCK XSTORE 512M LOCK</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 78</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.24 DEFSYM (Define a symbol) \\ //5.24.1 Function//</wrap>** <wrap>Defines symbol ‘//symbol’ //is to contain value ‘//value’//. The symbol can then be the object of a substitution used later in the configuration file or for console commands. If //value //contains blanks or spaces it must be enclosed within quotes or apostrophes. See chapter “Symbol Substitutions” for a more in-depth discussion on this feature.</wrap> <wrap>Substitution is available in configuration statements, meaning it is possible to perform substitution in the //DEFSYM //statement itself. However, symbols are always defined as the last step in the process, so attempting to self-define a symbol will result in an empty string.</wrap> **//<wrap>5.24.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>DEFSYM </wrap>//<wrap>symbol </wrap>////<wrap>value</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ DEFSYM ¬¬¬ </wrap>//<wrap>symbol </wrap>//<wrap>¬¬¬ </wrap>//<wrap>value</wrap>// **//<wrap>5.24.3 Parameter</wrap>//** **//<wrap>symbol </wrap>//**<wrap>The name of a symbol.</wrap> **//<wrap>value </wrap>//**<wrap>The value that is assigned to the symbol.</wrap> **//<wrap>5.24.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a symbol “TAPEDIR” with the value “/home/hercules/tapes”.</wrap> <wrap>DEFSYM TAPEDIR "/home/hercules/tapes"</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 79</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.25 DEVPRIO (Device threads process priority) \\ //5.25.1 Function//</wrap>** <wrap>DEVPRIO specifies the priority of the device threads. See section 5.82 “Process and Thread Priorities” for details.</wrap> **<wrap>Caution: </wrap>**<wrap>DEVPRIO should not have a higher dispatching priority than the TOD clock and timer thread.</wrap> **//<wrap>5.25.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>DEVPRI0 (8 | </wrap>//<wrap>nn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬DEVPRI0 ¬¬¬§¬¬¬ 8 _ </wrap> <wrap>⡿¬¬¬</wrap>//<wrap>nn</wrap>// **//<wrap>5.25.3 Parameter</wrap>//** **<wrap>8 </wrap>**<wrap>Specifies a device threads prority of 8. This is the default</wrap> **//<wrap>nn </wrap>//**<wrap>This value specifies the priority for the device threads. For details on the priority values see section 5.82 (“Process and Thread Priorities”). The default is 8.</wrap> **//<wrap>5.25.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set a priority of 10 for the device threads.</wrap> <wrap>DEVPRIO 10</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 80</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.26 DEVTMAX (Maximum number of device threads) \\ //5.26.1 Function//</wrap>** <wrap>DEVTMAX specifies the maximum number of device threads allowed.</wrap> **//<wrap>5.26.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>DEVTMAX (0 | </wrap><wrap>-1 </wrap><wrap>| 1</wrap><wrap>-</wrap>//<wrap>n</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_DEVTMAX %%__%%_§%%__%%%%__%% 0 </wrap><wrap>¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª%%__%%_ </wrap><wrap>-1 ¬¬¬¬«</wrap> <wrap>⡿%%__%%_ 1</wrap><wrap>-</wrap>//<wrap>n </wrap>//<wrap>%%__%%_</wrap> **//<wrap>5.26.3 Parameter</wrap>//** **<wrap>0 </wrap>**<wrap>Specify 0 to create an unlimited number of ‘semi-permanent’ threads on an ‘as-needed’ basis. This is the default. With this option, a thread is created to service an I/O request for a device if one does not already exist. When the I/O is complete the thread enters an idle state waiting for new work. If a new I/O request for the device arrives before the timeout period expires the existing thread will be reused. The timeout value is currently hard coded at 5 minutes.</wrap> <wrap>Note that this option can cause one thread (or possibly more) to be created for each de vice in your configuration. Specifying 0 means there is no limit to the number of threads that can be created.</wrap> **<wrap>-1 </wrap>**<wrap>Specify -1 to cause ‘one time only’ temporary threads to be created to service each I/O request to a device. Once the I/O request is complete, the thread exits. Subsequent I/Os to the same device will cause another worker thread to be created again.</wrap> **<wrap>1-//n //</wrap>**<wrap>Specify a value from 1 to n to set an upper limit to the number of threads that can be created to service any I/O request to any device. Like the “0” option, each thread once finished servicing an I/O request enters an idle state. If a new request arrives before the timeout period expires, the thread is reused.</wrap> <wrap>If all threads are busy when a new I/O request arrives a new thread is created only if the specified maximum number of threads have not yet been reached. If the specified maximum number of threads already has been reached then the I/O request is placed in a queue and will be serviced by the first available thread (eg. by whichever thread becomes idle first).</wrap> <wrap>This option was created to address a threading issue, possibly related to the Cyg-</wrap><wrap></wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 81</wrap> <wrap>\\ </wrap><wrap>win phtreads implementation on Windows systems. On Windows systems positive DEVTMAX values are currently not honoured and are treated identically as if the value 0 had been specified. The default for non-Windows systems is 0.</wrap> **//<wrap>5.26.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the upper limit for the number of device threads to 16.</wrap> <wrap>DEVTMAX 16</wrap> **<wrap>Example 2:</wrap>** <wrap>Allow an unlimited number of device threads.</wrap> <wrap>DEVTMAX 0</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 82</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.27 DIAG8CMD (DIAGNOSE 8 command option) \\ //5.27.1 Function//</wrap>** <wrap>This parameter specifies whether a command issued through Diagnose 8 will be executed by Hercules as a Hercules commands or not. An optional second argument can be specified to request whether the commands issued using the Diagnose 8 interface will be traced at the console. This may be useful for programs that routinely issue console commands using the Diagnose 8 interface.</wrap> **<wrap>Caution: </wrap>**<wrap>Enabling this feature may have security consequences. When this feature is enabled it is possible for guest operating systems running under Hercules to issue commands directly to the host operating system by means of the Hercules ‘sh’ (shell) command. This ability may be disabled via the SHCMDOPT statement.</wrap> **<wrap>Note: </wrap>**<wrap>There are some commands that are being prevented from being used by the Diagnose 8 interface. The list of commands that may not be executed by means of Diagnose 8 can be found in “Appendix D. Hercules Command Groups” under the column ‘NODIAG8’.</wrap> **//<wrap>5.27.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>DIAG8CMD (</wrap>__<wrap>DISABLE</wrap>__<wrap> | ENABLE [ECHO | </wrap>__<wrap>NOECHO</wrap>__<wrap>]}</wrap>__<wrap></wrap>__ **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬DIAG8CMD ¬¬¬§¬¬¬ </wrap>__<wrap>DISABLE</wrap>__<wrap> ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§ </wrap><wrap>⡿¬¬¬ENABLE¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ª¬¬¬¬ ECHO ¬¬¬¬« ⡿¬¬¬ </wrap>__<wrap>NOECHO</wrap>__<wrap> ¬¬¬</wrap> **//<wrap>5.27.3 Parameter</wrap>//** **<wrap>DISABLE </wrap>**<wrap>Commands issued through the Diagnose 8 interface will generate a Specification</wrap> <wrap>Exception program interrupt on the issuing CPU. This is the default.</wrap> **<wrap>ENABLED </wrap>**<wrap>Commands issued through the Diagnose 8 interface will be executed by Hercules as Hercules commands.</wrap> **<wrap>ECHO </wrap>**<wrap>When ECHO is specified, a message is issued as the console is about to issue the command, the command is redisplayed as if it was entered through the console input line, and a final message is issued to indicate the command completed.</wrap> **<wrap>NOECHO </wrap>**<wrap>When NOECHO is specified, no such messages are displayed and the command completes silently, except for the output of the command itself if the Diagnose 8 interface did not request a response buffer. This is the default.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 83</wrap> <wrap>\\ </wrap><wrap>The value of ECHO or NOECHO has no effect on command output being placed into a response buffer if the Diagnose 8 interface requested one.</wrap> **//<wrap>5.27.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify that commands issued through the Diagnose 8 interface are executed as Hercules commands. Additionally issue a message, as the console is about to execute the command, then redisplay the command itself and give a final message, indicating the command has completed.</wrap> <wrap>DIAG8CMD ENABLE ECHO</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 84</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.28 ECPSVM (ECPS:VM support status (VM)) \\ //5.28.1 Function//</wrap>** <wrap>This parameter specifies, whether ECPS:VM (Extended Control Program Support : Virtual Machine) support is to be enabled and – if it is enabled – to which level. The purpose of ECPS:VM is to provide to the VM/370 operating system a set of shortcut facilities to perform hypervisor functions (CP Assists) and virtual machine simulation (VM Assists).</wrap> <wrap>Although this feature does not affect VM operating system products operating in XA, ESA or z/Architec-ture mode, it will affect VM/370 and VM/SP products running under VM/XA, VM/ESA or z/VM. Running VM/370 and VM/SP products under VM/XA, VM/ESA or z/VM should be done with ECPS:VM disabled. ECPS:VM should not be enabled in AP or MP environments. ECPS:VM has no effect on non-VM operating systems. It is however recommended to disable ECPS:VM when running native non-VM operating systems.</wrap> <wrap>If a specific level is given this value will be reported to the operating system when it issues a Store ECPS:VM level but it does not otherwise alter the ECPS:VM facility operations. Please note that this is a partial implementation.</wrap> <wrap>Because the ECPSVM system parameter is processed by the same command processor like the ECPSVM console command, the same parameters can be specified. This may not make sense for all of them however. As an example the STATS parameter in the configuration is useless, because there are no statistics to display at this time.</wrap> <wrap>Some of the arguments of the ECPSVMsystem parameter can be abbreviated as shown in the syntax section below.</wrap> **//<wrap>5.28.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>ECPSVM (</wrap><wrap>Help </wrap><wrap>| Sl</wrap><wrap>ats </wrap><wrap>| </wrap>__<wrap>DIS</wrap>____<wrap>able</wrap>__<wrap> | EN</wrap><wrap>able </wrap><wrap>| DEBUG | NO</wrap><wrap>debug </wrap><wrap>| Level </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ECPSVM ¬¬¬§¬¬¬¬ H</wrap><wrap>elp ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>ª¬¬¬¬Sl</wrap><wrap>ats ¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>i¬¬¬ </wrap>__<wrap>DIS</wrap>____<wrap>able</wrap>__<wrap> ¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>F¬¬¬ EN</wrap><wrap>able ¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬¬DEBUG¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ª¬¬¬NO</wrap><wrap>debug ¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬¬Level </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬ </wrap>//<wrap>nn </wrap>//<wrap>¬¬¬¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 85</wrap> <wrap>\\ </wrap>**//<wrap>5.28.3 Parameter</wrap>//** **<wrap>Help </wrap>**<wrap>Display help with all available ECPSVM options.</wrap> **<wrap>STats </wrap>**<wrap>Show statistical counters.</wrap> **<wrap>DISable </wrap>**<wrap>Disable all ECPS:VM features. This is the default if ECPSVM is not coded.</wrap> **<wrap>ENable </wrap>**<wrap>Enable all ECPS:VM features.</wrap> **<wrap>DEBUG </wrap>**<wrap>Debug ECPS:VM features.</wrap> **<wrap>NOdebug </wrap>**<wrap>Turn debug modus off for ECPS:VM features.</wrap> **<wrap>Level </wrap>**<wrap>Set/show ECPS:VM level.</wrap> **//<wrap>nn </wrap>//**<wrap>The value //nn //specifies the support level that is reported to the operating system.</wrap> **//<wrap>5.28.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Enable “Extended Control Program Support : Virtual Machine” support.</wrap> <wrap>ECPSVM ENABLE</wrap> <wrap>or</wrap> <wrap>ECPSVM EN</wrap> **<wrap>Example 2:</wrap>** <wrap>Enable “ECPS:VM” support and set the level reported to the operating system to 20.</wrap> <wrap>ECPSVM LEVEL 20</wrap> <wrap>or</wrap> <wrap>ECPSVM L 20</wrap> **<wrap>Example 3:</wrap>** <wrap>Debug “ECPS:VM” features.</wrap> <wrap>ECPSVM DEBUG</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 86</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.29 ENGINES (Processor engines type) \\ //5.29.1 Function//</wrap>** <wrap>The ENGINES parameter specifies the type of engine for each installed processor. The default engine type is CP. The number of installed processor engines is determined by the MAXCPU system parameter.</wrap> <wrap>If the ENGINES system parameter specifies more than MAXCPU engines, the excess engines are ignored. If fewer than MAXCPU engines are specified, the remaining engines are set to type CP (the default). See the MAXCPU system parameter or console command for details regarding the compile time variable MAX_CPU_ENGINES.</wrap> <wrap>For detailed explanations on the interrelationship between ENGINES, MAXCPU and NUMCPU please see “Appendix B. Configuration of Emulated CPUs”.</wrap> **//<wrap>5.29.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>ENGINES [</wrap>//<wrap>nn*</wrap>//<wrap>] {</wrap>__<wrap>CP</wrap>__<wrap> | IL | AP | IP} [, ... ]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®</wrap> <wrap> </wrap> <wrap>ÊÊ¬¬¬ENGINES ¬¬¬°¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬ </wrap>__<wrap>CP</wrap>__<wrap> ¬¬¬§¬¬¬¨¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿¬¬¬ </wrap>//<wrap>nn* </wrap>//<wrap>¬¬¬¯ ª¬¬¬ IL ¬¬¬«</wrap> <wrap>ª¬¬¬AP¬¬¬« \\ ⡿¬¬¬IP¬¬¬¯</wrap> **//<wrap>5.29.3 Parameter</wrap>//** **//<wrap>nn</wrap>//****<wrap>* </wrap>**<wrap>This is an optional repeat count.</wrap> **<wrap>CP </wrap>**<wrap>Specifies a processor engine of type CP. This is the default.</wrap> **<wrap>IL </wrap>**<wrap>Specifies a processor engine of type IL.</wrap> **<wrap>AP </wrap>**<wrap>Specifies a processor engine of type AP.</wrap> **<wrap>IP </wrap>**<wrap>Specifies a processor engine of type IP.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 87</wrap> <wrap>\\ </wrap>**//<wrap>5.29.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify 4 engines of type CP, 2 engines of type AP and 2 engines of type IP.</wrap> <wrap>ENGINES CP,CP,CP,CP,AP,AP,IP,IP</wrap> <wrap>or</wrap> <wrap>ENGINES 4*CP,2*AP,2*IP</wrap> **<wrap>Example 2:</wrap>** <wrap>Specify 4 engines of type CP, 1 engine of type AP, 1 engine of type IP and 2 engines of type IL.</wrap> <wrap>ENGINES CP,CP,CP,CP,AP,IP,IL,IL</wrap> <wrap>or</wrap> <wrap>ENGINES 4*CP,AP,IP,2*IL</wrap> **<wrap>Example 3:</wrap>** <wrap>Specify 3 engines of type CP and 1 engines of type IL.</wrap> <wrap>ENGINES CP,CP,CP,IL</wrap> <wrap>or</wrap> <wrap>ENGINES 3*CP,IL</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 88</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.30 HAO (Hercules Automatic Operator) \\ //5.30.1 Function//</wrap>** <wrap>The Hercules Automatic operator (HAO) feature is a facility that allows to automatically issue console commands in response to certain messages being issued. To use the HAO facility it is necessary to define a rule, consisting of a target and an associated command.</wrap> <wrap>The Hercules Automatic Operator is only for those messages issued by Hercules to its console. It cannot be used for messages issued from the guest operating system.</wrap> <wrap>The current implementation limits the total number of defined rules to 64. There is currently no way to define a command whose arguments varies based on actual message text. All of the defined HAO rules are checked for a match each time Hercules issues a message, there is no way at this time to stop the processing of subsequent rules.</wrap> <wrap>HAO supports several commands. However when HAO is used in the configuration file, not all of the possible HAO commands make sense. As an example, there is no reason to define a rule in the configuration file and afterwards to delete it in one of the next statements. Therefore only those commands are listed here, that are useful during Hercules startup. For a list of all possible HAO commands see the HAO panel command.</wrap> **//<wrap>5.30.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>HAO </wrap>//<wrap>command </wrap>//<wrap>[</wrap>//<wrap>operands</wrap>//<wrap>] \\ where </wrap>//<wrap>command </wrap>//<wrap>can be:</wrap> <wrap>TGT </wrap>//<wrap>target</wrap>// <wrap>CMD </wrap>//<wrap>consolecmd</wrap>// <wrap>LIST [</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ HAO </wrap><wrap>¬¬¬« command</wrap> <wrap>where </wrap>//<wrap>command </wrap>//<wrap>can be:</wrap> <wrap>ª¬¬¬ TGT ¬¬¬ </wrap>//<wrap>target </wrap>//<wrap>¬¬¬¬ \\ </wrap><wrap>ª¬¬¬ CMD ¬¬¬ </wrap>//<wrap>consolecmd</wrap>// <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 89</wrap> <wrap>\\ </wrap>|<WRAP><wrap>I%%__%%_ LIST %%__%%_</wrap>__<wrap>§</wrap>__<wrap>%%__%%%%__%%%%__%%</wrap> <wrap>⡿%%__%%_</wrap>//<wrap>nn</wrap>// </WRAP> | **//<wrap>5.30.3 Parameter</wrap>//** **<wrap>TGT </wrap>**<wrap>This is the keyword to define a new rule (pattern).</wrap> **//<wrap>target </wrap>//**<wrap>Specifies the rule (pattern) to react on. The target is a regular expression pattern which is matched against the text of the messages that Hercules issues.</wrap> **<wrap>CMD </wrap>**<wrap>This is the keyword to specify a command for a previously defined rule.</wrap> **//<wrap>consolecmd </wrap>//**<wrap>Specifies the command to be executed if a target rule matches. The associated command must be a valid Hercules console command.</wrap> **<wrap>LIST </wrap>**<wrap>List all rules/commands or list only rule/command at index //nn//.</wrap> **//<wrap>nn </wrap>//**<wrap>Number of the index to be listed or deleted.</wrap> **//<wrap>5.30.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define the following target rule and the related command to be issued:</wrap> <wrap>Check for message HHC01600E ("Unknown Hercules command") and issue "?" command (List all valid commands).</wrap> <wrap>HAO TGT HHC01600E \\ HAO CMD HELP</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 90</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.31 HERCLOGO (Hercules logo file) \\ //5.31.1 Function//</wrap>** <wrap>HERCLOGO specifies the logo text file which defines a welcome screen that is presented when a TN3270 terminal connects to a Hercules 3270 device. For details on how to code the Hercules logo file, see section 10 (“Hercules 3270 Logo”).</wrap> **//<wrap>5.31.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>HERCL0G0 </wrap>****//<wrap>filename</wrap>//** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ HERCL0G0 ¬¬¬ </wrap>****//<wrap>filename</wrap>//** **//<wrap>5.31.3 Parameter</wrap>//** **//<wrap>filename </wrap>//**<wrap>The name (and optionally path) of a logo text file. If no path is specified the logo file is first searched in the current working directory and second in the directory where the Hercules executable resides.</wrap> **//<wrap>5.31.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Use the logo text file “HERCLOGO.txt” for the welcome screen.</wrap> <wrap>HERCLOGO </wrap>[[file:///D:/HERCULES/CONF/HERCLOGO.TXT|<wrap>D:%%\%%HERCULES%%\%%CONF%%\%%HERCLOGO.TXT</wrap>]]<wrap></wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 91</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.32 HERCPRIO (Hercules process priority) \\ //5.32.1 Function//</wrap>** <wrap>The HERCPRIO parameter specifies the process priority for Hercules. See section 5.82 “Process and Thread Priorities” for details.</wrap> **<wrap>Caution: </wrap>**<wrap>HERCPRIO should not have a higher dispatching priority than the TOD clock and timer thread.</wrap> **//<wrap>5.32.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>HERCPRI0 (0 | </wrap>//<wrap>nn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬HERCPRI0 ¬¬¬§¬¬¬ 0 _ </wrap> <wrap>⡿¬¬¬</wrap>//<wrap>nn</wrap>// **//<wrap>5.32.3 Parameter</wrap>//** **<wrap>0 </wrap>**<wrap>Specifies a process priority for Hercules of 0. This is the default</wrap> **//<wrap>nn </wrap>//**<wrap>This value specifies the process priority for Hercules. For details on the priority values see section 5.82 (“Process and Thread Priorities”). The default is 0.</wrap> **//<wrap>5.32.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the Hercules process priority to 0.</wrap> <wrap>HERCPRIO 0</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 92</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.33 HTTP (HTTP server configuration) \\ //5.33.1 Function//</wrap>** <wrap>The HTTP statement configures the HTTP server. More than one HTTP statement can be coded in the configuration file. Depending on the given arguments the port on which the HTTP server will listen and the authorization (if any) or the location of the HTTP server files can be specified. Additional arguments allow to start or to stop the HTTP server. Please note, that the HTTP server is not started by default (i.e. without a “HTTP START” statement).</wrap> **//<wrap>5.33.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>HTTP {START | STOP | ROOT </wrap>//<wrap>path </wrap>//<wrap>| PORT </wrap>//<wrap>port </wrap>//<wrap>{NOAUTH | AUTH </wrap>//<wrap>userid password</wrap>//<wrap>}}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ HTTP ¬¬¬§¬¬¬ START ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§ </wrap><wrap>ª</wrap><wrap>¬¬¬ STOP ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ª%%__%%_ROOT %%__%%_</wrap>//<wrap>path </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿%%__%%_PORT ¬¬¬ </wrap>//<wrap>port </wrap>//<wrap>%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%% NOAUTH %%__%%%%__%%%%__%%%%__%%%%__%%«</wrap> <wrap>⡿%%__%%_AUTH </wrap>//<wrap>userid password </wrap>//<wrap>%%__%%_</wrap> **//<wrap>5.33.3 Parameter</wrap>//** **<wrap>START </wrap>**<wrap>Start the HTTP server (if it is stopped).</wrap> **<wrap>STOP </wrap>**<wrap>Stop the HTTP server (if it is started).</wrap> **<wrap>ROOT </wrap>**<wrap>Keyword to specify the root directory of the HTTP server files. The HTTP root can only be set if the HTTP server is in the stopped state.</wrap> **//<wrap>path </wrap>//**<wrap>The full path of the root directory where the HTTP server files reside. If this parameter is not specified the default value for Win32 builds of Hercules is the directory where the Hercules executables themselves reside. For non-Win32 builds it is the directory specified as the default package installation directory when the Hercules executables were built. This can vary depending on how the Hercules package was built, it is commonly “/usr/local/share/hercules”.</wrap> **<wrap>PORT </wrap>**<wrap>Keyword to specify the port on which the HTTP server will listen (including optional authorization information). The HTTP port and authorization information can only be set if the HTTP server is in the stopped state.</wrap> **//<wrap>port </wrap>//**<wrap>The port number must be either 80 or within the range of 1024 to 65535 inclusive.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 93</wrap> <wrap>\\ </wrap>**<wrap>NOAUTH </wrap>**<wrap>NOAUTH indicates that no userid and password are required to access the HTTP server.</wrap> **<wrap>AUTH </wrap>**<wrap>AUTH indicates that a userid and a password are required to access the HTTP server. The userid and password have to be coded after the AUTH parameter.</wrap> **//<wrap>userid </wrap>//**<wrap>The userid can be any valid string.</wrap> **//<wrap>password </wrap>//**<wrap>The password can be any valid string.</wrap> **//<wrap>5.33.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Activate the HTTP server under a Linux system listening on port 8081 and with the HTTP server files residing on “/usr/local/share/Hercules”. Specify that authorization is required to access the HTTP server. The userid should be UID0001 and the password should be PSWD0001.</wrap> <wrap>HTTP PORT 8081 AUTH UID0001 PSWD0001 \\ HTTP ROOT /usr/local/share/Hercules \\ HTTP START</wrap> **<wrap>Example 2:</wrap>** <wrap>Activate the HTTP server under a Windows system listening on port 8088 and with the HTTP server files residing on “D:%%\%%Hercules%%\%%HTML”. Specify that authorization is not required to access the HTTP server.</wrap> <wrap>HTTP PORT 8088 NOAUTH</wrap> <wrap>HTTP ROOT </wrap>[[file:///D:/Hercules/HTML|<wrap>D:%%\%%Hercules%%\%%HTML</wrap>]]<wrap></wrap> <wrap>HTTP START</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 94</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.34 HTTPPORT (HTTP server port) \\ //5.34.1 Function//</wrap>** <wrap>The HTTPPORT parameter has been deprecated and is replaced by the HTTP system parameter. Use “HTTP PORT” instead. See the HTTP system parameter for details.</wrap> **//<wrap>5.34.2 Syntax</wrap>//** <wrap>See HTTP system parameter.</wrap> **//<wrap>5.34.3 Parameter</wrap>//** <wrap>See HTTP system parameter.</wrap> **//<wrap>5.34.4 Examples</wrap>//** <wrap>See HTTP system parameter.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 95</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.35 HTTPROOT (HTTP server root directory) \\ //5.35.1 Function//</wrap>** <wrap>The HTTPROOT parameter has been deprecated and is replaced by the HTTP system parameter. Use “HTTP ROOT” instead. See the HTTP system parameter for details.</wrap> **//<wrap>5.35.2 Syntax</wrap>//** <wrap>See HTTP system parameter.</wrap> **//<wrap>5.35.3 Parameter</wrap>//** <wrap>See HTTP system parameter.</wrap> **//<wrap>5.35.4 Examples</wrap>//** <wrap>See HTTP system parameter.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 96</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.36 IGNORE (Ignore subsequent INCLUDE errors) \\ //5.36.1 Function//</wrap>** <wrap>This system parameter indicates that errors caused by subsequent INCLUDE statements - for files which do not exist - should be ignored rather than causing the Hercules startup to be aborted as it would otherwise normally occur</wrap> **//<wrap>5.36.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>IGNORE INCLUDE ERRORS</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ IGNORE ¬¬¬ INCLUDE ERRORS</wrap>** **//<wrap>5.36.3 Parameter</wrap>//** **<wrap>INCLUDE_ERRORS </wrap>**<wrap>Indicates that subsequent INCLUDE errors will be ignored.</wrap> **//<wrap>5.36.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify that errors caused by subsequent INCLUDE statements should be ignored.</wrap> <wrap>IGNORE INCLUDE_ERRORS</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 97</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.37 INCLUDE (Include configuration file) \\ //5.37.1 Function//</wrap>** <wrap>An INCLUDE statement instructs the Hercules initialisation process to treat the contents of the file specified by filepath as if its contents had appeared in the configuration file at the point where the INCLUDE statement appears.</wrap> <wrap>The included file itself may contain yet another INCLUDE statement as long as the maximum nesting depth of 8 is not exceeded.</wrap> **//<wrap>5.37.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>INCLUDE </wrap>****//<wrap>filepath</wrap>//** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ INCLUDE ¬¬¬ </wrap>****//<wrap>filepath</wrap>//** **//<wrap>5.37.3 Parameter</wrap>//** **//<wrap>filepath </wrap>//**<wrap>Specifies the path and the filename of the configuration file that is to be included.</wrap> **//<wrap>5.37.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify that Hercules should include the contents of the file "</wrap>[[file:///D:/S390/CONF/CONFIG2.CONF|<wrap>D:%%\%%S390%%\%%CONF%%\%%CONFIG2.CONF</wrap>]]<wrap>" into the configuration.</wrap> <wrap>INCLUDE </wrap>[[file:///D:/S390/CONF/CONFIG2.CONF|<wrap>D:%%\%%S390%%\%%CONF%%\%%CONFIG2.CONF</wrap>]]<wrap></wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 98</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.38 IODELAY (I/O interrupt wait time (LINUX)) \\ //5.38.1 Function//</wrap>** <wrap>IODELAY sets the amount of time in microseconds to wait after an I/O interrupt is ready to be set pending. This value can also be set using the Hercules console. The purpose of this parameter is to circumvent a bug in the Linux/390 and z/Linux ‘dasd.c’ device driver. The bug is more likely to occur under Hercules than on a real machine as Hercules may present an I/O interrupt sooner than a real machine.</wrap> <wrap>NOTE: OSTAILOR LINUX no longer sets IODELAY to 800 since the problem described above is no longer present in recent versions of the Linux kernel.</wrap> **//<wrap>5.38.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>I0DELAY (0 | </wrap>//<wrap>usecs </wrap>//<wrap>[N0WARN]}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬I0DELAY ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬ 0 </wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿</wrap><wrap>¬¬¬ </wrap>//<wrap>usecs </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬N0WARN¬¬¬¯</wrap> **//<wrap>5.38.3 Parameter</wrap>//** **//<wrap>usecs </wrap>//**<wrap>Amount of time in microseconds to wait after an I/O interrupt is ready to be set pending.</wrap> **<wrap>NOWARN </wrap>**<wrap>If the IODELAY value is non-zero then a warning message will be issued unless NOWARN is specified.</wrap> **//<wrap>5.38.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the amount of time to wait after an I/O interrupt is ready to be set pending to 1000 microseconds.</wrap> <wrap>IODELAY 1000</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 99</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the amount of time to wait after an I/O interrupt is ready to be set pending to 500 microseconds and suppress the warning message.</wrap> <wrap>IODELAY 500 NOWARN</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 100</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.39 LDMOD (Additional dynamic load modules) \\ //5.39.1 Function//</wrap>** <wrap>LMOD provides the capability of defining additional modules that will be loaded by the Hercules Dynamic Loader. The default search order is within the Hercules directory and in the default DLL search path. Most systems also support absolute filenames (e.g. names starting with “/” or “.”) in which case the default search path is not taken. Multiple LDMOD statements may be used.</wrap> **//<wrap>5.39.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LM0D </wrap>//<wrap>module </wrap>//<wrap>[</wrap>//<wrap>module </wrap>//<wrap>[</wrap>//<wrap>module </wrap>//<wrap>...11</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ LDM0D ¬¬¬°¬¬¬ </wrap>//<wrap>module</wrap>// **//<wrap>5.39.3 Parameter</wrap>//** **//<wrap>module </wrap>//**<wrap>A list of modules that are to be loaded by the Hercules Dynamic Loader.</wrap> **//<wrap>5.39.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Instruct Hercules to load the additional module named S37X (S/370 Extension) from the Hercules directory or the default DLL search path.</wrap> <wrap>LDMOD S37X</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 101</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.40 LEGACYSENSEID (SENSE ID CCW (x'E4') feature) //5.40.1 Function//</wrap>** <wrap>This option specifies whether the SENSE ID CCW (X'E4') will be honoured for the devices that originally did not support that feature. This includes (but may not be limited to) 3410 and 3420 tape drives, 2311 and 2314 direct access storage devices and 2703 communication controllers. Because those legacy devices didn't originally support this command, and for compatibility reasons, the default is OFF or DISABLE.</wrap> <wrap>Specify ON or ENABLE, if your guest operating system needs the Sense ID support to dynamically detect those devices. Note that most current operating systems will not detect those devices even though Sense ID is enabled because those devices never supported the Sense ID in the first place. This mainly applies to custom built or modified versions of guest operating systems that are aware of this specific Hercules capability.</wrap> **//<wrap>5.40.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LEGACYSENSEID (</wrap>__<wrap>OFF</wrap>__<wrap> | </wrap>__<wrap>DISABLE</wrap>__<wrap> | ON | ENABLE}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>LEGACYSENSEID </wrap><wrap>¬¬¬§¬¬¬¬¬ </wrap>__<wrap>OFF</wrap>__<wrap> ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ </wrap>__<wrap>DISABLE</wrap>__<wrap> ¬¬¬«</wrap> <wrap>ª¬¬¬ ¬ ON ¬¬¬¬¬¬I</wrap> <wrap>⡿¬¬¬ENABLE¬¬¬¬¯</wrap> **//<wrap>5.40.3 Parameter</wrap>//** **<wrap>OFF </wrap>**<wrap>Specify OFF or DISABLE if your guest operating system does not need the Sense ID support to dynamically detect devices that originally did not support that feature. This is the default.</wrap> **<wrap>DISABLE </wrap>**<wrap>This is the same os ‘OFF’.</wrap> **<wrap>ON </wrap>**<wrap>Specify ON or ENABLE if your guest operating system needs the Sense ID support to dynamically detect devices that originally did not support that feature.</wrap> **<wrap>ENABLE </wrap>**<wrap>This is the same as ‘ON’.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 102</wrap> <wrap>\\ </wrap>**//<wrap>5.40.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify that the SENSE ID CCW will be honoured for devices that originally did not support that feature.</wrap> <wrap>LEGACYSENSEID ENABLE</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 103</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.41 LOADPARM (IPL parameter) \\ //5.41.1 Function//</wrap>** <wrap>This parameter specifies the eight-character IPL parameter which is used by all MVS based operating systems (MVS 3.8J, MVS/SP, MVS/XA, MVS/ESA, OS/390, z/OS) to select the system start parameter.</wrap> **//<wrap>5.41.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>L0ADPARM </wrap>//<wrap>ipl parameter</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ L0ADPARM ¬¬¬ </wrap>//<wrap>ipl parameter</wrap>// **//<wrap>5.41.3 Parameter</wrap>//** **//<wrap>ipl_parameter </wrap>//**<wrap>The system parameter used for the IPL of the intended operating system. The parameter is operating system dependent, consult the relevant operating system documentation for details.</wrap> **//<wrap>5.41.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Use 0A8200M1 as system parameter for the IPL of the operating system.</wrap> <wrap>LOADPARM 0A8200M1</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 104</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.42 LOGOPT (Logging options) \\ //5.42.1 Function//</wrap>** <wrap>The LOGOPT statement specifies the Hercules log options. It allows to insert or suppress the time stamp in front of each log message</wrap> **//<wrap>5.42.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>L0G0PTS {</wrap>****__<wrap>TIMESTAMP</wrap>__****<wrap> | </wrap>****__<wrap>TIME</wrap>__****<wrap> | N0TIMESTAMP | N0TIME}</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>Ê</wrap>**<wrap>Ê¬¬¬L0G0PTS </wrap>**<wrap>¬¬¬§¬¬¬¬ </wrap>**__<wrap>TIMESTAMP</wrap>__**<wrap> ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> **<wrap>ª¬¬¬¬¬¬</wrap>****__<wrap>TIME</wrap>__**<wrap> ¬¬¬¬¬¬¬«</wrap> **<wrap>I¬¬¬ N0TIMESTAMP</wrap>**<wrap>¬¬¬«</wrap> **<wrap>⡿¬¬</wrap>**<wrap>¬¬</wrap>**<wrap>¬N0TIME¬¬</wrap>**<wrap>¬¬</wrap>**<wrap>¬¬¯</wrap>** **//<wrap>5.42.3 Parameter</wrap>//** **<wrap>TIMESTAMP </wrap>**<wrap>Insert a time stamp in front of each log message. This is the same as using TIME.</wrap> **<wrap>TIME </wrap>**<wrap>Insert a time stamp in front of each log message. This is the same as using TIME-STAMP.</wrap> **<wrap>NOTIMESTAMP </wrap>**<wrap>Display log messages without a timestamp. This is the same as using NOTIME.</wrap> **<wrap>NOTIME </wrap>**<wrap>Display log messages without a timestamp. This is the same as using NOTIME-STAMP.</wrap> **//<wrap>5.42.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify that messages in the log are to be time stamped.</wrap> <wrap>LOGOPTS TIMESTAMP</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 105</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.43 LPARNAME (LPAR name returned by DIAG x'204') //5.43.1 Function//</wrap>** <wrap>LPARNAME defines the LPAR name returned by DIAG x’204’.</wrap> **//<wrap>5.43.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LPARNAME (__HERCULES__ | </wrap>//<wrap>lparname</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_LPARNAME %%__%%_§%%__%%_ __HERCULES__</wrap><wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>L%%__%%_ </wrap>//<wrap>lparname </wrap>//<wrap>%%__%%_</wrap> **//<wrap>5.43.3 Parameter</wrap>//** **//<wrap>lparname </wrap>//**<wrap>Maximum 8 byte character name for the LPAR. The default is HERCULES.</wrap> **//<wrap>5.43.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify HERCULES as LPAR name returned by DIAG x’204’.</wrap> <wrap>LPARNAME HERCULES</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 106</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.44 LPARNUM (LPAR identification number) \\ //5.44.1 Function//</wrap>** <wrap>The LPARNUM system parameter sets the LPAR identification number. It specifies the one- or two-digit hexadecimal LPAR identification number stored by the STIDP instruction, or BASIC. If a one-digit number from 1 to F (hexadecimal) is specified, then STIDP stores a format-0 CPU ID, unless a subsequent “CPUIDFMT 1” statement is specified. If zero or a two-digit hexadecimal number, except 10 (hexadecimal), is specified, then STIDP stores a format-1 CPU ID. For LPARNUM 10 the current CPUIDFMT is not changed. If LPARNUM is BASIC, then the STIDP instruction stores a basic-mode CPU ID. The default is LPARNUM 1 with a format-0 CPU ID.</wrap> **//<wrap>5.44.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>LPARNUM (BASIC |</wrap>****<wrap>1 </wrap>****<wrap>| </wrap>****//<wrap>n </wrap>//****<wrap>| </wrap>****//<wrap>nn</wrap>//****<wrap>}</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>oo¬¬¬ LPARNUM </wrap>****<wrap>¬¬¬§¬¬¬ </wrap>****<wrap>BASIC </wrap>****<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>****<wrap>ª¬</wrap>****<wrap>¬¬¬¬ 1 ¬¬¬¬¬« </wrap>****<wrap>ª¬¬¬</wrap>****<wrap>1...F ¬¬¬« </wrap>****<wrap>ª¬¬¬¬¬0 </wrap>****<wrap>¬¬¬¬¬« </wrap>****<wrap>⡿¬</wrap>****<wrap>¬¬¬ </wrap>****//<wrap>nn </wrap>//****<wrap>¬¬¬</wrap>****<wrap>¬¬¯</wrap>** **//<wrap>5.44.3 Parameter</wrap>//** **<wrap>BASIC </wrap>**<wrap>Specifies that STIDP stores a basic-mode CPU ID.</wrap> **<wrap>1 </wrap>**<wrap>Specifies the one-digit hexadecimal LPAR identification number. The STIDP instruction stores a format-0 CPU ID. This is the default.</wrap> **<wrap>1 ... F </wrap>**<wrap>Specifies the one-digit hexadecimal LPAR identification number. The STIDP instruction stores a format-0 CPU ID, unless a subsequent “CPUIDFMT 1” statement is specified.</wrap> **<wrap>0 </wrap>**<wrap>Specifies 0 as LPAR identification number. The STIDP instruction stores a format-1 CPU ID.</wrap> **//<wrap>nn </wrap>//**<wrap>Specifies the two-digit hexadecimal LPAR identification number (except 10 hexadecimal). For LPARNUM 10 the current CPUIDFMT is not changed. The STIDP instruction stores a format-1 CPU ID.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 107</wrap> <wrap>\\ </wrap>**//<wrap>5.44.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the LPAR identification number to x’21’ (Format-1 CPU ID).</wrap> <wrap>LPARNUM 21</wrap> **<wrap>Example 2:</wrap>** <wrap>Set the LPAR identification number to x’A’ (Format-0 CPU ID).</wrap> <wrap>LPARNUM A</wrap> **<wrap>Example 3:</wrap>** <wrap>Set a basic-mode CPU ID.</wrap> <wrap>LPARNUM BASIC</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 108</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.45 MAINSIZE (Main storage size) \\ //5.45.1 Function//</wrap>** <wrap>MAINSIZE specifies the size of the main storage. Storage is allocated in megabytes, unless a specific unit is specified. The actual upper limit of the main storage is determined by the host system's architecture, operating system, and on some systems the amount of physical memory and paging space you have available. The practical limit depends on the maximum amount of storage that can be obtained by “malloc” (usually around 1 GB on 32-bit platforms; on 64-bit platforms the value should only be limited by available paging space).</wrap> <wrap>An additional optional argument determines the locking state of the allocated memory (page lock by host operating system). The LOCKED option indicates that the memory is to be locked into storage while UNLOCKED (the default) indicates that the memory is not locked into the storage.</wrap> <wrap>Please note that Hercules preserves the last locking state of MAINSIZE. Once storage is locked, any subsequent change to the main storage size will honor the existing lock state of memory unless the lock state is specified again on the MAINSIZE command.</wrap> **<wrap>Caution: </wrap>**<wrap>Do not lock main storage unless sufficient real memory is available to back up the request. Failure to do so may require the host system to be rebooted.</wrap> **//<wrap>5.45.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MAINSIZE //msize//[B | K | M | G | I | P |E] [</wrap>__<wrap>UNLOCK</wrap>__<wrap> | LOCK]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** |<WRAP><wrap>ÊÊ¬¬¬MAINSIZE ¬¬-- //msize//</wrap> </WRAP> |<WRAP><wrap>~--- M ---® ~--- UNLOCK---®</wrap> <wrap>--¦---------¦---¦--------------¦------------------ÊÍ</wrap> <wrap>ª¬¬¬ B ---« ⡿¬¬¬¬LOCK¬¬¬¬¯</wrap> <wrap>ª¬¬¬K ---« \\ ª¬¬¬G ---« \\ ª¬¬¬T ---« \\ ª¬¬¬P ---« \\ ⡿--- E ---¯</wrap> </WRAP> | **//<wrap>5.45.3 Parameter</wrap>//** **//<wrap>msize </wrap>//**<wrap>The value of //msize //must be a valid decimal number. The actual upper limit is determined by the host system's architecture, the operating system and on some systems the amount of physical memory and paging space that is available.</wrap> <wrap>For storage sizes less than 16M, sizes not on a 4K boundary are rounded up to the next 4K boundary. Otherwise, storage sizes not on a 1M boundary are rounded up to the next 1M boundary.</wrap> <wrap>The minimum size is 4K for architecture levels ALS0 and ALS1 (S/370 and</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 109</wrap> <wrap>\\ </wrap><wrap>ESA/390), and 8K for architecture level ALS2 (ESAME) and higher. A maximum of 64M may be specified for architecture level ALS0 (S/370), 2048M (2G) for ALS1</wrap> <wrap>(ESA/390) and 16E for architecture level ALS2 (ESAME) and higher.</wrap> <wrap>The default on startup is 2M.</wrap> **<wrap>B </wrap>**<wrap>‘B’ determines that the number given is specified in bytes (no multiplier).</wrap> **<wrap>K </wrap>**<wrap>‘K’ determines that the number given is specified in kilobytes (multiplier 2%%**%%10).</wrap> **<wrap>M </wrap>**<wrap>‘M’ determines that the number given is specified in megabytes (multiplier 2%%**%%20). This is the default if no unit is appended.</wrap> **<wrap>G </wrap>**<wrap>‘G’ determines that the number given is specified in gigabytes (multiplier 2%%**%%30).</wrap> **<wrap>T </wrap>**<wrap>‘T’ determines that the number given is specified in terabytes (multiplier 2%%**%%40). On 32-bit machines the unit terabytes is not available.</wrap> **<wrap>P </wrap>**<wrap>‘P’ determines that the number given is specified in petabytes (multiplier 2%%**%%50). On 32-bit machines the unit petabytes is not available.</wrap> **<wrap>E </wrap>**<wrap>‘E’ determines that the number given is specified in exabytes (multiplier 2%%**%%60). On 32-bit machines the unit exabytes is not available.</wrap> **<wrap>LOCK </wrap>**<wrap>Attempt to lock the storage (pages locked by the host operating system).</wrap> **<wrap>UNLOCK </wrap>**<wrap>Leave the store unlocked (no pages locked by the host operating system). This is the default.</wrap> **<wrap>Notes:</wrap>** <wrap>The actual upper limit is determined by the host system’s architecture and operating system and the amount of physical memory and available paging space. The total of MAINSIZE and XPNDSIZE on host systems with a 32-bit architecture will be limited to 4G; host systems with a 64-bit architecture will be limited to less than 16E.</wrap> <wrap>Using minimum storage sizes, storage sizes less than or not on a 64K boundary for architecture level ALS0 (S/370) or not on a 1M boundary for architecture level ALS1 (ESA/390) and higher, it may be possible to generate error conditions not covered by the “Principles of Operations”.</wrap> <wrap>Use of storage sizes greater than supported by the guest operating system may generate incorrect results or error conditions within the guest operating system.</wrap> **//<wrap>5.45.4 Overview Storage Allocation Units</wrap>//** |<WRAP>**<wrap>Unit</wrap>** </WRAP> |<WRAP>**<wrap>Multiplier</wrap>** </WRAP> |<WRAP>**<wrap>Name (Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>IEC Name (IEC Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>Restrictions</wrap>** </WRAP> | |<WRAP><wrap>B</wrap> </WRAP> |<WRAP><wrap>None</wrap> </WRAP> |<WRAP><wrap>Byte (B)</wrap> </WRAP> |<WRAP><wrap>Byte (B)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>K</wrap> </WRAP> |<WRAP><wrap>2%%**%%10</wrap> </WRAP> |<WRAP><wrap>Kilobyte (kB)</wrap> </WRAP> |<WRAP><wrap>Kibibyte (KiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>M</wrap> </WRAP> |<WRAP><wrap>2%%**%%20</wrap> </WRAP> |<WRAP><wrap>Megabyte (MB)</wrap> </WRAP> |<WRAP><wrap>Mebibyte (MiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 110</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Unit</wrap>** </WRAP> |<WRAP>**<wrap>Multiplier</wrap>** </WRAP> |<WRAP>**<wrap>Name (Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>IEC Name (IEC Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>Restrictions</wrap>** </WRAP> | |<WRAP><wrap>G</wrap> </WRAP> |<WRAP><wrap>2%%**%%30</wrap> </WRAP> |<WRAP><wrap>Gigabyte (GB)</wrap> </WRAP> |<WRAP><wrap>Gibibyte (GiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>T</wrap> </WRAP> |<WRAP><wrap>2%%**%%40</wrap> </WRAP> |<WRAP><wrap>Terabyte (TB)</wrap> </WRAP> |<WRAP><wrap>Tebibyte (TiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | |<WRAP><wrap>P</wrap> </WRAP> |<WRAP><wrap>2%%**%%50</wrap> </WRAP> |<WRAP><wrap>Petabyte (PB)</wrap> </WRAP> |<WRAP><wrap>Pebibyte (PiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | |<WRAP><wrap>E</wrap> </WRAP> |<WRAP><wrap>2*60</wrap> </WRAP> |<WRAP><wrap>Exabyte (EB)</wrap> </WRAP> |<WRAP><wrap>Exbibyte (EiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | **<wrap>Table 6: Storage Allocation Units</wrap>** **//<wrap>5.45.5 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the size of the main storage to 1024 MB. Do not lock the memory into the storage.</wrap> <wrap>MAINSIZE 1024</wrap> <wrap>or</wrap> <wrap>MAINSIZE 1024 UNLOCK</wrap> <wrap>or</wrap> <wrap>MAINSIZE 1024M</wrap> <wrap>or</wrap> <wrap>MAINSIZE 1024M UNLOCK</wrap> **<wrap>Example 2:</wrap>** <wrap>Set the size of the main storage to 4 GB. Lock the memory into the storage.</wrap> <wrap>MAINSIZE 4096 LOCK</wrap> <wrap>or</wrap> <wrap>MAINSIZE 4G LOCK</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 111</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.46 MANUFACTURER (STSI manufacturer code) \\ //5.46.1 Function//</wrap>** <wrap>MANUFACTURER specifies the manufacturer name returned by the STSI instruction. The default name is HRC.</wrap> **//<wrap>5.46.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MANUFACTURER {</wrap>__<wrap>HRC</wrap>__<wrap> | </wrap>//<wrap>name</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬MANUFACTURER ¬¬¬§¬¬¬ </wrap>__<wrap>HRC</wrap>__<wrap> ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ L¬¬¬ </wrap>//<wrap>name </wrap>//<wrap>¬¬¬</wrap> </WRAP> | **//<wrap>5.46.3 Parameter</wrap>//** **//<wrap>name </wrap>//**<wrap>Any name with a maximum length of 16 characters. Valid characters are A-Z and 09. If MANUFACTURER is not specified in the configuration file then the default is HRC.</wrap> **//<wrap>5.46.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the manufacturer name returned by the STSI instruction to “HERC”.</wrap> <wrap>MANUFACTURER HERC</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 112</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.47 MAXCPU (Maximum number of CPUs) \\ //5.47.1 Function//</wrap>** <wrap>The MAXCPU system parameter specifies the maximum number of installed processor engines. The combination of MAXCPU and NUMCPU controls the behaviour of how many CPU engines will be configured online upon startup and how many can be configured online later. The NUMCPU statement specifies the number of engines which will be configured online at startup time. All processors are CP engines unless otherwise specified by the ENGINES statement.</wrap> <wrap>MAX_CPU_ENGINES is a compile-time variable which sets an upper limit on the value of MAXCPU. The value of MAX_CPU_ENGINES is displayed in the build information message on the Hercules control panel at startup time. To change the value of MAX_CPU_ENGINES you must rebuild Hercules. For Unix builds, specify "./configure --enable-multi-cpu=//nn//" before performing make. For Windows builds, specify "SET MAX_CPU_ENGINES=//nn//" before performing nmake.</wrap> <wrap>MAX_CPU_ENGINES may be up to 128 on 64-bit Linux platforms. On Windows, and on all 32-bit platforms, the maximum value is 64. For performance reasons, values above 32 are not recommended for 32-bit platforms. If MAX_CPU_ENGINES is set to 1 then multiprocessing is disabled. See also the NUM-CPU statement for a discussion of the performance implications of MAX_CPU_ENGINES.</wrap> <wrap>The value of MAXCPU cannot exceed the value of MAX_CPU_ENGINES. If MAXCPU is not specified in the configuration file, then its initial value is equal to NUMCPU. If MAXCPU and NUMCPU are both omitted, then MAXCPU is set to 1.</wrap> <wrap>For detailed explanations on the interrelationship between MAXCPU, ENGINES and NUMCPU please see “Appendix B. Configuration of Emulated CPUs”.</wrap> **//<wrap>5.47.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MAX</wrap><wrap>CPU </wrap><wrap>(</wrap><wrap>1 </wrap><wrap>| </wrap>//<wrap>nn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>MAXCPU </wrap><wrap>¬¬¬§¬¬¬ 1 %%__%% </wrap> <wrap>⡿¬¬¬</wrap>//<wrap>nn</wrap>// **//<wrap>5.47.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>Specifies the maximum number of installed processor engines. The value of MAXCPU cannot exceed the value of MAX_CPU_ENGINES (see description above).</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 113</wrap> <wrap>\\ </wrap>**//<wrap>5.47.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the maximum number of installed processor engines to 8.</wrap> <wrap>MAXCPU 8</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 114</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.48 MAXRATES (MIPS/SIO rate reporting interval) \\ //5.48.1 Function//</wrap>** <wrap>MAXRATES sets the MIPS/SIO rate reporting interval. When the interval is expired a MAXRATES command is automatically issued. The current rates will also be displayed during shutdown of Hercules. The default for the MAXRATES interval (if not coded in the configuration file) is 1440 minutes (1 day).</wrap> **//<wrap>5.48.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MAXRATES [</wrap>__<wrap>1440</wrap>__<wrap> | </wrap>//<wrap>in</wrap>////<wrap>terval </wrap>//<wrap>| MIDNIGHT</wrap><wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬MAXRATES ¬¬¬§¬¬¬¬¬ </wrap>__<wrap>1440</wrap>__<wrap> ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>1</wrap><wrap>/4 ª¬¬¬ </wrap>//<wrap>interval </wrap>//<wrap>¬¬¬« \\ </wrap><wrap>⡿¬¬¬MIDNIGHT ¬¬¬</wrap> **//<wrap>5.48.3 Parameter</wrap>//** **<wrap>1440 </wrap>**<wrap>This is the default that takes place if there is no MAXRATES interval is specified in the configuration file and sets the interval to 1440 minutes (1 day).</wrap> **//<wrap>interval </wrap>//**<wrap>This specifies the interval time in minutes. Changes to the MAXRATES interval that are other than “MIDNIGHT” will set the current interval start time to the present; this includes a value of “1440”.</wrap> **<wrap>MIDNIGHT </wrap>**<wrap>Sets the interval to 1440 minutes (1 day) and the start time for the interval timer to midnight of the current day. This will cause the MAXRATE statistics to be date aligned.</wrap> **//<wrap>5.48.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the MAXRATES interval to 60 minutes.</wrap> <wrap>MAXRATES 60</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 115</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the MAXRATES interval to one day and and the start time for the interval timer to midnight of the current day.</wrap> <wrap>MAXRATES MIDNIGHT</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 116</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.49 MEMLOCK (Lock Hercules memory) \\ //5.49.1 Function//</wrap>** <wrap>The MEMLOCK system parameter is used to lock Hercules memory in storage. It defines the locking state of the allocated Hercules memory (page lock by host operating system). If the Hercules memory is locked in storage it cannot be paged out by the host operating system. This may result in some performance improvements.</wrap> <wrap>This system parameter is available if Hercules is built with option “_HAVE_MLOCKALL”. Currently MEMLOCK is only supported under Linux host operating systems.</wrap> **//<wrap>5.49.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MEMLOCK (ON | </wrap>__<wrap>OFF</wrap>__<wrap>}____</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>MEMLOCK </wrap><wrap>¬¬¬§¬¬¬ </wrap><wrap>ON</wrap> <wrap>L%%__%%_ </wrap>__<wrap>OFF</wrap>__<wrap></wrap> **//<wrap>5.49.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>ON indicates that the memory is to be locked into storage.</wrap> **<wrap>OFF </wrap>**<wrap>OFF indicates that the memory is not to be locked into the storage.</wrap> **//<wrap>5.49.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Lock the Hercules memory in the storage.</wrap> <wrap>MEMLOCK ON</wrap> **<wrap>Example 2:</wrap>** <wrap>Do not lock the Hercules memory in the storage.</wrap> <wrap>MEMLOCK OFF</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 117</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.50 MODEL (STSI model code) \\ //5.50.1 Function//</wrap>** <wrap>MODEL specifies the model names returned by the STSI instruction. The optional second, third and the fourth operands specify the capacity model name, the permanent capacity model name and the temporary capacity model name respectively.</wrap> <wrap>The default model name, if the MODEL system parameter is not coded, is “EMULATOR”.</wrap> **//<wrap>5.50.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>MODEL (</wrap>__<wrap>EMULATOR</wrap>__<wrap> | </wrap>//<wrap>hdwmod </wrap>//<wrap>| = |*} \\ </wrap><wrap>[</wrap>__<wrap>EMULATOR</wrap>__<wrap> | </wrap>//<wrap>capmod </wrap>//<wrap>| = | * \\ </wrap><wrap>[</wrap>//<wrap>prmmod </wrap>//<wrap>| = | *</wrap> <wrap>[</wrap>//<wrap>tmpmod </wrap>//<wrap>| = | *</wrap><wrap>111</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬MODEL ¬¬¬§¬¬¬ </wrap>__<wrap>EMULATOR</wrap>__<wrap> %%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%Ê</wrap> <wrap>ª¬¬¬¬</wrap>//<wrap>hdwmod </wrap>//<wrap>%%__%%%%__%%«</wrap> <wrap>ª¬¬¬¬¬¬= </wrap><wrap>%%__%%%%__%%%%__%%_«</wrap> <wrap>⡿¬</wrap><wrap>%%__%%%%__%%_ * %%__%%%%__%%%%__%%</wrap><wrap>¬¯</wrap> <wrap>Ê</wrap><wrap>%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%ÊÍ </wrap><wrap>ª</wrap><wrap>%%__%%_ </wrap>__<wrap>EMULATOR</wrap>__<wrap> %%__%%_§%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_« </wrap><wrap>ª¬</wrap><wrap>%%__%%_ </wrap>//<wrap>capmod </wrap>//<wrap>%%__%%%%__%%« </wrap><wrap>ª¬</wrap><wrap>%%__%% </wrap>//<wrap>prmmod </wrap>//<wrap>%%__%%_§%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%« </wrap><wrap>ª</wrap><wrap>%%__%%%%__%%%%__%% </wrap><wrap>= </wrap><wrap>%%__%%%%__%%%%__%%_« </wrap><wrap>ª¬</wrap><wrap>%%__%%%%__%% </wrap><wrap>= </wrap><wrap>%%__%%%%__%%%%__%%« </wrap><wrap>ª</wrap><wrap>%%__%%_ </wrap>//<wrap>tmpmod </wrap>//<wrap>%%__%%_« </wrap><wrap>⡿</wrap><wrap>%%__%%%%__%%%%__%% * %%__%%%%__%%</wrap><wrap>¬¬¬¯ ⡿</wrap><wrap>%%__%%%%__%%_ * %%__%%_</wrap><wrap>¬¬¬¯ ª</wrap><wrap>%%__%%%%__%%_ </wrap><wrap>= </wrap><wrap>%%__%%%%__%%%%__%%«</wrap> <wrap>⡿</wrap><wrap>%%__%%%%__%%_ * %%__%%_</wrap><wrap>¬¬¬¯</wrap> **//<wrap>5.50.3 Parameter</wrap>//** **//<wrap>hdwmodel </wrap>//**<wrap>This specifies the hardware model name. This can be any name with a maximum length of 16 characters. Valid characters are A-Z and 0-9. Specifying a “=” resets the hardware model to “EMULATOR”; specifying an “*” leaves the current hardware model name intact. If the MODEL system parameter is not specified in the configuration file then the default name is “EMULATOR”.</wrap> **//<wrap>capmodel </wrap>//**<wrap>This optional parameter specifies the capacity model name. The //capmodel //can be any name with a maximum length of 16 characters. Valid characters are A-Z and 09. Specifying a “=” copies the current hardware model name to the capacity model; specifying an “*” leaves the current capacity model name intact. The default capa-</wrap><wrap></wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 118</wrap> <wrap>\\ </wrap><wrap>city model name is “EMULATOR”.</wrap> <wrap>\\ </wrap>**//<wrap>prmmodel </wrap>//**<wrap>This specifies the permanent capacity model name. The //prmmodel //can be any name with a maximum length of 16 characters. Valid characters are A-Z and 0-9. Specifying a “=” copies the current capacity model name to the permanent capacity model; specifying an “*” leaves the current permanent capacity model name intact. The default permanent capacity model name is a null string.</wrap> **//<wrap>tmpmodel </wrap>//**<wrap>This specifies the temporary capacity model name. The //tmpmodel //can be any name with a maximum length of 16 characters. Valid characters are A-Z and 0-9. Specifying a “=” copies the current permanent capacity model name to the temporary capacity model; specifying an “*” leaves the current temporary capacity model name intact. The default temporary capacity model name is a null string.</wrap> **//<wrap>5.50.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the model name returned by the STSI instruction to “EMULATOR”.</wrap> <wrap>MODEL EMULATOR</wrap> **<wrap>Example 2:</wrap>** <wrap>Set all model names returned by the STSI instruction to “EMULATOR”.</wrap> <wrap>MODEL EMULATOR EMULATOR EMULATOR EMULATOR</wrap> <wrap>or</wrap> <wrap>MODEL EMULATOR = = =</wrap> **<wrap>Example 3:</wrap>** <wrap>Set all capacity model names returned by the STSI instruction to “HERCULES”, but leave the hardware model name as is.</wrap> <wrap>MODEL * HERCULES HERCULES HERCULES</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 119</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.51 MODPATH (Dynamic load module path) \\ //5.51.1 Function//</wrap>** <wrap>MODPATH specifies the path where dynamic load modules are loaded from. If a MODPATH statement is coded then the path on the MODPATH statement is searched before the default path is searched. When a relative path is specified it is interpreted as a relative path within the default search path. If an absolute path is coded it is interpreted as such.</wrap> <wrap>The default MODPATH is ‘hercules’ which means modules are loaded from the directory ‘hercules’ within the default LD_LIBRARY_PATH.</wrap> **//<wrap>5.51.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>**<wrap>M0DPATH </wrap>//<wrap>path</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ M0DPATH ¬¬¬ </wrap>//<wrap>path</wrap>// **//<wrap>5.51.3 Parameter</wrap>//** **//<wrap>path </wrap>//**<wrap>The path where dynamic load modules are loaded from.</wrap> **//<wrap>5.51.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the path from where dynamic load modules are loaded to “D:/HERCULES/MODIFICATIONS”.</wrap> <wrap>MODPATH </wrap>[[file:///D:/HERCULES/MODIFICATIONS|<wrap>D:/HERCULES/MODIFICATIONS</wrap>]]<wrap></wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 120</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.52 MOUNTED_TAPE_REINIT (Control tape initialization) //5.52.1 Function//</wrap>** <wrap>This system parameter specifies whether reinitialization of tape drive devices via the DEVINIT command in order to mount a new tape should be allowed if there is already a tape mounted on the drive. This option is meant as a safety mechanism to protect against accidentally unmounting a tape from the wrong device as a result of a simple typing error and thereby eventually cancelling a potentially important tape job. Please note that for SCSI tape drives the "DEVINIT nnnn *" command has no effect. The tape must be unmounted manually since it is a real physical device and not emulated via a disk file like '.AWS' or '.HET' tapes.</wrap> <wrap>Specifying ALLOW, the default, indicates that new tapes may be mounted via "DEVINIT nnnn new-tape-filename" irrespective of whether or not there is already a tape mounted on the drive.</wrap> <wrap>Specifying DISALLOW prevents new tapes from being mounted if one is already mounted. Before the new tape can be mounted the existing one has first to be unmounted (via the "DEVINIT nnnn *" command). Otherwise the DEVINIT attempt to mount the new tape is rejected.</wrap> **//<wrap>5.52.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MOUNTED TAPE REINIT (__ENABLE__ | </wrap>__<wrap>ALLOW</wrap>__<wrap> | DISABLE | DISALLOW}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>MOUNTED TAPE REINIT </wrap><wrap>¬¬¬§¬¬¬ </wrap>__<wrap>ENABLE</wrap>__<wrap> ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>f%%__%%_ </wrap>__<wrap>ALLOW</wrap>__<wrap> ¬¬¬¬¬¬«</wrap> <wrap>I%%__%%_ DISABLE </wrap><wrap>¬¬¬¬«</wrap> <wrap>L%%__%%_ DISA</wrap><wrap>LLOW </wrap><wrap>%%__%%_</wrap> **//<wrap>5.52.3 Parameter</wrap>//** **<wrap>ENABLE </wrap>**<wrap>Indicates that new tapes may be mounted irrespective of whether or not there is already a tape mounted on the drive. This is the default.</wrap> **<wrap>ALLOW </wrap>**<wrap>This is the same as ENABLE.</wrap> **<wrap>DISABLE </wrap>**<wrap>Prevents new tapes from being mounted if one is already mounted on the drive. Before the new tape can be mounted the currently mounted tape must first to be unmounted. Instead of DISABLE, the argument DISALLOW that has been used in earlier versions of Hercules can also be used.</wrap> **<wrap>DISALLOW </wrap>**<wrap>This is the same as DISABLE.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 121</wrap> <wrap>\\ </wrap>**//<wrap>5.52.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify that new tapes are not being mounted if one is already mounted on the drive.</wrap> <wrap>MOUNTED_TAPE_REINIT DISABLE</wrap> **<wrap>Example 2:</wrap>** <wrap>Specify that new tapes may be mounted even if one is already mounted on the drive.</wrap> <wrap>MOUNTED_TAPE_REINIT ALLOW</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 122</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.53 MSGHLD (Timeout value of held messages) \\ //5.53.1 Function//</wrap>** <wrap>The MSGHLD system parameter is used to set the timeout value of held messages.</wrap> **//<wrap>5.53.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MSGHLD </wrap>//<wrap>nn</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ MSGHLD ¬¬¬ </wrap>//<wrap>nn</wrap>// **//<wrap>5.53.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This value specifies the new timeout value of held messages in seconds.</wrap> **//<wrap>5.53.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the timeout interval for held messages to 30 seconds.</wrap> <wrap>MSGHLD 30</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 123</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.54 MSGLEVEL (Message display output) \\ //5.54.1 Function//</wrap>** <wrap>The MSGLEVEL system parameter specifies the setting of the message level. It decides how many and what kind of messages are written to the Hercules console (and to the log).</wrap> <wrap>The message level is set per default to ‘terse’ which turns the verbose message level off. To display the additional messages during configuration file processing Hercules can be started with the “-v” option which sets the verbose message level. As an alternative, the MSGLEVEL system parameter can be set to activate the verbose message level. In this case however, MSGLEVEL must be coded as one of the first statements in the configuration file to take effect at an early stage during configuration file processing.</wrap> <wrap>In addition to the ‘terse’ level the following options are set by default (if not otherwise overwritten through the MSGLEVEL system parameter or console command): ‘nodebug’, ‘tape’, ‘dasd’, ‘comm’, ‘ur’, ‘scsi’, ‘ctca’, ‘graf’, ‘thread’ and ‘channel’.</wrap> <wrap>Certain levels (on, off, text, time) can only be set if Hercules is built with one of the following build options: OPTION_MSGCLR or OPTION_MSGHLD.</wrap> **//<wrap>5.54.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MSGLEVEL {</wrap>//<wrap>option option </wrap>//<wrap>...} \\ where </wrap>//<wrap>option </wrap>//<wrap>can be:</wrap> |<WRAP><wrap>ON</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>OFF | TEXT</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>TIME |</wrap> </WRAP> |<WRAP><wrap>NODEBUG |</wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] DEBUG</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] TAPE</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] DASD</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] COMM</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] UR</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] SCSI</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] CTCA</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] GRAF</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] THREAD</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] CHANNEL</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] VERBOSE</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] TERSE</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 124</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ MSGLEVEL ¬¬¬°¬¬¬I%%__%%_ </wrap>****//<wrap>option</wrap>//** **<wrap>where </wrap>****//<wrap>option </wrap>//****<wrap>can be:</wrap>** **<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬ ON¬¬¬¬¬¬¬¬§ ¬¬¬¬¬¬¬¬¬¬¬¬¬ OFF ¬¬¬¬¬¬¬I ¬¬¬¬¬¬¬¬¬¬¬¬¬TEXT¬¬¬¬¬¬I ¬¬¬¬¬¬¬¬¬¬¬¬¬TIME¬¬¬¬¬¬I ¬¬¬¬¬¬¬¬¬¬¬¬¬NODEBUG ¬¬¬I ¬¬¬¬¬§¬¬¬§¬¬¬ DEBUG¬¬¬¬¬I</wrap>** **<wrap>+ ¬¬¬I ª¬¬¬ TAPE ¬¬¬¬¬¬I</wrap>** **<wrap>- ¬¬¬¯ ª¬¬¬ DASD ¬¬¬¬¬¬I</wrap>** **<wrap>ª¬¬¬ COMM ¬¬¬¬¬¬« \\ ª¬¬¬ UR ¬¬¬¬¬¬¬¬« \\ ª¬¬¬ SCSI¬¬¬¬¬¬« \\ ª¬¬¬CTCA ¬¬¬¬¬¬I \\ ª¬¬¬GRAF ¬¬¬¬¬¬I \\ ª¬¬¬THREAD ¬¬¬¬I \\ ª¬¬¬CHANNEL¬¬¬I \\ ª¬¬¬VERBOSE¬¬¬« \\ ⡿¬¬¬TERSE¬¬¬¬¬</wrap>** **//<wrap>5.54.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>ON displays the messages in the default kind with message number followed by the message text.</wrap> **<wrap>OFF </wrap>**<wrap>No messages are displayed.</wrap> **<wrap>TEXT </wrap>**<wrap>Displays only the text part of the message (without message numbers).</wrap> **<wrap>TIME </wrap>**<wrap>Prefix the messages with a timestamp.</wrap> **<wrap>NODEBUG </wrap>**<wrap>The messages are not issued in debug mode (not prefixed additionally with the name of the source member and the line number that issues the message).</wrap> **<wrap>DEBUG </wrap>**<wrap>The messages are prefixed additionally with the name of the source member and the line number that issues the message.</wrap> **<wrap>TAPE </wrap>**<wrap>Display tape related messages.</wrap> **<wrap>DASD </wrap>**<wrap>Display DASD related messages.</wrap> **<wrap>COMM </wrap>**<wrap>Display communications related messages.</wrap> **<wrap>UR </wrap>**<wrap>Display unit record related messages.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 125</wrap> <wrap>\\ </wrap>**<wrap>SCSI </wrap>**<wrap>Display SCSI related messages.</wrap> **<wrap>CTCA </wrap>**<wrap>Display CTCA and LCS related messages.</wrap> **<wrap>GRAF </wrap>**<wrap>Display graphics (3270) related messages.</wrap> **<wrap>THREAD </wrap>**<wrap>Display threading related messages.</wrap> **<wrap>CHANNEL </wrap>**<wrap>Display channel related messages.</wrap> **<wrap>VERBOSE </wrap>**<wrap>Displays additional messages during configuration file processing.</wrap> **<wrap>TERSE </wrap>**<wrap>This turns the verbose message level off. This is the default unless VERBOSE is specified either through the MSGLEVEL system parameter or panel command or if Hercules is started with the “-v” option.</wrap> **//<wrap>5.54.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Turn the verbose level off.</wrap> <wrap>MSGLEVEL TERSE</wrap> **<wrap>Example 2:</wrap>** <wrap>Prefix messages with the name of the source member and the line number that issues the message (DEBUG level).</wrap> <wrap>MSGLEVEL DEBUG</wrap> **<wrap>Example 3:</wrap>** <wrap>Display no messages at all.</wrap> <wrap>MSGLEVEL OFF</wrap> **<wrap>Example 4:</wrap>** <wrap>Set a highly customized message processing. All messages have to be prefixed with a timestamp and additional messages during configuration file processing have to be displayed. SCSI related massaged as well as unit record related messages have to be suppressed.</wrap> <wrap>MSGLEVEL TIME +DEBUG +VERBOSE –SCSI -UR</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 126</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.55 MSGLVL (Message display output) \\ //5.55.1 Function//</wrap>** <wrap>This parameter specifies the message level. MSGLVL is an alias for the MSGLEVEL system parameter. Please see MSGLEVEL for details.</wrap> **//<wrap>5.55.2 Syntax</wrap>//** <wrap>See MSGLEVEL command.</wrap> **//<wrap>5.55.3 Parameter</wrap>//** <wrap>See MSGLEVEL command.</wrap> **//<wrap>5.55.4 Examples</wrap>//** <wrap>See MSGLEVEL command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 127</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.56 NUMCPU (Number of emulated CPUs) \\ //5.56.1 Function//</wrap>** <wrap>NUMCPU specifies the number of emulated processor engines which will be configured online at startup time. The combination of NUMCPU and MAXCPU controls the behaviour of how many CPU engines will be configured online upon startup and how many can be configured online later.</wrap> <wrap>NUMCPU cannot exceed the value of MAXCPU. If NUMCPU is less than MAXCPU then the remaining engines can be configured online later. The default NUMCPU value is 1. All processors are CP engines unless otherwise specified by the ENGINES system parameter.</wrap> <wrap>Multiprocessor emulation works best if your host system actually has more than one physical CPU, but you can still emulate multiple CPUs nevertheless even on a uniprocessor system (and you might even achieve a small performance benefit when you do).</wrap> <wrap>There is little point, however, in specifying NUMCPU greater than 1 unless your guest operating system (running under Hercules) is actually able to support multiple CPUs. If you do not actually need multiprocessor emulation, then setting MAX_CPU_ENGINES to 1 at compile time might even produce a slight performance advantage too.</wrap> <wrap>For detailed explanations on the interrelationship between NUMCPU, MAXCPU and ENGINES please see “Appendix B. Configuration of Emulated CPUs”.</wrap> **//<wrap>5.56.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>NUMCPU (</wrap><wrap>1 </wrap><wrap>| </wrap>//<wrap>nn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>NUMCPU </wrap><wrap>¬¬¬§¬¬¬ 1 _ </wrap> <wrap>⡿¬¬¬</wrap>//<wrap>nn</wrap>// **//<wrap>5.56.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>The number of emulated CPUs. NUMCPU must be less than or equal MAXCPU. If NUMCPU is larger than MAXCPU then an error message is issued, if it is less than MAXCPU then the remaining engines can be configured online later. The default for NUMCPU is 1.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 128</wrap> <wrap>\\ </wrap>**//<wrap>5.56.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the number of emulated CPUs to 4.</wrap> <wrap>NUMCPU 4</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 129</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.57 NUMVEC (Number of vector facilities) \\ //5.57.1 Function//</wrap>** <wrap>NUMVEC defines the number of emulated vector facilities. Default is one per CPU (for the number of CPUs, see also the NUMCPU parameter). The vector facility is only available in ESA/390 mode by default.</wrap> **//<wrap>5.57.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>NUMVEC (0 | </wrap>//<wrap>nn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>NUMVEC </wrap><wrap>¬¬¬§¬¬¬ </wrap><wrap>0 %%__%%_ </wrap> <wrap>⡿¬¬¬</wrap>//<wrap>nn</wrap>// **//<wrap>5.57.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>The number of desired vector facilities.</wrap> **//<wrap>5.57.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the number of emulated vector facilities to 1.</wrap> <wrap>NUMVEC 1</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 130</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.58 OSTAILOR (Tailor trace information for specific operating system)</wrap>** **//<wrap>5.58.1 Function</wrap>//** <wrap>OSTAILOR lets you specify the intended operating system. The effect of this parameter is to reduce control panel message traffic by selectively suppressing trace messages for program checks which are considered normal in the specified environment.</wrap> <wrap>The argument //QUIET //suppresses all exception messages whereas the argument //NULL //suppresses none of them. The other options do suppress some messages and do not suppress other messages depending on the specified operating system.</wrap> <wrap>Prefix values with a plus (“+”) to combine them with existing values or with a minus (“-“) to exclude them from existing values. To combine values the OSTAILOR statement has to be coded several times. Excluding values (although possible) does not make sense in the configuration file.</wrap> <wrap>See also the PGMTRACE console command which also to further fine tune the tracing of program interrupt exceptions.</wrap> **//<wrap>5.58.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>OSTAILOR {[+ | </wrap><wrap>-] </wrap><wrap>z/OS | OS/390 | VM | VSE | z/VSE | LINUX | </wrap><wrap>O</wrap><wrap>PENSOLARIS | QUIET | NULL}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬OSTAILOR¬¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬ z/OS ¬¬¬¬¬¬¬§</wrap> <wrap>ª¬¬¬ </wrap><wrap>+ ¬¬¬« </wrap><wrap>ª¬¬¬¬¬¬ OS/390 ¬¬¬¬¬¬</wrap><wrap>«</wrap> <wrap>⡿¬</wrap><wrap>¬¬ - ¬¬¬</wrap><wrap>¯ ª</wrap><wrap>¬¬¬</wrap><wrap>¬¬¬¬¬ VM ¬¬¬¬¬¬¬¬</wrap><wrap>« </wrap><wrap>ª¬¬¬¬¬¬¬VSE¬¬¬¬¬¬¬¬« ª¬¬¬¬¬¬z/VSE¬¬¬¬¬¬¬« ª¬¬¬¬¬¬LINUX¬¬¬¬¬¬¬« ª</wrap><wrap>¬¬¬ O</wrap><wrap>PENSOLARIS </wrap><wrap>¬¬¬¬« </wrap><wrap>ª¬¬¬¬¬¬QUIET¬¬¬¬¬¬¬« ⡿¬</wrap><wrap>¬¬¬¬</wrap><wrap>¬NULL¬¬</wrap><wrap>¬¬¬¬</wrap><wrap>¬¬</wrap> **//<wrap>5.58.3 Parameter</wrap>//** **<wrap>+ </wrap>**<wrap>Specifies to combine the value withexisting values.</wrap> **<wrap>- </wrap>**<wrap>Specifies to exclude the value from existing values.</wrap> **<wrap>z/OS </wrap>**<wrap>Code z/OS if you intend to run z/OS.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 131</wrap> <wrap>\\ </wrap>**<wrap>OS/390 </wrap>**<wrap>Code OS/390 if you intend to run MVS/370, MVS/XA, MVS/ESA, OS/390.</wrap> **<wrap>VM </wrap>**<wrap>Code VM if you intend to run VM/370, VM/ESA or z/VM.</wrap> **<wrap>VSE </wrap>**<wrap>Code VSE if you intend to run VSE/370 or VSE/ESA.</wrap> **<wrap>z/VSE </wrap>**<wrap>Code z/VSE if you intend to run z/VSE</wrap> **<wrap>LINUX </wrap>**<wrap>Code Linux if you intend to run Linux/390 or Linux for z/Series.</wrap> **<wrap>OpenSolaris </wrap>**<wrap>Code OpenSolaris you intend to run OpenSolaris for z/Series.</wrap> **<wrap>QUIET </wrap>**<wrap>QUIET discards all exception messages.</wrap> **<wrap>NULL </wrap>**<wrap>NULL allows all exception messages to be logged.</wrap> **//<wrap>5.58.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify Linux as the intended operating system and selectively suppressing trace messages for program checks which are considered normal in the Linux environment.</wrap> <wrap>OSTAILOR LINUX</wrap> **<wrap>Example 2:</wrap>** <wrap>Do not specify the intended operating system and allow all exception messages to be logged.</wrap> <wrap>OSTAILOR NULL</wrap> **<wrap>Example 3:</wrap>** <wrap>Specify VM, VSE and z/OS as the intended operating systems and selectively suppressing trace messages for program checks which are considered normal in these environments.</wrap> <wrap>OSTAILOR VM \\ OSTAILOR +VSE \\ OSTAILOR +z/OS</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 132</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.59 PANRATE (Console refresh rate) \\ //5.59.1 Function//</wrap>** <wrap>PANRATE defines the rate, in milliseconds, at which the Hercules hardware console (HMC) will be refreshed. Please be aware that the panel refresh rate can reduce overall Hercules performance if PANRATE is set to fast.</wrap> **//<wrap>5.59.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>PANRATE (</wrap>__<wrap>SLOW</wrap>__<wrap> | FAST | </wrap>//<wrap>rate</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬PANRATE ¬¬¬§¬¬¬ </wrap>__<wrap>SLOW</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬FAST¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>rate </wrap>//<wrap>¬¬¬</wrap> **//<wrap>5.59.3 Parameter</wrap>//** **<wrap>SLOW </wrap>**<wrap>SLOW is a synonym for a Hercules hardware console refresh rate of 500 milliseconds. This is also the default, if PANRATE is not specified.</wrap> **<wrap>FAST </wrap>**<wrap>FAST is a synonym for a Hercules hardware console refresh rate of 50 milliseconds.</wrap> **//<wrap>rate </wrap>//**<wrap>Any value between 1 (10) and 5000 milliseconds. A value less than the Linux system clock tick interval (10 on Intel platforms, 1 on Alpha platforms) or a value of more than 5000 will be rejected.</wrap> **//<wrap>5.59.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the panel refresh rate to 1 second.</wrap> <wrap>PANRATE 1000</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 133</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the panel refresh rate to 50 milliseconds.</wrap> <wrap>PANRATE FAST</wrap> <wrap>or</wrap> <wrap>PANRATE 50</wrap> **<wrap>Example 3:</wrap>** <wrap>Set the panel refresh rate to 500 milliseconds.</wrap> <wrap>PANRATE SLOW</wrap> <wrap>or</wrap> <wrap>PANRATE 500</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 134</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.60 PANTITLE (Console window title) \\ //5.60.1 Function//</wrap>** <wrap>PANTITLE specifies an optional console window title-bar string to be used in place of the default title supplied by the windowing system. This option allows one to distinguish between different Hercules sessions when running more than one instance of Hercules on the same machine.</wrap> <wrap>The PANTITLE option takes effect only when the Hercules console is displayed on an ‘xterm’ terminal (commonly used on Unix systems) or in a Windows command prompt window. Note that this option has no effect when Hercules is run under the control of the Hercules Windows GUI since Hercules's console window is hidden in favour of using the GUI's window instead.</wrap> <wrap>The default console title is a string consisting of the following information: \\ //“LPARNAME //– //SYSTYPE //* //SYSNAME //* //SYSPLEX //– System Status: //colour//”</wrap> <wrap>SYSTYPE, SYSNAME and SYSPLEX are populated by the system call SCLP Control Program Identification. If any of these values is blank, then that field is not presented in the console title. The system status colour has following meanings:</wrap> <wrap>RED One or more CPUs are in wait state.</wrap> <wrap>AMBER One or more CPUs are not running.</wrap> <wrap>GREEN Everything is working correctly.</wrap> **//<wrap>5.60.2 Syntax</wrap>//** {{hercules:userref:bf:image026.gif|}}{{hercules:userref:bf:image027.gif|}}{{hercules:userref:bf:image028.gif|}}{{hercules:userref:bf:image029.gif|}}**//<wrap>5.60.3 Parameter</wrap>//** **//<wrap>text </wrap>//**<wrap>Specifies the console window title-bar string to be used. If the value contains any blanks it must be enclosed within double-quotes ("). An empty string ("") will remove the default console title.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 135</wrap> <wrap>\\ </wrap>**//<wrap>5.60.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the console window title-bar string to “Hercules Emulator HMC”.</wrap> <wrap>PANTITLE "Hercules Emulator HMC"</wrap> **<wrap>Example 2:</wrap>** <wrap>Set the console window title-bar string to “Hercules_HMC”.</wrap> <wrap>PANTITLE Hercules_HMC</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 136</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.61 PGMPRDOS (LPP license setting) \\ //5.61.1 Function//</wrap>** <wrap>PGMPRDOS specifies whether or not Hercules will run licensed program product (LPP) ESA or z/Architecture operating systems.</wrap> **//<wrap>5.61.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PGMPRD0S (</wrap>__<wrap>RESTRICTED</wrap>__<wrap> | LICENSED}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬PGMPRD0S ¬¬¬§¬¬¬ </wrap>__<wrap>RESTRICTED</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>⡿¬¬¬¬LICENSED¬¬¬¬¯</wrap> **//<wrap>5.61.3 Parameter</wrap>//** **<wrap>RESTRICTED </wrap>**<wrap>When PGMPRDOS is set to RESTRICTED, Hercules will stop all CPUs when a licensed program product operating systems is detected. RESTRICTED is the default.</wrap> **<wrap>LICENSED </wrap>**<wrap>Setting PGMPRDOS to LICENSED will allow you to run licensed program product operating systems normally. This parameter has no effect on Linux/390, Linux for z/Series, or any 370-mode operating system.</wrap> <wrap>If you are running Hercules under the Windows GUI a pop up window appears during startup which must be acknowledged before the startup continuous.</wrap> **//<wrap>5.61.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Allow licensed program product operating systems to run normally.</wrap> <wrap>PGMPRDOS LICENSED</wrap> **<wrap>Example 2:</wrap>** <wrap>Disallow licensed program product operating systems to run.</wrap> <wrap>PGMPRDOS RESTRICTED</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 137</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.62 PLANT (STSI plant code) \\ //5.62.1 Function//</wrap>** <wrap>PLANT specifies the plant name returned by the STSI instruction.</wrap> **//<wrap>5.62.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PLANT {__ZZ__ | </wrap>//<wrap>name</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_PLANT %%__%%_§%%__%%%%__%% __ZZ__ %%__%% </wrap> <wrap>⡿%%__%%_ </wrap>//<wrap>name</wrap>// **//<wrap>5.62.3 Parameter</wrap>//** **//<wrap>name </wrap>//**<wrap>Any name with a maximum length of four characters. Valid characters are A-Z and 0-9. If PLANT is not specified in the configuration file then the default name is ZZ.</wrap> **//<wrap>5.62.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify “HERC” as the plant name returned by the STSI instruction.</wrap> <wrap>PLANT HERC</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 138</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.63 QUITMOUT (Quit timeout value) \\ //5.63.1 Function//</wrap>** <wrap>QUITMOUT is used for setting the timeout value for a second QUIT, EXIT or SSD command if Hercules is built with the option “OPTION_SHUTDOWN_CONFIRMATION”. If Hercules is built without this option, then the QUITMOUT system parameter cannot be specified in the configuration file.</wrap> **//<wrap>5.63.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>**<wrap>QUITM0UT </wrap>//<wrap>nn</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>QUITM0UT </wrap><wrap>¬¬¬ </wrap>//<wrap>nn</wrap>// **//<wrap>5.63.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This specifies the timeout value where //nn //must be in the range of 2 to 60 seconds. If the timeout value is 0 then no second QUIT, EXIT or SSD command is necessary.</wrap> **//<wrap>5.63.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the quit timeout value to 30 seconds.</wrap> <wrap>QUITMOUT 30</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 139</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.64 REXX (REXX interpreter settings) \\ //5.64.1 Function//</wrap>** <wrap>The REXX system parameter is used to manage the Rexx interpreter settings. It allows to specify the paths where the Rexx executables can be found and what extensions for the executables are to be used. If Hercules is built with support for both Rexx environments (Regina Rexx and Open Object Rexx) then the desired environments can be enabled or disabled. The message prefixes to be used for Rexx messages (issued through the “say” command) and error messages (issued through the Rexx interpreter) can be set separately.</wrap> **//<wrap>5.64.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>REXX </wrap>//<wrap>option</wrap>// <wrap>where </wrap>//<wrap>option </wrap>//<wrap>can be:</wrap> <wrap>ENABLE | START [REGINA | OOREXX]</wrap> <wrap>DISABLE | STOP</wrap> <wrap>PATHS | REXXPATHS (</wrap>//<wrap>path </wrap>//<wrap>[</wrap>//<wrap>delimiter path ...</wrap>//<wrap>] | RESET}</wrap> <wrap>SYSPATH (ON | OFF | RESET}</wrap> <wrap>EXTENSIONS | SUFFIXES (</wrap>//<wrap>suffix </wrap>//<wrap>[</wrap>//<wrap>delimiter suffix ...</wrap>//<wrap>] </wrap><wrap>| RESET}</wrap> <wrap>RESOLVER (ON | OFF | RESET}</wrap> <wrap>MSGLEVEL (0 | 1 | RESET}</wrap> <wrap>MSGPREFIX (</wrap>//<wrap>messageprefix </wrap>//<wrap>| OFF | RESET}</wrap> <wrap>ERRPREFIX (</wrap>//<wrap>errorprefix </wrap>//<wrap>| OFF | RESET}</wrap> <wrap>MODE (COMMAND | SUBROUTINE}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap> ÊÊ%%__%%_REXX %%__%%_ </wrap>//<wrap>option </wrap>//<wrap>¬ </wrap> <wrap>where </wrap>//<wrap>option </wrap>//<wrap>can be:</wrap> <wrap>ª%%__%%_§%%__%%_ ENABLE </wrap><wrap>¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§</wrap> <wrap>⡿%%__%%_ START </wrap><wrap>¬¬¬</wrap><wrap>_¯ ª%%__%%_ REGINA </wrap><wrap>¬¬¬«</wrap> <wrap>⡿%%__%%_ OOREXX %%__%%_</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 140</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>ª</wrap><wrap>%%__%%_§%%__%%_DISABLE </wrap><wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿%%__%%</wrap><wrap>¬¬ </wrap><wrap>STOP </wrap><wrap>¬¬¬¬</wrap><wrap>_</wrap> <wrap>~¬¬¬ </wrap>//<wrap>delimiter </wrap>//<wrap>¬¬¬®</wrap> <wrap>ª</wrap><wrap>%%__%%_§%%__%%%%__%%_PATHS </wrap><wrap>¬¬¬¬¬1¬¬¬1¬¬¬</wrap><wrap>°%%__%%%%__%% </wrap>//<wrap>path </wrap>//<wrap>¬¬¬¬¬¬¬</wrap><wrap>¨</wrap><wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%_ REXXPATHS %%__%%_¯ ⡿%%__%%%%__%%%%__%%%%__%%RESET %%__%%%%__%%%%__%%%%__%%%%__%%¯</wrap> <wrap>I</wrap><wrap>%%__%%_ SYSPATH </wrap><wrap>¬¬¬1¬¬¬¬ </wrap><wrap>ON </wrap><wrap>¬¬¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%% </wrap><wrap>OFF ¬¬¬¬«</wrap> <wrap>⡿%%__%%_ RESET %%__%%_</wrap> <wrap>~¬¬¬ </wrap>//<wrap>delimiter </wrap>//<wrap>¬¬¬®</wrap> <wrap>ª%%__%%_§%%__%%_ EXTENSIONS </wrap><wrap>¬¬¬1¬¬¬1¬¬¬</wrap><wrap>°%%__%%%%__%% </wrap>//<wrap>suffix </wrap>//<wrap>¬¬¬¬¬</wrap><wrap>¨</wrap><wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%%%__%% SUFFIXES %%__%%%%__%%¯ ⡿%%__%%%%__%%%%__%%%%__%%_RESET %%__%%%%__%%%%__%%%%__%%_¯</wrap> <wrap>I%%__%%_ RESOLVER </wrap><wrap>¬¬¬1¬¬¬¬ </wrap><wrap>ON </wrap><wrap>¬¬¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%% </wrap><wrap>OFF ¬¬¬¬«</wrap> <wrap>⡿%%__%%_ RESET %%__%%_¯</wrap> <wrap>I</wrap><wrap>%%__%%_ MSGLEVEL </wrap><wrap>¬¬¬1¬¬¬¬¬ </wrap><wrap>0 </wrap><wrap>¬¬¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%%_ </wrap><wrap>' ¬¬¬¬¬«</wrap> <wrap>⡿%%__%%_ RESET %%__%%_¯</wrap> <wrap>[%%__%%_ MSGPREFIX </wrap><wrap>¬¬¬1¬¬¬ </wrap>//<wrap>messageprefix </wrap>//<wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%%%%__%%%%__%%</wrap><wrap>OFF ¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%%%__%%%%__%%_RESET %%__%%%%__%%%%__%%_¯</wrap> <wrap>[%%__%%_ ERRPREFIX </wrap><wrap>¬¬¬1¬¬¬ </wrap>//<wrap>errorprefix </wrap>//<wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%%%%__%%_ </wrap><wrap>OFF ¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%%%__%%%%__%%RESET %%__%%%%__%%%%__%%¯</wrap> <wrap>F%%__%%_ MODE </wrap><wrap>¬¬¬1¬¬¬¬ </wrap><wrap>COMMAND </wrap><wrap>¬¬¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%_ SUBROUTINE%%__%%_¯</wrap> **//<wrap>5.64.3 Parameter</wrap>//** **<wrap>ENABLE </wrap>**<wrap>Enables the Rexx environment that is specified as argument (Regina or ooRexx). This option is only available if Hercules is built with support for both Regina and ooRexx and cannot be used in a single Rexx environment.</wrap> <wrap>If no environment is given as argument then the default Rexx environment (ooRexx) is started. ENABLE can be abbreviated as ‘ENA’.</wrap> **<wrap>START </wrap>**<wrap>This is the same as ENABLE. START can be abbreviated as ‘STA’.</wrap> **<wrap>DISABLE </wrap>**<wrap>Disables the currently active Rexx environment. This option is only available if Her-</wrap><wrap></wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 141</wrap> <wrap>\\ </wrap><wrap>cules is built with support for both Regina and ooRexx and cannot be used in a single Rexx environment.</wrap> <wrap>DISABLE can be abbreviated as ‘DIS’.</wrap> **<wrap>STOP </wrap>**<wrap>This is the same as DISABLE. STOP can be abbreviated as ‘STO’.</wrap> **<wrap>REGINA </wrap>**<wrap>Given as argument to the ‘START’ or ‘ENABLE’ options, REGINA specifies that the Regina Rexx environment has to be started.</wrap> **<wrap>OOREXX </wrap>**<wrap>Given as argument to the ‘START’ or ‘ENABLE’ option, OOREXX specifies that the Open Object Rexx (ooRexx) environment has to be started.</wrap> **<wrap>PATHS </wrap>**<wrap>This is the keyword for specifying the search path(s) for the Rexx scripts. PATHS can be abbreviated as ‘PATH’.</wrap> **<wrap>REXXPATHS </wrap>**<wrap>This is the same as PATHS. REXXPATHS can be abbreviated as ‘REXXP’.</wrap> **//<wrap>path </wrap>//**<wrap>A path (or a list of paths, separated by a delimiter) in which Rexx executables will be searched. If the path is not specified when activating the Rexx environment then the default used is the current path taken from the environment variable ‘PATH’.</wrap> **<wrap>SYSPATH </wrap>**<wrap>Keyword for specifying, if the search for the Rexx executables should be extended to the system paths (when set to on ‘ON’) or if it should be limited to the defined PATHS / REXXPATHS (when set to ‘OFF’).</wrap> <wrap>SYSPATH is set to “ON” if not overwritten through the REXX system parameter in the configuration file or changed later on with the REXX console command.</wrap> **<wrap>EXTENSIONS </wrap>**<wrap>This is the keyword for specifying the filename extension(s) to be used to search the Rexx executables. EXTENSIONS can be abbreviated as ‘EXT’.</wrap> <wrap>If a given script name is in the format //filename.extension //then it is used as is without any further processing.</wrap> **<wrap>SUFFIXES </wrap>**<wrap>This is the same as EXTENSIONS. SUFFIXES can be abbreviated as ‘SUF’.</wrap> **//<wrap>suffix </wrap>//**<wrap>A filename extension (or a list of filename extensions, separated by a delimiter) that identifies a Rexx executable. A filename extension must be specified in the format “.//ext//”.</wrap> <wrap>If there are no extensions specified the defaults used are ‘.REXX’, ‘.rexx’, ‘.REX’, ‘.rex’, ‘.CMD’, ‘.cmd’, ‘.RX’ and ‘.rx’.</wrap> **//<wrap>delimiter </wrap>//**<wrap>This is the delimiter used for separating multiple paths or multiple extensions. For Linux and Mac OS-X systems this is the colon (“:”), for Windows systems it is the semicolon (“;”).</wrap> **<wrap>RESOLVER </wrap>**<wrap>Keyword to define who will resolve the script name.</wrap> <wrap>When set to “ON” then the Hercules Rexx interface will resolve the script name and issue appropriate messages in case the process fails. When set to ‘OFF’ then the script name will be passed as is to the Rexx interpreter.</wrap> <wrap>RESOLVER is set to ‘ON’ if not overwritten through the REXX system parameter in the configuration file or changed later on with the REXX console command.</wrap> **<wrap>MSGLEVEL </wrap>**<wrap>This is the keyword for specifying the message level to be used. MSGLEVEL can</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 142</wrap> <wrap>\\ </wrap><wrap>be abbreviated as ‘MSGL’.</wrap> **<wrap>0 </wrap>**<wrap>Disables the display of the HHC17503I and HHC17504I messages. This is the default, if not explicitely set through the MSGLEVEL parameter.</wrap> **<wrap>1 </wrap>**<wrap>Enables the display of the HHC17503I and HHC17504I messages when a script has finished:</wrap> <wrap>HHC17503I REXX(//package name//) Exec/Script '//script name//' RetRC(0) HHC17504I REXX(//package name//) Exec/Script '//script name//' RetValue'0'</wrap> **<wrap>MSGPREFIX </wrap>**<wrap>This is the keyword used to set the prefix for standard messages (issued through ‘say’). MSGPREFIX can be abbreviated as ‘MSGP’. There is no message prefix set, unless exlicitely specified with the MSGPREFIX parameter.</wrap> **//<wrap>msgprefix </wrap>//**<wrap>Specifies the Rexx standard message prefix to be used. //msgprefix //can be any string up to 9 characters. Embedded blanks are not allowed.</wrap> **<wrap>ERRPREFIX </wrap>**<wrap>This is the keyword used to set the prefix for error messages. ERRPREFIX can be abbreviated as ‘ERRP’. There is no error prefix set, unless exlicitely specified with the ERRPREFIX parameter.</wrap> **//<wrap>errorprefix </wrap>//**<wrap>Specifies the Rexx error message prefix to be used. //errorprefix //can be any string up to 9 characters. Embedded blanks are not allowed.</wrap> **<wrap>MODE </wrap>**<wrap>This is the keyword used to specify the argument passing style to a Rexx script. If not explicitely specified, MODE is set to command style (‘COMMAND’).</wrap> **<wrap>COMMAND </wrap>**<wrap>Specifies command style for passing arguments to a Rexx script. ‘COMMAND’ may be abbreviated as ‘COM’.</wrap> **<wrap>SUBROUTINE </wrap>**<wrap>Specifies subroutine style for passing arguments to a Rexx script. ‘SUBROUTINE’ may be abbreviated as ‘SUB’.</wrap> **<wrap>ON </wrap>**<wrap>Activates the specified option.</wrap> **<wrap>OFF </wrap>**<wrap>Deactivates the specified option.</wrap> **<wrap>RESET </wrap>**<wrap>Given as an argument to one of the options of the Rexx command this will reset the corresponding value to the default settings.</wrap> **//<wrap>5.64.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Enable ooRexx, set the filename extensions to be used to “.REXX” and “.REX” and set subroutine style for passing arguments to the Rexx script.</wrap> <wrap>REXX ENABLE OOREXX</wrap> <wrap>REXX EXTENSIONS .REXX;.REX</wrap> <wrap>REXX MODE SUBROUTINE</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 143</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Enable Regina Rexx and set the search path for the Rexx scripts to “D:%%\%%MVS%%\%%SCRIPTS”, but disable the search in the system path. Set the filename extensions to be used for the Rexx scripts to “.REXX”, “.REX” and “.RX”.</wrap> <wrap>Finally set the message and error prefixes to RXMSG and RXERR and enable displaying the HHC17503I and HHC17504I messages after a Rexx script has been finished.</wrap> <wrap>Use the default setting for the argument passing style.</wrap> <wrap>REXX ENABLE REGINA</wrap> <wrap>REXX PATH </wrap>[[file:///D:/MVS/SCRIPTS|<wrap>D:%%\%%MVS%%\%%SCRIPTS</wrap>]]<wrap></wrap> <wrap>REXX SYSPATH OFF</wrap> <wrap>REXX EXTENSIONS .REXX;.REX;.RX</wrap> <wrap>REXX MSGLEVEL 1</wrap> <wrap>REXX MSGPREF RXMSG</wrap> <wrap>REXX ERRPREF RXERR</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 144</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.65 SCLPROOT (SCLP base directory) \\ //5.65.1 Function//</wrap>** <wrap>The SCLPROOT system parameter sets the SCLP base directory. If a directory is given then SCLP disk I/O for the specified directory path is enabled. NONE disables SCLP disk I/O.</wrap> <wrap>A subsequent list-directed IPL resets the path to the location of the .ins file, and a subsequent CCW-type IPL disables SCLP disk I/O.</wrap> **//<wrap>5.65.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SCLPROOT (</wrap>__<wrap>NONE</wrap>__<wrap> | </wrap>//<wrap>directory</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SCLPROOT ¬¬¬§¬¬¬¬¬ </wrap>__<wrap>NONE</wrap>__<wrap> ¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>⡿¬¬¬</wrap>//<wrap>directory </wrap>//<wrap>¬¬¬¯</wrap> **//<wrap>5.65.3 Parameter</wrap>//** **<wrap>NONE </wrap>**<wrap>Disables SCLP disk I/O.</wrap> **//<wrap>directory </wrap>//**<wrap>Specifies the directory from which SCLP disk I/O is allowed. A subsequent IPL of an “.ins” file or a subsequent CCW-type IPL will override this.</wrap> **//<wrap>5.65.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Disable SCLP disk I/O.</wrap> <wrap>SCLPROOT NONE</wrap> **<wrap>Example 2:</wrap>** <wrap>Specifies “D:%%\%%SCLP%%\%%DISK” as the directory from which SCLP disk I/O is allowed.</wrap> <wrap>SCLPROOT </wrap>[[file:///D:/SCLP/DISK|<wrap>D:%%\%%SCLP%%\%%DISK</wrap>]]<wrap></wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 145</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.66 SCPECHO (Echo to console and history of SCP replies) //5.66.1 Function//</wrap>** <wrap>SCPECHO allows it to route the SPC ('.') and priority SCP ('!') replies and responses to the Hercules console. The default is on (echo to the console) if SCPECHO is not coded.</wrap> **//<wrap>5.66.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SCPECHO (</wrap><wrap>OFF </wrap><wrap>| </wrap>__<wrap>ON</wrap>__<wrap>}</wrap>__<wrap></wrap>__ **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_SCPECHO </wrap><wrap>¬¬¬§¬¬¬ OFF_ </wrap> <wrap>L%%__%%_ ON</wrap> </WRAP> | **//<wrap>5.66.3 Parameter</wrap>//** **<wrap>OFF </wrap>**<wrap>Do not route the SPC and priority SCP replies and responses to the Hercules console. This is the default, if SCPECHO is not coded in the configuration file.</wrap> **<wrap>ON </wrap>**<wrap>Route the SPC and priority SCP replies and responses to the Hercules console.</wrap> **//<wrap>5.66.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Route SPC and priority SCP replies and responses to the Hercules console.</wrap> <wrap>SCPECHO ON</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 146</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.67 SCPIMPLY (Pass non-Hercules commands to the SCP) //5.67.1 Function//</wrap>** <wrap>SCPIMPLY allows it to pass all non-Hercules commands (commands unknown to Hercules) to the SPC if the SCP has enabled receipt of SCP commands. The default is off (no passing of unknown commands) if SCPIMPLY is not coded.</wrap> <wrap>An example: The command "ping" is an unknown Hercules command. If the SCP running is SLES z/Linux then the ping would be sent as console input to SLES just as if the command has been prefixed with a '.' (period).</wrap> **//<wrap>5.67.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SCPIMPLY (</wrap>__<wrap>OFF</wrap>__<wrap> | ON}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SCPIMPLY </wrap><wrap>¬¬¬§¬¬¬ </wrap>__<wrap>OFF</wrap>__<wrap>_ </wrap> <wrap>i¬¬¬ </wrap><wrap>O</wrap><wrap>N</wrap> </WRAP> | **//<wrap>5.67.3 Parameter</wrap>//** **<wrap>OFF </wrap>**<wrap>Do not pass non-Hercules commands to the SCP. This is the default, if SCPIMPLY is not coded in the configuration file.</wrap> **<wrap>ON </wrap>**<wrap>Pass all non-Hercules commands to the SCP if the SCP has enabled receipt of SCP commands.</wrap> **//<wrap>5.67.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Pass non-Hercules commands to the SCP.</wrap> <wrap>SCPIMPLY ON</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 147</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.68 SCSIMOUNT (Automatic SCSI tape mounts) \\ //5.68.1 Function//</wrap>** <wrap>The SCSIMOUNT parameter specifies whether automatic detection of SCSI tape mounts is enabled or not.</wrap> **<wrap>NOTE! </wrap>**<wrap>Enabling this option may negatively impact Hercules performance depending on how the host operating system (Windows, Linux etc.) handles SCSI attached tape drive status queries.</wrap> **//<wrap>5.68.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SCSIMOUNT (__NO__ | YES | </wrap>//<wrap>secs</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SCSIMOUNT ¬¬¬i¬¬¬ __NO__</wrap><wrap> ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬YES </wrap><wrap>¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>secs </wrap>//<wrap>¬¬¬</wrap> **//<wrap>5.68.3 Parameter</wrap>//** **<wrap>NO </wrap>**<wrap>NO indicates that the SCSIMOUNT option is disabled, forcing all SCSI tape mounts to be done manually via an appropriate DEVINIT command.</wrap> **<wrap>YES </wrap>**<wrap>Yes enables the option and causes periodic queries of the SCSI tape drive in a five second interval to automatically detect when a tape is mounted. YES is equivalent with “SCSIMOUNT 5”.</wrap> **//<wrap>secs </wrap>//**<wrap>A value from 1 to 99 seconds (inclusive) enables this option and causes periodic queries of the SCSI tape drive to automatically detect if a tape is mounted.</wrap> **//<wrap>5.68.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Enable automatic detection of SCSI tape mounts and set the periodic queries of the SCSI tape drive to a 30 seconds interval.</wrap> <wrap>AUTO_SCSI_MOUNT 30</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 148</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.69 SHCMDOPT (Shell command option) \\ //5.69.1 Function//</wrap>** <wrap>The SHCMDOPT system parameter defines the behaviour of the shell (sh) command. It specifies if shell commands (sh) are globally enabled or disabled either directly via the Hercules hardware console or programmatically via the DIAG8CMD interface.</wrap> **//<wrap>5.69.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>SHCMD0PT (DISABLE | </wrap>****__<wrap>ENABLE</wrap>__****<wrap> [</wrap>****__<wrap>DIAG8</wrap>__****<wrap> | N0DIAG8</wrap>****<wrap>]</wrap>****<wrap>}</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬SHCMD0PT ¬¬¬§¬¬¬ DISABLE¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>****<wrap>§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>** **<wrap>I ~¬¬¬¬ </wrap>****__<wrap>DIAG8</wrap>__****<wrap> ¬¬¬¬® \\ ⡿¬¬¬</wrap>****__<wrap>ENABLE</wrap>__****<wrap> ¬¬¬</wrap>****<wrap>I</wrap>****<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>****<wrap>¦¬¬¬¯</wrap>** **<wrap>i</wrap>****<wrap>¬¬¬ </wrap>****<wrap>N0DIAG8 </wrap>****<wrap>¬¬¬</wrap>****<wrap>¯</wrap>** **//<wrap>5.69.3 Parameter</wrap>//** **<wrap>DISABLE </wrap>**<wrap>When set to DISABLE, shell commands (sh) are globally disabled and will result in an error if entered either directly via the Hercules hardware console or programmatically via the DIAG8CMD interface.</wrap> **<wrap>ENABLE </wrap>**<wrap>When set to ENABLE, shell commands (sh) are globally enabled either directly via the Hercules hardware console or programmatically via the DIAG8CMD interface. This is the default.</wrap> **<wrap>DIAG8 </wrap>**<wrap>When DIAG8 is specified (which is the default) the programmatic execution of shell commands (sh) via the DIAG8CMD interface is enabled. This is the default.</wrap> **<wrap>NODIAG8 </wrap>**<wrap>When NODIAG8 is specified only the programmatic execution of shell commands via the DIAG8CMD interface is disabled; shell commands (sh) entered directly via the Hercules hardware console will still work.</wrap> **<wrap>NOTE: </wrap>**//<wrap>"entered directly via the Hercules hardware console" </wrap>//<wrap>includes commands entered via the HTTP server facility or entered via "run command" (.rc) scripts.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 149</wrap> <wrap>\\ </wrap>**//<wrap>5.69.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Disable the programmatic execution of shell commands via the diagnose 8 interface but allow shell commands entered directly via the Hercules hardware console.</wrap> <wrap>SHCMDOPT ENABLE NODIAG8</wrap> **<wrap>Example 2:</wrap>** <wrap>Globally disable the execution of shell commands.</wrap> <wrap>SHCMDOPT DISABLE</wrap> **<wrap>Example 3:</wrap>** <wrap>Globally enable the execution of shell commands.</wrap> <wrap>SHCMDOPT ENABLE DIAG8</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 150</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.70 SHOWDVOL1 (Enable showing of DASD volsers in device list) //5.70.1 Function//</wrap>** <wrap>SHOWDVOL1 indicates whether to show the DASD VOL1 labels (volser) in the device list display. 'YES' shows the volser in addition to the usual filename, whereas 'NO' shows the device list in a traditional filename only format. The 'ONLY' option shows only the volser; the filename is not shown at all. The default is 'NO', which results in a traditional device list display. Note: This system parameter is only available if Hercules is built with “OPTION_SHOWDVOL1”.</wrap> **//<wrap>5.70.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SHOWDVOL1 (__NO__ | YES | ONLY}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>SHOWDVOL1 </wrap><wrap>¬¬¬§¬¬¬ </wrap>__<wrap>NO</wrap>__<wrap> ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>I_</wrap><wrap>¬¬ </wrap><wrap>YES </wrap><wrap>¬¬¬¬«</wrap> <wrap>L%%__%%_ ONLY %%__%%_¯</wrap> **//<wrap>5.70.3 Parameter</wrap>//** **<wrap>NO </wrap>**<wrap>NO shows the device list in the traditional filename only format. This is the default.</wrap> **<wrap>YES </wrap>**<wrap>YES shows the volser in addition to the usual filename.</wrap> **<wrap>ONLY </wrap>**<wrap>ONLY shows only the volser, the filename is not shown at all.</wrap> **//<wrap>5.70.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Show the DASD VOL1 labels (volser) in the device list.</wrap> <wrap>SHOWDVOL1 YES</wrap> **<wrap>Example 2:</wrap>** <wrap>Show only the DASD VOL1 labels (volser) in the device list, don’t show the filenames.</wrap> <wrap>SHOWDVOL1 ONLY</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 151</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.71 SHRDPORT (Shared device server port) \\ //5.71.1 Function//</wrap>** <wrap>SHRDPORT defines the port number (in decimal) on which the shared device server will listen. The shared device server will allow other Hercules instances to access devices on this instance. Currently only DASD devices may be shared. The default port is 3990. If you decide to use a different port number then you must specify this port number on the device statements for the other Hercules instances. If no SHRDPORT statement is present then the shared device server thread will not be activated.</wrap> **//<wrap>5.71.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SHRDPORT (__3990__ | </wrap>//<wrap>port </wrap>//<wrap>| START | STOP}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SHRDPORT ¬¬¬§¬¬¬ __3990__</wrap>//<wrap> ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>// <wrap>ª¬¬- </wrap>//<wrap>port ¬¬¬¬«</wrap>// <wrap>ª¬¬¬ START </wrap>//<wrap>¬¬¬«</wrap>// <wrap>⡿¬¬¬ STOP </wrap>//<wrap>¬¬</wrap>//<wrap>¬¬¯</wrap> **//<wrap>5.71.3 Parameter</wrap>//** **<wrap>3990 </wrap>**<wrap>This is the default port for the shared device server. If this port number is used then the port number is not required to be coded on the device statements for other Hercules instances.</wrap> **//<wrap>port </wrap>//**<wrap>Any valid port number.</wrap> **<wrap>START </wrap>**<wrap>Start the shared device server thread.</wrap> **<wrap>STOP </wrap>**<wrap>Stop the shared device server thread.</wrap> **//<wrap>5.71.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify 3990 as the port used for the shared device server and start the shared device server thread.</wrap> <wrap>SHRDPORT 3990 \\ SHAREDPORT START \\ or</wrap> <wrap>SHRDPORT 3990</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 152</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Specify 3990 as the port used for the shared device server, but do not start the shared device server thread upon Hercules startup so that it can be started later on manually through the SHRDPORT console command.</wrap> <wrap>SHRDPORT 3990 \\ SHRDPORT STOP</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 153</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.72 SRVPRIO (Server threads priority) \\ //5.72.1 Function//</wrap>** <wrap>The SRVPRIO parameter specifies the priority of the server threads. See section 5.82 “Process and Thread Priorities” for details.</wrap> **<wrap>Caution: </wrap>**<wrap>SRVPRIO should not have a higher dispatching priority than the TOD clock and timer thread.</wrap> **//<wrap>5.72.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>SRVPRI0 (</wrap><wrap>4 </wrap><wrap>| </wrap>//<wrap>nn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>SRVPRI0 ¬¬¬§¬¬¬ </wrap><wrap>4 </wrap> <wrap>⡿¬¬¬</wrap>//<wrap>nn</wrap>// **//<wrap>5.72.3 Parameter</wrap>//** **<wrap>4 </wrap>**<wrap>Specifies a server threads process priority of 4. This is the default</wrap> **//<wrap>nn </wrap>//**<wrap>This value specifies the process priority for the server threads. For details on the priority values see section 5.82 (“Process and Thread Priorities”). The default is 4.</wrap> **//<wrap>5.72.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the server threads process priority to 0.</wrap> <wrap>HERCPRIO 0</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 154</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.73 SYMPTOM (Instruction trace display option) \\ //5.73.1 Function//</wrap>** <wrap>This parameter specifies the initial architecture mode. SYMPTOM is an alias for the TRACEOPTsystem parameter. Please see TRACEOPT for details.</wrap> **//<wrap>5.73.2 Syntax</wrap>//** <wrap>See TRACEOPT system parameter.</wrap> **//<wrap>5.73.3 Parameter</wrap>//** <wrap>See TRACEOPT system parameter.</wrap> **//<wrap>5.73.4 Examples</wrap>//** <wrap>See TRACEOPT system parameter.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 155</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.74 SYSEPOCH (Base date for TOD clock) \\ //5.74.1 Function//</wrap>** <wrap>SYSEPOCH specifies the base date for the TOD clock. Use the default value (1900) for all systems except OS/360. Use 1960 for OS/360. Values other than these were formerly used to offset the TOD clock by a number of years to move the date before the year 2000 for non-Y2K-compliant operating systems. This use is deprecated and support will be removed in a future Hercules release after which only values of 1900 or 1960 will be accepted.</wrap> **//<wrap>5.74.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SYSEP0CH (</wrap>__<wrap>1900</wrap>__<wrap> | 1960 | </wrap>//<wrap>year </wrap>//<wrap>[</wrap>//<wrap>+years </wrap>//<wrap>| </wrap>//<wrap>-years</wrap>//<wrap>l}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SYSEP0CH ¬¬¬§¬¬¬ </wrap>__<wrap>1900</wrap>__<wrap> ¬¬¬¬¬¬¬¬¬¬¬¬¬¬ </wrap><wrap>ª</wrap><wrap>¬¬¬ </wrap><wrap>1960 </wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬ </wrap><wrap>⡿¬¬¬</wrap>//<wrap>year </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬</wrap> <wrap>ª¬¬¬</wrap><wrap>+</wrap>//<wrap>years</wrap>// <wrap>⡿¬¬¬</wrap><wrap>-</wrap>//<wrap>years</wrap>// **//<wrap>5.74.3 Parameter</wrap>//** **<wrap>1900 </wrap>**<wrap>Year 1900 is one of the two valid values for SYSEPOCH. 1900 is the default.</wrap> **<wrap>1960 </wrap>**<wrap>Year 1960 is the second of the two valid values for SYSEPOCH.</wrap> **//<wrap>year </wrap>//**<wrap>This is the base date for the TOD clock. The only supported values for SYSEPOCH are currently 1900 and 1960. Any other value will produce a warning message showing the equivalent values to specify in the SYSEPOCH statement. 1900 is the default.</wrap> **<wrap>+ //years //</wrap>**<wrap>Specifies an optional positive year offset. It will be treated as though it had been specified using the YROFFSET statement.</wrap> **<wrap>- //years //</wrap>**<wrap>Specifies an optional negative year offset. It will be treated as though it had been specified using the YROFFSET statement.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 156</wrap> <wrap>\\ </wrap>**//<wrap>5.74.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify year 1900 as the base date for the TOD clock.</wrap> <wrap>SYSEPOCH 1900</wrap> **<wrap>Example 2:</wrap>** <wrap>Specify a positive year offset of 20 years to the default of 1900.</wrap> <wrap>SYSEPOCH +20</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 157</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.75 TIMERINT (Internal timer update interval) \\ //5.75.1 Function//</wrap>** <wrap>The TIMERINT parameter sets the internal timer update interval in microseconds. This parameter specifies how frequently Hercules's internal timers-update thread updates the TOD clock, CPU Timer and other architectural related clock/timer values.</wrap> <wrap>The default interval is 50 microseconds which strikes a reasonable balance between clock accuracy and overall host performance. The minimum allowed value is 1 microsecond and the maximum is 1,000,000 microseconds (one second).</wrap> **//<wrap>CAUTION: </wrap>//**//<wrap>While a lower TIMERINT value may help increase the accuracy of the guest's TOD clock and CPU Timer values it could also have severe negative impact on the overall performance of the host operating system. This is especially true when a low TIMERINT value is coupled with a high HERCPRIO and TODPRIO priority setting. Exercise extreme caution when choosing your desired TIMERINT in relationship to your chosen HERCPRIO and TODPRIO priority settings.</wrap>// **//<wrap>5.75.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>TIMERINT (__50__ | </wrap>//<wrap>interval</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_TIMERINT %%__%%</wrap><wrap>¬§¬¬¬¬¬¬ </wrap>__<wrap>50</wrap>__<wrap> ¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>L%%__%%_ </wrap>//<wrap>interval </wrap>//<wrap>%%__%%_¯</wrap> **//<wrap>5.75.3 Parameter</wrap>//** **//<wrap>interval </wrap>//**<wrap>Specifies the timer update interval in microseconds. The minimum allowed value for the interval is 1 microsecond and the maximum is 1'000'000 microseconds (one second.</wrap> <wrap>CAUTION: While a lower TIMERINT value may help increase the accuracy of the guest's TOD clock and CPU Timer values, it could also have severe negative impact on the overall performance of the host operating system. This is especially true when a low value is coupled with a high HERCPRIO and TODPRIO priority setting.</wrap> <wrap>Exercise extreme caution when choosing your desired TIMERINT in relationship to your chosen HERCPRIO and TODPRIO priority settings.</wrap> **//<wrap>interval </wrap>//**<wrap>Specifies the timer update interval in microseconds. The minimum allowed value for the interval is 1 microsecond and the maximum is 1,000,000 microseconds (one second).</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 158</wrap> <wrap>\\ </wrap>**//<wrap>5.75.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the timer update interval to 100 microseconds.</wrap> <wrap>TIMERINT 100</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 159</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.76 TODDRAG (TOD clock drag factor) \\ //5.76.1 Function//</wrap>** <wrap>TODDRAG specifies the TOD clock drag factor. This parameter can be used to slow down or speed up the TOD clock by a factor of //factor//. A significant slowdown can improve the performance of some operating systems which consume significant amounts of CPU time processing timer interrupts. A drag factor of 2.0 slows down the clock by 50%, a drag factor of 0.5 doubles the speed of the clock, a drag factor of 1.01 slows down the clock by 1% and 0.99 speeds up the clock by 1%.</wrap> **//<wrap>5.76.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>T000RAG (</wrap>__<wrap>1.000000</wrap>__<wrap> | </wrap>//<wrap>factor</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ T</wrap>//<wrap>000RAG </wrap>//<wrap>¬¬¬§¬¬¬ </wrap>//__<wrap>1.000000</wrap>__//<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>//<wrap>⡿¬¬¬¬</wrap>//<wrap>factor </wrap>//<wrap>¬¬¬¬¯</wrap> **//<wrap>5.76.3 Parameter</wrap>//** **//<wrap>factor </wrap>//**<wrap>The factor by which the TOD clock will be slowed down or sped up. The default factor is 1.000000.</wrap> **//<wrap>5.76.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Slow down the TOD clock by 50%.</wrap> <wrap>TODDRAG 2</wrap> **<wrap>Example 2:</wrap>** <wrap>Double the speed of the TOD clock.</wrap> <wrap>TODDRAG 0.5</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 160</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.77 TODPRIO (Timer thread process priority) \\ //5.77.1 Function//</wrap>** <wrap>With this parameter you can specify the priority of the TOD clock and the timer threads. See section 5.82 (“Process and Thread Priorities”) for details.</wrap> **<wrap>Caution: </wrap>**<wrap>TODPRIO should be given a dispatching priority equal to or higher than any other thread within Hercules (CPUPRIO, DEVPRIO, HERCPRIO, SRVPRIO).</wrap> **//<wrap>5.77.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>T0DPRI0 (</wrap>__<wrap>-</wrap>____<wrap>20</wrap>__<wrap> | </wrap>//<wrap>nn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬T0DPRI0 ¬¬¬</wrap><wrap>I</wrap><wrap>¬¬¬</wrap>__<wrap>-</wrap>____<wrap>20</wrap>__<wrap>%%__%% </wrap> <wrap>⡿¬¬¬</wrap>//<wrap>nn</wrap>// **//<wrap>5.77.3 Parameter</wrap>//** **<wrap>15 </wrap>**<wrap>Specifies a TOD clock process prority of -20. This is the default</wrap> **//<wrap>nn </wrap>//**<wrap>This value specifies the priority of the TOD clock and the timer thread. For details on the priority values see section 5.82 (“Process and Thread Priorities”). The default for TODPRIO is -20.</wrap> **//<wrap>5.77.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the priority of the TOD clock and the timer threads to -20.</wrap> <wrap>TODPRIO -20</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 161</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.78 TRACEOPT (Instruction trace display option) \\ //5.78.1 Function//</wrap>** <wrap>TRACEOPT sets the Hercules instruction tracing display option. In addition to the TRACEOPT system parameter there is also a corresponding TRACEOPT console command to dynamically display and/or update the current setting at any time.</wrap> **//<wrap>5.78.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>TRACEOPT (</wrap>__<wrap>TRADITIONAL</wrap>__<wrap> | REGSFIRST | NOREGS}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬TRACEOPT ¬¬¬§¬¬¬ </wrap>__<wrap>TRADITIONAL</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬¬REGSFIRST¬¬¬¬«</wrap> <wrap>⡿¬¬¬¬¬NOREGS¬¬¬¬¬¬</wrap> **//<wrap>5.78.3 Parameter</wrap>//** **<wrap>TRADITIONAL </wrap>**<wrap>TRADITIONAL (the default), displays the registers following the instruction about to be executed such that pressing enter (to execute the displayed instruction) then shows the next instruction to be executed followed by the updated registers display.</wrap> **<wrap>REGSFIRST </wrap>**<wrap>REGSFIRST displays the current register contents followed by the instruction about to be executed such that pressing enter (to execute the displayed instruction) then shows the updated registers followed by the next instruction to be executed.</wrap> **<wrap>NOREGS </wrap>**<wrap>NOREGS suppresses the registers display altogether and shows just the instruction to be executed.</wrap> **//<wrap>5.78.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the tracing display option to display the registers following the instruction about to be executed.</wrap> <wrap>TRACEOPT TRADITIONAL</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 162</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.79 TZOFFSET (TOD clock offset from GMT) \\ //5.79.1 Function//</wrap>** <wrap>TZOFFSET is used to define the offset of the TOD clock from the current system time. For GMT use the default value (0000). For time zones west of Greenwich specify a negative value (example: -0500 for US Eastern Standard Time, -0800 for US Pacific Standard Time). For time zones east of Greenwich, specify a positive value (example: +0100 for Central European Time, +0930 for South Australian Time).</wrap> **//<wrap>5.79.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>TZ0FFSET (__0000__ | </wrap>//<wrap>+hhmm </wrap>//<wrap>| </wrap>//<wrap>-hhmm</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_TZ0FFSET %%__%%_i%%__%%_ __0000__</wrap><wrap> ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>i%%__%%_ </wrap>//<wrap>+hhmm </wrap>//<wrap>¬¬¬«</wrap> <wrap>L%%__%%_ </wrap>//<wrap>-hhmm </wrap>//<wrap>%%__%%_</wrap> **//<wrap>5.79.3 Parameter</wrap>//** **<wrap>0000 </wrap>**<wrap>GMT time (0000 is the default value). Please note that this is also the correct setting if your system time (the time of the operating system on which Hercules is running) is set to local time rather than GMT.</wrap> **//<wrap>hhmm </wrap>//**<wrap>Use a positive time in hours and minutes for time zones east of Greenwich.</wrap> **//<wrap>hhmm </wrap>//**<wrap>Use a negative time in hours and minutes for time zones west of Greenwich.</wrap> **//<wrap>5.79.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the offset of the TOD clock from the current system time to Central European Time.</wrap> <wrap>TZOFFSET +0100</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 163</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.80 XPNDSIZE (Expanded storage size) \\ //5.80.1 Function//</wrap>** <wrap>XPNDSIZE specifies the expanded storage size. Storage is allocated in megabytes, unless a specific unit is specified. The actual upper limit of the expanded storage is determined by the host system's architecture, operating system, and on some systems the amount of physical memory and paging space you have available. The lower limit is 0.</wrap> <wrap>The practical limit depends on the maximum amount of storage that can be obtained by “malloc” (usually around 1 GB on 32-bit platforms; on 64-bit platforms the value should only be limited by available paging space).</wrap> <wrap>An additional optional argument determines the locking state of the allocated memory (page lock by host operating system). The LOCKED option indicates that the memory is to be locked into storage while UNLOCKED (the default) indicates that the memory is not locked into the storage.</wrap> <wrap>Please note that Hercules preserves the last locking state of XPNDSIZE. Once storage is locked, any subsequent change to the expanded storage size will honor the existing lock state of memory unless the lock state is specified again on the XPNDSIZE command.</wrap> **<wrap>Caution: </wrap>**<wrap>Do not lock expanded storage unless sufficient real memory is available to back up the request. Failure to do so may require the host system to be rebooted.</wrap> **//<wrap>5.80.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>XPNDSIZE </wrap>//<wrap>xsize</wrap>//<wrap>[M | G | T] [</wrap>__<wrap>UNLOCK</wrap>__<wrap> | LOCK]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬ M¬¬¬® ~¬¬¬ UNLOCK¬¬¬®</wrap> <wrap>ÊÊ¬¬¬ XPNDSIZE ¬¬¬¬ </wrap>//<wrap>xsize </wrap>//<wrap>¬¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ G ¬¬¬« ⡿¬¬¬¬LOCK ¬¬¬¬¯</wrap> <wrap>⡿¬¬¬</wrap> <wrap>T ¬¬¬¯</wrap> **//<wrap>5.80.3 Parameter</wrap>//** **//<wrap>size </wrap>//**<wrap>The value of //xsize //must be a valid decimal number. The actual upper limit is determined by the host system’s architecture, the operating system and on some systems the amount of physical memory and paging space that is available.</wrap> <wrap>Storage sizes not on a 1M boundary are rounded up to the next 1M boundary. The lower limit and default is 0.</wrap> **<wrap>M </wrap>**<wrap>‘M’ determines that the number given is specified in megabytes (multiplier 2%%**%%20). This is the default if no unit is appended.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 164</wrap> <wrap>\\ </wrap>**<wrap>G </wrap>**<wrap>‘G’ determines that the number given is specified in gigabytes (multiplier 2%%**%%30).</wrap> **<wrap>T </wrap>**<wrap>‘T’ determines that the number given is specified in terabytes (multiplier 2%%**%%40). On 32-bit machines the unit terabytes is not available.</wrap> **<wrap>LOCK </wrap>**<wrap>Attempt to lock the storage (pages locked by the host operating system).</wrap> **<wrap>UNLOCK </wrap>**<wrap>Leave the store unlocked (no pages locked by the host operating system). This is the default.</wrap> **<wrap>Notes:</wrap>** <wrap>The actual upper limit is determined by the host system’s architecture and operating system, the guest operating system and the amount of physical memory and available paging space.</wrap> <wrap>The total of MAINSIZE and XPNDSIZE on host systems with a 32-bit architecture will be limited to less than 4G; host systems with a 64-bit architecture will be limited to less than 16E.</wrap> <wrap>Use of storage sizes greater than supported by the guest operating system may generate incorrect results or error conditions within the guest operating system.</wrap> **//<wrap>5.80.4 Overview Storage Allocation Units</wrap>//** |<WRAP>**<wrap>Unit</wrap>** </WRAP> |<WRAP>**<wrap>Multiplier</wrap>** </WRAP> |<WRAP>**<wrap>Name (Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>IEC Name (IEC Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>Restrictions</wrap>** </WRAP> | |<WRAP><wrap>M</wrap> </WRAP> |<WRAP><wrap>2%%**%%20</wrap> </WRAP> |<WRAP><wrap>Megabyte (MB)</wrap> </WRAP> |<WRAP><wrap>Mebibyte (MiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>G</wrap> </WRAP> |<WRAP><wrap>2%%**%%30</wrap> </WRAP> |<WRAP><wrap>Gigabyte (GB)</wrap> </WRAP> |<WRAP><wrap>Gibibyte (GiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>T</wrap> </WRAP> |<WRAP><wrap>2%%**%%40</wrap> </WRAP> |<WRAP><wrap>Terabyte (TB)</wrap> </WRAP> |<WRAP><wrap>Tebibyte (TiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | **<wrap>Table 7: Storage Allocation Units</wrap>** **//<wrap>5.80.5 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the size of the expanded storage to 256 MB. Do not lock the memory into the storage.</wrap> <wrap>XPNDSIZE 256</wrap> <wrap>or</wrap> <wrap>XPNDSIZE 256M</wrap> <wrap>or</wrap> <wrap>XPNDSIZE 256 UNLOCK</wrap> <wrap>or</wrap> <wrap>XPNDSIZE 256M UNLOCK</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 165</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the size of the expanded storage to 2 GB. Lock the memory into the storage.</wrap> <wrap>XPNDSIZE 2048 LOCK</wrap> <wrap>or</wrap> <wrap>XPNDSIZE 2G LOCK</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 166</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.81 YROFFSET (TOD clock offset from actual date) \\ //5.81.1 Function//</wrap>** <wrap>Specifies the number of years the TOD clock is offset from the actual date. Positive numbers will move the clock forward in time while negative numbers will move it backward. A common value for non-Y2K-compliant operating systems is YROFFSET -28 which has the advantage that the day of the week and the presence or absence of February 29 is the same as the current year.</wrap> **//<wrap>5.81.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>YROFFSET {</wrap>//<wrap>+years </wrap>//<wrap>| </wrap>//<wrap>-years</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_YROFFSET %%__%%_§%%__%%_ </wrap>//<wrap>+years ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>//<wrap>L%%__%%_ </wrap>//<wrap>-years </wrap>//<wrap>%%__%%_¯</wrap> **//<wrap>5.81.3 Parameter</wrap>//** **<wrap>+//years //</wrap>**<wrap>Specifies the number of years the TOD clock is offset positive from the actual date. This value may not be specified as greater than +/-142 years, the total range of the TOD clock. Specifying a value that causes the computed TOD clock year to be more than 142 years later than SYSEPOCH will produce unexpected results.</wrap> **<wrap>-//years //</wrap>**<wrap>Specifies the number of years the TOD clock is offset positive from the actual date. This value may not be specified as greater than +/-142 years, the total range of the TOD clock. Specifying a value that causes the computed TOD clock year to be earlier than the value of SYSEPOCH will produce unexpected results.</wrap> **//<wrap>5.81.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify 28 years to offset the TOD clock from the actual date.</wrap> <wrap>YROFFSET -28</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 167</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>5.82 Process and Thread Priorities</wrap>** <wrap>This section covers details regarding the priority settings within Hercules. The relevant system parameters are:</wrap> <wrap>·<wrap></wrap></wrap><wrap>CPUPRIO</wrap> <wrap>·<wrap></wrap></wrap><wrap>DEVPRIO</wrap> <wrap>·<wrap></wrap></wrap><wrap>HERCPRIO</wrap> <wrap>·<wrap></wrap></wrap><wrap>SRVPRIO</wrap> <wrap>·<wrap></wrap></wrap><wrap>TODPRIO</wrap> **//<wrap>5.82.1 Process Priorities</wrap>//** <wrap>Under Linux a process is a thread and thread priority information applies instead.</wrap> <wrap>For Windows the following conversions are used for translating Unix process priorities to Windows priority classes:</wrap> |<WRAP>**<wrap>Unix</wrap>** **<wrap>Process Priority</wrap>** </WRAP> |<WRAP>**<wrap>Windows \\ Priority Class</wrap>** </WRAP> |<WRAP>**<wrap>Meaning</wrap>** </WRAP> | |<WRAP><wrap>-20 to -16</wrap> </WRAP> |<WRAP><wrap>Realtime</wrap> </WRAP> |<WRAP><wrap>Process that has the highest possible priority. The threads of the process preempt the threads of all other processes, including operating system processes performing important tasks. For example, a real-time process that executes for more than a very brief interval can cause disk caches not to flush or cause the mouse to be unresponsive.</wrap> </WRAP> | |<WRAP><wrap>-15 to -9</wrap> </WRAP> |<WRAP><wrap>High</wrap> </WRAP> |<WRAP><wrap>Process that performs time-critical tasks that must be executed immediately. The threads of the process preempt the threads of normal or idle priority class processes. An example is the Task List, which must respond quickly when called by the user, regardless of the load on the operating system. Use extreme care when using the high-priority class, because a high-priority class application can use nearly all available CPU time.</wrap> </WRAP> | |<WRAP><wrap>-8 to -1</wrap> </WRAP> |<WRAP><wrap>Above Normal</wrap> </WRAP> |<WRAP><wrap>Process that has priority above the Normal class but below the High class.</wrap> </WRAP> | |<WRAP><wrap>0 to 7</wrap> </WRAP> |<WRAP><wrap>Normal</wrap> </WRAP> |<WRAP><wrap>Process with no special scheduling needs.</wrap> </WRAP> | |<WRAP><wrap>8 to 15</wrap> </WRAP> |<WRAP><wrap>Below Normal</wrap> </WRAP> |<WRAP><wrap>Process that has priority above the Idle class but below the Normal class.</wrap> </WRAP> | |<WRAP><wrap>16 to 20</wrap> </WRAP> |<WRAP><wrap>Low</wrap> </WRAP> |<WRAP><wrap>Process whose threads run only when the system is idle. The threads of the process are preempted by the threads of any process running in a higher priority class. An example is a screen saver. The idle-priority class is inherited by child processes.</wrap> </WRAP> | **<wrap>Table 8: Process Priority Conversions</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 168</wrap> <wrap>\\ </wrap>**<wrap>Caution: </wrap>**<wrap>On Windows, the value you choose for your process priority has a direct impact on how your thread priorities are interpreted! You should never modify one without understanding what impact you are doing so might have on the other!</wrap> **//<wrap>5.82.2 Thread Priorities</wrap>//** <wrap>On Linux/Unix hosts Hercules needs to be a setuid root program to allow it to reset its dispatching priority to a high (negative) value (i.e. “chown root.root hercules; chmod +s hercules”).</wrap> <wrap>For Windows the following conversions are used for translating Linux/Unix thread priorities to Windows thread priorities:</wrap> |<WRAP>**<wrap>Unix</wrap>** **<wrap>Thread Priority</wrap>** </WRAP> |<WRAP>**<wrap>Windows</wrap>** **<wrap>Thread Priority</wrap>** </WRAP> |<WRAP>**<wrap>Meaning</wrap>** </WRAP> | |<WRAP><wrap>-20 to -16</wrap> </WRAP> |<WRAP><wrap>Time Critical</wrap> </WRAP> |<WRAP><wrap>Base priority of 15 for Idle, Below Normal, Normal, Above Normal, or High class processes, and a base priority of 31 for Realtime class processes.</wrap> </WRAP> | |<WRAP><wrap>-15 to -9</wrap> </WRAP> |<WRAP><wrap>Highest</wrap> </WRAP> |<WRAP><wrap>Priority 2 points above the priority class.</wrap> </WRAP> | |<WRAP><wrap>-8 to -1</wrap> </WRAP> |<WRAP><wrap>Above Normal</wrap> </WRAP> |<WRAP><wrap>Priority 1 point above the priority class.</wrap> </WRAP> | |<WRAP><wrap>0 to 7</wrap> </WRAP> |<WRAP><wrap>Normal</wrap> </WRAP> |<WRAP><wrap>Normal priority for the priority class.</wrap> </WRAP> | |<WRAP><wrap>8 to 15</wrap> </WRAP> |<WRAP><wrap>Below Normal</wrap> </WRAP> |<WRAP><wrap>Priority 1 point below the priority class.</wrap> </WRAP> | |<WRAP><wrap>16 to 19</wrap> </WRAP> |<WRAP><wrap>Lowest</wrap> </WRAP> |<WRAP><wrap>Priority 2 points below the priority class.</wrap> </WRAP> | |<WRAP><wrap>20</wrap> </WRAP> |<WRAP><wrap>Idle</wrap> </WRAP> |<WRAP><wrap>Base priority of 1 for Idle, Below Normal, Normal, Above Normal, or High class processes, and a base priority of 16 for Realtime class processes.</wrap> </WRAP> | **<wrap>Table 9: Thread Priority Conversions</wrap>** **<wrap>Caution: </wrap>**<wrap>On Windows, your Thread Priority is interpreted differently based on your chosen Process Priority setting! You should never modify your Thread Priority settings without first reviewing your chosen Process Priority setting!</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 169</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap></wrap>**<wrap>6. Device Definition Descriptions</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>6.1 Local non-SNA 3270 Devices \\ //6.1.1 Function//</wrap>** <wrap>The local non-SNA 3270 device statements are used to define terminals to the Hercules configuration. There are no required arguments for this particular device type but there are several optional arguments that may be specified.</wrap> <wrap>To use this device a tn3270 client must connect to the host machine via the port number specified on the CNSLPORT statement. A valid tn3270 device type such as IBM-3278 must be used.</wrap> <wrap>If the tn3270 client software allows it to specify a device type suffix (e.g. //IBM-3278@GROUPNAME//) then the suffix can be used to connect to that specific device number, if defined. If no suffix is used then the tn3270 client will be connected to the first available and defined 3270 device.</wrap> <wrap>If a specific terminal device address is specified via the device type suffix of the tn3270 client software then it must be eligible to connect at that device address or the connection is immediately rejected. An alternative terminal device for which the tn3270 client might be eligible will not be automatically selected.</wrap> **//<wrap>6.1.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>//<wrap>[</wrap><wrap>{</wrap>//<wrap>groupname </wrap>//<wrap>| *} </wrap><wrap>[</wrap>//<wrap>ipaddr </wrap>//<wrap>[</wrap>//<wrap>mask</wrap>//<wrap>]]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype</wrap>// <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª</wrap><wrap>¬¬</wrap><wrap>¬¬¬¬¬ * ¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>groupname </wrap>//<wrap>¬¬¬¯ ⡿</wrap><wrap>¬¬¬ </wrap>//<wrap>ipaddr </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬</wrap><wrap>¬¬ </wrap>//<wrap>mask </wrap>//<wrap>¬¬</wrap><wrap>¬¯</wrap> **//<wrap>6.1.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid terminal device types are 3270 and 3278.</wrap> **//<wrap>groupname </wrap>//**<wrap>If a terminal group name is given on the device statement then a device type suffix with this group name can be used to indicate that a device in this group is to be</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 170</wrap> <wrap>\\ </wrap><wrap>used. If it is specified as a terminal type suffix (e.g. IBM-3278@GROUPNAME) and there are no devices defined with that group name or no available devices remaining in that group then the connection is rejected. If no group name is specified as a terminal type suffix then the connection will only be eligible to terminal devices which also have no group name specified.</wrap> <wrap>The terminal group name should be 1-8 alphanumeric characters in length, the first character being alphabetic and it should not be a hexadecimal number. Upper and lower case letters in the group name are considered to be equivalent.</wrap> **<wrap>* </wrap>**<wrap>The asterisk is used to indicate any terminal group name. It may be omitted if there are no additional arguments following the group name. If an IP address (and optionally mask) is specified and there is no specific group name desired then the asterisk must be coded to distinguish the terminal group name and the IP address arguments.</wrap> **<wrap>ipaddr [mask] </wrap>**<wrap>The optional IP address and subnet masks specify the IP address(es) at which client(s) are allowed to connect via the device address identified by the device statement. This provides an additional means of specifying which device(s) a client tn3270 session may connect to.</wrap> <wrap>If the IP address and mask (default 255.255.255.255 if not specified) of the tn3270 client attempting to connect match the IP address/mask entered on the device statement, then the client is eligible to connect at this device address. Otherwise the client is ineligible to connect at this device address and the next available device, if any, for which the client is eligible to connect, will be attempted.</wrap> <wrap>If no permissible terminal devices remain (terminal devices for which the client is eligible to connect) or there are no more available terminal devices then the client connection is rejected.</wrap> <wrap>The optional IP address and subnet mask may be specified in conjunction with the terminal group argument. In this case the terminal group argument must be specified ahead of the optional IP address and subnet mask arguments. To specify an IP address and a subnet mask without also specifying a terminal group use an asterisk (“*”) as the group name substitute or placeholder.</wrap> <wrap>If an IP address / mask are not specified then any client tn3270 session is allowed to connect to the device (provided they are also a member of the specified terminal group, if any).</wrap> <wrap>The terminal group name must match if specified, regardless of any optional IP address / mask. To summarize, the device number suffix always takes precedence over any group name and any group name always takes precedence over any IP address/mask value.</wrap> **//<wrap>6.1.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a 3270 device on device address 0200.</wrap> <wrap>0200 3270</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image030.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 171</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Define a 3270 device on device address 0200. Allow clients with any terminal group name but only from IP address 192.168.0.100 to connect.</wrap> <wrap>0200 3270 * 192.168.0.100</wrap> **<wrap>Example 3:</wrap>** <wrap>Define a 3270 device on device address 0200. Allow clients with any terminal group name but only from IP address 192.168.0.100 with subnet mask 255.255.255.0 to connect.</wrap> <wrap>0200 3270 * 192.168.0.100 255.255.255.0</wrap> **<wrap>Example 4:</wrap>** <wrap>Define a 3270 device on device address 0200. Allow only clients with terminal group name CONSOLE and from IP address 192.168.0.100 with subnet mask 255.255.255.0 to connect.</wrap> <wrap>0200 3270 CONSOLE 192.168.0.100 255.255.255.0</wrap> **<wrap>Example 5:</wrap>** <wrap>Define a 3270 device on device address 0200. Allow only clients with terminal group name TSOTERM to connect.</wrap> <wrap>0200 3270 TSOTERM</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 172</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.2 Integrated 3270 (SYSG) Console \\ //6.2.1 Function//</wrap>** <wrap>The integrated 3270 (SYSG) console is similar to a local non-SNA 3270 device, except that it is not addressed by a subchannel number and it is supported only by certain system control programs. The SYSG console is defined like a 3270 device except that the device type is SYSG and the device address is ignored. Only one SYSG console can be defined in a configuration.</wrap> <wrap>Use tn3270 client software to connect to the SYSG console device via the port number specified on the CNSLPORT statement, just as you would connect to a regular local non-SNA 3270 device.</wrap> <wrap>The SYSG console configuration statement recognizes optional arguments which specify group name and IP address in the same way as previously described for a local non-SNA 3270 device. These optional arguments provide a means to ensure that a given tn3270 client can connect directly to the SYSG console.</wrap> <wrap>If the group name and IP address arguments are not specified, then the SYSG console is considered to be a member of the general pool of devices eligible for connection to any incoming tn3270 client.</wrap> **//<wrap>6.2.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr </wrap>//<wrap>SYSG [{</wrap>//<wrap>groupname </wrap>//<wrap>| *} [</wrap>//<wrap>ipaddr </wrap>//<wrap>[</wrap>//<wrap>mask</wrap>//<wrap>]]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ SYSG¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap> <wrap>Ê</wrap><wrap>%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_ÊÍ</wrap> <wrap>ª</wrap><wrap>¬¬</wrap><wrap>%%__%%%%__%%_ * %%__%%%%__%%%%__%%_§%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_«</wrap> <wrap>⡿¬¬¬ </wrap>//<wrap>groupname </wrap>//<wrap>¬¬¬¯ ⡿</wrap><wrap>%%__%%_ </wrap>//<wrap>ipaddr </wrap>//<wrap>%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%«</wrap> <wrap>⡿¬</wrap><wrap>%%__%% </wrap>//<wrap>mask </wrap>//<wrap>%%__%%</wrap><wrap>¬¯</wrap> **//<wrap>6.2.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address. In the case of the integrated 3270 (SYSG) console this address is ignored.</wrap> **<wrap>SYSG </wrap>**<wrap>This is the device type. The only valid device type is SYSG.</wrap> **//<wrap>groupname </wrap>//**<wrap>If a terminal group name is given on the device statement then a device type suffix with this group name can be used to indicate that a device in this group is to be used. If it is specified as a terminal type suffix (e.g. IBM-3278@GROUPNAME) and there are no devices defined with that group name or no available devices remaining in that group then the connection is rejected. If no group name is specified as a</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 173</wrap> <wrap>\\ </wrap><wrap>terminal type suffix then the connection will only be eligible to terminal devices which also have no group name specified.</wrap> <wrap>The terminal group name should be 1-8 alphanumeric characters in length, the first character being alphabetic and it should not be a hexadecimal number. Upper and lower case letters in the group name are considered to be equivalent.</wrap> **<wrap>* </wrap>**<wrap>The asterisk is used to indicate any terminal group name. It may be omitted if there are no additional arguments following the group name. If an IP address (and optionally mask) is specified and there is no specific group name desired then the asterisk must be coded to distinguish the terminal group name and the IP address arguments.</wrap> **//<wrap>ipaddr </wrap>//****<wrap>[//mask//] </wrap>**<wrap>The optional IP address and subnet masks specify the IP address(es) at which client(s) are allowed to connect via the device address identified by the device statement. This provides an additional means of specifying which device(s) a client tn3270 session may connect to.</wrap> <wrap>If the IP address and mask (default 255.255.255.255 if not specified) of the tn3270 client attempting to connect match the IP address/mask entered on the device statement, then the client is eligible to connect at this device address. Otherwise the client is ineligible to connect at this device address and the next available device, if any, for which the client is eligible to connect, will be attempted.</wrap> <wrap>If no permissible terminal devices remain (terminal devices for which the client is eligible to connect) or there are no more available terminal devices then the client connection is rejected.</wrap> <wrap>The optional IP address and subnet mask may be specified in conjunction with the terminal group argument. In this case the terminal group argument must be specified ahead of the optional IP address and subnet mask arguments. To specify an IP address and a subnet mask without also specifying a terminal group use an asterisk (“*”) as the group name substitute or placeholder.</wrap> <wrap>If an IP address / mask are not specified then any client tn3270 session is allowed to connect to the device (provided they are also a member of the specified terminal group, if any).</wrap> <wrap>The terminal group name must match if specified, regardless of any optional IP address / mask. To summarize, the device number suffix always takes precedence over any group name and any group name always takes precedence over any IP address/mask value.</wrap> **//<wrap>6.2.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define an integrated 3270 (SYSG) console on device address 0000 (the device address is ignored for SYSG consoles).</wrap> <wrap>0000 SYSG</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 174</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Define an integrated 3270 (SYSG) console on device address 0000. Allow only clients with terminal group name SYSGCONS and from IP address 192.168.0.100 with subnet mask 255.255.255.0 to connect.</wrap> <wrap>0000 SYSG SYSGCONS 192.168.0.100 255.255.255.0</wrap> **<wrap>Example 3:</wrap>** <wrap>Define an integrated 3270 (SYSG) console on device address 0000. Allow clients with any terminal group name but only from IP address 192.168.0.100 to connect.</wrap> <wrap>0000 SYSG * 192.168.0.100</wrap> **<wrap>Example 4:</wrap>** <wrap>Define an integrated 3270 (SYSG) console on device address 0000. Allow only clients with terminal group name SYSGCONS and from IP address 192.168.0.100 to connect.</wrap> <wrap>0000 SYSG SYSGCONS 192.168.0.100</wrap> **<wrap>Example 5:</wrap>** <wrap>Define an integrated 3270 (SYSG) console on device address 0000. Allow only clients with terminal group name SYSGCONS to connect.</wrap> <wrap>0000 SYSG SYSGCONS</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 175</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.3 Console Printer-Keyboard Devices \\ //6.3.1 Function//</wrap>** <wrap>These device statements are used to define “Console Printer-Keyboard” devices to Hercules. To use the Console Printer-Keyboard device a telnet client must connect to the host machine via the port number specified on the CNSLPORT statement in that configuration file.</wrap> <wrap>If the telnet client software allows it to specify a device type suffix (e.g. ansi@0009) then the suffix can be used to specify the specific 1052 or 3215 device to which the client should connect. If no suffix is used in the telnet client software (or the software does not allow it), then the client will be connected to the first available 1052 or 3215 device for which it is eligible.</wrap> **//<wrap>6.3.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>//<wrap>[N0PR0MPT] [{</wrap>//<wrap>groupname </wrap>//<wrap>| *} [</wrap>//<wrap>ipaddr </wrap>//<wrap>[</wrap>//<wrap>mask</wrap>//<wrap>]]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//__<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬</wrap>__<wrap></wrap> <wrap>N0PR0MPT</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª</wrap><wrap>¬¬</wrap><wrap>¬¬¬¬¬ * ¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>groupname </wrap>//<wrap>¬¬¬¯ ⡿¬¬¬ </wrap>//<wrap>ipaddr </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬</wrap><wrap>¬¬ </wrap>//<wrap>mask </wrap>//<wrap>¬¬</wrap><wrap>¬¯</wrap> **//<wrap>6.3.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid terminal device types are 1052 and 3215.</wrap> **<wrap>NOPROMPT </wrap>**<wrap>The NOPROMPT argument may be specified to cause suppression of the “ENTER INPUT FOR CONSOLE DEVICE nnnn” prompt message which is otherwise normally issued to the device whenever the system is awaiting input from the device.</wrap> <wrap>The NOPROMPT argument, if specified, must preceed the optional group name and any ipaddr mask arguments.</wrap> **//<wrap>groupname </wrap>//**<wrap>If a terminal group name is given on the device statement then a device type suffix with this group name can be used to indicate that a device in this group is to be used. If it is specified as a terminal type suffix (e.g. IBM-3278@GROUPNAME) and there are no devices defined with that group name or no available devices remaining in that group then the connection is rejected. If no group name is specified as a</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 176</wrap> <wrap>\\ </wrap><wrap>terminal type suffix then the connection will only be eligible to terminal devices which also have no group name specified.</wrap> <wrap>The terminal group name should be 1-8 alphanumeric characters in length, the first character being alphabetic and it should not be a hexadecimal number. Upper and lower case letters in the group name are considered to be equivalent.</wrap> **<wrap>* </wrap>**<wrap>The asterisk is used to indicate any terminal group name. It may be omitted if there are no additional arguments following the group name. If an IP address (and optionally mask) is specified and there is no specific group name desired then the asterisk must be coded to distinguish the terminal group name and the IP address arguments.</wrap> **//<wrap>ipaddr </wrap>//****<wrap>[//mask//] </wrap>**<wrap>The optional IP address and subnet masks specify the IP address(es) at which client(s) are allowed to connect via the device address identified by the device statement. This provides an additional means of specifying which device(s) a client tn3270 session may connect to.</wrap> <wrap>If the IP address and mask (default 255.255.255.255 if not specified) of the tn3270 client attempting to connect match the IP address/mask entered on the device statement, then the client is eligible to connect at this device address. Otherwise the client is ineligible to connect at this device address and the next available device, if any, for which the client is eligible to connect, will be attempted.</wrap> <wrap>If no permissible terminal devices remain (terminal devices for which the client is eligible to connect) or there are no more available terminal devices then the client connection is rejected.</wrap> <wrap>The optional IP address and subnet mask may be specified in conjunction with the terminal group argument. In this case the terminal group argument must be specified ahead of the optional IP address and subnet mask arguments. To specify an IP address and a subnet mask without also specifying a terminal group use an asterisk (“*”) as the group name substitute or placeholder.</wrap> <wrap>If an IP address / mask are not specified then any client tn3270 session is allowed to connect to the device (provided they are also a member of the specified terminal group, if any).</wrap> <wrap>The terminal group name must match if specified, regardless of any optional IP address / mask. To summarize, the device number suffix always takes precedence over any group name and any group name always takes precedence over any IP address/mask value.</wrap> **//<wrap>6.3.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a 1052 console printer-keyboard device on device address 0009.</wrap> <wrap>0009 1052</wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 1052 console printer-keyboard device on device address 0009 and suppress the “ENTER INPUT FOR CONSOLE DEVICE nnnn” prompt messages.</wrap> <wrap>0009 1052 NOPROMPT</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 177</wrap> <wrap>\\ </wrap>**<wrap>Example 3:</wrap>** <wrap>Define a 3215 console printer-keyboard device on device address 0009. Allow only clients with terminal group name CONSOLES and from IP address 192.168.0.100 to connect.</wrap> <wrap>0009 3215 CONSOLES 192.168.0.100 255.255.255.0</wrap> **<wrap>Example 4:</wrap>** <wrap>Define a 3215 console printer-keyboard device on device address 0009. Allow only clients with terminal group name CONSOLES and from IP address 192.168.0.100 with subnet mask 255.255.255.0 to connect. Additionally suppress the “ENTER INPUT FOR CONSOLE DEVICE nnnn” prompt messages.</wrap> <wrap>0009 3215 NOPROMPT CONSOLES 192.168.0.100 255.255.255.0</wrap> **<wrap>Example 5:</wrap>** <wrap>Define a 3215 console printer-keyboard device on device address 0009. Allow clients with any terminal group name but only from IP address 192.168.0.100 with subnet mask 255.255.255.0 to connect. Additionally suppress the “ENTER INPUT FOR CONSOLE DEVICE nnnn” prompt messages.</wrap> <wrap>0009 3215 NOPROMPT * 192.168.0.100 255.255.255.0</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 178</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.4 Integrated Console Printer-Keyboard Devices \\ //6.4.1 Function//</wrap>** <wrap>These device statements are used to define “Integrated Console Printer-Keyboard” devices to the Hercules configuration. The statements have one optional argument, the default command prefix for sending input to the device. The default command prefix is “/”. All integrated devices must use a different command prefix.</wrap> <wrap>To send a logon command to a 1052-C or 3215-C enter “/logon” on the Hercules console.</wrap> **//<wrap>6.4.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>//<wrap>[(</wrap>//<wrap>prefix </wrap>//<wrap>| /}I</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** |<WRAP><wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype</wrap>// </WRAP> |<WRAP><wrap>~¬¬¬¬¬¬ / ¬¬¬¬¬®</wrap> <wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿¬¬¬ </wrap>//<wrap>prefix </wrap>//<wrap>¬¬¬¯</wrap> </WRAP> | **//<wrap>6.4.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid terminal device types are 1052-C and 3215-C.</wrap> **//<wrap>prefix </wrap>//**<wrap>This is the command prefix for the device. The default command prefix is “/”. All devices must use a different command prefix.</wrap> **//<wrap>6.4.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a 3215-C integrated console printer-keyboard device on device address 0009. Specify "/" as command prefix.</wrap> <wrap>0009 3215-C /</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 179</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.5 Card Reader Devices \\ //6.5.1 Function//</wrap>** <wrap>The card reader device statements are used to define card readers to the Hercules configuration. The argument specifies a list of file names containing card images. Additional arguments can be defined after the file names.</wrap> **//<wrap>6.5.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr devtype filename </wrap>//<wrap>[</wrap>//<wrap>filename </wrap>//<wrap>... ] [S0CKDEV] [E0F] [INTRQ] \\ [MULTIFILE] [EBCDIC [AUT0PAD]] [ASCII [TRUNC]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®</wrap> <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>%%__%%_°%%__%%_ </wrap>//<wrap>filename </wrap>//<wrap>%%__%%_¨%%__%%_I%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%¬¬¬¬¬¬¬Ê</wrap> <wrap>L%%__%%_ S0CKDEV%%__%%%%__%%¯</wrap> <wrap>E0F %%__%%_ L%%__%%_ INTRQ %%__%%_ L%%__%%_ MULTIFILE</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬ÊÍ %%__%%_ EBCDIC%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_« ⡿%%__%%_ASCII %%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_«</wrap> <wrap>⡿%%__%%_ AUT0PAD %%__%%_¯ ⡿%%__%%_TRUNC%%__%%_¯</wrap> **//<wrap>6.5.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid card reader types are 1442, 2501, 3505.</wrap> **//<wrap>filename </wrap>//**<wrap>The name (and optionally the path) of the card reader file.</wrap> **<wrap>SOCKDEV </wrap>**<wrap>Indicates that the card reader is a socket device, wherein the filename is actually a socket specification instead of a device filename. When used, there must be only one filename specified in the form “//port//”, “//host:port//” or “//sockpath/sockname//”. The device then accepts remote connections on the given TCP/IP port or Unix domain socket and reads data from the socket instead from a device file. This allows automatic remote submission of card reader data.</wrap> <wrap>See chapter 15 ("Submitting Jobs via the Socket Reader") for more details.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 180</wrap> <wrap>\\ </wrap>**<wrap>EOF </wrap>**<wrap>EOF specifies that unit exception status is presented after reading the last card in the file. This option is persistent and will remain in effect until the reader is reinitialized with the INTRQ option.</wrap> **<wrap>INTRQ </wrap>**<wrap>INTRQ specifies that unit check status with intervention required sense bytes is presented after reading the last card in the file. This option is persistent and will</wrap> <wrap>remain in effect until the reader is reinitialized with the EOF option.</wrap> **<wrap>MULTIFILE </wrap>**<wrap>Specifies, when multiple files are entered, to automatically open the next input file and continue reading whenever EOF is encountered on a given file. If not specified reading stops once EOF is reached on a given file and an attention interrupt is required to open and begin reading the next file.</wrap> **<wrap>EBCDIC </wrap>**<wrap>Specifies that the file contains fixed length 80-byte EBCDIC records with no line-end delimiters.</wrap> **<wrap>ASCII </wrap>**<wrap>Specifies that the file contains variable length lines of ASCII characters delimited by LF (line feed) or CRLF (carriage return line feed) sequences at the end of each line.</wrap> <wrap>If neither EBCDIC nor ASCII is coded then the device handler attempts to detect the format of the card image file when the device is first accessed. Auto-detection is not supported for socket devices and the default is ASCII if SOCKDEV is specified.</wrap> **<wrap>TRUNC </wrap>**<wrap>With ASCII files, TRUNC defines, that lines longer than 80 characters are truncated instead of producing a unit check error.</wrap> **<wrap>AUTOPAD </wrap>**<wrap>With EBCDIC files, AUTOPAD defines, that the file is automatically padded to a multiple of 80 bytes if necessary.</wrap> **//<wrap>6.5.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a 3505 card reader device on device address 000C. The name and path of the card reader file is "</wrap>[[file:///D:/JCL/DUMMY.JCL|<wrap>D:/JCL/DUMMY.JCL</wrap>]]<wrap>". A unit exception status has to be presented after reading the last card in the file.</wrap> <wrap>000C 3505 </wrap>[[file:///D:/JCL/DUMMY.JCL|<wrap>D:/JCL/DUMMY.JCL</wrap>]]<wrap> EOF</wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 1442 card reader device on device address 000C. The name and path of the card reader file is "</wrap>[[file:///D:/JCL/JCL.TXT|<wrap>D:/JCL/JCL.TXT</wrap>]]<wrap>". The file contains fixed length 80-byte EBCDIC records, automatically padded to a multiple of 80 bytes if necessary. A unit check status with intervention required sense bytes has to be presented after reading the last card in the file.</wrap> <wrap>000C 1442 </wrap>[[file:///D:/JCL/JCL.TXT|<wrap>D:/JCL/JCL.TXT</wrap>]]<wrap> EBCDIC AUTOPAD INTRQ</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 181</wrap> <wrap>\\ </wrap>**<wrap>Example 3:</wrap>** <wrap>Define a 2501 card reader device on device address 000C. The card reader is a socket device accepting remote connections from address 127.0.0.1 port 2501. The file contains variable length lines of ASCII characters delimited by line feed or carriage return line feed sequences at the end of each line. Lines longer than 80 bytes have to be truncated and a unit exception status has to be presented after reading the last card in the file.</wrap> <wrap>000C 2501 127.0.0.1:2501 SOCKDEV ASCII TRUNC EOF</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 182</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.6 Card Punch Devices \\ //6.6.1 Function//</wrap>** <wrap>The card punch statement defines a card punch device to the Hercules configuration. The argument specifies the name of the file to which the punched output will be written. Additional arguments may be specified after the filename.</wrap> **//<wrap>6.6.2 Syntax</wrap>//** {{hercules:userref:bf:image031.gif|}}{{hercules:userref:bf:image032.gif|}}{{hercules:userref:bf:image033.gif|}}{{hercules:userref:bf:image034.gif|}}{{hercules:userref:bf:image032.gif|}}**//<wrap>6.6.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. A valid card punch type is 3525.</wrap> **//<wrap>filename </wrap>//**<wrap>The name (and optionally the path) of the card punch file.</wrap> **<wrap>ASCII </wrap>**<wrap>ASCII specifies that the file will be written as variable length lines of ASCII characters, delimited by line feeds or carriage return line feed sequences. Trailing blanks are removed from each line. If the ASCII argument is not specified, the file is written as fixed length 80-byte EBCDIC records with no line-end delimiters.</wrap> **<wrap>CRLF </wrap>**<wrap>This optional parameter specifies that carriage return line feed sequences are written at the end of each line. If the CRLF argument is not specified, line feeds are only written at the end of each line.</wrap> **<wrap>NOCLEAR </wrap>**<wrap>This argument specifies that the output file will not be cleared to zero bytes when it is opened. If NOCLEAR is not specified, then any previous content of the file is destroyed when the file is opened for output.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 183</wrap> <wrap>\\ </wrap>**//<wrap>6.6.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a 3525 card punch device on device address 000D. The punched output has to be written to the file "D/PCH/PCH1.TXT" as variable length lines of ASCII records delimited by carriage return line feed sequences. Any existing output in the file has to be kept when the file is opened for output.</wrap> <wrap>000D 3525 </wrap>[[file:///D:/PCH/PCH1.TXT|<wrap>D:/PCH/PCH1.TXT</wrap>]]<wrap> ASCII CRLF NOCLEAR</wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 3525 card punch device on device address 000D. The punched output has to be written to the file "D/PCH/PCH2.TXT" as fixed length 80-byte EBCDIC records with no line-end delimiters. Any existing output in the file will be destroyed when the file is opened for output.</wrap> <wrap>000D 3525 </wrap>[[file:///D:/PCH/PCH2.TXT|<wrap>D:/PCH/PCH2.TXT</wrap>]]<wrap></wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 184</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.7 Line Printer Devices \\ //6.7.1 Function//</wrap>** <wrap>The line printer device statement defines a printer to the Hercules configuration. The argument specifies the name of a file to which the printer output will be written. The output is written in the form of variable length lines of ASCII characters, delimited by line feeds or carriage return line feed sequences. Trailing blanks are removed from each line. Carriage control characters are translated to blank lines or ASCII form feed characters. If the file exists it will be overwritten.</wrap> <wrap>If the filename begins with the vertical bar '|' pipe character, then it is removed and the remainder of the filename is interpreted as a command line (the name of a program or batch file followed by any necessary arguments) to which to "pipe" the printer output to. This is known as the "print-to-pipe" feature. All printer output is then sent to the piped programs stdin input, and all of the piped programs stdout and stderr output is piped back to Hercules for displaying on the hardware console.</wrap> <wrap>SOCKDEV indicates that the line printer is a socket device wherein the filename is actually a socket specification in the form //host:port //instead of a device filename. The device then accepts remote connections on the given TCP/IP port and writes data to the socket instead to a device file. A Windows software that supports a socket printer is Fish's "HercPrt" (Hercules Remote Printer Spooler). It spools the print output from a Hercules socket printer and creates either PDF, RTF or just plain text files. A control file enables HercPrt to split the printouts on job separator page boundaries and name the file according the actual job accounting field values.</wrap> **//<wrap>6.7.2 Syntax</wrap>//** <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **//<wrap>devaddr devtype </wrap>//****//<wrap>filename </wrap>//****<wrap>[CRLF] [N0CLEAR] </wrap>****<wrap>[RAWCC] [</wrap>****__<wrap>FCBCHECK</wrap>__****<wrap> | N0FCBCHECK] </wrap>****<wrap>[</wrap>****__<wrap>0PTBR0WSE</wrap>__****<wrap> | 0PTPRINT] [LPI={6 | </wrap>****//<wrap>lpi</wrap>//****<wrap>] [INDEX={0 | </wrap>****//<wrap>idx</wrap>//****<wrap>] [LPP={</wrap>****__<wrap>66</wrap>__****<wrap> | </wrap>****//<wrap>lpp</wrap>//****<wrap>}]</wrap>** **<wrap>[</wrap>****<wrap>FCB={</wrap>****__<wrap>1</wrap>__****__<wrap>:1,07:2,13:3,19:</wrap>__****__<wrap>4,</wrap>__****__<wrap>25:5,31:6,37:7,43:8,61:9,49:10,55:11,61:12</wrap>__****<wrap> | </wrap>****//<wrap>l1:c1,l2:c2,l3:c3, ... ,l10:c10,l11:c11,l12:c12</wrap>//****<wrap>}]</wrap>** **<wrap>or</wrap>** **//<wrap>devaddr devtype </wrap>//****<wrap>[</wrap>****//<wrap>host:</wrap>//****<wrap>]</wrap>****//<wrap>port </wrap>//****<wrap>S0CKDEV</wrap>** <wrap>\\ </wrap>**__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ </wrap>****//<wrap>devaddr </wrap>//****<wrap>¬¬¬ </wrap>****//<wrap>devtype </wrap>//****<wrap>¬¬¬ </wrap>****//<wrap>filename</wrap>//** <wrap>\\ </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap>** **<wrap>⡿%%__%%_CLRF%%__%%_¯</wrap>** <wrap>\\ </wrap>**<wrap>~%%__%%%%__%%FCBCHECK %%__%%%%__%%®</wrap>** **<wrap>Ê</wrap>****<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap>** **<wrap>⡿%%__%%_N0CLEAR </wrap>****<wrap>¬¬¬</wrap>****<wrap>i L%%__%%_ </wrap>****<wrap>RAWCC </wrap>****<wrap>%%__%%_i '%%__%%_ N0FCBCHECK %%__%%_¯</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 185</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>~¬¬¬ </wrap><wrap>OPTBROWSE </wrap><wrap>¬¬¬¬® ~¬¬¬¬ </wrap><wrap>LPI=6 </wrap><wrap>¬¬¬¬¬¬®</wrap> <wrap>Ê</wrap><wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP>{{hercules:userref:bf:image035.jpg|}} </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>⡿¬¬¬OPTPRINT¬¬¬¬¬¯ ⡿</wrap><wrap>¬¬¬¬ </wrap><wrap>LPI=</wrap>//<wrap>lpi </wrap>//<wrap>¬¬¬¬</wrap><wrap>¯</wrap><wrap></wrap> <wrap>~¬¬¬ </wrap><wrap>INDEX=0 </wrap><wrap>¬¬¬¬¬® ~¬¬¬¬ </wrap><wrap>LPP=66 </wrap><wrap>¬¬¬¬¬®</wrap> <wrap>Ê</wrap><wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP>{{hercules:userref:bf:image036.jpg|}} </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>⡿¬¬¬INDEX=</wrap>//<wrap>idx</wrap>//<wrap>¬¬¬¯ ⡿</wrap><wrap>¬¬¬¬ </wrap><wrap>LPP=</wrap>//<wrap>lpp </wrap>//<wrap>¬¬¬¬</wrap><wrap>¯</wrap><wrap></wrap> <wrap>~</wrap><wrap>¬¬¬FCB=1:1,7:2,13:3,19:4, ... ,61:9,49:10,55:11,61:12 </wrap><wrap>¬¬¬¬®</wrap> <wrap>Ê</wrap><wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿¬¬¬FCB=</wrap>//<wrap>l1:c1,l2:c2,l3:c3, ... ,l10:c10,l11:c11,l12:c12 </wrap>//<wrap>¬¬¬¯</wrap> |<WRAP><wrap>or</wrap> <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>host: </wrap>//<wrap>¬¬¬¯</wrap> </WRAP> |<WRAP>//<wrap>port </wrap>//<wrap>¬¬¬ SOCKDEV ¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬ÊÍ</wrap> </WRAP> | <wrap>\\ </wrap><wrap></wrap> <wrap>\\ </wrap>**//<wrap>6.7.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid printer types are 1403 and 3211.</wrap> **//<wrap>filename </wrap>//**<wrap>The name (and optionally the path) of the printer file or the “print-to-pipe” command line. If the filename begins with the vertical bar '|' pipe character, then it is removed and the remainder of the filename is interpreted as a command line (the name of a program or batch file followed by any necessary arguments) to which to "pipe" the printer output to.</wrap> <wrap>This is known as the "print-to-pipe" feature. All printer output is then sent to the piped programs stdin input, and all of the piped programs stdout and stderr output is piped back to Hercules for displaying on the hardware console.</wrap> <wrap>If the "print-to-pipe" command line contains arguments, then quotes must be placed around the entire filename string including the vertical bar. If the "print-to-pipe" command line itself contains quotes, then the command line must be enclosed in apostrophes instead of quotes.</wrap> **<wrap>CRLF </wrap>**<wrap>This optional parameter specifies that carriage return line feed sequences are written at the end of each line. If the CRLF argument is not specified then line feeds only are written at the end of each line.</wrap> **<wrap>NOCLEAR </wrap>**<wrap>This argument specifies that the output file will not be cleared to zero bytes when it is opened. If NOCLEAR is not specified, then any previous content of the file is destroyed when the file is opened for output.</wrap> **<wrap>RAWCC </wrap>**<wrap>RAWCC specifies that printer output CCWs are not to be interpreted, but simply dumped in hex to the printer output file. This is useful for debugging. Default is to interpret printer CCWs normally.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 186</wrap> <wrap>\\ </wrap>**<wrap>FCBCHECK </wrap>**<wrap>This argument specifies that an attempt to skip to a FCB channel for which no line number has been set will cause the command to be rejected with a unit check. This is the default.</wrap> **<wrap>NOFCBCHECK </wrap>**<wrap>This argument specifies that an attempt to skip to a FCB channel for which no line number has been set will cause the next line of output printed on the next line on the printer output. The opposite, FCBCHECK, is the default.</wrap> **<wrap>OPTBROWSE </wrap>**<wrap>Printing is optimized for browsing. This is the default.</wrap> **<wrap>OPTPRINT </wrap>**<wrap>Printing is optimized for printed output.</wrap> **<wrap>LPI= </wrap>**<wrap>Specifies the number of lines per inch. The value of //lpi //must be 6 or 8. The default number of lines per inch is 6.</wrap> **<wrap>INDEX= </wrap>**<wrap>Sets the 3211 indexing. The value of //idx //must be in the range of 0 - 31. The default is 0.</wrap> **<wrap>LPP= </wrap>**<wrap>Specifies the number of lines per page. The value of //lpp //must be numeric but is not further checked. Any number of lines per page is allowed. The default number of lines per page is 66.</wrap> **<wrap>FCB= </wrap>**<wrap>FCB specifies an initial FCB image to use for the printer. The argument must be given in the form //l1:c1, ... ,l12:c12 //where 'l' and 'c' are numeric. 'l' is the line number and 'c' is the assigned channel. There is a maximum of 12' l:c' pairs allowed.</wrap> <wrap>The default is FCB=1:1,07:2,13:3,19:4,25:5,31:6,37:7,43:8,61:9,49:10,55:11,61:12.</wrap> **//<wrap>host </wrap>//**<wrap>This is the hostname or the IP address of the socket device.</wrap> **//<wrap>port </wrap>//**<wrap>This is the port number of the socket device.</wrap> **<wrap>SOCKDEV </wrap>**<wrap>SOCKDEV indicates that the line printer is a socket device wherein the filename is actually a socket specification instead of a device filename.</wrap> <wrap>When used, there must only be one filename specified in the form //port //or //host:port//. The device then accepts remote connections on the given TCP/IP port and writes data to the socket instead to a device file.</wrap> <wrap>This allows automatic remote spooling of line printer data. The sockdev option is mutually exclusive with all other printer options (like CRLF etc.) and must be specified alone.</wrap> **//<wrap>6.7.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a 1403 line printer device on device address 000E. The printed output has to be written to the file "</wrap>[[file:///D:/PRT/PRT1.TXT|<wrap>D:%%\%%PRT%%\%%PRT1.TXT</wrap>]]<wrap>" with carriage return line feed sequences at the end of each line. Any existing output in the file has to be kept when the file is opened for output.</wrap> <wrap>000E 1403 </wrap>[[file:///D:/PRT/PRT1.TXT|<wrap>D:/PRT/PRT1.TXT</wrap>]]<wrap> CRLF NOCLEAR</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 187</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Define a 3211 line printer device on device address 000F. The printed output has to be written to the file "</wrap>[[file:///D:/PRT/PRT2.TXT|<wrap>D:%%\%%PRT%%\%%PRT2.TXT</wrap>]]<wrap>" with line feeds only at the end of each line. Any existing output in the file will be overwritten when the file is opened for output.</wrap> <wrap>000F 3211 </wrap>[[file:///D:/PRT/PRT2.TXT|<wrap>D:/PRT/PRT2.TXT</wrap>]]<wrap></wrap> **<wrap>Example 3:</wrap>** <wrap>Define a 1403 line printer device on device address 000E. The printed output has to be written to the file "</wrap>[[file:///D:/PRT/PRT1.TXT|<wrap>D:%%\%%PRT%%\%%PRT1.TXT</wrap>]]<wrap>" with carriage return line feed sequences at the end of each line. A specific FCB has to be used and a skip to a FCB channel for which no line number has been set (channels 7 and 8) has to cause a unit check. The number of lines per inch must be 6 and the number of lines per page is 66. The output has to be optimized for printing.</wrap> <wrap>000E 1403 </wrap>[[file:///D:/PRT/PRT1.TXT|<wrap>D:/PRT/PRT1.TXT</wrap>]]<wrap> CRLF FCBCHECK LPI=6 LPP=66 OPTPRINT</wrap> <wrap>FCB=1:1,07:2,13:3,19:4,25:5,31:6,61:9,49:10,55:11,61:12</wrap> **<wrap>Example 4:</wrap>** <wrap>Define a 1403 line printer device on device address 000E. The line printer is a socket device with the IP address 192.168.0.199 and port 1403. Output is written to the socket instead to a device file.</wrap> <wrap>000E 1403 192.168.0.199:1403 SOCKDEV</wrap> **<wrap>Example 5:</wrap>** <wrap>Define a 1403 line printer device on device address 000E. The command line for the print-to-pipe feature is “/usr/bin/lpr”, the argument for the ‘lpr’ program is “-Phplj” (Unix example). In the case of the Windows example the command line for the print-to-pipe feature is “C:%%\%%utils%%\%%pr”, the argument for the ‘pr’ program is “-PLPTP1:” . Each printed line will have a carriage return line feed sequence at the end.</wrap> |<WRAP><wrap>000E</wrap> </WRAP> |<WRAP><wrap>1403</wrap> </WRAP> |<WRAP><wrap>"|/usr/bin/lpr</wrap> </WRAP> |<WRAP><wrap>-Phplj" crlf</wrap> </WRAP> |<WRAP>//<wrap>(for Unix)</wrap>// </WRAP> | |<WRAP><wrap>000E</wrap> </WRAP> |<WRAP><wrap>1403</wrap> </WRAP> |<WRAP><wrap>"|c:%%\%%utils%%\%%pr</wrap> </WRAP> |<WRAP><wrap>-s -PLPT1:" crlf</wrap> </WRAP> |<WRAP>//<wrap>(for Windows)</wrap>// </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 188</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.8 Emulated Tape Devices</wrap>** <wrap>Tape device statements are used to define tape devices to the Hercules configuration. Five types of emulation are supported:</wrap> <wrap>·<wrap></wrap></wrap><wrap>SCSI tapes</wrap> <wrap>·<wrap></wrap></wrap><wrap>Optical Media Attach (OMA) virtual files</wrap> <wrap>·<wrap></wrap></wrap><wrap>AWSTAPE virtual files</wrap> <wrap>·<wrap></wrap></wrap><wrap>HET virtual files</wrap> <wrap>·<wrap></wrap></wrap><wrap>Fake Tape virtual files</wrap> **//<wrap>6.8.1 SCSI Tapes</wrap>//** **<wrap>6.8.1.1 Function</wrap>** <wrap>When defining SCSI tapes the argument specifies the tape device name (usually **/dev/nst0**). SCSI tapes are read and written using variable length EBCDIC blocks and filemarks exactly like a mainframe tape volume (see also the AUTO_SCSI_MOUNT system parameter).</wrap> **<wrap>6.8.1.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr devtype devname </wrap>//<wrap>[--no-erg] [--blkid-</wrap><wrap>32 | </wrap><wrap>--blkid-22]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devname </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>L%%__%%_ </wrap><wrap>--no-</wrap><wrap>erg %%__%%_i</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª%%__%%_ </wrap><wrap>--blkid-</wrap><wrap>32 %%__%%_«</wrap> <wrap>%%__%%_ </wrap><wrap>--blkid-</wrap><wrap>22%%__%%_¯</wrap> **<wrap>6.8.1.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid device types are 3410, 3420, 3422, 3430, 3480, 3490, 8809 and 9347.</wrap> **//<wrap>devname </wrap>//**<wrap>The tape device name (usually “/dev/nst0” on Linux or “%%\%%%%\%%.%%\%%Tape0” on Windows).</wrap> **<wrap>--no-erg </wrap>**<wrap>This option is intended to prevent issuance of the Erase Gap command to those SCSI tape drives that do not support it (e.g. Quantum DLT series). It causes Her-</wrap><wrap></wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 189</wrap> <wrap>\\ </wrap><wrap>cules's device emulation logic to ignore any ‘Erase Gap’ commands issued to the drive and to return immediate success instead.</wrap> <wrap>This option should only be used (specified) for drives such as the Quantum which support switching from read mode to write mode in the middle of a data stream without the need of an intervening ‘Erase Gap’ command. Specifying it for any other model SCSI drive may cause incorrect functioning as a result of the Erase Gap command not being issued to the actual SCSI hardware.</wrap> <wrap>Check the manufacturer information for your particular model of SCSI-attached tape drive (and/or use Fish's "ftape" Windows utility) to determine whether or not this option is needed for your particular drive.</wrap> **<wrap>--blkid-32 </wrap>**<wrap>This option indicates that your SCSI-attached tape drive only supports 32-bit block-ids (as used by 3590 drives) and not the 22-bit format used by 3480/3490 drives. You should only specify this option if you intend to define the drive as a model 3480 or 3490 device and then only if your actual SCSI drive uses 32-bit block-ids. If you define your Hercules tape drive as a model 3590 device however this option is not required as 3590 drives are already presumed to use 32-bit block-ids.</wrap> <wrap>Specifying this option on a 3480/3490 device statement will cause Hercules device emulation logic to automatically translate the actual SCSI tape drive's 32-bit block-id into 22-bit format before returning it back to the guest operating system (since that is the format it expects it to be in for a model 3480/3490 drive), and to translate the guest's 22-bit format block-id into 32-bit format before sending it to the actual SCSI hardware (since that is the format that the actual hardware requires it to be in).</wrap> **<wrap>--blkid-22 </wrap>**<wrap>This is the opposite of the above --blkid-32 option.</wrap> **<wrap>6.8.1.4 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 3420 tape device on device address 0580. The tape device is a SCSI-attached tape drive which only supports 32-bit block-ids.</wrap> <wrap>0580 3420 /dev/nst0 --blkid-32</wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 3490 tape device on device address 0581. The tape device is a SCSI-attached tape drive which supports 22-bit block-ids. Ignore any ‘Erase Gap’ commands.</wrap> <wrap>0581 3490 %%\%%%%\%%.%%\%%Tape0 --no-erg --blkid-22</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 190</wrap> <wrap>\\ </wrap>**//<wrap>6.8.2 Optical Media Attach (OMA) virtual files</wrap>//** **<wrap>6.8.2.1 Function</wrap>** <wrap>OMA device statements are used to define Optical Media Attach (OMA) virtual files to the Hercules configuration. OMA virtual files are read-only files which normally reside on CDROM. OMA virtual tapes consist of one CDROM file corresponding to each physical file of the emulated tape. An ASCII text file called the “Tape Descriptor File” (TDF) specifies the names of the files which make up the virtual tape. The argument specifies the name of the tape descriptor file.</wrap> <wrap>Each file on the virtual tape can be in one of the following three formats:</wrap> **<wrap>TEXT </wrap>**<wrap>TEXT files consist of variable length ASCII records delimited by carriage return line feed (CRLF) sequences at the end of each record. Each record is translated to</wrap> <wrap>EBCDIC and presented to the program as one physical tape block.</wrap> **<wrap>FIXED nnnnn </wrap>**<wrap>FIXED files consist of fixed length EBCDIC blocks of the specified length (nnnnn).</wrap> **<wrap>HEADERS </wrap>**<wrap>HEADERS files consist of variable length EBCDIC blocks. Each block is preceded by a 12-byte header.</wrap> <wrap>If you have any IBM manuals in BookManager format on CDROM, you can see some examples of TDF files in the “%%\%%TAPES” directory on the CDROM.</wrap> **<wrap>6.8.2.2 Syntax</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr devtype tdf</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬ </wrap>//<wrap>tdf</wrap>// **<wrap>6.8.2.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type Valid device types are 3410, 3420, 3422, 3430, 3480, 3490, 8809 and 9347.</wrap> **//<wrap>tdf </wrap>//**<wrap>The filename (and path) of the tape descriptor file.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 191</wrap> <wrap>\\ </wrap>**<wrap>6.8.2.4 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 3480 tape device on device address 0582. The tape device is an Optical Media Attach (OMA) virtual file (CD-ROM). The filename of the Tape Descriptor File (TDF) is "B00105.TDF" located in the current search path.</wrap> <wrap>0582 3480 /CDROM/TAPES/UAA186.TDF</wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 3490 tape device on device address 0581. The tape device is an Optical Media Attach (OMA) virtual file (CD-ROM). The filename of the Tape Descriptor File (TDF) is "UAA186.TDF" located in path "/CDROM/TAPES/".</wrap> <wrap>0581 3490 B00105.TDF</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 192</wrap> <wrap>\\ </wrap>**//<wrap>6.8.3 AWSTAPE virtual files</wrap>//** **<wrap>6.8.3.1 Function</wrap>** <wrap>AWSTAPE device statements are used to define AWSTAPE virtual files to the Hercules configuration. AWSTAPEs contain a complete tape in one file. AWSTAPE files consist of variable length EBCDIC blocks. Each block is preceded by a 6-byte header. Filemarks are represented by a 6-byte header with no data. This is the same format as is used by the IBM P/390 systems. The argument specifies the location of the AWSTAPE file.</wrap> **<wrap>6.8.3.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>//<wrap>{</wrap>//<wrap>awsfile </wrap>//<wrap>| *} [</wrap>//<wrap>arguments</wrap>//<wrap>]</wrap> <wrap>where arguments can be</wrap><wrap>:</wrap> <wrap>[MAXSIZE={</wrap>//<wrap>n</wrap>//<wrap>[K | M | G | T] | 0}|</wrap> <wrap>MAXSIZEK={</wrap>//<wrap>n </wrap>//<wrap>| 0} |</wrap> <wrap>MAXSIZEM={</wrap>//<wrap>n </wrap>//<wrap>| 0}]</wrap> <wrap>[EOTMARGIN=</wrap>//<wrap>n</wrap>//<wrap>[K | M | G | T]</wrap><wrap>]</wrap> <wrap>[READONLY={0 | 1}]</wrap> <wrap>[RO | NORING | </wrap>__<wrap>RW</wrap>__<wrap> | __RING__</wrap><wrap>]</wrap> <wrap>[DEONIRQ={0 |1}]</wrap> <wrap>[NOAUTOMOUNT]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬§¬¬¬ </wrap>//<wrap>awsfile </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>⡿¬¬¬¬¬¬*¬¬¬¬¬¬</wrap> //<wrap>arguments</wrap>// <wrap>where arguments can be</wrap><wrap>:</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 193</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>ª</wrap><wrap>¬¬¬§¬¬¬MAXSIZE= ¬¬¬¬§¬¬¬0 </wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap> ⡿¬¬¬</wrap>//<wrap>n </wrap>//<wrap>¬¬¬§¬¬¬ K ¬¬¬« </wrap><wrap></wrap> <wrap> ª</wrap><wrap>¬¬¬ </wrap><wrap>M</wrap><wrap>¬¬¬« </wrap><wrap></wrap> <wrap> ª¬¬¬G¬¬¬« </wrap> <wrap> ⡿¬¬¬T¬¬¬¯ </wrap> <wrap>ª¬¬¬MAXSIZEK= ¬¬¬§¬¬¬ 0 ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¯</wrap> <wrap> ⡿¬¬¬</wrap>//<wrap>n </wrap>//<wrap>¬¬¬¯ \\ ⡿¬¬¬MAXSIZEM= ¬¬¬§¬¬¬ 0 </wrap><wrap>¬¬¬§¬¬¬</wrap><wrap>¯</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap><wrap>¯</wrap> |<WRAP><wrap>ª¬¬¬ EOTMARGIN= ¬¬¬ </wrap>//<wrap>n</wrap>// </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª</wrap><wrap>¬¬¬ K ¬¬¬« </wrap><wrap>ª</wrap><wrap>¬¬¬ </wrap><wrap>M</wrap><wrap>¬¬¬« </wrap><wrap>ª</wrap><wrap>¬¬¬ </wrap><wrap>G</wrap><wrap>¬¬¬« </wrap><wrap>⡿¬¬¬</wrap><wrap>T ¬¬¬</wrap><wrap>¯</wrap> </WRAP> | <wrap>ª</wrap><wrap>¬¬¬ READONLY=¬¬¬§¬¬¬0 </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬1¬¬¬</wrap> <wrap>ª</wrap><wrap>¬¬¬§¬¬¬¬¬RO¬</wrap><wrap>¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬NORING¬¬¬«</wrap> <wrap>ª¬¬¬¬¬</wrap>__<wrap>RW</wrap>__<wrap> ¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬¬</wrap> <wrap>%%__%%%%__%%%%__%% </wrap>__<wrap>RING</wrap>__<wrap> ¬¬¬¬</wrap> <wrap>ª</wrap><wrap>¬¬¬ DEONIRQ= ¬¬¬§¬¬¬0¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬ 1¬¬¬</wrap> <wrap>ª¬¬¬ NOAUTOMOUNT</wrap> **<wrap>6.8.3.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid device types are 3410, 3420, 3422, 3430, 3480, 3490, 8809 and 9347.</wrap> **//<wrap>awsfile </wrap>//**<wrap>The filename (and path) of the AWSTAPE file or “*”. An asterisk defines an empty tape station. The tape must be manually be loaded on request.</wrap> <wrap>If the filename starts with the “@” character (at sign), the file then describes a list of tape emulation files to be loaded in succession. The syntax of each line in this file is identical to the information that can be coded directly after the device type in the overall configuration file. Any emulation file name parameter specified in this file may be substituted by the character “*”, in which case it specifies a set of options to be applied to all additional emulation files specified in the list.</wrap> <wrap>This function emulates an Automatic Cartridge Feeder (ACF. The ACF is a feature on Cartridge type tape drives (3480, 3490, etc..) that automatically loads a new tape when a tape is removed from the drive. There is no real control over this device by the host as it just keeps on feeding tapes one after the other. Although the</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 194</wrap> <wrap>\\ </wrap><wrap>ACF feature is unique to cartridge type systems, the emulation accepts the use of the same technique for emulated 1/2 inch tapes reel drives as well.</wrap> <wrap>Parameters are appended in succession. In all cases, if the same parameter is coded more than once, the last instance takes precedence. Therefore it is possible to specify a set of parameters in the base configuration file, another on an “*” line and another for each individual line in the list of files. Parameters are then appended in that order. A SCSI tape device should not be given in a file list.</wrap> <wrap>The remaining parameters are described in section 6.8.6 (“Common parameters for AWS, HET and FakeTape virtual files”).</wrap> **<wrap>6.8.3.4 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 3490 tape device on device address 0580. The tape device is an AWSFILE virtual file named "R0673A.AWS" located in path "/S390/TAPES/".</wrap> <wrap>0580 3490 /S390/TAPES/R0673A.AWS</wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 3490 tape device on device address 0580. The tape device is an AWSFILE virtual file named "R0674A.AWS" located in path "/S390/TAPES/". Mount the tape readonly and disable the support for guest-initiated automatic tape volume mounting for this device.</wrap> <wrap>0580 3490 /S390/TAPES/R0674A.AWS READONLY=1 NOAUTOMOUNT</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 195</wrap> <wrap>\\ </wrap>**//<wrap>6.8.4 HET virtual files</wrap>//** **<wrap>6.8.4.1 HET virtual files</wrap>** <wrap>HET device statements are used to define HET virtual files to the Hercules configuration. These contain a complete tape in one file and have the same structure as the AWSTAPE format with the added ability to have compressed data. The first argument specifies the location of the HET file. The filename must end with “.HET” to be recognized by Hercules as a HET file (e.g. “023178.HET”). There are several additional arguments that control various HET settings.</wrap> **<wrap>6.8.4.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>//<wrap>{</wrap>//<wrap>hetfile </wrap>//<wrap>| *} [</wrap>//<wrap>arguments</wrap>//<wrap>]</wrap> <wrap>where arguments can be</wrap><wrap>:</wrap> <wrap>[AWSTAPE]</wrap> <wrap>[COMPRESS={0 | 1}]</wrap> <wrap>[IDRC={0 | 1}]</wrap> <wrap>[METHOD={</wrap><wrap>1 </wrap><wrap>| 2}]</wrap> <wrap>[LEVEL={</wrap>//<wrap>n </wrap>//<wrap>| </wrap><wrap>4</wrap><wrap>}]</wrap> <wrap>[CHUNKSIZE={</wrap>//<wrap>nnnnn </wrap>//<wrap>| __65535__}]</wrap> <wrap>[MAXSIZE={</wrap>//<wrap>n</wrap>//<wrap>[K | M | G | T] | 0}|</wrap> <wrap>MAXSIZEK={</wrap>//<wrap>n </wrap>//<wrap>| 0} |</wrap> <wrap>MAXSIZEM={</wrap>//<wrap>n </wrap>//<wrap>| 0}]</wrap> <wrap>[EOTMARGIN=</wrap>//<wrap>n</wrap>//<wrap>[K | M | G | T]]</wrap> <wrap>[READONLY={0 | 1}]</wrap> <wrap>[STRICTSIZE={0 | 1}]</wrap> <wrap>[R</wrap><wrap>O | NORING | </wrap>__<wrap>RW</wrap>__<wrap> | __RING__</wrap><wrap>]</wrap> <wrap>[DEONIRQ={0 |1}]</wrap> <wrap>[NOAUTOMOUNT]</wrap> |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype</wrap>// </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬ </wrap>//<wrap>hetfile </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>⡿¬¬¬¬¬¬*¬¬¬¬¬¬¯</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 196</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>//<wrap>arguments</wrap>// <wrap>where arguments can be</wrap><wrap>:</wrap> <wrap>ª¬¬¬ AWSTAPE</wrap> <wrap>i</wrap><wrap>¬¬¬ COMPRESS= ¬¬¬§¬¬¬ 0 </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I </wrap><wrap>⡿¬¬¬1¬¬¬</wrap> <wrap>i</wrap><wrap>¬¬¬ IDRC= ¬¬¬§¬¬¬ 0 </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I </wrap><wrap>⡿¬%%__%%_ 1¬¬¬</wrap> <wrap>i</wrap><wrap>¬¬¬ METHOD= ¬¬¬§¬¬¬ </wrap><wrap>1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I </wrap><wrap>⡿¬¬¬2¬¬¬</wrap> <wrap>i</wrap><wrap>¬¬¬ LEVEL= ¬¬¬§¬¬¬ </wrap><wrap>4 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I </wrap><wrap>⡿¬¬¬</wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> <wrap>i¬¬¬ CHUNKSIZE= ¬¬¬§¬¬¬ </wrap>__<wrap>65535</wrap>__<wrap> ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I </wrap><wrap>⡿¬¬¬</wrap>//<wrap>nnnnn </wrap>//<wrap>¬¬¬</wrap> <wrap>ª</wrap><wrap>¬¬¬§¬¬¬MAXSIZE= ¬¬¬¬§¬¬¬ 0 </wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I</wrap> <wrap> ⡿¬¬¬</wrap>//<wrap>n </wrap>//<wrap>¬¬¬§¬¬¬ K ¬¬¬I </wrap><wrap></wrap> <wrap> ª¬¬¬M¬¬¬« </wrap> <wrap> ª¬¬¬G¬¬¬« </wrap> <wrap> ⡿¬¬¬ T ¬¬¬¯ \\ ª¬¬¬ MAXSIZEK= ¬¬¬§¬¬¬0 ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¯</wrap> <wrap> ⡿¬¬¬</wrap>//<wrap>n </wrap>//<wrap>¬¬¬¯ \\ ⡿¬¬¬MAXSIZEM= ¬¬¬§¬¬¬ 0 </wrap><wrap>¬¬¬§¬¬¬</wrap><wrap>¯</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap><wrap>¯</wrap> |<WRAP><wrap>[¬¬¬ EOTMARGIN= ¬¬¬ </wrap>//<wrap>n</wrap>// </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I </wrap><wrap>ª</wrap><wrap>¬¬¬ K ¬¬¬I </wrap><wrap>ª</wrap><wrap>¬¬¬ </wrap><wrap>M</wrap><wrap>¬¬¬I </wrap><wrap>ª</wrap><wrap>¬¬¬ </wrap><wrap>G</wrap><wrap>¬¬¬I </wrap><wrap>⡿¬¬¬</wrap><wrap>T ¬¬¬</wrap><wrap>¯</wrap> </WRAP> | <wrap>i</wrap><wrap>¬¬¬ READONLY= ¬¬¬§¬¬¬ 0 </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I </wrap><wrap>⡿¬¬¬1¬¬¬</wrap> __<wrap>i</wrap>__<wrap>¬¬¬ STRICTSIZE= ¬¬¬§¬¬¬ 0 </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I </wrap><wrap>⡿¬¬¬1¬¬¬</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 197</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>ª</wrap><wrap>%%__%%_§%%__%%%%__%%_ R0 _</wrap><wrap>¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%_ N0RING %%__%%_«</wrap> <wrap>ª%%__%%%%__%%_ </wrap>__<wrap>RW</wrap>__<wrap> ¬¬¬¬¬«</wrap> <wrap>⡿%%__%%%%__%%__RING__ %%__%%%%__%%</wrap> <wrap>ª</wrap><wrap>%%__%%_ DE0NIRQ= %%__%%_§%%__%%_ 0 %%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿%%__%%_ %%__%%_</wrap> __<wrap>[</wrap>__<wrap>%%__%%_ N0AUT0M0UNT</wrap> **<wrap>6.8.4.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid device types are 3410, 3420, 3422, 3430, 3480, 3490, 8809 and 9347.</wrap> **//<wrap>hetfile </wrap>//**<wrap>The filename (and path) of the HET file or “*”. An asterisk defines an empty tape station. The tape must be manually loaded on request.</wrap> <wrap>If the filename starts with the “@” character (at sign), the file then describes a list of tape emulation files to be loaded in succession. The syntax of each line in this file is identical to the information that can be coded directly after the device type in the overall configuration file. Any emulation file name parameter specified in this file may be substituted by the character “*”, in which case it specifies a set of options to be applied to all additional emulation files specified in the list.</wrap> <wrap>This function emulates an Automatic Cartridge Feeder (ACF). The ACF is a feature on cartridge type tape drives (3480, 3490, etc.) that automatically loads a new tape when a tape is removed from the drive. There is no real control over this device by the host as it just keeps on feeding tapes one after the other. Although the ACF feature is unique to cartridge type systems, the emulation accepts the use of the same technique for emulated 1/2 inch tapes reel drives as well.</wrap> <wrap>Parameters are appended in succession. In all cases, if the same parameter is coded more than once, the last instance takes precedence. Therefore it is possible to specify a set of parameters in the base configuration file, another on an “*” line and another for each individual line in the list of files. Parameters are then appended in that order. A SCSI tape device should not be given in a file list!</wrap> **<wrap>AWSTAPE </wrap>**<wrap>The AWSTAPE argument causes HET files to be written in AWSTAPE format. This disables the additional feature provided by the HET format.</wrap> **<wrap>IDRC= </wrap>**<wrap>COMPRESS and IDRC control whether compression should be used when writing to HET files. The value of //n //can be “1” to turn compression on (the default), or can be “0” to turn compression off. IDRC is currently a synonym for COMPRESS but may be used in the future to control another emulated tape drive feature. Therefore COMPRESS is the preferred method to turn compression on or off.</wrap> **<wrap>COMPRESS= </wrap>**<wrap>This is the same as IDRC=.</wrap> **<wrap>METHOD= </wrap>**<wrap>The METHOD argument allows you to specify which compression method to use. A</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 198</wrap> <wrap>\\ </wrap><wrap>value of “1” forces the use of ZLIB compression. A value of “2” forces the use of BZIP2 compression. The default is “1”.</wrap> **<wrap>LEVEL= </wrap>**<wrap>The LEVEL option controls the level of compression. It ranges from “1” (for fastest compression) to “9” (for best compression). The default compression level is “4”.</wrap> **<wrap>CHUNKSIZE= </wrap>**<wrap>The CHUNKSIZE option allows you to create HET files with different chunk sizes. The AWSTAPE (and therefore HET) formats allow each tape block to be logically broken up into smaller chunks. For instance, if the S/3x0 application creates tapes with a block size of 27998, those blocks would be broken down into //nnnnn //sized chunks. Although possible it is not recommended to change the chunk size, as decreasing this may reduce compression performance. The range of //nnnnn //is from 4096 to 65535. 65535 is the default.</wrap> **<wrap>STRICTSIZE= </wrap>**<wrap>Upon reaching the tape file size limit, depending on strictsize, the tape file will or will not be truncated to enforce the maxsize limit. The limit is only enforced during a write type operation. If the file already exists and the program only reads the file, then the file will not be truncated, regardless of the strictsize setting.</wrap> <wrap>This affects any write that starts below the limit, but that would extend beyond the limit. The strictsize parameter only affects compressed HET files. On AWS tapes, the limit is always enforced, but the file is not truncated (the write does not occur, because first AWS tapes are never truncated and second the effects of the write are known in advance).</wrap> <wrap>Regardless of strictsize, any write operation (Write, Write TM) will return a Unit Check with Equipment Check to the program if the file size exceeds the predefined limit. If strictsize is “0”, the write will actually have been performed on the tape file. When strictsize is set to “1”, the file will be truncated on the preceding tape block boundary.</wrap> <wrap>Care must be taken that regardless of the strictsize setting, the tape may become unusable for the guest program should such an event occur (absence of a Tape Mark for example). This option has no effect if maxsize is 0. The default is “0” (do not truncate).</wrap> <wrap>The remaining parameters are described in section 6.8.6 (“Common parameters for AWS, HET and FakeTape virtual files”).</wrap> **<wrap>6.8.4.4 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 3490 tape device on device address 0580. The tape device is a HET virtual file with name "R0674A.HET" located in path "/S390/TAPES/". BZIP2 compression has to be turned on at a level of 9 (best compression).</wrap> <wrap>0580 3490 /S390/TAPES/R0674A.HET COMPRESS=1 METHOD=2 LEVEL=9</wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 3490 tape device on device address 0580. The tape device is a HET virtual file with name "R0675A.HET" located in path "/S390/TAPES/". Mount the tape as read/write.</wrap> <wrap>0580 3490 /S390/TAPES/R0675A.HET RING</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 199</wrap> <wrap>\\ </wrap>**//<wrap>6.8.5 Fake Tape virtual files</wrap>//** **<wrap>6.8.5.1 Function</wrap>** <wrap>Fake Tape virtual files contain a complete tape in one file. FakeTape files consist of variable length EBCDIC blocks. Each block is preceded by a 12-byte ASCII-hex-character header. Filemarks are represented by a 12-byte character header with no data. The FakeTape format is used by the Flex-ES system from Fundamental Software Inc (FSI). The argument specifies the location of the FakeTape file (for example “ickdsf.fkt”). "FLEX-ES" and "FakeTape" are trademarks of Fundamental Software, Inc.</wrap> **<wrap>6.8.5.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>//<wrap>{</wrap>//<wrap>fakefile </wrap>//<wrap>| *} [</wrap>//<wrap>arguments</wrap>//<wrap>]</wrap> <wrap>where arguments can be</wrap><wrap>:</wrap> <wrap>[MAXSIZE={</wrap>//<wrap>n</wrap>//<wrap>[K | M | G | T] | 0}|</wrap> <wrap>MAXSIZEK={</wrap>//<wrap>n </wrap>//<wrap>| 0} |</wrap> <wrap>MAXSIZEM={</wrap>//<wrap>n </wrap>//<wrap>| 0}]</wrap> <wrap>[EOTMARGIN=</wrap>//<wrap>n</wrap>//<wrap>[K | M | G | T]]</wrap> <wrap>[READONLY={0 | 1}]</wrap> <wrap>[RO | NORING | </wrap>__<wrap>RW</wrap>__<wrap> | __RING__</wrap><wrap>]</wrap> <wrap>[</wrap><wrap>DEONIRQ={0 |1}]</wrap> <wrap>[NOAUTOMOUNT]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬§¬¬¬ </wrap>//<wrap>fakefile </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>⡿¬¬¬¬¬¬*¬¬¬¬¬¬¬</wrap> //<wrap>arguments</wrap>// <wrap>where arguments can be</wrap><wrap>:</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 200</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**<wrap>ª</wrap>****<wrap>---§---MAXSIZE= ----§--- 0 </wrap>**<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> **<wrap> ⡿--- </wrap>**//<wrap>n </wrap>//<wrap>¬¬¬§¬¬¬ K ¬¬¬« </wrap>**<wrap></wrap>** **<wrap> ª</wrap>**<wrap>¬¬¬ </wrap>**<wrap>M</wrap>**<wrap>¬¬¬« </wrap>**<wrap></wrap>** **<wrap> ª---G ---« </wrap>** **<wrap> ⡿---T ---¯ </wrap>** **<wrap>ª---MAXSIZEK= ---§--- 0 ---§---§---------¯</wrap>** **<wrap>⡿---</wrap>**//<wrap>n </wrap>//**<wrap>---¯ \\ ⡿---MAXSIZEM= ---§--- 0 </wrap>**<wrap>¬¬¬§¬¬¬</wrap>**<wrap>¯</wrap>** **<wrap>⡿---</wrap>**//<wrap>n </wrap>//<wrap>¬¬¬</wrap>**<wrap>¯</wrap>** |<WRAP>**<wrap>I--- EOTMARGIN= --- </wrap>**//<wrap>n</wrap>// </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>ª</wrap>**<wrap>¬¬¬ K ¬¬¬« </wrap>**<wrap>ª</wrap>**<wrap>¬¬¬ </wrap>**<wrap>M </wrap>**<wrap>¬¬¬« </wrap>**<wrap>ª</wrap>**<wrap>¬¬¬ </wrap>**<wrap>G </wrap>**<wrap>¬¬¬« </wrap>**<wrap>⡿--- </wrap>**<wrap>T ¬¬¬</wrap>**<wrap>¯</wrap>** </WRAP> | **<wrap>ª</wrap>****<wrap>--- READONLY= ---§--- 0 </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>⡿--- 1 ---</wrap>**<wrap></wrap> **<wrap>ª</wrap>****<wrap>---§-----RO-</wrap>**<wrap>¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>**<wrap>ª---NORING---«</wrap>** **<wrap>ª-----</wrap>**__<wrap>RW</wrap>__<wrap> ¬¬¬¬¬«</wrap> **<wrap>⡿----</wrap>**<wrap></wrap> **<wrap>%%__%%%%__%% </wrap>****__<wrap>RING</wrap>__****<wrap> ----</wrap>**<wrap></wrap> **<wrap>I</wrap>****<wrap>DEONIRQ= ---§--- 0 ---§----------------------------------------</wrap>**<wrap>¬¬¬¬¬¬¬¬¬¬«</wrap> **<wrap>⡿--- 1 ---</wrap>**<wrap></wrap> **<wrap>I NOAUTOMOUNT</wrap>** **<wrap>6.8.5.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid device types are 3410, 3420, 3422, 3430, 3480, 3490, 8809 and 9347.</wrap> **//<wrap>fakefile </wrap>//**<wrap>The filename (and path) of the Fake Tape virtual file or “*”. An asterisk defines an empty tape station. The tape must be manually be loaded on request.</wrap> <wrap>If the filename starts with the “@” character (at sign), the file then describes a list of tape emulation files to be loaded in succession. The syntax of each line in this file is identical to the information that can be coded directly after the device type in the overall configuration file. Any emulation file name parameter specified in this file may be substituted by the character “*”, in which case it specifies a set of options to be applied to all additional emulation files specified in the list.</wrap> <wrap>This function emulates an Automatic Cartridge Feeder (ACF. The ACF is a feature on Cartridge type tape drives (3480, 3490, etc..) that automatically loads a new tape when a tape is removed from the drive. There is no real control over this device by the host as it just keeps on feeding tapes one after the other. Although the ACF feature is unique to cartridge type systems, the emulation accepts the use of</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 201</wrap> <wrap>\\ </wrap><wrap>the same technique for emulated 1/2 inch tapes reel drives as well.</wrap> <wrap>Parameters are appended in succession. In all cases, if the same parameter is coded more than once, the last instance takes precedence. Therefore it is possible to specify a set of parameters in the base configuration file, another on an “*” line and another for each individual line in the list of files. Parameters are then appended in that order. A SCSI tape device should not be given in a file list.</wrap> <wrap>The remaining parameters are described in section 6.8.6 (“Common parameters for AWS, HET and FakeTape virtual files”).</wrap> **<wrap>6.8.5.4 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 3490 tape device on device address 0580. The tape device is an Fake Tape virtual file named "R0528A.FKT" located in path "/S390/TAPES/".</wrap> <wrap>0580 3490 /S390/TAPES/R0528A.FKT</wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 3490 tape device on device address 0580. The tape device is an Fake Tape virtual file named "R0528A.FKT" located in path "/S390/TAPES/". Mount the tape as read-only and present a device end if intervention is required during tape motion.</wrap> <wrap>0580 3490 /S390/TAPES/R0528A.FKT NORING DEONIRQ=1</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 202</wrap> <wrap>\\ </wrap>**//<wrap>6.8.6 Common parameters for AWS, HET and Fake Tape virtual files</wrap>//** **<wrap>MAXSIZE= </wrap>**<wrap>This specifies the maximum number of bytes for the emulated file. The value is either //n //bytes or //nx //where x specifies the multiplier K, M, G, or T (see ”Table 10” at the end of this section for details). Specifying zero for this parameter means “unlimited” (there is no limit on the file size). MAXSIZE defaults to “0”.</wrap> **<wrap>MAXSIZEK= </wrap>**<wrap>This is the same as MAXSIZE=, but specified in Kilobytes.</wrap> **<wrap>MAXSIZEM= </wrap>**<wrap>This is the same as MAXSIZE=, but specified in Megabytes.</wrap> **<wrap>EOTMARGIN= </wrap>**<wrap>Specifies the number of bytes remaining (before reaching //MAXSIZEx//) at which point the tape device will signal the presence of the “End-of-Tape” marker (reflector), thus allowing the program to switch to the next tape. The value is either //n //bytes or //nx //where x specifies the multiplier K, M, G, or T (see “Table 10” at the end of this section for details).</wrap> **<wrap>READONLY= </wrap>**<wrap>Specifies whether the tape is mounted read-only (without a write ring or with the cartridge protect switch set to "write protect"). A parameter of 1 means read-only; a parameter of 0 means read-write. If READONLY=1, RO or NORING is not specified; READONLY=0 is the default. Note that READONLY=0 does not override the host system file permission settings for the underlying AWS or HET file. If the AWS or HET file is marked read-only, the tape will be mounted read-only despite specification of READONLY=0.</wrap> **<wrap>RO </wrap>**<wrap>Specifies that the tape is mounted read-only (without a write ring or with the cartridge protect switch set to "write protect"). RO and NORING are equivalent to READONLY=1.</wrap> **<wrap>NORING </wrap>**<wrap>This is the same as RO.</wrap> **<wrap>RW </wrap>**<wrap>Specifies that the tape should be mounted read-write, if possible. RW and RING are equivalent to READONLY=0. This is the default if READONLY=1, RO or NO-RING is not specified. Note that RW and RING do not override the host system file permission settings for the underlying AWS or HET file. If the AWS or HET file is marked read-only, the tape will be mounted read-only despite specification of RW or RING.</wrap> **<wrap>RING </wrap>**<wrap>This is the same as RW.</wrap> **<wrap>DEONIRQ= </wrap>**<wrap>Specifies whether a device end is presented if intervention is required during tape motion. A parameter of 1 selects this option; a parameter of 0 turns it off.</wrap> **<wrap>NOAUTOMOUNT </wrap>**<wrap>Indicates that support for guest-initiated automatic tape volume mounting is to always be disabled for this tape device. Automatic guest tape-mount support is automatically globally enabled for all virtual (non-SCSI) tape devices by default whenever an allowable automount directory is defined via the AUTOMOUNT system parameter or the automount console command. The NOAUTOMOUNT option allows you to specifically disable such support for a given device.</wrap> <wrap>The automount feature enables software running in guest operating systems to automatically mount, unmount and/or query for themselves the host "virtual tape volume" filename mounted on a tape drive, via the use of special CCW opcodes (0x4B Set Diagnose and 0xE4 Sense ID) without any intervention on the part of the Hercules operator. An example of such a program for DOS/VSE called TMOUNT is provided in the util subdirectory of the distributed source code.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 203</wrap> <wrap>\\ </wrap><wrap>This is a sticky option. When specified, automount support for the device remains disabled until the option is specifically removed via a devinit command without the option specified. This means if NOAUTOMOUNT is enabled for a device while global automount functionality is currently disabled (because no AUTOMOUNT statement was specified at Hercules startup), then automount functionality remains disabled for the device even should global automount functionality be later manually enabled via an automount con-sole command.</wrap> <wrap>When the 0x4B Set Diagnose CCW is used to auto-mount a virtual tape volume onto a given tape drive, an absolute (fully-qualified) pathname should normally always be specified, but need not be if a path relative to the currently defined "default allowable" automount directory is used instead.</wrap> <wrap>The default allowable automount directory is always the first "allowable" directory that was defined, or else the current directory if no allowable directories were specifically defined. There is always a default allowable directory whenever any allowable or unallowable automount directories are defined.</wrap> <wrap>Fully-resolved, absolute-full-path filenames are defined as being those which, for Windows, have a ':' (colon) in the second position or, for other host operating systems (e.g. Linux), have a '/' (slash) in the first position. Pathes which start with a '.' (period) are considered relative paths and will always be appended to the currently defined default allowable automount directory, before being resolved into fully-qualified paths by the host system (i.e. only fully-resolved absolute pathnames are used in the performance of the actual automatic tape volume mount).</wrap> <wrap>For example, if more than one allowable automount directory is defined and the volume wishing to be mounted happens to reside in the second one, then a fully-qualified absolute pathname should of course be specified (or else one that is relative to the default directory which happens to resolve to the desired file).</wrap> <wrap>All attempts to automount host files in any defined "disallowable" directory (or any subdirectory thereof [or otherwise //not //within any defined "allowable" directory or subdirectory]) will be rejected. An error message is always issued in such cases, just as one is whenever a successful mount or unmount is performed.</wrap> <wrap>A sample guest automount program called TMOUNT for the DOS/VSE operating system is provided in the "util" subdirectory of the distributed source code.</wrap> **<wrap>6.8.6.1 Multipliers for ‘MAXSIZE=’ and ‘EOTMARGIN=’ parameters</wrap>** |<WRAP>**<wrap>Unit</wrap>** </WRAP> |<WRAP>**<wrap>Multiplier</wrap>** </WRAP> |<WRAP>**<wrap>Name (Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>IEC Name (IEC Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>Restrictions</wrap>** </WRAP> | |<WRAP><wrap>K</wrap> </WRAP> |<WRAP><wrap>2%%**%%10</wrap> </WRAP> |<WRAP><wrap>Kilobyte (kB)</wrap> </WRAP> |<WRAP><wrap>Kibibyte (KiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>M</wrap> </WRAP> |<WRAP><wrap>2%%**%%20</wrap> </WRAP> |<WRAP><wrap>Megabyte (MB)</wrap> </WRAP> |<WRAP><wrap>Mebibyte (MiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>G</wrap> </WRAP> |<WRAP><wrap>2%%**%%30</wrap> </WRAP> |<WRAP><wrap>Gigabyte (GB)</wrap> </WRAP> |<WRAP><wrap>Gibibyte (GiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>T</wrap> </WRAP> |<WRAP><wrap>2%%**%%40</wrap> </WRAP> |<WRAP><wrap>Terabyte (TB)</wrap> </WRAP> |<WRAP><wrap>Tebibyte (TiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | **<wrap>Table 10: Multipliers for ‘MAXSIZE=’ and ‘EOTMARGIN=’ parameters</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 204</wrap> <wrap>\\ </wrap>**//<wrap>6.8.7 Basic ACF (Automatic Cartridge Feeder) Support</wrap>//** **<wrap>6.8.7.1 Function</wrap>** <wrap>The ACF (Automatic Cartridge Feeder) is a feature on cartridge type tape drives (3480, 3490, etc.) that automatically loads a new tape when a tape is removed (ejected) from the drive. There is no real control over this functionality by the host as the device just keeps on feeding tapes one after the other.</wrap> <wrap>Although the ACF features is unique to cartridge type tape systems the emulation accepts to use the same technique for emulated 1/2 inch tapes reel drives as well. ACF is supported through a file that contains a list of files (emulated tapes or cartridges) that will be loaded one after the other.</wrap> <wrap>To manually reset the ACF to the top of the stack the DEVINIT panel command can be used to "reload" the ACF feature.</wrap> **<wrap>6.8.7.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>////<wrap>?filename </wrap>//<wrap>[</wrap>//<wrap>arguments</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬ </wrap>//<wrap>?filename</wrap>// //<wrap>arguments</wrap>// **<wrap>6.8.7.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid device types are 3410, 3420, 3422, 3430, 3480, 3490, 8809 and 9347.</wrap> **//<wrap>@filename </wrap>//**<wrap>The filename (without the prefixing ‘@’) contains a list of files that will be loaded one after the other. The filenames contained in the file list cannot describe another ACF file nor an SCSI tape handle (/dev/st//x//). However the files may be standard AWS, HET, Fake Tape or OMA files.</wrap> **//<wrap>arguments </wrap>//**<wrap>These are the same arguments that apply to the AWS, HET, Fake Tape or OMA files, as described above.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 205</wrap> <wrap>\\ </wrap>**<wrap>6.8.7.4 Syntax ACF description file</wrap>** **<wrap># //comment line//</wrap>** **//<wrap>* arguments</wrap>//** **//<wrap>filename </wrap>//****<wrap>[//arguments//]</wrap>** **<wrap>6.8.7.5 Parameter</wrap>** **<wrap># </wrap>**<wrap>The hash symbol starts a comment line.</wrap> **<wrap>* </wrap>**<wrap>Any options following the asterisk are applied to each file of the list, followed by the options specified on the device configuration entry, followed by the options specified on each individual entry of the file list. Care must be taken that all ‘*’ lines are processed at once.</wrap> **//<wrap>filename </wrap>//**<wrap>The filename (and path) of the AWS, HET, Fake Tape or OMA tape file.</wrap> **//<wrap>arguments </wrap>//**<wrap>These are the same arguments that apply to the AWS, HET, Fake Tape or OMA files, as described above. The arguments are processed in the order in which they appear. Any conflicting argument overrides the previous one.</wrap> **<wrap>6.8.7.6 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 3490 Automatic Cartridge Feeder (ACF) on device address 0589. ZLIB compression is turned on. The file "newstack" describes a list of tape emulation files to be loaded in succession.</wrap> <wrap>a)<wrap></wrap></wrap><wrap>Hercules configuration file:</wrap> <wrap>0589 3490 @NEWSTACK COMPRESS=1</wrap> <wrap>b)<wrap></wrap></wrap><wrap>“NEWSTACK” file:</wrap> <wrap>* MAXSIZEM=16 EOTMARGIN=131072</wrap> <wrap>tape01.aws COMPRESS=0</wrap> <wrap>tape02.het MAXSIZEM=32 EOTMARGIN=65536</wrap> <wrap>tape03.het MAXSIZE=0</wrap> <wrap>The above example is equivalent to issuing the following (one at the start and one after each tape unload):</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 206</wrap> <wrap>\\ </wrap><wrap>a)<wrap></wrap></wrap><wrap>in the configuration file:</wrap> <wrap>180 3420 tape01.aws maxsizeM=16 eotmargin=131072 compress=0</wrap> <wrap>b) via devinit panel command:</wrap> <wrap>devinit 180 tape02.het compress=1 maxsizeM=32 eotmargin=65536 devinit 180 tape03.het eotmargin=131072 compress=1 maxsize=0</wrap> **<wrap>Example 2:</wrap>** <wrap>Resolution of the arguments using ‘*’ lines. \\ The following ACF file</wrap> <wrap>* compress=0 \\ tape01.aws \\ * compress=1 \\ tape02.aws</wrap> <wrap>is equivalent to this one</wrap> <wrap>* compress=1 \\ tape01.aws \\ tape02.aws</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 207</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.9 Channel-to-Channel Adapters \\ //6.9.1 Introduction//</wrap>** <wrap>The Channel-to-Channel Adapter device statements define CTC adapters to the Hercules configuration. All of the communications emulation implemented within Hercules use a CTCA (Channel-to-Channel Adapter) type device. Depending on the type, the CTCA device will provide either a point-to-point or a virtual network adapter interface to the driving system's TCP/IP stack or in the case of CTCT, a true CTCA connection to another instance of Hercules via a TCP/IP connection.</wrap> <wrap>All current emulations, with the exception of VMNET and CTCT use the Universal TUN/TAP driver on Linux and TunTap32 (WinPCap) on the Windows platforms which creates a network interface on the driving system which allow Hercules to present frames to, and receive frames from the TCP/IP stack. This network interface is configured on Linux platforms by the ‘hercifc’ program which is invoked by Hercules after the TUN/TAP device is opened.</wrap> <wrap>The following are the emulation types currently supported:</wrap> |<WRAP><wrap>·</wrap><wrap></wrap> </WRAP> |<WRAP><wrap>CTCI</wrap> </WRAP> |<WRAP><wrap>(Channel-to-Channel link to TCP/IP stack)</wrap> </WRAP> | |<WRAP><wrap>·</wrap><wrap></wrap> </WRAP> |<WRAP><wrap>CTCT</wrap> </WRAP> |<WRAP><wrap>(Channel-to-Channel emulation via TCP Connection)</wrap> </WRAP> | |<WRAP><wrap>·</wrap><wrap></wrap> </WRAP> |<WRAP><wrap>LCS</wrap> </WRAP> |<WRAP><wrap>(LAN Channel Station emulation)</wrap> </WRAP> | |<WRAP><wrap>·</wrap><wrap></wrap> </WRAP> |<WRAP><wrap>PTP</wrap> </WRAP> |<WRAP><wrap>(MPCPTP/PCPTP6 Channel-to-Channel link)</wrap> </WRAP> | <wrap>·<wrap></wrap></wrap><wrap>VMNET (Channel-to-Channel link via SLIP/VMNET)</wrap> **//<wrap>6.9.2 CTCI (Channel-to-Channel link to TCP/IP stack)</wrap>//** **<wrap>6.9.2.1 Function</wrap>** <wrap>The CTCI is a point-to-point connection with the TCP/IP stack of the driving system on which Hercules is running.</wrap> **<wrap>6.9.2.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap> |<WRAP>**<wrap>Descriptive</wrap>** </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP>//<wrap>devaddr </wrap>//<wrap>CTCI</wrap> </WRAP> |<WRAP><wrap>[{-n</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>--dev} //name//]</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>[{-s</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>--netmask} //mask//]</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>[{-m</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>--macaddr} //mac //| 00:00:5E:nn:nn:nn}]</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>[{-t</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>--mtu} //mtu //| 1500]</wrap> </WRAP> |<WRAP><wrap>*Linux only</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>[{-i</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>--ibuff} {//ibuff //| 64}]</wrap> </WRAP> |<WRAP><wrap>*Windows only</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>[{-k</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>--kbuff} {//kbuff //| 1024}]</wrap> </WRAP> |<WRAP><wrap>*Windows only</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>[-d</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>--debug]</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | //<wrap>guestip hostip</wrap>// <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 208</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ CTCI ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬</wrap> <wrap>ª¬¬¬¬¬</wrap><wrap>-n ¬¬¬¬§¬¬¬ </wrap>//<wrap>name \\ </wrap>//<wrap>⡿¬¬¬</wrap><wrap>--</wrap><wrap>dev ¬¬¬</wrap> <wrap>ª¬¬¬¬¬¬¬</wrap><wrap>-s ¬¬¬¬¬¬§¬¬¬ </wrap>//<wrap>mask \\ </wrap>//<wrap>⡿¬¬¬</wrap><wrap>--netmask </wrap><wrap>¬¬¬</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê </wrap><wrap>ª</wrap><wrap>¬¬¬¬¬</wrap><wrap>-m ¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬ </wrap>//<wrap>mac </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap><wrap>--</wrap><wrap>mac¬¬¬¯ ⡿¬¬¬</wrap>__<wrap>00:00:5E:nn:nn:nn</wrap>__<wrap> ¬¬¬¯</wrap> <wrap>§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ \\ </wrap><wrap>ª¬¬¬¬¬</wrap><wrap>-t ¬¬¬¬§¬¬¬ </wrap>//<wrap>mtu \\ </wrap>//<wrap>⡿¬¬¬</wrap><wrap>--</wrap><wrap>mtu ¬¬¬</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê </wrap><wrap>ª¬¬¬¬¬¬</wrap><wrap>-i ¬¬¬¬¬§¬¬¬§¬¬¬ </wrap>//<wrap>ibuff </wrap>//<wrap>¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap><wrap>--</wrap><wrap>ibuff ¬¬¬I I¬¬¬¬ </wrap>__<wrap>64</wrap>__<wrap> ¬¬¬¬¬¯</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê </wrap><wrap>ª¬¬¬¬¬¬</wrap><wrap>-k ¬¬¬¬¬§¬¬¬§¬¬¬ </wrap>//<wrap>kbuff </wrap>//<wrap>¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap><wrap>--</wrap><wrap>kbuff ¬¬¬I I¬¬¬ </wrap>__<wrap>1024</wrap>__<wrap> ¬¬¬¬¯</wrap> |<WRAP><wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ \\ </wrap><wrap>ª¬¬¬¬¬</wrap><wrap>-d ¬¬¬¬¬¬« \\ </wrap><wrap>⡿¬¬¬</wrap><wrap>--debug </wrap><wrap>¬¬¬¯</wrap> </WRAP> |<WRAP>//<wrap>guestip </wrap>//<wrap>¬¬¬ </wrap>//<wrap>hostip</wrap>// </WRAP> | **<wrap>6.9.2.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **<wrap>CTCI </wrap>**<wrap>This specifies the CTCI device/protocol type.</wrap> **<wrap>-n //name //</wrap>**<wrap>For Linux: Specifies the name of the tunnel device to use. The default name is “/dev/net/tun”, which is correct for version 2.4 and above of the Linux kernel.</wrap> <wrap>For Windows: Identifies the host network adapter. If your network adapter does not have a permanent (static) IP address assigned to it (e.g. you use DHCP and have a dynamic IP assigned) then instead of specifying an IP address as the second parameter in the device statement, you must specify the MAC address of the adapter. In this case the second argument (hostip) must be coded as “0.0.0.0”. This is simply a placeholder because two IP addresses are expected to satisfy the device definition syntax.</wrap> **<wrap>--dev //name //</wrap>**<wrap>This is the same as “-n name”.</wrap> **<wrap>-s //mask //</wrap>**<wrap>This is the netmask to be configured on the link. Note: Since this is a point-to-point link netmask is meaningless from the perspective of the actual network device.</wrap> **<wrap>--netmask //mask //</wrap>**<wrap>This is the same as “-s mask”.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 209</wrap> <wrap>\\ </wrap>**<wrap>--m //mac //</wrap>**<wrap>This is the optional hardware address of the interface in the format of either “xx:xx:xx:xx:xx:xx” or “xx-xx-xx-xx-xx-xx”. The default is 00:00:5E:nn:nn:nn where the “//nn:nn:nn” //part is constructed from the last three octets of the specified guestip.</wrap> **<wrap>--macaddr //mac //</wrap>**<wrap>This is the same as “-m mac”.</wrap> **<wrap>-t //mtu //</wrap>**<wrap>Linux only: Specifies the maximum transmission unit size (default 1500 bytes).</wrap> **<wrap>--mtu //mtu //</wrap>**<wrap>This is the same as “-t mtu”.</wrap> **<wrap>-i //ibuff //</wrap>**<wrap>Windows only: This specifies the TunTap32 I/O buffer size in KB. //nnnn //hast to be between 16 and 1024 (1 MB). The default value is 64 KB.</wrap> **<wrap>--ibuff //ibuff //</wrap>**<wrap>This is the same as “-i ibuff”.</wrap> **<wrap>-k //kbuff //</wrap>**<wrap>Windows only: This specifies the WinPcap device driver capture buffer size in KB. //nnnn //hast to be between 64 and 16384 (16 MB). The default value is 1024 (1 MB).</wrap> **<wrap>--kbuff //kbuff //</wrap>**<wrap>This is the same as “-k kbuff”.</wrap> **<wrap>-d </wrap>**<wrap>Specifies that debugging output has to be produced on the Hercules control panel. This should normally be left unspecified.</wrap> **<wrap>--debug </wrap>**<wrap>This is the same as “-d”.</wrap> **//<wrap>guestip </wrap>//**<wrap>Specifies the IP address of the guest operating system running under Hercules.</wrap> **//<wrap>hostip </wrap>//**<wrap>Identifies the host network adapter to use. If the host system is configured with DHCP this should instead be the MAC address of the ethernet adapter you wish to have Hercules use to connect to the outside world. If this parameter is specified using the //-m //or //--dev //option, then the value here must be specified as "0.0.0.0" to satisfy the statement syntax.</wrap> **<wrap>6.9.2.4 Examples \\ </wrap>****<wrap>Example 1:</wrap>** <wrap>Define 3088 CTC adapters on device addresses 0E20 and 0E21. The device/protocol type is CTCI (Channel-to-Channel link to Linux TCP/IP stack). The IP address of the guest operating system running under Hercules is 192.168.1.99, the host IP address (the network adapter) to use is 192.168.1.100.</wrap> <wrap>0E20.2 3088 CTCI 192.168.1.99 192.168.1.100 \\ or</wrap> |<WRAP><wrap>0E20</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>CTCI</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> | |<WRAP><wrap>0E21</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>CTCI</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 210</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Define 3088 CTC adapters on device addresses 0E20 and 0E21. The device/protocol type is CTCI (Channel-to-Channel link to Win32 TCP/IP stack). The WinPcap device driver capture buffer has to be set to 2048 KB, the TunTap32 I/O buffer size has to be set to 128 KB. The IP address of the guest operating system running under Hercules is 192.168.1.99 and the MAC address of the network adapter to use is 00-80-B3-E1-DF-69.</wrap> <wrap>0E20.2 3088 CTCI -n 00-80-B3-E1-DF-69 -k 2048 -i 128 192.168.1.99 0.0.0.0 or</wrap> |<WRAP><wrap>0E20</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>CTCI</wrap> </WRAP> |<WRAP><wrap>-n</wrap> </WRAP> |<WRAP><wrap>00-80-B3-E1-DF-69</wrap> </WRAP> |<WRAP><wrap>-k</wrap> </WRAP> |<WRAP><wrap>2048</wrap> </WRAP> |<WRAP><wrap>-i</wrap> </WRAP> |<WRAP><wrap>128</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>0.0.0.0</wrap> </WRAP> | |<WRAP><wrap>0E21</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>CTCI</wrap> </WRAP> |<WRAP><wrap>-n</wrap> </WRAP> |<WRAP><wrap>00-80-B3-E1-DF-69</wrap> </WRAP> |<WRAP><wrap>-k</wrap> </WRAP> |<WRAP><wrap>2048</wrap> </WRAP> |<WRAP><wrap>-i</wrap> </WRAP> |<WRAP><wrap>128</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>0.0.0.0</wrap> </WRAP> | **<wrap>Example 3:</wrap>** <wrap>Define 3088 CTC adapters on device addresses 0E20 and 0E21. The device/protocol type is CTCI (Channel-to-Channel link to Linux TCP/IP stack). The IP address of the guest operating system running under Hercules is 192.168.1.99, the host IP address (the network adapter) to use is 192.168.1.100.</wrap> <wrap>The maximum transmission size (MTU) should be 1492 bytes. The WinPcap device driver buffer size has to be set to 1024 KB and the TunTap32 I/O buffer size to 256 kB. Additionally debugging output has to be shown on the Hercules console.</wrap> <wrap>0E20.2 3088 CTCI -k 1024 -i 256 –t 1492 –d 192.168.1.99 192.168.1.100 or</wrap> |<WRAP><wrap>0E20</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>CTCI</wrap> </WRAP> |<WRAP><wrap>-k</wrap> </WRAP> |<WRAP><wrap>1024</wrap> </WRAP> |<WRAP><wrap>-i</wrap> </WRAP> |<WRAP><wrap>256</wrap> </WRAP> |<WRAP><wrap>–t</wrap> </WRAP> |<WRAP><wrap>1492</wrap> </WRAP> |<WRAP><wrap>–d</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> | |<WRAP><wrap>0E21</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>CTCI</wrap> </WRAP> |<WRAP><wrap>-k</wrap> </WRAP> |<WRAP><wrap>1024</wrap> </WRAP> |<WRAP><wrap>-i</wrap> </WRAP> |<WRAP><wrap>256</wrap> </WRAP> |<WRAP><wrap>–t</wrap> </WRAP> |<WRAP><wrap>1492</wrap> </WRAP> |<WRAP><wrap>–d</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 211</wrap> <wrap>\\ </wrap>**//<wrap>6.9.3 CTCT (Channel-to-Channel emulation via TCP Connection)</wrap>//** **<wrap>6.9.3.1 Function</wrap>** <wrap>This is an emulated Channel-to-Channel adapter to another Hercules system. CTCT only supports IP traffic and cannot be used to transport NJE, SNA, PVM, etc. type payloads. This may change in the future.</wrap> **<wrap>6.9.3.2 Syntax</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr </wrap>//<wrap>CTCT </wrap>//<wrap>lport rhost rport bufsize</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ CTCT ¬¬¬ </wrap>//<wrap>lport </wrap>//<wrap>¬¬¬ </wrap>//<wrap>rhost </wrap>//<wrap>¬¬¬ </wrap>//<wrap>rport </wrap>//<wrap>¬¬¬ </wrap>//<wrap>bufsize </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> **<wrap>6.9.3.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **<wrap>CTCT </wrap>**<wrap>This specifies the CTCT device/protocol type.</wrap> **//<wrap>lport </wrap>//**<wrap>Specifies the local TCP port. This is the TCP port that Hercules will listen on for this CTC adapter.</wrap> **//<wrap>rhost </wrap>//**<wrap>Specifies the remote host. This is the name or IP address of the remote host system that Hercules is running on, not the name or IP address of the OS running under this instance of Hercules.</wrap> **//<wrap>rport </wrap>//**<wrap>Specifies the remote TCP port. The rport parameter on this system must match the lport parameter on the remote system and vice versa.</wrap> **//<wrap>bufsize </wrap>//**<wrap>Specifies the buffer size for the link. If this link is used for IP traffic this parameter should be more than the MTU of the interface definition in the OS TCPIP stack.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 212</wrap> <wrap>\\ </wrap>**//<wrap>6.9.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define 3088 CTC adapters on device addresses 0400 and 0401. The device/protocol type is CTCT (Channel-to-Channel emulation via TCP connection). The local TCP ports on which Hercules will listen are 30880 and 30881. The IP address of the remote host is 192.168.100.2, the remote ports are also 30880 and 30881. The buffer size for the link is 2048 KB.</wrap> <wrap>0400.2 3088 CTCT 30880 192.168.100.2 30880 2048 \\ or</wrap> |<WRAP><wrap>0400</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>CTCT</wrap> </WRAP> |<WRAP><wrap>30880</wrap> </WRAP> |<WRAP><wrap>192.168.100.2</wrap> </WRAP> |<WRAP><wrap>30880</wrap> </WRAP> |<WRAP><wrap>2048</wrap> </WRAP> | |<WRAP><wrap>0401</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>CTCT</wrap> </WRAP> |<WRAP><wrap>30881</wrap> </WRAP> |<WRAP><wrap>192.168.100.2</wrap> </WRAP> |<WRAP><wrap>30881</wrap> </WRAP> |<WRAP><wrap>2048</wrap> </WRAP> | **//<wrap>6.9.5 CTCE (Enhanced Channel-to-Channel emulation via TCP Connection)</wrap>//** **<wrap>6.9.5.1 Function</wrap>** <wrap>The CTCE device type will emulate a real 3088 Channel-to-Channel Adapter also for non-IP traffic, enhancing the CTCT capabilities. CTCE connections are also based on TCP/IP between two (or more) Hercules instances, and requires an even-odd pair of port numbers per device side.</wrap> <wrap>Only the even port numbers are to be configured; the odd numbers are just derived by adding 1 to the configured even port numbers. The socket connection pairs cross-connect, the arrows are showing the the send -> receive direction:</wrap> <wrap>InstanceA-lport-even -> InstanceB-rport-odd \\ InstanceB-lport-odd <- InstanceA-rport-even</wrap> <wrap>CTCE connected Hercules instances can be hosted on either Unix or Windows platforms, both sides do not need to be the same.</wrap> **<wrap>6.9.5.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr CTCE lport raddress rport [mtu [sml]]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ devaddr ¬¬¬ CTCE ¬¬¬ lport ¬¬¬ raddress ¬¬¬ rport ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap>// //<wrap>mtu</wrap>// //<wrap>sml</wrap>// <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 213</wrap> <wrap>\\ </wrap>**//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **<wrap>CTCE </wrap>**<wrap>This specifies the device/protocol type.</wrap> **//<wrap>lport </wrap>//**<wrap>Specifies the even TCP/IP port on the local system.</wrap> **//<wrap>raddress </wrap>//**<wrap>Specifies the TCP/IP address of the remote system.</wrap> **//<wrap>rport </wrap>//**<wrap>Specifies the even TCP/IP port on the remote system.</wrap> **//<wrap>mtu </wrap>//**<wrap>Optional MTU buffer size. The default size is 32778.</wrap> **//<wrap>sml </wrap>//**<wrap>Optional small minimum for the MTU buffer size. The default size is 8.</wrap> **<wrap>6.9.5.3 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 3088 CTC connection with the CTCE protocol between two Hercules instances. Instance A is using address 192.168.1.100, Instance B is using address 192.168.1.200.</wrap> <wrap>Definitions on Hercules Instance A with IP address 192.168.1.100:</wrap> |<WRAP><wrap>0E40</wrap> </WRAP> |<WRAP><wrap>CTCT</wrap> </WRAP> |<WRAP><wrap>30880</wrap> </WRAP> |<WRAP><wrap>192.168.1.200</wrap> </WRAP> |<WRAP><wrap>30880</wrap> </WRAP> | |<WRAP><wrap>0E41</wrap> </WRAP> |<WRAP><wrap>CTCT</wrap> </WRAP> |<WRAP><wrap>30882</wrap> </WRAP> |<WRAP><wrap>192.168.1.200</wrap> </WRAP> |<WRAP><wrap>30882</wrap> </WRAP> | <wrap>Definitions on Hercules Instance B with IP address 192.168.1.200:</wrap> |<WRAP><wrap>0E40</wrap> </WRAP> |<WRAP><wrap>CTCT</wrap> </WRAP> |<WRAP><wrap>30880</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> |<WRAP><wrap>30880</wrap> </WRAP> | |<WRAP><wrap>0E41</wrap> </WRAP> |<WRAP><wrap>CTCT</wrap> </WRAP> |<WRAP><wrap>30882</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> |<WRAP><wrap>30882</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 214</wrap> <wrap>\\ </wrap>**//<wrap>6.9.6 LCS (LAN Channel Station)</wrap>//** **<wrap>6.9.6.1 Function</wrap>** <wrap>This statement defines an emulated LAN Channel Station adapter. This emulation mode appears to the operating system running in the Hercules machine as an IBM 8232 LCS device, an IBM 2216 router, an IBM 3172 running ICP (Interconnect Communications Program), the LCS3172 driver of an IBM P/390, or an IBM Open Systems Adapter (OSA).</wrap> <wrap>Rather than a point-to-point link, this emulation creates a virtual ethernet adapter through which the guest operating system running in the Hercules machine can communicate. As such, this mode is not limited to TCP/IP traffic, but in fact will handle any ethernet frame.</wrap> **<wrap>6.9.6.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr </wrap>//<wrap>LCS [{-n | --dev} //name] \\ //[{-o | --oat} //file//] \\ [{-m | --mac} //mac//] \\ [-d | --debug]</wrap> <wrap>[//guestip//]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ--- //devaddr //¬¬¬ LCS ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap> <wrap>ª¬¬¬¬-n -----§--- //name \\ //⡿¬¬¬--dev ¬¬¬</wrap> <wrap>ª¬¬¬¬-o -----§--- //file \\ //⡿¬¬¬--oat ¬¬¬</wrap> <wrap>ª¬¬¬¬-m -----§--- //mac \\ //⡿¬¬¬--mac ¬¬¬</wrap> <wrap>Ê</wrap><wrap>---§---------------§---§---------------§-----------------------------------ÊÍ ª¬¬¬¬¬-d ¬¬¬¬¬¬« ⡿¬ ¬¬ //guestip //¬¬¬¯ ⡿¬¬¬--debug ¬¬¬¯</wrap> **<wrap>6.9.6.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the address pair of the LCS device. This pair must be an even-odd address. This can be specified as two separate LCS statements with a single device address (“0E20 LCS...” and “0E21 LCS ...”) or as a single statement with a device address count (“0E20.2 LCS ...”).</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 215</wrap> <wrap>\\ </wrap>**<wrap>LCS </wrap>**<wrap>This specifies the LAN Channel Station (LCS) device/protocol type.</wrap> **<wrap>-n //name //</wrap>**<wrap>Identifies the host network adapter to use:</wrap> <wrap>On Linux systems this is name of the TUN/TAP special character device, normally /dev/net/tun.</wrap> <wrap>On Windows this is either the IP or MAC address of the host systems network card. TunTap32 will automatically select the first network adapter it finds if the option is omitted, this may be not desirable for some users.</wrap> **<wrap>--dev //name //</wrap>**<wrap>This is the same as “-n name”.</wrap> **<wrap>-o //file //</wrap>**//<wrap>file </wrap>//<wrap>specifies the filename of the OSA Address Table (OAT). If this option is specified the optional //--mac //and //guestip //entries are ignored in preference to statements in the OAT file. For a description of the OAT file see next section.</wrap> **<wrap>--oat //file //</wrap>**<wrap>This is the same as “-o file”.</wrap> **<wrap>-m //mac //</wrap>**//<wrap>mac </wrap>//<wrap>is the optional hardware address of the interface coded in the format “xx:xx:xx:xx:xx:xx”. If you use the “-o/--oat” option do not specify an address here, it will be ignored.</wrap> **<wrap>--mac //mac //</wrap>**<wrap>This is the same “-m mac”.</wrap> **<wrap>-d </wrap>**<wrap>Specifies that debugging output has to be produced on the Hercules control panel. This should normally be left unspecified.</wrap> **<wrap>--debug </wrap>**<wrap>This is the same as “-d”.</wrap> **//<wrap>guestip </wrap>//**<wrap>This is an optional IP address of the Hercules (guest OS) side. This is only used to establish a point-to-point routing table entry on the driving system. If you use the “-o/--oat” option do not specify an address here, it will be ignored.</wrap> **<wrap>6.9.6.4 OSA Address Table (OAT) Syntax</wrap>** <wrap>The syntax for the OSA Address Table file is as follows:</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%* * Dev Mode Port Entry specific information...</wrap> <wrap>%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%*</wrap> |<WRAP><wrap>0400</wrap> </WRAP> |<WRAP><wrap>IP</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>PRI</wrap> </WRAP> |<WRAP><wrap>172.021.003.032</wrap> </WRAP> | |<WRAP><wrap>0402</wrap> </WRAP> |<WRAP><wrap>IP</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>SEC</wrap> </WRAP> |<WRAP><wrap>172.021.003.033</wrap> </WRAP> | |<WRAP><wrap>0404</wrap> </WRAP> |<WRAP><wrap>IP</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>NO</wrap> </WRAP> |<WRAP><wrap>172.021.003.038</wrap> </WRAP> | |<WRAP><wrap>0406</wrap> </WRAP> |<WRAP><wrap>IP</wrap> </WRAP> |<WRAP><wrap>01</wrap> </WRAP> |<WRAP><wrap>NO</wrap> </WRAP> |<WRAP><wrap>172.021.002.016</wrap> </WRAP> | |<WRAP><wrap>040E</wrap> </WRAP> |<WRAP><wrap>SNA</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>HWADD 00 02:00:FE:DF:00:42</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 216</wrap> <wrap>\\ </wrap>|<WRAP><wrap>HWADD 01 02:00:FE:DF:00:43</wrap> <wrap>ROUTE 00 172.021.003.032 255.255.255.224</wrap> </WRAP> | **<wrap>Figure 2: OSA Address Table (OAT) File Syntax</wrap>** **<wrap>Dev </wrap>**<wrap>This is the base device address.</wrap> **<wrap>Mode </wrap>**<wrap>This is the operation mode: IP or SNA. (Note: The SNA operation mode is currently not implemented.</wrap> **<wrap>Port </wrap>**<wrap>This is the virtual (relative) adapter number.</wrap> **<wrap>Entry </wrap>**<wrap>This applies only for IP Mode and specifies where a packet with an unknown IP address is forwarded. PRI is the primary default entry, SEC is the entry to use when the primary is not available and NO specifies that this is not a default entry.</wrap> **//<wrap>n.n.n.n </wrap>//**<wrap>This specifies the home IP address.</wrap> <wrap>When the operation mode is IP specify only the even (read) device number //dev. //The odd (write) address will be created automatically. Additionally two other statements can be included in the Address Translation file. These are the HWADD and ROUTE statements.</wrap> <wrap>Use the HWADD statement to specify a hardware (MAC) address for a virtual adapter. The first parameter after the HWADD specifies the relative adapter for which the address is applied.</wrap> <wrap>The ROUTE statement is included for convenience. It allows the ‘hercifc’ program to create a network route for this specific virtual adapter. Please note that it is not necessary to include point-to-point routes for each IP address in the table. This is done automatically by the emulation module.</wrap> <wrap>The read / write devices can be swapped by coding the odd address of the even-odd pair in the OAT. Up to 4 virtual (relative) adapters (00-03) are currently supported.</wrap> <wrap>If no Address Translation file is specified, the emulation module will create the following:</wrap> <wrap>- An ethernet adapter (port 0) for TCP/IP traffic only.</wrap> <wrap>- Two device addresses (devnum and devnum+1).</wrap> **<wrap>6.9.6.5 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define LCS (LAN Channel Station emulation) adapters on device addresses 0440 and 0441. The name of the TUN/TAP special character device is “/dev/net/tun”. The IP address of the Hercules guest OS side is 192.168.200.2.</wrap> <wrap>0440.2 LCS -n /dev/net/tun 192.168.200.2 \\ or</wrap> |<WRAP><wrap>0440</wrap> </WRAP> |<WRAP><wrap>LCS</wrap> </WRAP> |<WRAP><wrap>-n</wrap> </WRAP> |<WRAP><wrap>/dev/net/tun</wrap> </WRAP> |<WRAP><wrap>192.168.200.2</wrap> </WRAP> | |<WRAP><wrap>0441</wrap> </WRAP> |<WRAP><wrap>LCS</wrap> </WRAP> |<WRAP><wrap>-n</wrap> </WRAP> |<WRAP><wrap>/dev/net/tun</wrap> </WRAP> |<WRAP><wrap>192.168.200.2</wrap> </WRAP> | <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 217</wrap> <wrap>\\ </wrap>**//<wrap>6.9.7 PTP (MPCPTP/PCPTP6 Channel-to-Channel link)</wrap>//** **<wrap>6.9.7.1 Function</wrap>** <wrap>The PTP is a point-to-point link to the driving system’s TCP/IP stack. From the point of view of the guest operating system in the Hercules machine it appears to be an MPCPTP and/or MPCPTP6 ESCON CTC link to another guest operating system.</wrap> **<wrap>6.9.7.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr </wrap>//<wrap>PIP [{-n | --dev} </wrap>//<wrap>name</wrap>//<wrap>]</wrap> <wrap>[{-m | --macaddr} </wrap>//<wrap>mac</wrap>//<wrap>]</wrap> <wrap>[{-t | --mtu} </wrap>//<wrap>mtu </wrap>//<wrap>| </wrap>__<wrap>1500</wrap>__<wrap>] *Linux only</wrap> <wrap>[{-i | --ibuff} {</wrap>//<wrap>ibuff </wrap>//<wrap>| </wrap>__<wrap>64</wrap>__<wrap>}] *Windows only</wrap> <wrap>[{-k | --kbuff} {</wrap>//<wrap>kbuff </wrap>//<wrap>| </wrap>__<wrap>1024</wrap>__<wrap>}] *Windows only</wrap> <wrap>[{-4 | --inet}]</wrap> <wrap>[{-6 | --inet6}]</wrap> <wrap>[-d | --debug]</wrap> //<wrap>guest1 host1 \\ </wrap>//<wrap>[</wrap>//<wrap>guest2 host2</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ PIP ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap> <wrap>ª------n ¬¬¬¬§¬¬¬ </wrap>//<wrap>name \\ </wrap>//<wrap>⡿--- --dev ---</wrap><wrap></wrap> <wrap>ª------m ¬¬¬¬§¬¬¬¬¬¬¬ </wrap>//<wrap>mac \\ </wrap>//<wrap>⡿-----mac ---</wrap><wrap></wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>ª----- -t ¬¬¬¬§¬¬¬ </wrap>//<wrap>mtu </wrap>//<wrap>---¯</wrap> <wrap>⡿-----mtu---¯</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ª-------i ¬¬¬¬¬§¬¬¬§¬¬¬ </wrap>//<wrap>ibuff </wrap>//<wrap>¬¬¬«</wrap> <wrap>⡿--- --ibuff ---¯ ⡿---- </wrap>__<wrap>64</wrap>__<wrap> -----¯</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ª------ -k ¬¬¬¬¬§¬¬¬§¬¬¬ </wrap>//<wrap>kbuff </wrap>//<wrap>¬¬¬«</wrap> <wrap>⡿--- --kbuff ---¯ ⡿--- </wrap>__<wrap>1024</wrap>__<wrap> ¬¬--¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 218</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>ª¬¬¬¬¬ </wrap><wrap>-</wrap><wrap>4 ¬¬¬¬¬« ª¬¬¬¬¬ </wrap><wrap>-</wrap><wrap>6 ¬¬¬¬¬¬« ª¬¬¬¬¬ </wrap><wrap>-d ¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬ </wrap><wrap>--inet </wrap><wrap>¬¬¬¯ ⡿¬¬¬ </wrap><wrap>--</wrap><wrap>inet6 ¬¬¬¯ ⡿¬¬¬</wrap><wrap>--debug </wrap><wrap>¬¬¬¯</wrap> <wrap>Ê¬¬¬ </wrap>//<wrap>guest1 </wrap>//<wrap>¬¬¬ </wrap>//<wrap>host1</wrap>// //<wrap>guest2 </wrap>//<wrap>¬¬¬ </wrap>//<wrap>host2</wrap>// **<wrap>6.9.7.3 Parameter</wrap>** **//<wrap>devaddr1-devaddr2 </wrap>//**<wrap>These are the device addresses (address pair) of the PTP device.</wrap> **<wrap>PTP </wrap>**<wrap>This specifies the PTP device/protocol type.</wrap> **<wrap>-n //name //</wrap>**<wrap>For Linux: Specifies the name of the tunnel device to use. The default name is “/dev/net/tun”, which is correct for version 2.4 and above of the Linux kernel.</wrap> <wrap>For Windows: Identifies the host network adapter. If your network adapter does not have a permanent (static) IP address assigned to it (e.g. you use DHCP and have a dynamic IP assigned) then instead of specifying an IP address you must specify the MAC address of the adapter. TunTap32 will automatically select the first network adapter it finds if this option is omitted, this may not be desirable depending on your configuration.</wrap> **<wrap>--dev //name //</wrap>**<wrap>This is the same as “-n name”.</wrap> **<wrap>--m //mac //</wrap>**<wrap>This is the optional hardware address of the interface in the format of either “xx:xx:xx:xx:xx:xx” or “xx-xx-xx-xx-xx-xx”.</wrap> **<wrap>--macaddr //mac //</wrap>**<wrap>This is the same as “-m mac”.</wrap> **<wrap>-t //mtu //</wrap>**<wrap>Linux only: Specifies the maximum transmission unit size (default 1500 bytes).</wrap> **<wrap>--mtu //mtu //</wrap>**<wrap>This is the same as “-t mtu”.</wrap> **<wrap>-i //ibuff //</wrap>**<wrap>Windows only: This specifies the TunTap32 I/O buffer size in KB. //nnnn //hast to be between 16 and 1024 (1 MB). The default value is 64 KB.</wrap> **<wrap>--ibuff //ibuff //</wrap>**<wrap>This is the same as “-i ibuff”.</wrap> **<wrap>-k //kbuff //</wrap>**<wrap>Windows only: This specifies the WinPcap device driver capture buffer size in KB. //nnnn //hast to be between 64 and 16384 (16 MB). The default value is 1024 (1 MB).</wrap> **<wrap>--kbuff //kbuff //</wrap>**<wrap>This is the same as “-k kbuff”.</wrap> **<wrap>-4 </wrap>**<wrap>Indicates that when a host name is specified for //guest1//, it must resolve to an IPv4 address.</wrap> **<wrap>--inet </wrap>**<wrap>This is the same as “-4”.</wrap> **<wrap>-6 </wrap>**<wrap>Indicates that when a host name is specified for //guest1//, it must resolve to an IPv6 address.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 219</wrap> <wrap>\\ </wrap>**<wrap>--inet6 </wrap>**<wrap>This is the same as “-6”.</wrap> **<wrap>-d </wrap>**<wrap>Specifies that debugging output has to be produced on the Hercules control panel. Warning: This will produce a tremendous amount of output to the Hercules console and should therefore normally be left unspecified.</wrap> **<wrap>--debug </wrap>**<wrap>This is the same as “-d”.</wrap> **//<wrap>guest1 </wrap>//**<wrap>Specifies the host name or the IP address of the guest operating system running under Hercules.</wrap> **//<wrap>host1 </wrap>//**<wrap>Identifies the host network adapter to use.</wrap> **//<wrap>guest2 </wrap>//**<wrap>Specifies the host name or the IP address of the guest operating system running under Hercules.</wrap> **//<wrap>host2 </wrap>//**<wrap>Identifies the host network adapter to use.</wrap> <wrap>The values for //guest1 //and //host1 //must both be of the same address family, i.e. both IPv4 or both IPv6.</wrap> <wrap>The values for //guest2 //and //host2//, if specified, must both be of the same address family, i.e. both IPv4 or both IPv6, and must not be of the same address family as //guest1 //and //host1//.</wrap> <wrap>If a host name is specified for //guest1 //and the host name can be resolved to both an IPv4 and an IPv6 address, then use either the “-4/--inet” or the “-6/--inet6” option to specify which address family should be used. If neither the “-4/--inet” or the “-6/--inet6” option is specified then whichever address family the resolver returns first will be used.</wrap> <wrap>If //guest1/host1 //or //guest2/host2 //are IPv4 addresses or are host names that will resolve to IPv4 addresses, //guest1/guest2 //can be followed by the prefix size expressed in CIDR notation, for example 192.168.1.1/24. If the prefix size is specified it can have a value from 0 to 32; if it is not specified then a value of 32 is assumed. The prefix size is used to produce the equivalent subnet mask. For example, a value of 24 produces a subnet mask of 255.255.255.0.</wrap> <wrap>If //guest1/host1 //or //guest2/host2 //are IPv6 addresses, or host names that resolve to IPv6 addresses, then //host1/host2 //can be followed by the prefix size expressed in CIDR notation, for example 2001:db8:3003:1::543:210f/48. If the prefix size is specified it can have a value from 0 to 128; if not specified a value of 128 is assumed.</wrap> <wrap>If //guest1//, //host1//, //guest2 //or //host2 //are numeric IPv6 addresses, they can be coded between braces, for example [2001:db8:3003:1::543:210f].</wrap> **<wrap>6.9.7.4 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a PTP device on addresses 0E20 and 0E21. The IP address of the guest operating system running under Hercules is 192.168.1.99, whereas the host IP address (the network adapter) to use is 192.168.1.100.</wrap> <wrap>0E20.2 PTP 192.168.1.99 192.168.1.100 \\ or</wrap> |<WRAP><wrap>0E20</wrap> </WRAP> |<WRAP><wrap>PTP</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> | |<WRAP><wrap>0E21</wrap> </WRAP> |<WRAP><wrap>PTP</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> | <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 220</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Define PTP (MPCPTP ESCON CTC link) adapters on device addresses 0440 and 0441. The name of the TUN/TAP special character device is “/dev/net/tun”. The IP address of the Hercules guest OS side is 192.168.1.99, the host network adapter to use is 192.168.1.100</wrap> <wrap>0440.2 PTP -n /dev/net/tun 192.168.1.99 192.168.1.100 \\ or</wrap> |<WRAP><wrap>0440</wrap> </WRAP> |<WRAP><wrap>PTP</wrap> </WRAP> |<WRAP><wrap>-n</wrap> </WRAP> |<WRAP><wrap>/dev/net/tun</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> | |<WRAP><wrap>0441</wrap> </WRAP> |<WRAP><wrap>PTP</wrap> </WRAP> |<WRAP><wrap>-n</wrap> </WRAP> |<WRAP><wrap>/dev/net/tun</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>192.168.1.100</wrap> </WRAP> | **<wrap>Example 3:</wrap>** <wrap>Define PTP (MPCPTP ESCON CTC link) adapters on device addresses 0E20 and 0E21. The WinPcap device driver capture buffer has to be set to 2048 KB and the TunTap32 I/O buffer size has to be set to 256 KB. The IP address of the guest operating system running under Hercules is 192.168.1.99 and the MAC address of the network adapter to use is 00-80-B3-E1-DF-69.</wrap> <wrap>0E20.2 3088 PTP -n 00-80-B3-E1-DF-69 -k 2048 -i 256 192.168.1.99 0.0.0.0 or</wrap> |<WRAP><wrap>0E20</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>PTP</wrap> </WRAP> |<WRAP><wrap>-n</wrap> </WRAP> |<WRAP><wrap>00-80-B3-E1-DF-69</wrap> </WRAP> |<WRAP><wrap>-k</wrap> </WRAP> |<WRAP><wrap>2048</wrap> </WRAP> |<WRAP><wrap>-i</wrap> </WRAP> |<WRAP><wrap>256</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>0.0.0.0</wrap> </WRAP> | |<WRAP><wrap>0E21</wrap> </WRAP> |<WRAP><wrap>3088</wrap> </WRAP> |<WRAP><wrap>PTP</wrap> </WRAP> |<WRAP><wrap>-n</wrap> </WRAP> |<WRAP><wrap>00-80-B3-E1-DF-69</wrap> </WRAP> |<WRAP><wrap>-k</wrap> </WRAP> |<WRAP><wrap>2048</wrap> </WRAP> |<WRAP><wrap>-i</wrap> </WRAP> |<WRAP><wrap>256</wrap> </WRAP> |<WRAP><wrap>192.168.1.99</wrap> </WRAP> |<WRAP><wrap>0.0.0.0</wrap> </WRAP> | **//<wrap>6.9.8 VMNET (Channel-to-Channel link via SLIP/VMNET)</wrap>//** **<wrap>6.9.8.1 Function</wrap>** <wrap>If the emulation mode is not specified on the configuration statement, it is assumed to be a point-to-point link to the driving system's TCP/IP stack using Willem Konynenberg's VMNET package. This provides the same function as the CTCI mode of operation, except that it uses a virtual SLIP interface instead of the TUN/TAP driver.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 221</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.10 FBA DASD Devices \\ //6.10.1 Function//</wrap>** <wrap>This device statement is used to define a FBA DASD device to the Hercules configuration. The argument specifies the name of a file which contains the FBA DASD image or the INET address of a Hercules shared device server.</wrap> <wrap>The file consists of fixed length 512-byte records each of which represents one physical block of the emulated disk. To allow access to a minidisk within a full-pack FBA DASD image file two additional arguments (origin and numblks) may be specified after the filename.</wrap> **//<wrap>6.10.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **//<wrap>devaddr devtype filename </wrap>//****<wrap>[</wrap>****//<wrap>origin </wrap>//****<wrap>| 0] [</wrap>****//<wrap>numblks</wrap>//****<wrap>] [sf=</wrap>****//<wrap>shadowfile</wrap>//****<wrap>] [SYNCIO]</wrap>** **<wrap>or</wrap>** **//<wrap>devaddr devtype ipname </wrap>//****<wrap>[</wrap>****//<wrap>:port </wrap>//****<wrap>| </wrap>****__<wrap>:3990</wrap>__****<wrap>] [</wrap>****//<wrap>:devnum</wrap>//****<wrap>] [COMP=</wrap>****//<wrap>n</wrap>//****<wrap>]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>~¬¬¬¬¬¬0 ¬¬¬¬¬®</wrap>** **<wrap>ÊÊ¬¬¬ </wrap>****//<wrap>devaddr </wrap>//****<wrap>¬¬¬ </wrap>****//<wrap>devtype </wrap>//****<wrap>¬¬¬ </wrap>****//<wrap>filename </wrap>//****<wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap>** **<wrap>⡿¬¬¬</wrap>****//<wrap>origin </wrap>//****<wrap>¬¬¬¯</wrap>** **//<wrap>numblks </wrap>//****<wrap>¬¬¬ i¬¬¬ SF=</wrap>****//<wrap>shadowfile </wrap>//****<wrap>¬¬¬ i¬¬¬ SYNCIO</wrap>** |<WRAP>**<wrap>or</wrap>** **<wrap>ÊÊ¬¬¬ </wrap>****//<wrap>devaddr </wrap>//****<wrap>¬¬¬ </wrap>****//<wrap>devtype </wrap>//****<wrap>¬¬¬ </wrap>****//<wrap>ipname</wrap>//** </WRAP> |<WRAP>**<wrap>~¬¬¬ :3990 ¬¬¬®</wrap>** **<wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ¬¬¬</wrap>****//<wrap>:port </wrap>//****<wrap>¬¬¬¯</wrap>** </WRAP> | **//<wrap>:devnum </wrap>//****<wrap>¬¬¬ '¬¬¬ COMP=</wrap>****//<wrap>n</wrap>//** **//<wrap>6.10.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid device types are 3310, 3370, 9332, 9335, 9336, 0671.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 222</wrap> <wrap>\\ </wrap>**//<wrap>filename </wrap>//**<wrap>This specifies the filename (and path) of the file containing the DASD image.</wrap> **//<wrap>origin </wrap>//**<wrap>Specifies the relative block number within the DASD image file at which the minidisk begins. The number must be less than the number of blocks in the file. The default origin is zero.</wrap> **//<wrap>numblks </wrap>//**<wrap>Specifies the number of 512-byte blocks in the minidisk. This number must not exceed the number of blocks in the file minus the origin. If omitted or specified as an asterisk (“*”), then the minidisk continues to the end of the DASD image file.</wrap> **<wrap>SF= </wrap>**<wrap>Specifies a shadow file for the DASD device. Please refer to the following CKD DASD section for information regarding the use of the SF=shadow file option.</wrap> **//<wrap>shadowfile </wrap>//**<wrap>This is the base name of the shadow file. The handling of shadow files for FBA devices is identical as that for CKD devices. Please refer to the following CKD DASD section for information regarding the use of the SF=shadow filefile option.</wrap> **<wrap>SYNCIO </wrap>**<wrap>SYNCIO enables possible synchronous I/O and is explained in detail in the following CKD DASD section.</wrap> **//<wrap>ipname </wrap>//**<wrap>This is the host name or IP address of the system, where the Hercules shared device server is running.</wrap> **//<wrap>port </wrap>//**<wrap>This is the port number the shared device server is listening on. If the port is omitted then the default is 3990.</wrap> **//<wrap>devnum </wrap>//**<wrap>Devnum specifies the device number on the shared device server. If the device number is omitted then the default is the current device number on the local system.</wrap> **<wrap>COMP=//n //</wrap>**<wrap>This keyword requests that the data has to be transferred compressed between the client and the server. The argument //n //specifies the compression level (1-9). Values closer to 1 mean less compression but also less processor time to perform the compression. Values closer to 9 mean the data is compressed more but also more processor time is required to compress the data.</wrap> **//<wrap>6.10.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a 3310 FBA DASD device on device address 0120. The name and path of the file containing the DASD image is "</wrap>[[file:///D:/DASD/TST001.FBA|<wrap>D:/DASD/TST001.FBA</wrap>]]<wrap>".</wrap> <wrap>0120 3310 </wrap>[[file:///D:/DASD/TST001.FBA|<wrap>D:/DASD/TST001.FBA</wrap>]]<wrap></wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 3370 FBA DASD device on device address 0120. The DASD device is attached to a shared device server which is running on a machine with IP address 192.168.200.1 and listening on port 3990. The device address of the DASD on the shared device server is 0121.</wrap> <wrap>0120 3370 192.168.200.1:3990:0121</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 223</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.11 CKD DASD Devices \\ //6.11.1 Function//</wrap>** <wrap>This device statement is used to define a CKD DASD device to the Hercules configuration. The argument specifies the name of a file that contains the CKD DASD image or the INET address of a Hercules shared device server.</wrap> <wrap>The file consists of a 512-byte device header record followed by fixed length track images. The length of each track image depends on the emulated device type and is always rounded up to the next multiple of 512 bytes.</wrap> <wrap>Volumes larger than 2 GB (for example the 3390, model 3) can be supported by spreading the data across more than one file. Each file contains a whole number of cylinders. The first file (which contains cylinders 0-2518 in the case of a 3390) usually has “_1” as the last two characters of its name. The ckddasd driver allocates the remaining files by replacing the last characters of the file name by the characters “_2”, “_3” and so on.</wrap> <wrap>If your operating system supports large file sizes (or 64-bit offsets) then volumes larger than 2GB can be kept in a single file. The two character suffix is not used in this case.</wrap> <wrap>Alternatively the argument may specify the name of a file containg a compressed CKD DASD image (CCKD DASD files). The CKD driver will automatically detect whether the file contains a regular CKD image or a compressed CKD image.</wrap> **//<wrap>6.11.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr devtype filename </wrap>//<wrap>[sf=</wrap>//<wrap>shadowfile</wrap>//<wrap>] [NOSYNCIO | SYNCIO] [READONLY]</wrap> <wrap>[FAKEWRITE] [CU=</wrap>//<wrap>type</wrap>//<wrap>]</wrap> <wrap>or</wrap> //<wrap>devaddr devtype ipname </wrap>//<wrap>[</wrap>//<wrap>:port </wrap>//<wrap>| </wrap>__<wrap>:3990</wrap>__<wrap>] [</wrap>//<wrap>:devnum</wrap>//<wrap>] [COMP=</wrap>//<wrap>n</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬ </wrap>//<wrap>filename </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>⡿¬¬¬SF=</wrap>//<wrap>shadowfile </wrap>//<wrap>¬¬¬¯</wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>ª¬¬¬ NOSYNCIO ¬¬¬« ⡿¬¬¬ READONLY ¬¬¬¯ ⡿¬¬¬ FAKEWRITE ¬¬¬¯ \\ ⡿¬¬¬¬SYNCIO¬¬¬¬</wrap> <wrap>CU=</wrap>//<wrap>type</wrap>// <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 224</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>or</wrap> |<WRAP><wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬ </wrap>//<wrap>ipname</wrap>// </WRAP> |<WRAP><wrap>~¬¬¬ :3990 ¬¬¬®</wrap> <wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>¬¬¬</wrap>//<wrap>:port </wrap>//<wrap>¬¬¬</wrap> </WRAP> | //<wrap>:devnum </wrap>//<wrap>¬¬¬ '¬¬¬ C0MP=</wrap>//<wrap>n</wrap>// **//<wrap>6.11.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. Valid device types are 2311, 2314, 3330, 3350, 3375, 3380, 3390 and 9345.</wrap> **//<wrap>filename </wrap>//**<wrap>This specifies the filename (and optionally the path) of the file containing the DASD image.</wrap> **//<wrap>shadowfile </wrap>//**<wrap>A shadow file contains all the changes made to the emulated DASD device since it was created, maintained until the next shadow file is created. The moment of the shadow file’s creation can be thought of a snapshot of the current emulated DASD at that time, as if the shadow file is later removed the emulated DASD reverts back to the state it was when the snapshot was taken.</wrap> <wrap>Using shadow files, the base files can be kept on a read-only device like CDROM or can be defined as read-only thus ensuring that these files can never be corrupt-ted.</wrap> <wrap>The shadow file does not have to actually exist when it is defined in the configuration file. The //shadow //operand of the sf= parameter is simply a filename template that will be used to name the shadow file whenever one is be created. Shadow files are created using the sf+ xxxx or sf+ * commands.</wrap> <wrap>The shadow file name must have a position where the shadow file number will be set. This is either the character preceding the last period after the slash or the last character if there is no period. For example: //sf=shadows/linux1_*.dsk//.</wrap> <wrap>Hercules console commands are provided to add a new shadow file, remove the current shadow file (with or without backward merge), compress the current shadow file and display the shadow file status and statistics.</wrap> <wrap>Please note, that the “sf” parameter has to be coded in lowercase letters otherwise an error message is presented.</wrap> <wrap>Details on how to work with shadow files can be found in chapter 8.153 ff.</wrap> **<wrap>[NO]SYNCIO </wrap>**<wrap>SYNCIO enables possible “synchronous” I/O. This is a DASD I/O feature wherein guest I/O requests are completed “synchronously” during the actual emulated execution of the SIO / SSCH (START IO / START SUBCHANNEL) instructions rather than being deferred and executed asynchronously in a separate device I/O thread.</wrap> <wrap>Only I/O which are known to be able to be completed without actually needing to perform any actual host I/O are completed synchronously (e.g. whenever the data being requested is found already be in the cache). If the requested data could not be found in the cache then actual host I/O will need to be done and the request is</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 225</wrap> <wrap>\\ </wrap><wrap>passed to a device I/O thread to be completed asynchronously instead.</wrap> <wrap>SYNCIO is the default for CKD devices. SYNCIO statistics may be displayed via the Hercules SYNCIO console command. SYNCIO may be abbreviated as //SYIO.//</wrap> <wrap>Note: If you plan on using SYNCIO with Linux/390 and/or zLinux you might also want to take a look at the IODELAY system parameter as well.</wrap> **<wrap>READONLY </wrap>**<wrap>READONLY returns “write inhibited” sense when a write is attempted. Note that not all the sense bits may be set absolutely correctly.</wrap> **<wrap>FAKEWRITE </wrap>**<wrap>FAKEWRITE is a workaround for the READONLY sense problem that was mentioned above. In these cases the disk is not intended to be updated (e.g. MVS updates the DSCB last referenced field for a readonly file) and any writes appear to be successful even though nothing is actually written.</wrap> **//<wrap>type </wrap>//**<wrap>Specifies the type of control unit to which this device is attached. The use of this parameter does not necessarily imply that all functions of the specified control unit are emulated. The purpose is to force a particular control unit type to be indicated in the data returned by SENSE ID and similar CCW's.</wrap> <wrap>Normally the default value is appropriate and this parameter need not to be specified. Additional to the table below the following values may be specified: 3990-3 and 3990-6. The default value depends on the device type as shown in table below.</wrap> **//<wrap>ipname </wrap>//**<wrap>This is the host name or IP address of the system where the Hercules shared device server is running.</wrap> **//<wrap>port </wrap>//**<wrap>This is the port number the shared device server is listening on. If omitted the default is 3990.</wrap> **//<wrap>devnum </wrap>//**<wrap>Devnum specifies the device number on the shared device server. If omitted the default is the current device number on the local system.</wrap> **<wrap>COMP=//n //</wrap>**<wrap>This keyword requests that the data has to be transferred compressed between the client and the server. The argument //n //specifies the compression level (1-9). Values closer to 1 mean less compression but also less processor time to perform the compression. Values closer to 9 mean the data is compressed more but also more processor time is required to compress the data.</wrap> <wrap>Two other options //LAZYWRITE //and //FULLTRACKIO //have been deprecated. They are still accepted to support compatibility with older configuration files but do actually nothing. It is strongly recommended to remove these statements from the configuration file.</wrap> <wrap>The following table shows the default Control Unit types depending on on the device type:</wrap> |<WRAP>**<wrap>Device Type</wrap>** </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP>**<wrap>Default CU Type</wrap>** </WRAP> | |<WRAP><wrap>2311</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>2841</wrap> </WRAP> | |<WRAP><wrap>2314</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>2314</wrap> </WRAP> | |<WRAP><wrap>3330,</wrap> </WRAP> |<WRAP><wrap>3340,</wrap> </WRAP> |<WRAP><wrap>3350,</wrap> </WRAP> |<WRAP><wrap>3375,</wrap> </WRAP> |<WRAP><wrap>3380</wrap> </WRAP> |<WRAP><wrap>3880</wrap> </WRAP> | <wrap><wrap>{{hercules:userref:bf:image037.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 226</wrap> <wrap>\\ </wrap>|<WRAP><wrap>3390</wrap> </WRAP> |<WRAP><wrap>3990</wrap> </WRAP> | |<WRAP><wrap>9345</wrap> </WRAP> |<WRAP><wrap>9343</wrap> </WRAP> | **<wrap>Table 11: Default CU Types</wrap>** **//<wrap>6.11.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define a 3390 CKD DASD device on device address 0A8C. The name and path of the file containing the DASD image is "</wrap>[[file:///D:/DASD/SARES1.CKD|<wrap>D:/DASD/SARES1.CKD</wrap>]]<wrap>".</wrap> <wrap>0A8C 3390 </wrap>[[file:///D:/DASD/SARES1.CKD|<wrap>D:/DASD/SARES1.CKD</wrap>]]<wrap></wrap> **<wrap>Example 2:</wrap>** <wrap>Define a 3390 CKD DASD device on device address 0AA2. The name and path of the file containing the DASD image is "</wrap>[[file:///D:/DASD/SARES1.CKD|<wrap>D:/DASD/SARES1.CKD</wrap>]]<wrap>". Synchronous I/O has to be enabled and the device has to return the "write inhibited" sense when a write is attempted.</wrap> <wrap>0AA2 3390 </wrap>[[file:///D:/DASD/SARES1.CKD|<wrap>D:/DASD/SARES1.CKD</wrap>]]<wrap> SYNCIO READONLY</wrap> **<wrap>Example 3:</wrap>** <wrap>Define a 3390 CCKD DASD device on device address 0A00. The name and path of the file containing the DASD image is "</wrap>[[file:///D:/DASD/SARES1.CCKD|<wrap>D:/DASD/SARES1.CCKD</wrap>]]<wrap>". All changes to the DASD device have to go to the shadow file(s) "</wrap>[[file:///D:/SHADOW/SARES1_|<wrap>D:/SHADOW/SARES1_</wrap>]]<wrap>*.CCKD".</wrap> <wrap>0A00 3390 </wrap>[[file:///D:/DASD/SARES1.CCKD|<wrap>D:/DASD/SARES1.CCKD</wrap>]]<wrap> SF=D:/SHADOW/SARES1_*.CCKD</wrap> **<wrap>Example 4:</wrap>** <wrap>Define a 3390 CKD DASD device on device address 0A8C. The DASD device is attached to a shared device server which is running on a machine with IP address 192.168.200.1 and listening on port 3990. The device address of the DASD on the shared device server is also 0A8C.</wrap> <wrap>0A8C 3390 192.168.200.1:3990:0A8C</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 227</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>6.12 Communication Lines</wrap>** **//<wrap>6.12.1 BSC (Preliminary 2703 BSC Support)</wrap>//** **<wrap>6.12.1.1 Function</wrap>** <wrap>This statement describes a BSC emulation line entry to either link 2 Hercules engines or a custom made program emulating a 2780, 3780 or 3x74, or a custom made program interfacing to a real BSC line.</wrap> <wrap>The communication is emulated over a TCP connection. All bytes are transferred as-is (except for doubling DLE in transparent mode) just as over a real BSC link. Emulated EIA (DCD, DTR, CTS, etc.) or X.21/V.11 leads (C, T, etc.) are treated differently depending on the DIAL option selected.</wrap> <wrap>The line emulates a point-to-point BSC link. There is no point-to-multipoint handling.</wrap> **<wrap>6.12.1.2 Syntax</wrap>** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>//<wrap>DIAL={IN | OUT | INOUT | NO}</wrap> <wrap>LHOST={</wrap>//<wrap>hostname </wrap>//<wrap>| </wrap>//<wrap>ipaddress </wrap>//<wrap>| *} LPORT={</wrap>//<wrap>servicen</wrap>////<wrap>ame </wrap>//<wrap>| </wrap>//<wrap>port</wrap>//<wrap>}</wrap> <wrap>RHOST={</wrap>//<wrap>hostname </wrap>//<wrap>| </wrap>//<wrap>ipaddress </wrap>//<wrap>} RPORT={</wrap>//<wrap>servicename </wrap>//<wrap>| </wrap>//<wrap>port</wrap>//<wrap>}</wrap> |<WRAP><wrap>[RTO={0</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-</wrap><wrap>1</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP>//<wrap>nnn </wrap>//<wrap>|</wrap> </WRAP> |<WRAP><wrap>3000}]</wrap> </WRAP> | |<WRAP><wrap>[PTO={0</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-</wrap><wrap>1</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP>//<wrap>nnn </wrap>//<wrap>|</wrap> </WRAP> |<WRAP><wrap>3000}]</wrap> </WRAP> | |<WRAP><wrap>[ETO={0</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-</wrap><wrap>1</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP>//<wrap>nnn </wrap>//<wrap>|</wrap> </WRAP> |<WRAP><wrap>10000}]</wrap> </WRAP> | **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>--- DIAL= ---§----IN -----§---------------</wrap><wrap>¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>ª----OUT ----«</wrap> <wrap>ª---INOUT ---«</wrap> <wrap>⡿----NO -----</wrap><wrap></wrap> <wrap>Ê---LHOST= ---§-------* -------§--- LPORT= ---§--- </wrap>//<wrap>servicename </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>ª---</wrap>//<wrap>hostname </wrap>//<wrap>----« ⡿------</wrap>//<wrap>port </wrap>//<wrap>-------</wrap><wrap>\\ </wrap><wrap>⡿---</wrap>//<wrap>ipaddress </wrap>//<wrap>---</wrap><wrap></wrap> <wrap>Ê---RHOST= ---§--- </wrap>//<wrap>hostname </wrap>//<wrap>----§--- RPORT= ---§--- </wrap>//<wrap>servicename </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>⡿--- </wrap>//<wrap>ipaddress </wrap>//<wrap>--- ⡿------</wrap>//<wrap>port </wrap>//<wrap>-------</wrap><wrap></wrap> <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap> ⡿---RTO= ---</wrap><wrap>§¬¬¬ </wrap>__<wrap>3000</wrap>__<wrap> ---« ⡿---PTO= ---</wrap><wrap>§¬¬¬ </wrap>__<wrap>3000</wrap>__<wrap> ¬¬¬«</wrap> <wrap> ª----0 -----« ª----0 </wrap><wrap>¬¬¬¬¬«</wrap> <wrap> ª---</wrap><wrap>-</wrap><wrap>1 -----« ª--- </wrap><wrap>-1 ¬¬¬¬¬«</wrap> <wrap>⡿---</wrap><wrap></wrap> //<wrap>_ nnn </wrap>//<wrap>----¯%%__%%%%__%%%%__%%%%__%%%%__%% ⡿---</wrap>//<wrap>nnn </wrap>//<wrap>----¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 228</wrap> <wrap>\\ </wrap>|<WRAP><wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>//<wrap>i¬¬¬ ET0= ¬¬¬</wrap>//<wrap>§¬¬¬ </wrap>//__<wrap>10000</wrap>__//<wrap> ¬¬¬«</wrap> //<wrap>ª¬</wrap>//<wrap>¬¬¬¬ </wrap>//<wrap>0 </wrap>//<wrap>¬¬¬¬¬«</wrap> //<wrap>ª¬¬¬¬</wrap>//<wrap>-1 ¬¬¬¬¬« \\ </wrap>//<wrap>⡿¬¬¬¬</wrap>////<wrap>nnn </wrap>////<wrap>¬¬¬¬¯</wrap>// </WRAP> | **<wrap>6.12.1.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. A valid device type is 2703.</wrap> **<wrap>DIAL= </wrap>**<wrap>This specifies the call direction (if any). If DIAL=NO is specified the TCP outgoing connection is attempted as soon as an ENABLE CCW is executed. Also in this mode, an incoming connection will always be accepted. If DIAL=IN or INOUT is specified, a TCP incoming call is accepted only if an ENABLE CCW is currently executing on the device. With DIAL=OUT the ENABLE CCW is rejected. When DIAL=IN or INOUT is coded a DIAL CCW allows the application to establish a TCP connection to a specific host. For other DIAL values the DIAL CCW is rejected.</wrap> **<wrap>LHOST= </wrap>**<wrap>Specifies which IP address to listen on. This also conditions the network interface from which incoming calls will be accepted. An asterisk (“*”) means all incoming TCP calls are accepted regardless of the destination IP address or call origin. A given IP address when DIAL=OUT is specified has no effect.</wrap> **<wrap>LPORT= </wrap>**<wrap>Specifies the TCP port for which to listen to incoming TCP calls. This value is mandatory for DIAL=IN, DIAL=INOUT or DIAL=NO. It is ignored for DIAL=OUT.</wrap> **<wrap>RHOST= </wrap>**<wrap>Specifies the remote host to which to direct a TCP connection on a DIAL=NO line when an ENABLE CCW is executed. This value is mandatory when DIAL=NO is specified, It is ignored for other DIAL values.</wrap> **<wrap>RPORT= </wrap>**<wrap>Specifies the remote port to which to direct a TCP connection on a DIAL=NO line when an ENABLE CCW is executed. This value is mandatory when DIAL=NO is specified, It is ignored for other DIAL values.</wrap> **<wrap>RTO= </wrap>**<wrap>Specifies the number of milliseconds before terminating a read on a timeout when no read termination control character is received. A value of zero means the read ends immediately. “-1” specifies that there is no timeout.</wrap> **<wrap>PTO= </wrap>**<wrap>Specifies the number of milliseconds before terminating a POLL on a timeout when no ACK or NACK sequence is received. A value of zero means the POLL ends immediately. “-1” specifies that there is no timeout.</wrap> **<wrap>ETO= </wrap>**<wrap>Specifies the number of milliseconds before terminating an ENABLE operation on a timeout. The timeout applies when DIAL=NO, DIAL=IN or DIAL=INOUT is specified, , the outgoing TCP call fails (DIAL=NO) and there is no previously or currently established TCP connection for this line. When DIAL=NO is specified the timeout defaults to 10 seconds, for DIAL=IN or DIAL=INOUT, the timeout defaults to “-1”, meaning there is no timeout.</wrap> <wrap>RTO, PTO and ETO are tuning options. In most cases using the default values will give the best result.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 229</wrap> <wrap>\\ </wrap>**<wrap>6.12.1.4 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 2703 BSC emulation line on device address 0023. The outgoing connection should be attempted as soon as an ENABLE CCW is expected, incoming connections should always be accepted (DIAL=NO). The IP address to listen on is 127.0.0.1 with port 3780. The remote host has the IP address 192.168.0.99 and the port to which to direct a TCP connection is 3781.</wrap> <wrap>0023 2703 DIAL=NO LHOST=127.0.0.1 LPORT=3780 RHOST=192.168.0.99 RPORT=3781</wrap> **<wrap>Example 2:</wrap>** <wrap>Example 2 is basically the same as example 1, but needs optimized timing options. The timeout for terminating a read must be 5000 ms, the timeout for terminating a POLL must also be 5000 ms and the timeout for terminating an ENABLE operation must be 12000 ms.</wrap> <wrap>0023 2703 DIAL=NO LHOST=127.0.0.1 LPORT=3780 RHOST=192.168.0.99 RPORT=3781 RT=5000 PTO=5000 ETO=12000</wrap> **//<wrap>6.12.2 TTY (Preliminary 2703 TELE2 TTY Support)</wrap>//** **<wrap>6.12.2.1 Function</wrap>** <wrap>This statement describes a 2703 Telegraph Terminal Control Type II (TTY 33/35) stop/start line, providing access to the Host OS via a standard telnet client.</wrap> <wrap>To the host OS the line emulates an asynchronous TELE2 connection. The communication is emulated over a telnet connection.</wrap> **<wrap>6.12.2.2 Syntax</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>devaddr devtype </wrap>//<wrap>LP0RT=</wrap>//<wrap>port </wrap>//<wrap>DIAL=IN TTY=1</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>devaddr </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬ LP0RT=</wrap>//<wrap>port </wrap>//<wrap>¬¬¬ DIAL=IN ¬¬¬ TTY=1 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> **<wrap>6.12.2.3 Parameter</wrap>** **//<wrap>devaddr </wrap>//**<wrap>This is the device address.</wrap> **//<wrap>devtype </wrap>//**<wrap>This is the device type. A valid device type is 2703.</wrap> **//<wrap>port </wrap>//**<wrap>Specifies the TCPIP port to listen on for incoming TCP calls.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 230</wrap> <wrap>\\ </wrap>**<wrap>DIAL=IN </wrap>**<wrap>Specifies that this line is for in-bound calls. This parameter is required.</wrap> **<wrap>TTY=1 </wrap>**<wrap>Specifies that this definition is for a TTY port. This parameter is required.</wrap> **<wrap>6.12.2.4 Examples</wrap>** **<wrap>Example 1:</wrap>** <wrap>Define a 2703 TTY emulation line on device address 00C3 listening on port 32003.</wrap> <wrap>00C3 2703 LPORT=32003 DIAL=IN TTY=1</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 231</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap></wrap>**<wrap>7. Hercules Console</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>7.1 Hercules Hardware Console</wrap>** <wrap>Various aspects of Hercules can be controlled with console commands. These commands are entered from the command line of the Hercules hardware management console (HMC).</wrap> <wrap>The Hercules hardware management console window is the panel that is active by default after starting Hercules. An alternate semi-graphical "New Panel" display showing devices, registers etc. is also available. Pressing the escape key switches between the two panels.</wrap> <wrap>The main Hercules screen contains a scrollable list of messages with a command input area and a system status line at the bottom of the screen. To scroll through the messages, use either the Page Up or Page Down keys, the Ctrl + Up Arrow or Ctrl + Down Arrow keys, or the Home or End and/or the Ctrl + Home or Ctrl + End keys.</wrap> <wrap>Important messages are highlighted in a different color (usually red) and are prevented from being scrolled off the screen for two minutes. If Extended Cursor handling is available then important messages currently at the top of the screen can be removed early by moving the cursor to the line containing the message and then pressing enter.</wrap> <wrap>Use the Insert key to switch between insert and overlay mode when typing in the command input area. Use the Home and End keys to move to the first or last character of the command you are typing, or the use the left/right arrow keys to move to a specific character. Use the Escape key to erase the input area. Pressing "Escape" when the command input area is already empty causes the screen to switch to the semi-graphical "New Panel" display mode, which shows the overall status of the system and devices.</wrap> <wrap>When in the semi-graphical "New Panel" display mode there is no command input area. Instead, single character "hot keys" are used to issue some of the more common functions such as starting or stopping the CPU. The hot-keys are those which are highlighted. Pressing the '?' key displays brief help information on how to use the semi-graphical panel.</wrap> <wrap>When a command is prefixed with a hyphen (‘-‘), the command will not be redisplayed at the console. This can be used in scripts and is also used internally when commands are to be invoked without being redisplayed at the console.</wrap> <wrap>Prefixing a command with a hyphen (‘-‘) makes it a silent non-echoing command and prevents the command from appearing in the command recall history list (see ‘HST’ command).</wrap> <wrap>Commands can be executed in the background by specifying an ampersand (‘&’) as last argument:</wrap> <wrap>- “SCRIPT ABC” runs in the foreground</wrap> <wrap>- “SCRIPT ABC &” runs in the background</wrap> <wrap>- “SCRIPT ABC &&” runs in the foreground but passes ‘&’ as last argument</wrap> <wrap>- “SCRIPT ABC & &” runs in the background and passes ‘&’as last argument</wrap> <wrap>Sample screenshots of the Hercules HMC are shown in the pictures on the following pages.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 232</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>{{hercules:userref:bf:image038.gif|}}</wrap></wrap>{{hercules:userref:bf:image039.gif|}}{{hercules:userref:bf:image040.gif|}}{{hercules:userref:bf:image041.gif|}}{{hercules:userref:bf:image042.gif|}}{{hercules:userref:bf:image043.gif|}}{{hercules:userref:bf:image043.gif|}}<wrap><wrap>{{hercules:userref:bf:image044.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image045.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image047.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image048.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image049.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image050.gif|}}</wrap></wrap><wrap>Hercules Emulator HMC - MVS V3.81- System Status: YELLOW</wrap> <wrap><wrap>{{hercules:userref:bf:image051.gif|}}</wrap></wrap>**<wrap>Figure 3: Hercules Hardware Console</wrap>** <wrap>\\ </wrap><wrap></wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image052.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 233</wrap> <wrap>\\ </wrap>{{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image054.gif|}}{{hercules:userref:bf:image055.gif|}}{{hercules:userref:bf:image056.gif|}}<wrap>Hercules Emulator V4.00 – User Reference Guide Page 234</wrap> <wrap>\\ </wrap><wrap>Once the HTTP server is started, the interface can be used from a web browser on any machine, that has a network connection to the Hercules server. With this interface you can operate Hercules nearly in the same way as you would do locally on the hardware management console.</wrap> <wrap>The following picture shows the main panel of the web browser interface.</wrap> {{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image057.gif|}}{{hercules:userref:bf:image058.gif|}}{{hercules:userref:bf:image059.gif|}}<wrap>Hercules Emulator V4.00 – User Reference Guide Page 235</wrap> <wrap>\\ </wrap>**//<wrap>7.3.1 Normal cursor handling</wrap>//** <wrap>The normal cursor handling is available on all platforms (Windows and Unix).</wrap> |<WRAP>**<wrap>Key</wrap>** </WRAP> |<WRAP>**<wrap>Action</wrap>** </WRAP> | |<WRAP><wrap>Esc</wrap> </WRAP> |<WRAP><wrap>Erases the contents of the command input area. If the command input area is already empty, switches to semi-graphical New Panel.</wrap> </WRAP> | |<WRAP><wrap>Del</wrap> </WRAP> |<WRAP><wrap>Deletes the character at the cursor position.</wrap> </WRAP> | |<WRAP><wrap>Backspace</wrap> </WRAP> |<WRAP><wrap>Erases the previous character.</wrap> </WRAP> | |<WRAP><wrap>Insert</wrap> </WRAP> |<WRAP><wrap>Toggles between insert mode and overlay mode.</wrap> </WRAP> | |<WRAP><wrap>Tab</wrap> </WRAP> |<WRAP><wrap>Attempts to complete the partial file name at the cursor position in the com-mand input area. If more than one possible file exists, a list of matching file names is displayed.</wrap> </WRAP> | |<WRAP><wrap>Home</wrap> </WRAP> |<WRAP><wrap>Moves the cursor to the start of the input in the command input area. If the command input area is empty, scrolls the message area to the top.</wrap> </WRAP> | |<WRAP><wrap>End</wrap> </WRAP> |<WRAP><wrap>Moves the cursor to the start of the input in the command input area. If the command input area is empty, scrolls the message area to the bottom.</wrap> </WRAP> | |<WRAP><wrap>Page Up</wrap> </WRAP> |<WRAP><wrap>Scrolls the message area up one screen.</wrap> </WRAP> | |<WRAP><wrap>Page Down</wrap> </WRAP> |<WRAP><wrap>Scrolls the message area down one screen.</wrap> </WRAP> | |<WRAP><wrap>Up arrow</wrap> </WRAP> |<WRAP><wrap>Recalls the previous command into the input area.</wrap> </WRAP> | |<WRAP><wrap>Down arrow</wrap> </WRAP> |<WRAP><wrap>Recalls the next command into the input area.</wrap> </WRAP> | |<WRAP><wrap>Right arrow</wrap> </WRAP> |<WRAP><wrap>Moves cursor to the next character of the input area.</wrap> </WRAP> | |<WRAP><wrap>Left arrow</wrap> </WRAP> |<WRAP><wrap>Moves cursor to the previous character of the input area.</wrap> </WRAP> | |<WRAP><wrap>Ctrl + Up arrow</wrap> </WRAP> |<WRAP><wrap>Scrolls the message area up one line.</wrap> </WRAP> | |<WRAP><wrap>Ctrl + Down arrow</wrap> </WRAP> |<WRAP><wrap>Scrolls the message area down one line.</wrap> </WRAP> | |<WRAP><wrap>Ctrl + Home</wrap> </WRAP> |<WRAP><wrap>Scrolls the message area to the top.</wrap> </WRAP> | |<WRAP><wrap>Ctrl + End</wrap> </WRAP> |<WRAP><wrap>Scrolls the message area to the bottom.</wrap> </WRAP> | **<wrap>Table 12: Normal cursor handling</wrap>** **//<wrap>7.3.2 Extended cursor handling</wrap>//** <wrap>The following additional keyboard functions are effective when the Hercules Extended Cursor Handling feature (OPTION_EXTCURS) is activated at compile time. At present, this feature is activated on the Windows platform only.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 236</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Key</wrap>** </WRAP> |<WRAP>**<wrap>Action</wrap>** </WRAP> | |<WRAP><wrap>Alt + Up arrow</wrap> </WRAP> |<WRAP><wrap>Moves cursor up one row.</wrap> </WRAP> | |<WRAP><wrap>Alt + Down arrow</wrap> </WRAP> |<WRAP><wrap>Moves cursor down one row.</wrap> </WRAP> | |<WRAP><wrap>Alt + Right arrow</wrap> </WRAP> |<WRAP><wrap>Moves cursor right one column.</wrap> </WRAP> | |<WRAP><wrap>Alt + Left arrow</wrap> </WRAP> |<WRAP><wrap>Moves cursor left one column.</wrap> </WRAP> | |<WRAP><wrap>Tab</wrap> </WRAP> |<WRAP><wrap>If the cursor is outside the command input area, moves cursor to the start of the input in the command input area.</wrap> <wrap>Otherwise behaves like as described in the previous table.</wrap> </WRAP> | |<WRAP><wrap>Home</wrap> </WRAP> |<WRAP><wrap>If the cursor is outside the command input area, moves cursor to the start of the input in the command input area.</wrap> <wrap>Otherwise behaves like as described in the previous table.</wrap> </WRAP> | |<WRAP><wrap>End</wrap> </WRAP> |<WRAP><wrap>If the cursor is outside the command input area, moves cursor to the end of the input in the command input area.</wrap> <wrap>Otherwise behaves like as described in the previous table.</wrap> </WRAP> | **<wrap>Table 13: Extended cursor handling</wrap>** **//<wrap>7.3.3 Windows event handler</wrap>//** <wrap>Hercules has handlers for certain Windows events. The following table shows the trapped events and the according action(s).</wrap> |<WRAP>**<wrap>Key or function</wrap>** </WRAP> |<WRAP>**<wrap>Action</wrap>** </WRAP> | |<WRAP><wrap>CTRL-Break</wrap> </WRAP> |<WRAP><wrap>Simulates the External Interrupt Key being pressed.</wrap> </WRAP> | |<WRAP><wrap>CTRL-C</wrap> </WRAP> |<WRAP><wrap>CTRL-C is currently caught, but there is no action taken.</wrap> </WRAP> | |<WRAP><wrap>Close</wrap> </WRAP> |<WRAP><wrap>The normal close button (the red "X" box) has been disabled to prevent an unintended shutdown of Hercules. The close function via the Windows menu ("File -> Exit") however is still available. In this case Hercules initiates an immediate shutdown in order to close all files correctly.</wrap> </WRAP> | |<WRAP><wrap>Shutdown</wrap> </WRAP> |<WRAP><wrap>Shutdown ("Start -> Shut down -> Shut down") initiates an immediate shutdown of Hercules in order to close all files correctly.</wrap> </WRAP> | |<WRAP><wrap>Logoff</wrap> </WRAP> |<WRAP><wrap>Logoff ("Start -> Shut down -> Log off") initiates an immediate shutdown of Hercules in order to close all files correctly.</wrap> </WRAP> | **<wrap>Table 14: Windows event handler</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 237</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>7.4 Log formats</wrap>** <wrap>The appearance of the log in terms of prefixing the messages is dependent on the used environment. The most flexible ways of prefixing the messages is given when running Hercules using the WinGUI. Running Hercules with the native console gives only limited options. The following table show an overview of the log options, depending on the Hercules version used.</wrap> |<WRAP>**<wrap>Message Prefix</wrap>** </WRAP> |<WRAP>**<wrap>Native Hercules Console</wrap>** </WRAP> |<WRAP>**<wrap>Hercules with WinGUI</wrap>** </WRAP> | |<WRAP><wrap>Date</wrap> </WRAP> |<WRAP><wrap>No</wrap> </WRAP> |<WRAP><wrap>Yes</wrap> </WRAP> | |<WRAP><wrap>Time</wrap> </WRAP> |<WRAP><wrap>Yes</wrap> </WRAP> |<WRAP><wrap>Yes</wrap> </WRAP> | |<WRAP><wrap>Process ID</wrap> </WRAP> |<WRAP><wrap>No</wrap> </WRAP> |<WRAP><wrap>Yes</wrap> </WRAP> | |<WRAP><wrap>Prefix(es) visible on console</wrap> </WRAP> |<WRAP><wrap>No</wrap> </WRAP> |<WRAP><wrap>Yes</wrap> </WRAP> | |<WRAP><wrap>Prefix(es) visible on hardcopy log</wrap> </WRAP> |<WRAP><wrap>Yes</wrap> </WRAP> |<WRAP><wrap>Yes</wrap> </WRAP> | **<wrap>Table 15: Message prefix overview</wrap>** <wrap>Most of the console command examples in this book are made without the WinGUI and with LOGOPT set to NOTIMESTAMP as described below. This is to ensure that the sample output from the commands fits into the text boxes in this book.</wrap> **//<wrap>7.4.1 Hercules Console</wrap>//** <wrap>Using Hercules under Linux, Mac OS or Windows (without WinGUI) lets you prefix the console messages with a timestamp. The difference between these options is shown in the next figure.</wrap> <wrap>Switching the option can be done with the ‘logopt’ console command or can be set at startup time through the ‘logopt’ system parameter.</wrap> <wrap>Please note that the console itself does not show the timestamp, independent of the ‘logopt’ settings. Only the hardcopy log does show the timestamp.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>logopt notimestamp</wrap> |<WRAP><wrap>HHCPN197I gpr</wrap> </WRAP> |<WRAP><wrap>Log option set: NOTIMESTAMP</wrap> </WRAP> | | |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R0=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R1=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R2=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R3=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R4=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R5=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R6=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R7=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R8=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R9=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>RA=0000000000000000</wrap> </WRAP> |<WRAP><wrap>RB=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>RC=0000000000000000</wrap> </WRAP> |<WRAP><wrap>RD=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>RE=0000000000000000</wrap> </WRAP> |<WRAP><wrap>RF=0000000000000000</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 238</wrap> <wrap>\\ </wrap> |<WRAP><wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>23:01:32</wrap> </WRAP> |<WRAP><wrap>logopt timestamp</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>23:01:32</wrap> </WRAP> |<WRAP><wrap>HHCPN197I</wrap> </WRAP> |<WRAP><wrap>Log option set: TIMESTAMP</wrap> </WRAP> | | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>gpr</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R0=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R1=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R2=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R3=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R4=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R5=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R6=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R7=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>R8=0000000000000000</wrap> </WRAP> |<WRAP><wrap>R9=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>RA=0000000000000000</wrap> </WRAP> |<WRAP><wrap>RB=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>RC=0000000000000000</wrap> </WRAP> |<WRAP><wrap>RD=0000000000000000</wrap> </WRAP> | |<WRAP><wrap>23:01:36</wrap> </WRAP> |<WRAP><wrap>CPU0000:</wrap> </WRAP> |<WRAP><wrap>RE=0000000000000000</wrap> </WRAP> |<WRAP><wrap>RF=0000000000000000.</wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 6: Message prefixing using the native Hercules console</wrap>** **//<wrap>7.4.2 Hercules console using the WinGUI</wrap>//** <wrap>Using the WinGUI with the Windows version of Hercules gives you the possibility to prefix all messages with the current date, the current time and the process ID. These prefixing options can be selected individually in the “Format” tab of the "Advanced Logging Options", where they can be separately turned on or off as showed in the next figure.</wrap> {{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image060.gif|}}{{hercules:userref:bf:image061.gif|}}<wrap>Hercules Emulator V4.00 – User Reference Guide Page 239</wrap> <wrap>\\ </wrap><wrap>The ‘logopt’ system parameter or console command has no effect when using the WinGUI. Prefixing the messages is only influenced over the GUI settings. The following figure shows the log messages using all prefixing options (date, time and process ID) as specified above.</wrap> |<WRAP><wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.071</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01416I</wrap> </WRAP> |<WRAP><wrap>Build information:</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.071</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Windows (MSVC) build for AMD64</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.071</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Modes: S/370 ESA/390 z/Arch</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.071</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Max CPU Engines: 8</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.071</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Using fthreads Threading Model</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.072</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Using FishIO</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.072</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Dynamic loading support</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.072</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Using shared libraries</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.072</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>HTTP Server support</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.072</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>No SIGABEND handler</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.072</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Regular Expressions support</wrap> </WRAP> | |<WRAP><wrap>2010/06/18</wrap> </WRAP> |<WRAP><wrap>19:12:18.072</wrap> </WRAP> |<WRAP><wrap>000008E4</wrap> </WRAP> |<WRAP><wrap>HHC01417I</wrap> </WRAP> |<WRAP><wrap>Automatic Operator support</wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 8: Message prefixing using the console of the Hercules WinGUI</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>7.5 Programmed Function Key (PF Key) Support</wrap>** <wrap>The Hercules console supports the usage of PF keys. The next sections show how to define and use PF keys with Hercules.</wrap> **//<wrap>7.5.1 Usage</wrap>//** <wrap>The command to be assigned to the PF key has to be defined with a DEFSYM statement. This can be done through a DEFSYM system parameter statement in the Hercules configuration file or through a panel command (manually from the console or coded in the Hercules run-commands file).</wrap> <wrap>On Windows systems PF keys PF01 to PF48 are assignable, on non-Windows systems PF01 to PF20. The following special keys must be used to access the PF keys:</wrap> <wrap>PF01-PF12 Press PF key only</wrap> <wrap>PF13-PF24 Press SHIFT and PF key</wrap> <wrap>PF25-PF36 Press CTRL and PF key</wrap> <wrap>PF37-PF48 Press ALT and PF key</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 240</wrap> <wrap>\\ </wrap>**//<wrap>7.5.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>DEFSYM PF</wrap>//<wrap>nn </wrap>//<wrap>"[SUBST] {IMMED | DELAY} {HERC | SCP | PSCP}</wrap> //<wrap>command </wrap>//<wrap>[</wrap>//<wrap>&n </wrap>//<wrap>| </wrap>//<wrap>&* </wrap>//<wrap>| </wrap>//<wrap>&$ </wrap>//<wrap>[...]]"</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>PI10¬¬¬ DEFSYM ¬¬¬ PF</wrap>//<wrap>nn </wrap>//<wrap>¬¬¬ " ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬IMMED ¬¬¬§¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬Ê</wrap> <wrap>⡿¬¬¬ SUBST </wrap><wrap>¬¬¬</wrap><wrap>¯ ⡿¬¬¬ DELAY </wrap><wrap>¬¬¬</wrap><wrap>¯</wrap> <wrap>Ê¬¬¬§¬¬¬HERC ¬¬¬§¬¬¬ </wrap>//<wrap>command </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ "</wrap> <wrap>¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª</wrap><wrap>¬¬¬ </wrap><wrap>SCP</wrap><wrap>¬¬¬¬« </wrap><wrap> </wrap><wrap>~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® </wrap><wrap></wrap> <wrap>⡿¬¬¬ PSCP</wrap><wrap>¬¬¬ </wrap><wrap>⡿</wrap><wrap>¬¬¬</wrap><wrap>°</wrap><wrap>¬¬¬§¬¬¬ </wrap>//<wrap>&n </wrap>//<wrap>¬¬¬§¬¬¬</wrap><wrap>¨</wrap><wrap>¬¬¬</wrap><wrap>¯</wrap> <wrap>ª</wrap><wrap>¬¬¬ &* ¬¬¬«</wrap> <wrap>⡿¬¬¬ </wrap><wrap>&$ ¬¬¬</wrap><wrap>¯</wrap> **//<wrap>7.5.3 Parameter</wrap>//** **<wrap>PFnn </wrap>**<wrap>This identifies the PF key to be defined, where //nn //is a number from 01 to 48. This number must be specified with the leading zero for PF keys 1 - 9 (PF01, ..., PF09).</wrap> **<wrap>SUBST </wrap>**<wrap>This indicates that the PF key data might contain substitution placeholders (//&n, //see below).</wrap> **<wrap>IMMED </wrap>**<wrap>This indicates the point in time when the PF key is processed. IMMED indicates that the PF data is processed when the PF key is pressed.</wrap> **<wrap>DELAY </wrap>**<wrap>This indicates the point in time when the PF key is processed. DELAY indicates that the PF data is displayed on the command line when the PF key is pressed. The data may then be modified if necessary. To finally process the PF data the “ENTER” key must be pressed.</wrap> **<wrap>HERC </wrap>**<wrap>The command target for the assigned command is the Hercules Emulator.</wrap> **<wrap>SCP </wrap>**<wrap>The command target for the assigned command is the System Control Program (the guest operating system running under Hercules).</wrap> **<wrap>PSCP </wrap>**<wrap>The assigned command is a System Control Program (guest operating system) priority command.</wrap> **<wrap>command </wrap>**<wrap>This defines the command that is to be assigned to the PF key.</wrap> **<wrap>&n </wrap>**<wrap>A substitution placeholder is identified by an ampersand (“&”), followed by a decimal number from 0 to 9. If two ampersands are detected (“&&”) then a single ampersand is substituted.</wrap> **<wrap>&* </wrap>**<wrap>Variable “&*” represents all of the remaining tokens beyond the last substitution variable used. A single space is added between each token. Tokens can be enclosed in paired</wrap> <wrap>single or double quotes. The quotes are included as part of the token string.</wrap> **<wrap>&$ </wrap>**<wrap>Variable “&$” represents the data remaining on the line past token 9. Variable “$*” (see below) does include the data from “&$”.A single space is added between each token.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 241</wrap> <wrap>\\ </wrap><wrap>Tokens can be enclosed in paired single or double quotes. The quotes are included as part of the token string.</wrap> **//<wrap>7.5.4 Default PF Key Assignments</wrap>//** <wrap>The following PF keys are defined per default:</wrap> <wrap>PF01 'SUBST IMMED herc help &0'</wrap> <wrap>PF10 'SUBST DELAY herc devinit &*'</wrap> <wrap>PF11 'IMMED herc devlist TAPE'</wrap> **//<wrap>7.5.5 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>DEFSYM PF01 “SUBST IMMED HERC HELP &0”</wrap> <wrap>Typing ‘MAXRATES’ on the command line and pressing PF01 would place the following on the command line and immediately execute the command:</wrap> <wrap>HERC HELP MAXRATES</wrap> **<wrap>Example 2:</wrap>** <wrap>DEFSYM PF02 “SUBST DELAY HERC DEVINIT &0 &*”</wrap> <wrap>Typing ‘580 “HETTAPE.HET” RO’ on the command line and pressing PF02 would place the following on the command line:</wrap> <wrap>HERC DEVINIT 580 “HETTAPE.HET” RO</wrap> <wrap>Pressing an additional “ENTER” does execute the command.</wrap> **<wrap>Example 3:</wrap>** <wrap>DEFSYM PF03 “SUBST DELAY HERC DEVINIT &0 &* &1 &* &2”</wrap> <wrap>Typing ‘T1 T2 T3 T4 T5 T6’ on the command line and pressing PF03 would place the following on the command line:</wrap> <wrap>HERC DEVINIT T1 T2 T3 T4 T5 T6 T2 T3 T4 T5 T6 T3 \\ </wrap><wrap>Pressing an additional “ENTER” does execute the command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 242</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>7.6 Hercules Console Commands (sorted alphabetically)</wrap>** <wrap>The following table shows an overview of the valid Hercules console commands that can be entered in the control panel (Hercules console display). In this table the commands are sorted alphabetically rather than grouped by functionality.</wrap> <wrap>Please note that the availability of certain commands depends on the build options used when Hercules was compiled. For a list of all build options and their related console commands please consult “Appendix E. Build Options for System Parameters and Console Commands”.</wrap> |<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>!message</wrap> </WRAP> |<WRAP><wrap>SCP priority message</wrap> </WRAP> | |<WRAP><wrap>#</wrap> </WRAP> |<WRAP><wrap>Silent comment</wrap> </WRAP> | |<WRAP><wrap>$locate</wrap> </WRAP> |<WRAP><wrap>Display and verify Hercules control blocks</wrap> </WRAP> | |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>Custom test command</wrap> </WRAP> | |<WRAP><wrap>$zapcmd</wrap> </WRAP> |<WRAP><wrap>Enable or disable system parameters and console commands</wrap> </WRAP> | |<WRAP><wrap>*</wrap> </WRAP> |<WRAP><wrap>Loud comment</wrap> </WRAP> | |<WRAP><wrap>.reply</wrap> </WRAP> |<WRAP><wrap>SCP command</wrap> </WRAP> | |<WRAP><wrap>?</wrap> </WRAP> |<WRAP><wrap>List all commands / command specific help (alias for help)</wrap> </WRAP> | |<WRAP><wrap>abs</wrap> </WRAP> |<WRAP><wrap>Display or alter absolute storage</wrap> </WRAP> | |<WRAP><wrap>aea</wrap> </WRAP> |<WRAP><wrap>Display AEA (absolue-effective-address) tables</wrap> </WRAP> | |<WRAP><wrap>aia</wrap> </WRAP> |<WRAP><wrap>Display AIA (absolute-instruction-address) tables</wrap> </WRAP> | |<WRAP><wrap>ar</wrap> </WRAP> |<WRAP><wrap>Display access registers</wrap> </WRAP> | |<WRAP><wrap>archlvl</wrap> </WRAP> |<WRAP><wrap>Set architecture level</wrap> </WRAP> | |<WRAP><wrap>archmode</wrap> </WRAP> |<WRAP><wrap>Set architecture mode (alias for ARCHLVL command)</wrap> </WRAP> | |<WRAP><wrap>attach</wrap> </WRAP> |<WRAP><wrap>Configure device</wrap> </WRAP> | |<WRAP><wrap>auto_scsi_mount</wrap> </WRAP> |<WRAP><wrap>Automatic SCSI tape mounts (deprecated, use SCSIMOUNT instead)</wrap> </WRAP> | |<WRAP><wrap>autoinit</wrap> </WRAP> |<WRAP><wrap>Display or set the automatic creation of empty tape files</wrap> </WRAP> | |<WRAP><wrap>automount</wrap> </WRAP> |<WRAP><wrap>Display or update allowable tape automount directories</wrap> </WRAP> | |<WRAP><wrap>b</wrap> </WRAP> |<WRAP><wrap>Set breakpoint (synonym for B+)</wrap> </WRAP> | |<WRAP><wrap>b+</wrap> </WRAP> |<WRAP><wrap>Set breakpoint (synonym for B)</wrap> </WRAP> | |<WRAP><wrap>b-</wrap> </WRAP> |<WRAP><wrap>Delete breakpoint</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 243</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>cache</wrap> </WRAP> |<WRAP><wrap>Execute cache related commands</wrap> </WRAP> | |<WRAP><wrap>cachestats</wrap> </WRAP> |<WRAP><wrap>Display cache statistics</wrap> </WRAP> | |<WRAP><wrap>capping</wrap> </WRAP> |<WRAP><wrap>Display or set CPU capping value</wrap> </WRAP> | |<WRAP><wrap>cckd</wrap> </WRAP> |<WRAP><wrap>CCKD command</wrap> </WRAP> | |<WRAP><wrap>cd</wrap> </WRAP> |<WRAP><wrap>Change directory</wrap> </WRAP> | |<WRAP><wrap>cf</wrap> </WRAP> |<WRAP><wrap>Configure current CPU online or offline</wrap> </WRAP> | |<WRAP><wrap>cfall</wrap> </WRAP> |<WRAP><wrap>Configure all CPU’s online or offline</wrap> </WRAP> | |<WRAP><wrap>clocks</wrap> </WRAP> |<WRAP><wrap>Display TOD clock and CPU timer</wrap> </WRAP> | |<WRAP><wrap>cmdlevel</wrap> </WRAP> |<WRAP><wrap>Display or set the current command group</wrap> </WRAP> | |<WRAP><wrap>cmdlvl</wrap> </WRAP> |<WRAP><wrap>Alias for cmdlevel</wrap> </WRAP> | |<WRAP><wrap>cmdsep</wrap> </WRAP> |<WRAP><wrap>Display or set command line separator</wrap> </WRAP> | |<WRAP><wrap>cmdtgt</wrap> </WRAP> |<WRAP><wrap>Specify the command target</wrap> </WRAP> | |<WRAP><wrap>cnslport</wrap> </WRAP> |<WRAP><wrap>Display or set console port</wrap> </WRAP> | |<WRAP><wrap>codepage</wrap> </WRAP> |<WRAP><wrap>Display or set codepage conversion table</wrap> </WRAP> | |<WRAP><wrap>conkpalv</wrap> </WRAP> |<WRAP><wrap>Display / alter console TCP/IP keep-alive settings</wrap> </WRAP> | |<WRAP><wrap>cp_updt</wrap> </WRAP> |<WRAP><wrap>Create or modify user character conversion table</wrap> </WRAP> | |<WRAP><wrap>cpu</wrap> </WRAP> |<WRAP><wrap>Define target CPU for console display and commands</wrap> </WRAP> | |<WRAP><wrap>cpuidfmt</wrap> </WRAP> |<WRAP><wrap>Display or set format BASIC / 0 / 1 STIDP generation</wrap> </WRAP> | |<WRAP><wrap>cpumodel</wrap> </WRAP> |<WRAP><wrap>Display or set CPU model number</wrap> </WRAP> | |<WRAP><wrap>cpuprio</wrap> </WRAP> |<WRAP><wrap>Display or set CPU thread process priority</wrap> </WRAP> | |<WRAP><wrap>cpuserial</wrap> </WRAP> |<WRAP><wrap>Display or set CPU serial number</wrap> </WRAP> | |<WRAP><wrap>cpuverid</wrap> </WRAP> |<WRAP><wrap>Display or set CPU version code</wrap> </WRAP> | |<WRAP><wrap>cr</wrap> </WRAP> |<WRAP><wrap>Display or alter control registers</wrap> </WRAP> | |<WRAP><wrap>cscript</wrap> </WRAP> |<WRAP><wrap>Cancel a running script thread</wrap> </WRAP> | |<WRAP><wrap>ctc</wrap> </WRAP> |<WRAP><wrap>Enable / disable CTC debugging</wrap> </WRAP> | |<WRAP><wrap>define</wrap> </WRAP> |<WRAP><wrap>Rename device</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 244</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>defstore</wrap> </WRAP> |<WRAP><wrap>Display or define main and expanded storage values</wrap> </WRAP> | |<WRAP><wrap>defsym</wrap> </WRAP> |<WRAP><wrap>Define a symbol</wrap> </WRAP> | |<WRAP><wrap>delsym</wrap> </WRAP> |<WRAP><wrap>Delete a symbol</wrap> </WRAP> | |<WRAP><wrap>detach</wrap> </WRAP> |<WRAP><wrap>Remove device</wrap> </WRAP> | |<WRAP><wrap>devinit</wrap> </WRAP> |<WRAP><wrap>Reinitialize device</wrap> </WRAP> | |<WRAP><wrap>devlist</wrap> </WRAP> |<WRAP><wrap>List device, device class or all devices</wrap> </WRAP> | |<WRAP><wrap>devprio</wrap> </WRAP> |<WRAP><wrap>Display or set device threads process priority</wrap> </WRAP> | |<WRAP><wrap>devtmax</wrap> </WRAP> |<WRAP><wrap>Display or set max device threads</wrap> </WRAP> | |<WRAP><wrap>diag8cmd</wrap> </WRAP> |<WRAP><wrap>Display or set DIAGNOSE 8 command option</wrap> </WRAP> | |<WRAP><wrap>dir</wrap> </WRAP> |<WRAP><wrap>Display file and directory listing</wrap> </WRAP> | |<WRAP><wrap>ds</wrap> </WRAP> |<WRAP><wrap>Display subchannel</wrap> </WRAP> | |<WRAP><wrap>ecpsvm</wrap> </WRAP> |<WRAP><wrap>ECPS:VM commands</wrap> </WRAP> | |<WRAP><wrap>engines</wrap> </WRAP> |<WRAP><wrap>Set processor engines type</wrap> </WRAP> | |<WRAP><wrap>exec</wrap> </WRAP> |<WRAP><wrap>Execute a REXX script</wrap> </WRAP> | |<WRAP><wrap>exit</wrap> </WRAP> |<WRAP><wrap>Terminate the emulator</wrap> </WRAP> | |<WRAP><wrap>ext</wrap> </WRAP> |<WRAP><wrap>Generate external interrupt</wrap> </WRAP> | |<WRAP><wrap>f{+/-} addr</wrap> </WRAP> |<WRAP><wrap>Mark frames usable / unusable</wrap> </WRAP> | |<WRAP><wrap>fcb</wrap> </WRAP> |<WRAP><wrap>Display current FCB or load new FCB image</wrap> </WRAP> | |<WRAP><wrap>fpc</wrap> </WRAP> |<WRAP><wrap>Display or alter floating point control register</wrap> </WRAP> | |<WRAP><wrap>fpr</wrap> </WRAP> |<WRAP><wrap>Display or alter floating point registers</wrap> </WRAP> | |<WRAP><wrap>g</wrap> </WRAP> |<WRAP><wrap>Turn off instruction stepping and start all CPUs</wrap> </WRAP> | |<WRAP><wrap>gpr</wrap> </WRAP> |<WRAP><wrap>Display or alter general purpose registers</wrap> </WRAP> | |<WRAP><wrap>hao</wrap> </WRAP> |<WRAP><wrap>Hercules Automatic Operator (HAO)</wrap> </WRAP> | |<WRAP><wrap>help</wrap> </WRAP> |<WRAP><wrap>List all commands / command specific help</wrap> </WRAP> | |<WRAP><wrap>herc</wrap> </WRAP> |<WRAP><wrap>Send Hercules command</wrap> </WRAP> | |<WRAP><wrap>herclogo</wrap> </WRAP> |<WRAP><wrap>Read a new Hercules logo file</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 245</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>hercprio</wrap> </WRAP> |<WRAP><wrap>Display or set Hercules process priority</wrap> </WRAP> | |<WRAP><wrap>hst</wrap> </WRAP> |<WRAP><wrap>History of commands</wrap> </WRAP> | |<WRAP><wrap>http</wrap> </WRAP> |<WRAP><wrap>Start, stop, modify or display HTTP server</wrap> </WRAP> | |<WRAP><wrap>i</wrap> </WRAP> |<WRAP><wrap>Generate I/O attention interrupt for device</wrap> </WRAP> | |<WRAP><wrap>icount</wrap> </WRAP> |<WRAP><wrap>Display individual instruction counts</wrap> </WRAP> | |<WRAP><wrap>iodelay</wrap> </WRAP> |<WRAP><wrap>Display or set I/O delay value</wrap> </WRAP> | |<WRAP><wrap>ipending</wrap> </WRAP> |<WRAP><wrap>Display pending interrupts</wrap> </WRAP> | |<WRAP><wrap>ipl</wrap> </WRAP> |<WRAP><wrap>IPL Normal from device xxxx</wrap> </WRAP> | |<WRAP><wrap>iplc</wrap> </WRAP> |<WRAP><wrap>IPL Clear from device xxxx</wrap> </WRAP> | |<WRAP><wrap>k</wrap> </WRAP> |<WRAP><wrap>Display CCKD internal trace</wrap> </WRAP> | |<WRAP><wrap>kd</wrap> </WRAP> |<WRAP><wrap>Clear held messages</wrap> </WRAP> | |<WRAP><wrap>ldmod</wrap> </WRAP> |<WRAP><wrap>Load a module</wrap> </WRAP> | |<WRAP><wrap>legacysenseid</wrap> </WRAP> |<WRAP><wrap>Display or set SENSE ID CCW (x’E4) feature</wrap> </WRAP> | |<WRAP><wrap>loadcore</wrap> </WRAP> |<WRAP><wrap>Load a core image from a file</wrap> </WRAP> | |<WRAP><wrap>loadparm</wrap> </WRAP> |<WRAP><wrap>Set IPL parameter</wrap> </WRAP> | |<WRAP><wrap>loadtext</wrap> </WRAP> |<WRAP><wrap>Load a text deck file</wrap> </WRAP> | |<WRAP><wrap>log</wrap> </WRAP> |<WRAP><wrap>Direct log output</wrap> </WRAP> | |<WRAP><wrap>logopts</wrap> </WRAP> |<WRAP><wrap>Change log options</wrap> </WRAP> | |<WRAP><wrap>lparname</wrap> </WRAP> |<WRAP><wrap>Display or set LPAR name</wrap> </WRAP> | |<WRAP><wrap>lparnum</wrap> </WRAP> |<WRAP><wrap>Display or set LPAR identification number</wrap> </WRAP> | |<WRAP><wrap>ls</wrap> </WRAP> |<WRAP><wrap>Display file and directory listing</wrap> </WRAP> | |<WRAP><wrap>lsdep</wrap> </WRAP> |<WRAP><wrap>List module dependencies</wrap> </WRAP> | |<WRAP><wrap>lsmod</wrap> </WRAP> |<WRAP><wrap>List dynamic modules</wrap> </WRAP> | |<WRAP><wrap>mainsize</wrap> </WRAP> |<WRAP><wrap>Display or set main storage size</wrap> </WRAP> | |<WRAP><wrap>manufacturer</wrap> </WRAP> |<WRAP><wrap>Display or set STSI manufacturer code</wrap> </WRAP> | |<WRAP><wrap>maxcpu</wrap> </WRAP> |<WRAP><wrap>Display or set maximum number of CPUs</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 246</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>maxrates</wrap> </WRAP> |<WRAP><wrap>Display highest MIPS/SIO rate or set new reporting interval</wrap> </WRAP> | |<WRAP><wrap>memlock</wrap> </WRAP> |<WRAP><wrap>Lock Hercules memory</wrap> </WRAP> | |<WRAP><wrap>message</wrap> </WRAP> |<WRAP><wrap>Display message on console like VM</wrap> </WRAP> | |<WRAP><wrap>model</wrap> </WRAP> |<WRAP><wrap>Display or set STSI model code</wrap> </WRAP> | |<WRAP><wrap>modpath</wrap> </WRAP> |<WRAP><wrap>Display or set dynamic load module path</wrap> </WRAP> | |<WRAP><wrap>mounted_tape_reinit</wrap> </WRAP> |<WRAP><wrap>Control tape initialization</wrap> </WRAP> | |<WRAP><wrap>msg</wrap> </WRAP> |<WRAP><wrap>Display message on console like VM</wrap> </WRAP> | |<WRAP><wrap>msghld</wrap> </WRAP> |<WRAP><wrap>Display or set timeout value of held messages</wrap> </WRAP> | |<WRAP><wrap>msglevel</wrap> </WRAP> |<WRAP><wrap>Display or set the current message display output</wrap> </WRAP> | |<WRAP><wrap>msglvl</wrap> </WRAP> |<WRAP><wrap>Display or set the current message display output (alias for msglevel command)</wrap> </WRAP> | |<WRAP><wrap>msgnoh</wrap> </WRAP> |<WRAP><wrap>Display message on console like VM, but without header</wrap> </WRAP> | |<WRAP><wrap>mt</wrap> </WRAP> |<WRAP><wrap>Control magnetic tape operation</wrap> </WRAP> | |<WRAP><wrap>numcpu</wrap> </WRAP> |<WRAP><wrap>Display or set number of emulated CPUs</wrap> </WRAP> | |<WRAP><wrap>numvec</wrap> </WRAP> |<WRAP><wrap>Display or set number of vector facilities</wrap> </WRAP> | |<WRAP><wrap>ostailor</wrap> </WRAP> |<WRAP><wrap>Tailor trace information for specific operating system</wrap> </WRAP> | |<WRAP><wrap>panrate</wrap> </WRAP> |<WRAP><wrap>Display or set console refresh rate</wrap> </WRAP> | |<WRAP><wrap>pantitle</wrap> </WRAP> |<WRAP><wrap>Display or set console window title</wrap> </WRAP> | |<WRAP><wrap>pgmprdos</wrap> </WRAP> |<WRAP><wrap>Set LPP license seting</wrap> </WRAP> | |<WRAP><wrap>pgmtrace</wrap> </WRAP> |<WRAP><wrap>Trace program interrupts</wrap> </WRAP> | |<WRAP><wrap>plant</wrap> </WRAP> |<WRAP><wrap>Display or set STSI plant code</wrap> </WRAP> | |<WRAP><wrap>pr</wrap> </WRAP> |<WRAP><wrap>Display prefix register</wrap> </WRAP> | |<WRAP><wrap>pscp</wrap> </WRAP> |<WRAP><wrap>Send system control program priority message</wrap> </WRAP> | |<WRAP><wrap>psw</wrap> </WRAP> |<WRAP><wrap>Display or alter program status word</wrap> </WRAP> | |<WRAP><wrap>ptp</wrap> </WRAP> |<WRAP><wrap>Enable / disable PTP debugging</wrap> </WRAP> | |<WRAP><wrap>ptt</wrap> </WRAP> |<WRAP><wrap>Display or set internal trace</wrap> </WRAP> | |<WRAP><wrap>pwd</wrap> </WRAP> |<WRAP><wrap>Print working directory</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 247</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>qcpuid</wrap> </WRAP> |<WRAP><wrap>Display CPU ID</wrap> </WRAP> | |<WRAP><wrap>qd</wrap> </WRAP> |<WRAP><wrap>Query device information</wrap> </WRAP> | |<WRAP><wrap>qpfkeys</wrap> </WRAP> |<WRAP><wrap>Display the current PF key settings</wrap> </WRAP> | |<WRAP><wrap>qpid</wrap> </WRAP> |<WRAP><wrap>Display process ID of Hercules</wrap> </WRAP> | |<WRAP><wrap>qports</wrap> </WRAP> |<WRAP><wrap>Display TCP/IP ports in use</wrap> </WRAP> | |<WRAP><wrap>qproc</wrap> </WRAP> |<WRAP><wrap>Display processors type and utilization</wrap> </WRAP> | |<WRAP><wrap>qstor</wrap> </WRAP> |<WRAP><wrap>Display main and expanded storage values</wrap> </WRAP> | |<WRAP><wrap>quiet</wrap> </WRAP> |<WRAP><wrap>Toggle automatic refresh of console display data</wrap> </WRAP> | |<WRAP><wrap>quit</wrap> </WRAP> |<WRAP><wrap>Terminate the emulator</wrap> </WRAP> | |<WRAP><wrap>quitmout</wrap> </WRAP> |<WRAP><wrap>Display or set quit timeout value</wrap> </WRAP> | |<WRAP><wrap>r</wrap> </WRAP> |<WRAP><wrap>Display or alter real storage</wrap> </WRAP> | |<WRAP><wrap>restart</wrap> </WRAP> |<WRAP><wrap>Generate restart interrupt</wrap> </WRAP> | |<WRAP><wrap>resume</wrap> </WRAP> |<WRAP><wrap>Resume Hercules</wrap> </WRAP> | |<WRAP><wrap>rexx</wrap> </WRAP> |<WRAP><wrap>Display or set REXX interpreter settings</wrap> </WRAP> | |<WRAP><wrap>rmmod</wrap> </WRAP> |<WRAP><wrap>Delete a module</wrap> </WRAP> | |<WRAP><wrap>s</wrap> </WRAP> |<WRAP><wrap>Instruction stepping</wrap> </WRAP> | |<WRAP><wrap>s+</wrap> </WRAP> |<WRAP><wrap>Instruction stepping on</wrap> </WRAP> | |<WRAP><wrap>s-</wrap> </WRAP> |<WRAP><wrap>Instruction stepping off</wrap> </WRAP> | |<WRAP><wrap>s?</wrap> </WRAP> |<WRAP><wrap>Instruction stepping query</wrap> </WRAP> | |<WRAP><wrap>s{+/-} dev</wrap> </WRAP> |<WRAP><wrap>Turn CCW stepping on / off</wrap> </WRAP> | |<WRAP><wrap>savecore</wrap> </WRAP> |<WRAP><wrap>Save a core image to a file</wrap> </WRAP> | |<WRAP><wrap>sclproot</wrap> </WRAP> |<WRAP><wrap>Set or display SCLP base directory</wrap> </WRAP> | |<WRAP><wrap>scp</wrap> </WRAP> |<WRAP><wrap>Send system control program command</wrap> </WRAP> | |<WRAP><wrap>scpecho</wrap> </WRAP> |<WRAP><wrap>Display or set echo to console and history of SCP replies</wrap> </WRAP> | |<WRAP><wrap>scpimply</wrap> </WRAP> |<WRAP><wrap>Display or set option to pass non-Hercules commands to the SCP</wrap> </WRAP> | |<WRAP><wrap>script</wrap> </WRAP> |<WRAP><wrap>Run a sequence of console commands contained in a file</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 248</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>scsimount</wrap> </WRAP> |<WRAP><wrap>Automatic SCSI tape mounts</wrap> </WRAP> | |<WRAP><wrap>sf+</wrap> </WRAP> |<WRAP><wrap>Create a new shadow file</wrap> </WRAP> | |<WRAP><wrap>sf-</wrap> </WRAP> |<WRAP><wrap>Delete a shadow file</wrap> </WRAP> | |<WRAP><wrap>sfc</wrap> </WRAP> |<WRAP><wrap>Compress a shadow file</wrap> </WRAP> | |<WRAP><wrap>sfd</wrap> </WRAP> |<WRAP><wrap>Display shadow file statistics</wrap> </WRAP> | |<WRAP><wrap>sfk</wrap> </WRAP> |<WRAP><wrap>Perform a chkdsk on the active shadow file</wrap> </WRAP> | |<WRAP><wrap>sh</wrap> </WRAP> |<WRAP><wrap>Shell command</wrap> </WRAP> | |<WRAP><wrap>shcmdopt</wrap> </WRAP> |<WRAP><wrap>Display or set shell command option</wrap> </WRAP> | |<WRAP><wrap>showdvol1</wrap> </WRAP> |<WRAP><wrap>Display or set enable showing of DASD volsers in device list</wrap> </WRAP> | |<WRAP><wrap>shrd</wrap> </WRAP> |<WRAP><wrap>Display or set shared device server trace</wrap> </WRAP> | |<WRAP><wrap>shrdport</wrap> </WRAP> |<WRAP><wrap>Set shared device server port</wrap> </WRAP> | |<WRAP><wrap>sizeof</wrap> </WRAP> |<WRAP><wrap>Display size of structures</wrap> </WRAP> | |<WRAP><wrap>srvprio</wrap> </WRAP> |<WRAP><wrap>Display or set server threads process priority</wrap> </WRAP> | |<WRAP><wrap>ssd</wrap> </WRAP> |<WRAP><wrap>Signal Shutdown</wrap> </WRAP> | |<WRAP><wrap>start</wrap> </WRAP> |<WRAP><wrap>Start CPU or printer / punch device</wrap> </WRAP> | |<WRAP><wrap>startall</wrap> </WRAP> |<WRAP><wrap>Start all CPU’s</wrap> </WRAP> | |<WRAP><wrap>stop</wrap> </WRAP> |<WRAP><wrap>Stop CPU or printer / punch device</wrap> </WRAP> | |<WRAP><wrap>stopall</wrap> </WRAP> |<WRAP><wrap>Stop all CPU’s</wrap> </WRAP> | |<WRAP><wrap>store</wrap> </WRAP> |<WRAP><wrap>Store CPU status at absolute zero</wrap> </WRAP> | |<WRAP><wrap>suspend</wrap> </WRAP> |<WRAP><wrap>Suspend Hercules</wrap> </WRAP> | |<WRAP><wrap>symptom</wrap> </WRAP> |<WRAP><wrap>Instruction trace display option (alias for TRACEOPT command)</wrap> </WRAP> | |<WRAP><wrap>syncio</wrap> </WRAP> |<WRAP><wrap>Display syncio device statistics</wrap> </WRAP> | |<WRAP><wrap>sysclear</wrap> </WRAP> |<WRAP><wrap>SYSTEM CLEAR RESET manual operation</wrap> </WRAP> | |<WRAP><wrap>sysepoch</wrap> </WRAP> |<WRAP><wrap>Set base date for TOD clock</wrap> </WRAP> | |<WRAP><wrap>sysreset</wrap> </WRAP> |<WRAP><wrap>SYSTEM RESET manual operation</wrap> </WRAP> | |<WRAP><wrap>t</wrap> </WRAP> |<WRAP><wrap>Instruction trace</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 249</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>t+</wrap> </WRAP> |<WRAP><wrap>Instruction trace on</wrap> </WRAP> | |<WRAP><wrap>t-</wrap> </WRAP> |<WRAP><wrap>Instruction trace off</wrap> </WRAP> | |<WRAP><wrap>t?</wrap> </WRAP> |<WRAP><wrap>Instruction trace query</wrap> </WRAP> | |<WRAP><wrap>t{+/-} CKD</wrap> </WRAP> |<WRAP><wrap>Turn CKD_KEY tracing on / off</wrap> </WRAP> | |<WRAP><wrap>t{+/-} dev</wrap> </WRAP> |<WRAP><wrap>Turn CCW tracing on / off</wrap> </WRAP> | |<WRAP><wrap>timerint</wrap> </WRAP> |<WRAP><wrap>Display or set timers update interval</wrap> </WRAP> | |<WRAP><wrap>tlb</wrap> </WRAP> |<WRAP><wrap>Display TLB tables</wrap> </WRAP> | |<WRAP><wrap>toddrag</wrap> </WRAP> |<WRAP><wrap>Display or set TOD clock drag factor</wrap> </WRAP> | |<WRAP><wrap>todprio</wrap> </WRAP> |<WRAP><wrap>Display or set timer thread process priority</wrap> </WRAP> | |<WRAP><wrap>traceopt</wrap> </WRAP> |<WRAP><wrap>Instruction trace display option</wrap> </WRAP> | |<WRAP><wrap>tt32</wrap> </WRAP> |<WRAP><wrap>Control / query CTCI-WIN functionality</wrap> </WRAP> | |<WRAP><wrap>tzoffset</wrap> </WRAP> |<WRAP><wrap>Set TOD clock offset from GMT</wrap> </WRAP> | |<WRAP><wrap>u</wrap> </WRAP> |<WRAP><wrap>Disassemble storage</wrap> </WRAP> | |<WRAP><wrap>uptime</wrap> </WRAP> |<WRAP><wrap>Display Hercules Emulator uptime</wrap> </WRAP> | |<WRAP><wrap>v</wrap> </WRAP> |<WRAP><wrap>Display or alter virtual storage</wrap> </WRAP> | |<WRAP><wrap>version</wrap> </WRAP> |<WRAP><wrap>Display version information</wrap> </WRAP> | |<WRAP><wrap>xpndsize</wrap> </WRAP> |<WRAP><wrap>Display or set expanded storage size</wrap> </WRAP> | |<WRAP><wrap>yroffset</wrap> </WRAP> |<WRAP><wrap>Set TOD clock offset from actual date</wrap> </WRAP> | **<wrap>Table 16: Hercules Console Commands (sorted alphabetically)</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>7.7 Hercules Console Commands (grouped by functionality)</wrap>** <wrap>The next table shows an overview of the valid Hercules console commands that can be entered in the control panel (Hercules console display). In this table the commands are grouped by functionality.</wrap> <wrap>Please note that the availability of certain commands depends on the build options used when Hercules was compiled. For a list of all build options and the related console commands please consult “Appendix E. Build Options for System Parameters and Console Commands”.</wrap> |<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>help</wrap> </WRAP> |<WRAP><wrap>List all commands / command specific help</wrap> </WRAP> | <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 250</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>?</wrap> </WRAP> |<WRAP><wrap>List all commands / command specific help (alias for help)</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>#</wrap> </WRAP> |<WRAP><wrap>Silent comment</wrap> </WRAP> | |<WRAP><wrap>*</wrap> </WRAP> |<WRAP><wrap>Loud comment</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cmdlevel</wrap> </WRAP> |<WRAP><wrap>Display or set the current command group</wrap> </WRAP> | |<WRAP><wrap>cmdlvl</wrap> </WRAP> |<WRAP><wrap>Alias for cmdlevel</wrap> </WRAP> | |<WRAP><wrap>cmdsep</wrap> </WRAP> |<WRAP><wrap>Display or set command line seperator</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>message</wrap> </WRAP> |<WRAP><wrap>Display message on console like VM</wrap> </WRAP> | |<WRAP><wrap>msg</wrap> </WRAP> |<WRAP><wrap>Display message on console like VM</wrap> </WRAP> | |<WRAP><wrap>msgnoh</wrap> </WRAP> |<WRAP><wrap>Display message on console like VM, but without header</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>quiet</wrap> </WRAP> |<WRAP><wrap>Toggle automatic refresh of console display data</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>hst</wrap> </WRAP> |<WRAP><wrap>History of commands</wrap> </WRAP> | |<WRAP><wrap>hao</wrap> </WRAP> |<WRAP><wrap>Hercules Automatic Operator (HAO)</wrap> </WRAP> | |<WRAP><wrap>log</wrap> </WRAP> |<WRAP><wrap>Direct logger output</wrap> </WRAP> | |<WRAP><wrap>logopt</wrap> </WRAP> |<WRAP><wrap>Display or set logging options</wrap> </WRAP> | |<WRAP><wrap>msglevel</wrap> </WRAP> |<WRAP><wrap>Display or set the current message display output</wrap> </WRAP> | |<WRAP><wrap>msglvl</wrap> </WRAP> |<WRAP><wrap>Display or set the current message display output (alias for msglevel command)</wrap> </WRAP> | |<WRAP><wrap>ostailor</wrap> </WRAP> |<WRAP><wrap>Tailor trace information for specific operating system</wrap> </WRAP> | |<WRAP><wrap>uptime</wrap> </WRAP> |<WRAP><wrap>Display Hercules Emulator uptime</wrap> </WRAP> | |<WRAP><wrap>version</wrap> </WRAP> |<WRAP><wrap>Display version information</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>exit</wrap> </WRAP> |<WRAP><wrap>Terminate the emulator</wrap> </WRAP> | |<WRAP><wrap>quit</wrap> </WRAP> |<WRAP><wrap>Terminate the emulator</wrap> </WRAP> | |<WRAP><wrap>quitmout</wrap> </WRAP> |<WRAP><wrap>Display or set quit timeout value</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cpu</wrap> </WRAP> |<WRAP><wrap>Define target CPU for console display and commands</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>fcb</wrap> </WRAP> |<WRAP><wrap>Display current FCB or load new FCB image</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 251</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>start</wrap> </WRAP> |<WRAP><wrap>Start CPU or printer / punch device</wrap> </WRAP> | |<WRAP><wrap>stop</wrap> </WRAP> |<WRAP><wrap>Stop CPU or printer / punch device</wrap> </WRAP> | |<WRAP><wrap>startall</wrap> </WRAP> |<WRAP><wrap>Start all CPU’s</wrap> </WRAP> | |<WRAP><wrap>stopall</wrap> </WRAP> |<WRAP><wrap>Stop all CPU’s</wrap> </WRAP> | |<WRAP><wrap>cf</wrap> </WRAP> |<WRAP><wrap>Configure current CPU online or offline</wrap> </WRAP> | |<WRAP><wrap>cfall</wrap> </WRAP> |<WRAP><wrap>Configure all CPU’s online or offline</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.reply</wrap> </WRAP> |<WRAP><wrap>SCP command</wrap> </WRAP> | |<WRAP><wrap>!message</wrap> </WRAP> |<WRAP><wrap>SCP priority message</wrap> </WRAP> | |<WRAP><wrap>scpecho</wrap> </WRAP> |<WRAP><wrap>Display or set echo to console and history of SCP replies</wrap> </WRAP> | |<WRAP><wrap>scpimply</wrap> </WRAP> |<WRAP><wrap>Display or set option to pass non-Hercules commands to the SCP</wrap> </WRAP> | |<WRAP><wrap>ssd</wrap> </WRAP> |<WRAP><wrap>Signal Shutdown</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>ptt</wrap> </WRAP> |<WRAP><wrap>Display or set internal trace</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>i</wrap> </WRAP> |<WRAP><wrap>Generate I/O attention interrupt for device</wrap> </WRAP> | |<WRAP><wrap>ext</wrap> </WRAP> |<WRAP><wrap>Generate external interrupt</wrap> </WRAP> | |<WRAP><wrap>restart</wrap> </WRAP> |<WRAP><wrap>Generate restart interrupt</wrap> </WRAP> | |<WRAP><wrap>archlvl</wrap> </WRAP> |<WRAP><wrap>Set architecture level</wrap> </WRAP> | |<WRAP><wrap>archmode</wrap> </WRAP> |<WRAP><wrap>Set architecture mode (alias for ARCHLVL command)</wrap> </WRAP> | |<WRAP><wrap>engines</wrap> </WRAP> |<WRAP><wrap>Set processor engines type</wrap> </WRAP> | |<WRAP><wrap>defstore</wrap> </WRAP> |<WRAP><wrap>Display or define main and expanded storage values</wrap> </WRAP> | |<WRAP><wrap>mainsize</wrap> </WRAP> |<WRAP><wrap>Display or set main storage size</wrap> </WRAP> | |<WRAP><wrap>xpndsize</wrap> </WRAP> |<WRAP><wrap>Display or set expanded storage size</wrap> </WRAP> | |<WRAP><wrap>cpuprio</wrap> </WRAP> |<WRAP><wrap>Display or set CPU thread process priority</wrap> </WRAP> | |<WRAP><wrap>devprio</wrap> </WRAP> |<WRAP><wrap>Display or set device threads process priority</wrap> </WRAP> | |<WRAP><wrap>hercprio</wrap> </WRAP> |<WRAP><wrap>Display or set Hercules process priority</wrap> </WRAP> | |<WRAP><wrap>srvprio</wrap> </WRAP> |<WRAP><wrap>Display or set server threads process priority</wrap> </WRAP> | |<WRAP><wrap>todprio</wrap> </WRAP> |<WRAP><wrap>Display or set timer thread process priority</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 252</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>maxcpu</wrap> </WRAP> |<WRAP><wrap>Display or set maximum number of CPUs</wrap> </WRAP> | |<WRAP><wrap>numcpu</wrap> </WRAP> |<WRAP><wrap>Display or set number of installed CPUs</wrap> </WRAP> | |<WRAP><wrap>numvec</wrap> </WRAP> |<WRAP><wrap>Display or set number of vector facilities</wrap> </WRAP> | |<WRAP><wrap>loadparm</wrap> </WRAP> |<WRAP><wrap>Set IPL parameter</wrap> </WRAP> | |<WRAP><wrap>lparname</wrap> </WRAP> |<WRAP><wrap>Display or set LPAR name</wrap> </WRAP> | |<WRAP><wrap>lparnum</wrap> </WRAP> |<WRAP><wrap>Display or set LPAR identification number</wrap> </WRAP> | |<WRAP><wrap>cpumodel</wrap> </WRAP> |<WRAP><wrap>Display or set CPU model number</wrap> </WRAP> | |<WRAP><wrap>cpuserial</wrap> </WRAP> |<WRAP><wrap>Display or set CPU serial number</wrap> </WRAP> | |<WRAP><wrap>cpuverid</wrap> </WRAP> |<WRAP><wrap>Display or set CPU version code</wrap> </WRAP> | |<WRAP><wrap>cpuidfmt</wrap> </WRAP> |<WRAP><wrap>Display or set format BASIC / 0 / 1 STIDP generation</wrap> </WRAP> | |<WRAP><wrap>cnslport</wrap> </WRAP> |<WRAP><wrap>Display or set console port</wrap> </WRAP> | |<WRAP><wrap>capping</wrap> </WRAP> |<WRAP><wrap>Display or set CPU capping value</wrap> </WRAP> | |<WRAP><wrap>manufacturer</wrap> </WRAP> |<WRAP><wrap>Display or set STSI manufacturer code</wrap> </WRAP> | |<WRAP><wrap>model</wrap> </WRAP> |<WRAP><wrap>Display or set STSI model code</wrap> </WRAP> | |<WRAP><wrap>plant</wrap> </WRAP> |<WRAP><wrap>Display or set STSI plant code</wrap> </WRAP> | |<WRAP><wrap>pgmprdos</wrap> </WRAP> |<WRAP><wrap>Set LPP license setting</wrap> </WRAP> | |<WRAP><wrap>codepage</wrap> </WRAP> |<WRAP><wrap>Display or set codepage conversion table</wrap> </WRAP> | |<WRAP><wrap>cp_updt</wrap> </WRAP> |<WRAP><wrap>Create or modify user character conversion table</wrap> </WRAP> | |<WRAP><wrap>diag8cmd</wrap> </WRAP> |<WRAP><wrap>Display or set DIAGNOSE 8 command option</wrap> </WRAP> | |<WRAP><wrap>shcmdopt</wrap> </WRAP> |<WRAP><wrap>Display or set shell command option</wrap> </WRAP> | |<WRAP><wrap>legacysenseid</wrap> </WRAP> |<WRAP><wrap>Display or set SENSE ID CCW (x’E4) feature</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>sysepoch</wrap> </WRAP> |<WRAP><wrap>Set base date for TOD clock</wrap> </WRAP> | |<WRAP><wrap>tzoffset</wrap> </WRAP> |<WRAP><wrap>Set TOD clock offset from GMT</wrap> </WRAP> | |<WRAP><wrap>yroffset</wrap> </WRAP> |<WRAP><wrap>Set TOD clock offset from actual date</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>ipl</wrap> </WRAP> |<WRAP><wrap>IPL Normal from device xxxx</wrap> </WRAP> | |<WRAP><wrap>iplc</wrap> </WRAP> |<WRAP><wrap>IPL Clear from device xxxx</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 253</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>sysreset</wrap> </WRAP> |<WRAP><wrap>SYSTEM RESET manual operation</wrap> </WRAP> | |<WRAP><wrap>sysclear</wrap> </WRAP> |<WRAP><wrap>SYSTEM CLEAR RESET manual operation</wrap> </WRAP> | |<WRAP><wrap>store</wrap> </WRAP> |<WRAP><wrap>Store CPU status at absolute zero</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>sclproot</wrap> </WRAP> |<WRAP><wrap>Set or display SCLP base directory</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>http</wrap> </WRAP> |<WRAP><wrap>Start, stop, modify or display HTTP server</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>psw</wrap> </WRAP> |<WRAP><wrap>Display or alter program status word</wrap> </WRAP> | |<WRAP><wrap>gpr</wrap> </WRAP> |<WRAP><wrap>Display or alter general purpose registers</wrap> </WRAP> | |<WRAP><wrap>fpr</wrap> </WRAP> |<WRAP><wrap>Display or alter floating point registers</wrap> </WRAP> | |<WRAP><wrap>fpc</wrap> </WRAP> |<WRAP><wrap>Display or alter floating point control register</wrap> </WRAP> | |<WRAP><wrap>cr</wrap> </WRAP> |<WRAP><wrap>Display or alter control registers</wrap> </WRAP> | |<WRAP><wrap>ar</wrap> </WRAP> |<WRAP><wrap>Display access registers</wrap> </WRAP> | |<WRAP><wrap>pr</wrap> </WRAP> |<WRAP><wrap>Display prefix register</wrap> </WRAP> | |<WRAP><wrap>timerint</wrap> </WRAP> |<WRAP><wrap>Display or set timers update interval</wrap> </WRAP> | |<WRAP><wrap>clocks</wrap> </WRAP> |<WRAP><wrap>Display TOD clock and CPU timer</wrap> </WRAP> | |<WRAP><wrap>ipending</wrap> </WRAP> |<WRAP><wrap>Display pending interrupts</wrap> </WRAP> | |<WRAP><wrap>ds</wrap> </WRAP> |<WRAP><wrap>Display subchannel</wrap> </WRAP> | |<WRAP><wrap>abs</wrap> </WRAP> |<WRAP><wrap>Display or alter absolute storage</wrap> </WRAP> | |<WRAP><wrap>r</wrap> </WRAP> |<WRAP><wrap>Display or alter real storage</wrap> </WRAP> | |<WRAP><wrap>v</wrap> </WRAP> |<WRAP><wrap>Display or alter virtual storage</wrap> </WRAP> | |<WRAP><wrap>u</wrap> </WRAP> |<WRAP><wrap>Disassemble storage</wrap> </WRAP> | |<WRAP><wrap>devtmax</wrap> </WRAP> |<WRAP><wrap>Display or set max device threads</wrap> </WRAP> | |<WRAP><wrap>k</wrap> </WRAP> |<WRAP><wrap>Display CCKD internal trace</wrap> </WRAP> | |<WRAP><wrap>memlock</wrap> </WRAP> |<WRAP><wrap>Lock Hercules memory</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>attach</wrap> </WRAP> |<WRAP><wrap>Configure device</wrap> </WRAP> | |<WRAP><wrap>detach</wrap> </WRAP> |<WRAP><wrap>Remove device</wrap> </WRAP> | |<WRAP><wrap>define</wrap> </WRAP> |<WRAP><wrap>Rename device</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 254</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>devinit</wrap> </WRAP> |<WRAP><wrap>Reinitialize device</wrap> </WRAP> | |<WRAP><wrap>devlist</wrap> </WRAP> |<WRAP><wrap>List device, device class or all devices</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>qcpuid</wrap> </WRAP> |<WRAP><wrap>Display CPU ID</wrap> </WRAP> | |<WRAP><wrap>qd</wrap> </WRAP> |<WRAP><wrap>Query device information</wrap> </WRAP> | |<WRAP><wrap>qpfkeys</wrap> </WRAP> |<WRAP><wrap>Display the current PF key settings</wrap> </WRAP> | |<WRAP><wrap>qpid</wrap> </WRAP> |<WRAP><wrap>Display process ID of Hercules</wrap> </WRAP> | |<WRAP><wrap>qports</wrap> </WRAP> |<WRAP><wrap>Display TCP/IP ports in use</wrap> </WRAP> | |<WRAP><wrap>qproc</wrap> </WRAP> |<WRAP><wrap>Display processors type and utilization</wrap> </WRAP> | |<WRAP><wrap>qstor</wrap> </WRAP> |<WRAP><wrap>Display main and expanded storage values</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>mounted_tape_reinit</wrap> </WRAP> |<WRAP><wrap>Control tape initialization</wrap> </WRAP> | |<WRAP><wrap>auto_scsi_mount</wrap> </WRAP> |<WRAP><wrap>Automatic SCSI tape mounts (deprecated, use SCSIMOUNT instead)</wrap> </WRAP> | |<WRAP><wrap>scsimount</wrap> </WRAP> |<WRAP><wrap>Automatic SCSI tape mounts</wrap> </WRAP> | |<WRAP><wrap>autoinit</wrap> </WRAP> |<WRAP><wrap>Display or set the automatic creation of empty tape files</wrap> </WRAP> | |<WRAP><wrap>automount</wrap> </WRAP> |<WRAP><wrap>Display or update allowable tape automount directories</wrap> </WRAP> | |<WRAP><wrap>mt</wrap> </WRAP> |<WRAP><wrap>Control magnetic tape operation</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cd</wrap> </WRAP> |<WRAP><wrap>Change directory</wrap> </WRAP> | |<WRAP><wrap>dir</wrap> </WRAP> |<WRAP><wrap>Display file and directory listing</wrap> </WRAP> | |<WRAP><wrap>ls</wrap> </WRAP> |<WRAP><wrap>Display file and directory listing</wrap> </WRAP> | |<WRAP><wrap>pwd</wrap> </WRAP> |<WRAP><wrap>Print working directory</wrap> </WRAP> | |<WRAP><wrap>sh</wrap> </WRAP> |<WRAP><wrap>Shell command</wrap> </WRAP> | |<WRAP><wrap>exec</wrap> </WRAP> |<WRAP><wrap>Execute a REXX script</wrap> </WRAP> | |<WRAP><wrap>rexx</wrap> </WRAP> |<WRAP><wrap>Display or set REXX interpreter settings</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cache</wrap> </WRAP> |<WRAP><wrap>Execute cache related commands</wrap> </WRAP> | |<WRAP><wrap>cachestats</wrap> </WRAP> |<WRAP><wrap>Display cache statistics</wrap> </WRAP> | |<WRAP><wrap>cckd</wrap> </WRAP> |<WRAP><wrap>CCKD command</wrap> </WRAP> | |<WRAP><wrap>shrd</wrap> </WRAP> |<WRAP><wrap>Display or set shared device server trace</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 255</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>shrdport</wrap> </WRAP> |<WRAP><wrap>Set shared device server port</wrap> </WRAP> | |<WRAP><wrap>conkpalv</wrap> </WRAP> |<WRAP><wrap>Display / alter console TCP/IP keep-alive settings</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>t</wrap> </WRAP> |<WRAP><wrap>Instruction trace</wrap> </WRAP> | |<WRAP><wrap>t+</wrap> </WRAP> |<WRAP><wrap>Instruction trace on</wrap> </WRAP> | |<WRAP><wrap>t-</wrap> </WRAP> |<WRAP><wrap>Instruction trace off</wrap> </WRAP> | |<WRAP><wrap>t?</wrap> </WRAP> |<WRAP><wrap>Instruction trace query</wrap> </WRAP> | |<WRAP><wrap>s</wrap> </WRAP> |<WRAP><wrap>Instruction stepping</wrap> </WRAP> | |<WRAP><wrap>s+</wrap> </WRAP> |<WRAP><wrap>Instruction stepping on</wrap> </WRAP> | |<WRAP><wrap>s-</wrap> </WRAP> |<WRAP><wrap>Instruction stepping off</wrap> </WRAP> | |<WRAP><wrap>s?</wrap> </WRAP> |<WRAP><wrap>Instruction stepping query</wrap> </WRAP> | |<WRAP><wrap>b</wrap> </WRAP> |<WRAP><wrap>Set breakpoint (synonym for B+)</wrap> </WRAP> | |<WRAP><wrap>b+</wrap> </WRAP> |<WRAP><wrap>Set breakpoint (synonym for B)</wrap> </WRAP> | |<WRAP><wrap>b-</wrap> </WRAP> |<WRAP><wrap>Delete breakpoint</wrap> </WRAP> | |<WRAP><wrap>g</wrap> </WRAP> |<WRAP><wrap>Turn off instruction stepping and start all CPUs</wrap> </WRAP> | |<WRAP><wrap>icount</wrap> </WRAP> |<WRAP><wrap>Display individual instruction counts</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>pgmtrace</wrap> </WRAP> |<WRAP><wrap>Trace program interrupts</wrap> </WRAP> | |<WRAP><wrap>savecore</wrap> </WRAP> |<WRAP><wrap>Save a core image to a file</wrap> </WRAP> | |<WRAP><wrap>loadcore</wrap> </WRAP> |<WRAP><wrap>Load a core image from a file</wrap> </WRAP> | |<WRAP><wrap>loadtext</wrap> </WRAP> |<WRAP><wrap>Load a text deck file</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>modpath</wrap> </WRAP> |<WRAP><wrap>Display or set dynamic load module path</wrap> </WRAP> | |<WRAP><wrap>ldmod</wrap> </WRAP> |<WRAP><wrap>Load a module</wrap> </WRAP> | |<WRAP><wrap>rmmod</wrap> </WRAP> |<WRAP><wrap>Delete a module</wrap> </WRAP> | |<WRAP><wrap>lsmod</wrap> </WRAP> |<WRAP><wrap>List dynamic modules</wrap> </WRAP> | |<WRAP><wrap>lsdep</wrap> </WRAP> |<WRAP><wrap>List module dependencies</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>iodelay</wrap> </WRAP> |<WRAP><wrap>Display or set I/O delay value</wrap> </WRAP> | |<WRAP><wrap>ctc</wrap> </WRAP> |<WRAP><wrap>Enable / disable CTC debugging</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 256</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>ptp</wrap> </WRAP> |<WRAP><wrap>Enable / disable PTP debugging</wrap> </WRAP> | |<WRAP><wrap>tt32</wrap> </WRAP> |<WRAP><wrap>Control / query CTCI-WIN functionality</wrap> </WRAP> | |<WRAP><wrap>toddrag</wrap> </WRAP> |<WRAP><wrap>Display or set TOD clock drag factor</wrap> </WRAP> | |<WRAP><wrap>syncio</wrap> </WRAP> |<WRAP><wrap>Display syncio device statistics</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>kd</wrap> </WRAP> |<WRAP><wrap>Clear held messages</wrap> </WRAP> | |<WRAP><wrap>msghld</wrap> </WRAP> |<WRAP><wrap>Display or set timeout value of held messages</wrap> </WRAP> | |<WRAP><wrap>maxrates</wrap> </WRAP> |<WRAP><wrap>Display highest MIPS/SIO rate or set new reporting interval</wrap> </WRAP> | |<WRAP><wrap>panrate</wrap> </WRAP> |<WRAP><wrap>Display or set console refresh rate</wrap> </WRAP> | |<WRAP><wrap>pantitle</wrap> </WRAP> |<WRAP><wrap>Display or set console window title</wrap> </WRAP> | |<WRAP><wrap>showdvol1</wrap> </WRAP> |<WRAP><wrap>Display or set enable showing of DASD volsers in device list</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>defsym</wrap> </WRAP> |<WRAP><wrap>Define a symbol</wrap> </WRAP> | |<WRAP><wrap>delsym</wrap> </WRAP> |<WRAP><wrap>Delete a symbol</wrap> </WRAP> | |<WRAP><wrap>script</wrap> </WRAP> |<WRAP><wrap>Run a sequence of console commands contained in a file</wrap> </WRAP> | |<WRAP><wrap>cscript</wrap> </WRAP> |<WRAP><wrap>Cancel a running script thread</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>ecpsvm</wrap> </WRAP> |<WRAP><wrap>ECPS:VM commands</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>aea</wrap> </WRAP> |<WRAP><wrap>Display AEA (absolue-effective-address) tables</wrap> </WRAP> | |<WRAP><wrap>aia</wrap> </WRAP> |<WRAP><wrap>Display AIA (absolute-instruction-address) tables</wrap> </WRAP> | |<WRAP><wrap>tlb</wrap> </WRAP> |<WRAP><wrap>Display TLB tables</wrap> </WRAP> | |<WRAP><wrap>$locate</wrap> </WRAP> |<WRAP><wrap>Display and verify Hercules control blocks</wrap> </WRAP> | |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>Custom test command</wrap> </WRAP> | |<WRAP><wrap>$zapcmd</wrap> </WRAP> |<WRAP><wrap>Enable or disable system parameters and console commands</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>sizeof</wrap> </WRAP> |<WRAP><wrap>Display size of structures</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>suspend</wrap> </WRAP> |<WRAP><wrap>Suspend Hercules</wrap> </WRAP> | |<WRAP><wrap>resume</wrap> </WRAP> |<WRAP><wrap>Resume Hercules</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>herclogo</wrap> </WRAP> |<WRAP><wrap>Read a new Hercules logo file</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 257</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Command</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>traceopt</wrap> </WRAP> |<WRAP><wrap>Instruction trace display option</wrap> </WRAP> | |<WRAP><wrap>symptom</wrap> </WRAP> |<WRAP><wrap>Instruction trace display option (alias for TRACEOPT command)</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cmdtgt</wrap> </WRAP> |<WRAP><wrap>Specify the command target</wrap> </WRAP> | |<WRAP><wrap>herc</wrap> </WRAP> |<WRAP><wrap>Send Hercules command</wrap> </WRAP> | |<WRAP><wrap>scp</wrap> </WRAP> |<WRAP><wrap>Send system control program command</wrap> </WRAP> | |<WRAP><wrap>pscp</wrap> </WRAP> |<WRAP><wrap>Send system control program priority message</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>sf+</wrap> </WRAP> |<WRAP><wrap>Create a new shadow file</wrap> </WRAP> | |<WRAP><wrap>sf-</wrap> </WRAP> |<WRAP><wrap>Delete a shadow file</wrap> </WRAP> | |<WRAP><wrap>sfc</wrap> </WRAP> |<WRAP><wrap>Compress a shadow file</wrap> </WRAP> | |<WRAP><wrap>sfd</wrap> </WRAP> |<WRAP><wrap>Display shadow file statistics</wrap> </WRAP> | |<WRAP><wrap>sfk</wrap> </WRAP> |<WRAP><wrap>Perform a chkdsk on the active shadow file</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>t{+/-} CKD</wrap> </WRAP> |<WRAP><wrap>Turn CKD_KEY tracing on / off</wrap> </WRAP> | |<WRAP><wrap>t{+/-} dev</wrap> </WRAP> |<WRAP><wrap>Turn CCW tracing on / off</wrap> </WRAP> | |<WRAP><wrap>s{+/-} dev</wrap> </WRAP> |<WRAP><wrap>Turn CCW stepping on / off</wrap> </WRAP> | |<WRAP><wrap>f{+/-} addr</wrap> </WRAP> |<WRAP><wrap>Mark frames usable / unusable</wrap> </WRAP> | **<wrap>Table 17: Hercules Console Commands (grouped by functionality)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 258</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap></wrap>**<wrap>8. Console Command Descriptions</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>8.1 !message (SCP priority message) \\ //8.1.1 Function//</wrap>** <wrap>The “!message” (SCP) command is used to enter a system control program (i.e. guest operating system) priority command on the hercules console. The command to be issued has to be prefixed with an exclamation point '!'.</wrap> <wrap>This command is similar to the “.reply” command. It is up to the operating system to differentiate between them.</wrap> **//<wrap>8.1.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**//<wrap>!prio_msg</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ !prio message</wrap>// **//<wrap>8.1.3 Parameter</wrap>//** **//<wrap>prio_msg </wrap>//**<wrap>The priority message that will be routed to the system control program running under the Hercules Emulator.</wrap> **//<wrap>8.1.4 Examples</wrap>//** <wrap>For a similar sample please see the “.reply” command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 259</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.2 # (Silent comment) \\ //8.2.1 Function//</wrap>** <wrap>The hash ("#") provides a convenient way of entering comments into the Hercules log file only with no other effect (“silent” comment). The comment is not processed in any way other than to echo it in the log file.</wrap> **//<wrap>8.2.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap># </wrap>****//<wrap>anytext</wrap>//** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ # ¬¬¬ </wrap>****//<wrap>anytext</wrap>//** **//<wrap>8.2.3 Parameter</wrap>//** **//<wrap>anytext </wrap>//**<wrap>This is the text that has to be written only to the Hercules log file (“silent” comment).</wrap> **//<wrap>8.2.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Write a text string to the log file only (“silent” comment).</wrap> <wrap># A comment that is written to the Hercules log file only</wrap> **<wrap>Figure 9: Silent comment</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 260</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.3 $LOCATE (Display and verify Hercules control blocks) //8.3.1 Function//</wrap>** <wrap>The $LOCATE command displays and verifies various Hercules control blocks. The specified control block is displayed in a hex dump format.</wrap> **//<wrap>8.3.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>$LOCATE </wrap>//<wrap>controlblock</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>$LOCATE </wrap><wrap>¬¬¬ </wrap>//<wrap>controlblock</wrap>// **//<wrap>8.3.3 Parameter</wrap>//** **//<wrap>controlblock </wrap>//**<wrap>This specifies the control block to be verified and displayed. Currently the following control blocks are supported through the LOCATE command:</wrap> <wrap>·<wrap></wrap></wrap><wrap>sysblk (System Configuration Block)</wrap> <wrap>·<wrap></wrap></wrap><wrap>regs (CPU Register Context)</wrap> <wrap>·<wrap></wrap></wrap><wrap>hostinfo (Host System Information Block)</wrap> **//<wrap>8.3.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Locate the Hercules sysblk control block. Please note that not all hex columns can be displayed in the figure below. Missing columns have been marked with “∫∫”’.</wrap> |<WRAP><wrap>HHC00013I HHC90000D</wrap> </WRAP> |<WRAP><wrap>Herc DBG:</wrap> </WRAP> |<WRAP><wrap>command: '$locate sysblk' SYSBLK @ 0x002333C0 - Verified</wrap> </WRAP> ||||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0000</wrap> </WRAP> |<WRAP><wrap>53595342</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>002333C0</wrap> </WRAP> |<WRAP><wrap>SYSBLK</wrap> </WRAP> |<WRAP><wrap>4.00 ...... #3.</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0020</wrap> </WRAP> |<WRAP><wrap>00009DE0</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP>__<wrap>/ </wrap>__<wrap></wrap> </WRAP> |<WRAP><wrap>k L</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0040</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0060</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>60140000 </wrap> <wrap>; ... </wrap> </WRAP> |<WRAP><wrap>`pc__ ` __</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0080</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>04000000</wrap> </WRAP> |<WRAP>__<wrap>H</wrap>__<wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x00a0</wrap> </WRAP> |<WRAP><wrap>04000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>387CA600 ....... </wrap> </WRAP> |<WRAP><wrap>dnoC.{..</wrap> </WRAP> |<WRAP><wrap>xtvM.|..xtvM8|..</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x00c0</wrap> </WRAP> |<WRAP><wrap>7874764D</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>307DA600</wrap> </WRAP> |<WRAP><wrap>xtvMp| xtvM.|..</wrap> </WRAP> |<WRAP><wrap>xtvM.|..xtvM0}..</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x00e0</wrap> </WRAP> |<WRAP><wrap>7874764D</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>B00</wrap><wrap>D0000</wrap> </WRAP> |<WRAP><wrap>xtvMh}.. xtvM.}</wrap> </WRAP> |<WRAP><wrap>x</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 261</wrap> <wrap>\\ </wrap> |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0100</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>508D6002 .... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>xtvMP.`.</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0120</wrap> </WRAP> |<WRAP><wrap>FC190000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap> g...g...g..</wrap> </WRAP> |<WRAP><wrap>.g</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0140</wrap> </WRAP> |<WRAP><wrap>0000</wrap><wrap>0000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000 .... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0160</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000 .... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x0180</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000 .... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0</wrap><wrap>x01a0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000 .... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x01c0</wrap> </WRAP> |<WRAP><wrap>80000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000 .... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>sysblk+0x01e0</wrap> </WRAP> |<WRAP><wrap>00008000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000 .... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 10: $LOCATE command (System Configuration Block)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Locate the Hercules regs control block. Please note that not all hex columns can be displayed in the figure below. Missing columns have been marked with “//∫∫//”.</wrap> |<WRAP><wrap>HHC00013I HHC90000D</wrap> </WRAP> |<WRAP><wrap>Herc DBG:</wrap> </WRAP> |<WRAP><wrap>command: '$locate regs'</wrap> <wrap>REGS[00] @ 0x02BF6788 -</wrap> </WRAP> ||<WRAP><wrap>Verified</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0000</wrap> </WRAP> |<WRAP><wrap>52454753</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>REGS_CP00</wrap> </WRAP> |<WRAP><wrap>4.00 ....... g.</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0020</wrap> </WRAP> |<WRAP><wrap>00009720</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>... .3#....... </wrap> </WRAP> |<WRAP><wrap>K............ </wrap> </WRAP> | |<WRAP><wrap>HHC9</wrap><wrap>0000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0040</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0060</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0080</wrap> </WRAP> |<WRAP><wrap>AA8AE302</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 </wrap> <wrap>p..... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x00a0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x00c0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x00e0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0100</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0120</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>@...... </wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0140</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0160</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x0180</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x01a0</wrap> </WRAP> |<WRAP><wrap>10BBFE00</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x01c0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>regs+0x01e0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 11: $LOCATE command (CPU Register Context)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Locate the Hercules hostinfo control block. Please note that not all hex columns can be displayed in the figure below. Missing columns have been marked with “//∫∫//”.</wrap> |<WRAP><wrap>HHC00013I HHC90000D HHC90000D HHC90000D HHC90000D HHC90000D HHC90000D</wrap> </WRAP> |<WRAP><wrap>Herc DBG: DBG: DBG: DBG: DBG:</wrap> <wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>command: HOSTINFO sysname nodename release version machine</wrap> </WRAP> |<WRAP><wrap>'$locate hostinfo'</wrap> <wrap>@ 0x0036AE00 - Verified</wrap> <wrap>= Windows</wrap> <wrap>= GOOFY</wrap> <wrap>= 6.1.7600</wrap> <wrap>= 7 Ultimate Edition</wrap> <wrap>= Intel(R) x64</wrap> </WRAP> ||<WRAP><wrap>64-bit</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>cpu_brand</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>Intel(R) Core(TM)</wrap> </WRAP> |<WRAP><wrap>i7 CPU</wrap> </WRAP> |<WRAP><wrap>Q</wrap> </WRAP> |<WRAP><wrap>720</wrap> </WRAP> |<WRAP><wrap>@</wrap> </WRAP> |<WRAP><wrap>1.60GHz</wrap> </WRAP> | | | | | | | | | | | | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 262</wrap> <wrap>\\ </wrap> |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>trycritsec_avail</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>YES</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>num_procs</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>8</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>num_packages</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>num_physical_cpu</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>4</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>num_logical_cpu</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>8</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>bus_speed</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>0Khz</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>cpu_speed</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>1.6Ghz</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>vector_unit</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>YES</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>fp_unit</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>YES</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>cpu_64bits</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>YES</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>cpu_aes_extns</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>NO</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>valid_cache_nums</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>YES</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>cachelinesz</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>64</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>L1Dcachesz</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>32KiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>L1Icachesz</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>32KiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>L2cachesz</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>256KiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>L3cachesz</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>6MiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>hostpagesz</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>4KiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>AllocGran</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>64KiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>TotalPhys</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>7.9263GiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>AvailPhys</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>6.1006GiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>TotalPageFile</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>15.9245GiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>AvailPageFile</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>13.9831GiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>TotalVirtual</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>1.9999GiB</wrap> </WRAP> | |<WRAP><wrap>HHC90000D</wrap> </WRAP> |<WRAP><wrap>DBG:</wrap> </WRAP> |<WRAP><wrap>AvailVirtual</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>1.8433GiB</wrap> </WRAP> | **<wrap>Figure 12: $LOCATE command (Host System Information Block)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 263</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.4 $TEST (Custom test command) \\ //8.4.1 Function//</wrap>** <wrap>The $TEST command is used for invoking a custom test command. It performs whatever function the user specifically coded it to do.</wrap> <wrap>WARNING: Do not use this command unless you specifically coded the function that this command invokes. Unless you wrote this command you probably don’t know what it is actually doing. It could perform any function, up to crashing Hercules!</wrap> **//<wrap>8.4.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>$TEST </wrap>//<wrap>req_parms </wrap>//<wrap>[</wrap>//<wrap>opt_parms</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬$TEST ¬¬¬ </wrap>//<wrap>req_parms </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿¬¬¬ </wrap>//<wrap>opt_parms </wrap>//<wrap>¬¬¬¯</wrap> **//<wrap>8.4.3 Parameter</wrap>//** **//<wrap>req_parms </wrap>//**<wrap>Any required parameter(s) for the specific implementation of the $TEST command.</wrap> **//<wrap>opt_parms </wrap>//**<wrap>Any optional parameter(s) for the specific implementation of the $TEST command.</wrap> **//<wrap>8.4.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Invoke the Hercules test command. This implementation of $TEST does not require any parameter.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: '$test'</wrap> |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>command: creating</wrap> </WRAP> ||<WRAP><wrap>threads...</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002590:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 2</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002594:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 4</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>000036BC:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 5</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>0000223C:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 1</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>000010C4:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 3</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002590:</wrap> </WRAP> |<WRAP><wrap>2 second</wrap> </WRAP> |<WRAP><wrap>sleep</wrap> </WRAP> |<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00003070:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 3</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 264</wrap> <wrap>\\ </wrap> |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>0000223C:</wrap> </WRAP> |<WRAP><wrap>1 second</wrap> </WRAP> |<WRAP><wrap>sleep</wrap> </WRAP> |<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002AD8:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 6</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002594:</wrap> </WRAP> |<WRAP><wrap>4 second</wrap> </WRAP> |<WRAP><wrap>sleep</wrap> </WRAP> |<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>000028EC:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 4</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>000010C4:</wrap> </WRAP> |<WRAP><wrap>3 second sleep</wrap> </WRAP> ||<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002F2C:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 2</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002494:</wrap> </WRAP> |<WRAP><wrap>sleeping</wrap> </WRAP> |<WRAP><wrap>for 1</wrap> </WRAP> |<WRAP><wrap>seconds...</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00003070:</wrap> </WRAP> |<WRAP><wrap>3 second sleep</wrap> </WRAP> ||<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>command: waiting for threads to exit...</wrap> </WRAP> |||| | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002494:</wrap> </WRAP> |<WRAP><wrap>1 second</wrap> </WRAP> |<WRAP><wrap>sleep</wrap> </WRAP> |<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>000036BC:</wrap> </WRAP> |<WRAP><wrap>5 second</wrap> </WRAP> |<WRAP><wrap>sleep</wrap> </WRAP> |<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002F2C:</wrap> </WRAP> |<WRAP><wrap>2 second</wrap> </WRAP> |<WRAP><wrap>sleep</wrap> </WRAP> |<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>000028EC:</wrap> </WRAP> |<WRAP><wrap>4 second</wrap> </WRAP> |<WRAP><wrap>sleep</wrap> </WRAP> |<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test</wrap> </WRAP> |<WRAP><wrap>thread</wrap> </WRAP> |<WRAP><wrap>00002AD8:</wrap> </WRAP> |<WRAP><wrap>6 second</wrap> </WRAP> |<WRAP><wrap>sleep</wrap> </WRAP> |<WRAP><wrap>done; rc=0</wrap> </WRAP> | |<WRAP><wrap>%%**%%*</wrap> </WRAP> |<WRAP><wrap>$test command: test complete.</wrap> </WRAP> ||||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 13: $TEST command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 265</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.5 $ZAPCMD (Enable or disable system parameters and console commands)</wrap>** **//<wrap>8.5.1 Function</wrap>//** <wrap>The $ZAPCMD console command allows it to enable or disable a given command name as a system parameter (configuration statement) or console command.</wrap> <wrap>This is a console command used for debugging and requires that the debug command level has been set. This is the default for debug builds, but not for normal production builds.</wrap> <wrap>To activate the $ZAPCMD console command for normal non-debug production release builds, use the following command sequence:</wrap> <wrap>MSGLVL VERBOSE (optional)</wrap> <wrap>MSGLVL DEBUG (optional)</wrap> <wrap>CMDLVL DEBUG (required) \\ $ZAPCMD //cmdname option//</wrap> <wrap>Note: It is possible to disable the $ZAPCMD console command itself, so be careful!</wrap> **//<wrap>8.5.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>$ZAPCMD cmdname [CFG | CMD | N0CFG | N0CMD]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ </wrap>//<wrap>$ZAPCMD </wrap>//<wrap>¬¬¬ cmdname ¬¬¬§¬¬¬ </wrap>//<wrap>CFG </wrap>//<wrap>¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>// <wrap>I¬¬¬ N0CFG </wrap>//<wrap>¬¬¬«</wrap>// <wrap>ª¬¬¬CMD </wrap>//<wrap>¬¬¬¬¬«</wrap>// <wrap>⡿¬¬¬N0CMD¬¬¬¯</wrap> **//<wrap>8.5.3 Parameter</wrap>//** **//<wrap>cmdname </wrap>//**<wrap>Specifies the command name of the system parameter (configuration statement) or the console command that has to be enabled or disabled.</wrap> **<wrap>CFG </wrap>**<wrap>Enable the given command name as a system parameter (configuration statement).</wrap> **<wrap>NOCFG </wrap>**<wrap>Disable the given command name as a system parameter (configuration statement).</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 266</wrap> <wrap>\\ </wrap>**<wrap>CMD </wrap>**<wrap>Enable the given command name as a console command.</wrap> **<wrap>NOCMD </wrap>**<wrap>Disable the given command name as a console command.</wrap> **//<wrap>8.5.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Disable ARCHLVL as a console command.</wrap> <wrap>HHC00013I Herc command: 'archlvl s/370'</wrap> <wrap>HHC01603I $zapcmd archlvl nocmd</wrap> <wrap>HHC01603I archlvl s/370</wrap> <wrap>HHC01600E Unknown command archlvl, enter 'help' for a list of valid commands</wrap> **<wrap>Figure 14: $ZAPCMD command (disable console command)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 267</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.6 * (Loud comment) \\ //8.6.1 Function//</wrap>** <wrap>The asterisk ("*") provides a convenient way of entering comments into the Hercules log file and to the Hercules console with no other effect (“loud” comment). The comment is not processed in any way other than to echo it in the log file and at the console.</wrap> **//<wrap>8.6.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>* </wrap>****//<wrap>anytext</wrap>//** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ * ¬¬¬ </wrap>****//<wrap>anytext</wrap>//** **//<wrap>8.6.3 Parameter</wrap>//** **//<wrap>anytext </wrap>//**<wrap>This is the text that has to be written to the Hercules log file and displayed on the Hercules console (“loud” comment).</wrap> **//<wrap>8.6.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Write a text string to the log file and the console (“loud” comment).</wrap> <wrap>* A comment that is written to the Hercules log file and displayed on the Hercules console</wrap> **<wrap>Figure 15: Loud comment</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 268</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.7 .reply (SCP command) \\ //8.7.1 Function//</wrap>** <wrap>The “.reply” (SCP) command is used to give a reply to a system control program (i.e. the guest operating system running under Hercules) message. To reply to a SCP message that gets issued to the Hercules console, prefix the reply with a period (dot).</wrap> **//<wrap>8.7.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>.</wrap>//<wrap>reply</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ .</wrap>//<wrap>reply</wrap>// **//<wrap>8.7.3 Parameter</wrap>//** **//<wrap>reply </wrap>//**<wrap>The reply that will be routed to the system control program running under the Hercules Emulator.</wrap> **//<wrap>8.7.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Reply to message IGGN504A (“r 00,0148”).</wrap> |<WRAP><wrap>* IGGN504A SPECIFY UNIT FOR CATALOG.MVS.MASTER ON MVSRES</wrap> <wrap>.r 00,0148</wrap> <wrap>HHCCP041I SYSCONS interface active</wrap> <wrap>IEE600I REPLY TO 00 IS;0148</wrap> </WRAP> | **<wrap>Figure 16: SCP command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 269</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.8 ? (List all commands / command specific help) \\ //8.8.1 Function//</wrap>** <wrap>The “?” command is an alias for the “help” command. Without any options it will display a sorted list of all commands matching the current command level with a short description. It is possible to specify a partial command name followed by an asterisk (“*”) to get a list of all commands matching the partial command name. For example ‘? msg*’ will list all commands beginning with ‘msg’ and matching the current command level.</wrap> <wrap>If the list is enterd with a full command name it will display a long form of help information associated with that command if the command is available for the current command level. The list provided by the command without options shows with an asterisk in front of the description if there is additional information available.</wrap> <wrap>The displayed help text may be limited to explaining the general format of the command and its various required or optional parameters and is not meant to replace the appropriate manual.</wrap> **//<wrap>8.8.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>? [</wrap>****//<wrap>command </wrap>//**<wrap>|</wrap>**//<wrap> cmd*</wrap>//****<wrap>]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ</wrap>****<wrap>¬¬¬ ? ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬</wrap>** <wrap>ªØØ-</wrap>**//<wrap> command \\ </wrap>//**<wrap>⡿Ø</wrap>**<wrap>¬¬¬ </wrap>****//<wrap>cmd* </wrap>//****<wrap>¬¬</wrap>** **//<wrap>8.8.3 Parameter</wrap>//** **//<wrap>command </wrap>//**<wrap>The Hercules console command to which additional information is desired.</wrap> **//<wrap>cmd* </wrap>//**<wrap>Provides a list of all commands beginning with the partial command name ‘cmd’ and matching the current command level.</wrap> **//<wrap>8.8.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>List all valid console commands matching the current command level.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: '?' \\ HHC01603I</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 270</wrap> <wrap>\\ </wrap>|<WRAP><wrap>HHC01602I Command Description</wrap> <wrap>HHC01602I ----- </wrap> <wrap>HHC01602I !message *SCP priority messsage</wrap> <wrap>HHC01602I # Silent comment</wrap> <wrap>HHC01602I * Loud comment</wrap> <wrap>HHC01602I .reply *SCP command</wrap> <wrap>HHC01602I ? alias for help</wrap> <wrap>HHC01602I aea Display AEA tables</wrap> <wrap>HHC01602I aia Display AIA fields</wrap> <wrap>HHC01602I alrf Command deprecated: Use "archlvl" instead</wrap> <wrap>HHC01602I ar Display access registers</wrap> <wrap>HHC01602I archlvl *Set Architecture Level</wrap> <wrap>HHC01602I archmode Alias for archlvl</wrap> <wrap>HHC01602I asn_and_l Command deprecated: Use "archlvl" instead</wrap> <wrap>HHC01602I attach *Configure device</wrap> <wrap>HHC01602I auto_scsi *Command deprecated - Use "SCSIMOUNT"</wrap> <wrap>HHC01602I autoinit *Display/Set automatic create empty tape file switch HHC01602I automount *Display/Update allowable tape automount directories</wrap> <wrap>HHC01602I b *Set breakpoint</wrap> <wrap>HHC01602I b+ Set breakpoint</wrap> <wrap>HHC01602I b- *Delete breakpoint</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC01602I s{+/-}dev Turn CCW stepping on/off</wrap> <wrap>HHC01602I t *Instruction trace</wrap> <wrap>HHC01602I t+ *Instruction trace on</wrap> <wrap>HHC01602I t- Turn off instruction tracing</wrap> <wrap>HHC01602I t? *Instruction trace query</wrap> <wrap>HHC01602I timerint *Display or set timers update interval</wrap> <wrap>HHC01602I tlb Display TLB tables</wrap> <wrap>HHC01602I toddrag Display or set TOD clock drag factor</wrap> <wrap>HHC01602I todprio Set/Display todprio parameter</wrap> <wrap>HHC01602I traceopt *Instruction trace display options</wrap> <wrap>HHC01602I tt32 *Control/query CTCI-WIN functionality</wrap> <wrap>HHC01602I tzoffset Set tzoffset parameter</wrap> <wrap>HHC01602I t{+/-}CKD Turn CKD_KEY tracing on/off</wrap> <wrap>HHC01602I t{+/-}dev Turn CCW tracing on/off</wrap> <wrap>HHC01602I u Disassemble storage</wrap> <wrap>HHC01602I uptime Display how long Hercules has been running</wrap> <wrap>HHC01602I v *Display or alter virtual storage</wrap> <wrap>HHC01602I version Display version information</wrap> <wrap>HHC01602I xpndsize *Define/Display xpndsize parameter</wrap> <wrap>HHC01602I yroffset Set yroffset parameter</wrap> <wrap>HHC01603I</wrap> <wrap>HHC01610I (*) More help available.</wrap> </WRAP> | **<wrap>Figure 17: “?” command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 271</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Display a list of commands beginning with ‘cpu’ and matching the current command level.</wrap> <wrap>HHC00013I Herc command: '? cpu*' \\ HHC01603I</wrap> <wrap>HHC01602I Command Description</wrap> <wrap>HHC01602I ------ </wrap> <wrap>HHC01602I cpu *Define target cpu for panel display and commands</wrap> <wrap>HHC01602I cpuidfmt Set format 0/1 STIDP generation</wrap> <wrap>HHC01602I cpumodel Set CPU model number</wrap> <wrap>HHC01602I cpuprio Set/Display cpuprio parameter</wrap> <wrap>HHC01602I cpuserial Set CPU serial number</wrap> <wrap>HHC01602I cpuverid Set CPU verion number</wrap> <wrap>HHC01603I</wrap> <wrap>HHC01610I (*) More help available.</wrap> **<wrap>Figure 18: “? CPU*” command</wrap>** **<wrap>Example 3:</wrap>** <wrap>Display additional help text for the MAINSIZE command.</wrap> <wrap>HHC00013I Herc command: '? mainsize' \\ HHC01603I</wrap> <wrap>HHC01602I Command Description</wrap> <wrap>HHC01602I ------ </wrap> <wrap>HHC01602I mainsize *Define/Display mainsize parameter</wrap> <wrap>HHC01603I</wrap> <wrap>HHC01603I Format: mainsize [ mmmm | nnnS [ lOCK | unlOCK ] ]</wrap> <wrap>HHC01603I mmmm - define main storage size mmmm Megabytes \\ HHC01603I</wrap> <wrap>HHC01603I nnnS - define main storage size nnn S where S is the multiplier</wrap> <wrap>HHC01603I B = no multiplier</wrap> <wrap>HHC01603I K = 2%%**%%10 (kilo/kibi)</wrap> <wrap>HHC01603I M = 2%%**%%20 (mega/mebi)</wrap> <wrap>HHC01603I G = 2%%**%%30 (giga/gibi)</wrap> <wrap>HHC01603I T = 2%%**%%40 (tera/tebi)</wrap> <wrap>HHC01603I P = 2%%**%%50 (peta/pebi)</wrap> <wrap>HHC01603I E = 2%%**%%60 (exa/exbi) \\ HHC01603I</wrap> <wrap>HHC01603I lOCK - attempt to lock storage (pages lock by host OS)</wrap> <wrap>HHC01603I unlOCK - leave storage unlocked (pagable by host OS) \\ HHC01603I</wrap> <wrap>HHC01603I (none) - display current mainsize value</wrap> <wrap>HHC01603I</wrap> <wrap>HHC01603I Note: Multipliers 'T', 'P', and 'E' are not available on 32bit machines</wrap> **<wrap>Figure 19: “? MAINSIZE” command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 272</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.9 ABS (Display or alter absolute storage) \\ //8.9.1 Function//</wrap>** <wrap>The ABS command allows you to display or alter absolute storage. Up to 64K of absolute storage can be displayed, up to 32 bytes of absolute storage can be altered.</wrap> **//<wrap>8.9.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>ABS {</wrap>//<wrap>addr </wrap>//<wrap>| </wrap>//<wrap>addr.length </wrap>//<wrap>| </wrap>//<wrap>addr-addr </wrap>//<wrap>| </wrap>//<wrap>addr=value</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ </wrap><wrap>ABS </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬ </wrap>//<wrap>addr </wrap>//<wrap>¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ </wrap>//<wrap>addr.length </wrap>//<wrap>¬¬¬«</wrap> <wrap>ª</wrap><wrap>¬¬¬¬ </wrap>//<wrap>addr-addr </wrap>//<wrap>¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>addr=value </wrap>//<wrap>¬¬¬</wrap><wrap>¬¯</wrap> **//<wrap>8.9.3 Parameter</wrap>//** **//<wrap>addr </wrap>//**<wrap>Specifies the address of the absolute storage that is to be displayed. If //addr //is given without a length or without a second address for the end of the storage area then 64 bytes of absolute storage are displayed.</wrap> **//<wrap>addr.length </wrap>//**<wrap>Specifies the address of the absolute storage area that is to be displayed with starting address and length (from address //addr //with the length of //length//). The //length //value must be given in hexadecimal. The maximum length that can be specified is 64K.</wrap> **//<wrap>addr-addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address) of the absolute storage area that is to be displayed.</wrap> **//<wrap>addr=value </wrap>//**<wrap>Specifies the address of the absolute storage area that is to be altered. //value //is a hex-string of up to 32 pairs of hex digits (32 bytes) which will be written to the absolute storage address given by the //addr //parameter. After altering the storage, 16 bytes of absolute storage starting at //addr //are displayed.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 273</wrap> <wrap>\\ </wrap>**//<wrap>8.9.4 Examples</wrap>//** **<wrap>Example 1: \\ </wrap>**<wrap>to be done.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'abs 00000000.ff'</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 20: ABS command (display absolute storage)</wrap>** **<wrap>Example 2: \\ </wrap>**<wrap>to be done.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'abs 00000000=FFFFFFFF'</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 21: ABS command (alter absolute storage)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 274</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.10 AEA (Display AEA absolute-effective-address tables) //8.10.1 Function//</wrap>** <wrap>Display the Hercules AEA tables. The AEA table is an address lookup accelerator which saves absolute data addresses for further lookups to eliminate the calls to logical_to_main.This shortens the translation path length.</wrap> **//<wrap>8.10.2 Syntax</wrap>//** **__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>AEA</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ AEA</wrap>** **//<wrap>8.10.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.10.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the AEA tables</wrap> <wrap>HHC00013I Herc command: 'aea' \\ HHC02282I aea mode DAT-Off</wrap> <wrap>HHC02282I aea ar 0D 07 01 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20</wrap> <wrap>HHC02282I aea common 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0</wrap> <wrap>HHC02282I aea cr[1] 0000000000000000</wrap> <wrap>HHC02282I cr[7] 0000000000000000</wrap> <wrap>HHC02282I cr[13] 0000000000000000</wrap> <wrap>HHC02282I cr[r] 00000000FFFFFFFF</wrap> <wrap>HHC02282I alb[0] 0000000000000000</wrap> <wrap>HHC02282I alb[1] 0000000000000000</wrap> <wrap>HHC02282I alb[2] 0000000000000000</wrap> <wrap>HHC02282I alb[3] 0000000000000000</wrap> <wrap>HHC02282I alb[4] 0000000000000000</wrap> <wrap>HHC02282I alb[5] 0000000000000000</wrap> <wrap>HHC02282I alb[6] 0000000000000000</wrap> <wrap>HHC02282I alb[7] 0000000000000000</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 275</wrap> <wrap>\\ </wrap><wrap>HHC02282I alb[8] 0000000000000000</wrap> <wrap>HHC02282I alb[9] 0000000000000000</wrap> <wrap>HHC02282I alb[10] 0000000000000000</wrap> <wrap>HHC02282I alb[11] 0000000000000000</wrap> <wrap>HHC02282I alb[12] 0000000000000000</wrap> <wrap>HHC02282I alb[13] 0000000000000000</wrap> <wrap>HHC02282I alb[14] 0000000000000000</wrap> <wrap>HHC02282I alb[15] 0000000000000000</wrap> **<wrap>Figure 22: AEA command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 276</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.11 AIA (List AIA absolute-instruction-address fields) //8.11.1 Function//</wrap>** <wrap>Display the Hercules AIA fields. The AIA fields are instruction fetch accelerators which save absolute instruction addresses for further lookups to shorten the translation path length.</wrap> **//<wrap>8.11.2 Syntax</wrap>//** **__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>****<wrap>AIA</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ A</wrap>****<wrap>I</wrap>****<wrap>A</wrap>** **//<wrap>8.11.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.11.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the AIA fields.</wrap> |<WRAP><wrap>HHC00013I Herc command: 'aia'</wrap> <wrap>HHC02283I AIV 000000000002f800 aip 0000000003AB0800 ip 0000000003AB0AAA aie 0000000000000000</wrap> <wrap>aim 0000000003A9F000</wrap> </WRAP> | **<wrap>Figure 23: AIA command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 277</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.12 AR (Display access registers) \\ //8.12.1 Function//</wrap>** <wrap>Display the current contents of the access registers.</wrap> **//<wrap>8.12.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>AR</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ AR</wrap>** **//<wrap>8.12.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.12.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the access registers.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'ar'</wrap> |<WRAP><wrap>HHC02272I</wrap> </WRAP> |<WRAP><wrap>Access</wrap> </WRAP> |<WRAP><wrap>registers</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02272I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>AR00=00000000</wrap> </WRAP> |<WRAP><wrap>AR01=00000000</wrap> </WRAP> |<WRAP><wrap>AR02=0000062A</wrap> </WRAP> |<WRAP><wrap>AR03=87465380</wrap> </WRAP> | |<WRAP><wrap>HHC02272I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>AR04=87461860</wrap> </WRAP> |<WRAP><wrap>AR05=07F51080</wrap> </WRAP> |<WRAP><wrap>AR06=87465190</wrap> </WRAP> |<WRAP><wrap>AR07=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02272I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>AR08=8746531C</wrap> </WRAP> |<WRAP><wrap>AR09=070D0060</wrap> </WRAP> |<WRAP><wrap>AR10=00000000</wrap> </WRAP> |<WRAP><wrap>AR11=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02272I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>AR12=00000000</wrap> </WRAP> |<WRAP><wrap>AR13=00000000</wrap> </WRAP> |<WRAP><wrap>AR14=00000000</wrap> </WRAP> |<WRAP><wrap>AR15=00000000</wrap> </WRAP> | **<wrap>Figure 24: AR command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 278</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.13 ARCHLVL (Set architecture level) \\ //8.13.1 Function//</wrap>** <wrap>The ARCHLVL console command is used to display or set the architecture mode. Given without any parameters the ARCHLVL command displays the current setting of the architecture mode.</wrap> <wrap>Additional parameters may be specified to set a new value for the architecture mode, to enable or disable specific facilities, to override the STFLE (Store Facility List Extended) response and force it to return a certain (incorrect) bit pattern or to display the status (enabled or disabled) of facilities. An overview of all architecture facilities can be found in “Appendix C. Architecture Facilities” on page 643.</wrap> **//<wrap>8.13.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>ARCHLVL [S/370 | ESA/390 | ESAME | z/ARCH]</wrap> <wrap>or</wrap> <wrap>ARCHLVL (ENABLE | DISABLE} </wrap>//<wrap>facility </wrap>//<wrap>[S/370 | ESA/390 | ESAME | z/ARCH]</wrap> <wrap>or</wrap> <wrap>ARCHLVL QUERY [</wrap>//<wrap>facility </wrap>//<wrap>| __ALL__]</wrap> <wrap>or</wrap> <wrap>ARCHLVL (ENABLE | DISABLE} </wrap>//<wrap>bitno </wrap>//<wrap>[S/370 | ESA/390 | ESAME | z/ARCH]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ ARCHLVL ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ F%%__%%_ S/370%%__%%%%__%%_« F%%__%%_ ESA/390%%__%%_« f%%__%%_ ESAME%%__%%%%__%%_« L%%__%%_ z/ARCH%%__%%%%__%%¯</wrap> <wrap>or</wrap> <wrap>ÊÊ¬¬¬ ARCHLVL ¬¬¬§¬¬¬ ENABLE ¬¬¬¬§¬¬¬ </wrap>//<wrap>facility </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>%%__%%_ DISABLE %%__%%_ 1%%__%%_ S/370%%__%%%%__%%_« F%%__%%_ ESA/390%%__%%_« F%%__%%_ ESAME ¬¬¬¬¬« I%%__%%_ z/ARCH%%__%%%%__%%¯</wrap> <wrap>or</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 279</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap> |<WRAP><wrap>ÊÊ ARCHLVL </wrap><wrap>QUERY</wrap> </WRAP> |<WRAP><wrap>~ ALL ®</wrap> <wrap>¦ ¦ ÊÍ \\ </wrap><wrap>⡿¬¬¬</wrap>//<wrap>facility </wrap>//<wrap>¬¬¬¯</wrap> </WRAP> | <wrap>or</wrap> <wrap>ÊÊ ARCHLVL § </wrap><wrap>ENABLE </wrap><wrap>§ //bitno //§ § ÊÍ</wrap> <wrap>⡿¬¬¬ DISABLE ¬¬¬ ª¬¬¬ S/370 ¬¬¬¬¬« \\ ª¬¬¬ ESA/390 ¬¬¬« ª¬¬¬ ESAME ¬¬¬¬¬« ⡿¬¬¬z/ARCH¬¬¬¬¯</wrap> **//<wrap>8.13.3 Parameter</wrap>//** **<wrap>S/370 </wrap>**<wrap>Use S/370 for OS/360, VM/370 and MVS 3.8.</wrap> **<wrap>ESA/390 </wrap>**<wrap>Use ESA/390 for MVS/XA, MVS/ESA, OS/390, VM/ESA, VSE/ESA, Linux/390 and ZZSA. zOS can be run until version 1.2 with ESA/390 mode without installed bimodal feature or until version 1.4 if the bimodal feature is installed.</wrap> **<wrap>ESAME </wrap>**<wrap>Use ESAME (Enterprise System Architecture, Modal Extensions) for z/OS, z/VM, z/VSE and z/Linux. The ESAME mode is equivalent to z/Archtecture mode at at Architecture Level 2.</wrap> <wrap>When ESAME is specified, the machine will always be IPL’ed in ESA/390 mode but the system is capable of being switched into the z/Architecture mode after IPL. This is handled automatically by all z/Architecture operating systems.</wrap> **<wrap>z/ARCH </wrap>**<wrap>Use z/ARCH for z/OS, z/VM, z/VSE and z/Linux. z/ARCH is similar to ESAME. The z/Arch mode is equivalent to z/Architecture mode at Architecture Level 3.</wrap> **<wrap>ENABLE </wrap>**<wrap>Enable the specified facility. If no architecture mode is given as additional parameter the facility is enabled for all architecture modes.</wrap> **<wrap>DISABLE </wrap>**<wrap>Disable the specified facility. If no architecture mode is given as additional parameter the facility is disabled for all architecture modes.</wrap> **//<wrap>facility </wrap>//**<wrap>The name of the facility that has to be enabled, disabled or displayed. An overview of all architecture facilities can be found in “Appendix C. Architecture Facilities” on page 643.</wrap> **//<wrap>bitno </wrap>//**<wrap>The bit number of the facility that has to be enabled or disabled. The format of //bitno //is BIT//nn//, e.g. “BIT44” (Bit 44 = PFPO Facility Bit). An overview of all architecture facilities can be found in “Appendix C. Architecture Facilities” on page 643.</wrap> **<wrap>QUERY </wrap>**<wrap>Display the facility settings.</wrap> **<wrap>ALL </wrap>**<wrap>Specifies that all facilities have to be displayed.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 280</wrap> <wrap>\\ </wrap>**//<wrap>8.13.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current setting of the architecture mode.</wrap> <wrap>HHC00013I Herc command: 'archlvl' \\ HHC02203I Value 'archmode': 'S/370'</wrap> **<wrap>Figure 25: ARCHLVL command (display architecture mode)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the architecture level to z/ARCH.</wrap> <wrap>HHC00013I Herc command: 'archlvl z/arch'</wrap> **<wrap>Figure 26: ARCHLVL command (set new architecture mode)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Disable the ‘DECIMAL_FLOAT’ facility in z/Architecture mode.</wrap> <wrap><wrap>{{hercules:userref:bf:image062.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image062.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap>HHC00013I Herc command: 'archlvl disable decimal_float z/arch' HHC00898I Facility(DECIMAL_FLOAT) disabled for archmode z/Arch</wrap> **<wrap>Figure 27: ARCHLVL command (enable facility)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Force the enabling of the PFPO feature (bit number 44) for all architecture modes.</wrap> <wrap>HHC00013I Herc command: 'archlvl enable bit44' \\ HHC00898I Facility(44) enabled for archmode S/370 \\ HHC00898I Facility(44) enabled for archmode ESA/390 \\ HHC00898I Facility(44) enabled for archmode z/Arch</wrap> **<wrap>Figure 28: ARCHLVL command (force on facility)</wrap>** **<wrap>Example 5:</wrap>** <wrap>Query all facilities.</wrap> <wrap>HHC00013I Herc command: 'archlvl query all'</wrap> <wrap>HHC00890I Facility(N3 ) Enabled</wrap> <wrap>HHC00890I Facility(ESAME_INSTALLED ) Enabled</wrap> <wrap>HHC00890I Facility(ESAME_ACTIVE ) Enabled</wrap> <wrap>HHC00890I Facility(IDTE_INSTALLED ) Enabled</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 281</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap> |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(IDTE_SC_SEGTAB</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(IDTE_SC_REGTAB</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(ASN_LX_REUSE</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(STFL_EXTENDED</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(ENHANCED_DAT</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(SENSE_RUN_STATUS</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(CONDITIONAL_SSKE</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(CONFIG_TOPOLOGY</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(IPTE_RANGE</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(NONQ_KEY_SET</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(TRAN_FAC2</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(MSG_SECURITY</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(LONG_DISPL_INST</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(LONG_DISPL_HPERF</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(HFP_MULT_ADD_SUB</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | <wrap>.</wrap> |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(ETF3_ENHANCEMENT</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(EXTRACT_CPU_TIME</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(CSSF</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(CSSF2</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(GEN_INST_EXTN</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(EXECUTE_EXTN</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(ENH_MONITOR</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(RESERVED_39</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(SET_PROG_PARAM</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(FPS_ENHANCEMENT</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(DECIMAL_FLOAT</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(DFP_HPERF</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(PFPO</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(FAST_BCR_SERIAL</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(CMPSC_ENH</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(RES_REF_BITS_MUL</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(CPU_MEAS_COUNTER</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(CPU_MEAS_SAMPLNG</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(MSA_EXTENSION_3</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(MSA_EXTENSION_4</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Disabled</wrap> </WRAP> | |<WRAP><wrap>HHC00890I</wrap> </WRAP> |<WRAP><wrap>Facility(MOVE_INVERSE</wrap> </WRAP> |<WRAP><wrap>)</wrap> </WRAP> |<WRAP><wrap>Enabled</wrap> </WRAP> | **<wrap>Figure 29: ARCHLVL command (query all)</wrap>** **<wrap>Example 6:</wrap>** <wrap>Query the ‘MOVE_INVERSE’ facility.</wrap> <wrap>HHC00013I Herc command: 'archlvl query move_inverse'</wrap> <wrap>HHC00890I Facility(MOVE_INVERSE ) Enabled</wrap> **<wrap>Figure 30: ARCHLVL command (query facility)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 282</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.14 ARCHMODE (Set architecture mode) \\ //8.14.1 Function//</wrap>** <wrap>The ARCHMODE command has been deprecated. This command was used to specify the initial architecture mode.</wrap> <wrap>ARCHMODE is still accepted and is treated as an alias for the ARCHLVL console command. However in the future the ARCHLVL command should be used instead. Please see ARCHLVL for details.</wrap> **//<wrap>8.14.2 Syntax</wrap>//** <wrap>See ARCHLVL console command.</wrap> **//<wrap>8.14.3 Parameter</wrap>//** <wrap>See ARCHLVL console command.</wrap> **//<wrap>8.14.4 Examples</wrap>//** <wrap>See ARCHLVL console command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 283</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.15 ATTACH (Configure device) \\ //8.15.1 Function//</wrap>** <wrap>The ATTACH command configures a new device and makes it available in the active configuration. The effect of this command is immediately visible in the device display of the Hercules Windows GUI or the Hercules “Peripherals” display if the GUI is not used.</wrap> **//<wrap>8.15.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>ATTACH </wrap>//<wrap>devn </wrap>////<wrap>type </wrap>//<wrap>[</wrap>//<wrap>argument </wrap>//<wrap>[</wrap>//<wrap>argument </wrap>//<wrap>...11</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ ATTACH ¬¬¬ </wrap>//<wrap>devn </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap> ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® \\ ⡿¬¬¬°¬¬¬</wrap>//<wrap>argument </wrap>//<wrap>¬¬¬¨¬¬¬¯</wrap> **//<wrap>8.15.3 Parameter</wrap>//** **//<wrap>devn </wrap>//**<wrap>The device number of the device that is to be configured in the current configuration.</wrap> **//<wrap>type </wrap>//**<wrap>The device type that is to be configured in the current configuration. For valid device types see chapter 6 (Device Definition Descriptions).</wrap> **//<wrap>argument </wrap>//**<wrap>These are the additional arguments for the device that is to be configured in the current configuration. The arguments are dependent on the device type. For additional information on valid arguments see chapter 6 (Device Definition Descriptions).</wrap> **//<wrap>8.15.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Attach a printer device to the active configuration.</wrap> <wrap>HHC00013I Herc command: 'attach 000f 1403 </wrap>[[file:///d:/mvs/prt/prt2.txt|<wrap>d:/mvs/prt/prt2.txt</wrap>]]<wrap> crlf' \\ HHC02198I Device attached</wrap> **<wrap>Figure 31: ATTACH command (configure printer)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 284</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Attach a display terminal to the active configuration.</wrap> <wrap>HHC00013I Herc command ‘attach 0700 3270’ \\ HHC02198I Device attached</wrap> **<wrap>Figure 32: ATTACH command (configure display terminal)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 285</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.16 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts) //8.16.1 Function//</wrap>** <wrap>The AUTO_SCSI_MOUNT panel command has been deprecated and is replaced by SCSIMOUNT. See SCSIMOUNT panel command for details.</wrap> **//<wrap>8.16.2 Syntax</wrap>//** <wrap>See SCSIMOUNT panel command.</wrap> **//<wrap>8.16.3 Parameter</wrap>//** <wrap>See SCSIMOUNT panel command.</wrap> **//<wrap>8.16.4 Examples</wrap>//** <wrap>See SCSIMOUNT panel command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 286</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.17 AUTOINIT (Display or set the automatic creation of empty tape files)</wrap>** **//<wrap>8.17.1 Function</wrap>//** <wrap>The AUTOINIT console command controls the automatic creation of empty tape files. AUTOINIT handles the "file not found" condition for a specified tape file. It controls if DEVINIT returns a "file not found" error or creates an empty tape file if the tape file could not be found. Given without an argument AUTOINIT displays the current setting.</wrap> **//<wrap>8.17.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>AUTOINIT [ON | OFF]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬AUTOINIT¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ON¬¬¬¬«</wrap> <wrap>⡿¬¬¬OFF¬¬¬¯</wrap> **//<wrap>8.17.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>When AUTOINIT is set ON, DEVINIT will initialize a blank, non-labeled tape if the specified tape file is not found. Next, DEVINIT writes two tapemarks, rewinds the tape and positions the tape to the beginning.</wrap> **<wrap>OFF </wrap>**<wrap>When AUTOINIT is set OFF (which is the default), DEVINIT will return a "file not found" error if the specified tape file is not found.</wrap> **//<wrap>8.17.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current AUTOINIT setting.</wrap> <wrap>HHC00013I Herc command: 'autoinit' \\ HHC02203I Value 'autoinit': 'off'</wrap> **<wrap>Figure 33: AUTOINIT command (display current setting)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 287</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the automatic creation of empty tape files to ‘ON’.</wrap> <wrap>23:05:25.148 00000ABC HHC00013I Herc command: 'autoinit on' \\ 23:05:25.148 00000ABC HHC02204I Value 'autoinit' set to 'on'</wrap> **<wrap>Figure 34: AUTOINIT command (change setting)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 288</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.18 AUTOMOUNT (Display or update allowable tape automount directories)</wrap>** **//<wrap>8.18.1 Function</wrap>//** <wrap>The AUTOMOUNT command allows it to add or delete entries from the list of allowable/unallowable tape automount directories, or lists all currently defined list entries, if any.</wrap> <wrap>The format of the //directory //operand for add/del operations is identical to that as described in the documentation for the AUTOMOUNT system parameter (i.e. prefix with '+' or '-' as needed).</wrap> <wrap>The automount feature is appropriately enabled or disabled for all tape devices as needed depending on the updated empty/non-empty list state.</wrap> **//<wrap>8.18.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>AUT0M0UNT (ADD </wrap>//<wrap>directory </wrap>//<wrap>| DEL </wrap>//<wrap>directory </wrap>//<wrap>| LIST}</wrap> <wrap>or</wrap> <wrap>AUT0M0UNT </wrap><wrap>[ + </wrap><wrap>|</wrap><wrap>- ]</wrap>//<wrap>directory</wrap>// |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_AUT0M0UNT</wrap> </WRAP> |<WRAP><wrap>~¬¬¬ + ¬¬¬®</wrap> <wrap>%%__%%_</wrap><wrap>¦¬¬¬¬¬¬¬¬¬¦¬¬¬</wrap> <wrap>⡿%%__%%_</wrap><wrap>- </wrap><wrap>%%__%%_¯</wrap> </WRAP> |<WRAP>//<wrap>directory</wrap>// </WRAP> | <wrap>or</wrap> <wrap>ÊÊ%%__%%_AUT0M0UNT %%__%%_§%%__%%_ ADD </wrap>//<wrap>directory </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>L%%__%%_ DEL </wrap>//<wrap>directory </wrap>//<wrap>%%__%%_¯</wrap> **//<wrap>8.18.3 Parameter</wrap>//** **<wrap>ADD or + </wrap>**<wrap>Add an entry to the list of allowable tape automount directories.</wrap> **<wrap>DEL or - </wrap>**<wrap>Delete an entry from the list of allowable tape automount directories.</wrap> **<wrap>LIST </wrap>**<wrap>List all currently defined list entries of allowable tape automount directories.</wrap> **//<wrap>directory </wrap>//**<wrap>Specifies the host system directory where the guest is allowed or not to automatically load virtual tape volumes from.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 289</wrap> <wrap>\\ </wrap>**//<wrap>8.18.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Add entries to the list of allowable tape automount directories.</wrap> <wrap>HHC00013I Herc command: 'automount add </wrap>[[file:///D:/MVS/Tape|<wrap>D:/MVS/Tape</wrap>]]<wrap>' \\ HHC02203I default allowed automount directory: '</wrap>[[file:///D:/MVS/Tape/|<wrap>D:/MVS/Tape/</wrap>]]<wrap>' \\ HHC00013I Herc command: 'automount add </wrap>[[file:///D:/MVS/Cart|<wrap>D:/MVS/Cart</wrap>]]<wrap>' \\ HHC02203I allowed automount directory: '</wrap>[[file:///D:/MVS/Cart/|<wrap>D:/MVS/Cart/</wrap>]]<wrap>'</wrap> **<wrap>Figure 35: AUTOMOUNT command (add entries)</wrap>** **<wrap>Example 2:</wrap>** <wrap>List all currently defined list entries of allowable tape automount directories.</wrap> <wrap>HHC00013I Herc command: 'automount list'</wrap> <wrap>HHC02217I '+D:/MVS/Tape/'</wrap> <wrap>HHC02217I '+D:/MVS/Cart/'</wrap> **<wrap>Figure 36: AUTOMOUNT command (list entries)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Delete an entry from the list of allowable tape automount directories.</wrap> <wrap>HHC00013I Herc command: 'automount del </wrap>[[file:///D:/MVS/Cart|<wrap>D:/MVS/Cart</wrap>]]<wrap>' \\ HHC02220I Entry deleted</wrap> **<wrap>Figure 37: AUTOMOUNT command (delete entry)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 290</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.19 B (Set breakpoint) \\ //8.19.1 Function//</wrap>** <wrap>The B (or B+) command sets a breakpoint. The argument gives an instruction address or a range of addresses where you wish to halt the execution. Once the breakpoint is reached, instruction execution is temporarily halted and the next instruction to be executed is displayed. You may then examine registers and / or storage etc. To continue execution after reaching a breakpoint, enter the “G” command.</wrap> <wrap>The “B” command is synonymous with the “S+” command.</wrap> **//<wrap>8.19.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>B {//addr //| //addr-addr//}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_B %%__%%_§%%__%%%%__%%//¬¬ addr //</wrap>//__<wrap>¬ </wrap>__////<wrap></wrap>// <wrap>L%%__%%_ //addr-addr//</wrap> </WRAP> | **//<wrap>8.19.3 Parameter</wrap>//** **//<wrap>addr </wrap>//**<wrap>Instruction address where instruction execution is to be stopped.</wrap> **//<wrap>addr-addr </wrap>//**<wrap>Range of instruction addresses where instruction execution is to be stopped.</wrap> **//<wrap>8.19.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set a breakpoint at instruction address 01000000.</wrap> <wrap>HHC00013I Herc command: 'b+ 01000000'</wrap> <wrap>HHC02229I Instruction break on range 1000000-1000000</wrap> **<wrap>Figure 38: B command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 291</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.20 B+ (Set breakpoint) \\ //8.20.1 Function//</wrap>** <wrap>The B+ (or B) command sets a breakpoint. The argument gives an instruction address or a range of addresses where you wish to halt the execution. Once the breakpoint is reached, instruction execution is temporarily halted and the next instruction to be executed is displayed. You may then examine registers and / or storage etc. To continue execution after reaching a breakpoint, enter the “G” command.</wrap> <wrap>The “B+” command is synonymous with the “S+” command.</wrap> **//<wrap>8.20.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>B+ {//addr //| //addr-addr//}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_B+ %%__%%_§%%__%%%%__%%%%__%% //addr //</wrap>//__<wrap>¬¬</wrap>__////<wrap></wrap>// <wrap>L%%__%%_ //addr-addr//</wrap> **//<wrap>8.20.3 Parameter</wrap>//** **//<wrap>addr </wrap>//**<wrap>Instruction address where instruction execution is to be stopped.</wrap> **//<wrap>addr-addr </wrap>//**<wrap>Range of instruction addresses where instruction execution is to be stopped.</wrap> **//<wrap>8.20.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set a breakpoint at instruction address 01000000.</wrap> <wrap>HHC00013I Herc command: 'b+ 01000000'</wrap> <wrap>HHC02229I Instruction break on range 1000000-1000000</wrap> **<wrap>Figure 39: B+ command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 292</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.21 B- (Delete breakpoint) \\ //8.21.1 Function//</wrap>** <wrap>The B- command removes any previously set breakpoint.</wrap> **//<wrap>8.21.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>**<wrap>B</wrap><wrap>-</wrap><wrap></wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ B</wrap> **//<wrap>8.21.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.21.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Delete the previously set breakpoint.</wrap> <wrap>HHC00013I Herc command: 'b-'</wrap> <wrap>HHC02229I Instruction break off range 1000000-1000000</wrap> **<wrap>Figure 40: B- command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 293</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.22 CACHE (Execute cache related commands) \\ //8.22.1 Function//</wrap>** <wrap>The CACHE command is used to execute various cache related commands. It allows to switch on or off the caching for the DASD system and to display the status of the system DASD caching. Given without an argument the CACHE command displays the cache statistics (see also CACHESTATS command).</wrap> **//<wrap>8.22.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CACHE [DASD SYSTEM [ON | OFF]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ </wrap><wrap>CACHE </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿¬¬¬DASD SYSTEM </wrap><wrap>¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª¬¬¬ON </wrap><wrap>¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap><wrap>OFF </wrap><wrap>¬¬¬¯</wrap> **//<wrap>8.22.3 Parameter</wrap>//** **<wrap>DASD SYSTEM </wrap>**<wrap>Displays the status of the DASD system caching if given without an additional argument, otherwise enables or disables the caching for all DASD devices.</wrap> **<wrap>ON </wrap>**<wrap>Enables the caching for all DASD devices.</wrap> **<wrap>OFF </wrap>**<wrap>Disables the caching for all DASD devices.</wrap> **//<wrap>8.22.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the status of the DASD system caching.</wrap> <wrap>HHC00013I Herc command: 'cache dasd system' \\ HHC02203I dasd system cache: on</wrap> **<wrap>Figure 41: CACHE command (display status of DASD system caching)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 294</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Disable caching for all DASD devices.</wrap> <wrap>HHC00013I Herc command: 'cache dasd system off' \\ HHC02204I dasd system cache set to off</wrap> **<wrap>Figure 42: CACHE command (disable caching for DASD devices)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Display the current cache statistics.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'cache'</wrap> <wrap>HHC02294I Cache .................. 0</wrap> <wrap>HHC02294I nbr ................. 229</wrap> <wrap>HHC02294I busy .................. 0</wrap> <wrap>HHC02294I busy% ................. 0</wrap> <wrap>HHC02294I empty ................. 0</wrap> <wrap>HHC02294I waiters ............... 0</wrap> <wrap>HHC02294I waits ................. 0</wrap> <wrap>HHC02294I buf size ......... 2799616</wrap> <wrap>HHC02294I hits ............... 1415</wrap> <wrap>HHC02294I fast hits ........... 1115</wrap> <wrap>HHC02294I misses ............. 56004</wrap> <wrap>HHC02294I hit% .................. 2</wrap> <wrap>HHC02294I age ............... 29617</wrap> <wrap>HHC02294I last adjusted .... none</wrap> <wrap>HHC02294I last wait ....... none</wrap> <wrap>HHC02294I adjustments ............ 0</wrap> <wrap>HHC02294I Cache .................. 1</wrap> <wrap>HHC02294I nbr ................ 1031</wrap> <wrap>HHC02294I busy ................. 34</wrap> <wrap>HHC02294I busy% ................. 3</wrap> <wrap>HHC02294I empty ............... 776</wrap> <wrap>HHC02294I waiters ............... 0</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC02294I hit% ................. 97</wrap> <wrap>HHC02294I age ............... 13261</wrap> <wrap>HHC02294I last adjusted .... none</wrap> <wrap>HHC02294I last wait ....... none</wrap> <wrap>HHC02294I adjustments ............ 0</wrap> <wrap>HHC02294I Cache[2] ..... not created</wrap> <wrap>HHC02294I Cache[3] ..... not created</wrap> <wrap>HHC02294I Cache[4] ..... not created</wrap> <wrap>HHC02294I Cache[5] ..... not created</wrap> <wrap>HHC02294I Cache[6] ..... not created</wrap> <wrap>HHC02294I Cache[7] ..... not created</wrap> **<wrap>Figure 43: CACHE command (display cache statistics)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 295</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.23 CACHESTATS (Display cache statistics) \\ //8.23.1 Function//</wrap>** <wrap>The CACHESTATS command displays the current Hercules cache statistics.</wrap> **//<wrap>8.23.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>CACHESTATS</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>CACHESTATS</wrap> **//<wrap>8.23.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.23.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current cache statistics.</wrap> <wrap>HHC00013I Herc command: 'cachestats'</wrap> <wrap>HHC02294I Cache ................... 0</wrap> <wrap>HHC02294I nbr .................. 229</wrap> <wrap>HHC02294I busy ................... 0</wrap> <wrap>HHC02294I busy% .................. 0</wrap> <wrap>HHC02294I empty .................. 0</wrap> <wrap>HHC02294I waiters ................ 0</wrap> <wrap>HHC02294I waits ................. 39</wrap> <wrap>HHC02294I buf size .......... 2987008</wrap> <wrap>HHC02294I hits ................ 2014</wrap> <wrap>HHC02294I fast hits ............ 1039</wrap> <wrap>HHC02294I misses ............... 4056</wrap> <wrap>HHC02294I hit% .................. 33</wrap> <wrap>HHC02294I age ................. 4569</wrap> <wrap>HHC02294I last adjusted .... none</wrap> <wrap>HHC02294I last wait ........ none</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 296</wrap> <wrap>\\ </wrap><wrap>HHC02294I adjustments ............. 0</wrap> <wrap>HHC02294I Cache ................... 1</wrap> <wrap>HHC02294I nbr ................. 1031</wrap> <wrap>HHC02294I busy .................. 34</wrap> <wrap>HHC02294I busy% .................. 3</wrap> <wrap>HHC02294I empty ................ 887</wrap> <wrap>HHC02294I waiters ................ 0</wrap> <wrap>HHC02294I waits .................. 0</wrap> <wrap>HHC02294I buf size ........... 294912</wrap> <wrap>HHC02294I hits ................ 2706</wrap> <wrap>HHC02294I fast hits ............ 2436</wrap> <wrap>HHC02294I misses ................ 145</wrap> <wrap>HHC02294I hit% .................. 94</wrap> <wrap>HHC02294I age ................. 2851</wrap> <wrap>HHC02294I last adjusted .... none</wrap> <wrap>HHC02294I last wait ........ none</wrap> <wrap>HHC02294I adjustments ............. 0</wrap> <wrap>HHC02294I Cache[2] ...... not created</wrap> <wrap>HHC02294I Cache[3] ...... not created</wrap> <wrap>HHC02294I Cache[4] ...... not created</wrap> <wrap>HHC02294I Cache[5] ...... not created</wrap> <wrap>HHC02294I Cache[6] ...... not created</wrap> <wrap>HHC02294I Cache[7] ...... not created</wrap> **<wrap>Figure 44: CACHESTATS command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 297</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.24 CAPPING (Display or set CPU capping value) \\ //8.24.1 Function//</wrap>** <wrap>The CAPPING command displays or sets the CPU capping value. If //mips //is greater than zero then the CPUs are capped to this value. If //mips //is equal to zero or “OFF” then the capping is disabled.</wrap> <wrap>Only CPUs of type CP are capped. CPUs of type IL, AP or IP are never capped. The CPU string on the Hercules device and status panel which shows the CPU usage turns from white to red during the time the CPU is capped.</wrap> **//<wrap>8.24.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CAPPING </wrap>//<wrap>[mips </wrap>//<wrap>| OFF | 0</wrap>//<wrap>]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬CAPPING ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>I</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>// <wrap>ª</wrap>//<wrap>¬¬¬ mips ¬¬¬«</wrap>// <wrap>ª¬¬¬</wrap>//<wrap>OFF ¬¬¬¬«</wrap>// <wrap>⡿¬¬¬¬0 </wrap>//<wrap>¬¬¬</wrap>//<wrap>¬¬¯</wrap> **//<wrap>8.24.3 Parameter</wrap>//** **//<wrap>mips </wrap>//**<wrap>Maximum total number of MIPS for all the ‘CP’ type processors.</wrap> **<wrap>OFF </wrap>**<wrap>Disables the CPU capping.</wrap> **<wrap>0 </wrap>**<wrap>This is the same as OFF.</wrap> **//<wrap>8.24.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current CPU capping value (capping set).</wrap> <wrap>HHC00013I Herc command: 'capping'</wrap> <wrap>HHC00832I Central processors will be capped at 10 MIPS</wrap> **<wrap>Figure 45: CAPPING command (display current CPU capping value, capping set)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 298</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the CPU capping value to 25 MIPS.</wrap> <wrap>HHC00013I Herc command: 'capping 25'</wrap> <wrap>HHC00877I Central processors are capped at 25 MIPS</wrap> **<wrap>Figure 46: CAPPING command (set CPU capping value)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Disable the CPU capping.</wrap> <wrap>HHC00013I Herc command: 'capping off'</wrap> **<wrap>Figure 47: CAPPING command (disable capping)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Display the current CPU capping value (capping not set).</wrap> <wrap>HHC00013I Herc command: 'capping' \\ HHC00838I Capping is not enabled</wrap> **<wrap>Figure 48</wrap>**<wrap>: **CAPPING command (display current CPU capping value, capping not set)**</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 299</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.25 CCKD (CCKD command) \\ //8.25.1 Function//</wrap>** <wrap>The CCKD console command can be used to affect CCKD processing. The CCKD console command supports the same options as the CCKD system parameter.</wrap> **//<wrap>8.25.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CCKD [HELP | STATS | OPTS | </wrap>//<wrap>option=value </wrap>//<wrap>[,</wrap>//<wrap>option=value </wrap>//<wrap>... ]]</wrap> <wrap>where option can be:</wrap> <wrap>[COMP={-1 | </wrap>//<wrap>n</wrap>//<wrap>}]</wrap> <wrap>[,COMPPARM={-1 | </wrap>//<wrap>n</wrap>//<wrap>}]</wrap> <wrap>[,RA={2 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,RAQ={4 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,RAT={2 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,WR={2 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,GCINT={5 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,GCPARM={0 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,NOSTRESS={0 | 1}]</wrap> <wrap>[,FREEPEND={</wrap>__<wrap>-1</wrap>__<wrap> | </wrap>//<wrap>n</wrap>//<wrap>}]</wrap> <wrap>[,FSYNC={0 | 1}] \\ [,TRACE={0 | </wrap>//<wrap>n</wrap>//<wrap>}] \\ [,LINUXNULL={0 | 1}]</wrap> <wrap>[,GCSTART={0 | 1}]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬®</wrap> <wrap>ÊÊ¬¬¬CCKD ¬¬¬§¬¬¬°¬¬« </wrap>//<wrap>option=value </wrap>//<wrap>ª¬¬¨¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬¬¬¬¬¬¬¬¬HELP¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª¬¬¬¬¬¬¬¬¬¬¬STATS¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬¬¬¬¬¬¬¬¬OPTS¬¬¬¬¬¬¬¬¬¬¬¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 300</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>where option can be:</wrap> <wrap>I</wrap><wrap>¬¬¬ COMP= ¬¬¬§¬¬¬ </wrap><wrap>-1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬</wrap><wrap>¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> |<WRAP><wrap>I¬¬¬ COMPPARM=</wrap> </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬</wrap><wrap>-1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬</wrap><wrap>¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> </WRAP> | <wrap>I</wrap><wrap>¬¬¬ RA= ¬¬¬§¬¬¬ 2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> <wrap>ª</wrap><wrap>¬¬¬RAD= ¬¬¬§¬¬¬ 4 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> <wrap>ª¬¬¬</wrap><wrap>RAT= ¬¬¬§¬¬¬ 2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> <wrap>ª</wrap><wrap>¬¬¬WR= ¬¬¬§¬¬¬ 2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> |<WRAP><wrap>I¬¬¬ GCINT=</wrap> </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬ 5 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬¯</wrap> </WRAP> | <wrap>I</wrap><wrap>¬¬¬ GCPARM= ¬¬¬§¬¬¬ 0 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> <wrap>I</wrap><wrap>¬¬¬ NOSTRESS= ¬¬¬§¬¬¬ 0¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ 1 ¬¬¬</wrap> <wrap>I¬¬¬ FREEPEND= ¬¬¬§¬¬¬ </wrap><wrap>-1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> <wrap>I</wrap><wrap>¬¬¬ FSYNC= ¬¬¬§¬¬¬ 0¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ 1 ¬¬¬</wrap> <wrap>I</wrap><wrap>¬¬¬ TRACE= ¬¬¬§¬¬¬ 0 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ </wrap>//<wrap>n </wrap>//<wrap>¬¬¬</wrap> <wrap>ª¬¬¬</wrap> <wrap>LINUXNULL= ¬¬¬§¬¬¬ 0 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ 1 ¬¬¬</wrap> <wrap>ª</wrap><wrap>¬¬¬GCSTART= ¬¬¬§¬¬¬ 0 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬ 1 ¬¬¬</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 301</wrap> <wrap>\\ </wrap>**//<wrap>8.25.3 Parameter</wrap>//** **<wrap>HELP </wrap>**<wrap>Display the CCKD help information.</wrap> **<wrap>STATS </wrap>**<wrap>Display the current CCKD statistics.</wrap> **<wrap>OPTS </wrap>**<wrap>Display the current CCKD options.</wrap> **//<wrap>option </wrap>//**<wrap>Set a CCKD option. Multiple options may be specified, separated by commas with no intervening blanks.</wrap> **<wrap>The CCKD options are:</wrap>** **<wrap>COMP=//n //</wrap>**<wrap>Specifies the compression type to be used. This overrides the compression used for all CCKD files. The default (-1) means don’t override the compression. Valid compression types are:</wrap> **<wrap>-1 </wrap>**<wrap>Default \\ **0 **None</wrap> **<wrap>1 </wrap>**<wrap>Zlib</wrap> **<wrap>2 </wrap>**<wrap>Bzip2</wrap> **<wrap>COMPPARM=//n //</wrap>**<wrap>Overrides the compression parameter. A higher value generally means more compression at the expense of CPU and/or storage. The default (-1) means don’t override the compression parameter. The value of //n //can be from -1 and 9.</wrap> **<wrap>RA=//n //</wrap>**<wrap>Sets the Number of read ahead threads. When sequential track or block group access is detected, some number (RAT=n) of tracks or block groups are queued (RAQ=n) to be read by one of the read ahead threads. The default is 2, the value of //n //can be a number from 1 to 9.</wrap> **<wrap>RAQ=//n //</wrap>**<wrap>Sets the size of the read ahead queue. When sequential track or block group access is detected, some number (RAT=n) of tracks or block groups are queued in the read ahead queue. The default is 4, the value of //n //can be a number from 0 to 16. A value of zero disables read ahead.</wrap> **<wrap>RAT=//n //</wrap>**<wrap>Sets the number of tracks or block groups to read ahead when sequential track or block group access is detected. The default is 2, the value of ratn can be a number from 0 to 16. A value of zero disables read ahead.</wrap> **<wrap>WR=//n //</wrap>**<wrap>Sets the number of writer threads. When the cache is flushed, updated cache entries are marked write pending and a writer thread is signalled. The writer thread compresses the track or block group and writes the compressed image to the emulation file.</wrap> <wrap>A writer thread is CPU-intensive while compressing the track or block group and I/O-intensive while writing the compressed image. The writer thread runs one nicer than the CPU thread(s). The default is 2, a value from 1 to 9 can be specified</wrap> **<wrap>GCINT=//n //</wrap>**<wrap>This is the number of seconds the garbage collector thread waits during an interval. At the end of an interval the garbage collector performs space recovery, flushes the cache and optionally ‘fsyncs’ the emulation file.</wrap> <wrap>However, the file will not be ‘fsynced’ unless at least 5 seconds have elapsed since the last synchronization (FSYNC). The default is 10 seconds. You can specify a</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 302</wrap> <wrap>\\ </wrap><wrap>number between 1 and 60.</wrap> **<wrap>GCPARM=//n //</wrap>**<wrap>A value affecting the amount of data moved during the garbage collectors space recovery routine. The garbage collector determines an amount of space to move based on the ratio of free space to used space in an emulation file and on the number of free spacesin the file. The garbage collector wants to reduce the free space to used space ratio and the number of free spaces.</wrap> <wrap>The value is logarithmic; a value of 8 means moving 28 the selected value while a negative value similarly decreases the amount to be moved. Normally, 256K will be moved for a file in an interval. Specifying a value of 8 can increase the amount to 64M. At least 64K will be moved. Specifying a large value (such as 8) may not increase the garbage collection efficiency correspondingly. The default is 0. You can specify a number from -8 to 8.</wrap> **<wrap>NOSTRESS=//n //</wrap>**<wrap>Indicates whether stress writes will occur or not. A track or block group may be written under stress when a high percentage of the cache is pending write or when a device I/O thread is waiting for a cache entry. When a stressed write occurs, the compression algorithm and/or compression parm may be relaxed, resulting in faster compression but usually a larger compressed image.</wrap> <wrap>If NOSTRESS is set to one, then a stressed situation is ignored. You would typically set this value to one when you want create the smallest emulation file possible in exchange for a possible performance degradation. The default is 0. You can specify 0 (enable stressed writes) or 1 (disable stressed writes).</wrap> **<wrap>FREEPEND=//n //</wrap>**<wrap>Specifies the free pending value for freed space. When a track or block group image is written, the space it previously occupied is freed. This space will not be available for future allocations until //n //garbage collection intervals have completed. In the event of a catastrophic failure, previously written track or block group images should be recoverable if the current image has not yet been written to the physical disk.</wrap> <wrap>By default the value is set to -1 which means that if FSYNC is specified then the value is 1 otherwise it is 2. If 0 is specified then freed space is immediately available for new allocations. The default is -1. You can specify a number from -1 to 4.</wrap> **<wrap>FSYNC=//n //</wrap>**<wrap>Enables or disables FSYNC. When FSYNC is enabled then the disk emulation file is synchronized with the physical hard disk at the end of a garbage collection interval (no more often than 5 seconds though).</wrap> <wrap>This means that if FREEPEND is non-zero and a catastrophic error occurs, the emulated disks should be recovered coherently. However, FSYNC may cause performance degradation depending on the host operating system and / or the host operating system level. The default is 0 (fsync disabled), you can specify 0 (disable FSYNC) or 1 (enable FSYNC).</wrap> **<wrap>TRACE=//n //</wrap>**<wrap>Specifies the number of CCKD trace entries. You would normally specify a nonzero value when debugging or capturing a problem in CCKD code. When the problem occurs, you should enter the "k" Hercules console command which will print the trace table entries. The default is 0. You can specify a number between 0 and 200000. Each trace entry represents 128 bytes. Normally, for debugging, it is recommended to use 100000.</wrap> **<wrap>LINUXNULL=//n //</wrap>**<wrap>If set to 1 then tracks written to 3390 CCKD volumes that were initialized with the //-linux //option will be checked if they are null (that is if all 12 4096 byte user records contain zeroes). This is used by the DASDCOPY utility. The default is 0.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 303</wrap> <wrap>\\ </wrap>**<wrap>GCSTART=//n //</wrap>**<wrap>If set to 1 then space recovery will become active on any emulated disks that have free space. Normally space recovery will ignore emulated disks until they have been updated. The default is 0.</wrap> **<wrap>Notes:</wrap>** <wrap>·<wrap></wrap></wrap>//<wrap>raq </wrap>//<wrap>should be at least as large as //ra//. Read ahead threads are scheduled from entries in the read ahead queue. Likewise //rat //should not exceed //raq //because only //raq //tracks or block groups can be queued at any time.</wrap> <wrap>·<wrap></wrap></wrap><wrap>The number of writer threads //wr //should usually be 1 more than the number of host processors. This is because one writer thread could be CPU-bound (compressing a track or block-group image) and the other could be i/o-bound (writing the compressed image).</wrap> <wrap>·<wrap></wrap></wrap><wrap>The garbage collection interval governs the maximum time in seconds an updated track or block group image will reside in storage before being written to the emulation file. A large value may mean more data loss if a catastrophic error occurs. A small value may mean that more CPU time is spent compressing images.</wrap> <wrap>For example, suppose that a particular image is updated several times each second. If the interval is changed from the default 5 seconds to 1 second, then that image will be compressed and written 5 times more frequently. A large value may cause more cache flushes within a garbage collection interval. These kinds of flushes mean that a read will wait because there are no available cache entries, slowing the emulated operating system. A large value will also cause more pending free space to build up (since free space is flushed each interval). This may mean that the garbage collector space recovery routine will perform more work and the resulting emulation file may be larger.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Specify //fsync=1 //and //gcint=5 //if you are seriously concerned about your data being lost due to a failure. //fsync //will ensure your data on disk is coherent. However, fsync may cause a noticeable performance degradation. Note that an fsync will not be performed more often than every 5 seconds.</wrap> **//<wrap>8.25.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the CCKD options panel.</wrap> <wrap>HHC00013I Herc command: 'cckd opts'</wrap> <wrap>HHC00346I cckd opts: comp=-1,compparm=-1,ra=2,raq=4,rat=2,wr=2,gcint=10</wrap> <wrap>HHC00346I gcparm=0,nostress=0,freepend=-1,fsync=0,linuxnull=0,trace=0</wrap> **<wrap>Figure 49: CCKD OPTS command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Display the CCKD help panel.</wrap> <wrap>HHC00013I Herc command: 'cckd help' \\ HHC00345I Command parameters for cckd:</wrap> <wrap>HHC00345I help Display help message</wrap> <wrap>HHC00345I stats Display cckd statistics</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 304</wrap> <wrap>\\ </wrap> |<WRAP><wrap>HHC00345I \\ HHC00345I \\ HHC00345I</wrap> </WRAP> |<WRAP><wrap>opts</wrap> <wrap>comp=<n> compparm=<n></wrap> </WRAP> |<WRAP><wrap>Display cckd options Override compression Override compression parm</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>(-1 ... 2)</wrap> <wrap>(-1 ... 9)</wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>ra=<n></wrap> </WRAP> |<WRAP><wrap>Set number readahead threads</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>( 1 ... 9)</wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>raq=<n></wrap> </WRAP> |<WRAP><wrap>Set readahead queue size</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>( 0 .. 16)</wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>rat=<n></wrap> </WRAP> |<WRAP><wrap>Set number tracks to read ahead</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>( 0 .. 16)</wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>wr=<n></wrap> </WRAP> |<WRAP><wrap>Set number writer threads</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>( 1 ... 9)</wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>gcint=<n></wrap> </WRAP> |<WRAP><wrap>Set garbage collector interval</wrap> </WRAP> |<WRAP><wrap>(sec)</wrap> </WRAP> |<WRAP><wrap>( 1 .. 60)</wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>gcparm=<n></wrap> </WRAP> |<WRAP><wrap>Set garbage collector parameter</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>(-8 ... 8)</wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>gcstart</wrap> </WRAP> |<WRAP><wrap>Start garbage collector</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>nostress=<n></wrap> </WRAP> |<WRAP><wrap>1=Disable stress writes</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>freepend=<n></wrap> </WRAP> |<WRAP><wrap>Set free pending cycles</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>(-1 ... 4)</wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>fsync=<n></wrap> </WRAP> |<WRAP><wrap>1=Enable fsync</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>linuxnull=<n></wrap> </WRAP> |<WRAP><wrap>1=Check for null linux tracks</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00345I</wrap> </WRAP> |<WRAP><wrap>trace=<n></wrap> </WRAP> |<WRAP><wrap>Set trace table size</wrap> </WRAP> |<WRAP><wrap>( 0</wrap> </WRAP> |<WRAP><wrap>... 200000)</wrap> </WRAP> | **<wrap>Figure 50: CCKD HELP command</wrap>** **<wrap>Example 3:</wrap>** <wrap>Display the CCKD statistics panel.</wrap> |<WRAP><wrap>HHC00013I HHC00347I</wrap> </WRAP> |<WRAP><wrap>Herc command: cckd stats:</wrap> </WRAP> |<WRAP><wrap>'cckd stats'</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>reads....</wrap> </WRAP> |<WRAP><wrap>2726</wrap> </WRAP> |<WRAP><wrap>Kbytes...</wrap> </WRAP> |<WRAP><wrap>10997</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>writes...</wrap> </WRAP> |<WRAP><wrap>141831</wrap> </WRAP> |<WRAP><wrap>Kbytes...</wrap> </WRAP> |<WRAP><wrap>179004</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>readaheads</wrap> </WRAP> |<WRAP><wrap>751</wrap> </WRAP> |<WRAP><wrap>misses...</wrap> </WRAP> |<WRAP><wrap>65</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>syncios..</wrap> </WRAP> |<WRAP><wrap>1149</wrap> </WRAP> |<WRAP><wrap>misses...</wrap> </WRAP> |<WRAP><wrap>1352</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>switches.</wrap> </WRAP> |<WRAP><wrap>3908</wrap> </WRAP> |<WRAP><wrap>l2 reads.</wrap> </WRAP> |<WRAP><wrap>322</wrap> </WRAP> |<WRAP><wrap>strs wrt.</wrap> </WRAP> |<WRAP><wrap>914</wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>cachehits</wrap> </WRAP> |<WRAP><wrap>1929</wrap> </WRAP> |<WRAP><wrap>misses...</wrap> </WRAP> |<WRAP><wrap>1979</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>l2 hits..</wrap> </WRAP> |<WRAP><wrap>15250</wrap> </WRAP> |<WRAP><wrap>misses...</wrap> </WRAP> |<WRAP><wrap>322</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>waits..... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>i/o.... </wrap> </WRAP> |<WRAP><wrap>158</wrap> </WRAP> |<WRAP><wrap>cache....</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>HHC00347I</wrap> </WRAP> |<WRAP><wrap>garbage collector</wrap> </WRAP> ||<WRAP><wrap>moves.. </wrap> </WRAP> |<WRAP><wrap>984</wrap> </WRAP> |<WRAP><wrap>Kbytes...</wrap> </WRAP> |<WRAP><wrap>173612</wrap> </WRAP> | **<wrap>Figure 51: CCKD STATS command</wrap>** **<wrap>Example 4:</wrap>** <wrap>Set a CCKD parameter.</wrap> <wrap>HHC00013I Herc command: 'cckd gcint=30'</wrap> <wrap>HHC00346I cckd opts: comp=-1,compparm=-1,ra=2,raq=4,rat=2,wr=2,gcint=30</wrap> <wrap>HHC00346I gcparm=0,nostress=0,freepend=-1,fsync=0,linuxnull=0,trace=0</wrap> **<wrap>Figure 52: CCKD command (set options)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 305</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.26 CD (Change directory) \\ //8.26.1 Function//</wrap>** <wrap>The CD command changes the current directory.</wrap> **//<wrap>8.26.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>CD </wrap>//<wrap>path</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CD ¬¬¬ </wrap>//<wrap>path</wrap>// **//<wrap>8.26.3 Parameter</wrap>//** **//<wrap>path </wrap>//**<wrap>This specifies the new path. The path can be specified absolute (“D:%%\%%S390%%\%%DASD”) or relative to the current path (“DASD”).</wrap> **//<wrap>8.26.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Change the current directory (absolute path).</wrap> <wrap>HHC00013I Herc command: 'cd </wrap>[[file:///D:/MVS|<wrap>D:%%\%%MVS</wrap>]]<wrap>'</wrap> <wrap>HHC02204I working directory set to </wrap>[[file:///D:/MVS|<wrap>D:%%\%%MVS</wrap>]]<wrap></wrap> **<wrap>Figure 53: CD command (absolute path)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Change the current directory (relative path).</wrap> <wrap>HHC00013I Herc command: 'cd DASD'</wrap> <wrap>HHC02204I working directory set to </wrap>[[file:///D:/MVS/DASD|<wrap>D:%%\%%MVS%%\%%DASD</wrap>]]<wrap></wrap> **<wrap>Figure 54: CD command (relative path)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 306</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.27 CF (Configure current CPU online or offline) \\ //8.27.1 Function//</wrap>** <wrap>The CF command is used to configure a CPU online or offline. The number of the CPU to be taken online or offline has to be specified first with the CPU command (refer to the CPU command for further information). If the CF command is issued without a parameter, the actual status of the CPU is displayed.</wrap> <wrap>Use the CFALL command to display the status of all CPUs or to configure all CPUs online or offline.</wrap> **//<wrap>8.27.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CF [ON | OFF]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ CF ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ ON ¬¬¬¬«</wrap> <wrap>⡿¬¬¬ OFF¬¬¬¯</wrap> **//<wrap>8.27.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>Place the specified CPU online.</wrap> **<wrap>OFF </wrap>**<wrap>Place the specified CPU offline.</wrap> **//<wrap>8.27.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the actual status of CPU 1.</wrap> <wrap>HHC00013I Herc command: 'cpu 1' \\ HHC00013I Herc command: 'cf' \\ HHC00819I Processor CP01: online</wrap> **<wrap>Figure 55: CF command (display CPU status)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 307</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Configure CPU 1 offline.</wrap> <wrap>HHC00013I Herc command: 'cpu 1'</wrap> <wrap>HHC00013I Herc command: 'cf off'</wrap> <wrap>HHC00101I Thread id 000010E0, prio 0, name 'Processor CP01' ended</wrap> <wrap>HHC00820I Processor CP01: offline</wrap> **<wrap>Figure 56: CF command (configure CPU offline)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Configure CPU 1 online.</wrap> <wrap>HHC00013I Herc command: 'cpu 1'</wrap> <wrap>HHC00013I Herc command: 'cf on'</wrap> <wrap>HHC00100I Thread id 000006F8, prio 0, name 'Processor CP01' started</wrap> <wrap>HHC00811I Processor CP01: architecture mode 'S/370'</wrap> <wrap>HHC00819I Processor CP01: online</wrap> **<wrap>Figure 57: CF command (configure CPU online)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 308</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.28 CFALL (Configure all CPUs online or offline) \\ //8.28.1 Function//</wrap>** <wrap>The CFALL command is used to place all CPUs online or offline. If the CFALL command is issued without a parameter, the actual status of all CPUs is displayed</wrap> **//<wrap>8.28.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CFALL [ON | OFF]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ CFALL ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ON¬¬¬¬«</wrap> <wrap>⡿¬¬¬OFF¬¬¬¯</wrap> **//<wrap>8.28.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>Place all CPUs online.</wrap> **<wrap>OFF </wrap>**<wrap>Place all CPUs offline.</wrap> **//<wrap>8.28.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current status of all CPUs.</wrap> <wrap>HHC00013I Herc command: 'cfall'</wrap> <wrap>HHC17007I NumCPU = 04, NumVEC = 00, ReservedCPU = 00, MaxCPU = 04</wrap> <wrap>HHC17008I Avgproc 001% 08; MIPS[ 2.44]; SIOS[ 2]</wrap> <wrap>HHC17009I PROC CP00 - 003%; MIPS[ 0.43]; SIOS[ 0]</wrap> <wrap>HHC17009I PROC CP01 - 001%; MIPS[ 0.13]; SIOS[ 2]</wrap> <wrap>HHC17009I PROC CP02 - 001%; MIPS[ 0.10]; SIOS[ 0]</wrap> <wrap>HHC17009I PROC CP03 - 000%; MIPS[ 0.09]; SIOS[ 0]</wrap> <wrap>HHC17010I - Started : Stopping * Stopped</wrap> **<wrap>Figure 58: CFALL command (display status of all CPUs)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 309</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Configure all CPUs offline.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'cfall off'</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00811I HHC00101I</wrap> </WRAP> |<WRAP><wrap>Processor Thread id</wrap> </WRAP> |<WRAP><wrap>CP00: architecture 00000450, prio 15,</wrap> </WRAP> ||<WRAP><wrap>mode name</wrap> </WRAP> |<WRAP><wrap>'ESA/390'</wrap> <wrap>'Processor CP00'</wrap> </WRAP> |<WRAP><wrap>ended</wrap> </WRAP> | |<WRAP><wrap>HHC00101I</wrap> </WRAP> |<WRAP><wrap>Thread id</wrap> </WRAP> |<WRAP><wrap>0000035C, prio</wrap> </WRAP> |<WRAP><wrap>0,</wrap> </WRAP> |<WRAP><wrap>name</wrap> </WRAP> |<WRAP><wrap>'Processor CP01'</wrap> </WRAP> |<WRAP><wrap>ended</wrap> </WRAP> | |<WRAP><wrap>HHC00101I</wrap> </WRAP> |<WRAP><wrap>Thread id</wrap> </WRAP> |<WRAP><wrap>000010C4, prio</wrap> </WRAP> |<WRAP><wrap>0,</wrap> </WRAP> |<WRAP><wrap>name</wrap> </WRAP> |<WRAP><wrap>'Processor CP02'</wrap> </WRAP> |<WRAP><wrap>ended</wrap> </WRAP> | |<WRAP><wrap>HHC00101I</wrap> </WRAP> |<WRAP><wrap>Thread id</wrap> </WRAP> |<WRAP><wrap>000013E4, prio</wrap> </WRAP> |<WRAP><wrap>0,</wrap> </WRAP> |<WRAP><wrap>name</wrap> </WRAP> |<WRAP><wrap>'Processor CP03'</wrap> </WRAP> |<WRAP><wrap>ended</wrap> </WRAP> | |<WRAP><wrap>HHC00101I</wrap> </WRAP> |<WRAP><wrap>Thread id</wrap> </WRAP> |<WRAP><wrap>00000D78, prio</wrap> </WRAP> |<WRAP><wrap>0,</wrap> </WRAP> |<WRAP><wrap>name</wrap> </WRAP> |<WRAP><wrap>'Processor CP04'</wrap> </WRAP> |<WRAP><wrap>ended</wrap> </WRAP> | |<WRAP><wrap>HHC00101I</wrap> </WRAP> |<WRAP><wrap>Thread id</wrap> </WRAP> |<WRAP><wrap>00000510, prio</wrap> </WRAP> |<WRAP><wrap>0,</wrap> </WRAP> |<WRAP><wrap>name</wrap> </WRAP> |<WRAP><wrap>'Processor CP05'</wrap> </WRAP> |<WRAP><wrap>ended</wrap> </WRAP> | |<WRAP><wrap>HHC00101I</wrap> </WRAP> |<WRAP><wrap>Thread id</wrap> </WRAP> |<WRAP><wrap>000006F8, prio</wrap> </WRAP> |<WRAP><wrap>0,</wrap> </WRAP> |<WRAP><wrap>name</wrap> </WRAP> |<WRAP><wrap>'Processor CP06'</wrap> </WRAP> |<WRAP><wrap>ended</wrap> </WRAP> | |<WRAP><wrap>HHC00101I</wrap> </WRAP> |<WRAP><wrap>Thread id</wrap> </WRAP> |<WRAP><wrap>00000C64, prio</wrap> </WRAP> |<WRAP><wrap>0,</wrap> </WRAP> |<WRAP><wrap>name</wrap> </WRAP> |<WRAP><wrap>'Processor CP07'</wrap> </WRAP> |<WRAP><wrap>ended</wrap> </WRAP> | |<WRAP><wrap>HHC00101I</wrap> </WRAP> |<WRAP><wrap>Thread id</wrap> </WRAP> |<WRAP><wrap>0000137C, prio</wrap> </WRAP> |<WRAP><wrap>0,</wrap> </WRAP> |<WRAP><wrap>name</wrap> </WRAP> |<WRAP><wrap>'Timer' ended</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 59: CFALL command (configure all CPUs offline)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Configure all CPUs online.</wrap> {{hercules:userref:bf:image063.gif|}}{{hercules:userref:bf:image064.gif|}}{{hercules:userref:bf:image065.gif|}}{{hercules:userref:bf:image066.gif|}}{{hercules:userref:bf:image067.gif|}}{{hercules:userref:bf:image068.gif|}}**<wrap>Figure 60: CFALL command (configure all CPUs online)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 310</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.29 CLOCKS (Display TOD clock and CPU timer) \\ //8.29.1 Function//</wrap>** <wrap>The CLOCKS command is used to display the actual values of the emulators various internal clocks and timers.</wrap> **//<wrap>8.29.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CLOCKS</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CLOCKS</wrap> **//<wrap>8.29.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.29.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the TOD clock and CPU timer.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc</wrap> </WRAP> |<WRAP><wrap>command: 'clocks'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02274I</wrap> </WRAP> |<WRAP><wrap>tod =</wrap> </WRAP> |<WRAP><wrap>F8ED87F060EA3000</wrap> </WRAP> |<WRAP><wrap>2038.282</wrap> </WRAP> |<WRAP><wrap>00:19:05.843363</wrap> </WRAP> | |<WRAP><wrap>HHC02274I</wrap> </WRAP> |<WRAP><wrap>h/w =</wrap> </WRAP> |<WRAP><wrap>C6B345BF5EEA3000</wrap> </WRAP> |<WRAP><wrap>2010.282</wrap> </WRAP> |<WRAP><wrap>00:19:05.843363</wrap> </WRAP> | |<WRAP><wrap>HHC02274I</wrap> </WRAP> |<WRAP><wrap>off =</wrap> </WRAP> |<WRAP><wrap>323A423102000000</wrap> </WRAP> |<WRAP><wrap>28.001</wrap> </WRAP> |<WRAP><wrap>00:00:00.000000</wrap> </WRAP> | |<WRAP><wrap>HHC02274I</wrap> </WRAP> |<WRAP><wrap>ckc =</wrap> </WRAP> |<WRAP><wrap>0000000000000000</wrap> </WRAP> |<WRAP><wrap>1900.001</wrap> </WRAP> |<WRAP><wrap>00:00:00.000000</wrap> </WRAP> | |<WRAP><wrap>HHC02274I HHC02274I</wrap> </WRAP> |<WRAP><wrap>cpt = itm =</wrap> </WRAP> |<WRAP><wrap>not decrementing FDA3714C</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>15:23:28.164060</wrap> </WRAP> | **<wrap>Figure 61: CLOCKS command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 311</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.30 CMDLEVEL (Display or set current command group) //8.30.1 Function//</wrap>** <wrap>The CMDLEVEL command displays or sets the current command group(s). A plus sign preceding the command group activates the console commands of this group, whereas a preceding minus sign deactivates the commands.</wrap> <wrap>A table showing the affiliation of each console command to the various command groups can be found in ‘Appendix D. Hercules Command Groups’.</wrap> <wrap>Some console commands are always active to keep Hercules operable, independent of the current active command group. These commands are listed under command group 'NONE' in the above mentioned table. Command group ‘NONE’ is the result of a ‘CMDLVL –ALL’ command.</wrap> <wrap>The default command level is set to operator, maintenance, programmer and configuration (which corresponds to the command "CMDLEVEL -ALL +OPER +MAINT +PROG +CONFIG"). Some of the arguments can be abbreviated as shown in the syntax section below.</wrap> **//<wrap>8.30.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>CMDLEVEL [{-'- | </wrap><wrap>-</wrap><wrap>} {ALL | 0PERator | MAINT | PR0G</wrap><wrap>rammer </wrap><wrap>| C0NFIG</wrap><wrap>uration </wrap><wrap>| DEVEL</wrap><wrap>oper </wrap><wrap>| DEBUG} </wrap><wrap>[...]]</wrap> |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬CMDLEVEL</wrap> </WRAP> |<WRAP><wrap>~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®</wrap> <wrap>¬¬¬°¬¬¬§¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬§¬¬¬¨</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>ª</wrap><wrap>¬¬¬ + ¬¬¬§¬¬¬§¬¬¬ ALL ¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap><wrap>- </wrap><wrap>¬¬¬¯ ª¬¬¬0PERator¬</wrap><wrap>¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬MAINT </wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬PR0Grammer </wrap><wrap>¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬C0NFIG</wrap><wrap>uration ¬¬¬« </wrap><wrap>ª¬¬¬DEVEL</wrap><wrap>oper ¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬DEBUG </wrap><wrap>¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¯</wrap> </WRAP> | **//<wrap>8.30.3 Parameter</wrap>//** **<wrap>+ </wrap>**<wrap>The plus sign activates the commands of the following command group.</wrap> **<wrap>- </wrap>**<wrap>The minus sign deactivates the commands of the following command group.</wrap> **<wrap>ALL </wrap>**<wrap>Command group ‘ALL’ contains all Hercules console commands. Specifying command group ‘+ALL’ enables all console commands whereas command group ‘-ALL’ equals to NONE. This disables all console commands with the exception of com-</wrap><wrap></wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 312</wrap> <wrap>\\ </wrap><wrap>mands necessary to keep Hercules operable.</wrap> <wrap>\\ </wrap>**<wrap>OPER </wrap>**<wrap>The ‘OPERator’ command group activates or deactivates all system operator commands.</wrap> **<wrap>MAINT </wrap>**<wrap>Command group ’MAINT’ activates or deactivates all system maintainer commands.</wrap> **<wrap>PROG </wrap>**<wrap>The ‘PROGrammer’ command group activates or deactivates all systems programmer commands.</wrap> **<wrap>CONFIG </wrap>**<wrap>Command group ‘CONFIGuration’ activates or deactivates all system configuration commands.</wrap> **<wrap>DEVEL </wrap>**<wrap>The ‘DEVELoper’ command group activates or deactivates all system developer commands.</wrap> **<wrap>DEBUG </wrap>**<wrap>Command group ‘DEBUG’ activates or deactivates all debugging activity commands activities.</wrap> **//<wrap>8.30.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the command group to OPERATOR and PROGRAMMER.</wrap> <wrap>HHC00013I Herc command: 'cmdlevel -all +operator +programmer' \\ HHC01606I cmdlevel[85] is 'operator programmer '</wrap> **<wrap>Figure 62: CMDLEVEL command (set command group)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Display the current command group(s).</wrap> <wrap>HHC00013I Herc command: 'cmdlvl'</wrap> <wrap>HHC01606I cmdlevel[1F] is 'operator maintenance programmer configuration'</wrap> **<wrap>Figure 63: CMDLEVEL command (display current command group)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 313</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.31 CMDLVL (Display or set current command group) //8.31.1 Function//</wrap>** <wrap>CMDLVL is an alias for CMDLEVEL. The CMDLVL command displays or sets the current command group(s). See CMDLEVEL for details.</wrap> **//<wrap>8.31.2 Syntax</wrap>//** <wrap>See CMDLEVEL command.</wrap> **//<wrap>8.31.3 Parameter</wrap>//** <wrap>See CMDLEVEL command.</wrap> **//<wrap>8.31.4 Examples</wrap>//** <wrap>See CMDLEVEL command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 314</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.32 CMDSEP (Display or set current command line separator) //8.32.1 Function//</wrap>** <wrap>The CMDSEP command displays or sets the command line separator. The command line separator character is used to separate multiple panel commands on a single line. The default is OFF which means that there is no command line separator defined and therefore multiple panel commands on a single line are not supported.</wrap> **//<wrap>8.32.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CMDSEP [</wrap>//<wrap>char </wrap>//<wrap>| OFF]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CMDSEP ¬¬¬§¬¬¬ </wrap>//<wrap>char </wrap>// <wrap>i¬¬¬ OFF -</wrap> **//<wrap>8.32.3 Parameter</wrap>//** **//<wrap>char </wrap>//**<wrap>Specifies a single character that is used for command separation. This character must not be the period ('.'), the exclamation mark ('!') or the hyphen ('-'). Although the command line separation character can be set to the number (hash) sign ('#'), this is not recommended because this could affect processing command lines that contain comments.</wrap> **<wrap>OFF </wrap>**<wrap>OFF disables command separation. This is the default.</wrap> **//<wrap>8.32.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the current command separator to ';'.</wrap> <wrap>HHC00013I Herc command: 'cmdsep' \\ HHC02203I Value 'cmdsep': 'Not set'</wrap> **<wrap>Figure 64: CMDSEP command (display the current command line separator)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 315</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the current command separator to ';'.</wrap> <wrap>HHC00013I Herc command: 'cmdsep ;' \\ HHC02204I Value 'cmdsep' set to ';'</wrap> **<wrap>Figure 65: CMDSEP command (set new command line separator)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 316</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.33 CMDTGT (Specify the command target) \\ //8.33.1 Function//</wrap>** <wrap>The CMDTGT command specifies the target environment for all following commands entered on the command line of the Hercules hardware console.</wrap> **//<wrap>8.33.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>CMDTGT {HERC | SCP | PSCP|?}</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ%%__%%_CMDTGT %%__%%_§%%__%%_ HERC%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_</wrap>**<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> **<wrap>I%%__%%_ SCP%%__%%%%__%%«</wrap>** **<wrap>I%%__%%_ PSCP%%__%%_«</wrap>** **<wrap>I %%__%%%%__%%?%%__%%%%__%%_¯</wrap>** **//<wrap>8.33.3 Parameter</wrap>//** **<wrap>HERC </wrap>**<wrap>The command target is the Hercules Emulator. This is also the default, when no CMDTGT target has been given.</wrap> **<wrap>SCP </wrap>**<wrap>The target for the commands is the system control program (i.e. the guest operating system running under Hercules).</wrap> **<wrap>PSCP </wrap>**<wrap>All entered commands are system control program (i.e. guest operating system) priority commands.</wrap> **<wrap>? </wrap>**<wrap>Display the current target environment for commands.</wrap> **//<wrap>8.33.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current target environment for commands.</wrap> <wrap>HHC00013I Herc command: 'cmdtgt ?' \\ HHC02288I Commands are sent to 'herc'</wrap> **<wrap>Figure 66: CMDTGT command (display current setting)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 317</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the system control program as the target for commands.</wrap> |<WRAP><wrap>HHC00013I Herc command: 'cmdtgt scp' HHC02288I Commands are sent to 'scp'</wrap> </WRAP> | **<wrap>Figure 67: CMDTGT command (set target to SCP)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the command target from SCP or PSCP back to Hercules (see also HERC command).</wrap> <wrap>HHC00013I Herc command: 'herc cmdtgt herc' \\ HHC02288I Commands are sent to 'herc'</wrap> **<wrap>Figure 68: CMDTGT command (set target back to Hercules)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 318</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.34 CNSLPORT (Display or set console port) \\ //8.34.1 Function//</wrap>** <wrap>The CNSLPORT command displays or sets the port number (in decimal), on which the telnet server will listen. The parameter of the command may also have the form host:port, where the telnet console server will bind to the specified address.</wrap> **//<wrap>8.34.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>CNSLP0RT </wrap>//<wrap>[port </wrap>//<wrap>| </wrap>//<wrap>host:port</wrap>////<wrap>]</wrap>// |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ C</wrap>//<wrap>NSLP0RT</wrap> </WRAP> |<WRAP>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>// <wrap>ª¬¬¬¬¬¬</wrap>//<wrap>port ¬¬¬¬¬¬«</wrap>// <wrap>⡿</wrap>//<wrap>¬¬¬ host </wrap>////<wrap>:port </wrap>////<wrap>¬¬¬</wrap>//<wrap>¯</wrap> </WRAP> | **//<wrap>8.34.3 Parameter</wrap>//** **//<wrap>host </wrap>//**<wrap>The IP address of the host to which the telnet server will bind to. If an IP address is given then it must be a valid IP address for the host system.</wrap> **//<wrap>port </wrap>//**<wrap>The port number (decimal) on which the telnet server will listen. The port number must not be in use by any other server. The port number must be in the range of 0 to 65535. Ports below 1024 cannot be used unless Hercules is running as root or is otherwise authorized to use low ports.</wrap> **//<wrap>8.34.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current telnet client port.</wrap> <wrap>HHC00013I Herc command: 'cnslport'</wrap> <wrap>HHC17001I Console server listening for host 192.168.1.10 on port 3270</wrap> **<wrap>Figure 69: CNSLPORT command (display current telnet client port)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 319</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the port number on which the telnet server will listen to 3270.</wrap> <wrap>HHC00013I Herc command: 'cnslport 3270'</wrap> **<wrap>Figure 70: CNSLPORT command (set telnet client port)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Specify 192.168.1.10 as the IP address of the host to which the telnet server will bind to and set the port number on which the telnet server will listen to 3270.</wrap> <wrap>HHC00013I Herc command: 'cnslport 192.168.1.10:3270'</wrap> **<wrap>Figure 71: CNSLPORT command (set telnet client port bound to specific address)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 320</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.35 CODEPAGE (Display or set codepage conversion table) //8.35.1 Function//</wrap>** <wrap>The CODEPAGE command displays or sets the codepage conversion table. If an operand is given then the codepage is set to the specified page, if the page is valid. If no operand is specified, the current code-page is displayed.</wrap> <wrap>With the QCODEPAGES panel command a list of all valid codepage mappings can be displayed.</wrap> **//<wrap>8.35.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>C0DEPAGE [</wrap>//<wrap>codepage </wrap>//<wrap>| USER | MAINT </wrap>//<wrap>cmd </wrap>//<wrap>[</wrap>//<wrap>operands</wrap>//<wrap>]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬C0DEPAGE¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ª¬¬¬</wrap>//<wrap>codepage </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª</wrap><wrap>¬¬¬USER¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬¬MAINT ¬¬¬ </wrap>//<wrap>cmd </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬ </wrap>//<wrap>operands </wrap>//<wrap>¬¬¬¯</wrap> **//<wrap>8.35.3 Parameter</wrap>//** **<wrap>DEFAULT </wrap>**<wrap>“DEFAULT” specifies the traditional Hercules codepage.</wrap> **//<wrap>codepage </wrap>//**<wrap>Specifies the codepage conversion table used for ASCII / EBCDIC translation. Supported codepage mappings are shown in the table below. Iconv single byte codepages may also be used (e.g. “UTF8/EBCDIC-CP-NL”).</wrap> **<wrap>USER </wrap>**<wrap>This specifies that the user specific codepage conversion tables (see CPUPDT system parameter and console command) have to be activated.</wrap> **<wrap>MAINT </wrap>**<wrap>MAINT and its arguments is the same as the CP_UPDT system parameter. Please see CP_UPDT for details.</wrap> <wrap>Supported codepage mappings:</wrap> |<WRAP>**<wrap>Mapping</wrap>** </WRAP> |<WRAP>**<wrap>ASCII</wrap>** </WRAP> |<WRAP>**<wrap>EBCDIC</wrap>** </WRAP> | |<WRAP><wrap>437/037</wrap> </WRAP> |<WRAP><wrap>437 PC United States</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada</wrap> </WRAP> | |<WRAP><wrap>437/500</wrap> </WRAP> |<WRAP><wrap>437 PC United States</wrap> </WRAP> |<WRAP><wrap>500 Latin 1</wrap> </WRAP> | |<WRAP><wrap>437/1047</wrap> </WRAP> |<WRAP><wrap>437 PC United States</wrap> </WRAP> |<WRAP><wrap>1047 Open Systems Latin 1</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 321</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>Mapping</wrap>** </WRAP> |<WRAP>**<wrap>ASCII</wrap>** </WRAP> |<WRAP>**<wrap>EBCDIC</wrap>** </WRAP> | |<WRAP><wrap>819/037</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada</wrap> </WRAP> | |<WRAP><wrap>819/037v2</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada SHARE</wrap> </WRAP> | |<WRAP><wrap>819/273</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>273 CECP Austria/Germany</wrap> </WRAP> | |<WRAP><wrap>819/277</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>277 CECP Denmark/Norway</wrap> </WRAP> | |<WRAP><wrap>819/278</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>278 CECP Finland/Sweden</wrap> </WRAP> | |<WRAP><wrap>819/280</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>280 CECP Italy</wrap> </WRAP> | |<WRAP><wrap>819/284</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>284 CECP Spain</wrap> </WRAP> | |<WRAP><wrap>819/285</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>285 CECP United Kingdom</wrap> </WRAP> | |<WRAP><wrap>819/297</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>297 CECP France</wrap> </WRAP> | |<WRAP><wrap>819/500</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>500 CECP International</wrap> </WRAP> | |<WRAP><wrap>819/1047</wrap> </WRAP> |<WRAP><wrap>819 ISO-8859-1 Latin 1</wrap> </WRAP> |<WRAP><wrap>1047 Open Systems Latin 1</wrap> </WRAP> | |<WRAP><wrap>850/273</wrap> </WRAP> |<WRAP><wrap>850 PC Latin 1</wrap> </WRAP> |<WRAP><wrap>273 Austria/Germany</wrap> </WRAP> | |<WRAP><wrap>850/1047</wrap> </WRAP> |<WRAP><wrap>850 PC Latin 1</wrap> </WRAP> |<WRAP><wrap>1047 Open Systems Latin 1</wrap> </WRAP> | |<WRAP><wrap>1252/037</wrap> </WRAP> |<WRAP><wrap>1252 Windows Latin 1</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada</wrap> </WRAP> | |<WRAP><wrap>1252/037v2</wrap> </WRAP> |<WRAP><wrap>1252 Windows Latin 1</wrap> </WRAP> |<WRAP><wrap>037 United States/Canada SHARE</wrap> </WRAP> | |<WRAP><wrap>1252/1047</wrap> </WRAP> |<WRAP><wrap>1252 Windows Latin 1</wrap> </WRAP> |<WRAP><wrap>1047 Open Systems Latin 1</wrap> </WRAP> | |<WRAP><wrap>1252/1140</wrap> </WRAP> |<WRAP><wrap>1252 Windows Latin 1</wrap> </WRAP> |<WRAP><wrap>1140 United States/Canada with Euro sign</wrap> </WRAP> | **<wrap>Table 18: Supported codepage mappings</wrap>** **//<wrap>8.35.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current codepage conversion table.</wrap> <wrap>HHC00013I Herc command: 'codepage' \\ HHC01476I Codepage is 'default'</wrap> **<wrap>Figure 72: CODEPAGE command (display current codepage conversion table)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the codepage conversion table to 437/037.</wrap> <wrap>HHC00013I Herc command: 'codepage 437/037'</wrap> <wrap>HHC01474I Using 'internal' codepage conversion table '437/037'</wrap> **<wrap>Figure 73: CODEPAGE command (set codepage conversion table)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 322</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.36 CONKPALV (Display / alter console TCP/IP keep-alive settings) //8.36.1 Function//</wrap>** <wrap>The CONKPALV command specifies the tn3270 console and telnet clients keepalive option values that control automatic detection of disconnected tn3270/telnet client sessions.</wrap> <wrap>This is a built-in feature of TCP/IP and allows detection of unresponsive TCP/IP connections and not idle clients. That is to say, your connection will not be terminated after 3 seconds of idle time. Your 3270 session can remain idle for many minutes or hours or days without any data being transmitted. If the TCP/IP stack at the other end of the connection (not your 3270 client itself) fails to respond to the internal keepalive probe packets however, then it means that the TCP/IP stack itself is down or there has been a physical break in the connection.</wrap> <wrap>Thus, even if your 3270 client is completely idle, your system's TCP/IP stack itself should still respond to the keepalive probes sent by the TCP/IP stack at the Hercules end of the link. If it doesn't, then TCP/IP will terminate the tn3270/telnet session which will cause Hercules to disconnect the terminal.</wrap> <wrap>The three values can also be modified on-demand via the conkpalv panel command, which has the exact same syntax. Note that the syntax is very unforgiving: no spaces are allowed anywhere within the parentheses and each value must be separated from the other with a single comma.</wrap> <wrap>Please also note that not all systems support being able to modify all three values. That is, not all values may be able to be changed, and it is system dependent which values you can change and which values you cannot. On Windows for example, the //count //value is ignored and cannot be changed from its default value of 10. Other systems may ignore one or more or all three values and use platform defaults instead. This is entirely system dependent. Check you system's documentation for details regarding which values can be changed and which cannot as well as how to adjust your system's default values.</wrap> **//<wrap>8.36.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CONKPALV (</wrap>//<wrap>idl</wrap>////<wrap>e,intv,count</wrap>//<wrap>)</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CONKPALV ¬¬¬ (</wrap>//<wrap>idle,intv,count</wrap>//<wrap>)</wrap> **//<wrap>8.36.3 Parameter</wrap>//** **//<wrap>idle </wrap>//**<wrap>The //idle //value specifies the number of seconds of inactivity until the first keep-alive probe is sent. The default for the //idle //value is 3 seconds.</wrap> **//<wrap>intv </wrap>//**<wrap>The //intv //value specifies the interval in seconds between the probes if no acknowledgement is received from the previous probe. The default for //intv //is 1 second.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 323</wrap> <wrap>\\ </wrap>**//<wrap>count </wrap>//**<wrap>The //count //value specifies the number of unacknowledged keep-alive packets sent before the connection is considered to have failed. The default value is 9 for non-Windows platforms and 10 for Windows systems.</wrap> //<wrap>Note: </wrap>//<wrap>On Windows platforms the count value is ignored and cannot be changed from its default value of 10.</wrap> **//<wrap>8.36.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the TCP/IP keep-alive settings to 5 seconds idle time, 3 seconds interval between the probes and disconnect after 15 consecutive failed probes.</wrap> <wrap>HHC00013I Herc command: 'conkpalv (5,3,15)'</wrap> **<wrap>Figure 74: CONKPALV command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 324</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.37 CP_UPDT (Create or modify user character conversion table) //8.37.1 Function//</wrap>** <wrap>The CP_UPDT console command creates or modifies the contents of the user codepage tables. The tables can be populated with a ‘CP_UPDT REFERENCE’ command which copies one of the provided codepage tables to the user tables or by a ‘CP_UPDT IMPORT’ command which imports a previously created and with ‘CP_UPDT EXPORT’ exported table.</wrap> <wrap>Changes in the user tables are made through one or more ‘CP_UPDT ALTER’ commands. These allow for up to 16 modifications at a time. The current contents of the user tables can be shown on the console with ‘CP_UPDT DISPLAY’. Finally the changed user tables are activated with a ‘CODEPAGE USER’ command.</wrap> <wrap>In all commands that require the selection of a user table (EBCDIC or ASCII), the EBCDIC table refers to the ‘guest to host’ (g2h) translation and the ASCII table refers to the ‘host to guest’ (h2g) translation.</wrap> **//<wrap>8.37.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CP UPDT </wrap>//<wrap>command</wrap>// <wrap>where </wrap>//<wrap>command </wrap>//<wrap>can be:</wrap> <wrap>ALTER {EBCDIC | ASCII | G2H | H2G} (</wrap>//<wrap>pos</wrap>//<wrap>,</wrap>//<wrap>val</wrap>//<wrap>[,</wrap>//<wrap>pos</wrap>//<wrap>,</wrap>//<wrap>val</wrap>//<wrap>]...)</wrap> <wrap>DISPLAY {EBCDIC | ASCII | G2H | H2G}</wrap> <wrap>EXPORT {EBCDIC | ASCII | G2H | H2G} </wrap>//<wrap>filename</wrap>// <wrap>IMPORT {EBCDIC | ASCII | G2H | H2G} </wrap>//<wrap>filename</wrap>// <wrap>REFERENCE [</wrap>//<wrap>codepage</wrap>//<wrap>]</wrap> <wrap>RESET</wrap> <wrap>TEST</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CP UPDT ¬¬¬i </wrap>//<wrap>command \\ </wrap>//<wrap>where </wrap>//<wrap>command </wrap>//<wrap>can be:</wrap> <wrap>~¬¬¬¬¬¬ , ¬¬¬¬¬¬®</wrap> <wrap>i¬¬¬ ALTER ¬¬¬§¬¬¬ EBCDIC ¬¬¬§¬¬¬ ( ¬¬¬°¬¬¬ </wrap>//<wrap>pos</wrap>//<wrap>,</wrap>//<wrap>val </wrap>//<wrap>¬¬¬¨¬¬¬ ) ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª¬¬¬ ASCII ¬¬¬¬«</wrap> <wrap>ª¬¬¬ G2H ¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬ H2G ¬¬¬¬¬¬</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 325</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>F--- DISPLAY </wrap><wrap>---§--- </wrap><wrap>EBCDIC </wrap><wrap>---§---------------------------------------------I</wrap> <wrap>ª---ASCII----«</wrap> <wrap>ª---G2H------«</wrap> <wrap>⡿--- </wrap> <wrap>%%__%%%%__%% H2G ------¯</wrap> <wrap>F--- EXPORT </wrap><wrap>---§--- </wrap><wrap>EBCDIC </wrap><wrap>---§--- //filename //---------------------------------I</wrap> <wrap>ª---ASCII----«</wrap> <wrap>ª---G2H------«</wrap> <wrap>⡿--- </wrap> <wrap>%%__%%%%__%% H2G ------</wrap><wrap></wrap> <wrap>F--- IMPORT </wrap><wrap>---§--- </wrap><wrap>EBCDIC </wrap><wrap>---§--- //filename //---------------------------------I</wrap> <wrap>ª---ASCII----«</wrap> <wrap>ª---G2H------«</wrap> <wrap>⡿--- </wrap> <wrap>%%__%%%%__%% H2G ------</wrap><wrap></wrap> <wrap>I- REFERENCE </wrap><wrap>---§----------------§-----------------------------------------I</wrap> <wrap>⡿---</wrap>//<wrap>codepage </wrap>//<wrap>---</wrap><wrap></wrap> <wrap>I</wrap><wrap>--- RESET </wrap><wrap>------------------------------------------------------------------</wrap>__<wrap>I</wrap>__<wrap></wrap> <wrap>I- TEST </wrap><wrap>-------------------------------------------------------------------</wrap>__<wrap>I</wrap>__<wrap></wrap> **//<wrap>8.37.3 Parameter</wrap>//** **<wrap>ALTER </wrap>**<wrap>Alters the user EBCDIC or ASCII table value at hex position //pos //to hex value //val//. Up to 16 pairs of hex digits may be specified within the parenthesis. ALTER can be abbreviated as ‘ALT’.</wrap> **<wrap>DISPLAY </wrap>**<wrap>Displays the user EBCDIC or ASCII codepage table. DISPLAY can be abbreviated as ‘DIS’ or ‘DSP’.</wrap> **<wrap>EXPORT </wrap>**<wrap>Exports the contents of the user EBCDIC or ASCII codepage table to file //filename//. EXPORT can be abbreviated as ‘EXP’.</wrap> **<wrap>IMPORT </wrap>**<wrap>Imports the contents of file //filename //to the user EBCDIC or ASCII codepage table. IMPORT can be abbreviated as ‘IMP’.</wrap> **<wrap>REFERENCE </wrap>**<wrap>Copies the specified codepage to the user EBCDIC and ASCII tables. If no code-page is specified, a list of valid codepages is displayed on the console. ‘REFERENCE’ can be abbreviated as ‘REF’.</wrap> **<wrap>RESET </wrap>**<wrap>Reset the internal user tables to binary zero.</wrap> **<wrap>TEST </wrap>**<wrap>Verify that user tables are transparent, i.e. the value at position n in g2h used as an</wrap> <wrap>index into h2g will return a value equal n (g2h<=>h2g, h2g<=>g2h).</wrap> **<wrap>EBCDIC </wrap>**<wrap>The target for the command is the EBCDIC table. The EBCDIC table refers to the ‘guest to host’ translation. ‘EBCDIC’ can be abbreviated as ‘E’.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 326</wrap> <wrap>\\ </wrap>**<wrap>ASCII </wrap>**<wrap>The target for the command is the ASCII table. The ASCII table refers to the ‘host to guest’ translation. ‘ASCII’ can be abbreviated as ‘A’.</wrap> **<wrap>G2H </wrap>**<wrap>This is the same as ‘EBCDIC’.</wrap> **<wrap>H2G </wrap>**<wrap>This is the same as ‘ASCII’.</wrap> **//<wrap>pos </wrap>//**<wrap>Specifies the hex position within the selected table.</wrap> **//<wrap>val </wrap>//**<wrap>Specifies the hex value for the selected position.</wrap> **//<wrap>filename </wrap>//**<wrap>Specifies the file name of the file to which the specified codepage has to be exported or from which the codepage table has to be imported.</wrap> **//<wrap>codepage </wrap>//**<wrap>Specifies the codepage that has to be copied to the user tables.</wrap> **//<wrap>8.37.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Copy the Hercules default codepage to the user tables.</wrap> <wrap>HHC00013I Herc command: 'cp_updt reference default' \\ HHC01478I Codepage 'default' copied to 'user'</wrap> **<wrap>Figure 75: CP_UPD command (copy codepage to user tables)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 327</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Display user ASCII table.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'cp_updt display</wrap> </WRAP> ||<WRAP><wrap>ascii'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01484I \\ HHC01485I \\ HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage: \\ Codepage: \\ Codepage:</wrap> </WRAP> |<WRAP><wrap>Displaying user table</wrap> <wrap>_0_1_2_3 _4_5_6_7 0_ 00010203 372D2E2F</wrap> </WRAP> |<WRAP><wrap>ascii/h2g</wrap> <wrap>_8_9_A_B _C_D_E_F 1605250B 0C0D0E0F</wrap> </WRAP> ||<WRAP><wrap>0...</wrap> <wrap>....</wrap> </WRAP> |<WRAP><wrap>4...</wrap> <wrap>....</wrap> </WRAP> |<WRAP><wrap>8...</wrap> <wrap>....</wrap> </WRAP> |<WRAP><wrap>C...</wrap> <wrap>....</wrap> </WRAP> |<WRAP><wrap>0_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>1_ 10111213 3C3D3226</wrap> </WRAP> |<WRAP><wrap>18191A27</wrap> </WRAP> |<WRAP><wrap>221D351F</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>1_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>2_ 405A7F7B 5B6C507D</wrap> </WRAP> |<WRAP><wrap>4D5D5C4E</wrap> </WRAP> |<WRAP><wrap>6B604B61</wrap> </WRAP> |<WRAP><wrap>!"#</wrap> </WRAP> |<WRAP><wrap>$%&'</wrap> </WRAP> |<WRAP><wrap>()*+</wrap> </WRAP> |<WRAP><wrap>,-./</wrap> </WRAP> |<WRAP><wrap>2_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>3_ F0F1F2F3 F4F5F6F7</wrap> </WRAP> |<WRAP><wrap>F8F97A5E</wrap> </WRAP> |<WRAP><wrap>4C7E6E6F</wrap> </WRAP> |<WRAP><wrap>0123</wrap> </WRAP> |<WRAP><wrap>4567</wrap> </WRAP> |<WRAP><wrap>89:;</wrap> </WRAP> |<WRAP><wrap><=>?</wrap> </WRAP> |<WRAP><wrap>3_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>4_ 7CC1C2C3 C4C5C6C7</wrap> </WRAP> |<WRAP><wrap>C8C9D1D2</wrap> </WRAP> |<WRAP><wrap>D3D4D5D6</wrap> </WRAP> |<WRAP><wrap>@ABC</wrap> </WRAP> |<WRAP><wrap>DEFG</wrap> </WRAP> |<WRAP><wrap>HIJK</wrap> </WRAP> |<WRAP><wrap>LMNO</wrap> </WRAP> |<WRAP><wrap>4_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>5_ D7D8D9E2 E3E4E5E6</wrap> </WRAP> |<WRAP><wrap>E7E8E9AD</wrap> </WRAP> |<WRAP><wrap>E0BD5F6D</wrap> </WRAP> |<WRAP><wrap>PQRS</wrap> </WRAP> |<WRAP><wrap>TUVW XYZ[</wrap> </WRAP> ||<WRAP><wrap>%%\%%]^_</wrap> </WRAP> |<WRAP><wrap>5_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>6_ 79818283 84858687</wrap> </WRAP> |<WRAP><wrap>88899192</wrap> </WRAP> |<WRAP><wrap>93949596</wrap> </WRAP> |<WRAP><wrap>`abc</wrap> </WRAP> |<WRAP><wrap>defg</wrap> </WRAP> |<WRAP><wrap>hijk</wrap> </WRAP> |<WRAP><wrap>lmno</wrap> </WRAP> |<WRAP><wrap>6_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>7_ 979899A2 A3A4A5A6</wrap> </WRAP> |<WRAP><wrap>A7A8A9C0</wrap> </WRAP> |<WRAP><wrap>6AD0A107 pqrs</wrap> </WRAP> ||<WRAP><wrap>tuvw xyz{</wrap> </WRAP> ||<WRAP><wrap>|}~.</wrap> </WRAP> |<WRAP><wrap>7_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>8_ 68DC5142 43444748</wrap> </WRAP> |<WRAP><wrap>52535457</wrap> </WRAP> |<WRAP><wrap>56586367</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>8_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>9_ 719C9ECB CCCDDBDD</wrap> </WRAP> |<WRAP><wrap>DFECFCB0</wrap> </WRAP> |<WRAP><wrap>B1B2B3B4</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>9_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>A_ 4555CEDE 49690406</wrap> </WRAP> |<WRAP><wrap>AB08BAB8</wrap> </WRAP> |<WRAP><wrap>B7AA8A8B</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>A_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>B_ 090A14BB 15B5B617</wrap> </WRAP> |<WRAP><wrap>1BB91C1E</wrap> </WRAP> |<WRAP><wrap>BC20BEBF</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>B_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>C_ 21232428 292A2B2C</wrap> </WRAP> |<WRAP><wrap>3031CA33</wrap> </WRAP> |<WRAP><wrap>343638CF</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>C_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>D_ 393A3B3E 41464A4F</wrap> </WRAP> |<WRAP><wrap>5962DA64</wrap> </WRAP> |<WRAP><wrap>65667072</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>D_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>E_ 73E17475 76777880</wrap> </WRAP> |<WRAP><wrap>8C8D8EEB 8FEDEEEF</wrap> </WRAP> ||<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>E_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>F_ 909A9B9D 9FA0ACAE AFFDFEFB 3FEAFAFF</wrap> </WRAP> |||<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>F_</wrap> </WRAP> | **<wrap>Figure 76: CP_UPD command (display ASCII user table)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Export the ASCII user table to file ‘ascii.cp’.</wrap> <wrap>HHC00013I Herc command: 'cp_updt export ascii </wrap>[[file:///d:/mvs/conf/ascii.cp|<wrap>d:%%\%%mvs%%\%%conf%%\%%ascii.cp</wrap>]]<wrap>'</wrap> <wrap>HHC01490I Codepage: Exported user table ascii/h2g to file </wrap>[[file:///d:/mvs/conf/ascii.cp|<wrap>d:%%\%%mvs%%\%%conf%%\%%ascii.cp</wrap>]]<wrap></wrap> **<wrap>Figure 77: CP_UPD command (export user table)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Import the ASCII user table from file ‘ascii.cp’.</wrap> <wrap>HHC00013I Herc command: 'cp_updt import ascii </wrap>[[file:///d:/mvs/conf/ascii.cp|<wrap>d:%%\%%mvs%%\%%conf%%\%%ascii.cp</wrap>]]<wrap>'</wrap> <wrap>HHC01490I Codepage: Imported user table ascii/h2g from file </wrap>[[file:///d:/mvs/conf/ascii.cp|<wrap>d:%%\%%mvs%%\%%conf%%\%%ascii.cp</wrap>]]<wrap></wrap> **<wrap>Figure 78: CP_UPD command (import user table)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 328</wrap> <wrap>\\ </wrap>**<wrap>Example 5:</wrap>** <wrap>Alter the ASCII user table as follows, display the changed table and activate it:</wrap> <wrap>- Change position x’5B’ to value x’C0’ and position x’5D’ to value x’D0’</wrap> <wrap>- Change position x’7B’ to value x’AD’ and position x’7D’ to value x’B0’</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'cp_updt alter ascii (5b,c0,5d,d0,7b,ad,7d,bd)'</wrap> <wrap>HHC01487I Codepage: Altering user table ascii/h2g</wrap> <wrap>HHC01488I Codepage: Pos[5B] was AD is C0</wrap> <wrap>HHC01488I Codepage: Pos[5D] was BD is D0</wrap> <wrap>HHC01488I Codepage: Pos[7B] was C0 is AD</wrap> <wrap>HHC01488I Codepage: Pos[7D] was D0 is BD</wrap> |<WRAP><wrap>HHC00013I Herc command: 'cp_updt display</wrap> <wrap>HHC01484I Codepage: Displaying user table</wrap> </WRAP> |||<WRAP><wrap>ascii' \\ ascii/h2g</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01485I HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage: Codepage:</wrap> </WRAP> |<WRAP><wrap>_0_1_2_3 _4_5_6_7 0_ 00010203 372D2E2F</wrap> </WRAP> |<WRAP><wrap>_8_9_A_B _C_D_E_F 1605250B 0C0D0E0F</wrap> </WRAP> |<WRAP><wrap>0...</wrap> <wrap>....</wrap> </WRAP> |<WRAP><wrap>4...</wrap> <wrap>....</wrap> </WRAP> |<WRAP><wrap>8...</wrap> <wrap>....</wrap> </WRAP> |<WRAP><wrap>C...</wrap> <wrap>....</wrap> </WRAP> |<WRAP><wrap>0_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>1_ 10111213 3C3D3226</wrap> </WRAP> |<WRAP><wrap>18191A27 221D351F</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>1_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>2_ 405A7F7B 5B6C507D</wrap> </WRAP> |<WRAP><wrap>4D5D5C4E 6B604B61</wrap> </WRAP> |<WRAP><wrap>!"#</wrap> </WRAP> |<WRAP><wrap>$%&'</wrap> </WRAP> |<WRAP><wrap>()*+</wrap> </WRAP> |<WRAP><wrap>,-./</wrap> </WRAP> |<WRAP><wrap>2_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>3_ F0F1F2F3 F4F5F6F7</wrap> </WRAP> |<WRAP><wrap>F8F97A5E 4C7E6E6F</wrap> </WRAP> |<WRAP><wrap>0123</wrap> </WRAP> |<WRAP><wrap>4567</wrap> </WRAP> |<WRAP><wrap>89:;</wrap> </WRAP> |<WRAP><wrap><=>?</wrap> </WRAP> |<WRAP><wrap>3_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>4_ 7CC1C2C3 C4C5C6C7</wrap> </WRAP> |<WRAP><wrap>C8C9D1D2 D3D4D5D6</wrap> </WRAP> |<WRAP><wrap>@ABC</wrap> </WRAP> |<WRAP><wrap>DEFG</wrap> </WRAP> |<WRAP><wrap>HIJK</wrap> </WRAP> |<WRAP><wrap>LMNO</wrap> </WRAP> |<WRAP><wrap>4_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>5_ D7D8D9E2 E3E4E5E6</wrap> </WRAP> |<WRAP><wrap>E7E8E9C0 E0D05F6D</wrap> </WRAP> |<WRAP><wrap>PQRS</wrap> </WRAP> |<WRAP><wrap>TUVW XYZ{</wrap> </WRAP> ||<WRAP><wrap>%%\%%}^_</wrap> </WRAP> |<WRAP><wrap>5_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>6_ 79818283 84858687</wrap> </WRAP> |<WRAP><wrap>88899192 93949596</wrap> </WRAP> |<WRAP><wrap>`abc</wrap> </WRAP> |<WRAP><wrap>defg</wrap> </WRAP> |<WRAP><wrap>hijk</wrap> </WRAP> |<WRAP><wrap>lmno</wrap> </WRAP> |<WRAP><wrap>6_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>7_ 979899A2 A3A4A5A6</wrap> </WRAP> |<WRAP><wrap>A7A8A9AD 6ABDA107 pqrs</wrap> </WRAP> ||<WRAP><wrap>tuvw xyz[</wrap> </WRAP> ||<WRAP><wrap>|]~.</wrap> </WRAP> |<WRAP><wrap>7_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>8_ 68DC5142 43444748</wrap> </WRAP> |<WRAP><wrap>52535457 56586367</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>8_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>9_ 719C9ECB CCCDDBDD</wrap> </WRAP> |<WRAP><wrap>DFECFCB0 B1B2B3B4</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>9_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>A_ 4555CEDE 49690406</wrap> </WRAP> |<WRAP><wrap>AB08BAB8 B7AA8A8B</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>A_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>B_ 090A14BB 15B5B617</wrap> </WRAP> |<WRAP><wrap>1BB91C1E BC20BEBF</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>B_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>C_ 21232428 292A2B2C</wrap> </WRAP> |<WRAP><wrap>3031CA33 343638CF</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>C_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>D_ 393A3B3E 41464A4F</wrap> </WRAP> |<WRAP><wrap>5962DA64 65667072</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>D_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>E_ 73E17475 76777880</wrap> </WRAP> |<WRAP><wrap>8C8D8EEB 8FEDEEEF</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>E_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>F_ 909A9B9D 9FA0ACAE AFFDFEFB 3FEAFAFF</wrap> </WRAP> ||<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>F_</wrap> </WRAP> | |<WRAP><wrap>HHC00013I HHC01474I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'codepage user'</wrap> <wrap>Using 'internal' codepage conversion table 'user'</wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 79: CP_UPD command (alter ASCII user table)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 329</wrap> <wrap>\\ </wrap>**<wrap>Example 6:</wrap>** <wrap>Reset the internal user tables to binary zero.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'cp_updt reset' \\ HHC01479I Codepage 'user' is deleted</wrap> <wrap>HHC00013I Herc command: 'cp_updt display ascii'</wrap> |<WRAP><wrap>HHC01484I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>Displaying</wrap> </WRAP> ||<WRAP><wrap>user table</wrap> </WRAP> |<WRAP><wrap>ascii/h2g, table</wrap> </WRAP> ||<WRAP><wrap>is invalid</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01485I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>_0_1_2_3</wrap> </WRAP> |<WRAP><wrap>_4_5_6_7</wrap> </WRAP> |<WRAP><wrap>_8_9_A_B</wrap> </WRAP> |<WRAP><wrap>_C_D_E_F</wrap> </WRAP> |<WRAP><wrap>0...</wrap> </WRAP> |<WRAP><wrap>4...</wrap> </WRAP> |<WRAP><wrap>8...</wrap> </WRAP> |<WRAP><wrap>C...</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>0_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>0_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>1_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>1_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>2_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>2_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>3_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>3_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>4_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>4_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>5_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>5_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>6_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>6_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>7_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>7_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>8_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>8_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>9_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>9_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>A_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>A_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>B_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>B_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>C_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>C_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>D_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>D_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>E_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>E_</wrap> </WRAP> | |<WRAP><wrap>HHC01486I</wrap> </WRAP> |<WRAP><wrap>Codepage:</wrap> </WRAP> |<WRAP><wrap>F_</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>....</wrap> </WRAP> |<WRAP><wrap>F_</wrap> </WRAP> | **<wrap>Figure 80: CP_UPD command (reset user codepage tables)</wrap>** **<wrap>Example 7:</wrap>** <wrap>Test the internal user tables.</wrap> <wrap>HHC00013I Herc command: 'cp_updt test'</wrap> <wrap>HHC01487I Codepage: Testing user table ebcdic/g2h vs. ascii/h2g \\ HHC01491I Codepage: g2h pos[15] = 0A; h2g pos[0A] = 25 \\ HHC01491I Codepage: g2h pos[AD] = 5B; h2g pos[5B] = C0 \\ HHC01491I Codepage: g2h pos[BD] = 5D; h2g pos[5D] = D0 \\ HHC01491I Codepage: g2h pos[C0] = 7B; h2g pos[7B] = AD \\ HHC01491I Codepage: g2h pos[D0] = 7D; h2g pos[7D] = BD \\ HHC01487I Codepage: Testing user table ascii/h2g vs. ebcdic/g2h \\ HHC01492I Codepage: h2g pos[5B] = C0; g2h pos[C0] = 7B \\ HHC01492I Codepage: h2g pos[5D] = D0; g2h pos[D0] = 7D \\ HHC01492I Codepage: h2g pos[7B] = AD; g2h pos[AD] = 5B \\ HHC01492I Codepage: h2g pos[7D] = BD; g2h pos[BD] = 5D \\ HHC01492I Codepage: h2g pos[B4] = 15; g2h pos[15] = 0A</wrap> **<wrap>Figure 81: CP_UPD command (test user codepage tables)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 330</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.38 CPU (Define target CPU for console displays and commands) //8.38.1 Function//</wrap>** <wrap>The CPU command sets the target CPU for console displays and commands in a Hercules multi-CPU environment. If the Hercules configuration file sets a single CPU environment, then no CPU command is necessary. If the NUMCPU system parameter in the Hercules configuration file is set greater than one and no CPU command is given, then always the first CPU (CPU 0) is the target for console displays and commands.</wrap> <wrap>If a CPU address is given through the CPU command then this specifies the CPU to which all subsequent panel commands will apply to. If an optional command follows the CPU address, the command will execute on this CPU and the target CPU will not be permanently changed.</wrap> <wrap>For example entering command “CPU 0F” followed by command “GPR” will change the target CPU for panel displays and commands and then display the general purpose registers for CPU #15 whereas the command “CPU 0F GPR” will execute the GPR command on CPU #15, but will not change the target CPU for subsequent panel displays and commands.</wrap> <wrap>Please note that the command “//CPU 1 CPU 2//” does no change the target to CPU 2 as the last command (CPU 2) is issued under the temporary CPU 1 environment.</wrap> **//<wrap>8.38.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>CPU </wrap>//<wrap>hh </wrap>//<wrap>[</wrap>//<wrap>cmd</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CPU ¬¬¬ </wrap>//<wrap>hh</wrap>// //<wrap>cmd</wrap>// **//<wrap>8.38.3 Parameter</wrap>//** **//<wrap>hh </wrap>//**<wrap>The hexadecimal CPU address of the CPU in the multiprocessor configuration which you wish all console commands to apply to. For example, entering “CPU 0F” followed by a subsequent command “GPR” in a multi- CPU configuration will display the general purpose registers for CPU #15 in the configuration, as opposed to CPU #0. The CPU address is then permanently set to CPU #15, as long as no other CPU command is given.</wrap> **//<wrap>cmd </wrap>//**<wrap>This is the Hercules command that will execute on CPU //hh. //In this case the CPU address applies only for this command and is not permanently set to CPU //hh//.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 331</wrap> <wrap>\\ </wrap>**//<wrap>8.38.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the target address for subsequent Hercules commands to CPU #4 in a multiprocessor configuration and display the general purpose registers for this CPU.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'cpu 4' \\ HHC00013I Herc command: 'gpr'</wrap> <wrap>HHC02269I General purpose registers</wrap> |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP04:</wrap> </WRAP> |<WRAP><wrap>GR00=00000000</wrap> </WRAP> |<WRAP><wrap>GR01=062B7000</wrap> </WRAP> |<WRAP><wrap>GR02=0178F500</wrap> </WRAP> |<WRAP><wrap>GR03=040C1E18</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP04:</wrap> </WRAP> |<WRAP><wrap>GR04=00000000</wrap> </WRAP> |<WRAP><wrap>GR05=00000021</wrap> </WRAP> |<WRAP><wrap>GR06=00000000</wrap> </WRAP> |<WRAP><wrap>GR07=0146B847</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP04:</wrap> </WRAP> |<WRAP><wrap>GR08=00000000</wrap> </WRAP> |<WRAP><wrap>GR09=03EB0980</wrap> </WRAP> |<WRAP><wrap>GR10=00F67400</wrap> </WRAP> |<WRAP><wrap>GR11=04755D78</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP04:</wrap> </WRAP> |<WRAP><wrap>GR12=0146A848</wrap> </WRAP> |<WRAP><wrap>GR13=040C0390</wrap> </WRAP> |<WRAP><wrap>GR14=00000000</wrap> </WRAP> |<WRAP><wrap>GR15=00000336</wrap> </WRAP> | **<wrap>Figure 82: CPU command (set target CPU address permanently)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the target address temporarily to CPU #2 in a multiprocessor configuration and display the general purpose registers for this CPU.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'cpu 2 gpr' HHC02269I General purpose registers</wrap> |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP02:</wrap> </WRAP> |<WRAP><wrap>GR00=762DDDF8</wrap> </WRAP> |<WRAP><wrap>GR01=00010016</wrap> </WRAP> |<WRAP><wrap>GR02=00F52D28</wrap> </WRAP> |<WRAP><wrap>GR03=0428E294</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP02:</wrap> </WRAP> |<WRAP><wrap>GR04=00FACD80</wrap> </WRAP> |<WRAP><wrap>GR05=01175397</wrap> </WRAP> |<WRAP><wrap>GR06=0428EF58</wrap> </WRAP> |<WRAP><wrap>GR07=00F3C4B8</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP02:</wrap> </WRAP> |<WRAP><wrap>GR08=0428E268</wrap> </WRAP> |<WRAP><wrap>GR09=81174398</wrap> </WRAP> |<WRAP><wrap>GR10=0175F060</wrap> </WRAP> |<WRAP><wrap>GR11=00FD12C0</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP02:</wrap> </WRAP> |<WRAP><wrap>GR12=03FCD790</wrap> </WRAP> |<WRAP><wrap>GR13=0428E390</wrap> </WRAP> |<WRAP><wrap>GR14=8101250C</wrap> </WRAP> |<WRAP><wrap>GR15=811744F4</wrap> </WRAP> | **<wrap>Figure 83: CPU command (set target CPU address permanently)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 332</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.39 CPUIDFMT (Display or set format BASIC / 0 / 1 STIDP generation) //8.39.1 Function//</wrap>** <wrap>The CPUIDFMT command displays or sets the STORE CPU ID (STIDP) format bit. The default STIDP format, if not explicitly set, is 'BASIC'. The format bit of the STIDP information specifies the format of the first two digits of the CPU identification number. When the format bit is ‘0’ then the contents of the CPU identification number identifies the CPU. When the format bit is ‘1’ then the CPU identification number identifies the system configuration as opposed to an individual CPU in the configuration and it identifies the logical partition in which the program is executed.</wrap> <wrap>When the format is ‘BASIC’ the CPU identification number has the following hexadecimal format, where 'A' is the CPU address of the CPU.</wrap> <wrap>·<wrap></wrap></wrap><wrap>x'Annnnn' (Basic Mode)</wrap> <wrap>When the format is ‘0’ the CPU identification number has the following hexadecimal format where 'L' is a logical CPU address and 'P' is a logical partition identifier.</wrap> <wrap>·<wrap></wrap></wrap><wrap>x'LPnnnn' (LPAR mode)</wrap> <wrap>When the format is ‘1’ the CPU identification number has the following hexadecimal format where 'PP' is the user partition identifier (UPID). The UPID is an eight bit unsigned binary integer bound to a logical partition.</wrap> <wrap>·<wrap></wrap></wrap><wrap>x'PPnnnn' (LPAR mode)</wrap> <wrap>In all cases //n //is a digit derived from the serial number of the CPU.</wrap> <wrap>For more information on the STORE CPU ID (STIDP) instruction and the format bit see IBMs "z/Architec-ture Principles of Operation" manual.</wrap> **//<wrap>8.39.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap> |<WRAP>**<wrap>Descriptive</wrap>** </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>CPUIDFMT [BASIC |</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>1i</wrap> </WRAP> | |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>ÊÊ¬¬¬ </wrap><wrap>CPUIDFMT </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ BASIC ¬¬¬«</wrap> <wrap>ª¬</wrap><wrap>¬¬¬¬ </wrap><wrap>0 </wrap><wrap>¬¬¬¬¬«</wrap> <wrap>⡿¬</wrap><wrap>¬¬¬¬ 1 ¬¬¬</wrap><wrap>¬¬¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 333</wrap> <wrap>\\ </wrap>**//<wrap>8.39.3 Parameter</wrap>//** **<wrap>BASIC </wrap>**<wrap>Set the format to 'BASIC'. The STIDP format bit is set to ‘0’.</wrap> **<wrap>0 </wrap>**<wrap>Set the format to '0'. The STIDP format bit is set to ‘0’.</wrap> **<wrap>1 </wrap>**<wrap>Set the format to '1'. The STIDP format bit is set to ‘1’.</wrap> **//<wrap>8.39.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current STIDP format.</wrap> <wrap>HHC00013I Herc command: 'cpuidfmt' \\ HHC02203I Value 'CPUIDFMT': '0'</wrap> **<wrap>Figure 84: CPUIDFMT command (display current STIDP format)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set STIDP format to '1'.</wrap> <wrap>HHC00013I Herc command: 'cpuidfmt 1'</wrap> **<wrap>Figure 85: CPUIDFMT command (set STIDP format bit)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 334</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.40 CPUMODEL (Display or set CPU model number) \\ //8.40.1 Function//</wrap>** <wrap>The CPUMODEL command displays or sets the 4 hexadecimal digits CPU model number stored by the STIDP instruction.</wrap> **//<wrap>8.40.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CPUM0DEL </wrap><wrap>[</wrap>//<wrap>model</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>CPUM0DEL </wrap><wrap>¬</wrap> //<wrap>model</wrap>// **//<wrap>8.40.3 Parameter</wrap>//** **//<wrap>model </wrap>//**<wrap>Any valid 4 digit hexadecimal CPU model number. A list of the valid model numbers can be found in the Hercules Windows GUI file “cpu-types.txt”.</wrap> **//<wrap>8.40.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify a 7060 CPU model.</wrap> <wrap>HHC00013I Herc command: 'cpumodel'</wrap> <wrap>HHC02203I cpumodel : 7060</wrap> **<wrap>Figure 86: CPUMODEL command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 335</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.41 CPUPRIO (Display or set CPU thread process priority) //8.41.1 Function//</wrap>** <wrap>The CPUPRIO command is used to change the priority of the CPU thread. See section 5.82 for details on process and thread priorities. On multi-CPU systems a real CPU can be “dedicated” to Hercules by giving the CPU-thread a very high dispatching priority (-20). Given without an argument the CPUPRIO command displays the current CPU thread process priority.</wrap> **<wrap>Caution: </wrap>**<wrap>CPUPRIO should not have a higher dispatching priority than the TOD clock and timer thread.</wrap> **//<wrap>8.41.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>CPUPRI0 </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>CPUPRI0</wrap> //<wrap>nn</wrap>// **//<wrap>8.41.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This value specifies the priority for the CPU thread. For details on the priority values see section 5.82 (“Process and Thread Priorities”).</wrap> **//<wrap>8.41.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the CPU process priority to -20.</wrap> <wrap>HHC00013I Herc command: 'cpuprio -20'</wrap> <wrap>HHC02204I cpuprio set to -20</wrap> **<wrap>Figure 87: CPUPRIO command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 336</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.42 CPUSERIAL (Display or set CPU serial number) \\ //8.42.1 Function//</wrap>** <wrap>The CPUSERIAL command displays or sets the 6 hexadecimal digit CPU serial number stored by the STIDP instruction.</wrap> **//<wrap>8.42.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CPUSERIAL </wrap>//<wrap>serial</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>CPUSERIAL</wrap> //<wrap>serial</wrap>// **//<wrap>8.42.3 Parameter</wrap>//** **//<wrap>serial </wrap>//**<wrap>Any valid 6 digit hexadecimal CPU serial number. In BASIC mode, the high-order digit may be replaced with the processor number when MAXCPU is greater than one. In LPAR mode, the two high-order digits are replaced with either the LPAR number or the CPU number and LPAR number with the full serial number available via the STSI instruction. The default serial number is ‘000001’.</wrap> **//<wrap>8.42.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the CPU serial number to 001963.</wrap> <wrap>HHC00013I Herc command: 'cpuserial 001963'</wrap> <wrap>HHC02204I cpuserial set to 001963</wrap> **<wrap>Figure 88: CPUSERIAL command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 337</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.43 CPUVERID (CPU version code) \\ //8.43.1 Function//</wrap>** <wrap>The CPUVERID command displays or sets the 2 hexadecimal digit CPU version code stored by the STIDP instruction. The default version code is “FD” when ARCHMODE S/370 or ARCHMODE ESA/390 is specified. For the z/ARCH (or ESAME architecture mode respectively), the version code is always stored as “00” and any value specified here is ignored.</wrap> **//<wrap>8.43.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CPU</wrap><wrap>VERID </wrap>//<wrap>venid</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ CPUVERID ¬¬¬ </wrap>//<wrap>venid</wrap>// **//<wrap>8.43.3 Parameter</wrap>//** **//<wrap>verid </wrap>//**<wrap>Any valid 2 digit hexadecimal CPU version code. A list of valid version codes can be found in the Hercules Windows GUI file “cpu-types.txt”.</wrap> **//<wrap>8.43.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the CPU version code to FD.</wrap> <wrap>HHC00013I Herc command: 'cpuverid fd'</wrap> <wrap>HHC02204I cpuverid set to FD</wrap> **<wrap>Figure 89: CPUVERID command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 338</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.44 CR (Display or alter control registers) \\ //8.44.1 Function//</wrap>** <wrap>The CR command displays or alters the actual contents of the control registers.</wrap> **//<wrap>8.44.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>CR [</wrap>////<wrap>nn=xxxxxxxx </wrap>//<wrap>| </wrap>//<wrap>nn=xxxxxxxxxxxxxxxx</wrap>////<wrap>l</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ</wrap>////<wrap>¬¬¬ CR ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§ \\ </wrap>//<wrap>ª</wrap><wrap>ØØØØØØØ</wrap>//<wrap>nn=xxxxxxxx</wrap>////<wrap> ¬¬¬¬¬¬¬« \\ </wrap>//<wrap>⡿ØØØ</wrap>//<wrap>nn=xxxxxxxxxxxxxxxx </wrap>//<wrap>ØØØ</wrap> **//<wrap>8.44.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This specifies the optional register number (00-15) to be altered.</wrap> **//<wrap>xxxxxxxx </wrap>//**<wrap>This is the register value in hexadecimal (1-8 hex digits for 32-bit registers, 1-16 hex digits for 64-bit registers).</wrap> **//<wrap>8.44.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the control registers.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'cr'</wrap> |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>Control registers</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR00=5FB1EE40</wrap> </WRAP> |<WRAP><wrap>CR01=3FFFE07F</wrap> </WRAP> |<WRAP><wrap>CR02=3F149FC0</wrap> </WRAP> |<WRAP><wrap>CR03=00000001</wrap> </WRAP> | |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR04=00010001</wrap> </WRAP> |<WRAP><wrap>CR05=3FFE7040</wrap> </WRAP> |<WRAP><wrap>CR06=FE000000</wrap> </WRAP> |<WRAP><wrap>CR07=3FFFE07F</wrap> </WRAP> | |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR08=00000000</wrap> </WRAP> |<WRAP><wrap>CR09=00000000</wrap> </WRAP> |<WRAP><wrap>CR10=00000000</wrap> </WRAP> |<WRAP><wrap>CR11=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR12=01984E80</wrap> </WRAP> |<WRAP><wrap>CR13=3FFFE07F</wrap> </WRAP> |<WRAP><wrap>CR14=FF8BF15F</wrap> </WRAP> |<WRAP><wrap>CR15=03150010</wrap> </WRAP> | **<wrap>Figure 90: CR command (display control registers)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 339</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Alter control register number 15.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'cr 15=ffffffff'</wrap> |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>Control registers</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR00=5FB1EE40</wrap> </WRAP> |<WRAP><wrap>CR01=3FFFE07F</wrap> </WRAP> |<WRAP><wrap>CR02=3F149FC0</wrap> </WRAP> |<WRAP><wrap>CR03=00000001</wrap> </WRAP> | |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR04=00010001</wrap> </WRAP> |<WRAP><wrap>CR05=3FFE7040</wrap> </WRAP> |<WRAP><wrap>CR06=FE000000</wrap> </WRAP> |<WRAP><wrap>CR07=3FFFE07F</wrap> </WRAP> | |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR08=00000000</wrap> </WRAP> |<WRAP><wrap>CR09=00000000</wrap> </WRAP> |<WRAP><wrap>CR10=00000000</wrap> </WRAP> |<WRAP><wrap>CR11=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02271I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR12=01984E80</wrap> </WRAP> |<WRAP><wrap>CR13=3FFFE07F</wrap> </WRAP> |<WRAP><wrap>CR14=FF8BF15F</wrap> </WRAP> |<WRAP><wrap>CR15=FFFFFFFF</wrap> </WRAP> | **<wrap>Figure 91: CR command (alter control register)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 340</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.45 CSCRIPT (Cancel a running script thread) \\ //8.45.1 Function//</wrap>** <wrap>The CSCRIPT command cancels a currently running script or all scripts. If ‘*’ or ‘ALL’ is given as argument then all running scripts are cancelled. If no argument is given only the first running script is cancelled. To cancel a specific script, then ‘//id//’ can be given as argument, where ‘//id//‘ is the ID number of the script to be cancelled. The ‘SCRIPT’ command may be used to display a list of all currently running scripts. If no script is running, no action is taken.</wrap> **//<wrap>8.45.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CSCRIPT [* | ALL | </wrap>//<wrap>id</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬CSCRIPT¬¬¬</wrap><wrap>§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬¬</wrap><wrap>* ¬¬¬¬«</wrap> <wrap>ª¬¬¬</wrap><wrap>ALL ¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>id </wrap>//<wrap>¬¬¬¬¯</wrap> **//<wrap>8.45.3 Parameter</wrap>//** **//<wrap>id </wrap>//**<wrap>The thread id of the script to be cancelled.</wrap> **//<wrap>8.45.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Cancel the first running script, given the case that currently five scripts (IDs 2,3,4,5,and 6) are running.</wrap> <wrap>HHC00013I Herc command: 'cscript'</wrap> <wrap>HHC02259E Script 2 aborted: 'user cancel request'</wrap> <wrap>HHC00007I Previous message from function script_abort() at script.c[837]</wrap> <wrap>HHC02265I Script 2: file '</wrap>[[file:///D:/MVS/Conf/Script1.rc|<wrap>D:/MVS/Conf/Script1.rc</wrap>]]<wrap>' aborted due to previous conditions</wrap> **<wrap>Figure 92: CSCRIPT command (cancel first script)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 341</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Cancel the script with the ID number 4 from the remaining four running scripts.</wrap> <wrap>HHC00013I Herc command: 'cscript 4'</wrap> <wrap>HHC02259E Script 4 aborted: 'user cancel request'</wrap> <wrap>HHC00007I Previous message from function script_abort() at script.c[837]</wrap> <wrap>HHC02265I Script 4: file '</wrap>[[file:///D:/MVS/Conf/Script3.rc|<wrap>D:/MVS/Conf/Script3.rc</wrap>]]<wrap>' aborted due to previous conditions</wrap> **<wrap>Figure 93: CSCRIPT command (cancel script with ID)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Cancel all still running scripts (with IDs 3,5 and 6).</wrap> <wrap>HHC00013I Herc command: 'cscript all'</wrap> <wrap>HHC02259E Script 3 aborted: 'user cancel request'</wrap> <wrap>HHC00007I Previous message from function script_abort() at script.c[837]</wrap> <wrap>HHC02265I Script 3: file '</wrap>[[file:///D:/MVS/Conf/Script2.rc|<wrap>D:/MVS/Conf/Script2.rc</wrap>]]<wrap>' aborted due to previous conditions</wrap> <wrap>HHC02259E Script 5 aborted: 'user cancel request'</wrap> <wrap>HHC00007I Previous message from function script_abort() at script.c[837]</wrap> <wrap>HHC02265I Script 5: file '</wrap>[[file:///D:/MVS/Conf/Script4.rc|<wrap>D:/MVS/Conf/Script4.rc</wrap>]]<wrap>' aborted due to previous conditions</wrap> <wrap>HHC02259E Script 6 aborted: 'user cancel request'</wrap> <wrap>HHC00007I Previous message from function script_abort() at script.c[837]</wrap> <wrap>HHC02265I Script 6: file '</wrap>[[file:///D:/MVS/Conf/Script5.rc|<wrap>D:/MVS/Conf/Script5.rc</wrap>]]<wrap>' aborted due to previous conditions</wrap> **<wrap>Figure 94: CSCRIPT command (cancel all scripts)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 342</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.46 CTC (Enable / disable CTC debugging) \\ //8.46.1 Function//</wrap>** <wrap>The CTC command enables or disables the debug packet tracing for the specified CTCI / LCS / PTP device group(s) identified by //devnum //or for all CTCI / LCS / PTP device group(s) if //devnum //is not specified or specified as ‘ALL’.</wrap> **//<wrap>8.46.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>CTC DEBUG (ON | OFF} [//devnum //| </wrap>__<wrap>ALL</wrap>__<wrap>]</wrap>__<wrap></wrap>__ **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬ ALL ¬¬¬¬¬®</wrap> <wrap>ÊÊ%%__%%_CTC %%__%%_ DEBUG %%__%%_§%%__%%_ ON%%__%%%%__%%§%%__%%_¦%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%¦%%__%%%%__%%%%__%%%%__%%</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿%%__%%_ OFF %%__%%_¯ ⡿%%__%%_ //devnum //%%__%%_¯</wrap> **//<wrap>8.46.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>Enables the debug packet tracing.</wrap> **<wrap>OFF </wrap>**<wrap>Disables the debug packet tracing.</wrap> **//<wrap>devnum </wrap>//**<wrap>Specifies the CTCI / LCS / PTP device group(s) for which debug packet tracing has to be enabled or disabled.</wrap> **<wrap>ALL </wrap>**<wrap>Enables or disables the debug packet tracing for all CTCI / LCS / PTP device groups. 'ALL' is the default if no device group is specified.</wrap> **//<wrap>8.46.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Enable the debug packet tracing for all CTCI / LCS / PTP devices. Please note that not all hex columns can be displayed in the figure below. Missing columns have been marked with “∫∫”.</wrap> <wrap>HHC00013I Herc command: 'ctc debug on all'</wrap> <wrap>HHC02204I CTC debug set to on ALL</wrap> <wrap>HHC00910I 0:0E20 CTC: sending packet to device 'tun0'</wrap> <wrap>HHC00964I CTC: packet trace: +0000< 4500011C ∫∫ C0A80063 E....X..@......c ....... 7M{y..</wrap> <wrap>HHC00964I CTC: </wrap><wrap>packet trace: +0010< C0A80001 ∫∫ C6E342A9 .... y.U|....B. {y....`..@..FT.z</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 343</wrap> <wrap>\\ </wrap> |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0020< 54C02001</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>31617437</wrap> </WRAP> |<WRAP><wrap>T. __ ' __1at7</wrap> </WRAP> |<WRAP><wrap>.{.....x.7.1./..</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0030< 7514C6E1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>01B5DE57</wrap> </WRAP> |<WRAP><wrap>u...'...=.3.. W</wrap> </WRAP> |<WRAP><wrap>..</wrap><wrap>F....G...J....</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0040< 4B1821C1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>18C5E477</wrap> </WRAP> |<WRAP><wrap>K.!..P..p.... w</wrap> </WRAP> |<WRAP><wrap>...A.&.X.....EU.</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0050< 681A40A1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>42220697</wrap> </WRAP> |<WRAP><wrap>h.@ __Q__.B"..</wrap> </WRAP> |<WRAP><wrap>.. ~.i...1.j...p</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0060< 47DEA381</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>52CAC4B7</wrap> </WRAP> |<WRAP><wrap>G...i.j'Wy&qR...</wrap> </WRAP> |<WRAP><wrap>..ta.{|..`....D.</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0070< 7E38CA61</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>0B309ED7</wrap> </WRAP> |<WRAP><wrap>~8.aBn.Gnf.Q.0..</wrap> </WRAP> |<WRAP><wrap>=../.>w.>."....P</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0080< 250C3541</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>393414F7</wrap> </WRAP> |<WRAP><wrap>%.5AD|>g8..194. </wrap> </WRAP> |<WRAP><wrap>@ U 7</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0090< 0A4C6421</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>1A25A717</wrap> </WRAP> |<WRAP><wrap>.Ld!.A..D/...%..</wrap> </WRAP> |<WRAP><wrap>.<.....g..]...x.</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+00A0< 1DFCD701</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>7CC5D537</wrap> </WRAP> |<WRAP><wrap>....B...N...|..7</wrap> </WRAP> |<WRAP><wrap>..P..gbx+k~1@EN.</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+00B0< 20310DE1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>23451F57</wrap> </WRAP> |<WRAP><wrap>1..t....i..#E.W</wrap> </WRAP> |<WRAP><wrap>.....f.G..</wrap><wrap>.J....</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+00C0< 0F0C88C1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>65440577</wrap> </WRAP> |<WRAP><wrap>......6.c.w.eD.w</wrap> </WRAP> |<WRAP><wrap>..hA"W.X</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+00D0< 54C2C7A1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>11D30797</wrap> </WRAP> |<WRAP><wrap>T__ ? ]__.h.... ____</wrap> </WRAP> |<WRAP><wrap>BG~.{..)..j.L.p</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+00E0< 35974A81</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>1172A5B7</wrap> </WRAP> |<WRAP><wrap>5.J._.['.$]q.r..</wrap> </WRAP> |<WRAP><wrap>.p.a^.$...)...v.</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+00F0< 7DDD9161</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>48135FD7</wrap> </WRAP> |<WRAP><wrap>}..a]swGG..QH._.</wrap> </WRAP> |<WRAP><wrap>'.j/).....O...^P</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0100< 6FF91C41</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>3715B5F7</wrap> </WRAP> |<WRAP><wrap>o..AK..g.@S17...</wrap> </WRAP> |<WRAP><wrap>?9...[... .....7</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0110< 725D6B21</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>r]k!S$C.q.T. .),....g....</wrap> </WRAP> | | |<WRAP><wrap>HHC00913I</wrap> </WRAP> |<WRAP><wrap>0:0E20 CTC:</wrap> </WRAP> ||<WRAP><wrap>received 284 bytes size</wrap> </WRAP> ||<WRAP><wrap>packet from device 'tun0'</wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0000> 4500011C</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>C0A80001</wrap> </WRAP> |<WRAP><wrap>E __@__.Ih....</wrap> </WRAP> |<WRAP><wrap>.....D.. ...{y..</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+</wrap><wrap>0010> C0A80063</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>C6E342A9</wrap> </WRAP> |<WRAP><wrap>...c....U|....B.</wrap> </WRAP> |<WRAP><wrap>{y....a..@..FT.z</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0020> 54C02001</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>31617437</wrap> </WRAP> |<WRAP><wrap>T. __ ' __1at7</wrap> </WRAP> |<WRAP><wrap>.{.....x.7.1./..</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0030> 7514C6E1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>01B5DE57</wrap> </WRAP> |<WRAP><wrap>u...'...=.3....W</wrap> </WRAP> |<WRAP><wrap>..F....G...J....</wrap> </WRAP> | |<WRAP><wrap>H</wrap><wrap>HC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0040> 4B1821C1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>18C5E477</wrap> </WRAP> |<WRAP><wrap>K.!..P..p.... w</wrap> </WRAP> |<WRAP><wrap>...A.&.X.....EU.</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0050> 681A40A1</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>42220697</wrap> </WRAP> |<WRAP><wrap>h.@ __Q__.B"..</wrap> </WRAP> |<WRAP><wrap>.. ~.i...1.j...p</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0060> 47DEA381</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>52CAC4B7</wrap> </WRAP> |<WRAP><wrap>G...i.j</wrap><wrap>'Wy&qR...</wrap> </WRAP> |<WRAP><wrap>..ta.{|..`....D.</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0070> 7E38CA61</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>0B309ED7</wrap> </WRAP> |<WRAP><wrap>~8.aBn.Gnf.Q.0..</wrap> </WRAP> |<WRAP><wrap>=../.>w.>."....P</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0080> 250C3541</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>393414F7</wrap> </WRAP> |<WRAP><wrap>%.5AD|>g8..194. </wrap> </WRAP> |<WRAP><wrap>@ U 7</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+0090> 0A</wrap><wrap>4C6421</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>1A25A717</wrap> </WRAP> |<WRAP><wrap>.Ld!.A..D/...%..</wrap> </WRAP> |<WRAP><wrap>.<.....g..]...x.</wrap> </WRAP> | |<WRAP><wrap>HHC00964I</wrap> </WRAP> |<WRAP><wrap>CTC:</wrap> </WRAP> |<WRAP><wrap>packet</wrap> </WRAP> |<WRAP><wrap>trace:</wrap> </WRAP> |<WRAP><wrap>+00A0> 1DFCD701</wrap> </WRAP> |<WRAP><wrap>∫∫</wrap> </WRAP> |<WRAP><wrap>7CC5D537</wrap> </WRAP> |<WRAP><wrap>....B...N...|..7</wrap> </WRAP> |<WRAP><wrap>..P..gbx+k~1@EN.</wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 95: CTC command (enable debug packet tracing)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Disable the debug packet tracing.</wrap> <wrap>HHC00013I Herc command: 'ctc debug off'</wrap> <wrap>HHC02204I CTC debug set to off</wrap> **<wrap>Figure 96: CTC command (disable debug packet tracing)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 344</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.47 DEFINE (Rename device) \\ //8.47.1 Function//</wrap>** <wrap>The DEFINE command can be used to “rename” a device (change the device number).</wrap> **//<wrap>8.47.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>DEFINE </wrap>//<wrap>olddevice newdevice</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ DEFINE ¬¬¬ </wrap>//<wrap>olddevice </wrap>////<wrap>¬¬¬ </wrap>////<wrap>newdevice</wrap>// **//<wrap>8.47.3 Parameter</wrap>//** **//<wrap>olddevice </wrap>//**<wrap>The device number of the device that has to be renamed.</wrap> **//<wrap>newdevice </wrap>//**<wrap>The new device number, to which the device should now be attached.</wrap> **//<wrap>8.47.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Rename two devices.</wrap> |<WRAP><wrap>HHC00013I Herc command: 'define 00c5 00c6' HHC00013I Herc command: 'define 0481 0482'</wrap> </WRAP> | **<wrap>Figure 97: DEFINE command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 345</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.48 DEFSTORE (Display or define main and expanded storage values)</wrap>** **//<wrap>8.48.1 Function</wrap>//** <wrap>The DEFSTORE command is used to specify the size of the main and expanded storage. Given without an argument the DEFSTORE command displays the current size of the main and expanded storage. If only the type of storage is given, the current storage size of this type is displayed. Storage is allocated in megabytes, unless a specific unit is specified. The actual upper limit of the main and expanded storage is determined by the host system's architecture, operating system, and on some systems the amount of physical memory and paging space you have available.</wrap> <wrap>The practical limit depends on the maximum amount of storage that can be obtained by the “malloc” function (usually around 1 GB on 32-bit platforms; on 64-bit platforms the value should only be limited by available paging space).</wrap> <wrap>When increasing the storage size Hercules attempts to allocate first the new storage. If the new allocation is successful then the previously allocated memory will be freed. This is to prevent a situation where the old memory is freed first, then the new allocation fails and a reallocation of the memory in the previous size also fails because of storage fragmentation and therefore leaving Hercules without memory.</wrap> <wrap>When decreasing the storage the memory will stay allocated in the previous size but the storage size will appear as decreased. Subsequent increases will not reallocate memory unless they go over the already allocated amount.</wrap> <wrap>An additional optional argument determines the locking state of the allocated memory (page lock by host operating system). The LOCKED option indicates that the memory is to be locked into storage while UNLOCKED (the default) indicates that the memory is not locked into the storage.</wrap> <wrap>Please note that Hercules preserves the last locking state of DEFSTORE for each type of storage. Once the storage is locked, any subsequent change to the storage size will honor the existing lock state of memory unless the lock state is specified again on the DEFSTORE command.</wrap> **<wrap>Caution: </wrap>**<wrap>Do not lock storage unless sufficient real memory is available to back up the request. Failure to do so may require the host system to be rebooted.</wrap> **//<wrap>8.48.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>DEFSTORE [MAIN [//msize[//B | K | M | G | T | P |E//] [//</wrap>__<wrap>UNLOCK</wrap>__<wrap> | LOCK]]] [{XSTOR | EXPANDED} [//xsize[//M | G | T//] [//</wrap>__<wrap>UNLOCK</wrap>__<wrap> | LOCK]]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬DEFSTORE</wrap> //<wrap>storagetype</wrap>// <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 346</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap> |<WRAP>**<wrap>ª¬¬¬ MAIN</wrap>** </WRAP> |<WRAP>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬</wrap>**<wrap>¬¬¬¬¬¬¬¬¬¬¬Ê </wrap>**<wrap> </wrap>**<wrap>~¬¬¬ </wrap>**<wrap>M </wrap>**<wrap>¬¬¬® </wrap>**<wrap>~¬ ¬¬UNLOCK ¬¬¬® </wrap>** **<wrap>⡿¬¬¬</wrap>**//<wrap>msize </wrap>//<wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬</wrap>**<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¯</wrap>** **<wrap>ª</wrap>**<wrap>¬¬¬ </wrap>**<wrap>B </wrap>**<wrap>¬¬¬« </wrap>**<wrap>⡿¬¬¬¬ LOCK ¬¬¬¬¯</wrap>** **<wrap>ª¬¬¬K ¬¬¬« \\ ª¬¬¬G ¬¬¬« \\ ª¬¬¬T ¬¬¬« \\ ª¬¬¬P ¬¬¬« \\ ⡿¬¬¬E ¬¬¬¯</wrap>** </WRAP> | <wrap>Ê</wrap>**<wrap>¬¬¬§¬¬¬XSTOR¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬</wrap>**<wrap>¬¬¬¬« </wrap>**<wrap>⡿¬¬¬</wrap>** **<wrap>%%__%%%%__%%_ EXPANDED ¬¬¬¯ </wrap>**<wrap>~¬¬¬ </wrap>**<wrap>M </wrap>**<wrap>¬¬¬® </wrap>**<wrap>~¬ ¬¬ UNLOCK ¬¬¬® \\ ⡿¬¬¬</wrap>**//<wrap>xsize </wrap>//<wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬</wrap>**<wrap>¯</wrap>** **<wrap>ª</wrap>**<wrap>¬¬¬ </wrap>**<wrap>G </wrap>**<wrap>¬¬¬« </wrap>**<wrap>⡿¬¬¬¬ LOCK ¬¬¬¬¯ ⡿¬¬¬T ¬¬¬¯</wrap>** **//<wrap>8.48.3 Parameter</wrap>//** **//<wrap>msize </wrap>//**<wrap>The value of //msize //must be a valid decimal number. The actual upper limit is determined by the host system's architecture, the operating system and on some systems the amount of physical memory and paging space that is available.</wrap> <wrap>For storage sizes less than 16M, sizes not on a 4K boundary are rounded up to the next 4K boundary. Otherwise, storage sizes not on a 1M boundary are rounded up to the next 1M boundary.</wrap> <wrap>The minimum size is 4K for architecture levels ALS0 and ALS1 (S/370 and ESA/390), and 8K for architecture level ALS2 (ESAME) and higher. A maximum of 64M may be specified for architecture level ALS0 (S/370), 2048M (2G) for ALS1 (ESA/390) and 16E for architecture level ALS2 (ESAME) and higher.</wrap> <wrap>The default on startup is 2M.</wrap> **//<wrap>xsize </wrap>//**<wrap>The value of //xsize //must be a valid decimal number. The actual upper limit is determined by the host system’s architecture, the operating system and on some systems the amount of physical memory and paging space that is available.</wrap> <wrap>Storage sizes not on a 1M boundary are rounded up to the next 1M boundary. The lower limit and default is 0.</wrap> **<wrap>B </wrap>**<wrap>‘B’ determines that the number given is specified in bytes (no multiplier). Specifying the storage in bytes is possible only for main storage.</wrap> **<wrap>K </wrap>**<wrap>‘K’ determines that the number given is specified in kilobytes (multiplier 2%%**%%10).</wrap> <wrap>Specifying the storage in kilobytes is possible only for main storage.</wrap> **<wrap>M </wrap>**<wrap>‘M’ determines that the number given is specified in megabytes (multiplier 2%%**%%20). This is the default if no unit is appended.</wrap> **<wrap>G </wrap>**<wrap>‘G’ determines that the number given is specified in gigabytes (multiplier 2%%**%%30).</wrap> **<wrap>T </wrap>**<wrap>‘T’ determines that the number given is specified in terabytes (multiplier 2%%**%%40). On 32-bit machines the unit terabytes is not available.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 347</wrap> <wrap>\\ </wrap>**<wrap>P </wrap>**<wrap>‘P’ determines that the number given is specified in petabytes (multiplier 2%%**%%50). Specifying the storage in petabytes is possible only for main storage. On 32-bit machines the unit petabytes is not available.</wrap> **<wrap>E </wrap>**<wrap>‘E’ determines that the number given is specified in exabytes (multiplier 2%%**%%60). Specifying the storage in exabytes is possible only for main storage. On 32-bit machines the unit exabytes is not available.</wrap> **<wrap>LOCK </wrap>**<wrap>Attempt to lock the storage (pages locked by the host operating system).</wrap> **<wrap>UNLOCK </wrap>**<wrap>Leave the store unlocked (no pages locked by the host operating system, pageable by host OS). This is the default.</wrap> **<wrap>Notes:</wrap>** <wrap>The actual upper limit is determined by the host system’s architecture and operating system and the amount of physical memory and available paging space. The total of MAINSIZE and XPNDSIZE on host systems with a 32-bit architecture will be limited to 4G; host systems with a 64-bit architecture will be limited to less than 16E.</wrap> <wrap>Using minimum storage sizes, storage sizes less than or not on a 64K boundary for architecture level ALS0 (S/370) or not on a 1M boundary for architecture level ALS1 (ESA/390) and higher, it may be possible to generate error conditions not covered by the “Principles of Operations”.</wrap> <wrap>Use of storage sizes greater than supported by the guest operating system may generate incorrect results or error conditions within the guest operating system.</wrap> **//<wrap>8.48.4 Overview Storage Allocation Units</wrap>//** |<WRAP>**<wrap>Unit</wrap>** </WRAP> |<WRAP>**<wrap>Multiplier</wrap>** </WRAP> |<WRAP>**<wrap>Name (Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>IEC Name (IEC Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>Restrictions</wrap>** </WRAP> | |<WRAP><wrap>B</wrap> </WRAP> |<WRAP><wrap>None</wrap> </WRAP> |<WRAP><wrap>Byte (B)</wrap> </WRAP> |<WRAP><wrap>Byte (B)</wrap> </WRAP> |<WRAP><wrap>Main storage only</wrap> </WRAP> | |<WRAP><wrap>K</wrap> </WRAP> |<WRAP><wrap>2%%**%%10</wrap> </WRAP> |<WRAP><wrap>Kilobyte (kB)</wrap> </WRAP> |<WRAP><wrap>Kibibyte (KiB)</wrap> </WRAP> |<WRAP><wrap>Main storage only</wrap> </WRAP> | |<WRAP><wrap>M</wrap> </WRAP> |<WRAP><wrap>2%%**%%20</wrap> </WRAP> |<WRAP><wrap>Megabyte (MB)</wrap> </WRAP> |<WRAP><wrap>Mebibyte (MiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>G</wrap> </WRAP> |<WRAP><wrap>2%%**%%30</wrap> </WRAP> |<WRAP><wrap>Gigabyte (GB)</wrap> </WRAP> |<WRAP><wrap>Gibibyte (GiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>T</wrap> </WRAP> |<WRAP><wrap>2%%**%%40</wrap> </WRAP> |<WRAP><wrap>Terabyte (TB)</wrap> </WRAP> |<WRAP><wrap>Tebibyte (TiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | |<WRAP><wrap>P</wrap> </WRAP> |<WRAP><wrap>2%%**%%50</wrap> </WRAP> |<WRAP><wrap>Petabyte (PB)</wrap> </WRAP> |<WRAP><wrap>Pebibyte (PiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | |<WRAP><wrap>E</wrap> </WRAP> |<WRAP><wrap>2*60</wrap> </WRAP> |<WRAP><wrap>Exabyte (EB)</wrap> </WRAP> |<WRAP><wrap>Exbibyte (EiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | **<wrap>Table 19: Storage Allocation Units</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 348</wrap> <wrap>\\ </wrap>**//<wrap>8.48.5 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current size of the main and expanded storage.</wrap> <wrap><wrap>{{hercules:userref:bf:image062.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image062.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap>HHC00013I Herc command: 'defstore'</wrap> <wrap>HHC17003I MAIN storage is 256 M (mainsize); storage is not locked HHC17003I EXPANDED storage is 256 M (xpndsize); storage is not locked</wrap> **<wrap>Figure 98: MAINSIZE command (display size of main and expanded storage)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Display the current size of the main storage.</wrap> <wrap>HHC00013I Herc command: 'defstore main'</wrap> <wrap>HHC17003I MAIN storage is 256 M (mainsize); storage is not locked</wrap> **<wrap>Figure 99: MAINSIZE command (display size of main storage)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the size of the main storage to 512 MB. Lock the storage into the memory.</wrap> <wrap>HHC00013I Herc command: 'defstore main 512 lock' \\ HHC01428I Locking main storage</wrap> <wrap>HHC17003I MAIN storage is 512 M (mainsize); storage is locked</wrap> **<wrap>Figure 100: MAINSIZE command (Set size of locked main storage)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Set the size of the main and expanded storage to 512 MB each. Lock the main storage into the memory, but do not lock the expanded storage.</wrap> <wrap>HHC00013I Herc command: 'defstore main 512M lock xstor 512M unlock' \\ HHC01428I Locking main storage</wrap> <wrap>HHC17003I MAIN storage is 512 M (mainsize); storage is locked \\ HHC17003I EXPANDED storage is 512 M (xpndsize); storage is not locked</wrap> **<wrap>Figure 101: MAINSIZE command (Set size of main and expanded storage)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 349</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.49 DEFSYM (Define a symbol) \\ //8.49.1 Function//</wrap>** <wrap>The DEFSYM command defines symbol ‘//symbol’ //as to contain value ‘//value’//. The symbol can then be the object of a substitution for later panel commands. If the //value //contains blanks or spaces then it must be enclosed within quotes or apostrophes. See chapter “Symbol Substitutions” for a more in-depth discussion on this feature.</wrap> **//<wrap>8.49.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>DEFSYM [</wrap>//<wrap>symbol </wrap>//<wrap>[</wrap>//<wrap>value</wrap>//<wrap>]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** |<WRAP><wrap>ÊÊ%%__%%_DEFSYM</wrap> </WRAP> |<WRAP><wrap>%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%%%__%%%%__%%%%__%%%%__%%_</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿%%__%%_ </wrap>//<wrap>symbol </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%_ </wrap>//<wrap>value </wrap>//<wrap>%%__%%_¯</wrap> </WRAP> | **//<wrap>8.49.3 Parameter</wrap>//** **//<wrap>symbol </wrap>//**<wrap>The name of a symbol. If no symbol name (and optionally a value) is given then all previously defined symbols are listed.</wrap> **//<wrap>value </wrap>//**<wrap>The value that is assigned to the symbol. If the value is omitted then the previously defined symbol is cleared, the symbol itself is not deleted.</wrap> **//<wrap>8.49.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>List all defined symbols.</wrap> <wrap>HHC00013I Herc command: 'defsym'</wrap> <wrap>HHC02199I Symbol VERSION '3.0.7.6879'</wrap> <wrap>HHC02199I Symbol BDATE 'Oct 12 2010'</wrap> <wrap>HHC02199I Symbol BTIME '18:23:14'</wrap> <wrap>HHC02199I Symbol HOSTNAME 'GOOFY'</wrap> <wrap>HHC02199I Symbol HOSTOS 'Windows'</wrap> <wrap>HHC02199I Symbol HOSTOSREL '6.1.7600'</wrap> <wrap>HHC02199I Symbol HOSTOSVER 'NT '</wrap> <wrap>HHC02199I Symbol HOSTARCH 'i686'</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 350</wrap> <wrap>\\ </wrap><wrap>HHC02199I Symbol HOSTNUMCPUS 'MP=8'</wrap> <wrap>HHC02199I Symbol MODNAME 'hercules.exe'</wrap> <wrap>HHC02199I Symbol MODPATH '</wrap>[[file:///D:/Hercules/|<wrap>D:%%\%%Hercules%%\%%</wrap>]]<wrap>'</wrap> <wrap>HHC02199I Symbol PF01 'SUBST IMMED herc help &0'</wrap> <wrap>HHC02199I Symbol PF11 'IMMED herc devlist TAPE'</wrap> <wrap>HHC02199I Symbol PF10 'SUBST DELAY herc devinit &*'</wrap> <wrap>HHC02199I Symbol CUU '$(CUU)'</wrap> <wrap>HHC02199I Symbol CCUU '$(CCUU)'</wrap> <wrap>HHC02199I Symbol DASDPATH '</wrap>[[file:///D:/MVS/DASD|<wrap>D:/MVS/DASD</wrap>]]<wrap>'</wrap> <wrap>HHC02199I Symbol READERPATH '</wrap>[[file:///D:/MVS/READER|<wrap>D:/MVS/READER</wrap>]]<wrap>'</wrap> <wrap>HHC02199I Symbol PRINTPATH '</wrap>[[file:///D:/MVS/PRINTER|<wrap>D:/MVS/PRINTER</wrap>]]<wrap>'</wrap> <wrap>HHC02199I Symbol PUNCHPATH '</wrap>[[file:///D:/MVS/PUNCH|<wrap>D:/MVS/PUNCH</wrap>]]<wrap>'</wrap> <wrap>HHC02199I Symbol CSS '0'</wrap> <wrap>HHC02199I Symbol SUBCHAN '0008'</wrap> **<wrap>Figure 102: DEFSYM command (list all symbols)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Define new symbol (and list the symbols afterwards).</wrap> <wrap>HHC00013I Herc command: 'defsym TAPEDIR "</wrap>[[file:///D:/MVS/TAPE|<wrap>D:%%\%%MVS%%\%%TAPE</wrap>]]<wrap>"' \\ HHC00013I Herc command: 'defsym'</wrap> <wrap>HHC02199I Symbol VERSION '3.0.7.6879'</wrap> <wrap>HHC02199I Symbol BDATE 'Oct 12 2010'</wrap> <wrap>HHC02199I Symbol BTIME '18:23:14'</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC02199I Symbol SUBCHAN '0008'</wrap> <wrap>HHC02199I Symbol TAPEDIR '</wrap>[[file:///D:/MVS/TAPE|<wrap>D:%%\%%MVS%%\%%TAPE</wrap>]]<wrap>'</wrap> **<wrap>Figure 103: DEFSYM command (define new symbol)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Clear defined symbol (and list the symbols afterwards).</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'defsym TAPEDIR' \\ HHC00013I Herc command: 'defsym'</wrap> <wrap>HHC02199I Symbol VERSION '3.0.7.6879'</wrap> <wrap>HHC02199I Symbol BDATE 'Oct 12 2010'</wrap> <wrap>HHC02199I Symbol BTIME '18:23:14'</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC02199I Symbol SUBCHAN '0008'</wrap> <wrap>HHC02199I Symbol TAPEDIR ''</wrap> **<wrap>Figure 104: DEFSYM command (clear defined symbol)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 351</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.50 DELSYM (Delete a symbol) \\ //8.50.1 Function//</wrap>** <wrap>The DELSYM command deletes a symbol. Please note that the “DELSYM //symbol//” command actually deletes the symbol while the “DEFSYM //symbol//” command (without a given value) clears the symbol, but does not delete it.</wrap> **//<wrap>8.50.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>DE</wrap><wrap>L</wrap><wrap>SYM </wrap>//<wrap>symbol</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ DE</wrap><wrap>L</wrap><wrap>SYM ¬¬¬ </wrap>//<wrap>symbol</wrap>// **//<wrap>8.50.3 Parameter</wrap>//** **//<wrap>symbol </wrap>//**<wrap>This is the name of the symbol to be deleted.</wrap> **//<wrap>8.50.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Delete symbol TAPEDIR.</wrap> <wrap>02:24:08 HHC00013I Herc command: 'delsym TAPEDIR'</wrap> **<wrap>Figure 105: DELSYM command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 352</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.51 DETACH (Remove device) \\ //8.51.1 Function//</wrap>** <wrap>The DETACH command removes a device from the current configuration. The effect of this command is immediately visible in the device display of the Hercules Windows GUI and the Hercules “Peripherals” display.</wrap> **//<wrap>8.51.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>****<wrap>DETACH </wrap>****//<wrap>device</wrap>//** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ DETACH ¬¬¬ </wrap>****//<wrap>device</wrap>//** **//<wrap>8.51.3 Parameter</wrap>//** **//<wrap>device </wrap>//**<wrap>The device number of the device that is to be removed from the current configuration.</wrap> **//<wrap>8.51.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Detach device 000F from the active configuration.</wrap> <wrap>HHC00013I Herc command: 'detach 000f' \\ HHC01465I 0:000F device detached</wrap> **<wrap>Figure 106: DETACH command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 353</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.52 DEVINIT (Reinitialize device) \\ //8.52.1 Function//</wrap>** <wrap>The DEVINIT command can be used to reopen an existing device. The arguments (if any) override the arguments specified in the configuration file for this device. If no arguments (beneath the device number) are given, then the DEVINIT command will reinitialise the device with the same arguments that were previously specified. The device type cannot be changed and must not be specified.</wrap> <wrap>This command can be used to rewind a tape, to mount a new tape or disk image file on an existing device, to load a new card deck into a reader, or to close and reopen a printer or punch device.</wrap> **//<wrap>8.52.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>DEVINIT </wrap>//<wrap>devnum </wrap>//<wrap>[</wrap>//<wrap>argument </wrap>//<wrap>[</wrap>//<wrap>argument </wrap>//<wrap>... ]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬DEVINIT ¬¬¬ </wrap>//<wrap>devnum </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap> ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® \\ ⡿¬¬¬°¬¬¬</wrap>//<wrap>argument </wrap>//<wrap>¬¬¬¨¬¬¬¯</wrap> **//<wrap>8.52.3 Parameter</wrap>//** **//<wrap>devnum </wrap>//**<wrap>The device number of the device to be reinitialized.</wrap> **//<wrap>argument </wrap>//**<wrap>Any arguments that are acceptable for the kind of device being reinitalized.</wrap> **//<wrap>8.52.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Initialize a tape device.</wrap> |<WRAP><wrap>HHC00013I Herc command: 'devinit 0480 </wrap>[[file:///D:/MVS/TAPE/RPF142.HET|<wrap>D:/MVS/TAPE/RPF142.HET</wrap>]]<wrap> compress=1 method=1 level=4' HHC00221I 0:0480 Tape file '</wrap>[[file:///D:/MVS/TAPE/RPF142.HET|<wrap>D:/MVS/TAPE/RPF142.HET</wrap>]]<wrap>', type 'het': format type 'HET file' HHC00222I 0:0480 Tape file '</wrap>[[file:///D:/MVS/TAPE/RPF142.HET|<wrap>D:/MVS/TAPE/RPF142.HET</wrap>]]<wrap>', type 'het': option 'compress' accepted HHC00222I 0:0480 Tape file '</wrap>[[file:///D:/MVS/TAPE/RPF142.HET|<wrap>D:/MVS/TAPE/RPF142.HET</wrap>]]<wrap>', type 'het': option 'method' accepted HHC00222I 0:0480 Tape file '</wrap>[[file:///D:/MVS/TAPE/RPF142.HET|<wrap>D:/MVS/TAPE/RPF142.HET</wrap>]]<wrap>', type 'het': option 'level' accepted HHC02245I 0:0480 device initialized</wrap> </WRAP> | **<wrap>Figure 107: DEVINIT command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 354</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.53 DEVLIST (List device, device class or all devices) //8.53.1 Function//</wrap>** <wrap>The DEVLIST command lists devices that are defined in the active Hercules configuration and displays their current status. Depending on the given argument DEVLIST shows information about one device only (when //devnum //is specified) or about all devices of a certain device class (when //devclass //is specified). Without an argument DEVLIST displays information about all defined devices.</wrap> **//<wrap>8.53.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>DEVLIST </wrap><wrap>[</wrap>//<wrap>devnum </wrap>//<wrap>| </wrap>//<wrap>devclass</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>DEVLIST </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬</wrap> <wrap>ª¬</wrap><wrap>¬¬¬ </wrap>//<wrap>devnum \\ </wrap>//<wrap>⡿¬¬¬</wrap>//<wrap>devclass</wrap>// **//<wrap>8.53.3 Parameter</wrap>//** **//<wrap>devnum </wrap>//**<wrap>This specifies the device number of the device for which the status has to be displayed.</wrap> **//<wrap>devclass </wrap>//**<wrap>This specifies the device class for which DEVLIST has to display the status information.</wrap> <wrap>Valid device classes are:</wrap> <wrap>CON (Console devices)</wrap> <wrap>CTCA (Channel-to-channel adapter)</wrap> <wrap>DASD (Disk devices)</wrap> <wrap>DSP (Terminals)</wrap> <wrap>LINE (Communication lines)</wrap> <wrap>PCH (Card punch devices)</wrap> <wrap>PRT (Printer devices) \\ QETH (QETH devices)</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 355</wrap> <wrap>\\ </wrap>**//<wrap>8.53.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>List all devices of the current configuration.</wrap> {{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image069.gif|}}{{hercules:userref:bf:image070.gif|}}{{hercules:userref:bf:image071.gif|}}{{hercules:userref:bf:image070.gif|}}{{hercules:userref:bf:image072.gif|}}{{hercules:userref:bf:image072.gif|}}**<wrap>Figure 108: DEVLIST command (list all devices)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 356</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>List all devices of class DSP (display).</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'devlist dsp'</wrap> |<WRAP><wrap>HHC02279I</wrap> </WRAP> |<WRAP><wrap>0:0010</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>192.168.0.101 IO[173] open</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02279I</wrap> </WRAP> |<WRAP><wrap>0:0011</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>192.168.0.101 IO[61] open</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02279I</wrap> </WRAP> |<WRAP><wrap>0:00C0</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>192.168.0.101 IO[1] open</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02279I</wrap> </WRAP> |<WRAP><wrap>0:00C1</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>192.168.0.101 IO[1] open</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02279I</wrap> </WRAP> |<WRAP><wrap>0:00C2</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>* 192.168.0.101 mask 255.255.255.255</wrap> </WRAP> |<WRAP><wrap>IO[2]</wrap> </WRAP> | |<WRAP><wrap>HHC02279I</wrap> </WRAP> |<WRAP><wrap>0:00C3</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>* 192.168.0.101 mask 255.255.255.255</wrap> </WRAP> |<WRAP><wrap>IO[2]</wrap> </WRAP> | |<WRAP><wrap>HHC02279I</wrap> </WRAP> |<WRAP><wrap>0:00C4</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>* 192.168.0.101 mask 255.255.255.255</wrap> </WRAP> |<WRAP><wrap>IO[2]</wrap> </WRAP> | |<WRAP><wrap>HHC02279I</wrap> </WRAP> |<WRAP><wrap>0:00C5</wrap> </WRAP> |<WRAP><wrap>3270</wrap> </WRAP> |<WRAP><wrap>* 192.168.0.101 mask 255.255.255.255</wrap> </WRAP> |<WRAP><wrap>IO[2]</wrap> </WRAP> | **<wrap>Figure 109: DEVLIST command (specify device class)</wrap>** **<wrap>Example 3:</wrap>** <wrap>List one device (0148) by device number.</wrap> <wrap>HHC00013I Herc command: 'devlist 0148'</wrap> <wrap>HHC02279I 0:0148 3350 </wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap> [560 cyls] [0 sfs] IO[92230] open</wrap> **<wrap>Figure 110: DEVLIST command (specify device number)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 357</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.54 DEVPRIO (Display or set device threads process priority) //8.54.1 Function//</wrap>** <wrap>The DEVPRIO command is used to change the priority of the device threads. See section 5.82 for details on process and thread priorities. Given without an argument the DEVPRIO command displays the current device threads process priority.</wrap> **<wrap>Caution: </wrap>**<wrap>DEVPRIO should not have a higher dispatching priority than the TOD clock and timer thread.</wrap> **//<wrap>8.54.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>DEVPRI0 </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>DEVPRI0</wrap> //<wrap>nn</wrap>// **//<wrap>8.54.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This value specifies the priority for the device threads. For details on the priority values see section 5.82 (“Process and Thread Priorities”).</wrap> **//<wrap>8.54.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the device threads process priority to1 0.</wrap> <wrap>HHC00013I Herc command: 'devprio 10'</wrap> <wrap>HHC02204I devprio set to 10</wrap> **<wrap>Figure 111: DEVPRIO command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 358</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.55 DEVTMAX (Display or set maximum device threads) //8.55.1 Function//</wrap>** <wrap>The DEVTMAX command displays the current setting of the DEVTMAX system parameter along with the actual device threads statistics. As an additional argument a new value for the maximum device threads may be specified.</wrap> **//<wrap>8.55.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>DEVTMAX [</wrap>****<wrap>-</wrap>****<wrap>1 | 0 | 1</wrap>****<wrap>-</wrap>****//<wrap>n</wrap>//****<wrap>]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>PI10¬¬¬ DEVTMAX ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>****<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>****<wrap>ª¬¬¬ </wrap>****<wrap>-1 ¬¬¬¬« </wrap>****<wrap>ª¬¬¬¬ 0 ¬¬¬¬« ⡿¬¬¬1</wrap>****<wrap>-</wrap>****//<wrap>n </wrap>//****<wrap>¬¬¬¯</wrap>** **//<wrap>8.55.3 Parameter</wrap>//** **<wrap>0 </wrap>**<wrap>Specify 0 to create an unlimited number of ‘semi-permanent’ threads on an ‘as-needed’ basis. This is the default. With this option, a thread is created to service an I/O request for a device if one does not already exist. When the I/O is complete the thread enters an idle state waiting for new work. If a new I/O request for the device arrives before the timeout period expires the existing thread will be reused. The timeout value is currently hard coded at 5 minutes.</wrap> <wrap>Note that this option can cause one thread (or possibly more) to be created for each de vice in your configuration. Specifying 0 means there is no limit to the number of threads that can be created.</wrap> **<wrap>-1 </wrap>**<wrap>Specify -1 to cause ‘one time only’ temporary threads to be created to service each I/O request to a device. Once the I/O request is complete, the thread exits. Subsequent I/Os to the same device will cause another worker thread to be created again.</wrap> **<wrap>1-//n //</wrap>**<wrap>Specify a value from 1 to n to set an upper limit to the number of threads that can be created to service any I/O request to any device. Like the “0” option, each thread once finished servicing an I/O request enters an idle state. If a new request arrives before the timeout period expires, the thread is reused.</wrap> <wrap>If all threads are busy when a new I/O request arrives a new thread is created only if the specified maximum number of threads have not yet been reached. If the specified maximum number of threads already has been reached then the I/O request</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 359</wrap> <wrap>\\ </wrap><wrap>is placed in a queue and will be serviced by the first available thread (eg. by whichever thread becomes idle first).</wrap> <wrap>This option was created to address a threading issue, possibly related to the Cyg-win phtreads implementation on Windows systems. On Windows systems positive DEVTMAX values are currently not honoured and are treated identically as if the value 0 had been specified. The default for non-Windows systems is 0.</wrap> **//<wrap>8.55.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the maximum allowed device threads along with the current statistics.</wrap> <wrap>HHC00013I Herc command: 'devtmax'</wrap> <wrap>HHC02241I Max device threads: 0, current: 5, most: 5, waiting: 4, max exceeded: 0</wrap> **<wrap>Figure 112: DEVTMAX command (list maximum allowed device threads)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the maximum allowed device threads to 25.</wrap> <wrap>HHC00013I Herc command: 'devtmax 25'</wrap> **<wrap>Figure 113: DEVTMAX command (set maximum allowed device threads)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 360</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.56 DIAG8CMD (Display or set DIAGNOSE 8 command option) //8.56.1 Function//</wrap>** <wrap>The DIAG8CMD command specifies whether a command issued through Diagnose 8 will be executed by Hercules as a Hercules commands or not. An optional second argument can be specified to request whether the commands issued using the Diagnose 8 interface will be traced at the console. This may be useful for programs that routinely issue console commands using the Diagnose 8 interface. If no argument is given, DIAG8CMD displays the current settings.</wrap> **<wrap>Caution: </wrap>**<wrap>Enabling this feature may have security consequences. When this feature is enabled it is possible for guest operating systems running under Hercules to issue commands directly to the host operating system by means of the Hercules ‘sh’ (shell) command. This ability may be disabled via the SHCMDOPT statement.</wrap> **<wrap>Note: </wrap>**<wrap>There are some commands that are being prevented from being used by the Diagnose 8 interface. The list of commands that may not be executed by means of Diagnose 8 can be found in “Appendix D. Hercules Command Groups” under the column ‘NODIAG8’.</wrap> **//<wrap>8.56.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>DIAG8CMD </wrap>****<wrap>[</wrap>****<wrap>DISABLE | ENABLE [ECHO | NOECHO</wrap>****<wrap>]]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>4</wrap>**<wrap>Ê¬¬¬ DIAG8CMD ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬</wrap>****<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>****<wrap>ª</wrap>****<wrap>¬¬¬ </wrap>****<wrap>DISABLE </wrap>****<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap>****<wrap>⡿¬¬¬ENABLE ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap>** **<wrap>ª¬¬¬¬EC</wrap>****<wrap>HO ¬¬¬¬«</wrap>** **<wrap>⡿¬¬¬NOECHO ¬¬¬¯</wrap>** **//<wrap>8.56.3 Parameter</wrap>//** **<wrap>DISABLE </wrap>**<wrap>Commands issued through the Diagnose 8 interface will generate a Specification Exception program interrupt on the issuing CPU. This is the default together with NOECHO.</wrap> **<wrap>ENABLED </wrap>**<wrap>Commands issued through the Diagnose 8 interface will be executed by Hercules as Hercules commands.</wrap> **<wrap>ECHO </wrap>**<wrap>When ECHO is specified, a message is issued as the console is about to issue the command, the command is redisplayed as if it was entered through the console input line, and a final message is issued to indicate the command completed.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 361</wrap> <wrap>\\ </wrap>**<wrap>NOECHO </wrap>**<wrap>When NOECHO is specified, no such messages are displayed and the command completes silently, except for the output of the command itself if the Diagnose 8 interface did not request a response buffer. This is the default together with DISABLE.</wrap> <wrap>The value of ECHO or NOECHO has no effect on command output being placed into a response buffer if the Diagnose 8 interface requested one.</wrap> **//<wrap>8.56.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current DIAG8CMD settings.</wrap> <wrap>HHC00013I Herc command: 'diag8cmd'</wrap> <wrap>HHC02203I DIAG8CMD : disable, no echo</wrap> **<wrap>Figure 114: DIAG8CMD command (display current settings)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Specify that commands issued through the Diagnose 8 interface are executed as Hercules commands. Additionally issue a message, as the console is about to execute the command, then redisplay the command itself and give a final message, indicating the command has completed.</wrap> <wrap>HHC00013I Herc command: 'diag8cmd enable echo'</wrap> **<wrap>Figure 115: DIAG8CMD command (set new DIAG8CMD mode)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 362</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.57 DIR (Display file and directory listing) \\ //8.57.1 Function//</wrap>** <wrap>The DIR command displays a list of files and subdirectories in the current directory. The DIR command is only available when running Hercules under Microsoft Windows. For Linux and Mac OS X please use the "LS" command.</wrap> **//<wrap>8.57.2 Syntax</wrap>//** **__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>****<wrap>DIR</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>**<wrap>DIR</wrap>** **//<wrap>8.57.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.57.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Show the list of files and subdirectories in the current directory.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'dir' \\ Volume in drive D is Hercules \\ Volume Serial Number is 6CD7-297E</wrap> |<WRAP><wrap>Directory of</wrap> <wrap>11.07.2010</wrap> <wrap>11.07.2010</wrap> </WRAP> |<WRAP>[[file:///D:/Hercules|<wrap>D:%%\%%Hercules</wrap>]]<wrap></wrap> <wrap>01:13 <DIR> .</wrap> <wrap>01:13 <DIR> ..</wrap> </WRAP> | | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |<WRAP><wrap>282'624 AWSBrowse32.exe</wrap> </WRAP> | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |<WRAP><wrap>503'808 AWSBrowse32D.exe</wrap> </WRAP> | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |<WRAP><wrap>274'432 AWSBrowse32U.exe</wrap> </WRAP> | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |<WRAP><wrap>491'520 AWSBrowse32UD.exe</wrap> </WRAP> | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:24</wrap> </WRAP> |<WRAP><wrap>323'072 AWSBrowse64.exe</wrap> </WRAP> | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:24</wrap> </WRAP> |<WRAP><wrap>647'168 AWSBrowse64D.exe</wrap> </WRAP> | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:24</wrap> </WRAP> |<WRAP><wrap>317'440 AWSBrowse64U.exe</wrap> </WRAP> | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:24</wrap> </WRAP> |<WRAP><wrap>636'416 AWSBrowse64UD.exe</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 363</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap> |<WRAP><wrap>07.02.2007 10.07.2010 10.07.2010 10.07.2010 10.07.2010 08.01.2009 10.07.2010 .</wrap> </WRAP> |<WRAP><wrap>05:37 \\ 02:45 \\ 02:45 \\ 02:45 \\ 02:45 \\ 16:43 \\ 02:45</wrap> </WRAP> |||<WRAP><wrap>934 15'872 15'872 24'064 17'408 162'984 14'336</wrap> </WRAP> |<WRAP><wrap>awshet.reg \\ cckdcdsk.exe \\ cckdcomp.exe \\ cckddiag.exe \\ cckdswap.exe \\ CHANGES \\ conspawn.exe</wrap> </WRAP> || | |<WRAP>//<wrap>several lines not displayed</wrap>// </WRAP> ||||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> || | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>122'880</wrap> </WRAP> |<WRAP><wrap>TT32Test.exe</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:28</wrap> </WRAP> |||<WRAP><wrap>158'208</wrap> </WRAP> |<WRAP><wrap>TT32Test64.exe</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:28</wrap> </WRAP> |||<WRAP><wrap>390'656</wrap> </WRAP> |<WRAP><wrap>TT32Test64D.exe</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:28</wrap> </WRAP> |||<WRAP><wrap>163'840</wrap> </WRAP> |<WRAP><wrap>TT32Test64U.exe</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:28</wrap> </WRAP> |||<WRAP><wrap>398'336</wrap> </WRAP> |<WRAP><wrap>TT32Test64UD.exe</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>290'816</wrap> </WRAP> |<WRAP><wrap>TT32TestD.exe</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>131'072</wrap> </WRAP> |<WRAP><wrap>TT32TestU.exe</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>299'008</wrap> </WRAP> |<WRAP><wrap>TT32TestUD.exe</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>131'072</wrap> </WRAP> |<WRAP><wrap>TunTap32.dll</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>344'064</wrap> </WRAP> |<WRAP><wrap>TunTap32D.dll</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>135'168</wrap> </WRAP> |<WRAP><wrap>TunTap32U.dll</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>344'064</wrap> </WRAP> |<WRAP><wrap>TunTap32UD.dll</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:27</wrap> </WRAP> |||<WRAP><wrap>144'384</wrap> </WRAP> |<WRAP><wrap>TunTap64.dll</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:27</wrap> </WRAP> |||<WRAP><wrap>561'664</wrap> </WRAP> |<WRAP><wrap>TunTap64D.dll</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:27</wrap> </WRAP> |||<WRAP><wrap>147'456</wrap> </WRAP> |<WRAP><wrap>TunTap64U.dll</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:27</wrap> </WRAP> |||<WRAP><wrap>565'760</wrap> </WRAP> |<WRAP><wrap>TunTap64UD.dll</wrap> </WRAP> || | |<WRAP><wrap>12.06.2010</wrap> </WRAP> |<WRAP><wrap>18:03 <DIR></wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>util</wrap> </WRAP> || | |<WRAP><wrap>08.02.2009</wrap> </WRAP> |<WRAP><wrap>20:03</wrap> </WRAP> |||<WRAP><wrap>75'264</wrap> </WRAP> |<WRAP><wrap>zlib1.dll</wrap> </WRAP> || | |<WRAP><wrap>121</wrap> </WRAP> ||<WRAP><wrap>File(s)</wrap> </WRAP> |<WRAP><wrap>25'408'168</wrap> </WRAP> |||<WRAP><wrap>bytes</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>5</wrap> </WRAP> ||<WRAP><wrap>Dir(s)</wrap> </WRAP> |<WRAP><wrap>74'086'850'560</wrap> </WRAP> |||<WRAP><wrap>bytes</wrap> </WRAP> |<WRAP><wrap>free</wrap> </WRAP> | | | | | | | | | | **<wrap>Figure 116: DIR command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 364</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.58 DS (Display subchannel) \\ //8.58.1 Function//</wrap>** <wrap>The DS command shows the subchannel information for a given device number.</wrap> **//<wrap>8.58.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>DS </wrap>//<wrap>devnum</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ DS ¬¬¬ </wrap>//<wrap>devnum</wrap>// **//<wrap>8.58.3 Parameter</wrap>//** **//<wrap>devnum </wrap>//**<wrap>The device number for which the subchannel information has to be displayed.</wrap> **//<wrap>8.58.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display subchannel information for device 0AE0.</wrap> <wrap>HHC00013I Herc command: 'ds 0ae0'</wrap> <wrap>HHC02268I 0:0AE0 D/T3390 Subchannel Number[0028]</wrap> <wrap>HHC02268I Path Management Control Word (PMCW)</wrap> <wrap>HHC02268I IntParm:00F3F8A8</wrap> <wrap>HHC02268I Flags:189D Dev:0AE0</wrap> <wrap>HHC02268I LPM:80 PNOM:00 LPUM:80 PIM:80</wrap> <wrap>HHC02268I MBI:0183 POM:FF PAM:80 \\ HHC02268I CHPID0:0A 1:00 2:00 3:00</wrap> <wrap>HHC02268I 4:00 5:00 6:00 7:00</wrap> <wrap>HHC02268I Misc:00000001</wrap> <wrap>HHC02268I Subchannel Status Word (SCSW)</wrap> <wrap>HHC02268I Flags:08C0 SCHC:4020 DS:00 SS:00 Count:0001 CCW:7F01CB70</wrap> <wrap>HHC02268I Device Status is Normal</wrap> <wrap>HHC02268I Subchannel Status is Normal</wrap> **<wrap>Figure 117: DS command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 365</wrap> <wrap>\\ </wrap>{{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image073.gif|}}{{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image074.gif|}}{{hercules:userref:bf:image043.gif|}}{{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image075.gif|}}{{hercules:userref:bf:image076.gif|}}{{hercules:userref:bf:image077.gif|}}{{hercules:userref:bf:image078.gif|}}{{hercules:userref:bf:image053.gif|}}<wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap> <wrap>\\ </wrap><wrap>MM Measurement-Mode Enable</wrap> <wrap>D Multipath Mode</wrap> <wrap>T Timing Facility</wrap> <wrap>V Device Number Valid</wrap> <wrap>LPM Logical-Path Mask</wrap> <wrap>PNOM Path-Not-Operational Mask</wrap> <wrap>LPUM Last-Path-Used Mask</wrap> <wrap>PIM Path-Installed Mask</wrap> <wrap>MBI Measurement-Block Index</wrap> <wrap>POM Path-Operational Mask</wrap> <wrap>PAM Path-Available Mask \\ CHPIDs Channel-Path Identifiers</wrap> <wrap>F Measurement Block Format Control</wrap> <wrap>X Extended Measurement Word Enable</wrap> <wrap>S Concurrent Sense</wrap> <wrap>The Subchannel-Status Word (SCSW) provides information about the status of a subchannel and its associated devices. The format of the SCSW is as follows:</wrap> <wrap>Word</wrap> |<WRAP><wrap>0</wrap> <wrap>1</wrap> <wrap>2</wrap> </WRAP> |<WRAP><wrap>Key</wrap> </WRAP> |<WRAP><wrap>S L CC</wrap> </WRAP> |<WRAP><wrap>F P I A U Z E N 0 FC</wrap> </WRAP> |<WRAP><wrap>AC SC</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>CCW Address</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>Device</wrap> </WRAP> |<WRAP><wrap>Status</wrap> </WRAP> |<WRAP><wrap>Subchannel Status</wrap> </WRAP> |<WRAP><wrap>Count</wrap> </WRAP> | **<wrap>Figure 120: Subchannel-Status Word</wrap>** __<wrap>Legend: </wrap>__<wrap></wrap> <wrap>Key Subchannel Key</wrap> <wrap>S Suspend Control</wrap> <wrap>L ESW Format</wrap> <wrap>CC Deferred Condition Code</wrap> <wrap>F Format</wrap> <wrap>P Prefetch</wrap> <wrap>I Initial-Status Interruption Control</wrap> <wrap>A Address-Limit-Checking Control</wrap> <wrap>U Suppress-Suspend Interruption</wrap> <wrap>Z Zero Condition Code</wrap> <wrap>E Extended Control</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 367</wrap> <wrap>\\ </wrap><wrap>N Path Not Operational</wrap> <wrap>0 Reserved</wrap> <wrap>FC Function Control</wrap> <wrap>AC Activity Control</wrap> <wrap>SC Status Control</wrap> <wrap>Count Residual Count</wrap> <wrap>Details about the control blocks, that have been described here only briefly, can be found in IBM's "z/Architecture Principles of Operation" manual.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 368</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.59 ECPSVM (ECPS:VM commands) \\ //8.59.1 Function//</wrap>** <wrap>This command specifies, whether ECPS:VM (Extended Control Program Support : Virtual Machine) support is to be enabled and – if it is enabled – to which level. Issuing command ECPSVM HELP displays a list of all available commands.</wrap> <wrap>The purpose of ECPS:VM is to provide to the VM/370 operating system a set of shortcut facilities to perform hypervisor functions (CP Assists) and virtual machine simulation (VM Assists).</wrap> <wrap>Although this feature does not affect VM operating system products operating in XA, ESA or z/Architec-ture mode, it will affect VM/370 and VM/SP products running under VM/XA, VM/ESA or z/VM. Running VM/370 and VM/SP products under VM/XA, VM/ESA or z/VM should be done with ECPS:VM disabled. ECPS:VM should not be enabled in AP or MP environments. ECPS:VM has no effect on non-VM operating systems. It is however recommended to disable ECPS:VM when running native non-VM operating systems.</wrap> <wrap>If a specific level is given this value will be reported to the operating system when it issues a Store ECPS:VM level but it does not otherwise alter the ECPS:VM facility operations. Please note that this is a partial implementation.</wrap> <wrap>Some of the arguments of the ECPSVM command can be abbreviated as shown in the syntax section below.</wrap> **//<wrap>8.59.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>ECPSVM [H</wrap><wrap>elp </wrap><wrap>| Sl</wrap><wrap>ats </wrap><wrap>| DIS</wrap><wrap>able </wrap><wrap>| EN</wrap><wrap>able </wrap><wrap>| DEBUG | NO</wrap><wrap>debug </wrap><wrap>| Level </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]]</wrap> |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ECPSVM</wrap> </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>ª¬¬¬¬H</wrap><wrap>elp ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬¬Sl</wrap><wrap>ats ¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬DIS</wrap><wrap>able ¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬EN</wrap><wrap>able ¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬¬DEBUG¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª¬¬¬NO</wrap><wrap>debug ¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬¬Level </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿¬¬¬ </wrap>//<wrap>nn </wrap>//<wrap>¬¬¬¯</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 369</wrap> <wrap>\\ </wrap>**//<wrap>8.59.3 Parameter</wrap>//** **<wrap>Help </wrap>**<wrap>Display help with all available ECPSVM options.</wrap> **<wrap>STats </wrap>**<wrap>Show statistical counters.</wrap> **<wrap>DISable </wrap>**<wrap>Disable all ECPS:VM features. This is the default if ECPSVM is not coded.</wrap> **<wrap>ENable </wrap>**<wrap>Enable all ECPS:VM features.</wrap> **<wrap>DEBUG </wrap>**<wrap>Debug ECPS:VM features.</wrap> **<wrap>NOdebug </wrap>**<wrap>Turn debug modus off for ECPS:VM features.</wrap> **<wrap>Level </wrap>**<wrap>Set/show ECPS:VM level.</wrap> **//<wrap>nn </wrap>//**<wrap>The value //nn //specifies the support level that is reported to the operating system.</wrap> **//<wrap>8.59.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Enable the ECPS:VM features.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'ecpsvm enable'</wrap> <wrap>HHC01719I ECPS:VM Command processor invoked \\ HHC01707I ECPS:VM VM ASSIST feature SVC Enabled \\ HHC01707I ECPS:VM VM ASSIST feature SSM Enabled \\ HHC01707I ECPS:VM VM ASSIST feature LPSW Enabled \\ HHC01707I ECPS:VM VM ASSIST feature STNSM Enabled \\ HHC01707I ECPS:VM VM ASSIST feature STOSM Enabled \\ HHC01707I ECPS:VM VM ASSIST feature SIO Enabled \\ HHC01707I ECPS:VM VM ASSIST feature VTIMER Enabled \\ HHC01707I ECPS:VM VM ASSIST feature STCTL Enabled \\ HHC01707I ECPS:VM VM ASSIST feature LCTL Enabled \\ HHC01707I ECPS:VM VM ASSIST feature DIAG Enabled \\ HHC01707I ECPS:VM VM ASSIST feature IUCV Enabled \\ HHC01708I All ECPS:VM VM ASSIST features Enabled \\ HHC01707I ECPS:VM CP ASSIST feature FREE Enabled</wrap> <wrap>HHC01707I ECPS:VM CP ASSIST feature FRET Enabled HHC01707I ECPS:VM CP ASSIST feature LCKPG Enabled HHC01707I ECPS:VM CP ASSIST feature ULKPG Enabled HHC01707I ECPS:VM CP ASSIST feature SCNRU Enabled HHC01707I ECPS:VM CP ASSIST feature SCNVU Enabled HHC01707I ECPS:VM CP ASSIST feature DISP0 Enabled HHC01707I ECPS:VM CP ASSIST feature DISP1 Enabled HHC01707I ECPS:VM CP ASSIST feature DISP2 Enabled HHC01707I ECPS:VM CP ASSIST feature DNCCW Enabled HHC01707I ECPS:VM CP ASSIST feature DFCCW Enabled HHC01707I ECPS:VM CP ASSIST feature FCCWS Enabled</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 370</wrap> <wrap>\\ </wrap><wrap>HHC01707I ECPS:VM CP ASSIST feature CCWGN Enabled \\ HHC01707I ECPS:VM CP ASSIST feature UXCCW Enabled \\ HHC01707I ECPS:VM CP ASSIST feature TRBRG Enabled \\ HHC01707I ECPS:VM CP ASSIST feature TRLOK Enabled \\ HHC01707I ECPS:VM CP ASSIST feature VIST Enabled \\ HHC01707I ECPS:VM CP ASSIST feature VIPT Enabled \\ HHC01707I ECPS:VM CP ASSIST feature STEVL Enabled \\ HHC01707I ECPS:VM CP ASSIST feature FREEX Enabled \\ HHC01707I ECPS:VM CP ASSIST feature FRETX Enabled \\ HHC01707I ECPS:VM CP ASSIST feature PMASS Enabled \\ HHC01707I ECPS:VM CP ASSIST feature LCSPG Enabled \\ HHC01708I All ECPS:VM CP ASSIST features Enabled \\ HHC01722I ECPS:VM Command processor complete</wrap> **<wrap>Figure 121: ECPSVM ENABLE command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Show ECPS:VM statistical counters.</wrap> <wrap>HHC00013I Herc command: 'ecpsvm stats'</wrap> <wrap>HHC01719I ECPS:VM Command processor invoked</wrap> <wrap>HHC01702I +---------- +-------- +-------- +------ +</wrap> <wrap>HHC01706I | VM ASSIST | Calls | Hits | Ratio |</wrap> <wrap>HHC01702I +---------- +-------- +-------- +------ +</wrap> <wrap>HHC01701I | Total | 0 | 0 | 100% |</wrap> <wrap>HHC01702I +---------- +-------- +-------- +----- + \\ HHC01704I 11 entry/entries not shown and never invoked</wrap> <wrap>HHC01702I +---------- +-------- +-------- +------ +</wrap> <wrap>HHC01706I | CP ASSIST | Calls | Hits | Ratio |</wrap> <wrap>HHC01702I +---------- +-------- +-------- +------ +</wrap> <wrap>HHC01701I | Total | 0 | 0 | 100% |</wrap> <wrap>HHC01702I +---------- +-------- +-------- +----- + \\ HHC01704I 23 entry/entries not shown and never invoked \\ HHC01722I ECPS:VM Command processor complete</wrap> **<wrap>Figure 122: ECPSVM STATS command</wrap>** **<wrap>Example 3:</wrap>** <wrap>Show the ECPS:VM level.</wrap> <wrap>HHC00013I Herc command: 'ecpsvm level' \\ HHC01719I ECPS:VM Command processor invoked \\ HHC01712I Current reported ECPS:VM level is 20 \\ HHC01713I But ECPS:VM is currently disabled \\ HHC01722I ECPS:VM Command processor complete</wrap> **<wrap>Figure 123: ECPSVM LEVEL command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 371</wrap> <wrap>\\ </wrap>**<wrap>Example 4:</wrap>** <wrap>Debug the ECPS:VM features.</wrap> |<WRAP><wrap>HHC00013I Herc command: 'ecpsvm debug'</wrap> <wrap>HHC01719I ECPS:VM Command processor invoked \\ HHC01707I ECPS:VM VM ASSIST feature SVC Debug On \\ HHC01707I ECPS:VM VM ASSIST feature SSM Debug On \\ HHC01707I ECPS:VM VM ASSIST feature LPSW Debug On \\ HHC01707I ECPS:VM VM ASSIST feature STNSM Debug On \\ HHC01707I ECPS:VM VM ASSIST feature STOSM Debug On \\ HHC01707I ECPS:VM VM ASSIST feature SIO Debug On \\ HHC01707I ECPS:VM VM ASSIST feature VTIMER Debug On \\ HHC01707I ECPS:VM VM ASSIST feature STCTL Debug On \\ HHC01707I ECPS:VM VM ASSIST feature LCTL Debug On \\ HHC01707I ECPS:VM VM ASSIST feature DIAG Debug On \\ HHC01707I ECPS:VM VM ASSIST feature IUCV Debug On \\ HHC01708I All ECPS:VM VM ASSIST features Debug On \\ HHC01707I ECPS:VM CP ASSIST feature FREE Debug On \\ HHC01707I ECPS:VM CP ASSIST feature FRET Debug On \\ .</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC01707I ECPS:VM CP ASSIST feature FCCWS Debug On HHC01707I ECPS:VM CP ASSIST feature CCWGN Debug On HHC01707I ECPS:VM CP ASSIST feature UXCCW Debug On HHC01707I ECPS:VM CP ASSIST feature TRBRG Debug On HHC01707I ECPS:VM CP ASSIST feature TRLOK Debug On HHC01707I ECPS:VM CP ASSIST feature VIST Debug On HHC01707I ECPS:VM CP ASSIST feature VIPT Debug On HHC01707I ECPS:VM CP ASSIST feature STEVL Debug On HHC01707I ECPS:VM CP ASSIST feature FREEX Debug On HHC01707I ECPS:VM CP ASSIST feature FRETX Debug On HHC01707I ECPS:VM CP ASSIST feature PMASS Debug On HHC01707I ECPS:VM CP ASSIST feature LCSPG Debug On HHC01708I All ECPS:VM CP ASSIST features Debug On HHC01709I ECPS:VM global debug On</wrap> <wrap>HHC01722I ECPS:VM Command processor complete</wrap> </WRAP> | **<wrap>Figure 124: ECPSVM DEBUG command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 372</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.60 ENGINES (Set processor engines type) \\ //8.60.1 Function//</wrap>** <wrap>The ENGINES command specifies the type of engine for each installed processor. The default engine type is CP. The number of installed processor engines is determined by the MAXCPU system parameter.</wrap> <wrap>If the ENGINES command specifies more than MAXCPU engines, the excess engines are ignored. If fewer than MAXCPU engines are specified, the remaining engines are set to type CP (the default). See the MAXCPU system parameter or console command for details regarding the compile time variable MAX_CPU_ENGINES.</wrap> <wrap>For detailed explanations on the interrelationship between ENGINES, MAXCPU and NUMCPU please see “Appendix B. Configuration of Emulated CPUs”.</wrap> **//<wrap>8.60.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>ENGINES [</wrap>//<wrap>nn*</wrap>//<wrap>] {</wrap>__<wrap>CP</wrap>__<wrap> | IL | AP | IP} [, ... ]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®</wrap> <wrap> </wrap> <wrap>ÊÊ¬¬¬ENGINES¬¬¬°¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬</wrap><wrap>§¬¬¬ </wrap>__<wrap>CP</wrap>__<wrap> ¬¬¬§¬¬¬¨¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿¬¬¬ </wrap>//<wrap>nn* </wrap>//<wrap>¬¬¬¯ ª¬¬¬ IL ¬¬¬«</wrap> <wrap>ª¬¬¬AP¬¬¬« \\ ⡿¬¬¬IP¬¬¬¯</wrap> **//<wrap>8.60.3 Parameter</wrap>//** **//<wrap>nn</wrap>//****<wrap>* </wrap>**<wrap>This is an optional repeat count.</wrap> **<wrap>CP </wrap>**<wrap>Specifies a processor engine of type CP. This is the default.</wrap> **<wrap>IL </wrap>**<wrap>Specifies a processor engine of type IL.</wrap> **<wrap>AP </wrap>**<wrap>Specifies a processor engine of type AP.</wrap> **<wrap>IP </wrap>**<wrap>Specifies a processor engine of type IP.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 373</wrap> <wrap>\\ </wrap>**//<wrap>8.60.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify two engines of type CP, one engine of type IP and one engine of type AP.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'engines 2*cp,ip,ap'</wrap> |<WRAP><wrap>HHC00827I</wrap> </WRAP> |<WRAP><wrap>Processor CP00:</wrap> </WRAP> |<WRAP><wrap>engine</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>type</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>set:</wrap> </WRAP> |<WRAP><wrap>'CP'</wrap> </WRAP> | |<WRAP><wrap>HHC00827I</wrap> </WRAP> |<WRAP><wrap>Processor CP01:</wrap> </WRAP> |<WRAP><wrap>engine</wrap> </WRAP> |<WRAP><wrap>01</wrap> </WRAP> |<WRAP><wrap>type</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>set:</wrap> </WRAP> |<WRAP><wrap>'CP'</wrap> </WRAP> | |<WRAP><wrap>HHC00827I</wrap> </WRAP> |<WRAP><wrap>Processor IP02:</wrap> </WRAP> |<WRAP><wrap>engine</wrap> </WRAP> |<WRAP><wrap>02</wrap> </WRAP> |<WRAP><wrap>type</wrap> </WRAP> |<WRAP><wrap>5</wrap> </WRAP> |<WRAP><wrap>set:</wrap> </WRAP> |<WRAP><wrap>'IP'</wrap> </WRAP> | |<WRAP><wrap>HHC00827I</wrap> </WRAP> |<WRAP><wrap>Processor AP03:</wrap> </WRAP> |<WRAP><wrap>engine</wrap> </WRAP> |<WRAP><wrap>03</wrap> </WRAP> |<WRAP><wrap>type</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>set:</wrap> </WRAP> |<WRAP><wrap>'AP'</wrap> </WRAP> | **<wrap>Figure 125: ENGINES command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 374</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.61 EXEC (Execute a REXX script) \\ //8.61.1 Function//</wrap>** <wrap>The EXEC console command executes a Rexx script. EXEC invokes Rexx within the Hercules process to execute the Rexx script and commands will be executed synchronously within the Hercules process.</wrap> <wrap>The EXEC command is only available if Hercules is built with Rexx support (see the Hercules “Installation Guide” for details on how to activate Rexx support and the Hercules “General Information” manual for more details about the Rexx support). Chapter 14 (“REXX Support”) in this manual contains additional information about using Rexx with Hercules.</wrap> **//<wrap>8.61.2 Syntax</wrap>//** {{hercules:userref:bf:image063.gif|}}{{hercules:userref:bf:image079.gif|}}{{hercules:userref:bf:image080.gif|}}{{hercules:userref:bf:image081.gif|}}**//<wrap>8.61.3 Parameter</wrap>//** **<wrap>COMMAND </wrap>**<wrap>Specifies command style for passing arguments to a Rexx script. ‘COMMAND’ may be abbreviated as ‘COM’. If not specified then the argument passing style is determined by the Rexx mode settings (form the REXX system parameter or console command).</wrap> **<wrap>SUBROUTINE </wrap>**<wrap>Specifies subroutine style for passing arguments to a Rexx script. ‘SUBROUTINE’ may be abbreviated as ‘SUB’. If not specified then the argument passing style is determined by the Rexx mode settings (form the REXX system parameter or console command).</wrap> **//<wrap>rexx </wrap>//**<wrap>This is the name (and optionally the path) of a Rexx script.</wrap> <wrap>If the name of the Rexx to be executed is given without a pathname, the script is searched within the path that has been defined with the REXX command or the default path if no path has been set for the Rexx environment (see the REXX console command for more details).</wrap> <wrap>If a path is specified in the EXEC command, then the Rexx will not be searched in the defined path of the Rexx environment.</wrap> **//<wrap>argument </wrap>//**<wrap>These are the arguments (separated by spaces) to be passed to the Rexx script.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 375</wrap> <wrap>\\ </wrap>**//<wrap>8.61.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Execute Rexx script “testrexx.rexx” with arguments ‘arg1’, ‘arg2’ and ‘arg3’.</wrap> <wrap>HHC00013I Herc command: 'exec testrexx arg1 arg2 arg3’</wrap> <wrap>testrexx started</wrap> <wrap>testrexx version . . . . : REXX-Regina_3.6(MT) 5.00 31 Dec 2011</wrap> <wrap>testrexx source . . . . : WIN64 COMMAND </wrap>[[file:///d:/mvs/conf/testrexx.REX|<wrap>d:%%\%%mvs%%\%%conf%%\%%testrexx.REX</wrap>]]<wrap></wrap> <wrap>testrexx hostenv . . . .... : HERCULES</wrap> <wrap>testrexx date ............ : 6 May 2012</wrap> <wrap>testrexx time ............ : 02:39:19</wrap> <wrap>testrexx arguments . . .... : arg1 arg2 arg3</wrap> <wrap>testrexx Hercules version : 3.08.0</wrap> <wrap>testrexx RC environment . : </wrap>[[file:///D:/MVS/CONF/Hercules_Test.rc|<wrap>D:%%\%%MVS%%\%%CONF%%\%%Hercules_Test.rc</wrap>]]<wrap></wrap> <wrap>HHC02208I Uptime 04:02:33</wrap> <wrap>testrexx ended</wrap> **<wrap>Figure 126: EXEC command</wrap>** <wrap>The executed REXX script from example 1 is the following:</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>/* REXX */</wrap> <wrap>parse arg parms</wrap> <wrap>parms = space(parms) \\ argc = words(parms)</wrap> <wrap>parse version ver \\ parse source src</wrap> <wrap>env = address()</wrap> <wrap>parse var src . . cmd</wrap> |<WRAP><wrap>who = filespec("n",cmd)</wrap> <wrap>parse var who who "." .</wrap> <wrap>say who " started"</wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>say who</wrap> </WRAP> |<WRAP><wrap>"</wrap> </WRAP> |<WRAP><wrap>version . . . .</wrap> </WRAP> |<WRAP><wrap>:"</wrap> </WRAP> |<WRAP><wrap>ver</wrap> </WRAP> | |<WRAP><wrap>say who</wrap> </WRAP> |<WRAP><wrap>"</wrap> </WRAP> |<WRAP><wrap>source . . . .</wrap> </WRAP> |<WRAP><wrap>:"</wrap> </WRAP> |<WRAP><wrap>src</wrap> </WRAP> | |<WRAP><wrap>say who</wrap> </WRAP> |<WRAP><wrap>"</wrap> </WRAP> |<WRAP><wrap>hostenv . . . </wrap> </WRAP> |<WRAP><wrap>:"</wrap> </WRAP> |<WRAP><wrap>env</wrap> </WRAP> | |<WRAP><wrap>say who</wrap> </WRAP> |<WRAP><wrap>"</wrap> </WRAP> |<WRAP><wrap>date .......... </wrap> </WRAP> |<WRAP><wrap>:"</wrap> </WRAP> |<WRAP><wrap>date()</wrap> </WRAP> | |<WRAP><wrap>say who</wrap> </WRAP> |<WRAP><wrap>"</wrap> </WRAP> |<WRAP><wrap>time .......... </wrap> </WRAP> |<WRAP><wrap>:"</wrap> </WRAP> |<WRAP><wrap>time()</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 376</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>if parms = ""</wrap> <wrap>then do</wrap> <wrap>say who " arguments . . . : no arguments given"</wrap> <wrap>ret = 0</wrap> <wrap>end</wrap> <wrap>else do</wrap> <wrap>say who " arguments . . . :" parms</wrap> <wrap>ret = parms</wrap> <wrap>end</wrap> <wrap>Say who " Hercules version :" value('version',,'SYSTEM')</wrap> <wrap>Say who " RC environment . :" value('HERCULES_RC',,'ENVIRONMENT')</wrap> <wrap>address hercules 'uptime'</wrap> <wrap>say who " ended"</wrap> <wrap>exit ret</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 377</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.62 EXIT (Terminate the emulator) \\ //8.62.1 Function//</wrap>** <wrap>The EXIT command (see also the QUIT command) initiates the Hercules shutdown. It terminates all threads, detaches all channels and devices and releases the configuration. Finally it terminates the emulator. If the guest OS has enabled “Signal Shutdown” then a signal shutdown request is sent to the guest OS and termination will begin after the guest OS has shutdown.</wrap> <wrap>The EXIT command acts different depending on how Hercules was built. If Hercules was not compiled \\ with the option 'OPTION_SHUTDOWN_CONFIRMATION' then the command acts as described above.</wrap> <wrap>If Hercules however was built with option 'OPTION_SHUTDOWN_CONFIRMATION' then the following special processing for terminating the emulator takes place.</wrap> <wrap>If EXIT is entered and the command level is not set to 'developer', 'debug' or 'all' then EXIT will first check that all online CPUs are stopped. If any CPU is not in the stopped state message HHC00069I is displayed indicating the number of CPUs still running.</wrap> <wrap>Message HHC02266A follows that prompts for confirmation by entering a second EXIT command within a certain time period (default 10 seconds) to start termination of the emulator. If the time period has expired then the process starts over. This is to prevent an inadvertent shutdown of Hercules while still a guest OS is running.</wrap> <wrap>The time period for the second EXIT command can be set to another value by using the 'QUITMOUT' console command or system parameter.</wrap> <wrap>If all processors are stopped or the command level is set to "developer", "debug" or "all" then quit stops Hercules immediately. 'EXIT FORCE' will also terminate the emulator immediately without any further checks.</wrap> **//<wrap>8.62.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>EXIT </wrap><wrap>[</wrap><wrap>FORCE</wrap><wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>EXIT </wrap><wrap>¬</wrap> <wrap>FORCE</wrap> **//<wrap>8.62.3 Parameter</wrap>//** **<wrap>FORCE </wrap>**<wrap>Terminate the emulator immediately.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 378</wrap> <wrap>\\ </wrap>**//<wrap>8.62.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Initiate the Hercules shutdown.</wrap> <wrap>HHC00013I Herc command: 'exit'</wrap> <wrap>HHC00069I Guest is not quiesced; there are 8 CPUs active</wrap> <wrap>HHC02266A Reenter command 'exit' again within 10 seconds to execute</wrap> <wrap>HHC00013I Herc command: 'exit'</wrap> <wrap>HHC01420I Begin Hercules shutdown</wrap> <wrap>HHC01421I Releasing configuration</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC01422I Configuration release complete</wrap> <wrap>HHC01423I Calling termination routines</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC02103I Logger: logger thread terminating</wrap> <wrap>HHC01412I Hercules terminated</wrap> **<wrap>Figure 127: EXIT command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Initiate an immediate Hercules shutdown.</wrap> <wrap>HHC00013I Herc command: 'exit force'</wrap> <wrap>HHC01420I Begin Hercules shutdown</wrap> <wrap>HHC01421I Releasing configuration</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC01422I Configuration release complete</wrap> <wrap>HHC01423I Calling termination routines</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC02103I Logger: logger thread terminating</wrap> <wrap>HHC01412I Hercules terminated</wrap> **<wrap>Figure 128: EXIT FORCE command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 379</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.63 EXT (Generate external interrupt) \\ //8.63.1 Function//</wrap>** <wrap>The EXT command generates an external interrupt (the virtual INTERRUPT key is pressed).</wrap> **//<wrap>8.63.2 Syntax</wrap>//** **__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>EXT</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ EXT</wrap> **//<wrap>8.63.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.63.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Generate an external interrupt.</wrap> <wrap>HHC00013I Herc command: 'ext' \\ HHC02228I Key 'interrupt' pressed</wrap> **<wrap>Figure 129: EXT command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 380</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.64 F{+/-} (Mark frames usable or unusable) \\ //8.64.1 Function//</wrap>** <wrap>The F{+/-} command is used to mark storage frames as usable or unusable.</wrap> **//<wrap>8.64.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>F{+ | </wrap>//<wrap>-</wrap>//<wrap>} </wrap>//<wrap>addr</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ F ¬¬¬§¬¬¬ + ¬¬¬§¬¬¬ addr</wrap>// <wrap>⡿¬¬¬</wrap>//<wrap>- </wrap>//<wrap>¬¬¬</wrap> **//<wrap>8.64.3 Parameter</wrap>//** **<wrap>+ </wrap>**<wrap>Mark storage frame as usable.</wrap> **<wrap>- </wrap>**<wrap>Mark storage frame as unusable.</wrap> **//<wrap>addr </wrap>//**<wrap>The address of the storage frame that has to be marked usable or unusable.</wrap> **//<wrap>8.64.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Mark frame at address x’01000000’ as unusable.</wrap> <wrap>HHC00013I Herc command: 'f- 01000000' \\ HHC02204I frame 01000000 set to unusable</wrap> **<wrap>Figure 130: F{-} command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 381</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.65 FCB (Display current FCB or load new FCB image) //8.65.1 Function//</wrap>** <wrap>The FCB command is used to load a new FCB image or set the LPI (lines per inch) and LPP (lines per page) settings for a given 1403 or 3211 printer. Without arguments the FCB command displays the current settings for the printer.</wrap> <wrap>To change settings, the printer must be stopped first ("STOP devaddr") and then started again ("START devaddr").</wrap> **//<wrap>8.65.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>FCB </wrap>//<wrap>dev</wrap>////<wrap>icenum </wrap>//<wrap>[LPI=</wrap>//<wrap>lpi</wrap>//<wrap>] [LPP=</wrap>//<wrap>lpp</wrap>//<wrap>]</wrap> <wrap>[FCB=</wrap>//<wrap>l1:c1,l2:c2,l3:c3, ... ,l10:c10,l11:c11,l12:c12</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>pi,¬¬¬ FCB ¬¬¬ </wrap>//<wrap>devicenum </wrap>//__<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>__<wrap></wrap> <wrap>⡿¬¬¬LPI=</wrap>//<wrap>lpi </wrap>//<wrap>¬¬¬ ⡿¬¬¬ LPP=</wrap>//<wrap>lpi </wrap>//<wrap>¬¬</wrap> __<wrap>Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ </wrap>__<wrap>⡿¬¬¬FCB=</wrap>//<wrap>l1:c1,l2:c2,l3:c3, ... ,l10:c10,l11:c11,l12:c12pi</wrap>// **//<wrap>8.65.3 Parameter</wrap>//** **//<wrap>devicenum </wrap>//**<wrap>This is the device number of the printer for which the current settings have to be listed or changed.</wrap> **<wrap>LPI= </wrap>**<wrap>Specifies the number of lines per inch. The value of //lpi //must be 6 or 8.</wrap> **<wrap>LPP= </wrap>**<wrap>Specifies the number of lines per page. The value of //lpp //must be numeric but is not otherwise checked. Any number of lines per page is allowed.</wrap> **<wrap>FCB= </wrap>**<wrap>FCB= specifies an new FCB image to use for the printer. The argument must be given in the form //l1:c1, ...,;l12:c12 //where 'l' and 'c' are both numeric. The value of 'l' is the line number and the value of 'c' is the assigned channel. There is a maximum of 12 'l:c' pairs allowed.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 382</wrap> <wrap>\\ </wrap>**//<wrap>8.65.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current FCB for the printer with device address 000E.</wrap> <wrap>HHC00013I Herc command: 'fcb 000e'</wrap> <wrap>HHC02210I 0:000E lpi=6 index=0 lpp=66 fcb=1:1,7:2,13:3,19:4,...,43:8,49:10,55:11,61:12,63:9</wrap> **<wrap>Figure 131: FCB command (display current FCB)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Stop the printer with device address 000E. Set lines per inch to 6, lines per page to 66 and load a new FCB image for the printer. Then start the printer again.</wrap> <wrap>HHC00013I Herc command: 'stop 000e'</wrap> <wrap>HHC02214I 0:000E device stopped</wrap> <wrap>HHC00013I Herc command: 'fcb 000e lpi=6 lpp=66 fcb=1:1,6:2,12:3,18:4,...,48:9,54:10,60:11,66:12'</wrap> <wrap>HHC02210I 0:000E lpi=6 index=0 lpp=66 fcb=1:1,6:2,12:3,18:4,...,48:9,54:10,60:11,66:12</wrap> <wrap>HHC00013I Herc command: 'start 000e'</wrap> <wrap>HHC02214I 0:000E device started</wrap> **<wrap>Figure 132: FCB command (load new FCB image)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 383</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.66 FPC (Display or alter floating point control register) //8.66.1 Function//</wrap>** <wrap>The FPC command displays or alters the actual content of the floating point control register. Enter FPC by itself to display the register value without altering it.</wrap> **//<wrap>8.66.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>FPC [</wrap>//<wrap>xxxxxxxx</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ FPC ¬¬¬§</wrap> //<wrap>xxxxxxxx</wrap>// **//<wrap>8.66.3 Parameter</wrap>//** **//<wrap>xxxxxxxx </wrap>//**<wrap>This is the register value in hexadecimal (1-8 hex digits).</wrap> **//<wrap>8.66.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the floating point control register.</wrap> <wrap>HHC00013I Herc command: 'fpc'</wrap> <wrap>HHC02276I Floating point control register: 00000000</wrap> **<wrap>Figure 133: FPC command (display value)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Alter the floating point control register.</wrap> <wrap>HHC00013I Herc command: 'fpc 00000103'</wrap> <wrap>HHC02276I Floating point control register: 00000103</wrap> **<wrap>Figure 134: FPC command (alter value)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 384</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.67 FPR (Display or alter floating point registers) \\ //8.67.1 Function//</wrap>** <wrap>The FPR command displays or alters the actual contents of the floating point registers (basic format). If the AFP bit is set in Control Register 0 then additional floating point registers are displayed (extended format). Enter FPR by itself to display the register values without altering them.</wrap> **//<wrap>8.67.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>FPR [</wrap>////<wrap>nn=xxxxxxxxxxxxxxxx</wrap>////<wrap>]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ FPR ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬</wrap>// //<wrap>nn=xxxxxxxxxxxxxxxx</wrap>// **//<wrap>8.67.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This specifies the register number (0,2,4,6 or 0-15, depending on the Control Register 0 AFP bit) to be altered.</wrap> **//<wrap>xxxxxxxxxxxxxxxx </wrap>//**<wrap>This is the register value in hexadecimal (1-16 hex digits for 64-bit registers).</wrap> **//<wrap>8.67.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the floating point registers.</wrap> <wrap>HHC00013I Herc command: 'fpr'</wrap> <wrap>HHC02270I Floating point registers</wrap> <wrap>HHC02270I CP00: FPR0=0000000000000000 FPR2=0000000000000000</wrap> <wrap>HHC02270I CP00: FPR4=0000000000000000 FPR6=0000000000000000</wrap> **<wrap>Figure 135: FPR command (display value)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 385</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Alter the floating point register 04.</wrap> <wrap>HHC00013I Herc command: 'fpr 04=000000000000ffff'</wrap> <wrap>HHC02270I Floating point registers</wrap> <wrap>HHC02270I CP00: FPR0=0000000000000000 FPR2=0000000000000000</wrap> <wrap>HHC02270I CP00: FPR4=000000000000FFFF FPR6=0000000000000000</wrap> **<wrap>Figure 136: FPR command (alter value)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 386</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.68 G (Turn off instruction stepping and start all CPUs) //8.68.1 Function//</wrap>** <wrap>The G command turns off the instruction stepping and starts all the CPUs. This command has also to be used to continue normal processing after stopping the instruction stepping with the S- command.</wrap> **//<wrap>8.68.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>****<wrap>G</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>**<wrap>G</wrap>** **//<wrap>8.68.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.68.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Stop the instruction stepping and start the CPU.</wrap> <wrap>HHC00013I Herc command: 'g'</wrap> **<wrap>Figure 137: G command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 387</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.69 GPR (Display or alter general purpose registers) \\ //8.69.1 Function//</wrap>** <wrap>The GPR command displays or alters the actual content of the general purpose registers. Enter GPR by itself to display the register values without altering them.</wrap> **//<wrap>8.69.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>GPR [</wrap>//<wrap>nn=xxxxxxxx </wrap>//<wrap>| </wrap>//<wrap>nn=xxxxxxxxxxxxxxxx</wrap>////<wrap>]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬GPR¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§ \\ </wrap><wrap>ª</wrap><wrap>¬¬¬¬¬¬¬</wrap>//<wrap>nn=xxxxxxxx </wrap>////<wrap>¬¬¬¬¬¬¬« \\ </wrap>//<wrap>⡿¬¬_</wrap>//<wrap>nn=xxxxxxxxxxxxxxxx </wrap>//<wrap>¬¬¬</wrap> **//<wrap>8.69.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This specifies the optional register number (00-15) to be altered.</wrap> **//<wrap>xxxxxxxx </wrap>//**<wrap>This is the register value in hexadecimal (1-8 hex digits for 32-bit registers, 1-16 hex digits for 64-bit registers).</wrap> **//<wrap>8.69.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the general purpose registers.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'gpr'</wrap> <wrap>HHC02269I General purpose registers</wrap> |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR00=00000000</wrap> </WRAP> |<WRAP><wrap>GR01=00000000</wrap> </WRAP> |<WRAP><wrap>GR02=0252E12C</wrap> </WRAP> |<WRAP><wrap>GR03=02501EB0</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR04=02502400</wrap> </WRAP> |<WRAP><wrap>GR05=00000C00</wrap> </WRAP> |<WRAP><wrap>GR06=01379E76</wrap> </WRAP> |<WRAP><wrap>GR07=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR08=0248EF58</wrap> </WRAP> |<WRAP><wrap>GR09=00000000</wrap> </WRAP> |<WRAP><wrap>GR10=0252EF7F</wrap> </WRAP> |<WRAP><wrap>GR11=0252DF80</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR12=813799C8</wrap> </WRAP> |<WRAP><wrap>GR13=0252DF80</wrap> </WRAP> |<WRAP><wrap>GR14=81379D22</wrap> </WRAP> |<WRAP><wrap>GR15=00000C00</wrap> </WRAP> | **<wrap>Figure 138: GPR command (display general purpose registers)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 388</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Alter general purpose register number 15.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'gpr 15=ffffffff' \\ HHC02269I General purpose registers</wrap> |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR00=00000000</wrap> </WRAP> |<WRAP><wrap>GR01=00000000</wrap> </WRAP> |<WRAP><wrap>GR02=0252E12C</wrap> </WRAP> |<WRAP><wrap>GR03=02501EB0</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR04=02502400</wrap> </WRAP> |<WRAP><wrap>GR05=00000C00</wrap> </WRAP> |<WRAP><wrap>GR06=01379E76</wrap> </WRAP> |<WRAP><wrap>GR07=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR08=0248EF58</wrap> </WRAP> |<WRAP><wrap>GR09=00000000</wrap> </WRAP> |<WRAP><wrap>GR10=0252EF7F</wrap> </WRAP> |<WRAP><wrap>GR11=0252DF80</wrap> </WRAP> | |<WRAP><wrap>HHC02269I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR12=813799C8</wrap> </WRAP> |<WRAP><wrap>GR13=0252DF80</wrap> </WRAP> |<WRAP><wrap>GR14=81379D22</wrap> </WRAP> |<WRAP><wrap>GR15=00000C00</wrap> </WRAP> | **<wrap>Figure 139: GPR command (alter general purpose register)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 389</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.70 HAO (Hercules Automatic Operator) \\ //8.70.1 Function//</wrap>** <wrap>The Hercules Automatic operator (HAO) feature is a facility that allows to automatically issue console commands in response to certain messages being issued. To use the HAO facility it is necessary to define a rule, consisting of a target and an associated command.</wrap> <wrap>The Hercules Automatic Operator is only for those messages issued by Hercules to its console. It cannot be used for messages issued from the guest operating system.</wrap> <wrap>The current implementation limits the total number of defined rules to 64. There is currently no way to define a command whose arguments varies based on actual message text. All of the defined rules are checked for a match each time Hercules issues a message, there is no way at this time to stop the processing of subsequent rules.</wrap> **//<wrap>8.70.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>HAO </wrap>//<wrap>command </wrap>//<wrap>[</wrap>//<wrap>operands</wrap>//<wrap>] \\ where </wrap>//<wrap>command </wrap>//<wrap>can be:</wrap> <wrap>TGT </wrap>//<wrap>target</wrap>// <wrap>CMD </wrap>//<wrap>consolecmd</wrap>// <wrap>DEL </wrap>//<wrap>nn</wrap>// <wrap>CLEAR</wrap> <wrap>LIST [</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ HAO ¬¬¬« command</wrap> <wrap>where </wrap>//<wrap>command </wrap>//<wrap>can be: ª¬¬¬ TGT ¬¬¬ </wrap>//<wrap>target </wrap>//<wrap>¬¬¬¬ ª¬¬¬ CMD ¬¬¬ </wrap>//<wrap>consolecmd </wrap>//<wrap>ª¬¬¬ DEL ¬¬¬ </wrap>//<wrap>nn </wrap>//<wrap>¬¬¬¬¬¬¬¬</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 390</wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>ª_</wrap>**<wrap>¬¬ </wrap>**<wrap>CLEAR%%__%%%%__%%%%__%%_</wrap>**<wrap>¬¬</wrap> **<wrap>I%%__%%_ LIST %%__%%___§__%%__%%%%__%%%%__%%</wrap>** **<wrap>⡿%%__%%_</wrap>**//<wrap>nn</wrap>// </WRAP> | **//<wrap>8.70.3 Parameter</wrap>//** **<wrap>TGT </wrap>**<wrap>This is the keyword to define a new rule (pattern).</wrap> **//<wrap>target </wrap>//**<wrap>Specifies the rule (pattern) to react on. The target is a regular expression pattern which is matched against the text of the messages that Hercules issues.</wrap> **<wrap>CMD </wrap>**<wrap>This is the keyword to specify a command for a previously defined rule.</wrap> **//<wrap>consolecmd </wrap>//**<wrap>Specifies the command to be executed if a target rule matches. The associated command must be a valid Hercules console command.</wrap> **<wrap>LIST </wrap>**<wrap>List all rules/commands or list only rule/command at index //nn//.</wrap> **<wrap>DEL </wrap>**<wrap>Delete rule and command at index //nn//.</wrap> **//<wrap>nn </wrap>//**<wrap>Number of the index to be listed or deleted.</wrap> **<wrap>CLEAR </wrap>**<wrap>Specifies to delete all defined rules. This stops the Automatic Operator.</wrap> **//<wrap>8.70.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Define target rule: Check for message HHC01600E ("Unknown Hercules command").</wrap> <wrap>HHC00013I Herc command: 'hao tgt hhc01600e' \\ HHC00077I The 'target' was placed at index 0</wrap> **<wrap>Figure 140: HAO command (define target rule).</wrap>** **<wrap>Example 2:</wrap>** <wrap>Define command for target rule: Issue "?" command (List all valid commands).</wrap> <wrap>HHC00013I Herc command: 'hao cmd help'</wrap> <wrap>HHC00077I The 'command' was placed at index 0</wrap> **<wrap>Figure 141: HAO command (define command)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 391</wrap> <wrap>\\ </wrap>**<wrap>Example 3:</wrap>** <wrap>List all defined rules.</wrap> <wrap>HHC00013I Herc command: 'hao list'</wrap> <wrap>HHC00087I The defined Hercules Automatic Operator rule(s) are: \\ HHC00088I Index 00: target 'hhc01600e' -> command 'help' \\ HHC00082I 1 rule(s) displayed</wrap> **<wrap>Figure 142: HAO command (list defined rules)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Delete rule at index 0.</wrap> <wrap>HHC00013I Herc command: 'hao del 0'</wrap> <wrap>HHC00086I Rule at index 0 successfully deleted</wrap> **<wrap>Figure 143: HAO command (delete rule)</wrap>** **<wrap>Example 5:</wrap>** <wrap>Delete all rules (stop Hercules Automatic Operator).</wrap> <wrap><wrap>{{hercules:userref:bf:image062.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image062.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap>HHC00013I Herc command: 'hao clear' HHC00080I All HAO rules are cleared</wrap> **<wrap>Figure 144: HAO command (delete all rules)</wrap>** **<wrap>Example 6:</wrap>** <wrap>Sample of automatic execution of a command (triggered via the use of an unknown console command, as defined in examples 1 and 2).</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'offload'</wrap> <wrap>HHC01600E Unknown herc command 'offload', enter 'help' for a list of valid commands</wrap> <wrap>HHC00007I Previous message from function ProcessPanelCommand() at cmdtab.c[286]</wrap> <wrap>HHC00081I Match at index 00, executing command 'help'</wrap> <wrap>HHC00013I Herc command: 'help'</wrap> <wrap>HHC01602I Command Description</wrap> <wrap>HHC01602I ------ </wrap> <wrap>HHC01602I help list all commands / command specific help</wrap> <wrap>HHC01602I ? alias for help</wrap> <wrap>HHC01602I cmdlevel Display/Set current command group</wrap> <wrap>HHC01602I cmdlvl Alias for cmdlevel</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 145: HAO fired command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 392</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.71 HELP (List all commands / command specific help) //8.71.1 Function//</wrap>** <wrap>The “help” command without any options will display a sorted list of all commands matching the current command level with a short description. It is possible to specify a partial command name followed by an asterisk (“*”) to get a list of all commands matching that partial command name. For example ‘help msg*’ will list all commands beginning with ‘msg’ and matching the current command level.</wrap> <wrap>If the list is enterd with a full command name it will display a long form of help information associated with that command if the command is available for the current command level. The list provided by the command without options shows with an asterisk in front of the description if there is additional information available.</wrap> <wrap>The displayed help text may be limited to explaining the general format of the command and its various required or optional parameters and is not meant to replace the appropriate manual.</wrap> **//<wrap>8.71.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>HELP </wrap>**<wrap>[</wrap>//<wrap>command </wrap>//**<wrap>| </wrap>**//<wrap>cmd*</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>**<wrap>HELP </wrap>**<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬</wrap> **<wrap>ª--- </wrap>**//<wrap>command \\ </wrap>//**<wrap>⡿---- </wrap>**//<wrap>cmd* </wrap>//**<wrap>--</wrap>**<wrap></wrap> **//<wrap>8.71.3 Parameter</wrap>//** **//<wrap>command </wrap>//**<wrap>The Hercules console command to which additional information is desired.</wrap> **//<wrap>cmd* </wrap>//**<wrap>Provides a list of all commands beginning with the partial command name ‘cmd’ and matching the current command level.</wrap> **//<wrap>8.71.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>List all valid console commands matching the current command level.</wrap> <wrap>HHC00013I Herc command: 'help' \\ HHC01603I</wrap> <wrap>HHC01602I Command Description</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 393</wrap> <wrap>\\ </wrap>|<WRAP><wrap>HHC01602I ----- </wrap> <wrap>HHC01602I !message *SCP priority messsage</wrap> <wrap>HHC01602I # Silent comment</wrap> <wrap>HHC01602I * Loud comment</wrap> <wrap>HHC01602I .reply *SCP command</wrap> <wrap>HHC01602I ? alias for help</wrap> <wrap>HHC01602I aea Display AEA tables</wrap> <wrap>HHC01602I aia Display AIA fields</wrap> <wrap>HHC01602I alrf Command deprecated: Use "archlvl" instead</wrap> <wrap>HHC01602I ar Display access registers</wrap> <wrap>HHC01602I archlvl *Set Architecture Level</wrap> <wrap>HHC01602I archmode Alias for archlvl</wrap> <wrap>HHC01602I asn_and_l Command deprecated: Use "archlvl" instead</wrap> <wrap>HHC01602I attach *Configure device</wrap> <wrap>HHC01602I auto_scsi *Command deprecated - Use "SCSIMOUNT"</wrap> <wrap>HHC01602I autoinit *Display/Set automatic create empty tape file switch HHC01602I automount *Display/Update allowable tape automount directories</wrap> <wrap>HHC01602I b *Set breakpoint</wrap> <wrap>HHC01602I b+ Set breakpoint</wrap> <wrap>HHC01602I b- *Delete breakpoint</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC01602I s{+/-}dev Turn CCW stepping on/off</wrap> <wrap>HHC01602I t *Instruction trace</wrap> <wrap>HHC01602I t+ *Instruction trace on</wrap> <wrap>HHC01602I t- Turn off instruction tracing</wrap> <wrap>HHC01602I t? *Instruction trace query</wrap> <wrap>HHC01602I timerint *Display or set timers update interval</wrap> <wrap>HHC01602I tlb Display TLB tables</wrap> <wrap>HHC01602I toddrag Display or set TOD clock drag factor</wrap> <wrap>HHC01602I todprio Set/Display todprio parameter</wrap> <wrap>HHC01602I traceopt *Instruction trace display options</wrap> <wrap>HHC01602I tt32 *Control/query CTCI-WIN functionality</wrap> <wrap>HHC01602I tzoffset Set tzoffset parameter</wrap> <wrap>HHC01602I t{+/-}CKD Turn CKD_KEY tracing on/off</wrap> <wrap>HHC01602I t{+/-}dev Turn CCW tracing on/off</wrap> <wrap>HHC01602I u Disassemble storage</wrap> <wrap>HHC01602I uptime Display how long Hercules has been running</wrap> <wrap>HHC01602I v *Display or alter virtual storage</wrap> <wrap>HHC01602I version Display version information</wrap> <wrap>HHC01602I xpndsize *Define/Display xpndsize parameter</wrap> <wrap>HHC01602I yroffset Set yroffset parameter</wrap> <wrap>HHC01603I</wrap> <wrap>HHC01610I (*) More help available.</wrap> </WRAP> | **<wrap>Figure 146: HELP command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 394</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Display a list of commands beginning with ‘cpu’ and matching the current command level.</wrap> <wrap>HHC00013I Herc command: 'help cpu*' \\ HHC01603I</wrap> <wrap>HHC01602I Command Description</wrap> <wrap>HHC01602I ------ </wrap> <wrap>HHC01602I cpu *Define target cpu for panel display and commands</wrap> <wrap>HHC01602I cpuidfmt Set format 0/1 STIDP generation</wrap> <wrap>HHC01602I cpumodel Set CPU model number</wrap> <wrap>HHC01602I cpuprio Set/Display cpuprio parameter</wrap> <wrap>HHC01602I cpuserial Set CPU serial number</wrap> <wrap>HHC01602I cpuverid Set CPU verion number</wrap> <wrap>HHC01603I</wrap> <wrap>HHC01610I (*) More help available.</wrap> **<wrap>Figure 147: HELP CPU* command</wrap>** **<wrap>Example 3:</wrap>** <wrap>Display additional help text for the MAINSIZE command.</wrap> <wrap>HHC00013I Herc command: 'help mainsize' \\ HHC01603I</wrap> <wrap>HHC01602I Command Description</wrap> <wrap>HHC01602I ------ </wrap> <wrap>HHC01602I mainsize *Define/Display mainsize parameter</wrap> <wrap>HHC01603I</wrap> <wrap>HHC01603I Format: mainsize [ mmmm | nnnS [ lOCK | unlOCK ] ]</wrap> <wrap>HHC01603I mmmm - define main storage size mmmm Megabytes \\ HHC01603I</wrap> <wrap>HHC01603I nnnS - define main storage size nnn S where S is the multiplier</wrap> <wrap>HHC01603I B = no multiplier</wrap> <wrap>HHC01603I K = 2%%**%%10 (kilo/kibi)</wrap> <wrap>HHC01603I M = 2%%**%%20 (mega/mebi)</wrap> <wrap>HHC01603I G = 2%%**%%30 (giga/gibi)</wrap> <wrap>HHC01603I T = 2%%**%%40 (tera/tebi)</wrap> <wrap>HHC01603I P = 2%%**%%50 (peta/pebi)</wrap> <wrap>HHC01603I E = 2%%**%%60 (exa/exbi) \\ HHC01603I</wrap> <wrap>HHC01603I lOCK - attempt to lock storage (pages lock by host OS)</wrap> <wrap>HHC01603I unlOCK - leave storage unlocked (pagable by host OS) \\ HHC01603I</wrap> <wrap>HHC01603I (none) - display current mainsize value</wrap> <wrap>HHC01603I</wrap> <wrap>HHC01603I Note: Multipliers 'T', 'P', and 'E' are not available on 32bit machines</wrap> **<wrap>Figure 148: HELP MAINSIZE command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 395</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.72 HERC (Send Hercules command) \\ //8.72.1 Function//</wrap>** <wrap>The HERC command sends a command in any CMDTGT mode to the Hercules Emulator. See also CMDTGT, SCP and PSCP commands.</wrap> **//<wrap>8.72.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>HERC [</wrap>//<wrap>cmd]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬HERC</wrap> //<wrap>cmd</wrap>// **//<wrap>8.72.3 Parameter</wrap>//** **//<wrap>cmd </wrap>//**<wrap>This is the command to be sent to the Hercules Emulator.</wrap> **//<wrap>8.72.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Send a Hercules command in SCP or PSCP command target mode..</wrap> <wrap>HHC00013I Herc command: 'herc psw'</wrap> <wrap>HHC02278I Program status word: 040C6000 815E43EA</wrap> <wrap>HHC02300I sm=04 pk=0 cmwp=C as=ar cc=2 pm=0 am=31 ia=15E43D8</wrap> **<wrap>Figure 149: HERC command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 396</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.73 HERCLOGO (Read new Hercules logo file) \\ //8.73.1 Function//</wrap>** <wrap>The HERCLOGO command loads a new logo file for 3270 terminal sessions. The logo file defines a welcome screen that is presented when a TN3270 terminal connects to a Hercules 3270 device. For details on how to code the logo file see chapter 10. If no filename is specified then the built-in logo is used instead.</wrap> **//<wrap>8.73.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>HERCL0G0 [</wrap>****//<wrap>filename</wrap>//****<wrap>]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬HERCL0G0¬¬¬§</wrap>** **//<wrap>filename</wrap>//** **//<wrap>8.73.3 Parameter</wrap>//** **//<wrap>filename </wrap>//**<wrap>The name (and optionally path) of a logo text file. If no path is specified the logo file is first searched in the current working directory and second in the directory where the Hercules executable resides. If no filename is specified the built-in logo is used instead.</wrap> **//<wrap>8.73.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Load a new logo file.</wrap> <wrap>HHC00013I Herc command: 'herclogo </wrap>[[file:///d:/hercules/conf/herclogo.txt|<wrap>d:%%\%%hercules%%\%%conf%%\%%herclogo.txt</wrap>]]<wrap>'</wrap> **<wrap>Figure 150: HERCLOGO command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 397</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.74 HERCPRIO (Display or set Hercules process priority) //8.74.1 Function//</wrap>** <wrap>The HERCPRIO console command is used to change the process priority for Hercules. See section 5.82 for details on process and thread priorities. Given without an argument the HERCPRIO command displays the current Hercules process priority.</wrap> **<wrap>Caution: </wrap>**<wrap>HERCPRIO should not have a higher dispatching priority than the TOD clock and timer thread.</wrap> **//<wrap>8.74.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>HERCPRI0 </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>HERCPRI0</wrap> //<wrap>nn</wrap>// **//<wrap>8.74.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This value specifies the process priority for Hercules. For details on the priority values see section 5.82 (“Process and Thread Priorities”).</wrap> **//<wrap>8.74.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the Hercules process priority to 0.</wrap> <wrap>HHC00013I Herc command: 'hercprio 0'</wrap> <wrap>HHC02204I hercprio set to 0</wrap> **<wrap>Figure 151: HERCPRIO command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 398</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.75 HST (History of commands) \\ //8.75.1 Function//</wrap>** <wrap>The HST command displays a list of the last commands entered from the command line. Usually every issued command is automatically added to the command recall history list. To prevent a command from appearing in the command recall history list it must be prefixed with a hyphen (‘-‘) to make it a silent non-echoing command.</wrap> **//<wrap>8.75.2 Syntax</wrap>//** {{hercules:userref:bf:image063.gif|}}{{hercules:userref:bf:image082.gif|}}{{hercules:userref:bf:image083.gif|}}**//<wrap>8.75.3 Parameter</wrap>//** **<wrap>-1 </wrap>**<wrap>HST -1 is the same as HST without argument and retrieves the last entered command.</wrap> **<wrap>[-]//n //</wrap>**<wrap>If n is a positive number then HST retrieves the n-th command from the list. If n is a negative number then HST retrieves the n-th last command from the list.</wrap> **<wrap>L or 0 </wrap>**<wrap>HST L or HST 0 (number "0") displays a list of the last ten commands entered on the command line.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 399</wrap> <wrap>\\ </wrap>**//<wrap>8.75.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display a list of the last ten commands entered.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc</wrap> </WRAP> |<WRAP><wrap>command: 'hst 0'</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>30:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'aia'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>31:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'ar'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>32:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'clocks'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>33:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'cr'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>34:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'maxrates 60'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>35:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'help ds'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>36:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'gpr'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>37:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'http stop'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>38:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'http port 8080</wrap> </WRAP> |<WRAP><wrap>noauth'</wrap> </WRAP> | |<WRAP><wrap>HHC02273I</wrap> </WRAP> |<WRAP><wrap>Index</wrap> </WRAP> |<WRAP><wrap>39:<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>'http start'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 152: HST command (display command recall history list)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Prevent a command from being added to the command recall history list and display a list of the last ten entered commands.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'psw'</wrap> <wrap>HHC02278I Program status word: 0000000000000000 0000000000000000</wrap> <wrap>HHC02300I sm=00 pk=0 cmwp=0 as=pri cc=0 pm=0 am=24 ia=0</wrap> <wrap>HHC00013I Herc command: 'hst 0'</wrap> <wrap>HHC02273I Index 30: 'aia'</wrap> <wrap>HHC02273I Index 31: 'ar'</wrap> <wrap>HHC02273I Index 32: 'clocks'</wrap> <wrap>HHC02273I Index 33: 'cr'</wrap> <wrap>HHC02273I Index 34: 'maxrates 60'</wrap> <wrap>HHC02273I Index 35: 'help ds'</wrap> <wrap>HHC02273I Index 36: 'gpr'</wrap> <wrap>HHC02273I Index 37: 'http stop'</wrap> <wrap>HHC02273I Index 38: 'http port 8080 noauth'</wrap> <wrap>HHC02273I Index 39: 'http start'</wrap> **<wrap>Figure 153: HST command (issue silent non-echoing command)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 400</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.76 HTTP (Start, stop, modify and display HTTP server) //8.76.1 Function//</wrap>** <wrap>The HTTP console command configures the HTTP server. Depending on the given arguments the port on which the HTTP server will listen and the authorization (if any) or the location of the HTTP server files can be specified. Additional arguments allow to start or to stop the HTTP server. Given without an argument the HTTP command displays the current state of the HTTP server.</wrap> **//<wrap>8.76.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>HTTP [START | STOP | ROOT </wrap>//<wrap>path </wrap>//<wrap>| PORT </wrap>//<wrap>port </wrap>//<wrap>{NOAUTH | AUTH </wrap>//<wrap>userid password</wrap>//<wrap>}]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ HTTP ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>ª</wrap><wrap>¬¬¬ START ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>ª</wrap><wrap>¬¬¬ STOP ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ª%%__%%_ROOT %%__%%_ </wrap>//<wrap>path </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿%%__%%_ PORT ¬¬¬ </wrap>//<wrap>port </wrap>//<wrap>%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%% NOAUTH %%__%%%%__%%%%__%%%%__%%%%__%%«</wrap> <wrap>⡿%%__%%_ AUTH </wrap>//<wrap>userid password </wrap>//<wrap>%%__%%_¯</wrap> **//<wrap>8.76.3 Parameter</wrap>//** **<wrap>START </wrap>**<wrap>Start the HTTP server (if it is stopped).</wrap> **<wrap>STOP </wrap>**<wrap>Stop the HTTP server (if it is started).</wrap> **<wrap>ROOT </wrap>**<wrap>Keyword to specify the root directory of the HTTP server files. The HTTP root can only be set if the HTTP server is in the stopped state.</wrap> **//<wrap>path </wrap>//**<wrap>The full path of the root directory where the HTTP server files reside. If this parameter is not specified the default value for Win32 builds of Hercules is the directory where the Hercules executables themselves reside. For non-Win32 builds it is the directory specified as the default package installation directory when the Hercules executables were built. This can vary depending on how the Hercules package was built, it is commonly “/usr/local/share/hercules”.</wrap> **<wrap>PORT </wrap>**<wrap>Keyword to specify the port on which the HTTP server will listen (including optional authorization information). The HTTP port and authorization information can only be set if the HTTP server is in the stopped state.</wrap> **//<wrap>port </wrap>//**<wrap>The port number must be either 80 or within the range of 1024 to 65535 inclusive.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 401</wrap> <wrap>\\ </wrap>**<wrap>NOAUTH </wrap>**<wrap>NOAUTH indicates that no userid and password are required to access the HTTP server.</wrap> **<wrap>AUTH </wrap>**<wrap>AUTH indicates that a userid and a password are required to access the HTTP server. The userid and password have to be coded after the AUTH parameter.</wrap> **//<wrap>userid </wrap>//**<wrap>The userid can be any valid string.</wrap> **//<wrap>password </wrap>//**<wrap>The password can be any valid string.</wrap> **//<wrap>8.76.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the HTTP server status.</wrap> <wrap>HHC00013I Herc command: 'http'</wrap> <wrap>HHC01809I HTTP server is waiting for requests</wrap> <wrap>HHC01811I HTTP server root directory </wrap>[[file:///D:/HERCULES/HTML/|<wrap>D:/HERCULES/HTML/</wrap>]]<wrap>\\ HHC01808I HTTP server port is port=80 noauth</wrap> **<wrap>Figure 154: HTTP command (display HTTP server status)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Stop the HTTP server.</wrap> <wrap>HHC00013I Herc command: 'http stop'</wrap> <wrap>HHC01805I HTTP server signaled to stop</wrap> <wrap>HHC00101I Thread id 0000097C, prio 0, name 'HTTP server' ended</wrap> **<wrap>Figure 155: HTTP command (stop HTTP server)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the HTTP server root directory to “D:%%\%%Hercules%%\%%html”.</wrap> <wrap>HHC00013I Herc command: 'http root </wrap>[[file:///D:/Hercules/html|<wrap>D:/Hercules/html</wrap>]]<wrap>'</wrap> <wrap>HHC02204I httproot set to </wrap>[[file:///D:/Hercules/html/|<wrap>D:/Hercules/html/</wrap>]]<wrap></wrap> **<wrap>Figure 156: HTTP command (set HTTP server root directory)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 402</wrap> <wrap>\\ </wrap>**<wrap>Example 4:</wrap>** <wrap>Set the HTTP server port to 8081 with required authorization for access. The userid should be set to “hercuser” and the password to “hercpswd”.</wrap> <wrap>HHC00013I Herc command: 'http port 8081 auth hercuser hercpswd'</wrap> <wrap>HHC02204I port set to port=8081 auth userid<hercuser> password<hercpswd></wrap> **<wrap>Figure 157: HTTP command (set HTTP server port and authorization)</wrap>** **<wrap>Example 5:</wrap>** <wrap>Start the HTTP server.</wrap> <wrap>HHC00013I Herc command: 'http start'</wrap> <wrap>HHC01807I HTTP server signaled to start</wrap> <wrap>HHC00100I Thread id 00001344, prio 0, name 'HTTP server' started</wrap> <wrap>HHC01802I Using HTTPROOT directory '</wrap>[[file:///D:/Hercules/html/|<wrap>D:/Hercules/html/</wrap>]]<wrap>'</wrap> <wrap>HHC01803I Waiting for HTTP requests on port 8081</wrap> **<wrap>Figure 158: HTTP command (start HTTP server)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 403</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.77 I (Generate I/O attention interrupt for device) \\ //8.77.1 Function//</wrap>** <wrap>The I command generates an I/O attention interrupt for a certain device.</wrap> **//<wrap>8.77.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>I </wrap>//<wrap>device</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ I ¬¬¬ </wrap>//<wrap>device</wrap>// **//<wrap>8.77.3 Parameter</wrap>//** **//<wrap>device </wrap>//**<wrap>The number of the device for which an I/O attention interrupt will be generated.</wrap> **//<wrap>8.77.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Generate an I/O attention interrupt for device 0148.</wrap> <wrap>HHC00013I Herc command: 'i 000f'</wrap> <wrap>HHC02230I 0:000F attention request raised</wrap> **<wrap>Figure 159: I command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 404</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.78 ICOUNT (Display individual instruction counts) \\ //8.78.1 Function//</wrap>** <wrap>The ICOUNT command displays statistic information about how often every single machine instruction has been executed so far. By default the list sorted by the instruction code. An additional SORT option displays the instructions sorted by the usage count and percentage of usage</wrap> <wrap>The command is only available if Hercules is built with the “OPTION_INSTRUCTION_COUNTING” option. This option is not activated by default because ICOUNT is a debugging command.</wrap> **//<wrap>8.78.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>ICOUNT </wrap>****<wrap>[</wrap>****<wrap>SORT | CLEAR]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ</wrap>****<wrap>¬¬¬ </wrap>****<wrap>ICOUNT </wrap>****<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>** **<wrap>ª¬¬¬ SORT </wrap>****<wrap>¬¬¬¬«</wrap>** **<wrap>⡿¬¬¬ CLEAR ¬¬¬¯</wrap>** **//<wrap>8.78.3 Parameter</wrap>//** **<wrap>SORT </wrap>**<wrap>Displays the instructions sorted by the usage count and percentage of usage.</wrap> **<wrap>CLEAR </wrap>**<wrap>Clears the counters and start counting from zero.</wrap> **//<wrap>8.78.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the individual instruction counts.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'icount'</wrap> |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Instruction</wrap> </WRAP> ||<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>display:</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'4'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>32688</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'5'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>3695113</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'6'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1211081</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'7'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>5523916</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'8'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>30274</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'9'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>46739</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'0A'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>95360</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 405</wrap> <wrap>\\ </wrap>|<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'0E'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>20764</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'0F'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>955</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'10'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>113522</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'11'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>38753</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'12'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>5743006</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'13'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>189520</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'14'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>625578</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'15'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>504659</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'16'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>148266</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'17'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>114403</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'18'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>12153723</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'19'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4082623</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'1A'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>586980</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'1B'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>2519610</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'1C'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4505</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'1D'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>25093</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'1E'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1237759</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'1F'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>6595895</wrap> </WRAP> | |<WRAP><wrap>.</wrap> //<wrap>several lines</wrap>// <wrap>.</wrap> </WRAP> ||<WRAP>//<wrap>not displayed</wrap>// </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'B6'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>78</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'B7'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>46856</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'BA'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1518619</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'BB'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>584272</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'BD'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>464448</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'BE'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>538116</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'BF'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>877819</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'D1'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>234238</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'D2'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>2827438</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'D3'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>64695</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'D4'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>8923</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'D5'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>945073</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'D6'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>104993</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'D7'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>722277</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'DC'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1641</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'DD'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4296</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'DE'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>80</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'F1'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>43</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'F2'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>411</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'F3'<wrap></wrap></wrap><wrap></wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1741</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst</wrap> </WRAP> |<WRAP><wrap>'F8'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> | **<wrap>Figure 160: ICOUNT command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 406</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Display the individual instruction counts sorted by usage count and percentage of usage.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'icount sort'</wrap> |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Sorted instruction</wrap> </WRAP> ||<WRAP><wrap>count display:</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '47'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>45073338</wrap> </WRAP> |<WRAP><wrap>(19%)</wrap> </WRAP> | | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '58'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>30958976</wrap> </WRAP> |<WRAP><wrap>(13%)</wrap> </WRAP> | | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '91'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>17490895</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>7%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '50'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>17148150</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>7%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '18'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>12193746</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>5%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '41'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>7487721</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>3%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '1F'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>6621520</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>2%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '48'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>6394646</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>2%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '12'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>5782677</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>2%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '54'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>5649330</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>2%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '07'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>5526616</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>2%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '5E'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4976470</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>2%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '19'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4096278</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>1%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '96'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>3834527</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>1%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '95'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>3765941</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>1%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '94'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>3755916</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>1%)</wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP>//<wrap>several lines not displayed</wrap>// </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'B20D'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4941</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '1C'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4591</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'B209'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4442</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'DD'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>4296</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '5C'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>3566</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '57'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>3391</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '8D'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>3127</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'F3'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1741</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'DC'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1641</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '4E'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1339</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '97'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1046</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '0F'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>955</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '93'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>699</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '4F'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>435</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'F2'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>411</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'B206'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>179</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'B6'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>114</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'DE'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>80</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'F1'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>43</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'B208'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>30</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'B202'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>15</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'B203'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>6</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '28'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>3</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'B200'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst 'F8'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | |<WRAP><wrap>HHC02292I</wrap> </WRAP> |<WRAP><wrap>Inst '35'</wrap> </WRAP> |<WRAP><wrap>count</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>(</wrap> </WRAP> |<WRAP><wrap>0%)</wrap> </WRAP> | **<wrap>Figure 161: ICOUNT command (sorted)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 407</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.79 IODELAY (Display or set I/O delay value) \\ //8.79.1 Function//</wrap>** <wrap>The IODELAY command displays the current setting or sets the amount of time in microseconds to wait after an I/O interrupt is ready to be set pending. The purpose of this parameter is to bypass a bug in the Linux/390 and z/Linux ‘dasd.c’ device driver. The problem is more apt to happen under Hercules than on a real machine, as Hercules may present an I/O interrupt sooner than a real machine.</wrap> <wrap>NOTE: OSTAILOR LINUX no longer sets IODELAY to 800 since the problem described above is no longer present in recent versions of the Linux kernel.</wrap> **//<wrap>8.79.2 Syntax</wrap>//** {{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image084.gif|}}{{hercules:userref:bf:image085.gif|}}{{hercules:userref:bf:image086.gif|}}**//<wrap>8.79.3 Parameter</wrap>//** **//<wrap>usecs </wrap>//**<wrap>Amount of time in microseconds to wait after an I/O interrupt is ready to be set pending.</wrap> **<wrap>NOWARN </wrap>**<wrap>If the IODELAY value is non-zero a warning message will be issued unless </wrap><wrap>NOWARN </wrap><wrap>is specified.</wrap> **//<wrap>8.79.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current IODELAY value.</wrap> <wrap>HHC00013I Herc command: 'iodelay'</wrap> <wrap>HHC02203I iodelay : 0</wrap> **<wrap>Figure 162: IODELAY command (display value)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 408</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Change the IODELAY value to 50 microseconds.</wrap> <wrap>HHC00013I Herc command: 'iodelay 50'</wrap> <wrap>HHC02204I iodelay set to 50</wrap> **<wrap>Figure 163: IODELAY command (set value)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 409</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.80 IPENDING (Display pending interrupts) \\ //8.80.1 Function//</wrap>** <wrap>The IPENDING command displays the pending interrupts for each CPU and some lock information.</wrap> **//<wrap>8.80.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>IPENDING</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ IPENDING</wrap>** **//<wrap>8.80.3 Parameter</wrap>//** <wrap>None</wrap> **//<wrap>8.80.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display pending interrupts.</wrap> <wrap>HHC00013I Herc command: 'ipending'</wrap> <wrap>HHC00850I Processor CP00: CPUint=00000001 (State:00000081)&(Mask:CF00EC4B)</wrap> <wrap>HHC00851I Processor CP00: interrupt not pending</wrap> <wrap>HHC00852I Processor CP00: I/O interrupt not pending</wrap> <wrap>HHC00853I Processor CP00: clock comparator not pending</wrap> <wrap>HHC00854I Processor CP00: CPU timer not pending</wrap> <wrap>HHC00855I Processor CP00: interval timer pending</wrap> <wrap>HHC00856I Processor CP00: ECPS vtimer not pending</wrap> <wrap>HHC00857I Processor CP00: external call not pending</wrap> <wrap>HHC00858I Processor CP00: emergency signal not pending</wrap> <wrap>HHC00859I Processor CP00: machine check interrupt not pending</wrap> <wrap>HHC00860I Processor CP00: service signal not pending</wrap> <wrap>HHC00861I Processor CP00: mainlock held: no</wrap> <wrap>HHC00862I Processor CP00: intlock held: no</wrap> <wrap>HHC00863I Processor CP00: waiting for intlock: no</wrap> <wrap>HHC00864I Processor CP00: lock not held</wrap> <wrap>HHC00865I Processor CP00: connected to channelset 0000</wrap> <wrap>HHC00866I Processor CP00: state STARTED</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 410</wrap> <wrap>\\ </wrap><wrap>HHC00867I Processor CP00: instcount 111019557</wrap> <wrap>HHC00868I Processor CP00: siocount 5181</wrap> <wrap>HHC00869I Processor CP00: psw 070E000000000000</wrap> <wrap>HHC00850I Processor CP01: CPUint=80000000 (State:80000001)&(Mask:8000000A)</wrap> <wrap>HHC00851I Processor CP01: interrupt pending</wrap> <wrap>HHC00852I Processor CP01: I/O interrupt not pending</wrap> <wrap>HHC00853I Processor CP01: clock comparator not pending</wrap> <wrap>HHC00854I Processor CP01: CPU timer not pending</wrap> <wrap>HHC00855I Processor CP01: interval timer not pending</wrap> <wrap>HHC00856I Processor CP01: ECPS vtimer not pending</wrap> <wrap>HHC00857I Processor CP01: external call not pending</wrap> <wrap>HHC00858I Processor CP01: emergency signal not pending</wrap> <wrap>HHC00859I Processor CP01: machine check interrupt not pending</wrap> <wrap>HHC00860I Processor CP01: service signal not pending</wrap> <wrap>HHC00861I Processor CP01: mainlock held: no</wrap> <wrap>HHC00862I Processor CP01: intlock held: no</wrap> <wrap>HHC00863I Processor CP01: waiting for intlock: no</wrap> <wrap>HHC00864I Processor CP01: lock not held</wrap> <wrap>HHC00865I Processor CP01: connected to channelset 0001</wrap> <wrap>HHC00866I Processor CP01: state STOPPED</wrap> <wrap>HHC00867I Processor CP01: instcount 0</wrap> <wrap>HHC00868I Processor CP01: siocount 0</wrap> <wrap>HHC00869I Processor CP01: psw 0000000000000000</wrap> <wrap>HHC00870I config mask 00000003 started mask 00000001 waiting mask 00000001</wrap> <wrap>HHC00871I syncbc mask 00000000</wrap> <wrap>HHC00872I signaling facility not busy</wrap> <wrap>HHC00873I TOD lock not held</wrap> <wrap>HHC00874I mainlock not held; owner ffff</wrap> <wrap>HHC00875I intlock not held; owner ffff</wrap> <wrap>HHC00881I I/O interrupt queue: (NULL)</wrap> **<wrap>Figure 164: IPENDING command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 411</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.81 IPL (IPL Normal from device xxxx) \\ //8.81.1 Function//</wrap>** <wrap>This console command performs the Initial Program Load (IPL) Normal manual function from the given device. The IPL command may also be used to perform a load from CD-ROM or server. For example if a standard SUSE S/390 Linux distribution CD is loaded and mounted on /cdrom, this CD-ROM may then be IPL’ed using //”IPL /cdrom/suse.ins”//.</wrap> <wrap>If the first operand is a device name (devnum is a 1- to 4-digit hexadecimal number), a CCW-type IPL is initiated from the indicated device number and SCLP disk I/O is disabled.</wrap> <wrap>If the first operand is a filename a list-directed IPL is performed from the specified ".ins" file and SCLP disk I/O is enabled for the directory path where the ".ins" file is located.</wrap> <wrap>An optional ‘LOADPARM’ keyword followed by a 1-8 character string can be used to set the LOADPARM prior to IPL.</wrap> <wrap>An optional 'PARM' keyword followed by a string can also be passed to the IPL command processor. The string will be loaded into the low-order 32 bits of the general purpose registers (4 characters per register for up to 64 bytes). The PARM option behaves similarly to the VM IPL command.</wrap> <wrap>An optional 'CLEAR' keyword will initiate a Load Clear manual control function, prior to starting an IPL.</wrap> **//<wrap>8.81.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>IPL {</wrap>//<wrap>devnum </wrap>//<wrap>| </wrap>//<wrap>filename</wrap>//<wrap>} [L0ADPARM </wrap>//<wrap>iplparm </wrap>//<wrap>| PARM </wrap>//<wrap>parmstring</wrap>//<wrap>] </wrap><wrap>[CLEAR]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬IPL ¬¬¬§¬¬¬ </wrap>//<wrap>devnum </wrap>//<wrap>¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>⡿¬¬_ </wrap>//<wrap>filename </wrap>//<wrap>¬¬¬¯ ª¬¬¬ L0ADPARM </wrap>//<wrap>iplparm </wrap>//<wrap>¬¬¬«</wrap> <wrap>⡿¬¬¬ PARM </wrap>//<wrap>parmstring </wrap>//<wrap>¬¬¬¬¯</wrap> <wrap>CLEAR</wrap> **//<wrap>8.81.3 Parameter</wrap>//** **//<wrap>devnum </wrap>//**<wrap>The device address from which the emulator will IPL the system.</wrap> **//<wrap>filename </wrap>//**<wrap>The name of a ".ins" file to be loaded.</wrap> **<wrap>LOADPARM </wrap>**<wrap>This is the optional LOADPARM keyword.</wrap> **//<wrap>iplparm </wrap>//**<wrap>This is an 1-8 byte character string used to set the LOADPARM prior to the IPL.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 412</wrap> <wrap>\\ </wrap><wrap>The parameter is operating system dependent, consult the relevant operating system documentation for details.</wrap> **<wrap>PARM </wrap>**<wrap>This is the optional PARM keyword.</wrap> **//<wrap>parmstring </wrap>//**<wrap>The character string (max. 64 bytes) to be passed to the IPL command processor. The character string will be loaded into the low-order 32 bits of the GPRs (4 characters per register).</wrap> **<wrap>CLEAR </wrap>**<wrap>Initiate a Load Clear manual control function, prior to starting an IPL.</wrap> **//<wrap>8.81.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>IPL normal from device 0148.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'ipl 0148'</wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:00C2</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>ccw 03000000 20000001=>040C0000</wrap> </WRAP> |<WRAP><wrap>0001CEFA 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 ............. </wrap> </WRAP> | |<WRAP><wrap>HHC01312I</wrap> </WRAP> |<WRAP><wrap>0:00C2</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>stat 0200, count 0001 "</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01313I</wrap> </WRAP> |<WRAP><wrap>0:00C2</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense 40000000 00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>HHC01314I</wrap> </WRAP> |<WRAP><wrap>0:00C2</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense INTREQ</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:00C3</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>ccw 03000000 20000001=>040C0000</wrap> </WRAP> |<WRAP><wrap>0001CEFA 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 ............. </wrap> </WRAP> | |<WRAP><wrap>HHC01312I</wrap> </WRAP> |<WRAP><wrap>0:00C3</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>stat 0200, count 0001 "</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01313I</wrap> </WRAP> |<WRAP><wrap>0:00C3</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense 40000000 00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>HHC01314I</wrap> </WRAP> |<WRAP><wrap>0:00C3</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense INTREQ</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:00C4</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>ccw 03000000 20000001=>040C0000</wrap> </WRAP> |<WRAP><wrap>0001CEFA 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 ............. </wrap> </WRAP> | |<WRAP><wrap>HHC01312I</wrap> </WRAP> |<WRAP><wrap>0:00C4</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>stat 0200, count 0001 "</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01313I</wrap> </WRAP> |<WRAP><wrap>0:00C4</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense 40000000 00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>HHC01314I</wrap> </WRAP> |<WRAP><wrap>0:00C4</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense INTREQ</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:00C5</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>ccw 03000000 20000001=>040C0000</wrap> </WRAP> |<WRAP><wrap>0001CEFA 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 ............. </wrap> </WRAP> | |<WRAP><wrap>HHC01312I</wrap> </WRAP> |<WRAP><wrap>0:00C5</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>stat 0200, count 0001 "</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01313I</wrap> </WRAP> |<WRAP><wrap>0:00C5</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense 40000000 00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>HHC01314I</wrap> </WRAP> |<WRAP><wrap>0:00C5</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense INTREQ</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:0480</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>ccw 03000000 20000001=>040C0000</wrap> </WRAP> |<WRAP><wrap>0001CEFA 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 ............. </wrap> </WRAP> | |<WRAP><wrap>HHC01312I</wrap> </WRAP> |<WRAP><wrap>0:0480</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>stat 0200, count 0001 "</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01313I</wrap> </WRAP> |<WRAP><wrap>0:0480</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense 40220000 00C00300 00000000</wrap> </WRAP> |<WRAP><wrap>00800100 010000FF</wrap> </WRAP> |<WRAP><wrap>FF000000</wrap> </WRAP> | |<WRAP><wrap>HHC01314I</wrap> </WRAP> |<WRAP><wrap>0:0480</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense INTREQ EOC WRI</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:0481</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>ccw 03000000 20000001=>040C0000</wrap> </WRAP> |<WRAP><wrap>0001CEFA 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 ............. </wrap> </WRAP> | |<WRAP><wrap>HHC01312I</wrap> </WRAP> |<WRAP><wrap>0:0481</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>stat 0200, count 0001 "</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01313I</wrap> </WRAP> |<WRAP><wrap>0:0481</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense 40220000 00C00300 00000000</wrap> </WRAP> |<WRAP><wrap>00800100 010000FF</wrap> </WRAP> |<WRAP><wrap>FF000000</wrap> </WRAP> | |<WRAP><wrap>HHC01314I</wrap> </WRAP> |<WRAP><wrap>0:0481</wrap> </WRAP> |<WRAP><wrap>CH:</wrap> </WRAP> |<WRAP><wrap>sense INTREQ EOC WRI</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 165: IPL command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 413</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.82 IPLC (IPL Clear from device xxxx) \\ //8.82.1 Function//</wrap>** <wrap>The IPLC console command has been deprecated. Please use the IPL command with the CLEAR option instead. See the IPL command for details.</wrap> **//<wrap>8.82.2 Syntax</wrap>//** <wrap>See IPL console command.</wrap> **//<wrap>8.82.3 Parameter</wrap>//** <wrap>See IPL console command.</wrap> **//<wrap>8.82.4 Examples</wrap>//** <wrap>See IPL console command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 414</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.83 K (Display CCKD internal trace) \\ //8.83.1 Function//</wrap>** <wrap>The K command displays the internal CCKD trace entries. Because the default value for the CCKD trace entries is set to zero, the trace must first be enabled by setting a trace entry value. This can be done either with the system parameter or the console command "CCKD TRACE=n", where n specifies the number of available trace entries and can be in the range of 1 to 200000.</wrap> <wrap>Please note that the K command can produce a lot of messages depending on the available trace entries.</wrap> **//<wrap>8.83.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>K</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ K</wrap>** **//<wrap>8.83.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.83.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current CCKD trace entries.</wrap> |<WRAP><wrap>HHC00013I HHC00399I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'k'</wrap> <wrap>CCKD file: internal cckd trace</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759838</wrap> </WRAP> |<WRAP><wrap>0:0148> start i/o file[0] bufcur 2588 cache[207]</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759842</wrap> </WRAP> |<WRAP><wrap>0:0148> end i/o bufcur 2588 cache[207] waiters 0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759848</wrap> </WRAP> |<WRAP><wrap>0:0148> start i/o file[0] bufcur 2588 cache[207]</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759852</wrap> </WRAP> |<WRAP><wrap>0:0148> read trk 2589 (synchronous)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759854</wrap> </WRAP> |<WRAP><wrap>0:0148> 0 rdtrk 2589</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759857</wrap> </WRAP> |<WRAP><wrap>0:0148> 0 rdtrk[208] 2589 syncio cache miss</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759868</wrap> </WRAP> |<WRAP><wrap>0:0148> read trk 2589 (asynchronous)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759872</wrap> </WRAP> |<WRAP><wrap>0:0148> 0 rdtrk 2589</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759875</wrap> </WRAP> |<WRAP><wrap>0:0148> 0 rdtrk[208] 2589 cache miss</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759888</wrap> </WRAP> |<WRAP><wrap>0:0148> 0 rdtrk[208] 2589 buf 0000000007F67CD0 len</wrap> </WRAP> |<WRAP><wrap>19456</wrap> </WRAP> | |<WRAP><wrap>HHC00398I</wrap> </WRAP> |<WRAP><wrap>02:07:32.759892</wrap> </WRAP> |<WRAP><wrap>0:0148> trk[2589] read_trkimg</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 415</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00398I 02:07:32.759894 0:0148> file[0] l2[10,29] trk[2589] read_l2ent 0x4d08</wrap> <wrap>HHC00398I 02:07:32.759898 0:0148> file[0] read_l2 10 active 0 10 2</wrap> <wrap>HHC00398I 02:07:32.759901 0:0148> file[0] l2[10,29] trk[2589] read_l2ent 0x14c1f2f 6290 6290</wrap> <wrap>HHC00398I 02:07:32.759904 0:0148> file[0] fd[16] read, off 0x14c1f2f len 6290</wrap> <wrap>HHC00398I 02:07:32.759918 0:0148> 0 rdtrk[208] 2589 complete buf 0000000007F67CD0:0100560009</wrap> <wrap>HHC00398I 02:07:32.759922 0:0148> uncompress comp 1 len 6290 maxlen 19456 trk 2589</wrap> <wrap>HHC00398I 02:07:32.760082 0:0148> uncompress zlib newlen 13065 rc 0</wrap> <wrap>HHC00398I 02:07:32.760085 0:0148> validating trk 2589 len 13065 0000560009 0056000900000008</wrap> <wrap> HHC00398I 02:07:32.760091 0:0148> read trk 2589 uncompressed len 13065 \\ HHC00398I 02:07:32.760096 0:0148> end i/o bufcur 2589 cache[208] waiters 0 HHC00398I 02:07:32.760104 0:0148> start i/o file[0] bufcur 2589 cache[208] HHC00398I 02:07:32.760112 0:0148> end i/o bufcur 2589 cache[208] waiters 0 HHC00398I 02:07:32.760118 0:0148> start i/o file[0] bufcur 2589 cache[208] HHC00398I 02:07:32.760124 0:0148> end i/o bufcur 2589 cache[208] waiters 0 .</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC00398I 02:07:32.760712 0:0148> end i/o bufcur 2589 cache[208] waiters 0 HHC00398I 02:07:32.760718 0:0148> start i/o file[0] bufcur 2589 cache[208] HHC00398I 02:07:32.760722 0:0148> end i/o bufcur 2589 cache[208] waiters 0 HHC00398I 02:07:32.760728 0:0148> start i/o file[0] bufcur 2589 cache[208]</wrap> <wrap> HHC00398I 02:07:32.760732 0:0148> read trk 2590 (synchronous)</wrap> <wrap> HHC00398I 02:07:32.760734 0:0148> 0 rdtrk 2590</wrap> <wrap>HHC00398I 02:07:32.760737 0:0148> 0 rdtrk[209] 2590 syncio cache miss</wrap> <wrap> HHC00398I 02:07:32.760748 0:0148> read trk 2590 (asynchronous)</wrap> <wrap> HHC00398I 02:07:32.760751 0:0148> 0 rdtrk 2590</wrap> <wrap>HHC00398I 02:07:32.760754 0:0148> 0 rdtrk[209] 2590 cache miss</wrap> <wrap>HHC00398I 02:07:32.760769 0:0148> 0 rdtrk[209] 2590 buf 0000000007F6C8E0 len 19456</wrap> <wrap>HHC00398I 02:07:32.760773 0:0148> trk[2590] read_trkimg</wrap> <wrap>HHC00398I 02:07:32.760775 0:0148> file[0] l2[10,30] trk[2590] read_l2ent 0x4d08</wrap> <wrap>HHC00398I 02:07:32.760779 0:0148> file[0] read_l2 10 active 0 10 2</wrap> <wrap>HHC00398I 02:07:32.760782 0:0148> file[0] l2[10,30] trk[2590] read_l2ent 0x14c37c1 4716 4716</wrap> <wrap>HHC00398I 02:07:32.760785 0:0148> file[0] fd[16] read, off 0x14c37c1 len 4716</wrap> <wrap>HHC00398I 02:07:32.760798 0:0148> 0 rdtrk[209] 2590 complete buf 0000000007F6C8E0:010056000a</wrap> <wrap>HHC00398I 02:07:32.760803 0:0148> uncompress comp 1 len 4716 maxlen 19456 trk 2590</wrap> <wrap>HHC00398I 02:07:32.760927 0:0148> uncompress zlib newlen 9813 rc 0</wrap> <wrap>HHC00398I 02:07:32.760929 0:0148> validating trk 2590 len 9813 000056000a 0056000a00000008</wrap> <wrap> HHC00398I 02:07:32.760935 0:0148> read trk 2590 uncompressed len 9813</wrap> <wrap>HHC00398I 02:07:32.760940 0:0148> end i/o bufcur 2590 cache[209] waiters 0 HHC00398I 02:07:32.760947 0:0148> start i/o file[0] bufcur 2590 cache[209] HHC00398I 02:07:32.760954 0:0148> end i/o bufcur 2590 cache[209] waiters 0 HHC00398I 02:07:32.760960 0:0148> start i/o file[0] bufcur 2590 cache[209] HHC00398I 02:07:32.760966 0:0148> end i/o bufcur 2590 cache[209] waiters 0 .</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 166: K command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 416</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.84 KD (Clear held messages) \\ //8.84.1 Function//</wrap>** <wrap>The KD command is an alias for 'MSGHLD CLEAR' and is used to release all held messages without having to wait for the timeout period to expire.</wrap> **//<wrap>8.84.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>****<wrap>KD</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>**<wrap>KD</wrap>** **//<wrap>8.84.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.84.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Release all held messages.</wrap> <wrap>HHC00013I Herc command: 'kd' \\ HHC02226I Held messages cleared</wrap> **<wrap>Figure 167: KD command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 417</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.85 LDMOD (Load a module) \\ //8.85.1 Function//</wrap>** <wrap>The LDMOD command instructs the Hercules Dynamic Loader to load an additional module. The default search order is within the Hercules directory and in the default DLL search path.</wrap> **//<wrap>8.85.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LM0D </wrap>//<wrap>module </wrap>//<wrap>[</wrap>//<wrap>module </wrap>//<wrap>[</wrap>//<wrap>module </wrap>//<wrap>...11</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ LDM0D ¬¬¬°¬¬¬ </wrap>//<wrap>module</wrap>// **//<wrap>8.85.3 Parameter</wrap>//** **//<wrap>module </wrap>//**<wrap>A list of modules that are to be loaded.</wrap> **//<wrap>8.85.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Load module “S37X” (S/370 Extension).</wrap> <wrap>HHC00013I Herc command: 'ldmod s37x' \\ HHC01526I HDL: loading module 's37x'... \\ HHC01527I HDL: module 's37x' loaded</wrap> **<wrap>Figure 168: LDMOD command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 418</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.86 LEGACYSENSEID (Display or set SENSE ID CCW (x'E4') feature) //8.86.1 Function//</wrap>** <wrap>The LEGACYSENSEID command specifies whether the SENSE ID CCW (X'E4') will be honoured for the devices that originally did not support that feature. This includes (but may not be limited to) 3410 and 3420 tape drives, 2311 and 2314 direct access storage devices and 2703 communication controllers. Because those legacy devices didn't originally support this command, and for compatibility reasons, the default is OFF or DISABLE.</wrap> <wrap>Specify ON or ENABLE, if your guest operating system needs the Sense ID support to dynamically detect those devices. Note that most current operating systems will not detect those devices even though Sense ID is enabled because those devices never supported the Sense ID in the first place. This mainly applies to custom built or modified versions of guest operating systems that are aware of this specific Hercules capability.</wrap> <wrap>Given without an argument the LEGACYSENSEID command displays the current setting.</wrap> **//<wrap>8.86.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LEGACYSENSEID (</wrap>__<wrap>OFF</wrap>__<wrap> | </wrap>__<wrap>DISABLE</wrap>__<wrap> | ON | ENABLE}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>LEGACYSENSEID </wrap><wrap>¬¬¬§¬¬¬¬¬ </wrap>__<wrap>OFF</wrap>__<wrap> ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ </wrap>__<wrap>DISABLE</wrap>__<wrap> ¬¬¬«</wrap> <wrap>ª¬¬¬ ¬ ON ¬¬¬¬¬¬I</wrap> <wrap>⡿¬¬¬ENABLE¬¬¬¬¯</wrap> **//<wrap>8.86.3 Parameter</wrap>//** **<wrap>OFF </wrap>**<wrap>Specify OFF or DISABLE if your guest operating system does not need the Sense ID support to dynamically detect devices that originally did not support that feature. This is the default.</wrap> **<wrap>DISABLE </wrap>**<wrap>This is the same os ‘OFF’.</wrap> **<wrap>ON </wrap>**<wrap>Specify ON or ENABLE if your guest operating system needs the Sense ID support to dynamically detect devices that originally did not support that feature.</wrap> **<wrap>ENABLE </wrap>**<wrap>This is the same as ‘ON’.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 419</wrap> <wrap>\\ </wrap>**//<wrap>8.86.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify that the SENSE ID CCW will be honoured for devices that originally did not support that feature.</wrap> <wrap>HHC00013I Herc command: 'legacysenseid enable' \\ HHC02204I legacysenseid set to enabled</wrap> **<wrap>Figure 169: LEGACYSENSEID command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 420</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.87 LOADCORE (Load a core image from a file) \\ //8.87.1 Function//</wrap>** <wrap>The LOADCORE command allows you to load a binary data file into real storage. This function is used mainly for emulator debugging purposes. A certain core snapshot that was saved can be restored at any later time to reproduce some tests with identical real storage values. The file //filename //is presumed to be a pure binary image file previously created via the SAVECORE command. Please note that you must stop all CPUs (see STOP / STOPALL commands) before loading a core image from a file.</wrap> **//<wrap>8.87.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>L0ADC0RE </wrap>//<wrap>filename </wrap>//<wrap>[</wrap>//<wrap>address </wrap>//<wrap>| 0</wrap><wrap>]</wrap> **__<wrap>Diagram \\ Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬¬¬ </wrap><wrap>0 </wrap><wrap>¬¬¬¬¬¬®</wrap> <wrap>ÊÊ¬¬¬ L0ADC0RE ¬¬¬ </wrap>//<wrap>filename </wrap>//<wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿¬¬¬ </wrap>//<wrap>address </wrap>//<wrap>¬¬¬¯</wrap> </WRAP> | **//<wrap>8.87.3 Parameter</wrap>//** **//<wrap>filename </wrap>//**<wrap>This argument specifies the file name (and optionally the path) of the file from which the core image will be loaded.</wrap> **//<wrap>address </wrap>//**<wrap>This specifies the start address of the real storage to where the saved file has to be loaded to. A value of zero, the default, means the beginning of real storage.</wrap> **//<wrap>8.87.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Load a core image file to address zero of real storage.</wrap> <wrap>HHC00013I Herc command: 'stopall'</wrap> <wrap>HHC00013I Herc command: 'loadcore </wrap>[[file:///d:/core02.bin|<wrap>d:%%\%%core02.bin</wrap>]]<wrap> 0' \\ HHC02250I Loading file '</wrap>[[file:///d:/core02.bin|<wrap>d:%%\%%core02.bin</wrap>]]<wrap>' to location 0 \\ HHC02249I Operation complete</wrap> **<wrap>Figure 170: LOADCORE command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 421</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.88 LOADPARM (Set IPL parameter) \\ //8.88.1 Function//</wrap>** <wrap>The LOADPARM command displays or changes the eight-character IPL parameter which is used by all MVS based operating systems (MVS 3.8J, MVS/SP, MVS/XA, MVS/ESA, OS/390, z/OS) to select the system parameter.</wrap> **//<wrap>8.88.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>L0ADPARM [</wrap>//<wrap>ipl parameter</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬L0ADPARM¬¬¬§¬¬¬¬¬</wrap> //<wrap>ipl parameter</wrap>// **//<wrap>8.88.3 Parameter</wrap>//** **//<wrap>ipl_parameter </wrap>//**<wrap>The system parameter used for the IPL of the intended operating system. The parameters are operating system dependent, the manuals of the operating system must be consulted for details.</wrap> **//<wrap>8.88.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current LOADPARM setting.</wrap> <wrap>HHC00013I Herc command: 'loadparm'</wrap> <wrap>HHC02203I loadparm : 014800M1</wrap> **<wrap>Figure 171: LOADPARM command (display IPL parameter)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 422</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Change the current LOADPARM setting.</wrap> <wrap>HHC00013I Herc command: 'loadparm 014800t1'</wrap> <wrap>HHC02204I loadparm set to 014800T1</wrap> **<wrap>Figure 172: LOADPARM command (set IPL parameter)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 423</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.89 LOADTEXT (Load a text deck file) \\ //8.89.1 Function//</wrap>** <wrap>The LOADTEXT command is essentially identical to the LOADCORE command (see section 8.87 for details) except that it loads a text deck file with “TXT” and “END” 80 byte records (i.e. an object deck).</wrap> **//<wrap>8.89.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>L0ADTEXT </wrap>//<wrap>filename </wrap>//<wrap>[</wrap>//<wrap>address</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬L0ADTEXT ¬¬¬ </wrap>//<wrap>filename </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>L¬¬¬ </wrap>//<wrap>address </wrap>//<wrap>¬¬¬i</wrap> </WRAP> | **//<wrap>8.89.3 Parameter</wrap>//** **//<wrap>filename </wrap>//**<wrap>This argument specifies the file name (and optionally the path) of the file from which the text deck will be loaded.</wrap> **//<wrap>address </wrap>//**<wrap>This specifies the start address of the real storage to where the saved text deck file will be loaded.</wrap> **//<wrap>8.89.4 Examples</wrap>//** <wrap>See LOADCORE command for similar examples.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 424</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.90 LOG (Direct logger output) \\ //8.90.1 Function//</wrap>** <wrap>The LOG command lets you redirect the log output to another destination.</wrap> **//<wrap>8.90.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LOG </wrap>**<wrap>[</wrap>****//<wrap>newfile </wrap>//**<wrap>| OFF]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬LOG ¬¬</wrap>**<wrap>¬§¬¬¬ </wrap>****//<wrap>newfil</wrap>//****//__<wrap>e</wrap>__//****//<wrap></wrap>//** <wrap>⡿¬¬¬¬¬</wrap>**<wrap>OFF </wrap>**<wrap>-</wrap> **//<wrap>8.90.3 Parameter</wrap>//** **//<wrap>newfile </wrap>//**<wrap>The file name and optionally the path to which the log output has to be written to.</wrap> **<wrap>OFF </wrap>**<wrap>Stops the output going to the logfile.</wrap> **//<wrap>8.90.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Redirect the log output to a new logfile destination.</wrap> <wrap>HHC00013I Herc command: 'log </wrap>[[file:///d:/mvs/log/newlog.txt|<wrap>d:/mvs/log/newlog.txt</wrap>]]<wrap>'</wrap> **<wrap>Figure 173: LOG command (redirect output to a new logfile)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Stop the output going to the logfile.</wrap> <wrap>HHC00013I Herc command: 'log off' \\ HHC02101I Logger: log closed</wrap> **<wrap>Figure 174: LOG command (stop output to logfile)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 425</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.91 LOGOPT (Display or set logging options) \\ //8.91.1 Function//</wrap>** <wrap>The LOGOPT command lets you display or change the logging options. "TIMESTAMP" inserts a time stamp in front of each log message, whereas "NOTIMESTAMP" displays log messages with no time stamps. Entering the command without any argument displays the current logging options.</wrap> **//<wrap>8.91.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LOGOPT [TIMESTAMP | NOTIMESTAMP | TIME | NOTIME]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>4</wrap><wrap>Ê¬¬¬ LOGOPT ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>ª¬¬¬¬TIMESTAMP ¬¬¬¬« ª¬¬¬NOTIMESTAMP ¬¬¬« ª¬¬¬¬¬¬TIME ¬¬¬¬¬¬¬« ⡿¬¬¬¬¬NOTIME ¬¬¬¬¬¬¯</wrap> **//<wrap>8.91.3 Parameter</wrap>//** **<wrap>TIMESTAMP </wrap>**<wrap>Insert a time stamp in front of each log message. This is the same as using TIME.</wrap> **<wrap>TIME </wrap>**<wrap>Insert a time stamp in front of each log message. This is the same as using TIME-STAMP.</wrap> **<wrap>NOTIMESTAMP </wrap>**<wrap>Display log messages without a timestamp. This is the same as using NOTIME.</wrap> **<wrap>NOTIME </wrap>**<wrap>Display log messages without a timestamp. This is the same as using NOTIME-STAMP.</wrap> **//<wrap>8.91.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display log messages without a timestamp in front of each message.</wrap> <wrap>HHC00013I Herc command: 'logopt notimestamp'</wrap> <wrap>HHC02204I logopts set to NOTIMESTAMP</wrap> **<wrap>Figure 175: LOGOPT command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 426</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.92 LPARNAME (Display or set LPAR name) \\ //8.92.1 Function//</wrap>** <wrap>The LPARNAME command is used to display the current LPAR name or to define the LPAR name returned by the DIAG x’204’.</wrap> **//<wrap>8.92.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LPARNAME [</wrap>//<wrap>lparname</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬LPARNAME¬¬¬§</wrap> //<wrap>lparname</wrap>// **//<wrap>8.92.3 Parameter</wrap>//** **//<wrap>lparname </wrap>//**<wrap>This specifies the new LPAR name. The value must be maximum 8 alphanumeric characters. If this parameter is omitted the current LPAR name is displayed.</wrap> **//<wrap>8.92.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current LPAR name.</wrap> <wrap>HHC00013I Herc command: 'lparname'</wrap> <wrap>HHC02203I lparname : HERCULES</wrap> **<wrap>Figure 176: LPARNAME command (display LPAR name)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 427</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.93 LPARNUM (Display or set LPAR identification number) //8.93.1 Function//</wrap>** <wrap>The LPARNUM console command displays or set the LPAR identification number. It specifies the one- or two-digit hexadecimal LPAR identification number stored by the STIDP instruction, or BASIC. If a one-digit number from 1 to F (hexadecimal) is specified, then STIDP stores a format-0 CPU ID, unless a subsequent “CPUIDFMT 1” statement is specified. If zero or a two-digit hexadecimal number, except 10 (hexadecimal), is specified, then STIDP stores a format-1 CPU ID. For LPARNUM 10 the current CPUIDFMT is not changed. If LPARNUM is BASIC, then the STIDP instruction stores a basic-mode CPU ID. The default is LPARNUM 1 with a format-0 CPU ID.</wrap> **//<wrap>8.93.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LPARNUM [BASIC | </wrap>//<wrap>n </wrap>//<wrap>|</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬LPARNUM¬¬¬i¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>I¬¬¬ BASIC </wrap><wrap>¬¬¬« </wrap><wrap>ª¬¬¬</wrap><wrap>1...F ¬¬¬« </wrap><wrap>ª¬¬¬</wrap><wrap>¬¬ </wrap><wrap>0 </wrap><wrap>¬¬¬¬¬« </wrap><wrap>⡿¬</wrap><wrap>¬¬¬ </wrap>//<wrap>nn </wrap>//<wrap>¬¬¬¬</wrap><wrap>_¯</wrap> **//<wrap>8.93.3 Parameter</wrap>//** **<wrap>BASIC </wrap>**<wrap>Specifies that STIDP stores a basic-mode CPU ID.</wrap> **<wrap>1 ... F </wrap>**<wrap>Specifies the one-digit hexadecimal LPAR identification number. The STIDP instruction stores a format-0 CPU ID, unless a subsequent “CPUIDFMT 1” statement is specified.</wrap> **<wrap>0 </wrap>**<wrap>Specifies 0 as LPAR identification number. The STIDP instruction stores a format-1 CPU ID.</wrap> **//<wrap>nn </wrap>//**<wrap>Specifies the two-digit hexadecimal LPAR identification number (except 10 hexadecimal). For LPARNUM 10 the current CPUIDFMT is not changed. The STIDP instruction stores a format-1 CPU ID.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 428</wrap> <wrap>\\ </wrap>**//<wrap>8.93.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current LPARNUM.</wrap> <wrap>HHC00013I Herc command: 'lparnum'</wrap> <wrap>HHC02203I lparnum : 00</wrap> **<wrap>Figure 177: LPARNUM command (display LPARNUM).</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set LPARNUM to 21.</wrap> <wrap>HHC00013I Herc command: 'lparnum 21'</wrap> <wrap>HHC02204I lparnum set to 21</wrap> **<wrap>Figure 178: LPARNUM command (set LPARNUM).</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set LPARNUM BASIC.</wrap> <wrap>HHC00013I Herc command: 'lparnum BASIC'</wrap> <wrap>HHC02204I lparnum set to BASIC</wrap> **<wrap>Figure 179: LPARNUM command (set LPARNUM BASIC).</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 429</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.94 LS (Display file and directory listing) \\ //8.94.1 Function//</wrap>** <wrap>The LS command displays a list of files and subdirectories in the current directory. The LS command is only available when running Hercules under Linux and Mac OS X. For Microsoft Windows please use the "DIR" command.</wrap> **//<wrap>8.94.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>**<wrap>LS</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>LS</wrap> **//<wrap>8.94.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.94.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Show the list of files and subdirectories in the current directory.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'ls -l'</wrap> |<WRAP><wrap>total 868</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>drwxr-xr-x</wrap> </WRAP> |<WRAP><wrap>3</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>4096</wrap> </WRAP> |<WRAP><wrap>2010-11-30</wrap> </WRAP> |<WRAP><wrap>15:49</wrap> </WRAP> |<WRAP><wrap>backups</wrap> </WRAP> | |<WRAP><wrap>-rw-r--r--</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>2350</wrap> </WRAP> |<WRAP><wrap>2008-02-18</wrap> </WRAP> |<WRAP><wrap>22:48</wrap> </WRAP> |<WRAP><wrap>condcode</wrap> </WRAP> | |<WRAP><wrap>drwxr-xr-x</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>4096</wrap> </WRAP> |<WRAP><wrap>2010-11-30</wrap> </WRAP> |<WRAP><wrap>16:29</wrap> </WRAP> |<WRAP><wrap>dasd</wrap> </WRAP> | |<WRAP><wrap>drwxr-xr-x</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>4096</wrap> </WRAP> |<WRAP><wrap>2007-02-23</wrap> </WRAP> |<WRAP><wrap>21:12</wrap> </WRAP> |<WRAP><wrap>docs</wrap> </WRAP> | |<WRAP><wrap>-rw-r--r--</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>1150</wrap> </WRAP> |<WRAP><wrap>2008-02-18</wrap> </WRAP> |<WRAP><wrap>22:48</wrap> </WRAP> |<WRAP><wrap>ibcdasdi.00c</wrap> </WRAP> | |<WRAP><wrap>-rw-r--r--</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>786</wrap> </WRAP> |<WRAP><wrap>2008-02-18</wrap> </WRAP> |<WRAP><wrap>22:48</wrap> </WRAP> |<WRAP><wrap>ibcdasdi.cnf</wrap> </WRAP> | |<WRAP><wrap>drwxr-xr-x</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>4096</wrap> </WRAP> |<WRAP><wrap>2010-11-30</wrap> </WRAP> |<WRAP><wrap>17:06</wrap> </WRAP> |<WRAP><wrap>jcl</wrap> </WRAP> | |<WRAP><wrap>-rw-r--r--</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>1758</wrap> </WRAP> |<WRAP><wrap>2010-12-01</wrap> </WRAP> |<WRAP><wrap>18:43</wrap> </WRAP> |<WRAP><wrap>mvs.cnf</wrap> </WRAP> | |<WRAP><wrap>-rwxr-xr-x</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>1229</wrap> </WRAP> |<WRAP><wrap>2008-02-13</wrap> </WRAP> |<WRAP><wrap>20:43</wrap> </WRAP> |<WRAP><wrap>mvsdasd</wrap> </WRAP> | |<WRAP><wrap>-rw-r--- </wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>11032</wrap> </WRAP> |<WRAP><wrap>2010-12-03</wrap> </WRAP> |<WRAP><wrap>15:49</wrap> </WRAP> |<WRAP><wrap>mvslog.txt</wrap> </WRAP> | |<WRAP><wrap>-rw-r--- </wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>2010-12-03</wrap> </WRAP> |<WRAP><wrap>15:40</wrap> </WRAP> |<WRAP><wrap>pch00d.txt</wrap> </WRAP> | |<WRAP><wrap>-rw-r--- </wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>330245</wrap> </WRAP> |<WRAP><wrap>2010-11-30</wrap> </WRAP> |<WRAP><wrap>15:12</wrap> </WRAP> |<WRAP><wrap>pch013.txt</wrap> </WRAP> | |<WRAP><wrap>-rw-r--- </wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>2010-12-03</wrap> </WRAP> |<WRAP><wrap>15:40</wrap> </WRAP> |<WRAP><wrap>prt00e.txt</wrap> </WRAP> | |<WRAP><wrap>-rw-r--- </wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>38121</wrap> </WRAP> |<WRAP><wrap>2010-12-03</wrap> </WRAP> |<WRAP><wrap>15:43</wrap> </WRAP> |<WRAP><wrap>prt00f.txt</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 430</wrap> <wrap>\\ </wrap> |<WRAP><wrap>-rwxr-xr-x</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>449463</wrap> </WRAP> |<WRAP><wrap>2006-01-16</wrap> </WRAP> |<WRAP><wrap>21:34</wrap> </WRAP> |<WRAP><wrap>rpfuguid.pdf</wrap> </WRAP> | |<WRAP><wrap>-rw-r--r--</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>826</wrap> </WRAP> |<WRAP><wrap>2008-02-18</wrap> </WRAP> |<WRAP><wrap>22:50</wrap> </WRAP> |<WRAP><wrap>smp.cnf</wrap> </WRAP> | |<WRAP><wrap>drwxr-xr-x</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>4096</wrap> </WRAP> |<WRAP><wrap>2008-01-14</wrap> </WRAP> |<WRAP><wrap>00:59</wrap> </WRAP> |<WRAP><wrap>source</wrap> </WRAP> | |<WRAP><wrap>-rw-r--r--</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>898</wrap> </WRAP> |<WRAP><wrap>2008-02-18</wrap> </WRAP> |<WRAP><wrap>22:48</wrap> </WRAP> |<WRAP><wrap>sysgen.cnf</wrap> </WRAP> | |<WRAP><wrap>drwxr-xr-x</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>hercules</wrap> </WRAP> |<WRAP><wrap>hercgrp</wrap> </WRAP> |<WRAP><wrap>4096</wrap> </WRAP> |<WRAP><wrap>2010-11-30</wrap> </WRAP> |<WRAP><wrap>16:22</wrap> </WRAP> |<WRAP><wrap>tape</wrap> </WRAP> | **<wrap>Figure 180: LS command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 431</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.95 LSDEP (List module dependencies) \\ //8.95.1 Function//</wrap>** <wrap>This function lists the Hercules module dependencies.</wrap> **//<wrap>8.95.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LSDEP</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ LSDEP</wrap> **//<wrap>8.95.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.95.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>List the module dependencies.</wrap> <wrap>HHC00013I Herc command: 'lsdep'</wrap> <wrap>HHC01535I HDL: dependency 'HERCULES' version '3.0.7.6835' size 11 \\ HHC01535I HDL: dependency 'REGS' version '3.03' size 47760 \\ HHC01535I HDL: dependency 'DEVBLK' version '3.05' size 3360 \\ HHC01535I HDL: dependency 'SYSBLK' version '4.00' size 49824 \\ HHC01535I HDL: dependency 'WEBBLK' version '2.17' size 40</wrap> **<wrap>Figure 181: LSDEP command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 432</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.96 LSMOD (List dynamic modules) \\ //8.96.1 Function//</wrap>** <wrap>The LSMOD command lists all the loaded Hercules dynamic modules and shows details for each module.</wrap> **//<wrap>8.96.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>LSM0D</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ LSM0D</wrap> **//<wrap>8.96.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.96.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>List the dynamic modules.</wrap> <wrap>HHC00013I Herc command: 'lsmod'</wrap> <wrap>HHC01531I HDL: dll type = load, name = s37x, flags = (unloadable, not forced)</wrap> <wrap>HHC01531I HDL: dll type = load, name = hdt3088, flags = (unloadable, not forced)</wrap> <wrap>HHC01532I HDL: symbol = debug_tt32_tracing, loadcount = 1, owner = hdt3088</wrap> <wrap>HHC01532I HDL: symbol = debug_tt32_stats, loadcount = 1, owner = hdt3088</wrap> <wrap>HHC01533I HDL: devtype(s) = CTCI-WIN VMNET CTCT CTCI 3088 LCS</wrap> <wrap>HHC01531I HDL: dll type = load, name = hdt3420, flags = (unloadable, not forced)</wrap> <wrap>HHC01533I HDL: devtype(s) = 9348 9347 8809 3590 3490 3480 3430 3422 3420 3411 3410</wrap> <wrap>HHC01531I HDL: dll type = load, name = hdt3270, flags = (unloadable, not forced)</wrap> <wrap>HHC01533I HDL: devtype(s) = SYSG 3287 3270 3215 1052</wrap> <wrap>HHC01531I HDL: dll type = load, name = hdt1403, flags = (unloadable, not forced)</wrap> <wrap>HHC01533I HDL: devtype(s) = 3211 1403</wrap> <wrap>HHC01531I HDL: dll type = load, name = hdt3525, flags = (unloadable, not forced)</wrap> <wrap>HHC01533I HDL: devtype(s) = 3525</wrap> <wrap>HHC01531I HDL: dll type = load, name = hdt3505, flags = (unloadable, not forced)</wrap> <wrap>HHC01533I HDL: devtype(s) = 3505 2501 1442</wrap> <wrap>HHC01531I HDL: dll type = load, name = dyncrypt, flags = (unloadable, not forced)</wrap> <wrap>HHC01532I HDL: symbol = z900_perform_cryptographic_key_management_operation, loadcount = 1, ...</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 433</wrap> <wrap>\\ </wrap>|<WRAP><wrap>HHC01532I HDL: symbol = z900_perform_cryptographic_computation, loadcount = 1, owner = dyncrypt HHC01532I HDL: symbol = z900_compute_message_authentication_code, loadcount = 1, owner = ... HHC01532I HDL: symbol = z900_compute_last_message_digest, loadcount = 1, owner = dyncrypt HHC01532I HDL: symbol = z900_compute_intermediate_message_digest, loadcount = 1, owner = ... HHC01532I HDL: symbol = z900_cipher_message_with_output_feedback, loadcount = 1, owner = ... HHC01532I HDL: symbol = z900_cipher_message_with_counter, loadcount = 1, owner = dyncrypt HHC01532I HDL: symbol = z900_cipher_message_with_cipher_feedback, loadcount = 1, owner = ... HHC01532I HDL: symbol = z900_cipher_message_with_chaining, loadcount = 1, owner = dyncrypt HHC01532I HDL: symbol = z900_cipher_message, loadcount = 1, owner = dyncrypt</wrap> <wrap>HHC01532I HDL: symbol = s390_perform_cryptographic_key_management_operation, loadcount = 1, ... HHC01532I HDL: symbol = s390_perform_cryptographic_computation, loadcount = 1, owner = dyncrypt HHC01532I HDL: symbol = s390_compute_message_authentication_code, loadcount = 1, owner = ... HHC01532I HDL: symbol = s390_compute_last_message_digest, loadcount = 1, owner = dyncrypt HHC01532I HDL: symbol = s390_compute_intermediate_message_digest, loadcount = 1, owner = ... HHC01532I HDL: symbol = s390_cipher_message_with_output_feedback, loadcount = 1, owner = ... HHC01532I HDL: symbol = s390_cipher_message_with_counter, loadcount = 1, owner = dyncrypt HHC01532I HDL: symbol = s390_cipher_message_with_cipher_feedback, loadcount = 1, owner = ... HHC01532I HDL: symbol = s390_cipher_message_with_chaining, loadcount = 1, owner = dyncrypt HHC01532I HDL: symbol = s390_cipher_message, loadcount = 1, owner = dyncrypt</wrap> <wrap>HHC01531I HDL: dll type = load, name = hdteq, flags = (unloadable, not forced)</wrap> <wrap>HHC01532I HDL: symbol = hdl_device_type_equates, loadcount = 1, owner = hdteq</wrap> <wrap>HHC01531I HDL: dll type = main, name = *Hercules, flags = (not unloadable, not forced)</wrap> <wrap>HHC01532I HDL: symbol = panel_display, loadcount = 1, owner = *Hercules</wrap> <wrap>HHC01532I HDL: symbol = panel_command, loadcount = 1, owner = *Hercules</wrap> <wrap>HHC01532I HDL: symbol = parse_args, loadcount = 0, owner = *Hercules</wrap> <wrap>HHC01533I HDL: devtype(s) = 9336 9335 9332 9313 3370 3310 0671 9345 3390 3380 3375 3350 3340...</wrap> </WRAP> | **<wrap>Figure 182: LSMOD command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 434</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.97 MAINSIZE (Display or set main storage size) \\ //8.97.1 Function//</wrap>** <wrap>The MAINSIZE command is used to specify the size of the main storage. Given without an argument the MAINSIZE command displays the current size of the main storage. Storage is allocated in megabytes, unless a specific unit is specified. The actual upper limit of the main storage is determined by the host system's architecture, operating system, and on some systems the amount of physical memory and paging space you have available. The practical limit depends on the maximum amount of storage that can be obtained by “malloc” (usually around 1 GB on 32-bit platforms; on 64-bit platforms the value should only be limited by available paging space).</wrap> <wrap>When increasing the main size Hercules attempts to allocate first the new storage. If the new allocation is successful then the previously allocated memory will be freed. This is to prevent a situation where the old memory is freed first, then the new allocation fails and a reallocation of the memory in the previous size also fails because of storage fragmentation and therefore leaving Hercules without memory.</wrap> <wrap>When decreasing the main storage the memory will stay allocated in the previous size but the storage size will appear as decreased. Subsequent increases will not reallocate memory unless they go over the already allocated amount.</wrap> <wrap>An additional optional argument determines the locking state of the allocated memory (page lock by host operating system). The LOCKED option indicates that the memory is to be locked into storage while UNLOCKED (the default) indicates that the memory is not locked into the storage.</wrap> <wrap>Please note that Hercules preserves the last locking state of MAINSIZE. Once storage is locked, any subsequent change to the main storage size will honor the existing lock state of memory unless the lock state is specified again on the MAINSIZE command.</wrap> **<wrap>Caution: </wrap>**<wrap>Do not lock main storage unless sufficient real memory is available to back up the request. Failure to do so may require the host system to be rebooted.</wrap> **//<wrap>8.97.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MAINSIZE [//msize//[B | K | M | G | I | P |E] [UNLOCK | LOCK]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** |<WRAP><wrap>ÊÊ--- MAINSIZE</wrap> </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬-------------------------§-----------ÊÍ</wrap> <wrap> ~--- M ---® ~¬¬¬ UNLOCK ¬¬-® \\ ⡿¬¬¬ //msize //---¦---------¦--¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¯</wrap> <wrap>ª--- B ---« ⡿¬¬¬¬LOCK¬¬¬¬¯</wrap> <wrap>ª¬¬¬K¬¬¬« \\ ª¬¬¬G-¬¬« \\ ª¬¬¬T¬¬¬« \\ ª¬¬¬P ---« \\ ⡿--- E ---¯</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 435</wrap> <wrap>\\ </wrap>**//<wrap>8.97.3 Parameter</wrap>//** **//<wrap>msize </wrap>//**<wrap>The value of //msize //must be a valid decimal number. The actual upper limit is determined by the host system's architecture, the operating system and on some systems the amount of physical memory and paging space that is available.</wrap> <wrap>For storage sizes less than 16M, sizes not on a 4K boundary are rounded up to the next 4K boundary. Otherwise, storage sizes not on a 1M boundary are rounded up to the next 1M boundary.</wrap> <wrap>The minimum size is 4K for architecture levels ALS0 and ALS1 (S/370 and</wrap> <wrap>ESA/390), and 8K for architecture level ALS2 (ESAME) and higher. A maximum of 64M may be specified for architecture level ALS0 (S/370), 2048M (2G) for ALS1 (ESA/390) and 16E for architecture level ALS2 (ESAME) and higher.</wrap> <wrap>The default on startup is 2M.</wrap> **<wrap>B </wrap>**<wrap>‘B’ determines that the number given is specified in bytes (no multiplier).</wrap> **<wrap>K </wrap>**<wrap>‘K’ determines that the number given is specified in kilobytes (multiplier 2%%**%%10).</wrap> **<wrap>M </wrap>**<wrap>‘M’ determines that the number given is specified in megabytes (multiplier 2%%**%%20). This is the default if no unit is appended.</wrap> **<wrap>G </wrap>**<wrap>‘G’ determines that the number given is specified in gigabytes (multiplier 2%%**%%30).</wrap> **<wrap>T </wrap>**<wrap>‘T’ determines that the number given is specified in terabytes (multiplier 2%%**%%40). On 32-bit machines the unit terabytes is not available.</wrap> **<wrap>P </wrap>**<wrap>‘P’ determines that the number given is specified in petabytes (multiplier 2%%**%%50). On 32-bit machines the unit petabytes is not available.</wrap> **<wrap>E </wrap>**<wrap>‘E’ determines that the number given is specified in exabytes (multiplier 2%%**%%60). On 32-bit machines the unit exabytes is not available.</wrap> **<wrap>LOCK </wrap>**<wrap>Attempt to lock the storage (pages locked by the host operating system).</wrap> **<wrap>UNLOCK </wrap>**<wrap>Leave the store unlocked (no pages locked by the host operating system). This is the default.</wrap> **<wrap>Notes:</wrap>** <wrap>The actual upper limit is determined by the host system’s architecture and operating system and the amount of physical memory and available paging space. The total of MAINSIZE and XPNDSIZE on host systems with a 32-bit architecture will be limited to 4G; host systems with a 64-bit architecture will be limited to less than 16E.</wrap> <wrap>Using minimum storage sizes, storage sizes less than or not on a 64K boundary for architecture level ALS0 (S/370) or not on a 1M boundary for architecture level ALS1 (ESA/390) and higher, it may be possible to generate error conditions not covered by the “Principles of Operations”.</wrap> <wrap>Use of storage sizes greater than supported by the guest operating system may generate incorrect results or error conditions within the guest operating system.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 436</wrap> <wrap>\\ </wrap>**//<wrap>8.97.4 Overview Storage Allocation Units</wrap>//** <wrap>\\ </wrap>|<WRAP>**<wrap>Unit</wrap>** </WRAP> |<WRAP>**<wrap>Multiplier</wrap>** </WRAP> |<WRAP>**<wrap>Name (Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>IEC Name (IEC Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>Restrictions</wrap>** </WRAP> | |<WRAP><wrap>B</wrap> </WRAP> |<WRAP><wrap>None</wrap> </WRAP> |<WRAP><wrap>Byte (B)</wrap> </WRAP> |<WRAP><wrap>Byte (B)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>K</wrap> </WRAP> |<WRAP><wrap>2%%**%%10</wrap> </WRAP> |<WRAP><wrap>Kilobyte (kB)</wrap> </WRAP> |<WRAP><wrap>Kibibyte (KiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>M</wrap> </WRAP> |<WRAP><wrap>2%%**%%20</wrap> </WRAP> |<WRAP><wrap>Megabyte (MB)</wrap> </WRAP> |<WRAP><wrap>Mebibyte (MiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>G</wrap> </WRAP> |<WRAP><wrap>2%%**%%30</wrap> </WRAP> |<WRAP><wrap>Gigabyte (GB)</wrap> </WRAP> |<WRAP><wrap>Gibibyte (GiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>T</wrap> </WRAP> |<WRAP><wrap>2%%**%%40</wrap> </WRAP> |<WRAP><wrap>Terabyte (TB)</wrap> </WRAP> |<WRAP><wrap>Tebibyte (TiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | |<WRAP><wrap>P</wrap> </WRAP> |<WRAP><wrap>2%%**%%50</wrap> </WRAP> |<WRAP><wrap>Petabyte (PB)</wrap> </WRAP> |<WRAP><wrap>Pebibyte (PiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | |<WRAP><wrap>E</wrap> </WRAP> |<WRAP><wrap>2*60</wrap> </WRAP> |<WRAP><wrap>Exabyte (EB)</wrap> </WRAP> |<WRAP><wrap>Exbibyte (EiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | **<wrap>Table 20: Storage Allocation Units</wrap>** **//<wrap>8.97.5 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current size of the main storage.</wrap> <wrap>HHC00013I Herc command: 'mainsize'</wrap> <wrap>HHC17003I MAIN storage is 001 GBytes 'mainsize'; storage is not locked</wrap> **<wrap>Figure 183: MAINSIZE command (display size of main storage)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the size of the main storage to 512 MB. Do not lock the memory into the storage.</wrap> <wrap>HHC00013I Herc command: 'mainsize 512'</wrap> <wrap>HHC17003I MAIN storage is 512 MBytes 'mainsize'; storage is not locked</wrap> **<wrap>Figure 184: MAINSIZE command (Set size of unlocked main storage)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 437</wrap> <wrap>\\ </wrap>**<wrap>Example 3:</wrap>** <wrap>Set the size of the main storage to 256 MB. Lock the memory into the storage.</wrap> <wrap>HHC00013I Herc command: 'mainsize 256 lock' \\ HHC01428I Locking main storage</wrap> <wrap>HHC17003I MAIN storage is 256 MBytes 'mainsize'; storage is locked</wrap> **<wrap>Figure 185: MAINSIZE command (Set size of locked main storage)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 438</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.98 MANUFACTURER (Display or set STSI manufacturer code) //8.98.1 Function//</wrap>** <wrap>The MANUFACTURER console command displays or sets the manufacturer name returned by the STSI instruction. If no argument is given, the current manufacturer name is displayed.</wrap> **//<wrap>8.98.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive \\ Descriptive </wrap>__****<wrap></wrap>** <wrap>MANUFACTURER </wrap><wrap>[</wrap>//<wrap>name</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬MANUFACTURER</wrap> //<wrap>name</wrap>// **//<wrap>8.98.3 Parameter</wrap>//** **//<wrap>name </wrap>//**<wrap>Any name with a maximum length of four characters.</wrap> **//<wrap>8.98.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the STSI manufacturer name to ‘HRC’.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'manufacturer HRC' \\ HHC02204I manufacturer set to HRC</wrap> **<wrap>Figure 186: MANUFACTURER command (set STSI manufacturer code)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 439</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.99 MAXCPU (Display or set maximum number of CPUs) //8.99.1 Function//</wrap>** <wrap>The MAXCPU command displays or sets the maximum number of installed processor engines. The combination of MAXCPU and NUMCPU controls the behaviour of how many CPU engines will be configured online upon startup and how many can be configured online later. The NUMCPU statement specifies the number of engines which will be configured online at startup time. All processors are CP engines unless otherwise specified by the ENGINES statement.</wrap> <wrap>MAX_CPU_ENGINES is a compile-time variable which sets an upper limit on the value of MAXCPU. The value of MAX_CPU_ENGINES is displayed in the build information message on the Hercules control panel at startup time. To change the value of MAX_CPU_ENGINES you must rebuild Hercules. For Unix builds, specify "./configure --enable-multi-cpu=//nn//" before performing make. For Windows builds, specify "SET MAX_CPU_ENGINES=//nn//" before performing nmake.</wrap> <wrap>MAX_CPU_ENGINES may be up to 128 on 64-bit Linux platforms. On Windows, and on all 32-bit platforms, the maximum value is 64. For performance reasons, values above 32 are not recommended for 32-bit platforms. If MAX_CPU_ENGINES is set to 1 then multiprocessing is disabled. See also the NUM-CPU statement for a discussion of the performance implications of MAX_CPU_ENGINES.</wrap> <wrap>The value of MAXCPU cannot exceed the value of MAX_CPU_ENGINES. If MAXCPU is not specified in the configuration file, then its initial value is equal to NUMCPU. If MAXCPU and NUMCPU are both omitted, then MAXCPU is set to 1.</wrap> <wrap>Given without an argument the MAXCPU statement displays the current maximum number of installed processor engines.</wrap> <wrap>For detailed explanations on the interrelationship between MAXCPU, ENGINES and NUMCPU please see “Appendix B. Configuration of Emulated CPUs”.</wrap> **//<wrap>8.99.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>MAXCPU </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>MAXCPU</wrap> //<wrap>nn</wrap>// **//<wrap>8.99.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>Specifies the maximum number of installed processor engines. The value of MAXCPU cannot exceed the value of MAX_CPU_ENGINES.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 440</wrap> <wrap>\\ </wrap>**//<wrap>8.99.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the number of installed processor engines.</wrap> <wrap>HHC00013I Herc command: 'maxcpu'</wrap> <wrap>HHC02203I maxcpu : 2</wrap> **<wrap>Figure 187: MAXCPU command (display current number of installed processors)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the maximum number of installed processor engines to 8.</wrap> <wrap>HHC00013I Herc command: 'maxcpu 8'</wrap> <wrap>HHC02204I maxcpu set to 8</wrap> **<wrap>Figure 188: MAXCPU command (set number of installed processors)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 441</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.100 MAXRATES (Display highest MIPS/SIO rate or set new reporting interval)</wrap>** **//<wrap>8.100.1 Function</wrap>//** <wrap>The MAXRATES command shows the maximum observed MIPS (million instructions per second) and SIO (Start I/O) rates reached during the current reporting interval (up to the time the command is issued). It lets you also set the MAXRATES reporting interval to a new value.</wrap> <wrap>If there is no MAXRATES reporting interval set in the configuration file then the default value for reporting the rates is 1440 minutes (1 day). When the interval is expired a MAXRATES command is automatically issued. The current rates will also be displayed during shutdown of Hercules.</wrap> **//<wrap>8.100.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MAXRATES [</wrap>//<wrap>interval </wrap>//<wrap>| MIDNIGHT</wrap><wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬MAXRATES¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>1</wrap><wrap>/4 ª¬¬¬ </wrap>//<wrap>interval </wrap>//<wrap>¬¬¬« \\ </wrap><wrap>⡿¬¬¬MIDNIGHT ¬¬¬¯</wrap> **//<wrap>8.100.3 Parameter</wrap>//** **//<wrap>interval </wrap>//**<wrap>This is the new interval time in minutes. The default MAXRATES interval that is active after startup of Hercules (if not otherwise specified in the configuration file), is 1440 minutes (1 day). Changes to the MAXRATES interval that are other than “MIDNIGHT” will set the current interval start time to the present; this includes a value of “1440”.</wrap> **<wrap>MIDNIGHT </wrap>**<wrap>Sets the interval to 1440 minutes (1 day) and the start time for the interval timer to midnight of the current day. This will cause the MAXRATE statistics to be date aligned.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 442</wrap> <wrap>\\ </wrap>**//<wrap>8.100.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Change the MAXRATES interval from the default value (or the last manually set interval value) to 60 minutes.</wrap> <wrap>HHC00013I Herc command: 'maxrates 60'</wrap> <wrap>HHC02204I maxrates set to 60 minutes</wrap> **<wrap>Figure 189: MAXRATES command (set the interval time)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Display the maximum observed MIPS and I/O rates during the last interval.</wrap> <wrap>HHC00013I Herc command: 'maxrates'</wrap> <wrap>HHC02272I Highest observed MIPS and IO/s rates:</wrap> <wrap>HHC02272I From Thu Apr 19 22:58:34 2012 to Fri Apr 20 22:58:34 2012</wrap> <wrap>HHC02272I MIPS: 105.333858</wrap> <wrap>HHC02272I IO/s: 3068</wrap> <wrap>HHC02272I From Fri Apr 20 22:58:34 2012 to Fri Apr 20 23:06:38 2012</wrap> <wrap>HHC02272I MIPS: 5.678100</wrap> <wrap>HHC02272I IO/s: 54</wrap> <wrap>HHC02272I Current interval is 1440 minutes</wrap> **<wrap>Figure 190: MAXRATES command (display maximum rates)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 443</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.101 MEMLOCK (Lock Hercules memory) \\ //8.101.1 Function//</wrap>** <wrap>The MEMLOCK console command is used to lock Hercules memory in storage. It defines the locking state of the allocated Hercules memory (page lock by host operating system). Given without argument MEMLOCK displays the current setting. If Hercules memory is locked in storage it cannot be paged out by the host operating system. This may result in some performance improvements.</wrap> <wrap>This console command is available if Hercules is built with option “_HAVE_MLOCKALL”. Currently MEMLOCK is only supported under Linux host operating systems.</wrap> **//<wrap>8.101.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MEMLOCK [ON | </wrap>__<wrap>OFF</wrap>__<wrap>]</wrap>__<wrap></wrap>__ **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ </wrap><wrap>MEMLOCK </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ ON </wrap><wrap>¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap><wrap>OFF </wrap><wrap>¬¬¬¯</wrap> **//<wrap>8.101.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>ON indicates that the memory is to be locked into storage.</wrap> **<wrap>OFF </wrap>**<wrap>OFF indicates that the memory is not to be locked into the storage.</wrap> **//<wrap>8.101.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Do not lock Hercules memory in storage.</wrap> <wrap>HHC00013I Herc command: 'memlock off'</wrap> **<wrap>Figure 191: MEMLOCK command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 444</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.102 MESSAGE (Display message on console like VM) //8.102.1 Function//</wrap>** <wrap>The MESSAGE command is actually a VM CP command. It is used to transmit message text to the virtual console of other active users.</wrap> <wrap>However, some programmers also use this command as a simplified way to display messages on the own virtual machine console by using "MESSAGE * <message text>". One program that uses this is the IBM "System z" port of Solaris which is only capable of running under z/VM.</wrap> <wrap>So basically, all the MESSAGE command does is to display a message on the Hercules console with VM like headers. Therefore the MESSAGE command is not really intended to be used directly from the Hercules console as shown in the example below, although it does not hurt doing so.</wrap> <wrap>The MESSAGE command is the same as MSG. See also the MSG and MSGNOH commands in this manual.</wrap> **//<wrap>8.102.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>MESSAGE </wrap>//<wrap>parms</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ MESSAGE ¬</wrap>//<wrap>¬¬ parms</wrap>// **//<wrap>8.102.3 Parameter</wrap>//** **//<wrap>parms </wrap>//**<wrap>Specifies the required and optional parameters as described in IBM's VM "CP Commands and Utilities Reference" manual.</wrap> **//<wrap>8.102.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display a message on the own virtual machine console.</wrap> <wrap>HHC00013I Herc command: 'message * transmitted message to VM console' \\ **20:50:33 * MSG FROM HERCULES: transmitted message to VM console**</wrap> **<wrap>Figure 192: MESSAGE command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 445</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.103 MODEL (Display or set STSI model code) \\ //8.103.1 Function//</wrap>** <wrap>The MODEL console command displays or sets the model names returned by the STSI instruction. If no argument is given the current STSI model names are displayed.</wrap> <wrap>The optional operands specify the hardware model name, the capacity model name, the permanent capacity model name and the temporary capacity model name respectively.</wrap> **//<wrap>8.103.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>MODEL </wrap>//<wrap>[</wrap>//<wrap>hdwmod </wrap>////<wrap>| = | * [</wrap>////<wrap>capmod </wrap>////<wrap>| = | * [</wrap>////<wrap>prmmod </wrap>////<wrap>| = | * [</wrap>////<wrap>tmpmod </wrap>////<wrap>| = | *111</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>4</wrap>//<wrap>Ê¬¬¬ MODEL</wrap>// //<wrap>ª</wrap>////<wrap>¬¬¬¬</wrap>////<wrap>hdwmod </wrap>//<wrap>¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> //__<wrap>ª</wrap>__////<wrap>¬¬¬¬¬¬ = ¬¬¬¬¬¬¬« ⡿¬¬¬¬¬¬* ¬¬¬¬¬¬¬</wrap>// |<WRAP><wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>//<wrap>ª</wrap>//<wrap>¬¬¬ </wrap>//<wrap>capmod </wrap>//<wrap>¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> </WRAP> ||| | |<WRAP>//<wrap>ª¬</wrap>//<wrap>¬¬¬¬ </wrap>//<wrap>= </wrap>//<wrap>¬¬¬¬¬¬« </wrap>//<wrap>ª¬</wrap>//<wrap>¬¬ ¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> //<wrap>prmmod</wrap>// </WRAP> ||| | |<WRAP>//<wrap>⡿</wrap>//<wrap>¬¬¬¬¬</wrap> </WRAP> |<WRAP><wrap>*</wrap> </WRAP> |<WRAP><wrap>¬¬¬</wrap>//<wrap>¬¬¬¯</wrap>// </WRAP> |<WRAP>//<wrap>ª¬¬</wrap>//<wrap>¬¬¬ </wrap>//<wrap>= </wrap>//<wrap>¬¬¬¬¬¬« </wrap>//<wrap>ª¬¬</wrap>//<wrap>¬ </wrap>//<wrap>tmpmod </wrap>//<wrap>¬¬¬«</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP>//<wrap>⡿</wrap>//<wrap>¬¬¬¬¬ * ¬¬¬</wrap>//<wrap>¬¬¬¯ ª¬</wrap>//<wrap>¬¬¬¬ </wrap>//<wrap>= </wrap>//<wrap>¬¬¬¬¬¬«</wrap> </WRAP> | |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP>//<wrap>⡿</wrap>//<wrap>¬¬¬¬¬ * ¬¬¬</wrap>//<wrap>¬¬¬¯</wrap>// </WRAP> | **//<wrap>8.103.3 Parameter</wrap>//** **//<wrap>hdwmodel </wrap>//**<wrap>This specifies the hardware model name. This can be any name with a maximum length of 16 characters. Valid characters are A-Z and 0-9. Specifying a “=” resets the hardware model to “EMULATOR”; specifying an “*” leaves the current hardware model name intact. If the MODEL system parameter is not specified in the configuration file then the default name is “EMULATOR”.</wrap> **//<wrap>capmodel </wrap>//**<wrap>This optional parameter specifies the capacity model name. The //capmodel //can be any name with a maximum length of 16 characters. Valid characters are A-Z and 09. Specifying a “=” copies the current hardware model name to the capacity model; specifying an “*” leaves the current capacity model name intact. The default capacity model name is “EMULATOR”.</wrap> **//<wrap>prmmodel </wrap>//**<wrap>This specifies the permanent capacity model name. The //prmmodel //can be any name with a maximum length of 16 characters. Valid characters are A-Z and 0-9. Specifying a “=” copies the current capacity model name to the permanent capacity model; specifying an “*” leaves the current permanent capacity model name intact.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 446</wrap> <wrap>\\ </wrap><wrap>The default permanent capacity model name is a null string.</wrap> **//<wrap>tmpmodel </wrap>//**<wrap>This specifies the temporary capacity model name. The //tmpmodel //can be any name with a maximum length of 16 characters. Valid characters are A-Z and 0-9. Specifying a “=” copies the current permanent capacity model name to the temporary capacity model; specifying an “*” leaves the current temporary capacity model name intact. The default temporary capacity model name is a null string.</wrap> **//<wrap>8.103.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the STSI model name (hardware model and capacity model) to “EMULATOR”.</wrap> <wrap>HHC00013I Herc command: 'model emulator emulator'</wrap> <wrap>HHC02204I hdw model set to EMULATOR</wrap> <wrap>HHC02204I cap model set to EMULATOR</wrap> <wrap>HHC02204I prm model set to</wrap> <wrap>HHC02204I tmp model set to</wrap> **<wrap>Figure 193: MODEL command (set STSI model name, variant 1)</wrap>** **<wrap>Example 2:</wrap>** <wrap>The same could also be specified using the following simplified command:</wrap> <wrap>HHC00013I Herc command: 'model emulator ='</wrap> <wrap>HHC02204I hdw model set to EMULATOR</wrap> <wrap>HHC02204I cap model set to EMULATOR</wrap> <wrap>HHC02204I prm model set to</wrap> <wrap>HHC02204I tmp model set to</wrap> **<wrap>Figure 194: MODEL command (set STSI model name, variant 2)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the STSI model name, the permanent capacity model name and the temporary model name to “HERCULES”, but leave the capacity model name intact.</wrap> <wrap>HHC00013I Herc command: 'model hercules * hercules ='</wrap> <wrap>HHC02204I hdw model set to HERCULES</wrap> <wrap>HHC02204I cap model set to EMULATOR</wrap> <wrap>HHC02204I prm model set to HERCULES</wrap> <wrap>HHC02204I tmp model set to HERCULES</wrap> **<wrap>Figure 195: MODEL command (set STSI model name, variant 1)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 447</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.104 MODPATH (Display or set dynamic load module path) //8.104.1 Function//</wrap>** <wrap>The MODPATH command displays or sets the dynamic load module path. If a MODPATH is defined then this path is searched before the default path is searched. When a relative path is specified it is interpreted as a relative path within the default search path. If an absolute path is coded it is interpreted as such.</wrap> <wrap>The default MODPATH is “hercules” which means modules are loaded from the directory “hercules” within the default LD_LIBRARY_PATH.</wrap> **//<wrap>8.104.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>****<wrap>M0DPATH </wrap>****<wrap>[</wrap>****//<wrap>path</wrap>//****<wrap>]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ </wrap>****<wrap>M0DPATH</wrap>** **//<wrap>path</wrap>//** **//<wrap>8.104.3 Parameter</wrap>//** **//<wrap>path </wrap>//**<wrap>The path where dynamic load modules are loaded from.</wrap> **//<wrap>8.104.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current dynamic load module path.</wrap> <wrap>HHC00013I Herc command: 'modpath'</wrap> <wrap>HHC01508I HDL: loadable module directory is '</wrap>[[file:///D:/Hercules/|<wrap>D:/Hercules/</wrap>]]<wrap>'</wrap> **<wrap>Figure 196: MODPATH command (display dynamic load module path)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 448</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the current dynamic load module path to “D:/Hercules/Modules”.</wrap> <wrap>HHC00013I Herc command: 'modpath </wrap>[[file:///D:/Hercules/Modules|<wrap>D:/Hercules/Modules</wrap>]]<wrap>'</wrap> <wrap>HHC01508I HDL: loadable module directory is '</wrap>[[file:///D:/Hercules/Modules|<wrap>D:/Hercules/Modules</wrap>]]<wrap>'</wrap> **<wrap>Figure 197: MODPATH command (set dynamic load module path)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 449</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.105 MOUNTED_TAPE_REINIT (Control tape initialization) //8.105.1 Function//</wrap>** <wrap>The MOUNTED_TAPE_REINIT command controls whether reinitialization of tape drive devices via the DEVINIT command in order to mount a new tape should be allowed if there is already a tape mounted on the drive. Without a parameter given the current setting is displayed.</wrap> <wrap>Specifying ALLOW indicates that new tapes may be mounted via "DEVINIT nnnn new-tape-filename" irrespective of whether or not there is already a tape mounted on the drive.</wrap> <wrap>Specifying DISALLOW prevents new tapes from being mounted if one is already mounted. Before the new tape can be mounted the existing one has first to be unmounted (via the "DEVINIT nnnn *" command). Otherwise the DEVINIT attempt to mount the new tape is rejected.</wrap> <wrap>This option is meant as a safety mechanism to protect against accidentally unmounting a tape from the wrong device as a result of a simple typing error and thereby eventually cancelling a potentially important tape job.</wrap> <wrap>Please note that for SCSI tape drives the "DEVINIT nnnn *" command has no effect. The tape must be unmounted manually since it is a real physical device and not emulated via a disk file like '.AWS' or '.HET' tapes.</wrap> **//<wrap>8.105.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MOUNTED TAPE REINIT [ENABLE | ALLOW | DISABLE | DISALLOW]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>MOUNTED TAPE REINIT </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>ª¬¬¬ ENABLE </wrap><wrap>¬¬¬¬¬« </wrap><wrap>ª¬¬¬ALLOW¬¬¬</wrap><wrap>¬¬¬« </wrap><wrap>ª¬¬¬DISABLE ¬¬¬¬I ⡿¬¬¬DISALLOW ¬¬¬¯</wrap> **//<wrap>8.105.3 Parameter</wrap>//** **<wrap>ENABLE </wrap>**<wrap>Indicates that new tapes may be mounted irrespective of whether or not there is already a tape mounted on the drive. This is the default.</wrap> **<wrap>ALLOW </wrap>**<wrap>This is the same as ENABLE.</wrap> **<wrap>DISABLE </wrap>**<wrap>Prevents new tapes from being mounted if one is already mounted on the drive. Before the new tape can be mounted the currently mounted tape must first to be unmounted. Instead of DISABLE, the argument DISALLOW that has been used in earlier versions of Hercules can also be used.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 450</wrap> <wrap>\\ </wrap>**<wrap>DISALLOW </wrap>**<wrap>This is the same as DISABLE.</wrap> **//<wrap>8.105.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display current tape mount settings.</wrap> <wrap>HHC00013I Herc command: 'mounted_tape_reinit' \\ HHC02203I mounted_tape_reinit: enabled</wrap> **<wrap>Figure 198: MOUNTED_TAPE_REINIT command (display settings).</wrap>** **<wrap>Example 2:</wrap>** <wrap>Disallow tape mount reinitialization.</wrap> <wrap>HHC00013I Herc command: 'mounted_tape_reinit disable' \\ HHC02204I mounted_tape_reinit set to disabled</wrap> **<wrap>Figure 199: MOUNTED_TAPE_REINIT command (disable tape mount reinitialization)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 451</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.106 MSG (Display message on console like VM) \\ //8.106.1 Function//</wrap>** <wrap>The MSG command is actually a VM CP command. It is used to transmit message text to the virtual console of other active users.</wrap> <wrap>However, some programmers also use this command as a simplified way to display messages on the own virtual machine console by using "MSG * <message text>". One program that uses this is the IBM "System z" port of Solaris which is only capable of running under z/VM.</wrap> <wrap>So basically, all the MSG command does is to display a message on the Hercules console with VM like headers. Therefore the MSG command is not really intended to be used directly from the Hercules console as shown in the example below, although it does not hurt doing so.</wrap> <wrap>The MSG command is the same as MESSAGE. See also the MESSAGE and MSGNOH commands in this manual.</wrap> **//<wrap>8.106.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>MSG </wrap>//<wrap>parms</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ MSG ¬¬¬ </wrap>//<wrap>parms</wrap>// **//<wrap>8.106.3 Parameter</wrap>//** **//<wrap>parms </wrap>//**<wrap>This specifies the required and optional parameters as described in IBM's VM "CP Commands and Utilities Reference" manual.</wrap> **//<wrap>8.106.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display a message on the own virtual machine console.</wrap> <wrap>18:24:09 msg * transmitted message to VM console</wrap> <wrap>18:24:09 18:24:09 * MSG FROM HERCULES: transmitted message to VM console</wrap> **<wrap>Figure 200: MSG command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 452</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.107 MSGHLD (Display or set timeout of held messages) //8.107.1 Function//</wrap>** <wrap>The MSGHLD console command is used to display or set the timeout value of held messages. It is also possible to release all held messages without having to wait for the timeout period to expire.</wrap> **//<wrap>8.107.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>MSGHLD {</wrap>****//<wrap>nnn </wrap>//****<wrap>| INFO | CLEAR}</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬MSGHLD ¬¬¬§¬¬¬¬ </wrap>****//<wrap>nnn </wrap>//****<wrap>¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>** **<wrap>ª¬¬¬ INFO¬¬¬¬«</wrap>** **<wrap>⡿¬¬¬ CLEAR¬¬¬¯</wrap>** **//<wrap>8.107.3 Parameter</wrap>//** **//<wrap>nnn </wrap>//**<wrap>This value specifies the new timeout value of held messages in seconds.</wrap> **<wrap>INFO </wrap>**<wrap>Display the current message held time setting.</wrap> **<wrap>CLEAR </wrap>**<wrap>Release the held messages immediately. The command 'KD' can be used as a</wrap> <wrap>shortcut for 'MSGHLD CLEAR'.</wrap> **//<wrap>8.107.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the new timeout interval for held messages to 30 seconds.</wrap> <wrap>HHC00013I Herc command: 'msghld 30'</wrap> <wrap>HHC02204I message hold time set to 30 seconds</wrap> **<wrap>Figure 201: MSGHLD command (set new interval)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 453</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Release all held messages.</wrap> <wrap>HHC00013I Herc command: 'msghld clear' \\ HHC02226I Held messages cleared</wrap> **<wrap>Figure 202: MSGHLD command (release messages)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 454</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.108 MSGLEVEL (Display or set the current message display output) //8.108.1 Function//</wrap>** <wrap>The MSGLEVEL command displays the current setting of the message level or allows setting a new message level. It decides how many and what kind of messages are written to the Hercules console (and to the log). Given without an argument MSGLEVEL displays the current message level settings.</wrap> <wrap>The message level is set per default to ‘terse’ which turns the verbose message level off. To display the additional messages during configuration file processing Hercules can be started with the “-v” option which sets the verbose message level. As an alternative, the MSGLEVEL system parameter can be set to activate the verbose message level. In this case however, MSGLEVEL must be coded as one of the first statements in the configuration file to take effect at an early stage during configuration file processing.</wrap> <wrap>In addition to the ‘terse’ level the following options are set by default (if not otherwise overwritten through the MSGLEVEL system parameter or console command): ‘nodebug’, ‘tape’, ‘dasd’, ‘comm’, ‘ur’, ‘scsi’, ‘ctca’, ‘graf’, ‘thread’ and ‘channel’.</wrap> <wrap>Certain levels (on, off, text, time) can only be set if Hercules is built with one of the following build options: OPTION_MSGCLR or OPTION_MSGHLD.</wrap> **//<wrap>8.108.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MSGLEVEL [//option option //...] \\ where //option //can be:</wrap> |<WRAP><wrap>ON</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>OFF | TEXT</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>TIME |</wrap> </WRAP> |<WRAP><wrap>NODEBUG |</wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] DEBUG</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] TAPE</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] DASD</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] COMM</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] UR</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] SCSI</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] CTCA</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] GRAF</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] THREAD</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] CHANNEL</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] VERBOSE</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>[+</wrap> </WRAP> |<WRAP><wrap>|</wrap> </WRAP> |<WRAP><wrap>-] TERSE</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 455</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ </wrap>****<wrap>MSGLEVEL</wrap>** **//<wrap>option</wrap>//** **<wrap>where </wrap>****//<wrap>option </wrap>//****<wrap>can be:</wrap>** **<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬ </wrap>****<wrap>ON</wrap>****<wrap>¬¬¬¬¬¬¬¬§ ¬¬¬¬¬¬¬¬¬¬¬¬¬ OFF ¬¬¬¬¬¬¬« ¬¬¬¬¬¬¬¬¬¬¬</wrap>****<wrap>¬¬TEXT¬</wrap>****<wrap>¬¬¬¬¬« ¬¬¬¬¬¬¬¬¬¬¬</wrap>****<wrap>¬¬TIME¬</wrap>****<wrap>¬¬¬¬¬« </wrap>****<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬NODEBUG </wrap>****<wrap>¬¬¬« ¬¬¬¬¬§¬¬¬§¬¬¬ </wrap>****<wrap>DEBUG</wrap>****<wrap>¬¬¬¬¬«</wrap>** **<wrap>+ ¬¬¬« </wrap>****<wrap>ª¬¬¬ TAPE </wrap>****<wrap>¬¬¬¬¬¬«</wrap>** **<wrap>- </wrap>****<wrap>¬¬¬¯ ª¬¬¬ DASD </wrap>****<wrap>¬¬¬¬¬¬«</wrap>** **<wrap>ª¬¬¬ COMM ¬¬¬¬¬¬« \\ ª¬¬¬ UR ¬¬¬¬¬¬¬¬« \\ ª¬¬¬ SCSI¬¬¬¬¬¬« \\ ª¬¬¬</wrap>****<wrap>CTCA ¬¬¬¬¬¬« \\ </wrap>****<wrap>ª¬¬¬GRAF </wrap>****<wrap>¬¬¬¬¬¬« \\ </wrap>****<wrap>ª¬¬¬THREAD </wrap>****<wrap>¬¬¬¬« \\ </wrap>****<wrap>ª¬¬¬CHANNEL¬¬¬« \\ ª¬¬¬VERBOSE¬¬¬« \\ ⡿¬¬¬TERSE¬</wrap>****<wrap>¬</wrap>****<wrap>¬¬¬</wrap>** **//<wrap>8.108.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>ON displays the messages in the default kind with message number followed by the message text.</wrap> **<wrap>OFF </wrap>**<wrap>No messages are displayed.</wrap> **<wrap>TEXT </wrap>**<wrap>Displays only the text part of the message (without message numbers).</wrap> **<wrap>TIME </wrap>**<wrap>Prefix the messages with a timestamp.</wrap> **<wrap>NODEBUG </wrap>**<wrap>The messages are not issued in debug mode (not prefixed additionally with the name of the source member and the line number that issues the message).</wrap> **<wrap>DEBUG </wrap>**<wrap>The messages are prefixed additionally with the name of the source member and the line number that issues the message.</wrap> **<wrap>TAPE </wrap>**<wrap>Display tape related messages.</wrap> **<wrap>DASD </wrap>**<wrap>Display DASD related messages.</wrap> **<wrap>COMM </wrap>**<wrap>Display communications related messages.</wrap> **<wrap>UR </wrap>**<wrap>Display unit record related messages.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 456</wrap> <wrap>\\ </wrap>**<wrap>SCSI </wrap>**<wrap>Display SCSI related messages.</wrap> **<wrap>CTCA </wrap>**<wrap>Display CTCA and LCS related messages.</wrap> **<wrap>GRAF </wrap>**<wrap>Display graphics (3270) related messages.</wrap> **<wrap>THREAD </wrap>**<wrap>Display threading related messages.</wrap> **<wrap>CHANNEL </wrap>**<wrap>Display channel related messages.</wrap> **<wrap>VERBOSE </wrap>**<wrap>Displays additional messages during configuration file processing.</wrap> **<wrap>TERSE </wrap>**<wrap>This turns the verbose message level off. This is the default unless VERBOSE is specified either through the MSGLEVEL system parameter or panel command or if Hercules is started with the “-v” option.</wrap> **//<wrap>8.108.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current message level.</wrap> <wrap>HHC00013I Herc command: 'msglevel'</wrap> <wrap>HHC17012I MSGLEVEL = terse nodebug tape dasd ur comm ctca graf scsi</wrap> **<wrap>Figure 203: MSGLEVEL command (display message level)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the message level to supress UR and SCSI related messages.</wrap> <wrap>HHC00013I Herc command: 'msglvl -ur -scsi'</wrap> <wrap>HHC17012I MSGLEVEL = terse nodebug tape dasd comm ctca graf</wrap> **<wrap>Figure 204: MSGLEVEL command (suppress certain messages)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the message level to DEBUG.</wrap> <wrap>HHC00013I Herc command: 'msglevel debug'</wrap> <wrap>cmdtab.c 350 21:01:56 HHC90000D DBG: Panel_Exit CommandLockCounter 0</wrap> <wrap>logmsg.c 261 HHC00007I Previous message from function ProcessPanelCommand() at cmdtab.c[350]</wrap> <wrap>cmdtab.c 361 21:01:56 HHC90000D DBG: RC = 0</wrap> <wrap>logmsg.c 261 HHC00007I Previous message from function ProcessPanelCommand() at cmdtab.c[361]</wrap> <wrap>cmdtab.c 602 21:02:01 HHC02101I Logger: log closed</wrap> **<wrap>Figure 205: MSGLEVEL command (set message level DEBUG)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 457</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.109 MSGLVL (Display or set the current message display output) //8.109.1 Function//</wrap>** <wrap>MSGLVL is an alias for MSGLEVEL. The MSGLVL command displays the current setting of the message level or allows it to set a new message level. See MSGLEVEL for details.</wrap> **//<wrap>8.109.2 Syntax</wrap>//** <wrap>See MSGLEVEL command.</wrap> **//<wrap>8.109.3 Parameter</wrap>//** <wrap>See MSGLEVEL command.</wrap> **//<wrap>8.109.4 Examples</wrap>//** <wrap>See MSGLEVEL command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 458</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.110 MSGNOH (Display message on console like VM, but without header)</wrap>** **//<wrap>8.110.1 Function</wrap>//** <wrap>The MSGNOH command is actually a VM CP command. It is used to transmit message text to the virtual console of other active users without the standard MESSAGE command header. However, some programmers also use this command as a simplified way to display messages on the own virtual machine console by using "MSGNOH * <message text>".</wrap> <wrap>So basically, all the MSGNOH command does is to display a message on the Hercules console (like the MESSAGE and MSG commands) but without VM like headers. Therefore the MSGNOH command is not really intended to be used directly from the Hercules console as shown in the example below, although it does not hurt doing so.</wrap> <wrap>See also the MESSAGE and MSG commands in this manual.</wrap> **//<wrap>8.110.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>MSGN0H </wrap>//<wrap>parms</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ MSGN0H ¬¬¬ </wrap>//<wrap>parms</wrap>// **//<wrap>8.110.3 Parameter</wrap>//** **//<wrap>parms </wrap>//**<wrap>Specifies the required and optional parameters as described in IBM's VM "CP Commands and Utilities Reference" manual.</wrap> **//<wrap>8.110.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display a message on the own virtual machine console.</wrap> <wrap>HHC00013I Herc command: 'msgnoh * transmitted message to VM console' \\ **transmitted message to VM console**</wrap> **<wrap>Figure 206: MSGNOH command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 459</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.111 MT (Control magnetic tape operation) \\ //8.111.1 Function//</wrap>** <wrap>The MT command performs various actions on magnetic tapes. All operations can be used on a valid tape device. The device must not have any I/O operation in process or pending.</wrap> <wrap>Please note that the WTM operation will truncate the tape after the last WTM written if it is not at the logical end of the tape when the WTM is issued. No warnings are given.</wrap> **//<wrap>8.111.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MT //device operation \\ //where operation can be:</wrap> <wrap>REW</wrap> <wrap>ASF [</wrap>//<wrap>nnnn </wrap>//<wrap>|</wrap><wrap>1] \\ </wrap><wrap>FSF [</wrap>//<wrap>nnnn </wrap>//<wrap>|</wrap><wrap>1] \\ </wrap><wrap>BSF [</wrap>//<wrap>nnnn </wrap>//<wrap>|</wrap><wrap>1] \\ </wrap><wrap>FSR [</wrap>//<wrap>nnnn </wrap>//<wrap>|</wrap><wrap>1] \\ </wrap><wrap>BSR [</wrap>//<wrap>nnnn </wrap>//<wrap>|</wrap><wrap>1] \\ </wrap><wrap>WTM [</wrap>//<wrap>nnnn </wrap>//<wrap>|</wrap><wrap>1] \\ </wrap><wrap>DSE</wrap> <wrap>DV0L1</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>m•--- MT --- //device //</wrap><wrap>¬¬¬« </wrap>//<wrap>operation </wrap>//<wrap>ª</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>where operation can be: \\ H- REW --------------</wrap><wrap></wrap> <wrap>~¬¬¬¬ 1 ¬¬¬¬¬®</wrap> <wrap>F</wrap><wrap>--- ASF ---</wrap><wrap>¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿---nnn</wrap><wrap>n </wrap><wrap>---¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 460</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>{{hercules:userref:bf:image087.gif|}}{{hercules:userref:bf:image088.gif|}}{{hercules:userref:bf:image089.gif|}}{{hercules:userref:bf:image087.gif|}}{{hercules:userref:bf:image088.gif|}}{{hercules:userref:bf:image089.gif|}}{{hercules:userref:bf:image087.gif|}}{{hercules:userref:bf:image088.gif|}}{{hercules:userref:bf:image089.gif|}}{{hercules:userref:bf:image087.gif|}}{{hercules:userref:bf:image088.gif|}}{{hercules:userref:bf:image089.gif|}}{{hercules:userref:bf:image087.gif|}}{{hercules:userref:bf:image088.gif|}}{{hercules:userref:bf:image089.gif|}}{{hercules:userref:bf:image090.gif|}}{{hercules:userref:bf:image078.gif|}}{{hercules:userref:bf:image090.gif|}}{{hercules:userref:bf:image091.gif|}}{{hercules:userref:bf:image092.gif|}}{{hercules:userref:bf:image078.gif|}}{{hercules:userref:bf:image090.gif|}}{{hercules:userref:bf:image093.gif|}}{{hercules:userref:bf:image090.gif|}}{{hercules:userref:bf:image091.gif|}}{{hercules:userref:bf:image057.gif|}}{{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image053.gif|}}<wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap> <wrap>\\ </wrap>**//<wrap>nnnn </wrap>//**<wrap>This must be a number in the range of 1-9999. The default is one if //nnnn //is not specified.</wrap> **//<wrap>8.111.4 Examples</wrap>//** **<wrap>Example 1: \\ </wrap>**<wrap>Rewind a tape.</wrap> <wrap>HHC00013I Herc command: 'mt 0480 rew' \\ HHC02800I 0:0480 rew complete</wrap> <wrap>HHC02802I 0:0480 Current file number 1 \\ HHC02803I 0:0480 Current block number 0</wrap> **<wrap>Figure 207: MT command (REW operation)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Position the tape at file number 5.</wrap> |<WRAP><wrap>HHC00013I Herc command: 'mt 0480 asf</wrap> </WRAP> |||<WRAP><wrap>5'</wrap> </WRAP> | |<WRAP><wrap>HHC02800I</wrap> </WRAP> |<WRAP><wrap>0:0480</wrap> </WRAP> |<WRAP><wrap>asf complete</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02802I</wrap> </WRAP> |<WRAP><wrap>0:0480</wrap> </WRAP> |<WRAP><wrap>Current file number</wrap> </WRAP> |<WRAP><wrap>5</wrap> </WRAP> | |<WRAP><wrap>HHC02803I</wrap> </WRAP> |<WRAP><wrap>0:0480</wrap> </WRAP> |<WRAP><wrap>Current block number</wrap> </WRAP> |<WRAP><wrap>775</wrap> </WRAP> | **<wrap>Figure 208: MT command (ASF operation)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Forward space 2 files.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command:</wrap> </WRAP> |<WRAP><wrap>'mt 0480 fsf</wrap> </WRAP> |<WRAP><wrap>2'</wrap> </WRAP> | |<WRAP><wrap>HHC02800I</wrap> </WRAP> |<WRAP><wrap>0:0480 fsf complete</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02802I</wrap> </WRAP> |<WRAP><wrap>0:0480 Current</wrap> </WRAP> |<WRAP><wrap>file number</wrap> </WRAP> |<WRAP><wrap>7</wrap> </WRAP> | |<WRAP><wrap>HHC02803I</wrap> </WRAP> |<WRAP><wrap>0:0480 Current</wrap> </WRAP> |<WRAP><wrap>block number</wrap> </WRAP> |<WRAP><wrap>2471</wrap> </WRAP> | **<wrap>Figure 209: MT command (FSF operation)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Forward space 3 records.</wrap> <wrap>HHC00013I Herc command: 'mt 0480 fsr 3' \\ HHC02800I 0:0480 fsr complete</wrap> <wrap>HHC02802I 0:0480 Current file number 7 \\ HHC02803I 0:0480 Current block number 2474</wrap> **<wrap>Figure 210: MT command (FSR operation)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 462</wrap> <wrap>\\ </wrap>**<wrap>Example 5:</wrap>** <wrap>Write 3 tapemarks.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command:</wrap> </WRAP> |<WRAP><wrap>'mt 0480 wtm</wrap> </WRAP> |<WRAP><wrap>3'</wrap> </WRAP> | |<WRAP><wrap>HHC02800I</wrap> </WRAP> |<WRAP><wrap>0:0480 wtm complete</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02802I</wrap> </WRAP> |<WRAP><wrap>0:0480 Current</wrap> </WRAP> |<WRAP><wrap>file number</wrap> </WRAP> |<WRAP><wrap>10</wrap> </WRAP> | |<WRAP><wrap>HHC02803I</wrap> </WRAP> |<WRAP><wrap>0:0480 Current</wrap> </WRAP> |<WRAP><wrap>block number</wrap> </WRAP> |<WRAP><wrap>2477</wrap> </WRAP> | **<wrap>Figure 211: MT command (WTM operation)</wrap>** **<wrap>Example 6: \\ </wrap>**<wrap>Erase a tape.</wrap> <wrap>HHC00013I Herc command: 'mt 0480 dse' \\ HHC02800I 0:0480 dse complete</wrap> <wrap>HHC02802I 0:0480 Current file number 1 \\ HHC02803I 0:0480 Current block number 0</wrap> **<wrap>Figure 212: MT command (DSE operation)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 463</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.112 NUMCPU (Display or set number of emulated CPUs) //8.112.1 Function//</wrap>** <wrap>The NUMCPU commands displays or sets the number of emulated processor engines which will be configured online at startup time. The combination of NUMCPU and MAXCPU controls the behaviour of how many CPU engines will be configured online upon startup and how many can be configured online later.</wrap> <wrap>NUMCPU cannot exceed the value of MAXCPU. If NUMCPU is less than MAXCPU then the remaining engines can be configured online later. The default NUMCPU value is 1. All processors are CP engines unless otherwise specified by the ENGINES system parameter.</wrap> <wrap>Multiprocessor emulation works best if your host system actually has more than one physical CPU, but you can still emulate multiple CPUs nevertheless even on a uniprocessor system (and you might even achieve a small performance benefit when you do).</wrap> <wrap>There is little point, however, in specifying NUMCPU greater than 1 unless your guest operating system (running under Hercules) is actually able to support multiple CPUs. If you do not actually need multiprocessor emulation, then setting MAX_CPU_ENGINES to 1 at compile time might even produce a slight performance advantage too.</wrap> <wrap>Given without an argument the NUMCPU command displays the current number of emulated CPUs.</wrap> <wrap>For detailed explanations on the interrelationship between NUMCPU, MAXCPU and ENGINES please see “Appendix B. Configuration of Emulated CPUs”.</wrap> **//<wrap>8.112.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>NUMCPU </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>NUMCPU</wrap> //<wrap>nn</wrap>// **//<wrap>8.112.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>The number of emulated CPUs. NUMCPU must be less than or equal MAXCPU. If NUMCPU is larger than MAXCPU then an error message is issued, if it is less than</wrap> <wrap>MAXCPU then the remaining engines can be configured online later.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 464</wrap> <wrap>\\ </wrap>**//<wrap>8.112.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current number of emulated CPUs.</wrap> <wrap>HHC00013I Herc command: 'numcpu'</wrap> <wrap>HHC02203I numcpu : 2</wrap> **<wrap>Figure 213: NUMCPU command (display current number of emulated CPUs)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the number of emulated CPUs to 4 (increase from 2 currently).</wrap> <wrap>HHC00013I Herc command: 'numcpu 4'</wrap> <wrap>HHC00100I Thread id 0000080C, prio 0, name 'Processor CP02' started</wrap> <wrap>HHC00811I Processor CP02: architecture mode 'S/370'</wrap> <wrap>HHC00100I Thread id 00000CB4, prio 0, name 'Processor CP03' started</wrap> <wrap>HHC00811I Processor CP03: architecture mode 'S/370'</wrap> <wrap>HHC02204I numcpu set to 4</wrap> **<wrap>Figure 214: NUMCPU command (increase emulated CPUs)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the number of emulated CPUs to (reduce from 4 currently).</wrap> <wrap>HHC00013I Herc command: 'numcpu 2'</wrap> <wrap>HHC00101I Thread id 0000080C, prio 0, name 'Processor CP02' ended</wrap> <wrap>HHC00101I Thread id 00000CB4, prio 0, name 'Processor CP03' ended</wrap> <wrap>HHC02204I numcpu set to 2</wrap> **<wrap>Figure 215: NUMCPU command (reduce emulated CPUs)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 465</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.113 NUMVEC (Display or set number of vector facilities) //8.113.1 Function//</wrap>** <wrap>The NUMVEC command displays or sets the number of emulated vector facilities. The vector facility is only available in ESA/390 mode by default. Given without an argument the NUMVEC command displays the current number of vector facilities.</wrap> **//<wrap>8.113.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>NUMVEC </wrap>**<wrap>[</wrap>****//<wrap>nn</wrap>//****<wrap>]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ </wrap>**<wrap>NUMVEC </wrap>**__<wrap>¬¬¬§¬¬¬¬¬¬</wrap>__****<wrap></wrap>** <wrap>⡿¬¬¬</wrap>**//<wrap>nn</wrap>//** **//<wrap>8.113.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This is the number of desired vector facilities.</wrap> **//<wrap>8.113.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current number of vector facilities.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'numvec'</wrap> <wrap>HHC02203I numvec : 1</wrap> **<wrap>Figure 216: NUMVEC command (display current number of vector facilities)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the number of vector facilities to 2.</wrap> <wrap>HHC00013I Herc command: 'numvec 2'</wrap> <wrap>HHC02204I numvec set to 2</wrap> **<wrap>Figure 217: NUMVEC command (set number of vector facilities)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 466</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.114 OSTAILOR (Tailor trace information for specific operating system)</wrap>** **//<wrap>8.114.1 Function</wrap>//** <wrap>The OSTAILOR command lets you display or (re-)specify the intended operating system. The effect of this parameter is to reduce control panel message traffic by selectively suppressing trace messages for program checks which are considered normal in the specified environment.</wrap> <wrap>The argument //QUIET //suppresses all exception messages, whereas the argument //NULL //suppresses none of them. The other options do suppress some messages and do not supress other messages depending on the specified operating system.</wrap> <wrap>Prefix values with a plus (“+”) to combine them with existing values or with a minus (“-“) to exclude them from existing values. See also the PGMTRACE console command which allows you to further fine tune the tracing of program interrupt exceptions.</wrap> **//<wrap>8.114.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>OSTAILOR [[+ | </wrap>****<wrap>-] </wrap>****<wrap>z/OS | OS/390 | VM | z/VSE | VSE | LINUX | OPENSOLARIS | QUIET | NULL]</wrap>** |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>oo¬¬¬ OSTAILOR</wrap>** </WRAP> |<WRAP>**<wrap>¬¬¬</wrap>****<wrap>§¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>****<wrap>ª¬¬¬</wrap>****<wrap>+ ¬¬¬« </wrap>****<wrap>ª¬¬¬¬¬¬¬ z/OS ¬¬¬¬¬¬¬«</wrap>** **<wrap>⡿¬</wrap>****<wrap>¬¬ - ¬¬¬</wrap>****<wrap>¯ ª¬¬¬¬¬¬ OS/390 ¬¬¬¬¬¬« ª¬¬¬</wrap>****<wrap>¬</wrap>****<wrap>¬¬¬¬VM ¬¬¬¬¬¬¬¬« ª¬¬¬¬¬¬¬VSE ¬¬¬¬¬¬¬¬« ª¬¬¬¬¬¬z/VSE ¬¬¬¬¬¬¬« ª¬¬¬¬¬¬LINUX ¬¬¬¬¬¬¬« ª¬¬¬OPENSOLARIS </wrap>****<wrap>¬¬¬¬« </wrap>****<wrap>ª¬¬¬¬¬¬QUIET ¬¬¬¬¬¬¬« ⡿¬</wrap>****<wrap>¬¬¬¬</wrap>****<wrap>¬NULL ¬¬</wrap>****<wrap>¬¬¬¬</wrap>****<wrap>¬¬¯</wrap>** </WRAP> | **//<wrap>8.114.3 Parameter</wrap>//** **<wrap>+ </wrap>**<wrap>Specifies to combine the value withexisting values.</wrap> **<wrap>- </wrap>**<wrap>Specifies to exclude the value from existing values.</wrap> **<wrap>z/OS </wrap>**<wrap>Code z/OS if you intend to run z/OS.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 467</wrap> <wrap>\\ </wrap>**<wrap>OS/390 </wrap>**<wrap>Code OS/390 if you intend to run MVS/370, MVS/XA, MVS/ESA, OS/390.</wrap> **<wrap>VM </wrap>**<wrap>Code VM if you intend to run VM/370, VM/ESA or z/VM.</wrap> **<wrap>VSE </wrap>**<wrap>Code VSE if you intend to run VSE/370 or VSE/ESA.</wrap> **<wrap>z/VSE </wrap>**<wrap>Code z/VSE if you intend to run z/VSE.</wrap> **<wrap>LINUX </wrap>**<wrap>Code Linux if you intend to run Linux/390 or Linux for z/Series.</wrap> **<wrap>OpenSolaris </wrap>**<wrap>Code OpenSolaris if you intend to run OpenSolaris for z/Series.</wrap> **<wrap>QUIET </wrap>**<wrap>QUIET discards all exception messages.</wrap> **<wrap>NULL </wrap>**<wrap>NULL allows all exception messages to be logged.</wrap> **//<wrap>8.114.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the currently specified intended operating system.</wrap> <wrap>HHC00013I Herc command: 'ostailor'</wrap> <wrap>HHC02203I ostailor : z/OS</wrap> **<wrap>Figure 218: OSTAILOR command (display intended operating system)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Change the specified intended operating system to Linux.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'ostailor linux'</wrap> <wrap>HHC00013I Herc command: 'ostailor'</wrap> <wrap>HHC02203I ostailor : LINUX</wrap> **<wrap>Figure 219: OSTAILOR command (specify intended operating system)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 468</wrap> <wrap>\\ </wrap>**<wrap>Example 3:</wrap>** <wrap>Set the specified intended operating system to VM and combine it with z/OS and VSE, then display the currently specified value(s).</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'ostailor vm' \\ HHC00013I Herc command: 'ostailor +z/OS' \\ HHC00013I Herc command: 'ostailor +vse'</wrap> <wrap>HHC00013I Herc command: 'ostailor'</wrap> <wrap>HHC02203I ostailor : Custom(0x7B7673FFF7DE7FB4)</wrap> **<wrap>Figure 220: OSTAILOR command (combine intended operating systems)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Display the currently specified intended operating system(s) and exclude z/OS from the existing values. Then display again the currently specified value(s).</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'ostailor'</wrap> <wrap>HHC02203I ostailor : Custom(0x7B7673FFF7DE7FB4)</wrap> <wrap>HHC00013I Herc command: 'ostailor -z/OS'</wrap> <wrap>HHC00013I Herc command: 'ostailor'</wrap> <wrap>HHC02203I ostailor : Custom(0xFFFFFFFFFFFFFFFC)</wrap> **<wrap>Figure 221: OSTAILOR command (combine intended operating systems)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 469</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.115 PANRATE (Display or set console refresh rate) \\ //8.115.1 Function//</wrap>** <wrap>The PANRATE command shows the current setting of the console (panel) refresh rate and allows a new value to be set.</wrap> **//<wrap>8.115.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PANRATE [SLOW | FAST | </wrap>//<wrap>rate</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬PANRATE ¬¬¬§¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬</wrap><wrap>I</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ SLOW¬¬¬«</wrap> <wrap>ª¬¬¬FAST¬¬¬«</wrap> <wrap>⡿¬</wrap><wrap>¬¬ </wrap>//<wrap>rate </wrap>//<wrap>¬¬¬¯</wrap> **//<wrap>8.115.3 Parameter</wrap>//** **<wrap>SLOW </wrap>**<wrap>SLOW is a synonym for a panel refresh rate of 500 milliseconds.</wrap> **<wrap>FAST </wrap>**<wrap>FAST is a synonym for a panel refresh rate of 50 milliseconds.</wrap> **//<wrap>rate </wrap>//**<wrap>Any value between 1 (10) and 5000 milliseconds. A value less than the Linux system clock tick interval (10 on Intel platforms, 1 on Alpha platforms) or a value of more than 5000 will be rejected.</wrap> **//<wrap>8.115.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display current panel refresh rate.</wrap> <wrap>HHC00013I Herc command: 'panrate'</wrap> <wrap>HHC02203I panrate : 1000</wrap> **<wrap>Figure 222: PANRATE command (list current panel refresh rate)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 470</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set panel refresh rate to 500 milliseconds.</wrap> <wrap>HHC00013I Herc command: 'panrate 500'</wrap> <wrap>HHC02204I panrate set to 500</wrap> **<wrap>Figure 223: PANRATE command (set new panel refresh rate)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 471</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.116 PANTITLE (Display or set console window title) //8.116.1 Function//</wrap>** <wrap>The PANTITLE command displays or sets an optional console window title-bar string to be used in place of the default title supplied by the windowing system. This option allows one to distinguish between different Hercules sessions when running more than one instance of Hercules on the same machine. Given without an argument the PANTITLE command displays the current console window title.</wrap> <wrap>The PANTITLE option takes effect only when the Hercules console is displayed on an ‘xterm’ terminal (commonly used on Unix systems) or in a Windows command prompt window. Note that this option has no effect when Hercules is run under the control of the Hercules Windows GUI since Hercules's console window is hidden in favour of using the GUI's window instead.</wrap> <wrap>The default console title is a string consisting of the following information: \\ //“LPARNAME //– //SYSTYPE //* //SYSNAME //* //SYSPLEX //– System Status: //colour//”</wrap> <wrap>SYSTYPE, SYSNAME and SYSPLEX are populated by the system call SCLP Control Program Identification. If any of these values is blank, then that field is not presented in the console title. The system status colour has following meanings:</wrap> **<wrap>RED </wrap>**<wrap>One or more CPUs are in a disabled wait state.</wrap> **<wrap>AMBER </wrap>**<wrap>One or more CPUs are not running.</wrap> **<wrap>GREEN </wrap>**<wrap>Everything is working correctly.</wrap> **//<wrap>8.116.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PANTITLE </wrap>//<wrap>[text </wrap>//<wrap>| </wrap>//<wrap>"text text text" </wrap>//<wrap>|</wrap>//<wrap>""</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** |<WRAP><wrap>ÊÊ%%__%%%%__%%%%__%%PANTITLE</wrap> </WRAP> |<WRAP><wrap>%%__%%%%__%%%%__%%§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%</wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>// <wrap>ª%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%% </wrap>//<wrap>text ¬¬¬¬¬¬¬¬¬«</wrap>// <wrap>ª%%__%%%%__%%%%__%% </wrap>//<wrap>"text text text" ¬¬¬«</wrap>// <wrap>⡿%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%% </wrap>//<wrap>"" </wrap>//<wrap>%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%¯</wrap> </WRAP> | **//<wrap>8.116.3 Parameter</wrap>//** **//<wrap>text </wrap>//**<wrap>Specifies the optional console window title-bar string to be used. If the value contains any blanks it must be enclosed within double-quotes ("). An empty string ("") will remove the default console title.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 472</wrap> <wrap>\\ </wrap>**//<wrap>8.116.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the console window title to “Hercules Emulator HMC”.</wrap> <wrap>HHC00013I Herc command: 'pantitle "Hercules Emulator HMC"'</wrap> <wrap>HHC02204I pantitle set to Hercules Emulator HMC</wrap> **<wrap>Figure 224: PANTITLE command (set a new console window title)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Remove the current window console title.</wrap> <wrap>HHC00013I Herc command: 'pantitle ""'</wrap> <wrap>HHC02204I pantitle set to (none)</wrap> **<wrap>Figure 225: PANTITLE command (remove console window title)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 473</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.117 PGMPRDOS (Set LPP license setting) \\ //8.117.1 Function//</wrap>** <wrap>The PGMPRDOS command specifies whether or not Hercules will run licensed program product (LPP) ESA or z/Architecture operating systems.</wrap> **//<wrap>8.117.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PGMPRD0S (RESTRICTED | LICENSED}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬PGMPRD0S ¬¬¬§¬¬¬ RESTRICTED </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>⡿¬¬¬¬LICENSED¬¬¬¬¯</wrap> **//<wrap>8.117.3 Parameter</wrap>//** **<wrap>RESTRICTED </wrap>**<wrap>When PGMPRDOS is set to RESTRICTED, Hercules will stop all CPUs when a licensed program product operating systems is detected. RESTRICTED is the default.</wrap> **<wrap>LICENSED </wrap>**<wrap>Setting PGMPRDOS to LICENSED will allow you to run licensed program product operating systems normally. This parameter has no effect on Linux/390, Linux for z/Series, or any 370-mode operating system. If you are running Hercules under the Windows GUI a pop up window appears during startup which must be acknowledged before the startup continuous.</wrap> **//<wrap>8.117.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Allow licensed program product operating systems to run normally.</wrap> <wrap>HHC00013I Herc command: 'pgmprdos licensed'</wrap> **<wrap>Figure 226: PGMPRDOS command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 474</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.118 PGMTRACE (Trace program interrupts) \\ //8.118.1 Function//</wrap>** <wrap>The PGMTRACE command without arguments displays the actual trace program interrupt options. Given with an argument (interruption code) the command changes the current options. Precede the interruption code with a minus sign to stop tracing of that particular interruption code. See also the OSTAILOR console command which allows you to further fine tune the tracing of program interrupt exceptions.</wrap> **//<wrap>8.118.2 Syntax</wrap>//** {{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image094.gif|}}{{hercules:userref:bf:image028.gif|}}{{hercules:userref:bf:image029.gif|}}**//<wrap>8.118.3 Parameter</wrap>//** **//<wrap>intcode </wrap>//**<wrap>Specifies the interruption code for which trace information is to be written to the Hercules log or for which the trace information is to be stopped. //intcode //has to be a valid program interruption code in the range from 0x01 to 0x40.</wrap> **<wrap>- </wrap>**<wrap>A minus sign, directly preceding the //intcode //parameter, stops tracing for that particular interruption code.</wrap> **//<wrap>8.118.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current program interruption trace settings.</wrap> <wrap>HHC00013I Herc command: 'pgmtrace'</wrap> <wrap>HHC02281I * = Tracing suppressed; otherwise tracing enabled</wrap> <wrap>HHC02281I 0000000000000001111111111111111222222222222222233333333333333334</wrap> <wrap>HHC02281I 123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0</wrap> <wrap>HHC02281I * %%**%% * * %%**%% %%**%% * *</wrap> **<wrap>Figure 227: PGMTRACE command (display settings)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 475</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Change the current program interruption trace settings.</wrap> <wrap>HHC00013I Herc command: 'pgmtrace 04'</wrap> <wrap>HHC00013I Herc command: 'pgmtrace'</wrap> <wrap>HHC02281I * = Tracing suppressed; otherwise tracing enabled</wrap> <wrap>HHC02281I 0000000000000001111111111111111222222222222222233333333333333334</wrap> <wrap>HHC02281I 123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0</wrap> <wrap>HHC02281I * %%**%% * * %%**%% %%**%% * * * *</wrap> **<wrap>Figure 228: PGMTRACE command (change settings)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 476</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.119 PLANT (Display or set STSI plant code) \\ //8.119.1 Function//</wrap>** <wrap>The PLANT console command displays or sets the plant name returned by the STSI instruction. If no argument is given, the current plant name is displayed.</wrap> **//<wrap>8.119.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>PLANT [</wrap>//<wrap>name</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap>\\ </wrap>**<wrap>ÊÊ¬¬¬PLANT</wrap> //<wrap>name</wrap>// **//<wrap>8.119.3 Parameter</wrap>//** **//<wrap>name </wrap>//**<wrap>Any name with a maximum length of four characters.</wrap> **//<wrap>8.119.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the STSI plant name to ‘ZZ’.</wrap> <wrap>HHC00013I Herc command: 'plant ZZ'</wrap> <wrap>HHC02204I plant set to ZZ</wrap> **<wrap>Figure 229: PLANT command (set STSI plant name)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 477</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.120 PR (Display prefix register) \\ //8.120.1 Function//</wrap>** <wrap>The PR command displays the contents of the prefix registers.</wrap> **//<wrap>8.120.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>PR</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ PR</wrap>** **//<wrap>8.120.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.120.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the prefix register.</wrap> <wrap>HHC00013I Herc command: 'pr'</wrap> <wrap>HHC02277I Prefix register: 7FA03000</wrap> **<wrap>Figure 230: PR command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 478</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.121 PSCP (Send system control program priority message) //8.121.1 Function//</wrap>** <wrap>The PSCP command sends a system control program (i.e. guest operating system) priority command in any CMDTGT mode.</wrap> **//<wrap>8.121.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>PSCP [</wrap>//<wrap>cmd]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊØØØPSCP</wrap> //<wrap>cmd</wrap>// **//<wrap>8.121.3 Parameter</wrap>//** **//<wrap>cmd </wrap>//**<wrap>This is the command to be sent as a system control program (i.e. guest operating system) priority command.</wrap> **//<wrap>8.121.4 Examples</wrap>//** <wrap>For a similar sample please refer to the SCP command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 479</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.122 PSW (Display or alter program status word) \\ //8.122.1 Function//</wrap>** <wrap>The PSW command displays or alters the actual content of the Program Status Word (PSW).</wrap> **//<wrap>8.122.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>PSW [</wrap>//<wrap>operand=value </wrap>//<wrap>[</wrap>//<wrap>operand=value </wrap>//<wrap>... ]]</wrap> <wrap>where operand can be</wrap><wrap>:</wrap> <wrap>SM=</wrap>//<wrap>xx</wrap>// <wrap>PK=</wrap>//<wrap>nn</wrap>// <wrap>CMWP=</wrap>//<wrap>x</wrap>// <wrap>AS=[PRI | SEC | HOME]</wrap> <wrap>CC=</wrap>//<wrap>n</wrap>// <wrap>PM=</wrap>//<wrap>x</wrap>// <wrap>IA=</wrap>//<wrap>xxxxxxxx</wrap>// <wrap>AM=[24 | 31 | 64]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬PSW</wrap> //<wrap>operand=value</wrap>// <wrap>where operand can be</wrap><wrap>: </wrap><wrap>ª</wrap><wrap>¬¬- SM=</wrap>//<wrap>xx </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬ </wrap><wrap>ª</wrap><wrap>¬¬¬ PK=</wrap>//<wrap>nn </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬ </wrap><wrap>ª¬¬¬ CMWP=</wrap>//<wrap>x </wrap>//<wrap>¬¬¬¬¬¬¬¬¬¬¬¬</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 480</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>ª</wrap><wrap>¬¬¬AS= ¬¬¬§¬¬¬ PRI ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª¬¬¬ SEC ¬¬¬¬«</wrap> <wrap>⡿¬¬¬ HOME¬¬¬¯</wrap> <wrap>i</wrap><wrap>¬¬¬ CC=</wrap><wrap>n ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>__<wrap>«</wrap>__<wrap></wrap> <wrap>ª</wrap><wrap>¬¬¬ PM=</wrap><wrap>x ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>__<wrap>«</wrap>__<wrap></wrap> <wrap>[¬¬¬ IA=</wrap><wrap>xxxxxxxx ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>__<wrap>«</wrap>__<wrap></wrap> <wrap>F</wrap><wrap>¬¬¬AM=¬¬¬§¬¬¬24¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª¬¬¬31¬¬¬«</wrap> <wrap>⡿¬¬¬64¬¬¬¯</wrap> **//<wrap>8.122.3 Parameter</wrap>//** **<wrap>SM=//xx //</wrap>**<wrap>Modifies the PSW system mask (xx is 2 hexadecimal digits).</wrap> **<wrap>PK=//nn //</wrap>**<wrap>Modifies the PSW protection key (nn is decimal 0 to 15).</wrap> **<wrap>CMWP=//x //</wrap>**<wrap>Modifies the EC/M/W/P bits of the PSW (x is 1 hexadecimal digit).</wrap> **<wrap>AS=//aspace //</wrap>**<wrap>This modifies the PSW address space control bits. The address space aspace must be ‘PRI’, ‘SEC’ or ‘HOME’.</wrap> **<wrap>CC=//n //</wrap>**<wrap>Modifies the PSW condition code (n is decimal 0 to 3).</wrap> **<wrap>PM=//x //</wrap>**<wrap>Modifies the PSW program mask (x is one hexadecimal digit).</wrap> **<wrap>IA=//xxxxxxxx //</wrap>**<wrap>Modifies the PSW instruction address (//xxxxxxxx //is one to 16 hexadecimal digits).</wrap> **<wrap>AM=//amode //</wrap>**<wrap>Modifies the addressing mode bits of the PSW. The addressing mode //amode //must be 24, 31 or 64 bit.</wrap> **//<wrap>8.122.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the Program Status Word.</wrap> <wrap>HHC00013I Herc command: 'psw'</wrap> <wrap>HHC02278I Program status word: 070E000000000000</wrap> <wrap>HHC02300I sm=07 pk=0 cmwp=E as=pri cc=0 pm=0 am=24 ia=0</wrap> **<wrap>Figure 231: PSW command (display PSW).</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 481</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Change the PSW condition code to zero.</wrap> <wrap>HHC00013I Herc command: 'psw cc=0'</wrap> <wrap>HHC02278I Program status word: 070E000000000000</wrap> <wrap>HHC02300I sm=07 pk=0 cmwp=E as=pri cc=0 pm=0 am=24 ia=0</wrap> **<wrap>Figure 232: PSW command (modify condition code)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Change the PSW condition code to zero and the addressing mode bits to AM=31.</wrap> <wrap>HHC00013I Herc command: 'psw cc=0 am=31'</wrap> <wrap>HHC02278I Program status word: 070E000080000000</wrap> <wrap>HHC02300I sm=07 pk=0 cmwp=E as=pri cc=0 pm=0 am=31 ia=0</wrap> **<wrap>Figure 233: PSW command (modify condition code and addressing mode)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 482</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.123 PTP (Enable / disable PTP debugging) \\ //8.123.1 Function//</wrap>** <wrap>The PTP command enables or disables debug tracing for the device group identified by //devnum //or for all device group(s) if //devnum //is not specified or specified as ‘ALL’.</wrap> **//<wrap>8.123.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PIP DEBUG (ON | OFF} [//devnum //| __ALL__] [//mask//]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬ ALL ¬¬¬¬¬®</wrap> <wrap>ÊÊ¬¬¬ PIP %%__%%_ DEBUG %%__%%_§%%__%%_ ON%%__%%%%__%%§%%__%%_¦%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%¦%%__%%_§%%__%%%%__%%¬¬¬¬¬¬¬¬§¬¬¬¬ÊÍ</wrap> <wrap>⡿%%__%%_ OFF %%__%%_¯ ⡿%%__%%_ //devnum //%%__%%_¯ ⡿%%__%%_ //mask //%%__%%_¯</wrap> **//<wrap>8.123.3 Parameter</wrap>//** **<wrap>ON </wrap>**<wrap>Enables the PTP debug tracing.</wrap> **<wrap>OFF </wrap>**<wrap>Disables the PTP debug packet tracing.</wrap> **//<wrap>devnum </wrap>//**<wrap>Specifies the PTP device group(s) for which debug tracing has to be enabled or disabled.</wrap> **<wrap>ALL </wrap>**<wrap>Enables or disables the debug tracing for all PTP device groups. 'ALL' is the default if no device group is specified.</wrap> **//<wrap>mask </wrap>//**<wrap>Specifies the type of debug output to be produced. //mask //is a value from 1 to 255. The following debug output can be selected:</wrap> <wrap>·<wrap></wrap></wrap><wrap>Xxx</wrap> <wrap>·<wrap></wrap></wrap><wrap>Xxx</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 483</wrap> <wrap>\\ </wrap>**//<wrap>8.123.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Enable the debug tracing for all PTP devices. Please note that not all hex columns can be displayed in the figure below. Missing columns have been marked with “//∫∫//”.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'ptp debug on all'</wrap> <wrap>HHC02204I PTP debug set to on ALL</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 234: PTP command (enable debug tracing)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Disable the PTP debug tracing.</wrap> <wrap>HHC00013I Herc command: 'ptp debug off'</wrap> <wrap>HHC02204I PTP debug set to off</wrap> **<wrap>Figure 235: PTP command (disable debug tracing)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 484</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.124 PTT (Display or set internal trace) \\ //8.124.1 Function//</wrap>** <wrap>The PTT command sets or displays the internal trace options. When specified with no operands, the PTT command displays the trace options and the contents of the internal trace table.</wrap> <wrap>When specified with operands, the PTT command sets the trace options and/or specifies which events are to be traced. If the last operand is numeric, it sets the size of the trace table and activates the trace.</wrap> <wrap>The following events can be traced:</wrap> <wrap>·<wrap></wrap></wrap><wrap>Internal logger events</wrap> <wrap>·<wrap></wrap></wrap><wrap>Internal timer events</wrap> <wrap>·<wrap></wrap></wrap><wrap>Internal threading events</wrap> <wrap>·<wrap></wrap></wrap><wrap>Instruction information events</wrap> <wrap>·<wrap></wrap></wrap><wrap>Instruction error events</wrap> <wrap>·<wrap></wrap></wrap><wrap>Program interrupt events</wrap> <wrap>·<wrap></wrap></wrap><wrap>Interlocked instruction type events</wrap> <wrap>·<wrap></wrap></wrap><wrap>SIE instruction events</wrap> <wrap>·<wrap></wrap></wrap><wrap>SIGP instruction events</wrap> <wrap>·<wrap></wrap></wrap><wrap>I/O instruction events</wrap> <wrap>·<wrap></wrap></wrap><wrap>LCS timing events</wrap> <wrap>·<wrap></wrap></wrap><wrap>QETH timing events</wrap> <wrap>The following options can be set:</wrap> <wrap>·<wrap></wrap></wrap><wrap>Lock table before updating</wrap> <wrap>·<wrap></wrap></wrap><wrap>Timestamp table entries</wrap> <wrap>·<wrap></wrap></wrap><wrap>Wraparound trace table</wrap> <wrap>·<wrap></wrap></wrap><wrap>Automatic display timeout</wrap> <wrap>·<wrap></wrap></wrap><wrap>Table size</wrap> **//<wrap>8.124.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PTT </wrap><wrap>[events] [options] [TO=</wrap>//<wrap>nnn</wrap>//<wrap>] [//mmmmm//]</wrap> <wrap>where </wrap><wrap>events </wrap><wrap>can be</wrap><wrap>:</wrap> <wrap>[NO]LOG \\ [NO]TMR \\ [NO]THR</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 485</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>[NO]INF \\ [NO]ERR \\ [NO]PGM \\ [NO]CSF \\ [NO]SIE \\ [NO]SIG \\ [NO]IO</wrap> <wrap>[NO]LCS \\ [NO]QETH</wrap> <wrap>and where options can be</wrap><wrap>:</wrap> <wrap>[NO]LOCK \\ [NO]TOD \\ [NO]WRAP</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ PTT </wrap><wrap>%%__%%_°%%__%%_« //events //ª%%__%%_¨%%__%%_°%%__%%_I </wrap>//<wrap>options </wrap>//<wrap>ª%%__%%_'%%__%%_</wrap><wrap>§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§</wrap> <wrap>⡿%%__%%_TO=</wrap>//<wrap>nnn </wrap>//<wrap>%%__%%_</wrap> //<wrap>mmmmm</wrap>// <wrap>where </wrap><wrap>events </wrap><wrap>can be</wrap><wrap>:</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ LOG \\ ⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ TMR \\ ⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ </wrap><wrap>THR \\ </wrap><wrap>⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ INF \\ ⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ E</wrap><wrap>RR \\ </wrap><wrap>⡿%%__%%_ NO %%__%%_¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 486</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ PGM \\ ⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ CSF \\ ⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ SIE \\ ⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ SIG \\ ⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ IO \\ ⡿%%__%%_NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ LCS \\ ⡿%%__%%_ NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ QETH \\ ⡿%%__%%_ NO ¬¬_¯</wrap> <wrap>and where options can be:</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ LOCK \\ ⡿%%__%%_ NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ TOD \\ ⡿%%__%%_ NO %%__%%_¯</wrap> <wrap>ª%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ WRAP \\ ⡿%%__%%_ NO %%__%%_¯</wrap> **//<wrap>8.124.3 Parameter</wrap>//** **<wrap>NO//xxxxxxxx //</wrap>**<wrap>Deselects the specified trace entry type or deselects the specified option.</wrap> **<wrap>LOG </wrap>**<wrap>Selects the internal logger trace entries.</wrap> **<wrap>TMR </wrap>**<wrap>Selects the internal timer trace entries.</wrap> **<wrap>THR </wrap>**<wrap>Selects the internal threading trace entries.</wrap> **<wrap>INF </wrap>**<wrap>Selects the instruction information trace entries.</wrap> **<wrap>ERR </wrap>**<wrap>Selects the instruction error trace entries.</wrap> **<wrap>PGM </wrap>**<wrap>Selects the program interrupt trace entries.</wrap> **<wrap>CSF </wrap>**<wrap>Select the interlocked instruction type trace entries.</wrap> **<wrap>SIE </wrap>**<wrap>Selects the SIE instruction trace entries.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 487</wrap> <wrap>\\ </wrap>**<wrap>SIGP </wrap>**<wrap>Selects the SIGP instruction trace entries.</wrap> **<wrap>IO </wrap>**<wrap>Selects the I/O instruction trace entries.</wrap> **<wrap>LCS </wrap>**<wrap>Selects the LCS timing trace entries.</wrap> **<wrap>QETH </wrap>**<wrap>Selects the QETH timing trace entries.</wrap> **<wrap>LOCK </wrap>**<wrap>Lock table before updating</wrap> **<wrap>TOD </wrap>**<wrap>Timestamp table entries</wrap> **<wrap>WRAP </wrap>**<wrap>Specifies that the trace table has be overwritten when it is full. As soon as the end of the table is reached, the next entry to be written to the table goes to the start and overlays the trace entry that was formerly there.</wrap> **<wrap>TO=//nnn //</wrap>**<wrap>Timeout in seconds before the automatic issuance of the PTT command is to occur, to print (display) the internal trace table.</wrap> **//<wrap>mmmmm </wrap>//**<wrap>Number of trace entries to be kept.</wrap> **//<wrap>8.124.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current defaults, then set the pthread trace options and start the trace.</wrap> <wrap>HHC00013I Herc command: 'ptt'</wrap> <wrap>HHC90012I Pttrace: lock tod wrap to 0 0</wrap> <wrap>HHC00013I Herc command: 'ptt prog inter signal io threads logger nowrap 10000'</wrap> **<wrap>Figure 236: PTT command (display trace options / set options and start trace)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Display the pthread trace entries.</wrap> |<WRAP><wrap>HHC00013I Herc</wrap> </WRAP> |<WRAP><wrap>command: 'ptt'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cmdtab.c:342</wrap> </WRAP> |<WRAP><wrap>05:23:33.429599</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00820738</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:145</wrap> </WRAP> |<WRAP><wrap>05:23:33.429601</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>002334f8</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:145</wrap> </WRAP> |<WRAP><wrap>05:23:33.429602</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>002334f8</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:175</wrap> </WRAP> |<WRAP><wrap>05:23:33.429603</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>002334f8</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1818</wrap> </WRAP> |<WRAP><wrap>05:23:33.429604</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>009473d8</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1818</wrap> </WRAP> |<WRAP><wrap>05:23:33.429605</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>009473d8</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1821</wrap> </WRAP> |<WRAP><wrap>05:23:33.429620</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>009473d8</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1818</wrap> </WRAP> |<WRAP><wrap>05:23:33.429621</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>009473d8</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1818</wrap> </WRAP> |<WRAP><wrap>05:23:33.429622</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>009473d8</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1821</wrap> </WRAP> |<WRAP><wrap>05:23:33.429634</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>009473d8</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | |<WRAP><wrap>logger.c:493</wrap> </WRAP> |<WRAP><wrap>05:23:33.429906</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | |<WRAP><wrap>logger.c:504</wrap> </WRAP> |<WRAP><wrap>05:23:33.429907</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>logger.c:504</wrap> </WRAP> |<WRAP><wrap>05:23:33.429909</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000 0</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 488</wrap> <wrap>\\ </wrap> |<WRAP><wrap>logger.c:505</wrap> </WRAP> |<WRAP><wrap>05:23:33.429919</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>broadcast</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0036a77c</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:506</wrap> </WRAP> |<WRAP><wrap>05:23:33.429921</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:121</wrap> </WRAP> |<WRAP><wrap>05:23:33.429935</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>wait after</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>0036a77c</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:156</wrap> </WRAP> |<WRAP><wrap>05:23:33.429936</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>hao.c:589</wrap> </WRAP> |<WRAP><wrap>05:23:33.429943</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00830f18</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>hao.c:589</wrap> </WRAP> |<WRAP><wrap>05:23:33.429944</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00830f18</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>hao.c:610</wrap> </WRAP> |<WRAP><wrap>05:23:33.429945</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00830f18</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:115</wrap> </WRAP> |<WRAP><wrap>05:23:33.429946</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>logger.c:115</wrap> </WRAP> |<WRAP><wrap>05:23:33.429947</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:121</wrap> </WRAP> |<WRAP><wrap>05:23:33.429948</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>wait before</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>0036a77c</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cpu.c:1744</wrap> </WRAP> |<WRAP><wrap>05:23:33.435955</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>wait after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>03426d94</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cpu.c:1759</wrap> </WRAP> |<WRAP><wrap>05:23:33.435957</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cpu.c:1586</wrap> </WRAP> |<WRAP><wrap>05:23:33.435959</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cpu.c:1586</wrap> </WRAP> |<WRAP><wrap>05:23:33.435960</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>external.c:54</wrap> </WRAP> |<WRAP><wrap>05:23:33.435966</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>*EXTINT</wrap> </WRAP> |<WRAP><wrap>00001004</wrap> </WRAP> |<WRAP><wrap>00000004</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>external.c:127</wrap> </WRAP> |<WRAP><wrap>05:23:33.435968</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:6474</wrap> </WRAP> |<WRAP><wrap>05:23:33.435981</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>control.c:6474</wrap> </WRAP> |<WRAP><wrap>05:23:33.435982</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:6497</wrap> </WRAP> |<WRAP><wrap>05:23:33.435986</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:4570</wrap> </WRAP> |<WRAP><wrap>05:23:33.436008</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>control.c:4570</wrap> </WRAP> |<WRAP><wrap>05:23:33.436009</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:4581</wrap> </WRAP> |<WRAP><wrap>05:23:33.436011</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:4570</wrap> </WRAP> |<WRAP><wrap>05:23:33.436028</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>control.c:4570</wrap> </WRAP> |<WRAP><wrap>05:23:33.436029</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:4581</wrap> </WRAP> |<WRAP><wrap>05:23:33.436031</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:4570</wrap> </WRAP> |<WRAP><wrap>05:23:33.436069</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>control.c:4570</wrap> </WRAP> |<WRAP><wrap>05:23:33.436070</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:4581</wrap> </WRAP> |<WRAP><wrap>05:23:33.436072</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:4632</wrap> </WRAP> |<WRAP><wrap>05:23:33.436287</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>control.c:4632</wrap> </WRAP> |<WRAP><wrap>05:23:33.436288</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:4642</wrap> </WRAP> |<WRAP><wrap>05:23:33.436290</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cpu.c:1586</wrap> </WRAP> |<WRAP><wrap>05:23:33.436291</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cpu.c:1586</wrap> </WRAP> |<WRAP><wrap>05:23:33.436292</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cpu.c:1744</wrap> </WRAP> |<WRAP><wrap>05:23:33.436294</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>wait before</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>03426d94</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cpu.c:1744</wrap> </WRAP> |<WRAP><wrap>05:23:33.446986</wrap> </WRAP> |<WRAP><wrap>00000B34</wrap> </WRAP> |<WRAP><wrap>wait after</wrap> </WRAP> |<WRAP><wrap>00233b54</wrap> </WRAP> |<WRAP><wrap>03426d94</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | **<wrap>Figure 237: PTT command (display trace entries)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the pthread trace options, start the trace and issue automatic display of the trace entries after 2 minutes.</wrap> |<WRAP><wrap>HHC90012I Pttrace: prog inter signal io threads logger lock tod nowrap to 0 10000</wrap> <wrap>HHC00013I Herc command: 'ptt prog inter signal io threads logger nowrap to=120 10000'</wrap> <wrap>HHC00100I Thread id 00001610, prio 0, name 'PTT timeout timer' started</wrap> </WRAP> |||||| | |<WRAP><wrap>pttrace.c:270</wrap> </WRAP> |<WRAP><wrap>05:24:09.648613</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>0036aca0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>pttrace.c:270</wrap> </WRAP> |<WRAP><wrap>05:24:09.648615</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>0036aca0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:493</wrap> </WRAP> |<WRAP><wrap>05:24:09.648652</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:504</wrap> </WRAP> |<WRAP><wrap>05:24:09.648654</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>logger.c:504</wrap> </WRAP> |<WRAP><wrap>05:24:09.648655</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>0036a774</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:505</wrap> </WRAP> |<WRAP><wrap>05:24:09.648667</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>broadcast</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>0036a77c</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 489</wrap> <wrap>\\ </wrap> |<WRAP><wrap>logger.c:506</wrap> </WRAP> |<WRAP><wrap>05:24:09.648668</wrap> </WRAP> |<WRAP><wrap>00001118</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>0036a774 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:121</wrap> </WRAP> |<WRAP><wrap>05:24:09.648747</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>wait after</wrap> </WRAP> |<WRAP><wrap>0036a774 0036a77c</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:156</wrap> </WRAP> |<WRAP><wrap>05:24:09.648749</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>0036a774 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>hao.c:589</wrap> </WRAP> |<WRAP><wrap>05:24:09.648758</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00830f18 00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>hao.c:589</wrap> </WRAP> |<WRAP><wrap>05:24:09.648759</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00830f18 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>hao.c:610</wrap> </WRAP> |<WRAP><wrap>05:24:09.648761</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00830f18 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:115</wrap> </WRAP> |<WRAP><wrap>05:24:09.648763</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>0036a774 00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>logger.c:115</wrap> </WRAP> |<WRAP><wrap>05:24:09.648764</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>0036a774 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>logger.c:121</wrap> </WRAP> |<WRAP><wrap>05:24:09.648765</wrap> </WRAP> |<WRAP><wrap>00000CE4</wrap> </WRAP> |<WRAP><wrap>wait before</wrap> </WRAP> |<WRAP><wrap>0036a774 0036a77c</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>pttrace.c:272</wrap> </WRAP> |<WRAP><wrap>05:24:09.648844</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>create</wrap> </WRAP> |<WRAP><wrap>00001610 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>pttrace.c:275</wrap> </WRAP> |<WRAP><wrap>05:24:09.648845</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>0036aca0 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cmdtab.c:342</wrap> </WRAP> |<WRAP><wrap>05:24:09.648848</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00820738 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:145</wrap> </WRAP> |<WRAP><wrap>05:24:09.648851</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>002334f8 00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>dyngui.c:145</wrap> </WRAP> |<WRAP><wrap>05:24:09.648852</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>002334f8 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:175</wrap> </WRAP> |<WRAP><wrap>05:24:09.648854</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>002334f8 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1818</wrap> </WRAP> |<WRAP><wrap>05:24:09.648856</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>009473d8 00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1818</wrap> </WRAP> |<WRAP><wrap>05:24:09.648857</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>009473d8 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1821</wrap> </WRAP> |<WRAP><wrap>05:24:09.648892</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>009473d8 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1818</wrap> </WRAP> |<WRAP><wrap>05:24:09.648893</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>009473d8 00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1818</wrap> </WRAP> |<WRAP><wrap>05:24:09.648894</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>009473d8 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>dyngui.c:1821</wrap> </WRAP> |<WRAP><wrap>05:24:09.648929</wrap> </WRAP> |<WRAP><wrap>00001084</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>009473d8 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>control.c:4642</wrap> </WRAP> |<WRAP><wrap>05:24:11.878330</wrap> </WRAP> |<WRAP><wrap>00000B50</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cpu.c:1586</wrap> </WRAP> |<WRAP><wrap>05:24:11.878333</wrap> </WRAP> |<WRAP><wrap>00000B50</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cpu.c:1586</wrap> </WRAP> |<WRAP><wrap>05:24:11.878334</wrap> </WRAP> |<WRAP><wrap>00000B50</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cpu.c:1744</wrap> </WRAP> |<WRAP><wrap>05:24:11.878336</wrap> </WRAP> |<WRAP><wrap>00000B50</wrap> </WRAP> |<WRAP><wrap>wait before</wrap> </WRAP> |<WRAP><wrap>00233b54 030a6d94</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cpu.c:1744</wrap> </WRAP> |<WRAP><wrap>05:24:11.885597</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>wait after</wrap> </WRAP> |<WRAP><wrap>00233b54 031a6d94</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cpu.c:1759</wrap> </WRAP> |<WRAP><wrap>05:24:11.885599</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>cpu.c:1586</wrap> </WRAP> |<WRAP><wrap>05:24:11.885601</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>cpu.c:1586</wrap> </WRAP> |<WRAP><wrap>05:24:11.885602</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>external.c:54</wrap> </WRAP> |<WRAP><wrap>05:24:11.885607</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>*EXTINT</wrap> </WRAP> |<WRAP><wrap>00001004 00000002</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>external.c:127</wrap> </WRAP> |<WRAP><wrap>05:24:11.885609</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:6474</wrap> </WRAP> |<WRAP><wrap>05:24:11.885622</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>lock before</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>control.c:6474</wrap> </WRAP> |<WRAP><wrap>05:24:11.885623</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>lock after</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>control.c:6497</wrap> </WRAP> |<WRAP><wrap>05:24:11.885627</wrap> </WRAP> |<WRAP><wrap>00000FE8</wrap> </WRAP> |<WRAP><wrap>unlock</wrap> </WRAP> |<WRAP><wrap>00233b54 00000000</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>HHC00101I Thread</wrap> </WRAP> |<WRAP><wrap>id 00001610, prio</wrap> </WRAP> |<WRAP><wrap>0, name</wrap> </WRAP> |<WRAP><wrap>'PTT timeout</wrap> </WRAP> |<WRAP><wrap>timer' ended</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 238: PTT command (start trace and issue automatic display)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 490</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.125 PWD (Print working directory) \\ //8.125.1 Function//</wrap>** <wrap>The PWD command prints the current working directory.</wrap> **//<wrap>8.125.2 Syntax</wrap>//** **__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>PWD</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ PWD</wrap> **//<wrap>8.125.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.125.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Print the current working directory.</wrap> <wrap>HHC00013I Herc command: 'pwd'</wrap> <wrap>HHC02204I working directory set to </wrap>[[file:///d:/hercules|<wrap>d:%%\%%hercules</wrap>]]<wrap></wrap> **<wrap>Figure 239: PWD command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 491</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.126 QCPUID (Display CPU ID) \\ //8.126.1 Function//</wrap>** <wrap>The QCPUID command displays the CPU ID and STSI results presented to the SCP.</wrap> **//<wrap>8.126.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>QCPUID</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>QCPUID</wrap> **//<wrap>8.126.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.126.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the default CPUID.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'qcpuid'</wrap> </WRAP> || | |<WRAP><wrap>HHC17004I</wrap> </WRAP> |<WRAP><wrap>CPUID</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>1900196370600000</wrap> </WRAP> | |<WRAP><wrap>HHC17005I</wrap> </WRAP> |<WRAP><wrap>CPC SI</wrap> </WRAP> |<WRAP><wrap>=</wrap> </WRAP> |<WRAP><wrap>7060.7060-H70.HRC.ZZ.0000000000001963</wrap> </WRAP> | **<wrap>Figure 240: QCPUID command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 492</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.127 QD (Query device information) \\ //8.127.1 Function//</wrap>** <wrap>The QD command queries one or all devices or device classes depending on the given argument. The device number can be either a single device number or a multiple device number specification. The device class is either CHAN, CON, CTCA, DASD, DSP, FCP, LINE, OSA, PCH, PRT, RDR or TAPE. If no argument is given all devices are queried.</wrap> **//<wrap>8.127.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>QD [</wrap>//<wrap>devnum </wrap>//<wrap>| </wrap>//<wrap>devclass</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬QD¬¬¬i¬¬¬¬¬¬¬¬¬</wrap><wrap>¬¬¬</wrap> <wrap>ª¬</wrap><wrap>¬¬¬ </wrap>//<wrap>devnum \\ </wrap>//<wrap>L_</wrap><wrap>¬¬ </wrap>//<wrap>devclass</wrap>// **//<wrap>8.127.3 Parameter</wrap>//** **//<wrap>devnum </wrap>//**<wrap>The device number or multiple device number specification of the device(s) to be queried.</wrap> **//<wrap>Devclass </wrap>//**<wrap>Specifies the device class to be queried. The device class is either CHAN, CON, CTCA, DASD, DSP, FCP, LINE, OSA, PCH, PRT, RDR or TAPE</wrap> **//<wrap>8.127.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Query DASD device with address 0AE0.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command:</wrap> </WRAP> ||<WRAP><wrap>'qd</wrap> </WRAP> |<WRAP><wrap>0148'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>SNSID</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>FF383002</wrap> </WRAP> |<WRAP><wrap>335000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>RDC</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>38300233</wrap> </WRAP> |<WRAP><wrap>50000000</wrap> </WRAP> |<WRAP><wrap>00002000</wrap> </WRAP> |<WRAP><wrap>022B001E</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>10</wrap> </WRAP> |<WRAP><wrap>80004B36</wrap> </WRAP> |<WRAP><wrap>00B90000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>022B0096</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>20</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000002</wrap> </WRAP> |<WRAP><wrap>4B360001</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>30</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00FF0000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>RCD</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>C4010100</wrap> </WRAP> |<WRAP><wrap>4040F3F3</wrap> </WRAP> |<WRAP><wrap>F5F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0C8D9C3</wrap> </WRAP> |<WRAP><wrap>|D... 3350000HRC|</wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>10</wrap> </WRAP> |<WRAP><wrap>E9E9F0F0</wrap> </WRAP> |<WRAP><wrap>F0F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0F10300</wrap> </WRAP> |<WRAP><wrap>|ZZ000000000001..|</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 493</wrap> <wrap>\\ </wrap> |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>20</wrap> </WRAP> |<WRAP><wrap>C4000000</wrap> </WRAP> |<WRAP><wrap>4040F3F3</wrap> </WRAP> |<WRAP><wrap>F5F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0C8D9C3</wrap> </WRAP> |<WRAP><wrap>|D... 3350000HRC|</wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>30</wrap> </WRAP> |<WRAP><wrap>E9E9F0F0</wrap> </WRAP> |<WRAP><wrap>F0F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0F10300</wrap> </WRAP> |<WRAP><wrap>|ZZ000000000001. |</wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>40</wrap> </WRAP> |<WRAP><wrap>D4020000</wrap> </WRAP> |<WRAP><wrap>4040F3F8</wrap> </WRAP> |<WRAP><wrap>F3F0F0F0</wrap> </WRAP> |<WRAP><wrap>F2C8D9C3</wrap> </WRAP> |<WRAP><wrap>|M... 3830002HRC|</wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>50</wrap> </WRAP> |<WRAP><wrap>E9E9F0F0</wrap> </WRAP> |<WRAP><wrap>F0F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0F10300</wrap> </WRAP> |<WRAP><wrap>|ZZ000000000001. |</wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>60</wrap> </WRAP> |<WRAP><wrap>F0000001</wrap> </WRAP> |<WRAP><wrap>4040F3F8</wrap> </WRAP> |<WRAP><wrap>F3F04040</wrap> </WRAP> |<WRAP><wrap>40C8D9C3</wrap> </WRAP> |<WRAP><wrap>|0... 3830 HRC|</wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>70</wrap> </WRAP> |<WRAP><wrap>E9E9F0F0</wrap> </WRAP> |<WRAP><wrap>F0F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0F0F0F0</wrap> </WRAP> |<WRAP><wrap>F0F10300</wrap> </WRAP> |<WRAP><wrap>|ZZ000000000001. |</wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>80</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>| ............. |</wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>90</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>A0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>B0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>C0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>D0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>E0</wrap> </WRAP> |<WRAP><wrap>80000002</wrap> </WRAP> |<WRAP><wrap>00001E00</wrap> </WRAP> |<WRAP><wrap>01408048</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>48480200 ...... </wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>F0</wrap> </WRAP> |<WRAP><wrap>00808048</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>00000000 ...... </wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>SNSS</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00481F00</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>10</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02280I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>20</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000140</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 241: QD command</wrap>** **//<wrap>8.127.5 Explanations for device class DASD</wrap>//** <wrap>The Sense ID (SNSID) is describing the type and the model number of the subsystem and logical volume of the channel and has the following format:</wrap> |<WRAP>**<wrap>Bytes</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>---</wrap><wrap></wrap> </WRAP> | |<WRAP><wrap>1-2</wrap> </WRAP> |<WRAP><wrap>Subsystem Type</wrap> </WRAP> | |<WRAP><wrap>3</wrap> </WRAP> |<WRAP><wrap>Subsystem Model and Architecture</wrap> </WRAP> | |<WRAP><wrap>4-5</wrap> </WRAP> |<WRAP><wrap>Device Type</wrap> </WRAP> | |<WRAP><wrap>6</wrap> </WRAP> |<WRAP><wrap>Device Model</wrap> </WRAP> | |<WRAP><wrap>7</wrap> </WRAP> |<WRAP><wrap>Reserved</wrap> </WRAP> | |<WRAP><wrap>8-11</wrap> </WRAP> |<WRAP><wrap>Command Interface Word (CIW) for Read Configuration Data</wrap> </WRAP> | |<WRAP><wrap>12-15</wrap> </WRAP> |<WRAP><wrap>Command Interface Word (CIW) for Set-Interface-Identifier</wrap> </WRAP> | |<WRAP><wrap>16-19</wrap> </WRAP> |<WRAP><wrap>Command Interface Word (CIW) for Read-Node-Identifier</wrap> </WRAP> | **<wrap>Table 21: Sense ID</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 494</wrap> <wrap>\\ </wrap><wrap>The Read Device Characteristics (RDC) defines the characteristics of the logical volume. The format is the following:</wrap> |<WRAP>**<wrap>Bytes</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>0-1</wrap> </WRAP> |<WRAP><wrap>Subsystem type</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>Subsystem model number and architecture</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>3-4</wrap> </WRAP> |<WRAP><wrap>Device type</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>5</wrap> </WRAP> |<WRAP><wrap>Device model</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>6-9</wrap> </WRAP> |<WRAP><wrap>Subsystem and device facilities</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>10</wrap> </WRAP> |<WRAP><wrap>Device class code</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>11</wrap> </WRAP> |<WRAP><wrap>Device type code</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>12-13</wrap> </WRAP> |<WRAP><wrap>Number of primary cylinders</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>14-15</wrap> </WRAP> |<WRAP><wrap>Tracks per cylinder</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>16</wrap> </WRAP> |<WRAP><wrap>Number of sectors</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>17-19</wrap> </WRAP> |<WRAP><wrap>Track length</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>20-21</wrap> </WRAP> |<WRAP><wrap>Length of HA and R0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>22</wrap> </WRAP> |<WRAP><wrap>Track capacity calculation formula</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>23-27</wrap> </WRAP> |<WRAP><wrap>Track capacity calculation factors F1 through</wrap> </WRAP> |<WRAP><wrap>F5</wrap> </WRAP> | |<WRAP><wrap>28-29</wrap> </WRAP> |<WRAP><wrap>First alternate cylinder address</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>30-31</wrap> </WRAP> |<WRAP><wrap>Number of alternate tracks</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>32-33</wrap> </WRAP> |<WRAP><wrap>First diagnostic cylinder address</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>34-35</wrap> </WRAP> |<WRAP><wrap>Number of diagnostic tracks</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>36-37</wrap> </WRAP> |<WRAP><wrap>First device support cylinder address</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>38-39</wrap> </WRAP> |<WRAP><wrap>number of device support tracks</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>40</wrap> </WRAP> |<WRAP><wrap>MDR record ID</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>41</wrap> </WRAP> |<WRAP><wrap>OBR record ID</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>42</wrap> </WRAP> |<WRAP><wrap>Control unit type code</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>43</wrap> </WRAP> |<WRAP><wrap>Read trackset parameter length</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>44-45</wrap> </WRAP> |<WRAP><wrap>Maximum record zero length</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>46</wrap> </WRAP> |<WRAP><wrap>Reserved</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>47</wrap> </WRAP> |<WRAP><wrap>Track set size</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>48</wrap> </WRAP> |<WRAP><wrap>Track capacity calculation factor F6</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>49-50</wrap> </WRAP> |<WRAP><wrap>RPS sector calculation factors</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>51-53</wrap> </WRAP> |<WRAP><wrap>Reserved</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>54</wrap> </WRAP> |<WRAP><wrap>Device and control unit features</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>55</wrap> </WRAP> |<WRAP><wrap>Reserved</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>56</wrap> </WRAP> |<WRAP><wrap>Real control unit type code</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>57</wrap> </WRAP> |<WRAP><wrap>Real device type code</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>58-63</wrap> </WRAP> |<WRAP><wrap>Reserved</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Table 22: Read Device Characteristics</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 495</wrap> <wrap>\\ </wrap><wrap>The Read Configuration Data (RCD) contains configuration data. It shows how the internal disk subsystem is configured. The RCD has the following format:</wrap> |<WRAP>**<wrap>Bytes</wrap>** </WRAP> |<WRAP>**<wrap>Name</wrap>** </WRAP> |<WRAP>**<wrap>Description</wrap>** </WRAP> | |<WRAP><wrap>000-031</wrap> </WRAP> |<WRAP><wrap>NED1</wrap> </WRAP> |<WRAP><wrap>Volume NED (logical volume within the subsystem)</wrap> </WRAP> | |<WRAP><wrap>032-063</wrap> </WRAP> |<WRAP><wrap>NED2</wrap> </WRAP> |<WRAP><wrap>NED for the RAID array</wrap> </WRAP> | |<WRAP><wrap>064-095</wrap> </WRAP> |<WRAP><wrap>NED3</wrap> </WRAP> |<WRAP><wrap>NED for the logical subsystem</wrap> </WRAP> | |<WRAP><wrap>096-127</wrap> </WRAP> |<WRAP><wrap>NED4</wrap> </WRAP> |<WRAP><wrap>Token NED (establishes a relationship among all configuration data records in a control unit in the subsystem)</wrap> </WRAP> | |<WRAP><wrap>128-223</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>Reserved</wrap> </WRAP> | |<WRAP><wrap>224-255</wrap> </WRAP> |<WRAP><wrap>QNEQ</wrap> </WRAP> |<WRAP><wrap>General NEQ (describes paths and addresses)</wrap> </WRAP> | **<wrap>Table 23: Read Configuration Data</wrap>** __<wrap>Legend: </wrap>__<wrap></wrap> <wrap>NED Node Element Descriptor</wrap> <wrap>NEQ Node Element Qualifier</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 496</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.128 QPFKEYS (Display the current PF key settings) \\ //8.128.1 Function//</wrap>** <wrap>The QPFKEYS command displays the current PF key settings.</wrap> **//<wrap>8.128.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>QPFKEYS</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>QPFKEYS</wrap> **//<wrap>8.128.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.128.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current PF key settings.</wrap> <wrap>HHC00013I Herc command: 'qpfkeys'</wrap> <wrap>HHC17199I PF01 'SUBST IMMED herc help &0' \\ HHC17199I PF02 'SUBST IMMED herc hst &0' \\ HHC17199I PF03 'UNDEFINED'</wrap> <wrap>HHC17199I PF04 'UNDEFINED'</wrap> <wrap>HHC17199I PF05 'IMMED herc maxrates' \\ HHC17199I PF06 'IMMED herc uptime' \\ HHC17199I PF07 'IMMED herc qproc'</wrap> <wrap>HHC17199I PF08 'SUBST IMMED herc qd &0' \\ HHC17199I PF09 'UNDEFINED'</wrap> <wrap>HHC17199I PF10 'UNDEFINED'</wrap> <wrap>HHC17199I PF11 'SUBST DELAY herc &*' \\ HHC17199I PF12 'IMMED herc cmdtgt herc' \\ HHC17199I PF13 'UNDEFINED'</wrap> <wrap>HHC17199I PF14 'UNDEFINED'</wrap> <wrap>HHC17199I PF15 'SUBST IMMED herc sfd &0' \\ HHC17199I PF16 'SUBST IMMED herc sfc &0' \\ HHC17199I PF17 'SUBST IMMED herc sfk &0 &1'</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 497</wrap> <wrap>\\ </wrap><wrap>HHC17199I PF18 'SUBST IMMED herc sf+ &0' \\ HHC17199I PF19 'SUBST IMMED herc sf- &0 &1' \\ HHC17199I PF20 'SUBST IMMED herc sf= &0 &1' \\ HHC17199I PF21 'UNDEFINED' \\ HHC17199I PF22 'UNDEFINED' \\ HHC17199I PF23 'SUBST DELAY scp &*' \\ HHC17199I PF24 'IMMED herc cmdtgt scp' \\ HHC17199I PF25 'UNDEFINED' \\ HHC17199I PF26 'UNDEFINED' \\ HHC17199I PF27 'UNDEFINED' \\ HHC17199I PF28 'UNDEFINED' \\ HHC17199I PF29 'UNDEFINED' \\ HHC17199I PF30 'UNDEFINED' \\ HHC17199I PF31 'UNDEFINED' \\ HHC17199I PF32 'UNDEFINED' \\ HHC17199I PF33 'UNDEFINED' \\ HHC17199I PF34 'UNDEFINED' \\ HHC17199I PF35 'SUBST DELAY pscp &*' \\ HHC17199I PF36 'IMMED herc cmdtgt pscp' \\ HHC17199I PF37 'UNDEFINED' \\ HHC17199I PF38 'UNDEFINED' \\ HHC17199I PF39 'UNDEFINED' \\ HHC17199I PF40 'UNDEFINED' \\ HHC17199I PF41 'UNDEFINED' \\ HHC17199I PF42 'UNDEFINED' \\ HHC17199I PF43 'UNDEFINED' \\ HHC17199I PF44 'UNDEFINED' \\ HHC17199I PF45 'UNDEFINED' \\ HHC17199I PF46 'UNDEFINED' \\ HHC17199I PF47 'UNDEFINED' \\ HHC17199I PF48 'UNDEFINED'</wrap> **<wrap>Figure 242: QPFKEYS command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 498</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.129 QPID (Display process ID of Hercules) \\ //8.129.1 Function//</wrap>** <wrap>The QPID command displays the process ID of Hercules.</wrap> **//<wrap>8.129.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>QPID</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>QPID</wrap> **//<wrap>8.129.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.129.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the process ID of Hercules.</wrap> <wrap>HHC00013I Herc command: 'qpid' \\ HHC17013I Process ID = 3544</wrap> **<wrap>Figure 243: QPID command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 499</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.130 QPORTS (Display TCP/IP ports in use) \\ //8.130.1 Function//</wrap>** <wrap>The QPORTS command displays the TCP/IP ports in use.</wrap> **//<wrap>8.130.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>QP0RTS</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>QP0RTS</wrap> **//<wrap>8.130.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.130.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the TCP/IP ports in use.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'qports'</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC17001I</wrap> </WRAP> |<WRAP><wrap>Server '</wrap> </WRAP> |<WRAP><wrap>http'</wrap> </WRAP> |<WRAP><wrap>is</wrap> </WRAP> |<WRAP><wrap>listening</wrap> </WRAP> |<WRAP><wrap>on port</wrap> </WRAP> |<WRAP><wrap>8089</wrap> </WRAP> | |<WRAP><wrap>HHC17001I</wrap> </WRAP> |<WRAP><wrap>Server '</wrap> </WRAP> |<WRAP><wrap>shared_dasd'</wrap> </WRAP> |<WRAP><wrap>is</wrap> </WRAP> |<WRAP><wrap>listening</wrap> </WRAP> |<WRAP><wrap>on port</wrap> </WRAP> |<WRAP><wrap>3999</wrap> </WRAP> | |<WRAP><wrap>HHC17001I</wrap> </WRAP> |<WRAP><wrap>Server '</wrap> </WRAP> |<WRAP><wrap>console'</wrap> </WRAP> |<WRAP><wrap>is</wrap> </WRAP> |<WRAP><wrap>listening</wrap> </WRAP> |<WRAP><wrap>on port</wrap> </WRAP> |<WRAP><wrap>3278</wrap> </WRAP> | **<wrap>Figure 244: QPORTS command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 500</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.131 QPROC (Display processors type and utilization) //8.131.1 Function//</wrap>** <wrap>The QPROC command displays the processors type and their utilization.</wrap> **//<wrap>8.131.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>QPROC</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ QPROC</wrap> **//<wrap>8.131.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.131.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the processors type and utilitzation.</wrap> |<WRAP><wrap>HHC00013I HHC17007I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'qproc'</wrap> <wrap>NumCPU = 08, NumVEC = 00, ReservedCPU =</wrap> </WRAP> ||||<WRAP><wrap>00, MaxCPU = 08</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC17008I</wrap> </WRAP> |<WRAP><wrap>Avgproc 028% 08;</wrap> </WRAP> ||<WRAP><wrap>MIPS[39.71];</wrap> </WRAP> |<WRAP><wrap>SIOS[998]</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC17009I</wrap> </WRAP> |<WRAP><wrap>PROC</wrap> </WRAP> |<WRAP><wrap>CP00 - 067%;</wrap> </WRAP> |<WRAP><wrap>MIPS[10.11];</wrap> </WRAP> |<WRAP><wrap>SIOS[358]</wrap> </WRAP> |<WRAP><wrap>- Host</wrap> </WRAP> |<WRAP><wrap>Kernel(00:00:00.202)</wrap> </WRAP> |<WRAP><wrap>User(00:00:39.203)</wrap> </WRAP> | |<WRAP><wrap>HHC17009I</wrap> </WRAP> |<WRAP><wrap>PROC</wrap> </WRAP> |<WRAP><wrap>CP01 - 060%;</wrap> </WRAP> |<WRAP><wrap>MIPS[ 8.84];</wrap> </WRAP> |<WRAP><wrap>SIOS[329]</wrap> </WRAP> |<WRAP><wrap>- Host</wrap> </WRAP> |<WRAP><wrap>Kernel(00:00:00.202)</wrap> </WRAP> |<WRAP><wrap>User(00:00:19.640)</wrap> </WRAP> | |<WRAP><wrap>HHC17009I</wrap> </WRAP> |<WRAP><wrap>PROC</wrap> </WRAP> |<WRAP><wrap>CP02 - 046%;</wrap> </WRAP> |<WRAP><wrap>MIPS[12.77];</wrap> </WRAP> |<WRAP><wrap>SIOS[255]</wrap> </WRAP> |<WRAP><wrap>- Host</wrap> </WRAP> |<WRAP><wrap>Kernel(00:00:00.124)</wrap> </WRAP> |<WRAP><wrap>User(00:00:15.974)</wrap> </WRAP> | |<WRAP><wrap>HHC17009I</wrap> </WRAP> |<WRAP><wrap>PROC</wrap> </WRAP> |<WRAP><wrap>CP03 - 032%;</wrap> </WRAP> |<WRAP><wrap>MIPS[ 4.63];</wrap> </WRAP> |<WRAP><wrap>SIOS[151]</wrap> </WRAP> |<WRAP><wrap>- Host</wrap> </WRAP> |<WRAP><wrap>Kernel(00:00:00.156)</wrap> </WRAP> |<WRAP><wrap>User(00:00:12.792)</wrap> </WRAP> | |<WRAP><wrap>HHC17009I</wrap> </WRAP> |<WRAP><wrap>PROC</wrap> </WRAP> |<WRAP><wrap>CP04 - 009%;</wrap> </WRAP> |<WRAP><wrap>MIPS[ 1.09];</wrap> </WRAP> |<WRAP><wrap>SIOS[ 51]</wrap> </WRAP> |<WRAP><wrap>- Host</wrap> </WRAP> |<WRAP><wrap>Kernel(00:00:00.078)</wrap> </WRAP> |<WRAP><wrap>User(00:00:10.670)</wrap> </WRAP> | |<WRAP><wrap>HHC17009I</wrap> </WRAP> |<WRAP><wrap>PROC</wrap> </WRAP> |<WRAP><wrap>CP05 - 005%;</wrap> </WRAP> |<WRAP><wrap>MIPS[ 0.65];</wrap> </WRAP> |<WRAP><wrap>SIOS[ 13]</wrap> </WRAP> |<WRAP><wrap>- Host</wrap> </WRAP> |<WRAP><wrap>Kernel(00:00:00.000)</wrap> </WRAP> |<WRAP><wrap>User(00:00:08.470)</wrap> </WRAP> | |<WRAP><wrap>HHC17009I</wrap> </WRAP> |<WRAP><wrap>PROC</wrap> </WRAP> |<WRAP><wrap>CP06 - 008%;</wrap> </WRAP> |<WRAP><wrap>MIPS[ 1.22];</wrap> </WRAP> |<WRAP><wrap>SIOS[ 41]</wrap> </WRAP> |<WRAP><wrap>- Host</wrap> </WRAP> |<WRAP><wrap>Kernel(00:00:00.078)</wrap> </WRAP> |<WRAP><wrap>User(00:00:06.754)</wrap> </WRAP> | |<WRAP><wrap>HHC17009I</wrap> </WRAP> |<WRAP><wrap>PROC</wrap> </WRAP> |<WRAP><wrap>CP07 - 002%;</wrap> </WRAP> |<WRAP><wrap>MIPS[ 0.36];</wrap> </WRAP> |<WRAP><wrap>SIOS[ 8]</wrap> </WRAP> |<WRAP><wrap>- Host</wrap> </WRAP> |<WRAP><wrap>Kernel(00:00:00.031)</wrap> </WRAP> |<WRAP><wrap>User(00:00:06.598)</wrap> </WRAP> | |<WRAP><wrap>HHC17010I</wrap> </WRAP> |<WRAP><wrap>- Started</wrap> </WRAP> ||<WRAP><wrap>: Stopping</wrap> </WRAP> |<WRAP><wrap>* Stopped</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 245: QPROC command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 501</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.132 QSTOR (Display main and expanded storage values) //8.132.1 Function//</wrap>** <wrap>The QSTOR command displays the current main and expanded storage values.</wrap> **//<wrap>8.132.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>QST0R</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>QST0R</wrap> **//<wrap>8.132.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.132.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current main and expanded storage values.</wrap> |<WRAP><wrap>HHC00013I Herc command: 'qstor'</wrap> <wrap>HHC17003I MAIN storage is 006 GBytes 'mainsize' HHC17003I EXPANDED storage is 000 MBytes 'xpndsize'</wrap> </WRAP> | **<wrap>Figure 246: QSTOR command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 502</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.133 QUIET (Toggle automatic refresh of console display data) //8.133.1 Function//</wrap>** <wrap>The QUIET command either disables automatic screen refreshing if it is currently enabled or enables it if it is currently disabled. When disabled you will not be able to see the response of any entered command nor any messages issued by the system nor be able to scroll the display, etc. Basically all screen updating is disabled. Entering 'quiet' again re-enables screen updating.</wrap> <wrap>Please note that the QUIET command is disabled in the dyngui and therefore is not available when using the Hercules WinGUI.</wrap> **//<wrap>8.133.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>QUIET</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ QUIET</wrap>** **//<wrap>8.133.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.133.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Change between automatic refresh of console display data.</wrap> <wrap>HHC00013I Herc command: 'quiet' \\ HHC02203I automatic refresh: disabled \\ HHC00013I Herc command: 'quiet' \\ HHC02203I automatic refresh: enabled</wrap> **<wrap>Figure 247: QUIET command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 503</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.134 QUIT (Terminate the emulator) \\ //8.134.1 Function//</wrap>** <wrap>The QUIT command (see also the EXIT command) initiates the Hercules shutdown. It terminates all threads, detaches all channels and devices and releases the configuration. Finally it terminates the emulator. If the guest OS has enabled “Signal Shutdown” then a signal shutdown request is sent to the guest OS and termination will begin after the guest OS has shutdown.</wrap> <wrap>The QUIT command acts different depending on how Hercules was built. If Hercules was not compiled with the option 'OPTION_SHUTDOWN_CONFIRMATION' then the command acts as described above.</wrap> <wrap>If Hercules however was built with option 'OPTION_SHUTDOWN_CONFIRMATION' then the following special processing for terminating the emulator takes place.</wrap> <wrap>If QUIT is entered and the command level is not set to 'developer', 'debug' or 'all' then QUIT will first check that all online CPUs are stopped. If any CPU is not in the stopped state message HHC00069I is displayed indicating the number of CPUs still running.</wrap> <wrap>Message HHC02266A follows that prompts for confirmation by entering a second QUIT command within a certain time period (default 10 seconds) to start termination of the emulator. If the time period has expired then the process starts over. This is to prevent an inadvertent shutdown of Hercules while still a guest OS is running.</wrap> <wrap>The time period for the second QUIT command can be set to another value by using the 'QUITMOUT' console command or system parameter.</wrap> <wrap>If all processors are stopped or the command level is set to 'developer', 'debug' or 'all' then quit stops Hercules immediately. 'QUIT FORCE' will also terminate the emulator immediately without any further checks.</wrap> **//<wrap>8.134.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>QUIT </wrap><wrap>[</wrap><wrap>FORCE</wrap><wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>QUIT </wrap>__<wrap>¬</wrap>__<wrap></wrap> <wrap>FORCE</wrap> **//<wrap>8.134.3 Parameter</wrap>//** **<wrap>FORCE </wrap>**<wrap>Terminate the emulator immediately.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 504</wrap> <wrap>\\ </wrap>**//<wrap>8.134.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Initiate the Hercules shutdown.</wrap> <wrap>HHC00013I Herc command: 'quit'</wrap> <wrap>HHC00069I Guest is not quiesced; there are 8 CPUs active</wrap> <wrap>HHC02266A Reenter command 'exit' again within 10 seconds to execute</wrap> <wrap>HHC00013I Herc command: 'exit'</wrap> <wrap>HHC01420I Begin Hercules shutdown</wrap> <wrap>HHC01421I Releasing configuration</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC01422I Configuration release complete</wrap> <wrap>HHC01423I Calling termination routines</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC02103I Logger: logger thread terminating</wrap> <wrap>HHC01412I Hercules terminated</wrap> **<wrap>Figure 248: QUIT command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Initiate an immediate Hercules shutdown.</wrap> <wrap>HHC00013I Herc command: 'quit force'</wrap> <wrap>HHC01420I Begin Hercules shutdown</wrap> <wrap>HHC01421I Releasing configuration</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC01422I Configuration release complete</wrap> <wrap>HHC01423I Calling termination routines</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC02103I Logger: logger thread terminating</wrap> <wrap>HHC01412I Hercules terminated</wrap> **<wrap>Figure 249: QUIT FORCE command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 505</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.135 QUITMOUT (Display or set quit timeout value) \\ //8.135.1 Function//</wrap>** <wrap>The QUITMOUT console command is used to display or set the timeout value for a second QUIT, EXIT or SSD command if Hercules is built with the option “OPTION_SHUTDOWN_CONFIRMATION”. If Hercules is built without this option, then the QUITMOUT console command is not available. If QUITMOUT is given without argument it displays the current setting.</wrap> **//<wrap>8.135.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>QUITM0UT </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>QUITM0UT</wrap> //<wrap>nn</wrap>// **//<wrap>8.135.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This specifies the timeout value where //nn //must be in the range of 2 to 60 seconds. If the timeout value is 0 then no second QUIT, EXIT or SSD is necessary.</wrap> **//<wrap>8.135.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current QUITMOUT value.</wrap> <wrap>HHC01603I quitmout</wrap> <wrap>HHC17100I Timeout value for 'quit' and 'ssd' is '10' seconds</wrap> **<wrap>Figure 250: QUITMOUT command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 506</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.136 R (Display or alter real storage) \\ //8.136.1 Function//</wrap>** <wrap>The R command allows you to display or alter real storage. Up to 64K of real storage can be displayed, up to 32 bytes of real storage can be altered.</wrap> **//<wrap>8.136.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>R {</wrap>//<wrap>addr </wrap>//<wrap>| </wrap>//<wrap>addr.length </wrap>//<wrap>| </wrap>//<wrap>addr-addr </wrap>//<wrap>| </wrap>//<wrap>addr=value</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ R ¬¬¬§¬¬¬¬¬¬¬ </wrap>//<wrap>addr </wrap>//<wrap>¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ </wrap>//<wrap>addr.length </wrap>//<wrap>¬¬¬«</wrap> <wrap>ª¬¬¬¬ </wrap>//<wrap>addr-addr </wrap>//<wrap>¬¬¬¬«</wrap> <wrap>⡿¬¬¬</wrap>//<wrap>addr=value </wrap>//<wrap>¬¬¬¬¯</wrap> **//<wrap>8.136.3 Parameter</wrap>//** **//<wrap>addr </wrap>//**<wrap>Specifies the address of the real storage that is to be displayed. If //addr //is given without a length or without a second address for the end of the storage area then 64 bytes of real storage are displayed.</wrap> **//<wrap>addr.length </wrap>//**<wrap>Specifies the address of the real storage area that is to be displayed with starting address and length (from address //addr //with the length of //length//). The //length //value must be given in hexadecimal. The maximum length that can be specified is 64K.</wrap> **//<wrap>addr-addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address) of the real storage area that is to be displayed.</wrap> **//<wrap>addr=value </wrap>//**<wrap>Specifies the address of the real storage area that is to be altered. //value //is a hex-string of up to 32 pairs of hex digits (32 bytes) which will be written to the real storage address given by the //addr //parameter. After altering the storage, 16 bytes of real storage starting at //addr //are displayed.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 507</wrap> <wrap>\\ </wrap>**//<wrap>8.136.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display 256 bytes of real storage starting from location x’00000000’.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'r 00000000.ff'</wrap> |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000000:K:06=040C0000</wrap> </WRAP> |<WRAP><wrap>0001CEFA 00000000</wrap> </WRAP> ||<WRAP><wrap>00000000 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000010:K:06=00009720</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>070E0000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>..p</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000020:K:06=070C0000</wrap> </WRAP> |<WRAP><wrap>0003C160</wrap> </WRAP> |<WRAP><wrap>070C1000</wrap> </WRAP> |<WRAP><wrap>00077352 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>A-</wrap><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000030:K:06=00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>070E0000</wrap> </WRAP> |<WRAP><wrap>00000000 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000040:K:06=00088618</wrap> </WRAP> |<WRAP><wrap>0C000000</wrap> </WRAP> |<WRAP><wrap>00006318</wrap> </WRAP> |<WRAP><wrap>00009720</wrap> </WRAP> |<WRAP><wrap>f. </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>p.</wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000050:K:06=FFCA28D9</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>040C0000</wrap> </WRAP> |<WRAP><wrap>0001D09A</wrap> </WRAP> |<WRAP><wrap>R. </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>}.</wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000060:K:06=040C0000</wrap> </WRAP> |<WRAP><wrap>0001D37A</wrap> </WRAP> |<WRAP><wrap>000C0000</wrap> </WRAP> |<WRAP><wrap>0001D9B4 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>L:</wrap> </WRAP> |<WRAP><wrap>R.</wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000070:K:06=00080000</wrap> </WRAP> |<WRAP><wrap>0001E500</wrap> </WRAP> |<WRAP><wrap>040C0000</wrap> </WRAP> |<WRAP><wrap>0001E972 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>V</wrap> </WRAP> |<WRAP><wrap>Z.</wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000080:K:06=00000000</wrap> </WRAP> |<WRAP><wrap>00001004</wrap> </WRAP> |<WRAP><wrap>00020074</wrap> </WRAP> |<WRAP><wrap>00040011 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:00000090:K:06=00091800</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:000000A0:K:06=00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>10000000</wrap> </WRAP> |<WRAP><wrap>00FD41C8 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>H</wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:000000B0:K:06=FFFFFFFF</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000149</wrap> </WRAP> |<WRAP><wrap>00000000 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:000000C0:K:06=00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:000000D0:K:06=00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:000000E0:K:06=00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02290I</wrap> </WRAP> |<WRAP><wrap>R:000000F0:K:06=00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000 </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 251: R command (display real storage)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Alter 4 bytes of real storage at location x’00000000’ to x’FFFFFFFF’.</wrap> <wrap>HHC00013I Herc command: 'r 00000000=FFFFFFFF'</wrap> <wrap><wrap>{{hercules:userref:bf:image095.gif|}}</wrap></wrap><wrap>HHC02290I R:00000000:K:06=FFFFFFFF 0001CEFA 00000000 00000000</wrap> **<wrap>Figure 252: R command (alter real storage)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 508</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.137 RESTART (Generate restart interrupt) \\ //8.137.1 Function//</wrap>** <wrap>The RESTART command generates a restart interrupt (the virtual RESTART key is pressed).</wrap> **//<wrap>8.137.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>RESTART</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ RESTART</wrap>** **//<wrap>8.137.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.137.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Generate restart interrupt.</wrap> <wrap>HHC00013I Herc command: 'restart' \\ HHC02228I Key 'restart' pressed</wrap> **<wrap>Figure 253: RESTART command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 509</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.138 RESUME (Resume Hercules) \\ //8.138.1 Function//</wrap>** <wrap>This command resumes a Hercules session that had been previously suspended with the SUSPEND command (see section 8.171 for details). The data necessary to resume the session is read from a packed (zipped) file called “hercules.srf.gz” located in the current configuration directory.</wrap> <wrap>In order for an instance to be resumed HERCULES must be started with a configuration file describing the configuration at suspend time. For example, MAINSIZE and XPNDSIZE must match and all devices present at suspend time must be present at resume time.</wrap> <wrap>Disk devices must be at the same state as they were at suspend time. They can however be a different file type. For example a disk could be a CCKD disk at suspend time then a CKD disk could be created using DASDCOPY and HERCULES resumed using the CKD disk instead.</wrap> <wrap>HERCULES must also be configured similarly as at suspend time. For example if 4 emulated CPUs were active at suspend time then the session cannot be resumed on a HERCULES with a maximum of two CPUs. Similarly you will not be able to resume a session in z/Architecture mode for a HERCULES that was built without z/Architecture.</wrap> <wrap>After entering the RESUME command on the Hercules console the suspend file is re-imported and the CPUs are put in the STARTED state again resuming guest program operations at the same point and in the same state as the suspend file was created.</wrap> <wrap>There are some caveats when resuming guest operating system processing:</wrap> <wrap>·<wrap></wrap></wrap><wrap>As seen by the guest operating system, the TOD clock will appear to jump a large value. Some guests may not cope very well with this. For example some guests may be dismayed because certain interrupts will occur way past its due time. Also for S/370 an interval timer interrupt may be lost if the guest is interrupted for more than half the Interval Timer wrap time (around 8 hours).</wrap> <wrap>·<wrap></wrap></wrap><wrap>Although some effort has been put in order to make this as transparent as possible (that is, it should appear to the guest operating system that the STOP key was pressed for a large amount of time), some state information may be missed.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Some guest operating systems will fare better if the suspend state is prepared first. For MVS, as an example, it seems to help when a QUIESCE command and a SYSTEM RESTART manual operation are issued prior to suspend the system.</wrap> **//<wrap>8.138.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>RESUME</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ RESUME</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 510</wrap> <wrap>\\ </wrap>**//<wrap>8.138.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.138.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Resume a Hercules session.</wrap> {{hercules:userref:bf:image063.gif|}}{{hercules:userref:bf:image096.gif|}}{{hercules:userref:bf:image071.gif|}}{{hercules:userref:bf:image097.gif|}}{{hercules:userref:bf:image098.gif|}}**<wrap>Figure 254: RESUME command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 511</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.139 REXX (Display or set REXX interpreter settings) //8.139.1 Function//</wrap>** <wrap>The REXX console command is used to manage the Rexx interpreter settings. It allows to specify the paths where the Rexx executables can be found and what extensions for the executables are to be used. If Hercules is built with support for both Rexx environments (Regina Rexx and Open Object Rexx) then the environments can be dynamically enabled or disabled. The message prefixes to be used for Rexx messages (issued through the “say” command) and error messages (issued through the Rexx interpreter) can be set separately.</wrap> <wrap>If the command is given without any arguments it displays the current Rexx interpreter settings.</wrap> **//<wrap>8.139.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>REXX [</wrap>//<wrap>option</wrap>//<wrap>]</wrap> <wrap>where </wrap>//<wrap>option </wrap>//<wrap>can be:</wrap> <wrap>ENABLE | START [REGINA | OOREXX]</wrap> <wrap>DISABLE | STOP</wrap> <wrap>PATHS | REXXPATHS (</wrap>//<wrap>path </wrap>//<wrap>[</wrap>//<wrap>delimiter path ...</wrap>//<wrap>] | RESET}</wrap> <wrap>SYSPATH (ON | OFF | RESET}</wrap> <wrap>EXTENSIONS | SUFFIXES (</wrap>//<wrap>suffix </wrap>//<wrap>[</wrap>//<wrap>delimiter suffix ...</wrap>//<wrap>] | RESET}</wrap> <wrap>RESOLVER (ON | OFF | RESET}</wrap> <wrap>MSGLEVEL (0 | 1 | RESET}</wrap> <wrap>MSGPREFIX (</wrap>//<wrap>messageprefix </wrap>//<wrap>| OFF | RESET}</wrap> <wrap>ERRPREFIX (</wrap>//<wrap>errorprefix </wrap>//<wrap>| OFF | RESET}</wrap> <wrap>MODE (COMMAND | SUBROUTINE}</wrap> |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ REXX</wrap> </WRAP> |<WRAP><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿¬¬¬« </wrap>//<wrap>option </wrap>//<wrap>ª¬¬¬¯</wrap> </WRAP> | <wrap>where </wrap>//<wrap>option </wrap>//<wrap>can be:</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 512</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>ª%%__%%_§%%__%%_ ENABLE </wrap><wrap>¬¬¬1¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬1</wrap> <wrap>%%__%%_ START %%__%%%%__%%¯ ª%%__%%_ REGINA </wrap><wrap>¬¬¬«</wrap> <wrap>%%__%%_ OOREXX %%__%%_</wrap> <wrap>ª</wrap><wrap>%%__%%_</wrap><wrap>1</wrap><wrap>¬¬¬ </wrap><wrap>DISABLE </wrap><wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« </wrap><wrap>⡿%%__%%</wrap><wrap>¬¬ </wrap><wrap>STOP </wrap><wrap>¬¬¬</wrap><wrap>%%__%%</wrap> <wrap>~¬¬¬ </wrap>//<wrap>delimiter </wrap>//<wrap>¬¬¬®</wrap> <wrap>ª</wrap><wrap>%%__%%_</wrap><wrap>1</wrap><wrap>¬¬¬¬¬ </wrap><wrap>PATHS </wrap><wrap>¬¬¬¬¬1¬¬¬1¬¬¬</wrap><wrap>°%%__%%%%__%% </wrap>//<wrap>path </wrap>//<wrap>¬¬¬¬¬¬¬</wrap><wrap>¨</wrap><wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%_ REXXPATHS %%__%%_¯ _</wrap><wrap>¬¬¬¬¬¬¬ </wrap><wrap>RESET </wrap><wrap>¬¬¬¬¬¬¬¬</wrap><wrap>%%__%%¯</wrap> <wrap>I</wrap><wrap>%%__%%_ SYSPATH </wrap><wrap>¬¬¬1¬¬¬¬ </wrap><wrap>ON </wrap><wrap>¬¬¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%% </wrap><wrap>OFF ¬¬¬¬«</wrap> <wrap>%%__%%_ RESET %%__%%_</wrap> <wrap>~¬¬¬ </wrap>//<wrap>delimiter </wrap>//<wrap>¬¬¬®</wrap> <wrap>ª%%__%%_</wrap><wrap>1</wrap><wrap>¬¬¬ </wrap><wrap>EXTENSIONS </wrap><wrap>¬¬¬1¬¬¬1¬¬¬</wrap><wrap>°</wrap><wrap>¬¬¬¬ </wrap>//<wrap>suffix </wrap>//<wrap>¬¬¬¬¬</wrap><wrap>¨</wrap><wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>I %%__%%%%__%%SUFFIXES %%__%%%%__%%¯ %%__%%%%__%%</wrap><wrap>¬¬¬¬¬ </wrap><wrap>RESET </wrap><wrap>¬¬¬¬</wrap><wrap>%%__%%%%__%%_¯</wrap> <wrap>I%%__%%_ RESOLVER </wrap><wrap>¬¬¬1¬¬¬¬ </wrap><wrap>ON </wrap><wrap>¬¬¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%% </wrap><wrap>OFF ¬¬¬¬«</wrap> <wrap>%%__%%_ RESET %%__%%_¯</wrap> <wrap>I</wrap><wrap>%%__%%_ MSGLEVEL </wrap><wrap>¬¬¬1¬¬¬¬¬ </wrap><wrap>0 </wrap><wrap>¬¬¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%%_ </wrap><wrap>' ¬¬¬¬¬«</wrap> <wrap>%%__%%_ RESET %%__%%_¯</wrap> <wrap>[%%__%%_ MSGPREFIX </wrap><wrap>¬¬¬1¬¬¬ </wrap>//<wrap>messageprefix </wrap>//<wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%%%%__%%%%__%%</wrap><wrap>OFF ¬¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%%%__%%%%__%%_RESET %%__%%%%__%%%%__%%_¯</wrap> <wrap>[%%__%%_ ERRPREFIX </wrap><wrap>¬¬¬1¬¬¬ </wrap>//<wrap>errorprefix </wrap>//<wrap>¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>ª%%__%%%%__%%%%__%%_ </wrap><wrap>OFF ¬¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%%%__%%%%__%%RESET %%__%%%%__%%%%__%%¯</wrap> <wrap>F%%__%%_ MODE </wrap><wrap>¬¬¬1¬¬¬¬ </wrap><wrap>COMMAND </wrap><wrap>¬¬¬¬¬1¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap> <wrap>%%__%%_ SUBROUTINE%%__%%_¯</wrap> **//<wrap>8.139.3 Parameter</wrap>//** **<wrap>ENABLE </wrap>**<wrap>Enables the Rexx environment that is specified as argument (Regina or ooRexx). This option is only available if Hercules is built with support for both Regina and ooRexx and cannot be used in a single Rexx environment.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 513</wrap> <wrap>\\ </wrap><wrap>If no environment is given as argument then the default Rexx environment is started.</wrap> <wrap>The default can be specified with the HREXX_PACKAGE environment variable (for details see chapter 14 “REXX Support”). If this variable is not set the ooRexx is the default package used.</wrap> <wrap>ENABLE can be abbreviated as ‘ENA’.</wrap> **<wrap>START </wrap>**<wrap>This is the same as ENABLE. START can be abbreviated as ‘STA’.</wrap> **<wrap>DISABLE </wrap>**<wrap>Disables the currently active Rexx environment. This option is only available if Hercules is built with support for both Regina and ooRexx and cannot be used in a single Rexx environment.</wrap> <wrap>DISABLE can be abbreviated as ‘DIS’.</wrap> **<wrap>STOP </wrap>**<wrap>This is the same as DISABLE. STOP can be abbreviated as ‘STO’.</wrap> **<wrap>REGINA </wrap>**<wrap>Given as argument to the ‘START’ or ‘ENABLE’ options, REGINA specifies that the Regina Rexx environment has to be started.</wrap> **<wrap>OOREXX </wrap>**<wrap>Given as argument to the ‘START’ or ‘ENABLE’ option, OOREXX specifies that the Open Object Rexx (ooRexx) environment has to be started.</wrap> **<wrap>PATHS </wrap>**<wrap>This is the keyword for specifying the search path(s) for the Rexx scripts. PATHS can be abbreviated as ‘PATH’.</wrap> **<wrap>REXXPATHS </wrap>**<wrap>This is the same as PATHS. REXXPATHS can be abbreviated as ‘REXXP’.</wrap> **//<wrap>path </wrap>//**<wrap>A path (or a list of paths, separated by a delimiter) in which Rexx executables will be searched. If the path is not specified when activating the Rexx environment then the default used is the current path taken from the environment variable ‘PATH’.</wrap> **<wrap>SYSPATH </wrap>**<wrap>Keyword for specifying if the search for the Rexx executables should be extended to the system paths used for executables (when set to on ‘ON’) or if it should be</wrap> <wrap>limited to the defined PATHS / REXXPATHS (when set to ‘OFF’).</wrap> **<wrap>EXTENSIONS </wrap>**<wrap>This is the keyword for specifying the filename extension(s) to be used to search the Rexx executables. EXTENSIONS can be abbreviated as ‘EXT’.</wrap> <wrap>If a given script name is in the format //filename.extension //then it is used as is without any further processing</wrap> **<wrap>SUFFIXES </wrap>**<wrap>This is the same as EXTENSIONS. SUFFIXES can be abbreviated as ‘SUF’.</wrap> **//<wrap>suffix </wrap>//**<wrap>A filename extension (or a list of filename extensions, separated by a delimiter) that identifies a Rexx executable. A filename extension must be specified in the format “.//ext//”.</wrap> <wrap>If there are no extensions specified the defaults used are ‘.REXX’, ‘.rexx’, ‘.REX’, ‘.rex’, ‘.CMD’, ‘.cmd’, ‘.RX’ and ‘.rx’.</wrap> **//<wrap>delimiter </wrap>//**<wrap>This is the delimiter used for separating multiple paths or multiple extensions. For Linux and Mac OS-X systems this is the colon (“:”), for Windows systems it is the semicolon (“;”).</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 514</wrap> <wrap>\\ </wrap>**<wrap>RESOLVER </wrap>**<wrap>Keyword to define who will resolve the script name.</wrap> <wrap>When set to “ON” then the Hercules Rexx interface will resolve the script name and issue appropriate messages in case the process fails. When set to “OFF” then the script name will be passed as is to the Rexx interpreter.</wrap> <wrap>For examples of the different behaviour of the EXEC command depending on the RESOLVER settings please see the next section.</wrap> **<wrap>MSGLEVEL </wrap>**<wrap>This is the keyword for specifying the message level to be used. MSGLEVEL can be abbreviated as ‘MSGL’.</wrap> **<wrap>0 </wrap>**<wrap>Disables the display of the HHC17503I and HHC17504I messages when a script has finished.</wrap> **<wrap>1 </wrap>**<wrap>Enables the display of the HHC17503I and HHC17504I messages when a script has finished:</wrap> <wrap>HHC17503I REXX(//package name//) Exec/Script '//script name//' RetRC(0) HHC17504I REXX(//package name//) Exec/Script '//script name//' RetValue'0'</wrap> **<wrap>MSGPREFIX </wrap>**<wrap>This is the keyword used to set the prefix for standard messages (issued through ‘say’). MSGPREFIX can be abbreviated as ‘MSGP’.</wrap> **//<wrap>msgprefix </wrap>//**<wrap>Specifies the Rexx standard message prefix to be used. //msgprefix //can be any string up to 9 characters. Embedded blanks are not allowed.</wrap> **<wrap>ERRPREFIX </wrap>**<wrap>This is the keyword used to set the prefix for error messages. ERRPREFIX can be abbreviated as ‘ERRP’.</wrap> **//<wrap>errorprefix </wrap>//**<wrap>Specifies the Rexx error message prefix to be used. //errorprefix //can be any string up to 9 characters. Embedded blanks are not allowed.</wrap> **<wrap>MODE </wrap>**<wrap>This is the keyword used to specify the argument passing style to a Rexx script.</wrap> **<wrap>COMMAND </wrap>**<wrap>Specifies command style for passing arguments to a Rexx script. ‘COMMAND’ may be abbreviated as ‘COM’.</wrap> **<wrap>SUBROUTINE </wrap>**<wrap>Specifies subroutine style for passing arguments to a Rexx script. ‘SUBROUTINE’ may be abbreviated as ‘SUB’.</wrap> **<wrap>ON </wrap>**<wrap>Activates the specified option.</wrap> **<wrap>OFF </wrap>**<wrap>Deactivates the specified option.</wrap> **<wrap>RESET </wrap>**<wrap>Given as an argument to one of the options of the Rexx command this will reset the corresponding value to the default settings.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 515</wrap> <wrap>\\ </wrap>**//<wrap>8.139.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current Rexx interpreter settings (defaults).</wrap> <wrap>HHC00013I Herc command: 'rexx’</wrap> <wrap>HHC17500I REXX(Regina) Rexx Path ( 0) -</wrap> <wrap>HHC17500I REXX(Regina) Sys Path (18) - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Extensions( 9) - ;.REXX;.rexx;.REX;.rex;.CMD;.cmd;.RX;.rx</wrap> <wrap>HHC17500I REXX(Regina) Resolver - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Msg Level - 0</wrap> <wrap>HHC17500I REXX(Regina) Msg Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Err Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Mode - (Command)</wrap> <wrap>HHC17500I REXX(Regina) REXX-Regina_3.6(MT) 5.00 31 Dec 2011</wrap> <wrap>HHC17500I REXX(Regina) WIN64 FUNCTION Instore</wrap> **<wrap>Figure 255: REXX command (display interpreter settings)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the path for Rexx executables to “d:%%\%%mvs%%\%%conf” and “d:%%\%%mvs%%\%%rexx”.</wrap> <wrap>HHC00013I Herc command: 'rexx paths </wrap>[[file:///d:/mvs/conf|<wrap>d:%%\%%mvs%%\%%conf</wrap>]]<wrap>;d:%%\%%mvs%%\%%rexx’</wrap> <wrap>HHC17500I REXX(Regina) Rexx Path ( 2) -d:%%\%%mvs%%\%%conf;d:%%\%%mvs%%\%%rexx</wrap> <wrap>HHC17500I REXX(Regina) Sys Path (18) - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Extensions( 9) - ;.REXX;.rexx;.REX;.rex;.CMD;.cmd;.RX;.rx</wrap> <wrap>HHC17500I REXX(Regina) Resolver - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Msg Level - 0</wrap> <wrap>HHC17500I REXX(Regina) Msg Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Err Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Mode - (Command)</wrap> <wrap>HHC17500I REXX(Regina) REXX-Regina_3.6(MT) 5.00 31 Dec 2011</wrap> <wrap>HHC17500I REXX(Regina) WIN64 FUNCTION Instore</wrap> **<wrap>Figure 256: REXX command (set PATH)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the extensions for Rexx executables to “*.rexx” and “*.rex”.</wrap> <wrap>HHC00013I Herc command: 'rexx suffixes .rexx;.rex’</wrap> <wrap>HHC17500I REXX(Regina) Rexx Path ( 2) -d:%%\%%mvs%%\%%conf;d:%%\%%mvs%%\%%rexx</wrap> <wrap>HHC17500I REXX(Regina) Sys Path (18) - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Extensions( 3) - ;.rexx;.rex</wrap> <wrap>HHC17500I REXX(Regina) Resolver - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Msg Level - 0</wrap> <wrap>HHC17500I REXX(Regina) Msg Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Err Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Mode - (Command)</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 516</wrap> <wrap>\\ </wrap><wrap>HHC17500I REXX(Regina) REXX-Regina_3.6(MT) 5.00 31 Dec 2011 \\ HHC17500I REXX(Regina) WIN64 FUNCTION Instore</wrap> **<wrap>Figure 257: REXX command (set EXTENSION)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Set the prefix for Rexx error messages to “RXERR”.</wrap> <wrap>HHC00013I Herc command: 'rexx errpref RXERR’</wrap> <wrap>HHC17500I REXX(Regina) Rexx Path ( 2) -d:%%\%%mvs%%\%%conf;d:%%\%%mvs%%\%%rexx</wrap> <wrap>HHC17500I REXX(Regina) Sys Path (18) - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Extensions( 3) - ;.rexx;.rex</wrap> <wrap>HHC17500I REXX(Regina) Resolver - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Msg Level - 0</wrap> <wrap>HHC17500I REXX(Regina) Msg Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Err Prefix - RXERR</wrap> <wrap>HHC17500I REXX(Regina) Mode - (Command)</wrap> <wrap>HHC17500I REXX(Regina) REXX-Regina_3.6(MT) 5.00 31 Dec 2011</wrap> <wrap>HHC17500I REXX(Regina) WIN64 FUNCTION Instore</wrap> **<wrap>Figure 258: REXX command (set ERRPREF)</wrap>** **<wrap>Example 5:</wrap>** <wrap>Disable the error message prefixing.</wrap> <wrap>HHC00013I Herc command: 'rexx errpref reset’</wrap> <wrap>HHC17500I REXX(Regina) Rexx Path ( 2) -d:%%\%%mvs%%\%%conf;d:%%\%%mvs%%\%%rexx</wrap> <wrap>HHC17500I REXX(Regina) Sys Path (18) - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Extensions( 3) - ;.rexx;.rex</wrap> <wrap>HHC17500I REXX(Regina) Resolver - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Msg Level - 0</wrap> <wrap>HHC17500I REXX(Regina) Msg Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Err Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Mode - (Command)</wrap> <wrap>HHC17500I REXX(Regina) REXX-Regina_3.6(MT) 5.00 31 Dec 2011</wrap> <wrap>HHC17500I REXX(Regina) WIN64 FUNCTION Instore</wrap> **<wrap>Figure 259: REXX command (disable ERRPREF)</wrap>** **<wrap>Example 6:</wrap>** <wrap>Messages issued when a Rexx script could not be found and RESOLVER is set to ‘ON’.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command:</wrap> </WRAP> |<WRAP><wrap>'rexx resolver</wrap> </WRAP> ||<WRAP><wrap>on’</wrap> </WRAP> | |<WRAP><wrap>HHC17500I</wrap> </WRAP> |<WRAP><wrap>REXX(Regina)</wrap> </WRAP> |<WRAP><wrap>Rexx Path</wrap> </WRAP> |<WRAP><wrap>( 2)</wrap> </WRAP> |<WRAP><wrap>-d:%%\%%mvs%%\%%conf;d:%%\%%mvs%%\%%rexx</wrap> </WRAP> | |<WRAP><wrap>HHC17500I</wrap> </WRAP> |<WRAP><wrap>REXX(Regina)</wrap> </WRAP> |<WRAP><wrap>Sys Path</wrap> </WRAP> |<WRAP><wrap>(18)</wrap> </WRAP> |<WRAP><wrap>- (ON)</wrap> </WRAP> | |<WRAP><wrap>HHC17500I</wrap> </WRAP> |<WRAP><wrap>REXX(Regina)</wrap> </WRAP> |<WRAP><wrap>Extensions( 3)</wrap> </WRAP> ||<WRAP><wrap>- ;.rexx;.rex</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 517</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC17500I REXX(Regina) Resolver - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Msg Level - 0</wrap> <wrap>HHC17500I REXX(Regina) Msg Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Err Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Mode - (Command)</wrap> <wrap>HHC17500I REXX(Regina) REXX-Regina_3.6(MT) 5.00 31 Dec 2011</wrap> <wrap>HHC17500I REXX(Regina) WIN64 FUNCTION Instore</wrap> <wrap>HHC01603I exec samplerexx</wrap> <wrap>HHC17506I REXX(Regina) Exec/script 'samplerexx' not found</wrap> **<wrap>Figure 260: REXX command (RESOLVER ON)</wrap>** **<wrap>Example 7:</wrap>** <wrap>Messages issued when a Rexx script could not be found and RESOLVER is set to ‘OFF’.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'rexx resolver off’</wrap> <wrap>HHC17500I REXX(Regina) Rexx Path ( 2) -d:%%\%%mvs%%\%%conf;d:%%\%%mvs%%\%%rexx</wrap> <wrap>HHC17500I REXX(Regina) Sys Path (18) - (ON)</wrap> <wrap>HHC17500I REXX(Regina) Extensions( 3) - ;.rexx;.rex</wrap> <wrap>HHC17500I REXX(Regina) Resolver - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Msg Level - 0</wrap> <wrap>HHC17500I REXX(Regina) Msg Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Err Prefix - (OFF)</wrap> <wrap>HHC17500I REXX(Regina) Mode - (Command)</wrap> <wrap>HHC17500I REXX(Regina) REXX-Regina_3.6(MT) 5.00 31 Dec 2011</wrap> <wrap>HHC17500I REXX(Regina) WIN64 FUNCTION Instore</wrap> <wrap>Messages issued when using Regina Rexx:</wrap> <wrap>HHC01603I exec samplerexx</wrap> <wrap>HHC17506I REXX(Regina) Exec/script 'samplerexx' not found</wrap> <wrap>Messages issued when using ooRexx:</wrap> <wrap>HHC01603I exec samplerexx</wrap> <wrap>REX0003E: Error 3: Failure during initialization</wrap> <wrap>REX0534E: Error 3.901: Failure during initialization: Program “samplerexx” was not found</wrap> <wrap>HHC17502E REXX(ooRexx) ooRexx RC(-3)</wrap> **<wrap>Figure 261: REXX command (RESOLVER OFF)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 518</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.140 RMMOD (Delete a module) \\ //8.140.1 Function//</wrap>** <wrap>The RMMOD command deletes (unloads) modules.</wrap> **//<wrap>8.140.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>RMM0D </wrap>//<wrap>module </wrap>//<wrap>[//module //[//module //...11</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>RMM0D ¬¬¬°¬¬</wrap><wrap>¬ //module//</wrap> **//<wrap>8.140.3 Parameter</wrap>//** **//<wrap>module </wrap>//**<wrap>The names of the modules that have to be unloaded. If a device is still bound to a module then a message is issued and the module is not deleted.</wrap> **//<wrap>8.140.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Delete module “S37X” (S/370 Extension).</wrap> <wrap>HHC00013I Herc command: 'rmmod s37x'</wrap> <wrap>HHC01528I HDL: unloading module 's37x'... \\ HHC01529I HDL: module 's37x' unloaded</wrap> **<wrap>Figure 262: RMMOD command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 519</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.141 S (Instruction stepping) \\ //8.141.1 Function//</wrap>** <wrap>This command sets the instruction stepping and breaking range. The instruction stepping is totally separate from the instruction tracing range (See T command).</wrap> <wrap>A range can be specified. If there is no range then the range includes all addresses. “S 0” eliminates the range and all addresses will be stepped. With or without a given range, the S command displays whether instruction stepping is on or off and the range if any.</wrap> <wrap>The S command by itself does not activate instruction stepping. Use the S+ command to activate instruction stepping.</wrap> **//<wrap>8.141.2 Syntax</wrap>//** <wrap>The S command has the following syntax:</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>S [</wrap>//<wrap>addr-addr </wrap>//<wrap>| </wrap>//<wrap>addr:addr </wrap>//<wrap>| </wrap>//<wrap>addr.length </wrap>//<wrap>| 01</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬S¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ª¬¬¬¬</wrap>//<wrap>addr-addr </wrap>//<wrap>¬¬¬¬« ª¬¬¬¬ </wrap>//<wrap>addr:addr </wrap>//<wrap>¬¬¬¬« ª¬¬¬</wrap>//<wrap>addr.length </wrap>//<wrap>¬¬¬« ⡿¬¬¬¬¬¬¬¬0¬¬¬¬¬¬¬¬¯</wrap> **//<wrap>8.141.3 Parameter</wrap>//** **//<wrap>addr-addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address).</wrap> **//<wrap>addr:addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address).</wrap> **//<wrap>addr.length </wrap>//**<wrap>Specifies an address range with start and length (from begin address with the specified length).</wrap> **<wrap>0 </wrap>**<wrap>No range is specified or an existing range is reset. Instruction stepping is set for all addresses.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 520</wrap> <wrap>\\ </wrap>**//<wrap>8.141.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set instruction stepping range with begin and end address and query the range afterwards.</wrap> <wrap>HHC00013I Herc command: 's 100000-101000'</wrap> <wrap>HHC02229I Instruction stepping off range 100000-101000</wrap> <wrap>HHC00013I Herc command: 's?'</wrap> <wrap>HHC02229I Instruction stepping off range 100000-101000</wrap> **<wrap>Figure 263: S command (address range)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set instruction stepping range with start address and length and query the range afterwards.</wrap> <wrap>HHC00013I Herc command: 's 100000.1000'</wrap> <wrap>HHC02229I Instruction stepping off range 100000.1000</wrap> <wrap>HHC00013I Herc command: 's?'</wrap> <wrap>HHC02229I Instruction stepping off range 100000-101000</wrap> **<wrap>Figure 264: S command (address with length)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set instruction stepping for all addresses and query the range afterwards.</wrap> <wrap>HHC00013I Herc command: 's 0' \\ HHC02229I Instruction stepping off \\ HHC00013I Herc command: 's?' \\ HHC02229I Instruction stepping off</wrap> **<wrap>Figure 265: S command (all addresses)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 521</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.142 S+ (Instruction stepping on) \\ //8.142.1 Function//</wrap>** <wrap>This command turns on the instruction stepping. After turning instruction stepping on, each ENTER from the console allows Hercules to execute exactly one instruction and lists detailed trace information.</wrap> <wrap>The trace information includes the executing CPU, the PSW, the executed instruction in hexadecimal and in disassembled form as well as register hexadecimal displays of all involved register types.</wrap> <wrap>A range can be specified as for the “S” command, otherwise the existing range is used. If there is no range (or range was specified as 0) then the range includes all addresses.</wrap> <wrap>When an instruction within the range is about to be executed, the CPU is temporarily stopped and the next instruction is displayed. You may then examine registers and/or storage etc. before you press Enter to execute the instruction and stop at the next instruction. To turn off instruction stepping and continue normal execution, enter the “G” command.</wrap> **//<wrap>8.142.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>S+ [</wrap>//<wrap>addr-addr </wrap>//<wrap>| </wrap>//<wrap>addr:addr </wrap>//<wrap>| </wrap>//<wrap>addr.length </wrap>//<wrap>| 01</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬S+¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ª¬¬¬¬</wrap>//<wrap>addr-addr </wrap>//<wrap>¬¬¬¬« ª¬¬¬¬ </wrap>//<wrap>addr:addr </wrap>//<wrap>¬¬¬¬« ª¬¬¬</wrap>//<wrap>addr.length </wrap>//<wrap>¬¬¬« ⡿¬¬¬¬¬¬¬¬0¬¬¬¬¬¬¬¬¯</wrap> **//<wrap>8.142.3 Parameter</wrap>//** **//<wrap>addr-addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address).</wrap> **//<wrap>addr:addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address).</wrap> **//<wrap>addr.length </wrap>//**<wrap>Specifies an address range with start and length (from begin address with the specified length).</wrap> **<wrap>0 </wrap>**<wrap>No range is specified or an existing range is reset. Instruction stepping is set for all addresses.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 522</wrap> <wrap>\\ </wrap>**//<wrap>8.142.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Turn on instruction stepping.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 's+'</wrap> |<WRAP><wrap>HHC02229I Instruction stepping on</wrap> <wrap>HHC00811I Processor CP00: architecture mode 'S/370'</wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=0000014800000080 INST=05F0 BALR 15,0</wrap> </WRAP> |<WRAP><wrap>branch_and_link_register</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR04=00000000 GR05=00000000 GR06=00000000 GR07=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR08=00000000 GR09=00000000 GR10=00000000 GR11=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR12=00000000 GR13=00000000 GR14=00000000 GR15=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>HHC00834I Processor CP00: running state selected</wrap> |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=0000014800000082 INST=980E0010 LM</wrap> </WRAP> |<WRAP><wrap>0,14,16(0) load_multiple</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>R:00000010:K:06=00000000 00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000 .............. </wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR00=00000000 GR01=00000000 GR02=00000000</wrap> </WRAP> |<WRAP><wrap>GR03=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR04=00000000 GR05=00000000 GR06=00000000</wrap> </WRAP> |<WRAP><wrap>GR07=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR08=00000000 GR09=00000000 GR10=00000000</wrap> </WRAP> |<WRAP><wrap>GR11=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR12=00000000 GR13=00000000 GR14=00000000</wrap> </WRAP> |<WRAP><wrap>GR15=40000082</wrap> </WRAP> | |<WRAP><wrap>HHC00834I Processor CP00: running state selected</wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=0000014880000086 INST=41A0F05A LA</wrap> </WRAP> |<WRAP><wrap>10,90(0,15) load_address</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>R:000000DC:K:06=41800100 41A0F08A 1B984700</wrap> </WRAP> |<WRAP><wrap>F06E5890 ......0..q..0>. </wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR00=00000000 GR01=00000000 GR02=00000000</wrap> </WRAP> |<WRAP><wrap>GR03=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR04=00000000 GR05=00000000 GR06=00000000</wrap> </WRAP> |<WRAP><wrap>GR07=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR08=00000000 GR09=00000000 GR10=00000000</wrap> </WRAP> |<WRAP><wrap>GR11=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR12=00000000 GR13=00000000 GR14=00000000</wrap> </WRAP> |<WRAP><wrap>GR15=40000082</wrap> </WRAP> | <wrap>HHC00834I Processor CP00: running state selected</wrap> |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=000001488000008A INST=D200FC7D0008 MVC</wrap> </WRAP> |<WRAP><wrap>3197(1,15),8(0) move_character</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00: R:00000CFF:K:06=F1 E5D5C9D7 D458FFFF 76B3BD00 AAAAFF 1VNIPM.....].. </wrap> </WRAP> || | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00: R:00000008:K:06=F1000000 00000000 00000000</wrap> </WRAP> ||<WRAP><wrap>00000000 1............. </wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR00=00000000 GR01=00000000 GR02=00000000</wrap> </WRAP> |<WRAP><wrap>GR03=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR04=00000000 GR05=00000000 GR06=00000000</wrap> </WRAP> |<WRAP><wrap>GR07=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR08=00000000 GR09=00000000 GR10=000000DC</wrap> </WRAP> |<WRAP><wrap>GR11=00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR12=00000000 GR13=00000000 GR14=00000000</wrap> </WRAP> |<WRAP><wrap>GR15=40000082</wrap> </WRAP> | <wrap>HHC00834I Processor CP00: running state selected</wrap> <wrap>HHC02267I CP00: PSW=00000148C0000090 INST=95000009 CLI 9(0),0 compare_logical_immediate</wrap> <wrap>HHC02267I CP00: R:00000009:K:06=000000 00000000 00000000 00000000 00 ........... </wrap> <wrap>HHC02267I CP00: GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000 HHC02267I CP00: GR04=00000000 GR05=00000000 GR06=00000000 GR07=00000000 HHC02267I CP00: GR08=00000000 GR09=00000000 GR10=000000DC GR11=00000000 HHC02267I CP00: GR12=00000000 GR13=00000000 GR14=00000000 GR15=40000082 HHC00834I Processor CP00: running state selected</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 266: S+ command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 523</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.143 S- (Instruction stepping off) \\ //8.143.1 Function//</wrap>** <wrap>This command turns off the instruction stepping. To continue normal processing after stopping the instruction stepping use the “G” command.</wrap> **//<wrap>8.143.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>****<wrap>S</wrap>**<wrap>-</wrap><wrap></wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ S</wrap>** **//<wrap>8.143.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.143.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Turn off instruction stepping.</wrap> <wrap>HHC00013I Herc command: 's-'</wrap> <wrap>HHC02229I Instruction stepping off range 40130-441c6</wrap> **<wrap>Figure 267: S- command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 524</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.144 S? (Instruction stepping query) \\ //8.144.1 Function//</wrap>** <wrap>The S? command displays whether instruction stepping is on or off and the active range if any.</wrap> **//<wrap>8.144.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>S?</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ S</wrap>****<wrap>?</wrap>** **//<wrap>8.144.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.144.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Query instruction stepping.</wrap> <wrap>HHC00013I Herc command: 's?'</wrap> <wrap>HHC02229I Instruction stepping off range 100000-101000</wrap> **<wrap>Figure 268: S? command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 525</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.145 S{+/-} dev (Turn CCW stepping on or off) \\ //8.145.1 Function//</wrap>** <wrap>This command turns on (s+ dev) or turns off (s- dev) the CCW stepping function. After CCW stepping is turned on every execution of a CCW has to be confirmed by hitting ENTER on the Hercules console and produces detailed trace output.</wrap> **//<wrap>8.145.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>S{+ | </wrap>//<wrap>-</wrap>//<wrap>} </wrap>//<wrap>devaddr</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬S ¬¬¬§¬¬¬ + ¬¬¬§¬¬¬ </wrap>//<wrap>devaddr</wrap>// <wrap>⡿¬¬¬</wrap>//<wrap>- </wrap>//<wrap>¬¬¬¯</wrap> **//<wrap>8.145.3 Parameter</wrap>//** **//<wrap>devaddr </wrap>//**<wrap>This is the address of the device for which CCW stepping will be turned on or off.</wrap> **<wrap>+ </wrap>**<wrap>The plus sign turns on the CCW stepping for the given device. The plus sign must immediately follow the S command (without an intervening blank).</wrap> **<wrap>- </wrap>**<wrap>The minus sign turns off the CCW stepping for the given device. The minus sign must immediately follow the S command (without an intervening blank).</wrap> **//<wrap>8.145.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Turn on CCW stepping.</wrap> |<WRAP><wrap>HHC00013I HHC02204I</wrap> </WRAP> |<WRAP><wrap>Herc command: 's+0148'</wrap> <wrap>CCW step for 0:0148 set to on</wrap> </WRAP> || | |<WRAP><wrap>HHC00396I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>start i/o</wrap> </WRAP> |<WRAP><wrap>file[1] bufcur -1 cache[-1]</wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CHAN: ccw</wrap> </WRAP> |<WRAP><wrap>02000000 60000018=>02000000 60000018 00000000 00000000 -</wrap> </WRAP> | |<WRAP><wrap>HHC00431I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': seeking to cyl 0 head 0</wrap> </WRAP> | |<WRAP><wrap>HHC00396I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>read trk</wrap> </WRAP> |<WRAP><wrap>0 (asynchronous)</wrap> </WRAP> | |<WRAP><wrap>HHC00396I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>0 rdtrk</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> | |<WRAP><wrap>HHC00396I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>0 rdtrk[0]</wrap> </WRAP> |<WRAP><wrap>0 cache miss</wrap> </WRAP> | |<WRAP><wrap>HHC00396I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>0 rdtrk[0]</wrap> </WRAP> |<WRAP><wrap>0 buf 07AB5C88 len 19456</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 526</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00396I 0:0148 trk[0] read_trkimg</wrap> <wrap>HHC00396I 0:0148 file[1] l2[0,0] trk[0] read_l2ent 0xd08</wrap> <wrap>HHC00396I 0:0148 file[1] read_l2 0 active -1 -1 -1</wrap> <wrap>HHC00396I 0:0148 l2[1,0] cache[0] miss</wrap> <wrap>HHC00396I 0:0148 file[1] fd[18] read, off 0x0000000000000d08 len 2048</wrap> <wrap>HHC00396I 0:0148 file[1] cache[0] l2[0] read offset 0x00000d08</wrap> <wrap>HHC00396I 0:0148 file[0] l2[0,0] trk[0] read_l2ent 0x508</wrap> <wrap>HHC00396I 0:0148 file[0] read_l2 0 active 1 0 0</wrap> <wrap>HHC00396I 0:0148 l2[0,0] cache[1] miss</wrap> <wrap>HHC00396I 0:0148 file[0] fd[17] read, off 0x0000000000000508 len 2048</wrap> <wrap>HHC00396I 0:0148 file[0] cache[1] l2[0] read offset 0x00000508</wrap> <wrap>HHC00396I 0:0148 file[0] l2[0,0] trk[0] read_l2ent 0x116f079 2343 2343</wrap> <wrap>HHC00396I 0:0148 file[0] fd[17] read, off 0x000000000116f079 len 2343</wrap> <wrap>HHC00396I 0:0148 0 rdtrk[0] 0 complete buf 07AB5C88:0100000000</wrap> <wrap>HHC00396I 0:0148 uncompress comp 1 len 2343 maxlen 19456 trk 0</wrap> <wrap>HHC00396I 0:0148 newbuf malloc 023C1CD0 len 19456</wrap> <wrap>HHC00396I 0:0148 uncompress zlib newlen 6817 rc 0</wrap> <wrap>HHC00396I 0:0148 validating trk 0 len 6817 0000000000 0000000000000008</wrap> <wrap>HHC00396I 0:0148 read trk 0 uncompressed len 6817</wrap> <wrap>HHC00434I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read count orientation 'index' HHC00435I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head 0 record 0 kl 0 dl 8 of 0 HHC00435I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head 0 record 1 kl 4 dl 24 of 0 HHC00437I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read data 24 bytes</wrap> <wrap>HHC01312I 0:0148 CHAN: stat 0C00, count 0000 '=>00000000 00000000 06003A98 60000060 ......... q</wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 06003A98 60000060=>00000000 00000000 00000000 00000000 ............ </wrap> <wrap>HHC00434I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read count orientation 'data'</wrap> <wrap>HHC00435I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head 0 record 2 kl 4 dl 144 of 0 HHC00437I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read data 144 bytes</wrap> <wrap>HHC01312I 0:0148 CHAN: stat 0C00, count 0000 '=>07003AB8 40000006 31003ABE 40000005 .... ...... </wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 08003A98 00000000=>07003AB8 40000006 31003ABE 40000005 .... ....... </wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 07003AB8 40000006=>00000000 00000000 00000400 00000000 ............ </wrap> <wrap>HHC00431I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': seeking to cyl 0 head 0 HHC01312I 0:0148 CHAN: stat 0C00, count 0000 "</wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 31003ABE 40000005=>00000000 04000000 00000000 00000000 ............ </wrap> <wrap>HHC00434I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read count orientation 'index'</wrap> <wrap>HHC00435I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head 0 record 0 kl 0 dl 8 of 0</wrap> <wrap>HHC01312I 0:0148 CHAN: stat 0C00, count 0000 "</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 269: S+ dev command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Turn off CCW stepping.</wrap> <wrap>HHC00013I Herc command: 's-0148'</wrap> <wrap>HHC02204I CCW step for 0:0148 set to off</wrap> **<wrap>Figure 270: S- dev command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 527</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.146 SAVECORE (Save a core image to a file) \\ //8.146.1 Function//</wrap>** <wrap>The SAVECORE command allows you to save a portion of real storage in binary form to a file. This command is used mainly for emulator debugging purposes. A certain core snapshot can be saved and then be restored at any later time to reproduce some tests with identical real storage values.</wrap> <wrap>Please note that you have to stop all CPUs (see STOP/STOPALL commands) before saving the core image to a file.</wrap> **//<wrap>8.146.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SAVECORE</wrap>//<wrap> filename </wrap>//<wrap>[</wrap>//<wrap>start </wrap>//<wrap>|</wrap><wrap> * ] [</wrap>//<wrap>end </wrap>//<wrap>|</wrap><wrap> * ]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>~¬¬¬¬¬ * ¬¬¬¬¬® ~¬¬¬¬ * ¬¬¬¬®</wrap> <wrap>ÊÊØØØ SAVECORE ØØØ</wrap>//<wrap> filename </wrap>//<wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿ØØØ</wrap>//<wrap> start </wrap>//<wrap>ØØØ¯ ⡿ØØØ</wrap>//<wrap> end </wrap>//<wrap>ØØØ¯</wrap> **//<wrap>8.146.3 Parameter</wrap>//** **//<wrap>filename </wrap>//**<wrap>This argument specifies the file name (and optionally the path) of the file where the core image will be written to.</wrap> **//<wrap>start </wrap>//****<wrap>or * </wrap>**//<wrap>Start </wrap>//<wrap>specifies the start address of the real storage to be saved to the file //filename//. The asterisk (“*”), which is the default, means the first byte of the first modified page as determined by the storage-key changed bit.</wrap> **//<wrap>end </wrap>//****<wrap>or * </wrap>**//<wrap>End </wrap>//<wrap>specifies the end address of the real storage to be saved to the file //filename//. The asterisk (“*”), which is the default, means the last byte of the last modified page as determined by the storage-key changed bit.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 528</wrap> <wrap>\\ </wrap>**//<wrap>8.146.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Save the first 4096 bytes of real storage to file </wrap>[[file:///D:/core01.bin.|<wrap>D:%%\%%core01.bin.</wrap>]]<wrap></wrap> <wrap>HHC00013I Herc command: 'stopall'</wrap> <wrap>HHC00013I Herc command: 'savecore </wrap>[[file:///d:/core01.bin|<wrap>d:%%\%%core01.bin</wrap>]]<wrap> 00000000 00001000' \\ HHC02248I Saving locations 00000000-00001000 to file '</wrap>[[file:///d:/core01.bin|<wrap>d:%%\%%core01.bin</wrap>]]<wrap>' \\ HHC02249I Operation complete</wrap> **<wrap>Figure 271: SAVECORE command (save specific area)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Save all real storage to file </wrap>[[file:///D:/core02.bin.|<wrap>D:%%\%%core02.bin.</wrap>]]<wrap></wrap> <wrap>HHC00013I Herc command: 'stopall'</wrap> <wrap>HHC00013I Herc command: 'savecore </wrap>[[file:///d:/core02.bin|<wrap>d:%%\%%core02.bin</wrap>]]<wrap> * *'</wrap> <wrap>HHC02248I Saving locations 00000000-00FFFFFF to file '</wrap>[[file:///d:/core02.bin|<wrap>d:%%\%%core02.bin</wrap>]]<wrap>'</wrap> <wrap>HHC02249I Operation complete</wrap> **<wrap>Figure 272: SAVECORE command (save from begin to end)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 529</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.147 SCLPROOT (Set or display SCLP base directory) //8.147.1 Function//</wrap>** <wrap>The SCLPROOT command sets or displays the SCLP base directory. If a directory is given then SCLP disk I/O for the specified directory path is enabled. NONE disables SCLP disk I/O.</wrap> <wrap>A subsequent list-directed IPL resets the path to the location of the .ins file, and a subsequent CCW-type IPL disables SCLP disk I/O. If no operand is specified, SCLPROOT displays the current setting.</wrap> **//<wrap>8.147.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SCLPROOT [NONE | </wrap>//<wrap>directory</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>Ê</wrap><wrap>Ê¬¬¬SCLPROOT</wrap> <wrap>ª¬¬¬¬¬NONE¬¬¬</wrap> <wrap>i¬¬¬ </wrap>//<wrap>directory</wrap>// **//<wrap>8.147.3 Parameter</wrap>//** **<wrap>NONE </wrap>**<wrap>Disables SCLP disk I/O.</wrap> **//<wrap>directory </wrap>//**<wrap>Specifies the directory from which SCLP disk I/O is allowed. A subsequent IPL of \\ an “.ins” file or a subsequent CCW-type IPL will override this.</wrap> **//<wrap>8.147.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display SCLP base directory.</wrap> <wrap>HHC00013I Herc command: 'sclproot'</wrap> <wrap>HHC02204I SCLP disk I/O set to disabled</wrap> **<wrap>Figure 273: SCLPROOT command (display SCLP base directory)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 530</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set SCLP base directory.</wrap> <wrap>HHC00013I Herc command: 'sclproot </wrap>[[file:///d:/iso|<wrap>d:%%\%%iso</wrap>]]<wrap>' \\ HHC00013I Herc command: 'sclproot'</wrap> <wrap>HHC02204I sclproot set to </wrap>[[file:///d:/iso/|<wrap>d:/iso/</wrap>]]<wrap></wrap> **<wrap>Figure 274: SCLPROOT command (set SCLP base directory)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 531</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.148 SCP (Send system control program command) \\ //8.148.1 Function//</wrap>** <wrap>The SCP command sends a command to the system control program (the guest operating system running under Hercules) in any CMDTGT mode.</wrap> **//<wrap>8.148.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>**<wrap>SCP</wrap>//<wrap> [cmd]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊØØØSCP</wrap> //<wrap>cmd</wrap>// **//<wrap>8.148.3 Parameter</wrap>//** **//<wrap>cmd </wrap>//**<wrap>This is the command to be sent to the system control program (guest operating system).</wrap> **//<wrap>8.148.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Send a reply (“r 00,0148”) to the system control program running under Hercules when in HERC or PSCP command target mode.</wrap> <wrap>* IGGN504A SPECIFY UNIT FOR CATALOG.MVS.MASTER ON MVSRES</wrap> <wrap>scp r 00,0148</wrap> <wrap>HHCCP041I SYSCONS interface active</wrap> <wrap>IEE600I REPLY TO 00 IS;0148</wrap> **<wrap>Figure 275: SCP command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 532</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.149 SCPECHO (Display or set echo to console and history of SCP replies)</wrap>** **//<wrap>8.149.1 Function</wrap>//** <wrap>SCPECHO switches the SPC ('.') and priority SCP ('!') replies and responses to the Hercules console on or off or displays the current setting if no argument is given. This is to manage passwords being displayed and journaled.</wrap> <wrap>The default for SCPECHO is off if it is not explicitly switched on in the Hercules configuration file.</wrap> **//<wrap>8.149.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SCPECHO [OFF | ON] \\ </wrap>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ </wrap><wrap>SCPECHO </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ </wrap><wrap>OFF ¬¬¬«</wrap> <wrap>⡿¬¬¬ ON ¬¬¬¬¯</wrap> **//<wrap>8.149.3 Parameter</wrap>//** **<wrap>OFF </wrap>**<wrap>Do not route the SPC and priority SCP replies and responses to the Hercules console.</wrap> **<wrap>ON </wrap>**<wrap>Route the SPC and priority SCP replies and responses to the Hercules console.</wrap> **//<wrap>8.149.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Switch echo to Hercules console for SCP and priority SCP commands on and off.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'scpecho on' \\ HHC02204I SCP, PSCP echo set to on</wrap> <wrap>HHC00013I Herc command: 'scpecho off' \\ HHC02204I SCP, PSCP echo set to off</wrap> **<wrap>Figure 276: SCPECHO command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 533</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.150 SCPIMPLY (Display or set option to pass non-Hercules commands to the SCP)</wrap>** **//<wrap>8.150.1 Function</wrap>//** <wrap>SCPIMPLY allows it to switch on or off the passing of all non-Hercules commands (commands unknown to Hercules) to the SPC if the SCP has enabled receipt of SCP commands. Given without an argument the command displays the current value.</wrap> <wrap>The default for SCPIMPLY is off if it is not explicitly switched on in the Hercules configuration file.</wrap> **//<wrap>8.150.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SCPIMPLY [OFF | ON] \\ </wrap>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>SCPIMPLY </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ </wrap><wrap>OFF ¬¬¬«</wrap> <wrap>⡿¬¬¬ ON ¬¬¬¬¯</wrap> **//<wrap>8.150.3 Parameter</wrap>//** **<wrap>OFF </wrap>**<wrap>Do not route the SPC and priority SCP replies and responses to the Hercules console. This is the default, if SCPECHO is not coded in the configuration file.</wrap> **<wrap>ON </wrap>**<wrap>Route the SPC and priority SCP replies and responses to the Hercules console.</wrap> **//<wrap>8.150.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Switch passing of non-Hercules commands to the SCP on and off.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'scpimply'</wrap> <wrap>HHC02204I Value 'scpimply' set to 'off'</wrap> <wrap>HHC00013I Herc command: 'scpimply on' \\ HHC02204I Value 'scpimply' set to 'on'</wrap> **<wrap>Figure 277: SCPIMPLY command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 534</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.151 SCRIPT (Run a sequence of commands contained in a file) //8.151.1 Function//</wrap>** <wrap>The SCRIPT command sequentially executes the commands contained within the file //filename//. The script file itself may also contain script commands but the system ensures that no more than 10 levels of scripts are invoked at any one time to avoid recursion loops. Enter the command without any arguments to list all currently running scripts.</wrap> **//<wrap>8.151.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>SCRIPT </wrap>****<wrap>[//filename //[//filename //... ]]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ SCRIPT ¬¬¬°¬¬¬ </wrap>****//<wrap>filename</wrap>//** **//<wrap>8.151.3 Parameter</wrap>//** **//<wrap>filename </wrap>//**<wrap>The name (and optionally the path) of the script file to be executed.</wrap> **//<wrap>8.151.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Execute script file “Script1.rc”.</wrap> <wrap>HHC00013I Herc command: 'script </wrap>[[file:///D:/MVS/Conf/Script1.rc|<wrap>D:%%\%%MVS%%\%%Conf%%\%%Script1.rc</wrap>]]<wrap>'</wrap> <wrap>HHC02260I Script 5: begin processing file '</wrap>[[file:///D:/MVS/Conf/Script1.rc|<wrap>D:/MVS/Conf/Script1.rc</wrap>]]<wrap>'</wrap> **<wrap>Figure 278: SCRIPT command (Execute script file)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 535</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>List all currently running scripts.</wrap> |<WRAP><wrap>HHC00013I Herc command: 'script'</wrap> <wrap>HHC02315I Script id:2, tid:00000D2C, level:1, name:D:%%\%%MVS%%\%%Conf%%\%%Script1.rc HHC02315I Script id:3, tid:00000A4C, level:1, name:D:%%\%%MVS%%\%%Conf%%\%%Script2.rc HHC02315I Script id:4, tid:000017E8, level:1, name:D:%%\%%MVS%%\%%Conf%%\%%Script3.rc HHC02315I Script id:5, tid:00000E6C, level:1, name:D:%%\%%MVS%%\%%Conf%%\%%Script4.rc HHC02315I Script id:6, tid:00000B50, level:1, name:D:%%\%%MVS%%\%%Conf%%\%%Script5.rc</wrap> </WRAP> | **<wrap>Figure 279: SCRIPT command (list currently running scripts)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 536</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.152 SCSIMOUNT (Automatic SCSI tape mounts) \\ //8.152.1 Function//</wrap>** <wrap>The SCSIMOUNT command displays or modifies the automatic SCSI tape mount option. When entered without any operands it displays the current value and any pending tape mount requests. Entering a value between 1 and 99 enables the option and specifies how often (in seconds) to query SCSI tape drives to automatically detect when a tape has been mounted. When a tape is mounted an unsolicited device attention interrupt will be presented to the guest operating system.</wrap> <wrap>Notes: Enabling this option may negatively impact Hercules performance depending on how the host operating system (Windows, Linux, etc.) processes SCSI attached tape drive status queries.</wrap> **//<wrap>8.152.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SCSIMOUNT [NO | YES | </wrap>//<wrap>secs</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SCSIMOUNT¬¬¬§¬¬¬ NO </wrap><wrap>¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬¬ YES </wrap><wrap>¬¬¬¬¬«</wrap> <wrap>⡿¬</wrap><wrap>¬¬ </wrap>//<wrap>secs </wrap>//<wrap>¬¬¬</wrap><wrap>¬</wrap> **//<wrap>8.152.3 Parameter</wrap>//** **<wrap>NO </wrap>**<wrap>No indicates that the SCSIMOUNT option is disabled and forcing all SCSI tape</wrap> <wrap>mounts to be done manually via an appropriate DEVINIT command.</wrap> **<wrap>YES </wrap>**<wrap>Yes enables the option and causes periodic queries of the SCSI tape drive in a five second interval to automatically detect when a tape is mounted. YES is equivalent with ‘SCSIMOUNT 5’.</wrap> **//<wrap>secs </wrap>//**<wrap>A value from 1 to 99 seconds inclusive enables the option and causes periodic queries of the SCSI tape drive every //secs //seconds to automatically detect when a tape is mounted.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 537</wrap> <wrap>\\ </wrap>**//<wrap>8.152.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Enable the SCSI tape mount option and display the current settings.</wrap> <wrap>HHC00013I Herc command: 'scsimount yes'</wrap> <wrap>HHC02204I scsimount set to yes \\ HHC00013I Herc command: 'scsimount'</wrap> <wrap>HHC02203I scsimount : 5</wrap> **<wrap>Figure 280: SCSIMOUNT command (enable SCSI tape mount option)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Enable the SCSIMOUNT option and query the SCSI tape drive every 15 seconds.</wrap> <wrap>HHC00013I Herc command: 'scsimount 15' \\ HHC02204I scsimount set to 15</wrap> **<wrap>Figure 281: SCSIMOUNT command (enable SCSI tape mount option and set interval)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 538</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.153 SF+ (Create a new shadow file) \\ //8.153.1 Function//</wrap>** <wrap>With the SF+ command a new shadow file for a certain dasd device (or for all dasd devices that have shadow files) is created.</wrap> **//<wrap>8.153.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SF+ (</wrap>//<wrap>device </wrap>//<wrap>| *}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SF+ ¬¬¬§¬¬¬ </wrap>//<wrap>devi__ce__</wrap>// <wrap>⡿¬¬¬¬¬*¬¬</wrap> **//<wrap>8.153.3 Parameter</wrap>//** **//<wrap>device </wrap>//**<wrap>This specifies the device for which a new shadow file will be created.</wrap> **<wrap>* </wrap>**<wrap>Specifying an asterisk it is possible to create a (new) shadow file for all dasd devices that have a shadow file defined in their configuration file definition statements.</wrap> **//<wrap>8.153.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Create a new shadow file for device 0148.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'sf+ 0148'</wrap> |<WRAP><wrap>HHC00320I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CCKD file[1] '</wrap>[[file:///D:/MVS/SHADOW/MVSRES_1.CCKD|<wrap>D:/MVS/SHADOW/MVSRES_1.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>shadow</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>succesfully</wrap> </WRAP> |<WRAP><wrap>added</wrap> </WRAP> | |<WRAP><wrap>HHC00333I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>size free nbr st reads writes</wrap> </WRAP> |<WRAP><wrap>l2reads</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>hits switches</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00335I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>0:0148 --------------------------------- </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00336I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[*] 21623269 0% 0 0 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>0 0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00338I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00339I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[0] 21621981 0% 0 rd 0 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00340I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/SHADOW/MVSRES_|<wrap>D:/MVS/SHADOW/MVSRES_</wrap>]]<wrap>*.CCKD</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00341I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[1] 1288 0% 0 rw 0 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 282: SF+ command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 539</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.154 SF- (Delete a shadow file) \\ //8.154.1 Function//</wrap>** <wrap>The SF- command removes a shadow file. Depending on the MERGE / NOMERGE / FORCE parameter the changes are incorporated in the base file or discarded.</wrap> <wrap>If MERGE is specified or defaulted then the contents of the current file is merged into the previous file, the current file is removed and the previous file becomes the current file.</wrap> <wrap>If NOMERGE is specified then the contents of the current file is discarded and the previous file becomes the current file. However if the previous file is read-only then a new shadow file is created ("re-added") and that becomes the current file.</wrap> <wrap>The FORCE option is required when doing a merge to a base file and the base file is read-only because the 'ro' option was specified on the device configuration statement.</wrap> **//<wrap>8.154.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>SF</wrap>****<wrap>- </wrap>****<wrap>(</wrap>****//<wrap>device </wrap>//****<wrap>| *} [</wrap>****__<wrap>MERGE</wrap>__****<wrap> | NOMERGE | FORCE]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>~¬¬¬¬MERGE¬¬¬¬®</wrap>** **<wrap>ÊÊ¬¬¬SF</wrap>****<wrap>- ¬¬¬§¬¬¬ </wrap>****//<wrap>device </wrap>//****<wrap>¬¬¬§¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>** **<wrap>⡿¬¬¬¬¬* ¬¬¬¬¬¬¯ ª¬¬¬ NOMERGE ¬¬¬«</wrap>** **<wrap>⡿¬¬¬¬FORCE¬¬¬¬¯</wrap>** **//<wrap>8.154.3 Parameter</wrap>//** **//<wrap>device </wrap>//**<wrap>This specifies the device for which a shadow file should be deleted.</wrap> **<wrap>* </wrap>**<wrap>Specifying an asterisk it is possible to remove a shadow file for all dasd devices that have shadow files.</wrap> **<wrap>MERGE </wrap>**<wrap>The MERGE parameter (which is the default) specifies that all changes or updates that have been made to the shadow file will be committed.</wrap> **<wrap>NOMERGE </wrap>**<wrap>The NOMERGE parameter specifies that all changes or updates that have been</wrap> <wrap>made to the shadow file will be discarded instead of being committed.</wrap> **<wrap>FORCE </wrap>**<wrap>The FORCE parameter is used when doing a merge to a base file that is read-only because the 'ro' option was specified on the device configuration statement.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 540</wrap> <wrap>\\ </wrap>**//<wrap>8.154.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Remove a shadow file for device 0148 with backwards merge (i.e. //commit //all of the changes/updates).</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'sf- 0148'</wrap> |<WRAP><wrap>HHC00325I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CCKD file[1] '</wrap>[[file:///D:/MVS/SHADOW/MVSRES_1.CCKD|<wrap>D:/MVS/SHADOW/MVSRES_1.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |||<WRAP><wrap>shadow file successfully merged</wrap> </WRAP> | | |<WRAP><wrap>HHC00333I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>size free nbr st</wrap> </WRAP> |<WRAP><wrap>reads</wrap> </WRAP> |<WRAP><wrap>writes</wrap> </WRAP> |<WRAP><wrap>l2reads hits</wrap> </WRAP> |<WRAP><wrap>switches</wrap> </WRAP> | |<WRAP><wrap>HHC00334I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>readaheads</wrap> </WRAP> |<WRAP><wrap>misses</wrap> </WRAP> | |<WRAP><wrap>HHC00335I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>0:0148 ------------------- </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00336I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[*] 21627652 0% 9</wrap> </WRAP> |<WRAP><wrap>881</wrap> </WRAP> |<WRAP><wrap>21</wrap> </WRAP> |<WRAP><wrap>14 712</wrap> </WRAP> |<WRAP><wrap>1520</wrap> </WRAP> | |<WRAP><wrap>HHC00337I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>74</wrap> </WRAP> |<WRAP><wrap>23</wrap> </WRAP> | |<WRAP><wrap>HHC00338I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00339I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[0] 21627652 0% 9 rw</wrap> </WRAP> |<WRAP><wrap>881</wrap> </WRAP> |<WRAP><wrap>21</wrap> </WRAP> |<WRAP><wrap>14</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00340I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/SHADOW/MVSRES_|<wrap>D:/MVS/SHADOW/MVSRES_</wrap>]]<wrap>*.CCKD</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 283: SF- command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Remove a shadow file for device 0148 without backwards merge (i.e. //discard //all of the changes/updates).</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'sf- 0148 nomerge'</wrap> |<WRAP><wrap>HHC00325I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CCKD file[1] '</wrap>[[file:///D:/MVS/SHADOW/MVSRES_1.CCKD|<wrap>D:/MVS/SHADOW/MVSRES_1.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>shadow file successfully</wrap> </WRAP> |<WRAP><wrap>removed</wrap> </WRAP> | |<WRAP><wrap>HHC00333I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>size free nbr st reads writes</wrap> </WRAP> |<WRAP><wrap>l2reads hits switches</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00334I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>readaheads misses</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00335I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>0:0148 --------------------------------- </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00336I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[*] 21627652 0% 9 883 20</wrap> </WRAP> |<WRAP><wrap>14 715 1520</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00337I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>79 25</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00338I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00339I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[0] 21627652 0% 9 rw 883 20</wrap> </WRAP> |<WRAP><wrap>14</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00340I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/SHADOW/MVSRES_|<wrap>D:/MVS/SHADOW/MVSRES_</wrap>]]<wrap>*.CCKD</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 284: SF- NOMERGE command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 541</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.155 SFC (Compress a shadow file) \\ //8.155.1 Function//</wrap>** <wrap>The SFC command compresses a shadow file.</wrap> **//<wrap>8.155.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SFC (</wrap>//<wrap>device </wrap>//<wrap>|*}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SFC ¬¬¬§¬¬¬ </wrap>//<wrap>devi__ce__</wrap>// <wrap>⡿¬¬¬¬¬*¬¬</wrap> **//<wrap>8.155.3 Parameter</wrap>//** **//<wrap>device </wrap>//**<wrap>This specifies the device for which the shadow file will be compressed.</wrap> **<wrap>* </wrap>**<wrap>Specifying an asterisk it is possible to compress the shadow files for all DASD devices that have a shadow file.</wrap> **//<wrap>8.155.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Compress the shadow file for dasd device 0148.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'sfc 0148'</wrap> |<WRAP><wrap>HHC00358I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CCKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> ||<WRAP><wrap>file already compressed</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00333I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>size free nbr st</wrap> </WRAP> |<WRAP><wrap>reads</wrap> </WRAP> |<WRAP><wrap>writes</wrap> </WRAP> |<WRAP><wrap>l2reads hits</wrap> </WRAP> |<WRAP><wrap>switches</wrap> </WRAP> | |<WRAP><wrap>HHC00334I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>readaheads</wrap> </WRAP> |<WRAP><wrap>misses</wrap> </WRAP> | |<WRAP><wrap>HHC00335I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>0:0148 ------------------- </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00336I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[*] 21631751 0% 9</wrap> </WRAP> |<WRAP><wrap>885</wrap> </WRAP> |<WRAP><wrap>425</wrap> </WRAP> |<WRAP><wrap>15 715</wrap> </WRAP> |<WRAP><wrap>1522</wrap> </WRAP> | |<WRAP><wrap>HHC00337I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>79</wrap> </WRAP> |<WRAP><wrap>25</wrap> </WRAP> | |<WRAP><wrap>HHC00338I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00339I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[0] 21627652 0% 9 rd</wrap> </WRAP> |<WRAP><wrap>884</wrap> </WRAP> |<WRAP><wrap>20</wrap> </WRAP> |<WRAP><wrap>15</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00340I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/SHADOW/MVSRES_|<wrap>D:/MVS/SHADOW/MVSRES_</wrap>]]<wrap>*.CCKD</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00341I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[1] 4099 0% 0 rw</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>405</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 285: SFC command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 542</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.156 SFD (Display shadow file statistics) \\ //8.156.1 Function//</wrap>** <wrap>The SFD command displays statistical information about the specified shadow file(s).</wrap> **//<wrap>8.156.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SF0 (</wrap>//<wrap>device </wrap>//<wrap>|*}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SF0 </wrap><wrap>¬¬¬§¬¬¬ </wrap>//<wrap>devi__ce__</wrap>// <wrap>⡿¬¬¬¬¬*¬¬</wrap> **//<wrap>8.156.3 Parameter</wrap>//** **//<wrap>device </wrap>//**<wrap>This specifies the device for which shadow file statistics will be written to the log file.</wrap> **<wrap>* </wrap>**<wrap>Specifying an asterisk it is possible to create statistical output for all dasd devices that have shadow files.</wrap> **//<wrap>8.156.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display statistical information for the shadow file of dasd device 0148.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'sfd 0148'</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00333I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>size free nbr st</wrap> </WRAP> |<WRAP><wrap>reads</wrap> </WRAP> |<WRAP><wrap>writes</wrap> </WRAP> |<WRAP><wrap>l2reads</wrap> </WRAP> |<WRAP><wrap>hits</wrap> </WRAP> |<WRAP><wrap>switches</wrap> </WRAP> | |<WRAP><wrap>HHC00334I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>readaheads</wrap> </WRAP> ||<WRAP><wrap>misses</wrap> </WRAP> | |<WRAP><wrap>HHC00335I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>0:0148 ------------------- </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00336I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[*] 21632514 0% 10</wrap> </WRAP> |<WRAP><wrap>885</wrap> </WRAP> |<WRAP><wrap>424</wrap> </WRAP> |<WRAP><wrap>15</wrap> </WRAP> |<WRAP><wrap>715</wrap> </WRAP> |<WRAP><wrap>1522</wrap> </WRAP> | |<WRAP><wrap>HHC00337I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>79</wrap> </WRAP> |<WRAP><wrap>25</wrap> </WRAP> | |<WRAP><wrap>HHC00338I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00339I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[0] 21627652 0% 9 rd</wrap> </WRAP> |<WRAP><wrap>884</wrap> </WRAP> |<WRAP><wrap>20</wrap> </WRAP> |<WRAP><wrap>15</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00340I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/SHADOW/MVSRES_|<wrap>D:/MVS/SHADOW/MVSRES_</wrap>]]<wrap>*.CCKD</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00341I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[1] 4862 15% 1 rw</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>404</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 286: SFD command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 543</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.157 SFK (Perform a chkdsk on the active shadow file) //8.157.1 Function//</wrap>** <wrap>The SFK command performs a chkdsk on the active shadow file(s).</wrap> **//<wrap>8.157.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SFK (</wrap>//<wrap>device </wrap>//<wrap>| *} [</wrap>//<wrap>n</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SFK ¬¬¬§¬¬¬ </wrap>//<wrap>devi__ce __</wrap>//__<wrap>¬¬¬§¬¬¬§¬¬¬¬¬</wrap>__<wrap></wrap> <wrap>⡿¬¬¬¬¬*¬¬¬¬¬¬ ⡿¬¬¬</wrap>//<wrap>n</wrap>// **//<wrap>8.157.3 Parameter</wrap>//** **//<wrap>device </wrap>//**<wrap>This specifies the device for which active shadow file a chkdsk is to be performed.</wrap> **<wrap>* </wrap>**<wrap>Specifiying an asterisk it is possible to perform a chkdsk for the active shadow files of all dasd devices.</wrap> **//<wrap>n </wrap>//**<wrap>The optional check level to be performed (default is 2):</wrap> <wrap>-1 devhdr, cdevhdr, I1 table</wrap> <wrap>0 devhdr, cdevhdr, I1 table, I2 tables</wrap> <wrap>1 devhdr, cdevhdr, I1 table, I2 tables, free spaces</wrap> <wrap>2 devhdr, cdevhdr, I1 table, I2 tables, free spaces, trkhdrs</wrap> <wrap>3 devhdr, cdevhdr, I1 table, I2 tables, free spaces, trkimgs</wrap> <wrap>4 devhdr, cdevhdr, build everything else from recovery</wrap> <wrap>Use the check level '4' only after making a backup and be prepared to wait a long time!</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 544</wrap> <wrap>\\ </wrap>**//<wrap>8.157.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Perform chkdsk level '2' for the shadow file of dasd device 0148.</wrap> |<WRAP><wrap>HHC00013I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'sfk 0148 2'</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00333I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>size free nbr</wrap> </WRAP> |<WRAP><wrap>st</wrap> </WRAP> |<WRAP><wrap>reads</wrap> </WRAP> |<WRAP><wrap>writes</wrap> </WRAP> |<WRAP><wrap>l2reads</wrap> </WRAP> |<WRAP><wrap>hits</wrap> </WRAP> |<WRAP><wrap>switches</wrap> </WRAP> | |<WRAP><wrap>HHC00334I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>readaheads</wrap> </WRAP> ||<WRAP><wrap>misses</wrap> </WRAP> | |<WRAP><wrap>HHC00335I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>0:0148 --------------- </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00336I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[*] 21632514 0% 10</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>886</wrap> </WRAP> |<WRAP><wrap>426</wrap> </WRAP> |<WRAP><wrap>16</wrap> </WRAP> |<WRAP><wrap>715</wrap> </WRAP> |<WRAP><wrap>1523</wrap> </WRAP> | |<WRAP><wrap>HHC00337I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>79</wrap> </WRAP> |<WRAP><wrap>25</wrap> </WRAP> | |<WRAP><wrap>HHC00338I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00339I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[0] 21627652 0% 9</wrap> </WRAP> |<WRAP><wrap>rd</wrap> </WRAP> |<WRAP><wrap>884</wrap> </WRAP> |<WRAP><wrap>20</wrap> </WRAP> |<WRAP><wrap>15</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00340I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/SHADOW/MVSRES_|<wrap>D:/MVS/SHADOW/MVSRES_</wrap>]]<wrap>*.CCKD</wrap> </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00341I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[1] 4862 15% 1</wrap> </WRAP> |<WRAP><wrap>rw</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>406</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 287: SFK command (chkdsk level 2)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Perform chkdsk level '4' for the shadow file of dasd device 0148.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'sfk 0148 4'</wrap> |<WRAP><wrap>HHC00372I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CCKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>trk[10320] recovered offset 0x1003</wrap> </WRAP> |<WRAP><wrap>len</wrap> </WRAP> |<WRAP><wrap>763</wrap> </WRAP> | |<WRAP><wrap>HHC00373I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CCKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>1 trk images recovered</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00377I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CCKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>free space rebuilt</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00333I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>size free nbr st reads</wrap> </WRAP> |<WRAP><wrap>writes l2reads hits switches</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00334I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>readaheads misses</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00335I</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>0:0148 -------------------------- </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00336I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[*] 21632514 0% 10 886</wrap> </WRAP> |<WRAP><wrap>426 16 715 1523</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00337I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>79 25</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00338I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00339I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[0] 21627652 0% 9 rd 884</wrap> </WRAP> |<WRAP><wrap>20 15</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00340I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP>[[file:///D:/MVS/SHADOW/MVSRES_|<wrap>D:/MVS/SHADOW/MVSRES_</wrap>]]<wrap>*.CCKD</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00341I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>[1] 4862 15% 1 rw 2</wrap> </WRAP> |<WRAP><wrap>406 1</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 288: SFK command (chkdsk level 4)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 545</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.158 SH (Shell command) \\ //8.158.1 Function//</wrap>** <wrap>The SH command passes the given command and the parameters (if any) as-is to the shell for process-sing. The results of the passed command are displayed on the Hercules console.</wrap> <wrap>The special ‘STARTGUI’ command must be used if the command being started either directly or indirectly starts a Windows graphical user interface (non command-line) program (e.g. Notepad). If STARTGUI is not used in such cases then Hercules will hang until the graphical user interface program is closed. Note that starting a batch file (command line program) that itself starts a graphical user interface program still requires using STARTGUI.</wrap> <wrap>If “foo.bat” contains “start notepad.exe” then issuing “sh foo.bat” will hang Hercules until Notepad is being closed. The same applies if “sh start foo.bat” is used. The correct way is using ‘STARTGUI’ for invoking foo.bat is “sh startgui foo.bat”.</wrap> **//<wrap>8.158.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SH [STARTGUI] </wrap>//<wrap>command </wrap>//<wrap>[</wrap>//<wrap>arg </wrap>//<wrap>[</wrap>//<wrap>arg </wrap>//<wrap>... ]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_SH%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%_ </wrap>//<wrap>command </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬ÊÍ</wrap> <wrap>⡿%%__%%_ STARTGUI %%__%%_¯ ~%%__%%%%__%%%%__%%%%__%%%%__%%_® </wrap> <wrap>⡿%%__%%_°%%__%%_ </wrap>//<wrap>arg </wrap>//<wrap>%%__%%_¨%%__%%_¯</wrap> **//<wrap>8.158.3 Parameter</wrap>//** **<wrap>STARTGUI </wrap>**<wrap>STARTGUI must be used if the command passed to the shell either directly or indirectly starts a Windows graphical user interface (non command-line) program.</wrap> **//<wrap>command </wrap>//**<wrap>The command that is to be passed to the shell.</wrap> **//<wrap>arg </wrap>//**<wrap>These are the parameters passed to the command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 546</wrap> <wrap>\\ </wrap>**//<wrap>8.158.4 Examples</wrap>//** <wrap>Example 1:</wrap> <wrap>Display the current working directory through the shell command 'DIR'.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'sh dir' \\ Volume in drive D is Hercules \\ Volume Serial Number is E21F-FE83</wrap> |<WRAP><wrap>Directory</wrap> <wrap>13.10.2010</wrap> <wrap>13.10.2010</wrap> </WRAP> |<WRAP><wrap>of </wrap>[[file:///D:/hercules|<wrap>D:%%\%%hercules</wrap>]]<wrap></wrap> <wrap>21:23 <DIR></wrap> <wrap>21:23 <DIR></wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>.</wrap> <wrap>..</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>282'624</wrap> </WRAP> |<WRAP><wrap>AWSBrowse32.exe</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>503'808</wrap> </WRAP> |<WRAP><wrap>AWSBrowse32D.exe</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>274'432</wrap> </WRAP> |<WRAP><wrap>AWSBrowse32U.exe</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>491'520</wrap> </WRAP> |<WRAP><wrap>AWSBrowse32UD.exe</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:24</wrap> </WRAP> |||<WRAP><wrap>323'072</wrap> </WRAP> |<WRAP><wrap>AWSBrowse64.exe</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:24</wrap> </WRAP> |||<WRAP><wrap>647'168</wrap> </WRAP> |<WRAP><wrap>AWSBrowse64D.exe</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:24</wrap> </WRAP> |||<WRAP><wrap>317'440</wrap> </WRAP> |<WRAP><wrap>AWSBrowse64U.exe</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:24</wrap> </WRAP> |||<WRAP><wrap>636'416 AWSBrowse64UD.exe</wrap> </WRAP> ||| | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>934</wrap> </WRAP> |<WRAP><wrap>awshet.reg</wrap> </WRAP> || | |<WRAP><wrap>12.10.2010</wrap> </WRAP> |<WRAP><wrap>18:24</wrap> </WRAP> |||<WRAP><wrap>14'336</wrap> </WRAP> |<WRAP><wrap>cckdcdsk.exe</wrap> </WRAP> || | |<WRAP><wrap>12.10.2010</wrap> </WRAP> |<WRAP><wrap>18:24</wrap> </WRAP> |||<WRAP><wrap>13'824</wrap> </WRAP> |<WRAP><wrap>cckdcomp.exe</wrap> </WRAP> || | |<WRAP><wrap>12.10.2010</wrap> </WRAP> |<WRAP><wrap>18:24</wrap> </WRAP> |||<WRAP><wrap>73'728</wrap> </WRAP> |<WRAP><wrap>cckddiag.exe</wrap> </WRAP> || | |<WRAP><wrap>12.10.2010</wrap> </WRAP> |<WRAP><wrap>18:24</wrap> </WRAP> |||<WRAP><wrap>15'360</wrap> </WRAP> |<WRAP><wrap>cckdswap.exe</wrap> </WRAP> || | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> || | |<WRAP>//<wrap>several lines not displayed</wrap>// </WRAP> ||||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> || | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>131'072</wrap> </WRAP> |<WRAP><wrap>TunTap32.dll</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>344'064</wrap> </WRAP> |<WRAP><wrap>TunTap32D.dll</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>135'168</wrap> </WRAP> |<WRAP><wrap>TunTap32U.dll</wrap> </WRAP> || | |<WRAP><wrap>16.12.2007</wrap> </WRAP> |<WRAP><wrap>01:00</wrap> </WRAP> |||<WRAP><wrap>344'064</wrap> </WRAP> |<WRAP><wrap>TunTap32UD.dll</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:27</wrap> </WRAP> |||<WRAP><wrap>144'384</wrap> </WRAP> |<WRAP><wrap>TunTap64.dll</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:27</wrap> </WRAP> |||<WRAP><wrap>561'664</wrap> </WRAP> |<WRAP><wrap>TunTap64D.dll</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:27</wrap> </WRAP> |||<WRAP><wrap>147'456</wrap> </WRAP> |<WRAP><wrap>TunTap64U.dll</wrap> </WRAP> || | |<WRAP><wrap>28.02.2007</wrap> </WRAP> |<WRAP><wrap>06:27</wrap> </WRAP> |||<WRAP><wrap>565'760</wrap> </WRAP> |<WRAP><wrap>TunTap64UD.dll</wrap> </WRAP> || | |<WRAP><wrap>13.06.2010</wrap> </WRAP> |<WRAP><wrap>22:04 <DIR></wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>util</wrap> </WRAP> || | |<WRAP><wrap>12.10.2010</wrap> </WRAP> |<WRAP><wrap>18:24</wrap> </WRAP> |||<WRAP><wrap>19'968</wrap> </WRAP> |<WRAP><wrap>vmfplc2.exe</wrap> </WRAP> || | |<WRAP><wrap>13.10.2010</wrap> </WRAP> |<WRAP><wrap>21:23</wrap> </WRAP> |||<WRAP><wrap>8'157</wrap> </WRAP> |<WRAP><wrap>x.log</wrap> </WRAP> || | |<WRAP><wrap>20.07.2005</wrap> </WRAP> |<WRAP><wrap>11:48</wrap> </WRAP> |||<WRAP><wrap>59'904</wrap> </WRAP> |<WRAP><wrap>zlib1.dll</wrap> </WRAP> || | |<WRAP><wrap>127</wrap> </WRAP> ||<WRAP><wrap>File(s)</wrap> </WRAP> |<WRAP><wrap>24'988'911</wrap> </WRAP> |||<WRAP><wrap>bytes</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>5</wrap> </WRAP> ||<WRAP><wrap>Dir(s)</wrap> </WRAP> |<WRAP><wrap>67'712'364'544</wrap> </WRAP> |||<WRAP><wrap>bytes</wrap> </WRAP> |<WRAP><wrap>free</wrap> </WRAP> | | | | | | | | | | **<wrap>Figure 289: SH command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 547</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.159 SHCMDOPT (Display or set shell command option) //8.159.1 Function//</wrap>** <wrap>The SHCMDOPT console command specifies the behaviour of the shell (sh) command. It defines if shell commands (sh) are globally enabled or disabled either directly via the Hercules hardware console or programmatically via the DIAG8CMD interface. Given without an argument SHCMDOPT displays the current setting.</wrap> **//<wrap>8.159.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>SHCMD0PT </wrap>****<wrap>[</wrap>****<wrap>DISABLE | ENABLE </wrap>****<wrap>[</wrap>****__<wrap>DIAG8</wrap>__****<wrap> | N0DIAG8</wrap>****<wrap>]]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ%%__%%_SHCMD0PT%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%ÊÍ I</wrap>****<wrap>¬¬¬ </wrap>****<wrap>DISABLE </wrap>****<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«</wrap>** **<wrap> ~%%__%%%%__%% DIAG8 %%__%%%%__%%® \\ ⡿%%__%%_ ENABLE %%__%%_¦%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_¦%%__%%_¯</wrap>** **<wrap>⡿%%__%%_N0DIAG8%%__%%_¯</wrap>** **//<wrap>8.159.3 Parameter</wrap>//** **<wrap>DISABLE </wrap>**<wrap>When set to DISABLE, shell commands (sh) are globally disabled and will result in an error if entered either directly via the Hercules hardware console or programmatically via the DIAG8CMD interface.</wrap> **<wrap>ENABLE </wrap>**<wrap>When set to ENABLE, shell commands (sh) are globally enabled either directly via the Hercules hardware console or programmatically via the DIAG8CMD interface. This is the default.</wrap> **<wrap>DIAG8 </wrap>**<wrap>When DIAG8 is specified (which is the default) the programmatic execution of shell commands (sh) via the DIAG8CMD interface is enabled. This is the default.</wrap> **<wrap>NODIAG8 </wrap>**<wrap>When NODIAG8 is specified only the programmatic execution of shell commands via the DIAG8CMD interface is disabled; shell commands (sh) entered directly via the Hercules hardware console will still work.</wrap> **<wrap>NOTE: </wrap>**//<wrap>"entered directly via the Hercules hardware console" </wrap>//<wrap>includes commands entered via the HTTP server facility or entered via "run command" (.rc) scripts.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 548</wrap> <wrap>\\ </wrap>**//<wrap>8.159.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current shell command option setting.</wrap> <wrap>HHC00013I Herc command: 'shcmdopt'</wrap> <wrap>HHC02203I shcmdopt : Enabled</wrap> **<wrap>Figure 290: SHCMDOPT command (display current shell command options)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Disable the the programmatic execution of shell commands via the DIAG8CMD interface, while still allowing shell commands (sh) entered directly via the Hercules hardware console.</wrap> <wrap>HHC00013I Herc command: 'shcmdopt enable nodiag8'</wrap> <wrap>HHC02204I shcmdopt set to Enabled NoDiag8</wrap> **<wrap>Figure 291: SHCMDOPT command (change shell command options)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 549</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.160 SHOWDVOL1 (Display or set enable showing of DASD volsers in device list)</wrap>** **//<wrap>8.160.1 Function</wrap>//** <wrap>SHOWDVOL1 indicates whether to show the DASD VOL1 labels (volser) in the device list display. 'YES' shows the volser in addition to the usual filename, whereas 'NO' shows the device list in a traditional filename only format. The 'ONLY' option shows only the volser; the filename is not shown at all. Enter the command without any operands to display the current setings on the console. Note: This console command is only available if Hercules is built with “OPTION_SHOWDVOL1”.</wrap> **//<wrap>8.160.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SHOWDVOL1 </wrap><wrap>[</wrap><wrap>NO | YES | ONLY]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>SHOWDVOL1 </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬</wrap><wrap>¬¬ </wrap><wrap>NO </wrap><wrap>¬¬¬¬¬«</wrap> <wrap>ª¬</wrap><wrap>¬¬ </wrap><wrap>YES </wrap><wrap>¬¬¬¬«</wrap> <wrap>⡿¬¬¬ ONLY ¬¬¬¯</wrap> **//<wrap>8.160.3 Parameter</wrap>//** **<wrap>NO </wrap>**<wrap>NO shows the device list in the traditional filename only format. This is the default.</wrap> **<wrap>YES </wrap>**<wrap>YES shows the volser in addition to the usual filename.</wrap> **<wrap>ONLY </wrap>**<wrap>ONLY shows only the volser, the filename is not shown at all.</wrap> **//<wrap>8.160.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Show the DASD VOL1 labels (volser) in the device list.</wrap> <wrap>HHC00013I Herc command: 'showdvol1 yes'</wrap> <wrap>HHC02204I showdvol1 set to YES</wrap> **<wrap>Figure 292: SHOWDVOL command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 550</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.161 SHRD (Display or set shared device server trace) //8.161.1 Function//</wrap>** <wrap>The SHRD command has two functions. Depending on the given arguments it initializes the shared device server trace table and starts the trace or it displays the contents of the current trace table.</wrap> **//<wrap>8.161.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>SHRD TRACE[</wrap>//<wrap>=n</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SHRD ¬¬¬ TRACE</wrap> //<wrap>=n</wrap>// **//<wrap>8.161.3 Parameter</wrap>//** **<wrap>TRACE </wrap>**<wrap>Keyword TRACE, when specified without a decimal number, displays the current contents of the trace table.</wrap> **//<wrap>n </wrap>//**<wrap>This specifies the trace table size (decimal). If the TRACE argument is given with a \\ number then a trace table with a size of //n //elements initialized.</wrap> **//<wrap>8.161.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Initialize the shared device server trace table with a size of 2500 trace entries.</wrap> <wrap>HHC00013I Herc command: 'shrd trace=2500'</wrap> **<wrap>Figure 293: SHRD command (initialize shared device server trace table)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 551</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Print the Shared Device Server trace table.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'shrd trace'</wrap> <wrap>HHC00743I Shared: 1290125714.658483 0148:start cur 5966 cache 150 \\ HHC00743I Shared: 1290125714.658486 0148:client_request e2 00 148 1 \\ HHC00743I Shared: 1290125714.658490 0148:client_send e2 00 148 1 0</wrap> <wrap> HHC00743I Shared: 1290125714.658543 0000:recvData 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.658548 0148:client_recv 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.658551 0148:client_response 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.658559 0148:ckd_read trk 5940</wrap> <wrap>HHC00743I Shared: 1290125714.658566 0148:ckd_read trk 5940 cache hit 205 \\ HHC00743I Shared: 1290125714.658576 0148:end cur 5940 cache 205 \\ HHC00743I Shared: 1290125714.658579 0148:client_request e3 00 148 1 \\ HHC00743I Shared: 1290125714.658582 0148:client_send e3 00 148 1 0</wrap> <wrap> HHC00743I Shared: 1290125714.658645 0000:recvData 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.658649 0148:client_recv 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.658652 0148:client_response 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659060 0148:start cur 5940 cache 205 \\ HHC00743I Shared: 1290125714.659063 0148:client_request e2 00 148 1 \\ HHC00743I Shared: 1290125714.659067 0148:client_send e2 00 148 1 0</wrap> <wrap> HHC00743I Shared: 1290125714.659121 0000:recvData 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659126 0148:client_recv 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659128 0148:client_response 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659134 0148:ckd_read trk 2550</wrap> <wrap>HHC00743I Shared: 1290125714.659138 0148:ckd_read trk 2550 cache hit 107 \\ HHC00743I Shared: 1290125714.659149 0148:end cur 2550 cache 107 \\ HHC00743I Shared: 1290125714.659152 0148:client_request e3 00 148 1 \\ HHC00743I Shared: 1290125714.659155 0148:client_send e3 00 148 1 0</wrap> <wrap> HHC00743I Shared: 1290125714.659209 0000:recvData 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659213 0148:client_recv 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659216 0148:client_response 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659654 0148:start cur 2550 cache 107 \\ HHC00743I Shared: 1290125714.659657 0148:client_request e2 00 148 1 \\ HHC00743I Shared: 1290125714.659660 0148:client_send e2 00 148 1 0</wrap> <wrap> HHC00743I Shared: 1290125714.659720 0000:recvData 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659724 0148:client_recv 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659727 0148:client_response 00 00 148 1 0 \\ HHC00743I Shared: 1290125714.659733 0148:ckd_read trk 2553</wrap> <wrap>HHC00743I Shared: 1290125714.659738 0148:ckd_read trk 2553 cache miss -1 \\ HHC00743I Shared: 1290125714.659744 0148:client_send e8 00 148 1 4</wrap> <wrap> HHC00743I Shared: 1290125714.659845 0000:recvData 10 15 148 1 6541</wrap> <wrap> HHC00743I Shared: 1290125714.660025 0000:recvData 00 00 148 1 11957 (uncompressed)</wrap> <wrap>HHC00743I Shared: 1290125714.660030 0148:client_recv 00 00 148 1 11957 \\ HHC00743I Shared: 1290125714.660045 0148:end cur 2553 cache 172 \\ HHC00743I Shared: 1290125714.660049 0148:client_request e3 00 148 1 \\ HHC00743I Shared: 1290125714.660052 0148:client_send e3 00 148 1 0</wrap> <wrap> HHC00743I Shared: 1290125714.660111 0000:recvData 00 00 148 1 0</wrap> <wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 294: SHRD command (display shared device server trace table)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 552</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.162 SHRDPORT (Set shared device server port) \\ //8.162.1 Function//</wrap>** <wrap>The SHRDPORT command defines the port number (in decimal) on which the shared device server will listen and starts or stops the shared device server. The shared device server will allow other Hercules instances to access devices on this instance. Currently only DASD devices may be shared.</wrap> **//<wrap>8.162.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SHRDPORT </wrap>//<wrap>[port </wrap>//<wrap>| START | STOP]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SHRDPORT ¬¬¬§¬¬¬ </wrap>//<wrap>port ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>// <wrap>F¬</wrap>//<wrap>¬¬ </wrap>//<wrap>START </wrap>//<wrap>¬¬¬«</wrap>// <wrap>i¬¬¬ STOP ¬¬¬¬</wrap> **//<wrap>8.162.3 Parameter</wrap>//** **//<wrap>port </wrap>//**<wrap>This is the port number for the shared device server. Any valid port number can be specified. Specifying a port number starts the shared device server. It is not necessary to issue an explicit start command.</wrap> **<wrap>START </wrap>**<wrap>Starts the shared device server if it is in the stopped state.</wrap> **<wrap>STOP </wrap>**<wrap>Stops the shared device server if it is in the started state.</wrap> **//<wrap>8.162.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Start the shared device server.</wrap> <wrap>HHC00013I Herc command: 'shrdport start'</wrap> <wrap>HHC00100I Thread id 000003E8, prio 0, name 'Shared device server 0.1' started</wrap> <wrap>HHC00737I Shared: waiting for shared device requests on port 3000</wrap> **<wrap>Figure 295: SHRDPORT command (start the shared device server)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 553</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Set the port number for the shared device server to 3999. To change the port number the shared device server has first to be stopped.</wrap> <wrap>20:05:26 HHC00013I Herc command: 'shrdport stop'</wrap> <wrap>20:05:37 HHC00013I Herc command: 'shrdport 3999'</wrap> <wrap>20:05:37 HHC00100I Thread id 00000BD0, prio 0, name 'Shared device server 0.1' started</wrap> <wrap>20:05:37 HHC00737I Shared: waiting for shared device requests on port 3999</wrap> **<wrap>Figure 296: SHRDPORT command (set port number)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 554</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.163 SIZEOF (Display size of structures) \\ //8.163.1 Function//</wrap>** <wrap>The SIZEOF command shows the size of various Hercules internal structures.</wrap> **//<wrap>8.163.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>SIZE0F</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ SIZE0F</wrap>** **//<wrap>8.163.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.163.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the size of internal structures.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'sizeof'</wrap> |<WRAP><wrap>HHC02257I (unsigned short) </wrap> <wrap>HHC02257I (void *) ........ </wrap> <wrap>HHC02257I (unsigned int) .. </wrap> <wrap>HHC02257I (long) ......... </wrap> <wrap>HHC02257I (long long) ..... </wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> </WRAP> |<WRAP><wrap>2 \\ 4 \\ 4 \\ 4 \\ 8</wrap> </WRAP> | |<WRAP><wrap>HHC02257I REGS (copy len) . </wrap> </WRAP> |<WRAP><wrap>1584</wrap> </WRAP> | |<WRAP><wrap>HHC02257I PSW ............ </wrap> </WRAP> |<WRAP><wrap>40</wrap> </WRAP> | |<WRAP><wrap>HHC02257I DEVBLK .......... </wrap> </WRAP> |<WRAP><wrap>3096</wrap> </WRAP> | |<WRAP><wrap>HHC02257I TLB entry ....... </wrap> </WRAP> |<WRAP><wrap>36</wrap> </WRAP> | |<WRAP><wrap>HHC02257I TLB table ....... </wrap> </WRAP> |<WRAP><wrap>36864</wrap> </WRAP> | |<WRAP><wrap>HHC02257I CPU_BITMAP ...... </wrap> </WRAP> |<WRAP><wrap>4</wrap> </WRAP> | |<WRAP><wrap>HHC02257I STFL_BYTESIZE ... </wrap> </WRAP> |<WRAP><wrap>10</wrap> </WRAP> | **<wrap>Figure 297: SIZEOF command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 555</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.164 SRVPRIO (Display or set server threads process priority) //8.164.1 Function//</wrap>** <wrap>The SRVPRIO command is used to change the priority of the server threads. See section 5.82 for details on process and thread priorities. Given without an argument the SRVPRIO command displays the current server threads process priority.</wrap> **<wrap>Caution: </wrap>**<wrap>SRVPRIO should not have a higher dispatching priority than the TOD clock and timer thread.</wrap> **//<wrap>8.164.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>SRVPRI0 </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>SRVPRI0</wrap> //<wrap>nn</wrap>// **//<wrap>8.164.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This value specifies the process priority for the server threads. For details on the priority values see section 5.82 (“Process and Thread Priorities”).</wrap> **//<wrap>8.164.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the server threads process priority to 0.</wrap> <wrap>HHC00013I Herc command: 'srvprio 0'</wrap> <wrap>HHC02204I srvprio set to 0</wrap> **<wrap>Figure 298: SRVPRIO command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 556</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.165 SSD (Signal shutdown) \\ //8.165.1 Function//</wrap>** <wrap>The SSD (signal shutdown) command signals an imminent hypervisor shutdown to the guest. Guests who support this are supposed to perform a shutdown upon receiving this request.</wrap> <wrap>An implicit ssd command is given on a hercules QUIT or EXIT command if the guest supports SSD. In that case Hercules shutdown will be delayed until the guest has shutdown.</wrap> <wrap>The SSD command acts different depending on how Hercules was built. If Hercules was not built with option 'OPTION_SHUTDOWN_CONFIRMATION' (#UNDEF in file feature.h) then the command acts as described above.</wrap> <wrap>If Hercules however was built with option “OPTION_SHUTDOWN_CONFIRMATION” then a special processing for SSD takes place.</wrap> <wrap>If SSD is entered and the command level is not set to 'developer', 'debug' or 'all' then SSD first issues message HHC02266A that prompts for confirmation by entering a second SSD command within a certain time period (default 10 seconds) to signal the hypervisor shutdown. If the time period has expired then the process starts over. This is to prevent an inadvertent shutdown of a running guest OS.</wrap> <wrap>The time period for the second SSD command can be set to another value by using the 'QUITMOUT' console command or configuration statement.</wrap> <wrap>If the command level is set to 'developer', 'debug' or 'all' then SSD immediately signals the hypervisor shutdown. 'SSD FORCE' also performs an immediate signal shutdown without any further checks.</wrap> **//<wrap>8.165.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>SSD </wrap><wrap>[</wrap><wrap>FORCE</wrap><wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>SSD </wrap><wrap>¬</wrap> <wrap>FORCE</wrap> **//<wrap>8.165.3 Parameter</wrap>//** **<wrap>FORCE </wrap>**<wrap>Perform the signal shutdown immediately.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 557</wrap> <wrap>\\ </wrap>**//<wrap>8.165.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Signal an imminent hypervisor shutdown to the guest operating system.</wrap> <wrap>HHC00013I Herc command: 'ssd'</wrap> <wrap>HHC02266A Confirm command by entering 'ssd' again within 10 seconds</wrap> <wrap>HHC00013I Herc command: 'ssd'</wrap> **<wrap>Figure 299: SSD command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Signal an immediate imminent hypervisor shutdown to the guest operating system.</wrap> <wrap>HHC00013I Herc command: 'ssd force'</wrap> **<wrap>Figure 300: SSD FORCE command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 558</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.166 START (Start CPU or printer / punch device) \\ //8.166.1 Function//</wrap>** <wrap>The START command by itself (without argument) simply starts a stopped CPU, whereas START //devicenum //presses the (virtual) start button on printer or punch device //devicenum//.</wrap> **//<wrap>8.166.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>START [</wrap>//<wrap>devicenum</wrap>////<wrap>]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬START ¬¬¬i¬</wrap> //<wrap>devicenum</wrap>// **//<wrap>8.166.3 Parameter</wrap>//** **//<wrap>devicenum </wrap>//**<wrap>The device number of the printer or punch device which should be started.</wrap> **//<wrap>8.166.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Start the printer device 000E.</wrap> <wrap>HHC00013I Herc command: 'start 000e' \\ HHC02212I 0:000E device started</wrap> **<wrap>Figure 301: START command (start printer)</wrap>** **<wrap>Example 2: \\ </wrap>**<wrap>Start CPU 1.</wrap> <wrap>HHC00013I Herc command: 'cpu 1'</wrap> <wrap>HHC00013I Herc command: 'start'</wrap> <wrap>HHC00834I Processor CP01: running state selected</wrap> **<wrap>Figure 302: START command (start CPU)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 559</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.167 STARTALL (Start all CPUs) \\ //8.167.1 Function//</wrap>** <wrap>The STARTALL command starts all CPUs.</wrap> **//<wrap>8.167.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>STAR</wrap><wrap>TALL</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ STARTALL</wrap> **//<wrap>8.167.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.167.4 Examples</wrap>//** **<wrap>Example 1: \\ </wrap>**<wrap>Start all CPU’s.</wrap> <wrap>HHC00013I Herc command: 'startall'</wrap> **<wrap>Figure 303: STARTALL command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 560</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.168 STOP (Stop CPU or printer / punch device) \\ //8.168.1 Function//</wrap>** <wrap>The STOP command by itself (without argument) simply stops a started CPU, whereas STOP //devicenum //presses the (virtual) stop button on printer or punch device //devicenum//</wrap> **//<wrap>8.168.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>STOP [</wrap>//<wrap>devicenum</wrap>////<wrap>]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬</wrap>//<wrap>¬STOP ¬¬¬i¬</wrap> //<wrap>devicenum</wrap>// **//<wrap>8.168.3 Parameter</wrap>//** **//<wrap>devicenum </wrap>//**<wrap>The device number of the printer or punch device which should be stopped-</wrap><wrap></wrap> **//<wrap>8.168.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Stop the printer device 000E.</wrap> <wrap>HHC00013I Herc command: 'stop 000e' \\ HHC02214I 0:000E device stopped</wrap> **<wrap>Figure 304: STOP command (stop printer)</wrap>** **<wrap>Example 2: \\ </wrap>**<wrap>Stop CPU 1.</wrap> <wrap>HHC00013I Herc command: 'cpu 1'</wrap> <wrap>HHC00013I Herc command: 'stop'</wrap> <wrap>HHC00834I Processor CP01: manual state selected</wrap> **<wrap>Figure 305: STOP command (stop CPU)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 561</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.169 STOPALL (Stop all CPUs) \\ //8.169.1 Function//</wrap>** <wrap>The STOPALL command stops all CPUs</wrap> **//<wrap>8.169.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>ST0PALL</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ ST0PALL</wrap> **//<wrap>8.169.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.169.4 Examples</wrap>//** **<wrap>Example 1: \\ </wrap>**<wrap>Stop all CPU’s.</wrap> <wrap>HHC00013I Herc command: 'stopall'</wrap> **<wrap>Figure 306: STOPALL command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 562</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.170 STORE (Store CPU status at absolute zero) \\ //8.170.1 Function//</wrap>** <wrap>The STORE command stores the CPU status of the active CPU at absolute zero.</wrap> **//<wrap>8.170.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>STORE</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ STORE</wrap>** **//<wrap>8.170.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.170.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Store status for active CPU.</wrap> <wrap>HHC00013I Herc command: 'store'</wrap> <wrap>HHC00817I Processor CP00: store status completed</wrap> **<wrap>Figure 307: STORE command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 563</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.171 SUSPEND (Suspend Hercules) \\ //8.171.1 Function//</wrap>** <wrap>This command lets you suspend the current Hercules session and shutdown the host machine. Subsequently the suspended session can be resumed (see “RESUME” command). The data necessary to be saved for a later restart is saved in a packed (zipped) file called “hercules.srf.gz” which is located in the current configuration path.</wrap> <wrap>After entering the SUSPEND command the CPUs are put in a stopped state and the contents of the main storage, CPU states, I/O device states and internal Hercules states are dumped onto the “Hercules.srf.gz” file. After the SUSPEND command has finished writing to the suspend file, it schedules an immediate shutdown of Hercules.</wrap> <wrap>Currently device state is only fully saved for CKD disks. Each device class (e.g. TAPE, RDR, PUN, CTC) will need code to save and restore their state. Some states may not be possible to restore (e.g. active TCP/IP connections at the time of suspend). Currently the vector facility state is not saved, neither is the ECPSVM state.</wrap> <wrap>The created suspend file is designed to be HERCULES release independent and to be host architecture independent. For example it is possible to take a suspend file created on HERCULES 3.05.0 on an Intel machine and resume on a Sun machine running HERCULES 3.07.0.</wrap> <wrap>Please note that there are some caveats with suspend / resume processing which can affect the guest operating system running under Hercules. These caveats are described in the chapter about RESUME processing (8.138, RESUME).</wrap> <wrap>There are some caveats when suspending and resuming guest operating system processing:</wrap> <wrap>·<wrap></wrap></wrap><wrap>As seen by the guest operating system, the TOD clock will appear to jump a large value. Some guests may not cope very well with this. For example some guests may be dismayed because certain interrupts will occur way past its due time. Also for S/370 an interval timer interrupt may be lost if the guest is interrupted for more than half the Interval Timer wrap time (around 8 hours).</wrap> <wrap>·<wrap></wrap></wrap><wrap>Although some effort has been put in order to make this as transparent as possible (that is, it should appear to the guest operating system that the STOP key was pressed for a large amount of time), some state information may be missed.</wrap> <wrap>·<wrap></wrap></wrap><wrap>Some guest operating systems will fare better if the suspend state is prepared first. For MVS, as an example, it seems to help when a QUIESCE command and a SYSTEM RESTART manual operation are issued prior to suspend the system.</wrap> **//<wrap>8.171.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SUSPEND</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ SUSPEND</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image023.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 564</wrap> <wrap>\\ </wrap>**//<wrap>8.171.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.171.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Suspend the Hercules session.</wrap> <wrap>HHC00013I Herc command: 'suspend'</wrap> <wrap>HHC01420I Begin Hercules shutdown</wrap> <wrap>HHC02272I Highest observed MIPS and IO/s rates</wrap> <wrap>HHC02272I from Sun Sep 26 00:00:00 2010</wrap> <wrap>HHC02272I to Sun Sep 26 03:50:21 2010</wrap> <wrap>HHC02272I MIPS: 0.00 IO/s: 0</wrap> <wrap>HHC01421I Releasing configuration</wrap> <wrap>HHC00101I Thread id 000001F0, prio 0, name 'Processor CP00' ended</wrap> <wrap>HHC00101I Thread id 000017A4, prio 0, name 'Processor CP01' ended</wrap> <wrap>HHC01465I 0:000C device detached</wrap> <wrap>HHC01465I 0:000D device detached</wrap> <wrap>HHC01465I 0:000E device detached</wrap> <wrap>.</wrap> //<wrap>several lines not displayed.</wrap>// <wrap>.</wrap> <wrap>HHC01465I 0:0480 device detached</wrap> <wrap>HHC01465I 0:0481 device detached</wrap> <wrap>HHC01465I 0:0E20 device detached</wrap> <wrap>HHC01422I Configuration release complete</wrap> <wrap>HHC01423I Calling termination routines</wrap> <wrap>HHC01500I HDL: begin shutdown sequence</wrap> <wrap>HHC01501I HDL: calling 'panel_cleanup'</wrap> <wrap>HHC01502I HDL: calling 'panel_cleanup' complete</wrap> <wrap>HHC02103I Logger: logger thread terminating</wrap> **<wrap>Figure 308: SUSPEND command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 565</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.172 SYMPTOM (Instruction trace display option) \\ //8.172.1 Function//</wrap>** <wrap>The SYMPTOM command determines how the registers are displayed during instruction tracing and stepping. SYMPTOM is an alias for the TRACEOPT console command. Please see TRACEOPT for details.</wrap> **//<wrap>8.172.2 Syntax</wrap>//** <wrap>See TRACEOPT console command.</wrap> **//<wrap>8.172.3 Parameter</wrap>//** <wrap>See TRACEOPT console command.</wrap> **//<wrap>8.172.4 Examples</wrap>//** <wrap>See TRACEOPT console command.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 566</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.173 SYNCIO (Display SYNCIO device statistics) \\ //8.173.1 Function//</wrap>** <wrap>This command shows the SYNCIO device statistics for all DASD devices.</wrap> **//<wrap>8.173.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>SYNCI0</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ SYNCI0</wrap>** **//<wrap>8.173.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.173.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display SYNCIO device statistics.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'syncio'</wrap> |<WRAP><wrap>HHC02239I 0:0130 synchronous:</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02239I 0:0131 synchronous:</wrap> </WRAP> |<WRAP><wrap>48</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>11</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02239I 0:0132 synchronous:</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02239I 0:0133 synchronous:</wrap> </WRAP> |<WRAP><wrap>2</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> //<wrap>several lines not displayed</wrap>// </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02239I 0:034A synchronous:</wrap> </WRAP> |<WRAP><wrap>7</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02239I 0:034B synchronous:</wrap> </WRAP> |<WRAP><wrap>13</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>8</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02239I 0:0480 synchronous:</wrap> </WRAP> |<WRAP><wrap>2326</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>629</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02239I 0:0481 synchronous:</wrap> </WRAP> |<WRAP><wrap>44</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>19</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02240I Total synchronous:</wrap> </WRAP> |<WRAP><wrap>57957</wrap> </WRAP> |<WRAP><wrap>asynchronous:</wrap> </WRAP> |<WRAP><wrap>9267</wrap> </WRAP> |<WRAP><wrap>86%</wrap> </WRAP> | **<wrap>Figure 309: SYNCIO command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 567</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.174 SYSCLEAR (SYSTEM CLEAR RESET manual operation) //8.174.1 Function//</wrap>** <wrap>The SYSCLEAR command issues a SYSTEM CLEAR RESET manual operation. This is the same as the “SYSRESET CLEAR” command. It clears the main storage to x'00'. Additionally the general purpose registers, control registers, etc. are reset to their initial value. At this point the system is essentially in the same state as it was just after having been started.</wrap> <wrap>Please note that all CPUs must be stopped prior to issuing a system clear reset or the function will be rejected with a message.</wrap> **//<wrap>8.174.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>SYSCLEAR</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ SYSCLEAR</wrap>** **//<wrap>8.174.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.174.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>CLEAR RESET the system.</wrap> <wrap>HHC00013I Herc command: 'stopall' \\ HHC00013I Herc command: 'sysclear' \\ HHC02311I sysclear completed</wrap> **<wrap>Figure 310: SYSCLEAR command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 568</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.175 SYSEPOCH (Set base date for TOD clock) \\ //8.175.1 Function//</wrap>** <wrap>The SYSEPOCH command specifies the base date for the TOD clock. Use the default value (1900) for all systems except OS/360. Use 1960 for OS/360. Values other than these were formerly used to offset the TOD clock by a number of years to move the date before the year 2000 for non-Y2K-compliant operating systems. This use is deprecated and support will be removed in a future Hercules release after which only values of 1900 or 1960 will be accepted.</wrap> **//<wrap>8.175.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SYSEP0CH (1900 | 1960 | </wrap>//<wrap>year </wrap>//<wrap>[</wrap>//<wrap>+years </wrap>//<wrap>| </wrap>//<wrap>-years</wrap>//<wrap>l}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SYSEP0CH ¬¬¬§¬¬¬ 1900 </wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬ </wrap><wrap>ª</wrap><wrap>¬¬¬ </wrap><wrap>1960 </wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬ </wrap><wrap>⡿¬¬¬</wrap>//<wrap>year </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬</wrap> <wrap>ª¬¬¬</wrap>//<wrap>+years</wrap>// <wrap>⡿¬¬¬</wrap>//<wrap>-years</wrap>// **//<wrap>8.175.3 Parameter</wrap>//** **<wrap>1900 </wrap>**<wrap>Year 1900 is one of the two valid values for SYSEPOCH. 1900 is the default.</wrap> **<wrap>1960 </wrap>**<wrap>Year 1960 is the second of the two valid values for SYSEPOCH.</wrap> **//<wrap>year </wrap>//**<wrap>This is the base date for the TOD clock. The only supported values for SYSEPOCH are currently 1900 and 1960. Any other value will produce a warning message showing the equivalent values to specify in the SYSEPOCH statement. 1900 is the default.</wrap> **<wrap>+ //years //</wrap>**<wrap>Specifies an optional positive year offset. It will be treated as though it had been specified using the YROFFSET statement.</wrap> **<wrap>- //years //</wrap>**<wrap>Specifies an optional negative year offset. It will be treated as though it had been specified using the YROFFSET statement.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 569</wrap> <wrap>\\ </wrap>**//<wrap>8.175.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify year 1900 as the base date for the TOD clock and use an offset of 28 years.</wrap> <wrap>HHC00013I Herc command: 'sysepoch 1900 +28'</wrap> **<wrap>Figure 311: SYSEPOCH command (with offset)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Specify year 1960 as the base date for the TOD clock without an offset.</wrap> <wrap>HHC00013I Herc command: 'sysepoch 1960'</wrap> **<wrap>Figure 312: SYSEPOCH command (without offset)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 570</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.176 SYSRESET (SYSTEM RESET manual operation) //8.176.1 Function//</wrap>** <wrap>The SYSRESET command issues a SYSTEM RESET manual operation. Without any arguments or with the “NORMAL” argument only a CPU and I/O subsystem reset are performed. When the “CLEAR” argument is given then this command is identical function to the “SYSCLEAR” command.</wrap> <wrap>Please note that all CPUs must be stopped prior to issuing a system reset or the function will be rejected with a message.</wrap> **//<wrap>8.176.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>SYSRESET [NORMAL | CLEAR]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬SYSRESET </wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬</wrap><wrap>¬¬ </wrap><wrap>NORMAL </wrap><wrap>¬¬¬«</wrap> <wrap>⡿¬¬¬ CLEAR ¬¬¬¬¯</wrap> **//<wrap>8.176.3 Parameter</wrap>//** **<wrap>NORMAL </wrap>**<wrap>Performs only a CPU and I/O subsystem reset. This is the same as “SYSRESET” without any argument given.</wrap> **<wrap>CLEAR </wrap>**<wrap>This clears the main storage to x'00'. Additionally the general purpose registers, control registers, etc. are reset to their initial value. At this point the system is essentially in the same state as it was just after having been started. “SYSRESET CLEAR” is identical in functionality to the “SYSCLEAR” command.</wrap> **//<wrap>8.176.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>RESET CLEAR the system.</wrap> <wrap>HHC00013I Herc command: 'stopall'</wrap> <wrap>HHC00013I Herc command: 'sysreset clear' \\ HHC02311I sysreset clear completed</wrap> **<wrap>Figure 313: SYSRESET CLEAR command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 571</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.177 T (Instruction trace) \\ //8.177.1 Function//</wrap>** <wrap>This command sets the instruction tracing range. Instruction tracing is totally separate from the instruction stepping and breaking range. With or without a range the “T” command displays whether tracing is on or off and the range, if any.</wrap> <wrap>The “T” command by itself does not activate instruction tracing. Use the “T+” command to activate instruction tracing. The command “T 0” eliminates the range (all addresses will be traced).</wrap> **//<wrap>8.177.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>T [</wrap>//<wrap>addr-addr </wrap>//<wrap>| </wrap>//<wrap>addr:addr </wrap>//<wrap>| </wrap>//<wrap>addr.length </wrap>//<wrap>| 01</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ T ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ª¬¬¬¬</wrap>//<wrap>addr-addr </wrap>//<wrap>¬¬¬¬« ª¬¬¬¬ </wrap>//<wrap>addr:addr </wrap>//<wrap>¬¬¬¬« ª¬¬¬</wrap>//<wrap>addr.length </wrap>//<wrap>¬¬¬« ⡿¬¬¬¬¬¬¬¬0¬¬¬¬¬¬¬¬¯</wrap> **//<wrap>8.177.3 Parameter</wrap>//** **//<wrap>addr-addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address).</wrap> **//<wrap>addr:addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address).</wrap> **//<wrap>addr.length </wrap>//**<wrap>Specifies an address range with start and length (from begin address with the specified length).</wrap> **<wrap>0 </wrap>**<wrap>No range is specified or an existing range is reset. The tracing is active for all addresses.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 572</wrap> <wrap>\\ </wrap>**//<wrap>8.177.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set instruction tracing range with begin and end address and query the range afterwards.</wrap> <wrap>HHC00013I Herc command: 't 100000-101000'</wrap> <wrap>HHC02229I Instruction tracing off range 100000-101000</wrap> <wrap>HHC00013I Herc command: 't?'</wrap> <wrap>HHC02229I Instruction tracing off range 100000-101000</wrap> **<wrap>Figure 314: T command (address range)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set instruction tracing range with start address and length and query the range afterwards.</wrap> <wrap>HHC00013I Herc command: 't 1000000.1000'</wrap> <wrap>HHC02229I Instruction tracing off range 1000000.1000</wrap> <wrap>HHC00013I Herc command: 't?'</wrap> <wrap>HHC02229I Instruction tracing off range 1000000-1001000</wrap> **<wrap>Figure 315: T command (address with length)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set instruction tracing for all addresses and query the range afterwards.</wrap> <wrap>HHC00013I Herc command: 't 0' \\ HHC02229I Instruction tracing off \\ HHC00013I Herc command: 't?' \\ HHC02229I Instruction tracing off</wrap> **<wrap>Figure 316: T command (all addresses)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 573</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.178 T+ (Instruction trace on) \\ //8.178.1 Function//</wrap>** <wrap>This command turns on instruction tracing. A range can be specified as for the “T” command. Instruction tracing is totally separate from the instruction stepping and breaking range.</wrap> <wrap>After turning instruction tracing on, every instruction is listed with detailed trace information. The trace information includes the executing CPU, the PSW, the executed instruction in hexadecimal and in disassembled form as well as register hexadecimal displays of all involved register types.</wrap> <wrap>This function is similar to the instruction stepping. The difference between these two function is that with instruction stepping the execution of every instruction has to be initiated by hitting ENTER on the Hercules console, whereas instruction tracing – once started – traces the instructions without interruption.</wrap> <wrap>Please note that this function will create an enormous amount of output in the Hercules log. Running it on a relatively current machine (3 GHz HT Processor) for 10 seconds creates more than 10 MB of trace data.</wrap> **//<wrap>8.178.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>1+ [</wrap>//<wrap>addr-addr </wrap>//<wrap>| </wrap>//<wrap>addr:addr </wrap>//<wrap>| </wrap>//<wrap>addr.length </wrap>//<wrap>| 01</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬¬ 1+ ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap><wrap>ª¬¬¬¬</wrap>//<wrap>addr-addr </wrap>//<wrap>¬¬¬¬« </wrap><wrap>ª</wrap><wrap>¬¬¬¬ </wrap>//<wrap>addr:addr </wrap>//<wrap>¬¬¬¬« </wrap><wrap>ª¬¬¬</wrap>//<wrap>addr.length </wrap>//<wrap>¬¬¬« </wrap><wrap>⡿¬¬¬¬¬</wrap><wrap>¬¬</wrap><wrap>¬0¬¬¬¬¬¬¬¬¯</wrap> **//<wrap>8.178.3 Parameter</wrap>//** **//<wrap>addr-addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address).</wrap> **//<wrap>addr:addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address).</wrap> **//<wrap>addr.length </wrap>//**<wrap>Specifies an address range with start and length (from begin address with the specified length).</wrap> **<wrap>0 </wrap>**<wrap>No range is specified or an existing range is reset. The tracing is active for all addresses.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 574</wrap> <wrap>\\ </wrap>**//<wrap>8.178.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Turn instruction tracing on.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 't+' \\ HHC02229I Instruction tracing on</wrap> <wrap>HHC02267I CP00: PSW=0000014800000080 INST=05F0 BALR 15,0 branch_and_link_register \\ HHC02267I CP00: GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000 HHC02267I CP00: GR04=00000000 GR05=00000000 GR06=00000000 GR07=00000000 HHC02267I CP00: GR08=00000000 GR09=00000000 GR10=00000000 GR11=00000000 HHC02267I CP00: GR12=00000000 GR13=00000000 GR14=00000000 GR15=00000000</wrap> <wrap>HHC02267I CP00: PSW=0000014800000082 INST=980E0010 LM 0,14,16(0) load_multiple</wrap> <wrap>HHC02267I CP00: R:00000010:K:06=00000000 00000000 00000000 00000000 ............ </wrap> <wrap>HHC02267I CP00: GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000 HHC02267I CP00: GR04=00000000 GR05=00000000 GR06=00000000 GR07=00000000 HHC02267I CP00: GR08=00000000 GR09=00000000 GR10=00000000 GR11=00000000 HHC02267I CP00: GR12=00000000 GR13=00000000 GR14=00000000 GR15=40000082</wrap> <wrap>HHC02267I CP00: PSW=0000014880000086 INST=41A0F05A LA 10,90(0,15) load_address</wrap> <wrap>HHC02267I CP00: R:000000DC:K:06=41800100 41A0F08A 1B984700 F06E5890 ......0..q..0>..</wrap> <wrap>HHC02267I CP00: GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000</wrap> <wrap>HHC02267I CP00: GR04=00000000 GR05=00000000 GR06=00000000 GR07=00000000</wrap> <wrap>HHC02267I CP00: GR08=00000000 GR09=00000000 GR10=00000000 GR11=00000000</wrap> <wrap>HHC02267I CP00: GR12=00000000 GR13=00000000 GR14=00000000 GR15=40000082</wrap> <wrap>HHC02267I CP00: PSW=000001488000008A INST=D200FC7D0008 MVC 3197(1,15),8(0) move_character \\ HHC02267I CP00: R:00000CFF:K:06=F1 E5D5C9D7 D458FFFF 76B3BD00 AAAAFF 1VNIPM.....]....</wrap> <wrap>HHC02267I CP00: R:00000008:K:06=F1000000 00000000 00000000 00000000 1............. </wrap> <wrap>HHC02267I CP00: GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000 HHC02267I CP00: GR04=00000000 GR05=00000000 GR06=00000000 GR07=00000000 HHC02267I CP00: GR08=00000000 GR09=00000000 GR10=000000DC GR11=00000000 HHC02267I CP00: GR12=00000000 GR13=00000000 GR14=00000000 GR15=40000082</wrap> <wrap>HHC02267I CP00: PSW=00000148C0000090 INST=95000009 CLI 9(0),0 compare_logical_immediate</wrap> <wrap>HHC02267I CP00: R:00000009:K:06=000000 00000000 00000000 00000000 00 ........... </wrap> <wrap>HHC02267I CP00: GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000 HHC02267I CP00: GR04=00000000 GR05=00000000 GR06=00000000 GR07=00000000 HHC02267I CP00: GR08=00000000 GR09=00000000 GR10=000000DC GR11=00000000 HHC02267I CP00: GR12=00000000 GR13=00000000 GR14=00000000 GR15=40000082</wrap> <wrap>HHC02267I CP00: PSW=0000014880000094 INST=4780F050 BC 8,80(0,15) branch_on_condition</wrap> <wrap>HHC02267I CP00: R:000000D2:K:06=6800 FD2E2820 28402860 41800100 41A0 -</wrap> <wrap>HHC02267I CP00: GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000 HHC02267I CP00: GR04=00000000 GR05=00000000 GR06=00000000 GR07=00000000 HHC02267I CP00: GR08=00000000 GR09=00000000 GR10=000000DC GR11=00000000 HHC02267I CP00: GR12=00000000 GR13=00000000 GR14=00000000 GR15=40000082 .</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 317: T+ command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 575</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.179 T- (Instruction trace off) \\ //8.179.1 Function//</wrap>** <wrap>This command turns off the instruction tracing function.</wrap> **//<wrap>8.179.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>**<wrap>T-</wrap><wrap></wrap> **__<wrap>Diagram </wrap>__****<wrap>\\ </wrap>**<wrap>ÊÊ¬¬¬ T</wrap> **//<wrap>8.179.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.179.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Turn off instruction tracing.</wrap> <wrap>HHC00013I Herc command: 't-'</wrap> <wrap>HHC02229I Instruction tracing off range 1000000-1001000</wrap> **<wrap>Figure 318: T- command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 576</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.180 T? (Instruction trace query) \\ //8.180.1 Function//</wrap>** <wrap>The “T?” command displays whether instruction tracing is on or off and the range if any.</wrap> **//<wrap>8.180.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap>\\ </wrap>**<wrap>1</wrap><wrap>?</wrap> **__<wrap>Diagram </wrap>__****<wrap>\\ </wrap>**<wrap>ÊÊ¬¬¬ </wrap><wrap>1</wrap><wrap>?</wrap> **//<wrap>8.180.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.180.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Query instruction tracing.</wrap> <wrap>HHC00013I Herc command: 't?'</wrap> <wrap>HHC02229I Instruction tracing off range 1000000-1001000</wrap> **<wrap>Figure 319: T? command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 577</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.181 T{+/-} CKD (Turn CKD_KEY tracing on or off) \\ //8.181.1 Function//</wrap>** <wrap>The “T{+/-}CKD” command turns the CKD key tracing on (T+CKD) or turns it off (T-CKD). Please note that the command has to be issued without any intervening blanks.</wrap> **//<wrap>8.181.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>T{+ | </wrap><wrap>-</wrap><wrap>}CKD</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬T ¬¬¬§¬¬¬ + ¬¬¬§¬¬¬ CKD</wrap> <wrap>⡿¬¬¬ </wrap><wrap>- </wrap><wrap>¬¬¬</wrap> **//<wrap>8.181.3 Parameter</wrap>//** **<wrap>T+CKD </wrap>**<wrap>The T+CKD turns on the CKD key trace. The plus sign and the CKD argument must immediately follow the T command (without an intervening blank).</wrap> **<wrap>T-CKD </wrap>**<wrap>The T-CKD turns off the CKD key trace. The minus sign and the CKD argument must immediately follow the T command (without an intervening blank).</wrap> **//<wrap>8.181.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Turning the CKD key trace on.</wrap> |<WRAP><wrap>HHC00013I HHC02204I</wrap> </WRAP> |<WRAP><wrap>Herc command: 't+ckd'</wrap> <wrap>CKD key trace set to on</wrap> </WRAP> ||||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS1.NUCLEUS</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEANUC01'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNIPM'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNPA2'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNP01'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNPB2'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS1.LOGREC</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS1.SVCLIB</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNP11'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYSCATLG'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 578</wrap> <wrap>\\ </wrap> |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'Z9999994.VSAMDSPC'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNP1A'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNP03'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNP12'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS1.PARMLIB</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEASYS00'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS1.LINKLIB</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'LNKLST00'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS1.CMDLIB</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0240</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/PUB000.CCKD|<wrap>D:/MVS/DASD/PUB000.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS2.LINKLIB</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0241</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/PUB001.CCKD|<wrap>D:/MVS/DASD/PUB001.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS2.CMDLIB</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNP10'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAOPT00'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAIPS00'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'ILRPREAD'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNP04'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'ILROPS00'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNPA8'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAVNP05'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'SYS1.LPALIB</wrap> </WRAP> |<WRAP><wrap>'</wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEAPAK00'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEABLD00'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'ALLOC '</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'E '</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'HEWL '</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEWL '</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IEWLF440'</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IFOX01 '</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IFOX11 '</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'IFOX62 '</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC00423I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD</wrap> </WRAP> |<WRAP><wrap>file</wrap> </WRAP> |<WRAP><wrap>'</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>':</wrap> </WRAP> |<WRAP><wrap>search</wrap> </WRAP> |<WRAP><wrap>key</wrap> </WRAP> |<WRAP><wrap>'LINK '</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 320: T+CKD command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Turning the CKD key trace off.</wrap> <wrap>HHC00013I Herc command: 't-ckd' \\ HHC02204I CKD key trace set to off</wrap> **<wrap>Figure 321: T-CKD command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 579</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.182 T{+/-} dev (Turn CCW tracing on or off) \\ //8.182.1 Function//</wrap>** <wrap>This command turns the CCW tracing for a certain device on (T+dev) or turns it off (T-dev). It is possible to trace several devices concurrently. To enable the tracing of more than one device the T+ command must be issued for each device. The traces can be turned off independently of each other.</wrap> <wrap>This function is similar to the CCW stepping described in section 8.145. The difference between these two function is that with CCW stepping the execution of every CCW has to be initiated by hitting ENTER on the Hercules console, whereas CCW tracing – once started – traces the instructions without interruption.</wrap> <wrap>Notes:</wrap> <wrap>·<wrap></wrap></wrap><wrap>The tracing function will create an enormous amount of output in the Hercules log.</wrap> <wrap>·<wrap></wrap></wrap><wrap>The command has to be issued without any intervening blanks.</wrap> **//<wrap>8.182.2 Syntax</wrap>//** |<WRAP>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>T{+ | </wrap>//<wrap>-</wrap>//<wrap>}</wrap>//<wrap>devaddr</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ T ¬¬¬§¬¬¬ + ¬¬¬§¬¬¬ </wrap>////<wrap>devaddr</wrap>// <wrap>⡿¬¬¬</wrap>//<wrap>- </wrap>//<wrap>¬¬¬</wrap> </WRAP> | **//<wrap>8.182.3 Parameter</wrap>//** **<wrap>+ </wrap>**<wrap>The plus sign turns on the CCW tracing for the given device. The plus sign must immediately follow the T command (without an intervening blank).</wrap> **<wrap>- </wrap>**<wrap>The minus sign turns off the CCW tracing for the given device. The minus sign must immediately follow the T command (without an intervening blank).</wrap> **//<wrap>devaddr </wrap>//**<wrap>This specifies the address of the device for which the CCW tracing is to be turned on or off.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 580</wrap> <wrap>\\ </wrap>**//<wrap>8.182.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Turn on the CCW tracing for device 0148.</wrap> <wrap><wrap>{{hercules:userref:bf:image062.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap>HHC00013I Herc command: 't+0148'</wrap> <wrap>HHC02204I CCW trace for 0:0148 set to on</wrap> <wrap>HHC00396I 0:0148 start i/o file[1] bufcur -1 cache[-1]</wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 02000000 60000018=>02000000 60000018 00000000 00000000 - HHC00431I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': seeking to cyl 0 head 0</wrap> <wrap>HHC00396I 0:0148 read trk 0 (asynchronous)</wrap> <wrap>HHC00396I 0:0148 0 rdtrk 0</wrap> <wrap>HHC00396I 0:0148 0 rdtrk[0] 0 cache miss</wrap> <wrap>HHC00396I 0:0148 0 rdtrk[0] 0 buf 07B8F9E0 len 19456</wrap> <wrap>HHC00396I 0:0148 trk[0] read_trkimg</wrap> <wrap>HHC00396I 0:0148 file[1] l2[0,0] trk[0] read_l2ent 0xd08</wrap> <wrap>HHC00396I 0:0148 file[1] read_l2 0 active -1 -1 -1</wrap> <wrap>HHC00396I 0:0148 l2[1,0] cache[0] miss</wrap> <wrap>HHC00396I 0:0148 file[1] fd[18] read, off 0x0000000000000d08 len 2048</wrap> <wrap>HHC00396I 0:0148 file[1] cache[0] l2[0] read offset 0x00000d08</wrap> <wrap>HHC00396I 0:0148 file[0] l2[0,0] trk[0] read_l2ent 0x508</wrap> <wrap>HHC00396I 0:0148 file[0] read_l2 0 active 1 0 0</wrap> <wrap>HHC00396I 0:0148 l2[0,0] cache[1] miss</wrap> <wrap>HHC00396I 0:0148 file[0] fd[17] read, off 0x0000000000000508 len 2048</wrap> <wrap>HHC00396I 0:0148 file[0] cache[1] l2[0] read offset 0x00000508</wrap> <wrap>HHC00396I 0:0148 file[0] l2[0,0] trk[0] read_l2ent 0x116f079 2343 2343</wrap> <wrap>HHC00396I 0:0148 file[0] fd[17] read, off 0x000000000116f079 len 2343</wrap> <wrap>HHC00396I 0:0148 0 rdtrk[0] 0 complete buf 07B8F9E0:0100000000</wrap> <wrap>HHC00396I 0:0148 uncompress comp 1 len 2343 maxlen 19456 trk 0</wrap> <wrap>HHC00396I 0:0148 newbuf malloc 07B9CED8 len 19456</wrap> <wrap>HHC00396I 0:0148 uncompress zlib newlen 6817 rc 0</wrap> <wrap>HHC00396I 0:0148 validating trk 0 len 6817 0000000000 0000000000000008</wrap> <wrap>HHC00396I 0:0148 read trk 0 uncompressed len 6817</wrap> <wrap>HHC00434I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read count orientation 'index' HHC00435I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head 0 record 0 kl 0 dl 8 of 0 HHC00435I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head 0 record 1 kl 4 dl 24 of 0 HHC00437I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read data 24 bytes</wrap> <wrap>HHC01312I 0:0148 CHAN: stat 0C00, count 0000 '=>00000000 00000000 06003A98 60000060 .......... q</wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 06003A98 60000060=>00000000 00000000 00000000 00000000 ............. </wrap> <wrap>HHC00434I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read count orientation 'data'</wrap> <wrap>HHC00435I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head 0 record 2 kl 4 dl 144 of 0 HHC00437I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read data 144 bytes</wrap> <wrap>HHC01312I 0:0148 CHAN: stat 0C00, count 0000 '=>07003AB8 40000006 31003ABE 40000005 .... ...... </wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 08003A98 00000000=>07003AB8 40000006 31003ABE 40000005 .... ....... . </wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 07003AB8 40000006=>00000000 00000000 00000400 00000000 ............. </wrap> <wrap>HHC00431I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': seeking to cyl 0 head 0 HHC01312I 0:0148 CHAN: stat 0C00, count 0000 "</wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 31003ABE 40000005=>00000000 04000000 00000000 00000000 ............. \\ HHC00434I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read count orientation 'index'</wrap> <wrap>HHC00435I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head 0 record 0 kl 0 dl 8 of 0 HHC01312I 0:0148 CHAN: stat 0C00, count 0000 "</wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 08003AA0 00000000=>31003ABE 40000005 08003AA0 00000000 ............. </wrap> <wrap>HHC01315I 0:0148 CHAN: ccw 31003ABE 40000005=>00000000 04000000 00000000 00000000 ............. </wrap> <wrap>HHC00434I 0:0148 CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': read count orientation 'count'</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image099.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 581</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap> |<WRAP><wrap>HHC00435I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CKD file '</wrap>[[file:///D:/MVS/DASD/MVSRES.CCKD|<wrap>D:/MVS/DASD/MVSRES.CCKD</wrap>]]<wrap>': cyl 0 head</wrap> </WRAP> |<WRAP><wrap>0 record</wrap> </WRAP> |<WRAP><wrap>1 kl 4 dl</wrap> </WRAP> |<WRAP><wrap>24</wrap> </WRAP> |<WRAP><wrap>of 0</wrap> </WRAP> | |<WRAP><wrap>HHC01312I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CHAN: stat 0C00, count 0000 "</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CHAN: ccw 08003AA0 00000000=>31003ABE 40000005</wrap> </WRAP> |<WRAP><wrap>08003AA0</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC01315I</wrap> </WRAP> |<WRAP><wrap>0:0148</wrap> </WRAP> |<WRAP><wrap>CHAN: ccw 31003ABE 40000005=>00000000 04000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | <wrap>.</wrap> <wrap>.</wrap> <wrap>.</wrap> **<wrap>Figure 322: T+ dev command</wrap>** **<wrap>Example 2:</wrap>** <wrap>Turn off the CCW tracing for device 0148.</wrap> <wrap>HHC00013I Herc command: 't-0148'</wrap> <wrap>HHC02204I CCW trace for 0:0148 set to off</wrap> **<wrap>Figure 323: T- dev command</wrap>** **<wrap>Example 3:</wrap>** <wrap>Turn on the CCW tracing for several devices.</wrap> <wrap>HHC00013I Herc command: 't+0344' \\ HHC02204I CCW trace for 0:0344 set to on \\ HHC00013I Herc command: 't+0345' \\ HHC02204I CCW trace for 0:0345 set to on</wrap> **<wrap>Figure 324: T+ dev command (for several devices)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 582</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.183 TIMERINT (Display or set timers update interval) //8.183.1 Function//</wrap>** <wrap>The TIMERINT parameter displays or sets the internal timer update interval in microseconds. This parameter specifies how frequently Hercules's internal timers-update thread updates the TOD clock, CPU Timer and other architectural related clock and timer values.</wrap> <wrap>The default interval is 50 microseconds which attempts to strike a reasonable balance between clock accuracy and overall host performance.</wrap> **//<wrap>8.183.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>TIMERINT [</wrap>//<wrap>interval</wrap>////<wrap>]</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬TIMERINT¬¬¬§</wrap> //<wrap>interval</wrap>// **//<wrap>8.183.3 Parameter</wrap>//** **//<wrap>interval </wrap>//**<wrap>Specifies the timer update interval in microseconds. The minimum allowed value for the interval is 1 microsecond and the maximum is 1'000'000 microseconds (one second.</wrap> <wrap>CAUTION: While a lower TIMERINT value may help increase the accuracy of the guest's TOD clock and CPU Timer values, it could also have severe negative impact on the overall performance of the host operating system. This is especially true when a low value is coupled with a high HERCPRIO and TODPRIO priority setting.</wrap> <wrap>Exercise extreme caution when choosing your desired TIMERINT in relationship to your chosen HERCPRIO and TODPRIO priority settings.</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 583</wrap> <wrap>\\ </wrap>**//<wrap>8.183.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display current timers update interval.</wrap> <wrap>HHC00013I Herc command: 'timerint'</wrap> <wrap>HHC02203I timerint : 50</wrap> **<wrap>Figure 325: TIMERINT command (list current value)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set timers update interval to 100 microseconds.</wrap> <wrap>HHC00013I Herc command: 'timerint 100'</wrap> <wrap>HHC02204I timerint set to 100</wrap> **<wrap>Figure 326: TIMERINT command (set new value)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 584</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.184 TLB (Display TLB tables) \\ //8.184.1 Function//</wrap>** <wrap>The TLB command shows the actual contents of the TLB (Translation Lookaside Buffer) tables.</wrap> **//<wrap>8.184.2 Syntax</wrap>//** **__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>TLB</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ TLB</wrap> **//<wrap>8.184.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.184.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the TLB tables.</wrap> |<WRAP><wrap>HHC00013I \\ HHC02284I \\ HHC02284I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'tlb'</wrap> <wrap>tlbID 0x000E3B mainstor 0000000003A81000</wrap> <wrap>ix asd vaddr pte</wrap> </WRAP> |||<WRAP><wrap>id c</wrap> </WRAP> |<WRAP><wrap>p</wrap> </WRAP> |<WRAP><wrap>r w</wrap> </WRAP> ||<WRAP><wrap>ky</wrap> </WRAP> |<WRAP><wrap>main</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*000 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000000000</wrap> </WRAP> |<WRAP><wrap>0000000000000001</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*001 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000000800</wrap> </WRAP> |<WRAP><wrap>0000000000000001</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00000800</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*002 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000001000</wrap> </WRAP> |<WRAP><wrap>0000000000000011</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>FC580000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*003 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000001800</wrap> </WRAP> |<WRAP><wrap>0000000000000011</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00001800</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>004 000000000F927C00</wrap> </WRAP> |<WRAP><wrap>0000000000002000</wrap> </WRAP> |<WRAP><wrap>0000000000000021</wrap> </WRAP> |<WRAP><wrap>0E31 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00002000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>005 000000000F927C00</wrap> </WRAP> |<WRAP><wrap>0000000000002800</wrap> </WRAP> |<WRAP><wrap>0000000000000021</wrap> </WRAP> |<WRAP><wrap>0E31 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00002800</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>006 000000000F927C00</wrap> </WRAP> |<WRAP><wrap>0000000000003000</wrap> </WRAP> |<WRAP><wrap>0000000000000031</wrap> </WRAP> |<WRAP><wrap>0E31 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00003000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>007 000000000F927C00</wrap> </WRAP> |<WRAP><wrap>0000000000003800</wrap> </WRAP> |<WRAP><wrap>0000000000000031</wrap> </WRAP> |<WRAP><wrap>0E31 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00003800</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*008 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000004000</wrap> </WRAP> |<WRAP><wrap>0000000000000041</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00004000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*009 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000004800</wrap> </WRAP> |<WRAP><wrap>0000000000000041</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>FC583800</wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP>//<wrap>several lines not displayed</wrap>// </WRAP> ||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3F6 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFB000</wrap> </WRAP> |<WRAP><wrap>000000000000FFB1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00FFB000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3F7 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFB800</wrap> </WRAP> |<WRAP><wrap>000000000000FFB1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00FFB800</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 585</wrap> <wrap>\\ </wrap> |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3F8 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFC000</wrap> </WRAP> |<WRAP><wrap>000000000000FFC1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>FD57B000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3F9 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFC800</wrap> </WRAP> |<WRAP><wrap>000000000000FFC1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00FFC800</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3FA 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFD000</wrap> </WRAP> |<WRAP><wrap>000000000000FFD1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>FD57C000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3FB 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFD800</wrap> </WRAP> |<WRAP><wrap>000000000000FFD1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00FFD800</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3FC 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFE000</wrap> </WRAP> |<WRAP><wrap>000000000000FFE1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00FFE000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3FD 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFE800</wrap> </WRAP> |<WRAP><wrap>000000000000FFE1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00FFE800</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3FE 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFF000</wrap> </WRAP> |<WRAP><wrap>000000000000FFF1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>FD57E000</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>*3FF 000000000FFD7C00</wrap> </WRAP> |<WRAP><wrap>0000000000FFF800</wrap> </WRAP> |<WRAP><wrap>000000000000FFF1</wrap> </WRAP> |<WRAP><wrap>0E3B 0</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>1</wrap> </WRAP> |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>00</wrap> </WRAP> |<WRAP><wrap>00FFF800</wrap> </WRAP> | |<WRAP><wrap>HHC02284I</wrap> </WRAP> |<WRAP><wrap>138 tlbID matches</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 327: TLB command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 586</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.185 TODDRAG (Display or set TOD clock drag factor) //8.185.1 Function//</wrap>** <wrap>The TODDRAG command displays the current setting of the TOD clock drag factor or sets a new value. This parameter can be used to slow down or speed up the TOD clock by a factor of //nn. //A significant slowdown can improve the performance of some operating systems which consume large amounts of CPU time processing timer interrupts. A drag factor of 2.0 slows down the clock by 50%, a drag factor of 0.5 doubles the speed of the clock, a drag factor of 1.01 slows down the clock by 1% and 0.99 speeds up the clock by 1%.</wrap> **//<wrap>8.185.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>T000RAG [factor]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬T000RAG ¬¬</wrap> <wrap>factor</wrap> **//<wrap>8.185.3 Parameter</wrap>//** **//<wrap>factor </wrap>//**<wrap>The factor to which the TOD clock has to be slowed down or sped up.</wrap> **//<wrap>8.185.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display current TOD clock drag factor.</wrap> <wrap>HHC00013I Herc command: 'toddrag'</wrap> <wrap>HHC02203I toddrag : 1.000000</wrap> **<wrap>Figure 328: TODDRAG command (display TOD clock factor)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 587</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Speed up the clock by 10%.</wrap> <wrap>HHC00013I Herc command: 'toddrag 0.9'</wrap> <wrap>HHC02204I toddrag set to 0.9</wrap> **<wrap>Figure 329: TODDRAG command (set TOD clock factor)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 588</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.186 TODPRIO (Display or set timer thread process priority) //8.186.1 Function//</wrap>** <wrap>The TODPRIO command is used to change the process priority of the TOD clock and the timer threads. See section 5.82 for details on process and thread priorities. Given without an argument the TODPRIO command displays the current Hercules process priority.</wrap> **<wrap>Caution: </wrap>**<wrap>TODPRIO should be given a dispatching priority equal to or higher than any other thread (CPUPRIO, DEVPRIO, HERCPRIO and SRVPRIO) within Hercules.</wrap> **//<wrap>8.186.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>T0DPRI0 </wrap><wrap>[</wrap>//<wrap>nn</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>T0DPRI0</wrap> //<wrap>nn</wrap>// **//<wrap>8.186.3 Parameter</wrap>//** **//<wrap>nn </wrap>//**<wrap>This value specifies the priority of the TOD clock and the timer thread. For details on the priority values see section 5.82 (“Process and Thread Priorities”).</wrap> **//<wrap>8.186.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the process priority of the TOD clock and the timer threads to 0.</wrap> <wrap>HHC00013I Herc command: 'todprio -20'</wrap> <wrap>HHC02204I todprio set to -20</wrap> **<wrap>Figure 330: TODPRIO command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 589</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.187 TRACEOPT (Instruction trace display options) \\ //8.187.1 Function//</wrap>** <wrap>The TRACEOPT command determines how the registers are displayed during instruction tracing and stepping. Entering the command without any argument simply displays the current trace mode.</wrap> **//<wrap>8.187.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>TRACEOPT [TRADITIONAL | REGSFIRST | NOREGS]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬TRACEOPT ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬I¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>**<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> **<wrap>i¬¬¬ TRADITIONAL¬¬¬«</wrap>** **<wrap>ª¬</wrap>**<wrap>¬</wrap>**<wrap>¬¬REGSFIRST¬</wrap>**<wrap>¬¬¬«</wrap> **<wrap>⡿¬</wrap>**<wrap>¬</wrap>**<wrap>¬¬¬NOREGS¬¬¬¬¬¬¯</wrap>** **//<wrap>8.187.3 Parameter</wrap>//** **<wrap>TRADITIONAL </wrap>**<wrap>Displays the registers following the instruction about to be executed such that pressing enter (to execute the displayed instruction) then shows the next instruction to be executed followed by the updated registers display.</wrap> **<wrap>REGSFIRST </wrap>**<wrap>Displays the current register contents followed by the instruction about to be executed such that pressing enter (to execute the displayed instruction) then shows the updated registers followed by the next instruction to be executed.</wrap> **<wrap>NOREGS </wrap>**<wrap>Suppresses the register display altogether and shows just the instruction to be executed.</wrap> **//<wrap>8.187.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the instruction trace in traditional mode (instruction followed by registers).</wrap> <wrap><wrap>{{hercules:userref:bf:image062.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image046.gif|}}</wrap></wrap><wrap>HHC00013I Herc command: 'traceopt traditional'</wrap> <wrap>HHC02203I Hercules inst trace displayed: traditional mode</wrap> <wrap>HHC02267I CP00: PSW=040C10000001D0C4 INST=58E00230 L 14,560(0,0) load</wrap> <wrap>HHC02267I CP00: V:00000230:K:06=00000000 00000000 00000000 00FD4000 .............. HHC02267I CP00: GR00=00000000 GR01=00000000 GR02=00000000 GR03=00000000</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image099.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 590</wrap> <wrap>\\ </wrap>|<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR04=00000000 GR05=00000000 GR06=00000000</wrap> </WRAP> |<WRAP><wrap>GR07=00FFDE28</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR08=00000000 GR09=4001D0A4 GR10=00000000</wrap> </WRAP> |<WRAP><wrap>GR11=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR12=00000000 GR13=00000000 GR14=00000000</wrap> </WRAP> |<WRAP><wrap>GR15=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR00=C080EC40 CR01=0FFD7C00 CR02=FFFFFFFF</wrap> </WRAP> |<WRAP><wrap>CR03=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR04=00000000 CR05=00000000 CR06=00000000</wrap> </WRAP> |<WRAP><wrap>CR07=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR08=00000000 CR09=00000000 CR10=00000000</wrap> </WRAP> |<WRAP><wrap>CR11=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR12=00000000 CR13=00000000 CR14=EFC00000</wrap> </WRAP> |<WRAP><wrap>CR15=00FEBB10</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=040C10000001D0C8 INST=50E070BC ST</wrap> </WRAP> |<WRAP><wrap>14,188(0,7)</wrap> </WRAP> |<WRAP><wrap>store</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>V:00FFDEE4:K:06=00FFDE28 00000000 4001D0A4</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> <wrap>............ }u....</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR00=00000000 GR01=00000000 GR02=00000000</wrap> </WRAP> |<WRAP><wrap>GR03=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR04=00000000 GR05=00000000 GR06=00000000</wrap> </WRAP> |<WRAP><wrap>GR07=00FFDE28</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR08=00000000 GR09=4001D0A4 GR10=00000000</wrap> </WRAP> |<WRAP><wrap>GR11=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>GR12=00000000 GR13=00000000 GR14=00000000</wrap> </WRAP> |<WRAP><wrap>GR15=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR00=C080EC40 CR01=0FFD7C00 CR02=FFFFFFFF</wrap> </WRAP> |<WRAP><wrap>CR03=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR04=00000000 CR05=00000000 CR06=00000000</wrap> </WRAP> |<WRAP><wrap>CR07=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR08=00000000 CR09=00000000 CR10=00000000</wrap> </WRAP> |<WRAP><wrap>CR11=00000000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>CR12=00000000 CR13=00000000 CR14=EFC00000</wrap> </WRAP> |<WRAP><wrap>CR15=00FEBB10</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 331: TRACEOPT command (TRADITIONAL)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Display the instruction trace in regsfirst mode (registers followed by instruction).</wrap> {{hercules:userref:bf:image063.gif|}}{{hercules:userref:bf:image057.gif|}}{{hercules:userref:bf:image057.gif|}}{{hercules:userref:bf:image057.gif|}}<wrap><wrap>{{hercules:userref:bf:image100.gif|}}</wrap></wrap>**<wrap>Figure 332: TRACEOPT command (REGSFIRST)</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 591</wrap> <wrap>\\ </wrap>**<wrap>Example 3:</wrap>** <wrap>Display the instruction trace in noregs mode (instruction only).</wrap> |<WRAP><wrap>HHC00013I HHC02203I</wrap> </WRAP> |<WRAP><wrap>Herc command: 'traceopt noregs'</wrap> <wrap>Hercules inst trace displayed: noregs mode</wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>V:00FFDEC8:K:06=00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000 ......... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=040C10000001D0C4 INST=58E00230</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>14,560(0,0)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>V:00000230:K:06=00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00FD4000 ......... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=040C10000001D0C8 INST=50E070BC</wrap> </WRAP> |<WRAP><wrap>ST</wrap> </WRAP> |<WRAP><wrap>14,188(0,7)</wrap> </WRAP> |<WRAP><wrap>store</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>V:00FFDEE4:K:06=00FFDE28 00000000</wrap> </WRAP> |<WRAP><wrap>4001D0A4</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> <wrap>.. }u....</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=040C10000001D0CC INST=58E00234</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>14,564(0,0)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>V:00000234:K:06=00000000 00000000</wrap> </WRAP> |<WRAP><wrap>00FD4000</wrap> </WRAP> |<WRAP><wrap>070E0000 ......... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=040C10000001D0D0 INST=50E070C4</wrap> </WRAP> |<WRAP><wrap>ST</wrap> </WRAP> |<WRAP><wrap>14,196(0,7)</wrap> </WRAP> |<WRAP><wrap>store</wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>V:00FFDEEC:K:06=4001D0A4 00000000</wrap> </WRAP> |<WRAP><wrap>00000000</wrap> </WRAP> |<WRAP><wrap>00000000 .}u.... </wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02267I</wrap> </WRAP> |<WRAP><wrap>CP00:</wrap> </WRAP> |<WRAP><wrap>PSW=040C10000001D0D4 INST=58D00010</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>13,16(0,0)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | **<wrap>Figure 333: TRACEOPT command (NOREGS)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 592</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.188 TT32 (Control / query CTCI-WIN functionality) \\ //8.188.1 Function//</wrap>** <wrap>The TT32 command controls or queries the CTCI-WIN functionality for a given device address. It allows you to enable or disable global CTCI-WIN debug tracing, or displays TunTap32 statistics for the specified CTC device.</wrap> **//<wrap>8.188.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>TT32 (DEBUG | N0DEBUG | STATS //devnum//}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_TT32 %%__%%_§%%__%%%%__%%%%__%%%%__%% DEBUG%%__%%%%__%%%%__%%%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%</wrap><wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª%%__%%</wrap><wrap>¬¬¬¬</wrap><wrap>_N0DEBUG_</wrap><wrap>¬¬¬¬¬¬¬«</wrap> <wrap>L%%__%%_ STATS %%__%%_ //devnum //%%__%%_</wrap> **//<wrap>8.188.3 Parameter</wrap>//** **<wrap>DEBUG </wrap>**<wrap>Enable global CTCI-WIN debug tracing.</wrap> **<wrap>NODEBUG </wrap>**<wrap>Disable global CTCI-WIN debug tracing.</wrap> **<wrap>STATS </wrap>**<wrap>Display TunTap32 statistics for CTC device.</wrap> **//<wrap>devnum </wrap>//**<wrap>Device number of the device for which the TunTap32 statistics have to displayed.</wrap> **//<wrap>8.188.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Enable global CTCI-WIN debug tracing.</wrap> <wrap>HHC00013I Herc command: 'tt32 debug' \\ HHC02204I TT32 debug set to enabled</wrap> **<wrap>Figure 334: TT32 DEBUG command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 593</wrap> <wrap>\\ </wrap>**<wrap>Example 2:</wrap>** <wrap>Disable global CTCI-WIN debug tracing.</wrap> <wrap>HHC00013I Herc command: 'tt32 nodebug' \\ HHC02204I TT32 debug set to disabled</wrap> **<wrap>Figure 335: TT32 NODEBUG command</wrap>** **<wrap>Example 3:</wrap>** <wrap>Display TunTap32 statistics for device 0E20.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: 'tt32 stats 0e20'</wrap> <wrap>HHC04101I </wrap>[[file:///D:/Hercules/TunTap32.dll|<wrap>D:%%\%%Hercules%%\%%TunTap32.dll</wrap>]]<wrap> Statistics:</wrap> |<WRAP><wrap>Size of Kernel Hold Buffer: 1024K</wrap> <wrap>Size of DLL I/O Buffer: 64K</wrap> <wrap>Maximum DLL I/O Bytes Received: 4K</wrap> <wrap>0 Total Write Calls</wrap> <wrap>0 Total Write I/Os</wrap> <wrap>0 Packets To All Zeroes MAC Written</wrap> </WRAP> ||| | |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>Total</wrap> </WRAP> |<WRAP><wrap>Packets Written</wrap> </WRAP> | | |<WRAP><wrap>0</wrap> </WRAP> |<WRAP><wrap>Total</wrap> </WRAP> |<WRAP><wrap>Bytes</wrap> </WRAP> |<WRAP><wrap>Written</wrap> </WRAP> | |<WRAP><wrap>346</wrap> </WRAP> |<WRAP><wrap>Total</wrap> </WRAP> |<WRAP><wrap>Read</wrap> </WRAP> |<WRAP><wrap>Calls</wrap> </WRAP> | |<WRAP><wrap>1770</wrap> </WRAP> |<WRAP><wrap>Total</wrap> </WRAP> |<WRAP><wrap>Read</wrap> </WRAP> |<WRAP><wrap>I/Os</wrap> </WRAP> | <wrap>0 Internally Handled ARP Packets</wrap> <wrap>0 Packets From Ourself</wrap> <wrap>913 Total Ignored Packets</wrap> <wrap>0 Packets To All Zeroes MAC Read</wrap> <wrap>950 Total Packets Read</wrap> <wrap>524372 Total Bytes Read</wrap> **<wrap>Figure 336: TT32 STATS command</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 594</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.189 TZOFFSET (Set TOD clock offset from GMT) \\ //8.189.1 Function//</wrap>** <wrap>The TZOFFSET command is used to define the offset of the TOD clock from the current system time. For GMT use the default value (0000). This is also the correct setting if your system time (the time of the operating system on which Hercules is running) is set to local time rather than GMT. For time zones west of Greenwich specify a negative value (example: -0500 for US Eastern Standard Time, -0800 for US Pacific Standard Time). For time zones east of Greenwich, specify a positive value (example: +0100 for Central European Time, +0930 for South Australian Time).</wrap> **//<wrap>8.189.2 Syntax</wrap>//** {{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image101.gif|}}{{hercules:userref:bf:image102.gif|}}**//<wrap>8.189.3 Parameter</wrap>//** **<wrap>+hhmm </wrap>**<wrap>Use a positive time in hours and minutes for time zones east of Greenwich.</wrap> **<wrap>-hhmm </wrap>**<wrap>Use a negative time in hours and minutes for time zones west of Greenwich.</wrap> **//<wrap>8.189.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Set the offset of the TOD clock from the current system time to Central European Time.</wrap> <wrap>HHC00013I Herc command: 'tzoffset +0100'</wrap> <wrap>HHC02204I tzoffset set to +0100</wrap> **<wrap>Figure 337: TZOFFSET command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 595</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.190 U (Disassemble storage) \\ //8.190.1 Function//</wrap>** <wrap>The U command lets you disassemble storage. The argument specifies the storage address to be disassembled. The length of the storage area can be given as an optional argument. The listed storage area is formatted as one line per instruction. Every instruction is shown as a hexadecimal string and as readable assembler statement. Storage areas that cannot be disassembled (data areas) are marked with question marks. Up to 64K bytes can be disassembled.</wrap> **//<wrap>8.190.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>U [R | V | P | H] {</wrap>//<wrap>addr</wrap>//<wrap>.</wrap>//<wrap>length </wrap>//<wrap>| </wrap>//<wrap>addr-addr</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ U ¬¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬ </wrap>//<wrap>addr.length </wrap>//<wrap>¬¬¬§¬¬ÊÍ</wrap> <wrap>ª¬¬¬ R ¬¬¬« ⡿¬¬¬¬ </wrap>//<wrap>addr-addr </wrap>//<wrap>¬¬¬¬</wrap> <wrap>ª¬¬¬V¬¬¬«</wrap> <wrap>ª¬¬¬ P ¬¬¬«</wrap> <wrap>⡿¬¬¬ H¬¬¬¯</wrap> **//<wrap>8.190.3 Parameter</wrap>//** **<wrap>R </wrap>**<wrap>The optional 'R' argument will force real address translation mode instead of current PSW mode.</wrap> **<wrap>V </wrap>**<wrap>The optional 'V' argument will force virtual address translation mode instead of current PSW mode.</wrap> **<wrap>P </wrap>**<wrap>The optional 'P' argument will force primary space address translation mode instead of current PSW mode.</wrap> **<wrap>H </wrap>**<wrap>The optional 'H' argument will force home space address translation mode instead of current PSW mode.</wrap> **//<wrap>addr.length </wrap>//**<wrap>Specifies the address of the storage area that is to be disassembled with starting address and length (from address //addr //with the length of //length//). The //length //value must be given in hexadecimal. The maximum length that can be specified is 64K.</wrap> **//<wrap>addr-addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address) of the storage area that is to be disassembled. The range specified must not exceed 64K.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 596</wrap> <wrap>\\ </wrap>**//<wrap>8.190.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Disassemble 4096 bytes beginning at address 00040130.</wrap> |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>u 00040130.1000</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040130: 90DF02EC</wrap> </WRAP> |<WRAP><wrap>STM</wrap> </WRAP> |<WRAP><wrap>13,15,748(0)</wrap> </WRAP> |<WRAP><wrap>store_multiple</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040134: 4166000C</wrap> </WRAP> |<WRAP><wrap>LA</wrap> </WRAP> |<WRAP><wrap>6,12(6,0)</wrap> </WRAP> |<WRAP><wrap>load_address</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040138: 58606160</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>6,352(0,6)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004013C: 58300010</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>3,16(0,0)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040140: 58430184</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>4,388(3,0)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040144: 55C06058</wrap> </WRAP> |<WRAP><wrap>CL</wrap> </WRAP> |<WRAP><wrap>12,88(0,6)</wrap> </WRAP> |<WRAP><wrap>compare_logical</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040148: 478060E0</wrap> </WRAP> |<WRAP><wrap>BC</wrap> </WRAP> |<WRAP><wrap>8,224(0,6)</wrap> </WRAP> |<WRAP><wrap>branch_on_condition</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004014C: 8840000A</wrap> </WRAP> |<WRAP><wrap>SRL</wrap> </WRAP> |<WRAP><wrap>4,10(0)</wrap> </WRAP> |<WRAP><wrap>shift_right_single_logical</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040150: 47F060E4</wrap> </WRAP> |<WRAP><wrap>BC</wrap> </WRAP> |<WRAP><wrap>15,228(0,6)</wrap> </WRAP> |<WRAP><wrap>branch_on_condition</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040154: 88400005</wrap> </WRAP> |<WRAP><wrap>SRL</wrap> </WRAP> |<WRAP><wrap>4,5(0)</wrap> </WRAP> |<WRAP><wrap>shift_right_single_logical</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040158: 9620820C</wrap> </WRAP> |<WRAP><wrap>OI</wrap> </WRAP> |<WRAP><wrap>524(8),32</wrap> </WRAP> |<WRAP><wrap>or_immediate</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004015C: 55C06058</wrap> </WRAP> |<WRAP><wrap>CL</wrap> </WRAP> |<WRAP><wrap>12,88(0,6)</wrap> </WRAP> |<WRAP><wrap>compare_logical</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040160: 478060F8</wrap> </WRAP> |<WRAP><wrap>BC</wrap> </WRAP> |<WRAP><wrap>8,248(0,6)</wrap> </WRAP> |<WRAP><wrap>branch_on_condition</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040164: 58506228</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>5,552(0,6)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040168: 47F060FC</wrap> </WRAP> |<WRAP><wrap>BC</wrap> </WRAP> |<WRAP><wrap>15,252(0,6)</wrap> </WRAP> |<WRAP><wrap>branch_on_condition</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004016C: 5850622C</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>5,556(0,6)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040170: 58AB0000</wrap> </WRAP> |<WRAP><wrap>L</wrap> </WRAP> |<WRAP><wrap>10,0(11,0)</wrap> </WRAP> |<WRAP><wrap>load</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040174: 12AA</wrap> </WRAP> |<WRAP><wrap>LTR</wrap> </WRAP> |<WRAP><wrap>10,10</wrap> </WRAP> |<WRAP><wrap>load_and_test_register</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040176: 4770611A</wrap> </WRAP> |<WRAP><wrap>BC</wrap> </WRAP> |<WRAP><wrap>7,282(0,6)</wrap> </WRAP> |<WRAP><wrap>branch_on_condition</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004017A: 94DF820C</wrap> </WRAP> |<WRAP><wrap>NI</wrap> </WRAP> |<WRAP><wrap>524(8),223</wrap> </WRAP> |<WRAP><wrap>and_immediate</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004017E: 9102022A</wrap> </WRAP> |<WRAP><wrap>TM</wrap> </WRAP> |<WRAP><wrap>554(0),2</wrap> </WRAP> |<WRAP><wrap>test_under_mask</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040182: 0717</wrap> </WRAP> |<WRAP><wrap>BCR</wrap> </WRAP> |<WRAP><wrap>1,7</wrap> </WRAP> |<WRAP><wrap>branch_on_condition_register</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040184: 980402B8</wrap> </WRAP> |<WRAP><wrap>LM</wrap> </WRAP> |<WRAP><wrap>0,4,696(0)</wrap> </WRAP> |<WRAP><wrap>load_multiple</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040188: 98DF02EC</wrap> </WRAP> |<WRAP><wrap>LM</wrap> </WRAP> |<WRAP><wrap>13,15,748(0)</wrap> </WRAP> |<WRAP><wrap>load_multiple</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004018C: 07F7</wrap> </WRAP> |<WRAP><wrap>BCR</wrap> </WRAP> |<WRAP><wrap>15,7</wrap> </WRAP> |<WRAP><wrap>branch_on_condition_register</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004018E: 465060FC</wrap> </WRAP> |<WRAP><wrap>BCT</wrap> </WRAP> |<WRAP><wrap>5,252(0,6)</wrap> </WRAP> |<WRAP><wrap>branch_on_count</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040192: 55A06230</wrap> </WRAP> |<WRAP><wrap>CL</wrap> </WRAP> |<WRAP><wrap>10,560(0,6)</wrap> </WRAP> |<WRAP><wrap>compare_logical</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P00040196: 4740620E</wrap> </WRAP> |<WRAP><wrap>BC</wrap> </WRAP> |<WRAP><wrap>4,526(0,6)</wrap> </WRAP> |<WRAP><wrap>branch_on_condition</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004019A: 48E301DC</wrap> </WRAP> |<WRAP><wrap>LH</wrap> </WRAP> |<WRAP><wrap>14,476(3,0)</wrap> </WRAP> |<WRAP><wrap>load_halfword</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P0004019E: 54A06234</wrap> </WRAP> |<WRAP><wrap>N</wrap> </WRAP> |<WRAP><wrap>10,564(0,6)</wrap> </WRAP> |<WRAP><wrap>and</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401A2: 15AE</wrap> </WRAP> |<WRAP><wrap>CLR</wrap> </WRAP> |<WRAP><wrap>10,14</wrap> </WRAP> |<WRAP><wrap>compare_logical_register</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401A4: 4720620E</wrap> </WRAP> |<WRAP><wrap>BC</wrap> </WRAP> |<WRAP><wrap>2,526(0,6)</wrap> </WRAP> |<WRAP><wrap>branch_on_condition</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401A8: B60082B0</wrap> </WRAP> |<WRAP><wrap>STCTL</wrap> </WRAP> |<WRAP><wrap>0,0,688(8)</wrap> </WRAP> |<WRAP><wrap>store_control</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401AC: B6000308</wrap> </WRAP> |<WRAP><wrap>STCTL</wrap> </WRAP> |<WRAP><wrap>0,0,776(0)</wrap> </WRAP> |<WRAP><wrap>store_control</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401B0: D40303086166</wrap> </WRAP> |<WRAP><wrap>NC</wrap> </WRAP> |<WRAP><wrap>776(4,0),358(6)</wrap> </WRAP> |<WRAP><wrap>and_character</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401B6: D6030308616A</wrap> </WRAP> |<WRAP><wrap>OC</wrap> </WRAP> |<WRAP><wrap>776(4,0),362(6)</wrap> </WRAP> |<WRAP><wrap>or_character</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401BC: B7000308</wrap> </WRAP> |<WRAP><wrap>LCTL</wrap> </WRAP> |<WRAP><wrap>0,0,776(0)</wrap> </WRAP> |<WRAP><wrap>load_control</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401C0: AD010308</wrap> </WRAP> |<WRAP><wrap>STOSM</wrap> </WRAP> |<WRAP><wrap>776(0),1</wrap> </WRAP> |<WRAP><wrap>store_then_or_system_mask</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401C4: ACFE0308</wrap> </WRAP> |<WRAP><wrap>STNSM</wrap> </WRAP> |<WRAP><wrap>776(0),254</wrap> </WRAP> |<WRAP><wrap>store_then_and_system_mask</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401C8: B6000308</wrap> </WRAP> |<WRAP><wrap>STCTL</wrap> </WRAP> |<WRAP><wrap>0,0,776(0)</wrap> </WRAP> |<WRAP><wrap>store_control</wrap> </WRAP> | |<WRAP><wrap>HHC02289I</wrap> </WRAP> |<WRAP><wrap>P000401CC: D60082B00308</wrap> </WRAP> |<WRAP><wrap>OC</wrap> </WRAP> |<WRAP><wrap>688(1,8),776(0)</wrap> </WRAP> |<WRAP><wrap>or_character</wrap> </WRAP> | |<WRAP><wrap>.</wrap> <wrap>remaining</wrap> </WRAP> |<WRAP><wrap>lines not displayed</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>.</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | **<wrap>Figure 338: U command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 597</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.191 UPTIME (Display Hercules Emulator uptime) \\ //8.191.1 Function//</wrap>** <wrap>The UPTIME console command displays how long the Hercules Emulator has been running.</wrap> **//<wrap>8.191.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>UPTIME</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>UPTIME</wrap> **//<wrap>8.191.3 Parameter</wrap>//** **<wrap>None.</wrap>** **//<wrap>8.191.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display how long the Hercules Emulator has been running so far (uptime < 1 day).</wrap> <wrap>HHC00013I Herc command: 'uptime' \\ HHC02208I Uptime 06:33:12</wrap> **<wrap>Figure 339: UPTIME command (uptime < 1 day).</wrap>** **<wrap>Example 2:</wrap>** <wrap>Display how long the Hercules Emulator has been running so far (uptime > 1 week).</wrap> <wrap>HHC00013I Herc command: 'uptime'</wrap> <wrap>HHC02208I Uptime 3 weeks, 5 days, 16:48:15.</wrap> **<wrap>Figure 340: UPTIME command (uptime > 1 week).</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 598</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.192 V (Display or alter virtual storage) \\ //8.192.1 Function//</wrap>** <wrap>The V command displays or alters virtual storage. Up to 64K of virtual storage can be displayed, up to 32 bytes of virtual storage can be altered.</wrap> **//<wrap>8.192.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>V [P | S | H] {</wrap>////<wrap>addr </wrap>////<wrap>| </wrap>////<wrap>addr.length </wrap>////<wrap>| </wrap>////<wrap>addr-addr </wrap>////<wrap>| addr=value}</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ</wrap>////<wrap>¬¬¬ V ¬¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬ addr ¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap>// //<wrap>ª¬¬¬ P ¬¬¬« ª¬¬¬ </wrap>////<wrap>addr.length ¬¬¬« \\ </wrap>////<wrap>ª¬¬¬ S ¬¬¬« ª¬¬¬</wrap>////<wrap>¬ addr-addr ¬¬¬¬«</wrap>// //<wrap>⡿¬¬¬ H ¬¬¬¯ ⡿¬¬</wrap>////<wrap>¬ </wrap>////<wrap>addr=value </wrap>////<wrap>¬¬¬</wrap>////<wrap>¬¯</wrap>// **//<wrap>8.192.3 Parameter</wrap>//** **<wrap>P </wrap>**<wrap>The optional 'P' argument will force primary space address translation mode instead of current PSW mode.</wrap> **<wrap>S </wrap>**<wrap>The optional 'P' argument will force secondary space address translation mode instead of current PSW mode.</wrap> **<wrap>H </wrap>**<wrap>The optional 'H' argument will force home space address translation mode instead of current PSW mode.</wrap> **//<wrap>addr </wrap>//**<wrap>Specifies the address of the virtual storage that is to be displayed. If //addr //is given without a length or without a second address for the end of the storage area then 64 bytes of virtual storage are displayed.</wrap> **//<wrap>addr.length </wrap>//**<wrap>Specifies the address of the virtual storage area that is to be displayed with starting address and length (from address //addr //with the length of //length//). The //length //value must be given in hexadecimal. The maximum length that can be specified is 64K.</wrap> **//<wrap>addr-addr </wrap>//**<wrap>Specifies an address range with start and end address (from begin address to end address) of the virtual storage area that is to be displayed.</wrap> **//<wrap>addr=value </wrap>//**<wrap>Specifies the address of the virtual storage area that is to be altered. //value //is a hex-string of up to 32 pairs of digits (32 bytes) which will be written to the virtual storage address given by the //addr //parameter. After altering the storage, 16 bytes of real storage starting at //addr //are displayed.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 599</wrap> <wrap>\\ </wrap>**//<wrap>8.192.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display 256 (x’FF’) bytes of virtual storage starting from address x’00010000’.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: ‘v 00010000.ff’ \\ HHC02291I V:00010000 (primary) R:00010000</wrap> |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010000:K:04=4770A1C8</wrap> </WRAP> |<WRAP><wrap>5820901C</wrap> </WRAP> |<WRAP><wrap>47F0A1F0</wrap> </WRAP> |<WRAP><wrap>91802003</wrap> </WRAP> |<WRAP><wrap>..~H... 0~0j...</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010010:K:04=47E0A1EC</wrap> </WRAP> |<WRAP><wrap>58202004</wrap> </WRAP> |<WRAP><wrap>47F0A1F0</wrap> </WRAP> |<WRAP><wrap>96803200</wrap> </WRAP> |<WRAP><wrap>.%%\%%~.... 0~0o...</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010020:K:04=91803200</wrap> </WRAP> |<WRAP><wrap>4770A1FE</wrap> </WRAP> |<WRAP><wrap>12224770</wrap> </WRAP> |<WRAP><wrap>A1DC5850</wrap> </WRAP> |<WRAP><wrap>j__ ~ ~ __&</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010030:K:04=30201FCC</wrap> </WRAP> |<WRAP><wrap>195C4770</wrap> </WRAP> |<WRAP><wrap>A01C50C0</wrap> </WRAP> |<WRAP><wrap>30245820</wrap> </WRAP> |<WRAP><wrap>.....*....&{....</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010040:K:04=30089140</wrap> </WRAP> |<WRAP><wrap>320047E0</wrap> </WRAP> |<WRAP><wrap>A28441B0</wrap> </WRAP> |<WRAP><wrap>202C58D0</wrap> </WRAP> |<WRAP><wrap>..j ...%%\%%sd... }</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010050:K:04=02FC98CD</wrap> </WRAP> |<WRAP><wrap>D19005ED</wrap> </WRAP> |<WRAP><wrap>58C031F4</wrap> </WRAP> |<WRAP><wrap>12CC4780</wrap> </WRAP> |<WRAP><wrap>..q.J....{.4....</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010060:K:04=A24E9120</wrap> </WRAP> |<WRAP><wrap>300047E0</wrap> </WRAP> |<WRAP><wrap>A2424160</wrap> </WRAP> |<WRAP><wrap>203047F0</wrap> </WRAP> |<WRAP><wrap>s+j....%%\%%s..-. 0</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010070:K:04=A2464160</wrap> </WRAP> |<WRAP><wrap>20485870</wrap> </WRAP> |<WRAP><wrap>31F445E0</wrap> </WRAP> |<WRAP><wrap>A2E458C0</wrap> </WRAP> |<WRAP><wrap>s..-.....4.%%\%%sU.{</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010080:K:04=31F812CC</wrap> </WRAP> |<WRAP><wrap>4780A262</wrap> </WRAP> |<WRAP><wrap>187C4160</wrap> </WRAP> |<WRAP><wrap>203045E0</wrap> </WRAP> |<WRAP><wrap>.8....s..@.-. %%\%%</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010090:K:04=A2E458C0</wrap> </WRAP> |<WRAP><wrap>31FC12CC</wrap> </WRAP> |<WRAP><wrap>4780A276</wrap> </WRAP> |<WRAP><wrap>187C4160</wrap> </WRAP> |<WRAP><wrap>sU.{......s..@.-</wrap><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100A0:K:04=204045E0</wrap> </WRAP> |<WRAP><wrap>A2E441B0</wrap> </WRAP> |<WRAP><wrap>202C58D0</wrap> </WRAP> |<WRAP><wrap>02FC98CD</wrap> </WRAP> |<WRAP><wrap>. .%%\%%sU.....}..q.</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100B0:K:04=D19C05ED</wrap> </WRAP> |<WRAP><wrap>91803001</wrap> </WRAP> |<WRAP><wrap>4770A2DA</wrap> </WRAP> |<WRAP><wrap>1FCC59C0</wrap> </WRAP> |<WRAP><wrap>J...j.....s.. {</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100C0:K:04=30504780</wrap> </WRAP> |<WRAP><wrap>A2A691C0</wrap> </WRAP> |<WRAP><wrap>32004770</wrap> </WRAP> |<WRAP><wrap>A2A659C0</wrap> </WRAP> |<WRAP><wrap>.&..swj{....sw.{</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100D0:K:04=200C4780</wrap> </WRAP> |<WRAP><wrap>A2DA58C0</wrap> </WRAP> |<WRAP><wrap>305412CC</wrap> </WRAP> |<WRAP><wrap>4770A2DA</wrap> </WRAP> |<WRAP><wrap>....s..{......s.</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100E0:K:04=1F114180</wrap> </WRAP> |<WRAP><wrap>0001BA18</wrap> </WRAP> |<WRAP><wrap>30544770</wrap> </WRAP> |<WRAP><wrap>A2DA5810</wrap> </WRAP> |<WRAP>__<wrap>s </wrap>__<wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100F0:K:04=305858F0</wrap> </WRAP> |<WRAP><wrap>001058F0</wrap> </WRAP> |<WRAP><wrap>F2645800</wrap> </WRAP> |<WRAP><wrap>F0005000</wrap> </WRAP> |<WRAP><wrap>...0...02...0.&.</wrap> </WRAP> | **<wrap>Figure 341: V command (display virtual storage with length)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Change virtual storage at address x’00010000’ to x’FFFFFFFF’.</wrap> <wrap>HHC00013I Herc command: ‘v 00010000=FFFFFFFF’ \\ HHC02291I V:00010000 (primary) R:00010000</wrap> <wrap>HHC02291I V:00010000:K:06=FFFFFFFF 5820901C 47F0A1F0 91802003 ......... 0~0j...</wrap> **<wrap>Figure 342: V command (alter virtual storage)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Display virtual storage from address x’00010000’ to adress x’00010100’.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: ‘v 00010000-00010100’ \\ HHC02291I V:00010000 (primary) R:00010000</wrap> |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010000:K:06=FFFFFFFF</wrap> </WRAP> |<WRAP><wrap>5820901C</wrap> </WRAP> |<WRAP><wrap>47F0A1F0</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap>91802003 </wrap> <wrap>0~0j...</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010010:K:06=47E0A1EC</wrap> </WRAP> |<WRAP><wrap>58202004</wrap> </WRAP> |<WRAP><wrap>47F0A1F0</wrap> </WRAP> |<WRAP><wrap>96803200</wrap> </WRAP> |<WRAP><wrap>.%%\%%~.... 0~0o...</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010020:K:06=91803200</wrap> </WRAP> |<WRAP><wrap>4770A1FE</wrap> </WRAP> |<WRAP><wrap>12224770</wrap> </WRAP> |<WRAP><wrap>A1DC5850</wrap> </WRAP> |<WRAP><wrap>j__ ~ ~ __&</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010030:K:06=30201FCC</wrap> </WRAP> |<WRAP><wrap>195C4770</wrap> </WRAP> |<WRAP><wrap>A01C50C0</wrap> </WRAP> |<WRAP><wrap>30245820</wrap> </WRAP> |<WRAP><wrap>.....*....&{....</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010040:K:06=30089140</wrap> </WRAP> |<WRAP><wrap>320047E0</wrap> </WRAP> |<WRAP><wrap>A28441B0</wrap> </WRAP> |<WRAP><wrap>202C58D0</wrap> </WRAP> |<WRAP><wrap>..j ...%%\%%sd... }</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010050:K:06=02FC98CD</wrap> </WRAP> |<WRAP><wrap>D19005ED</wrap> </WRAP> |<WRAP><wrap>58C031F4</wrap> </WRAP> |<WRAP><wrap>12CC4780</wrap> </WRAP> |<WRAP><wrap>..q.J....{.4....</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010060:K:06=A24E9120</wrap> </WRAP> |<WRAP><wrap>300047E0</wrap> </WRAP> |<WRAP><wrap>A2424160</wrap> </WRAP> |<WRAP><wrap>203047F0</wrap> </WRAP> |<WRAP><wrap>s+j....%%\%%s..-.. 0</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010070:K:06=A2464160</wrap> </WRAP> |<WRAP><wrap>20485870</wrap> </WRAP> |<WRAP><wrap>31F445E0</wrap> </WRAP> |<WRAP><wrap>A2E458C0</wrap> </WRAP> |<WRAP><wrap>s..-.....4.%%\%%sU.{</wrap> </WRAP> | <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 600</wrap> <wrap>\\ </wrap>|<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010080:K:06=31F812CC</wrap> </WRAP> |<WRAP><wrap>4780A262</wrap> </WRAP> |<WRAP><wrap>187C4160</wrap> </WRAP> |<WRAP><wrap>203045E0</wrap> </WRAP> |<WRAP><wrap>.8....s..@.-...%%\%%</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010090:K:06=A2E458C0</wrap> </WRAP> |<WRAP><wrap>31FC12CC</wrap> </WRAP> |<WRAP><wrap>4780A276</wrap> </WRAP> |<WRAP><wrap>187C4160</wrap> </WRAP> |<WRAP><wrap>sU.{......s..@.-</wrap><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100A0:K:06=204045E0</wrap> </WRAP> |<WRAP><wrap>A2E441B0</wrap> </WRAP> |<WRAP><wrap>202C58D0</wrap> </WRAP> |<WRAP><wrap>02FC98CD</wrap> </WRAP> |<WRAP><wrap>. .%%\%%sU.....}..q.</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100B0:K:06=D19C05ED</wrap> </WRAP> |<WRAP><wrap>91803001</wrap> </WRAP> |<WRAP><wrap>4770A2DA</wrap> </WRAP> |<WRAP><wrap>1FCC59C0</wrap> </WRAP> |<WRAP><wrap>J...j.....s....{</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100C0:K:06=30504780</wrap> </WRAP> |<WRAP><wrap>A2A691C0</wrap> </WRAP> |<WRAP><wrap>32004770</wrap> </WRAP> |<WRAP><wrap>A2A659C0</wrap> </WRAP> |<WRAP><wrap>.&..swj{....sw.{</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100D0:K:06=200C4780</wrap> </WRAP> |<WRAP><wrap>A2DA58C0</wrap> </WRAP> |<WRAP><wrap>305412CC</wrap> </WRAP> |<WRAP><wrap>4770A2DA</wrap> </WRAP> |<WRAP><wrap>....s..{......s.</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100E0:K:06=1F114180</wrap> </WRAP> |<WRAP><wrap>0001BA18</wrap> </WRAP> |<WRAP><wrap>30544770</wrap> </WRAP> |<WRAP><wrap>A2DA5810</wrap> </WRAP> |<WRAP>__<wrap>s </wrap>__<wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100F0:K:06=305858F0</wrap> </WRAP> |<WRAP><wrap>001058F0</wrap> </WRAP> |<WRAP><wrap>F2645800</wrap> </WRAP> |<WRAP><wrap>F0005000</wrap> </WRAP> |<WRAP><wrap>...0...02...0.&.</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010100:K:06=1004BA01</wrap> </WRAP> |<WRAP><wrap>F0004770</wrap> </WRAP> |<WRAP><wrap>A2CE982E</wrap> </WRAP> |<WRAP><wrap>31C0947F</wrap> </WRAP> |<WRAP><wrap>....0...s.q..{m"</wrap> </WRAP> | **<wrap>Figure 343: V command (display virtual storage with range)</wrap>** **<wrap>Example 4:</wrap>** <wrap>Display 256 (x’FF’) bytes of virtual storage starting from address x’00010000’. Force Secondary translation instead of current PSW mode.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>HHC00013I Herc command: ‘v s 00010000.ff’ \\ HHC02291I V:00010000 (secondary) R:00010000</wrap> |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010000:K:04=4770A1C8</wrap> </WRAP> |<WRAP><wrap>5820901C</wrap> </WRAP> |<WRAP><wrap>47F0A1F0</wrap> </WRAP> |<WRAP><wrap>91802003</wrap> </WRAP> |<WRAP><wrap>..~H... 0~0j...</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010010:K:04=47E0A1EC</wrap> </WRAP> |<WRAP><wrap>58202004</wrap> </WRAP> |<WRAP><wrap>47F0A1F0</wrap> </WRAP> |<WRAP><wrap>96803200</wrap> </WRAP> |<WRAP><wrap>.%%\%%~.... 0~0o...</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010020:K:04=91803200</wrap> </WRAP> |<WRAP><wrap>4770A1FE</wrap> </WRAP> |<WRAP><wrap>12224770</wrap> </WRAP> |<WRAP><wrap>A1DC5850</wrap> </WRAP> |<WRAP><wrap>j__ ~ ~ __&</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010030:K:04=30201FCC</wrap> </WRAP> |<WRAP><wrap>195C4770</wrap> </WRAP> |<WRAP><wrap>A01C50C0</wrap> </WRAP> |<WRAP><wrap>30245820</wrap> </WRAP> |<WRAP><wrap>.....*....&{....</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010040:K:04=30089140</wrap> </WRAP> |<WRAP><wrap>320047E0</wrap> </WRAP> |<WRAP><wrap>A28441B0</wrap> </WRAP> |<WRAP><wrap>202C58D0</wrap> </WRAP> |<WRAP><wrap>..j ...%%\%%sd... }</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010050:K:04=02FC98CD</wrap> </WRAP> |<WRAP><wrap>D19005ED</wrap> </WRAP> |<WRAP><wrap>58C031F4</wrap> </WRAP> |<WRAP><wrap>12CC4780</wrap> </WRAP> |<WRAP><wrap>..q.J....{.4....</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010060:K:04=A24E9120</wrap> </WRAP> |<WRAP><wrap>300047E0</wrap> </WRAP> |<WRAP><wrap>A2424160</wrap> </WRAP> |<WRAP><wrap>203047F0</wrap> </WRAP> |<WRAP><wrap>s+j....%%\%%s..-. 0</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010070:K:04=A2464160</wrap> </WRAP> |<WRAP><wrap>20485870</wrap> </WRAP> |<WRAP><wrap>31F445E0</wrap> </WRAP> |<WRAP><wrap>A2E458C0</wrap> </WRAP> |<WRAP><wrap>s..-.....4.%%\%%sU.{</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010080:K:04=31F812CC</wrap> </WRAP> |<WRAP><wrap>4780A262</wrap> </WRAP> |<WRAP><wrap>187C4160</wrap> </WRAP> |<WRAP><wrap>203045E0</wrap> </WRAP> |<WRAP><wrap>.8....s..@.-. %%\%%</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:00010090:K:04=A2E458C0</wrap> </WRAP> |<WRAP><wrap>31FC12CC</wrap> </WRAP> |<WRAP><wrap>4780A276</wrap> </WRAP> |<WRAP><wrap>187C4160</wrap> </WRAP> |<WRAP><wrap>sU.{......s..@.-</wrap><wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100A0:K:04=204045E0</wrap> </WRAP> |<WRAP><wrap>A2E441B0</wrap> </WRAP> |<WRAP><wrap>202C58D0</wrap> </WRAP> |<WRAP><wrap>02FC98CD</wrap> </WRAP> |<WRAP><wrap>. .%%\%%sU.....}..q.</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100B0:K:04=D19C05ED</wrap> </WRAP> |<WRAP><wrap>91803001</wrap> </WRAP> |<WRAP><wrap>4770A2DA</wrap> </WRAP> |<WRAP><wrap>1FCC59C0</wrap> </WRAP> |<WRAP><wrap>J...j.....s.. {</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100C0:K:04=30504780</wrap> </WRAP> |<WRAP><wrap>A2A691C0</wrap> </WRAP> |<WRAP><wrap>32004770</wrap> </WRAP> |<WRAP><wrap>A2A659C0</wrap> </WRAP> |<WRAP><wrap>.&..swj{....sw.{</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100D0:K:04=200C4780</wrap> </WRAP> |<WRAP><wrap>A2DA58C0</wrap> </WRAP> |<WRAP><wrap>305412CC</wrap> </WRAP> |<WRAP><wrap>4770A2DA</wrap> </WRAP> |<WRAP><wrap>....s..{......s.</wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100E0:K:04=1F114180</wrap> </WRAP> |<WRAP><wrap>0001BA18</wrap> </WRAP> |<WRAP><wrap>30544770</wrap> </WRAP> |<WRAP><wrap>A2DA5810</wrap> </WRAP> |<WRAP>__<wrap>s </wrap>__<wrap></wrap> </WRAP> | |<WRAP><wrap>HHC02291I</wrap> </WRAP> |<WRAP><wrap>V:000100F0:K:04=305858F0</wrap> </WRAP> |<WRAP><wrap>001058F0</wrap> </WRAP> |<WRAP><wrap>F2645800</wrap> </WRAP> |<WRAP><wrap>F0005000</wrap> </WRAP> |<WRAP><wrap>...0...02...0.&.</wrap> </WRAP> | **<wrap>Figure 344: V command (display virtual storage with ‘S’ option)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 601</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.193 VERSION (Display version information) \\ //8.193.1 Function//</wrap>** <wrap>The version command is used to display various version and build information about the Hercules emulator.</wrap> **//<wrap>8.193.2 Syntax</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>VERSION</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ VERSION</wrap>** **//<wrap>8.193.3 Parameter</wrap>//** <wrap>None.</wrap> **//<wrap>8.193.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the Hercules version information.</wrap> <wrap>HHC00013I Herc command: 'version'</wrap> <wrap>HHC01413I Hercules version 3.07-svn-6583</wrap> <wrap>HHC01414I (c) Copyright 1999-2010 by Roger Bowler, Jan Jaeger, and others</wrap> <wrap>HHC01415I Built on Sep 24 2010 at 23:46:56</wrap> <wrap>HHC01416I Build information:</wrap> <wrap>HHC01417I Windows (MSVC) build for i386</wrap> <wrap>HHC01417I Modes: S/370 ESA/390 z/Arch</wrap> <wrap>.</wrap> //<wrap>several lines not displayed</wrap>// <wrap>.</wrap> <wrap>HHC01417I Regular Expressions support</wrap> <wrap>HHC01417I Automatic Operator support</wrap> <wrap>HHC01417I Machine dependent assists: cmpxchg1 cmpxchg4 cmpxchg8 fetch_dw store_dw</wrap> <wrap>HHC01417I Running on GOOFY Windows-6.1.7600. 7 Ultimate Edition, 32-bit i686 MP=8</wrap> **<wrap>Figure 345: VERSION command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 602</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.194 XPNDSIZE (Display or set expanded storage size) //8.194.1 Function//</wrap>** <wrap>The XPNDSIZE command is used to specify the size of the main storage in megabytes. Given without an argument the XPNDSIZE command displays the current size of the expanded storage. Storage is allocated in megabytes, unless a specific unit is specified. The actual upper limit of the expanded storage is determined by the host system's architecture, operating system, and on some systems the amount of physical memory and paging space you have available. The lower limit is 0.</wrap> <wrap>The practical limit depends on the maximum amount of storage that can be obtained by “malloc” (usually around 1 GB on 32-bit platforms; on 64-bit platforms the value should only be limited by available paging space).</wrap> <wrap>When increasing the expanded size Hercules attempts to allocate first the new storage. If the new allocation is successful then the previously allocated memory will be freed. This is to prevent a situation where the old memory is freed first, then the new allocation fails and a reallocation of the memory in the previous size also fails because of storage fragmentation and therefore leaving Hercules without memory.</wrap> <wrap>When decreasing the expanded storage the memory will stay allocated in the previous size but the storage size will appear as decreased. Subsequent increases will not reallocate memory unless they go over the already allocated amount.</wrap> <wrap>An additional optional argument determines the locking state of the allocated memory (page lock by host operating system). The LOCKED option indicates that the memory is to be locked into storage while UNLOCKED (the default) indicates that the memory is not locked into the storage.</wrap> <wrap>Please note that Hercules preserves the last locking state of XPNDSIZE. Once storage is locked, any subsequent change to the expanded storage size will honor the existing lock state of memory unless the lock state is specified again on the XPNDSIZE command.</wrap> **<wrap>Caution: </wrap>**<wrap>Do not lock expanded storage unless sufficient real memory is available to back up the request. Failure to do so may require the host system to be rebooted.</wrap> **//<wrap>8.194.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>XPNDSIZE [</wrap>//<wrap>xsize</wrap>//<wrap>[M | G | 1] [UNLOCK | LOCK]]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ XPNDSIZE¬¬¬§¬¬¬¬¬¬¬¬¬¬¬ ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap> ~¬¬¬ M ¬¬¬® ~¬¬¬ UNLOCK ¬¬¬® \\ ⡿¬¬¬ </wrap>//<wrap>xsize </wrap>//<wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¯</wrap> <wrap>ª¬¬¬ G ¬¬¬« ⡿¬¬¬¬ LOCK ¬¬¬¬¯ \\ ⡿¬¬¬ T ¬¬¬¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 603</wrap> <wrap>\\ </wrap>**//<wrap>8.194.3 Parameter</wrap>//** **//<wrap>size </wrap>//**<wrap>The value of //xsize //must be a valid decimal number. The actual upper limit is determined by the host system’s architecture, the operating system and on some systems the amount of physical memory and paging space that is available.</wrap> <wrap>Storage sizes not on a 1M boundary are rounded up to the next 1M boundary. The lower limit and default is 0.</wrap> **<wrap>M </wrap>**<wrap>‘M’ determines that the number given is specified in megabytes (multiplier 2%%**%%20). This is the default if no unit is appended.</wrap> **<wrap>G </wrap>**<wrap>‘G’ determines that the number given is specified in gigabytes (multiplier 2%%**%%30).</wrap> **<wrap>T </wrap>**<wrap>‘T’ determines that the number given is specified in terabytes (multiplier 2%%**%%40). On 32-bit machines the unit terabytes is not available.</wrap> **<wrap>LOCK </wrap>**<wrap>Attempt to lock the storage (pages locked by the host operating system).</wrap> **<wrap>UNLOCK </wrap>**<wrap>Leave the store unlocked (no pages locked by the host operating system). This is the default.</wrap> **<wrap>Notes:</wrap>** <wrap>The actual upper limit is determined by the host system’s architecture and operating system, the guest operating system and the amount of physical memory and available paging space.</wrap> <wrap>The total of MAINSIZE and XPNDSIZE on host systems with a 32-bit architecture will be limited to less than 4G; host systems with a 64-bit architecture will be limited to less than 16E.</wrap> <wrap>Use of storage sizes greater than supported by the guest operating system may generate incorrect results or error conditions within the guest operating system.</wrap> **//<wrap>8.194.4 Overview Storage Allocation Units</wrap>//** |<WRAP>**<wrap>Unit</wrap>** </WRAP> |<WRAP>**<wrap>Multiplier</wrap>** </WRAP> |<WRAP>**<wrap>Name (Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>IEC Name (IEC Symbol)</wrap>** </WRAP> |<WRAP>**<wrap>Restrictions</wrap>** </WRAP> | |<WRAP><wrap>M</wrap> </WRAP> |<WRAP><wrap>2%%**%%20</wrap> </WRAP> |<WRAP><wrap>Megabyte (MB)</wrap> </WRAP> |<WRAP><wrap>Mebibyte (MiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>G</wrap> </WRAP> |<WRAP><wrap>2%%**%%30</wrap> </WRAP> |<WRAP><wrap>Gigabyte (GB)</wrap> </WRAP> |<WRAP><wrap>Gibibyte (GiB)</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>T</wrap> </WRAP> |<WRAP><wrap>2%%**%%40</wrap> </WRAP> |<WRAP><wrap>Terabyte (TB)</wrap> </WRAP> |<WRAP><wrap>Tebibyte (TiB)</wrap> </WRAP> |<WRAP><wrap>Not on 32-bit machines</wrap> </WRAP> | **<wrap>Table 24: Storage Allocation Units</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 604</wrap> <wrap>\\ </wrap>**//<wrap>8.194.5 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Display the current size of the expanded storage.</wrap> <wrap>HHC00013I Herc command: 'xpndsize'</wrap> <wrap>HHC17003I EXPANDED storage is 256 MBytes 'xpndsize'; storage is not locked</wrap> **<wrap>Figure 346: XPNDSIZE command (display size of expanded storage)</wrap>** **<wrap>Example 2:</wrap>** <wrap>Set the size of the expanded storage to 128 MB. Do not lock the memory into the storage.</wrap> <wrap>HHC00013I Herc command: 'xpndsize 128'</wrap> <wrap>HHC17003I EXPANDED storage is 128 MBytes 'xpndsize'; storage is not locked</wrap> **<wrap>Figure 347: XPNDSIZE command (set size of unlocked expanded storage)</wrap>** **<wrap>Example 3:</wrap>** <wrap>Set the size of the expanded storage to 512 MB. Lock the memory into the storage.</wrap> <wrap>HHC00013I Herc command: 'xpndsize 512 lock'</wrap> <wrap>HHC01428I Locking expanded storage</wrap> <wrap>HHC17003I EXPANDED storage is 512 MBytes 'xpndsize'; storage is locked</wrap> **<wrap>Figure 348: XPNDSIZE command (set size of locked expanded storage)</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 605</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>8.195 YROFFSET (Set TOD clock offset from actual date) //8.195.1 Function//</wrap>** <wrap>The YROFFSET command specifies the number of years the TOD clock is offset from the actual date. Positive numbers will move the clock forward in time while negative numbers will move it backward. A common value for non-Y2K-compliant operating systems is YROFFSET -28 which has the advantage that the day of the week and the presence or absence of February 29 is the same as the current year.</wrap> **//<wrap>8.195.2 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>YROFFSET {</wrap>////<wrap>+years </wrap>////<wrap>| </wrap>////<wrap>-years</wrap>////<wrap>}</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬YROFFSET ¬¬¬§¬¬¬ </wrap>////<wrap>+years </wrap>//<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ </wrap>//<wrap>⡿¬¬¬</wrap>////<wrap>-years </wrap>////<wrap>¬¬¬¯</wrap>// **//<wrap>8.195.3 Parameter</wrap>//** **<wrap>+//years //</wrap>**<wrap>Specifies the number of years the TOD clock is offset positive from the actual date. This value may not be specified as greater than +/-142 years, the total range of the TOD clock. Specifying a value that causes the computed TOD clock year to be more than 142 years later than SYSEPOCH will produce unexpected results.</wrap> **<wrap>-//years //</wrap>**<wrap>Specifies the number of years the TOD clock is offset positive from the actual date. This value may not be specified as greater than +/-142 years, the total range of the TOD clock. Specifying a value that causes the computed TOD clock year to be earlier than the value of SYSEPOCH will produce unexpected results.</wrap> **//<wrap>8.195.4 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Specify 28 years to offset the TOD clock from the actual date.</wrap> <wrap>HHC00013I Herc command: 'yroffset -28'</wrap> <wrap>HHC02204I yroffset set to -28</wrap> **<wrap>Figure 349: YROFFSET command</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 606</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap></wrap>**<wrap>9. Shared Device Support</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>9.1 Basics</wrap>** <wrap>Shared Device Support (see also "General Information" manual) allows multiple Hercules instances to share devices. The device will be local to one Hercules instance and remote to all other Hercules instances. The local instance is the server for that device and the remote instances are the clients. It is possible that each instance acts as both a client and a server. If a local instance declares a device as remote on another instance and on this remote instance the device is defined again as remote on a third instance, then the original instance will have to hop through this second instance to get to the real device.</wrap> <wrap>It is not necessary to IPL an operating system on the device server. Any number of Hercules instances can act as a server in a "HERCPLEX".</wrap> <wrap>When "SHRDPORT" is specified in the Hercules configuration the thread "shared_server" is started at the end of Hercules initialization. If Shared Device Support is requested on a device statement then the Hercules instances cannot initialize these devices until the server is started on each system. In this case the device trying to access a server gets the 'connecting' bit set on in the DEVBLK and the device still needs to initialize. After the shared server is started a thread is attached for each device that is connecting to complete the connection (the device init handler).</wrap> <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>9.2 Caching</wrap>** <wrap>Cached records (i.e. CKD tracks or FBA blocks) are kept independently on both the client and server sides. Whenever the client issues a START request to initiate a channel program, the server will return a list of records to purge from the clients cache. These will have been updated by other clients since the last START request. If the list is too large the server will indicate that the client should purge all records for the device.</wrap> <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>9.3 Compression</wrap>** <wrap>Data that would normally be transferred uncompressed between the client and the host can optionally be compressed by specifying the "COMP=n" keyword on the device configuration statement (see below) or on the attach command. The value n of the "COMP=n" keyword is the zlib compression parameter which must be a number between 1 and 9. A value closer to 1 means less compression but less processor time to perform the compression. A value closer to 9 means the data is compressed more but also more processor time is required to compress the data.</wrap> <wrap>If the server is on localhost then you should not specify compression. Otherwise you are just stealing processor time from Hercules to facilitate compression/decompression. If the server is on a local network then a low value such as 1, 2 or 3 is recommended. There is a tradeoff curve, attempting to trade CPU cycles for network traffic to derive an optimal throughput.</wrap> <wrap>If the devices on the server are compressed devices (i.e. CCKD or CFBA) then the records (track images or block groups) may be transferred compressed regardless of the "COMP=n" settings. This depends on whether the client supports the compression type (zlib or bzip2) of the record on the server and whether the record is actually compressed in the server cache.</wrap> <wrap>An example may help to explain this: Suppose on the client that you execute one or more channel programs to read a record on a CKD track, update a record on the same track, and then read another (or the same) record on the track. For the first read the server will read the track image and pass it to the client as it was originally compressed in the file. To update a portion of the track image the server must uncom-press the track image so data in it can be updated. When the client next reads from the track image the track image is uncompressed.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 607</wrap> <wrap>\\ </wrap><wrap>Specifying "COMP=n" means that uncompressed data sent to the client will be compressed. If the data to be sent to the client is already compressed then the data is sent as is unless the client has indicated that it does not support that compression algorithm.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>9.4 Usage of Shared Devices</wrap>** <wrap>To use a device on a remote Hercules instance, instead of specifying a file name on the device statement, an IP address or a DNS name is specified.</wrap> **//<wrap>9.4.1 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>loc devnum devtype host</wrap>//<wrap>[</wrap>//<wrap>:port </wrap>//<wrap>| </wrap>__<wrap>:3990</wrap>__<wrap>] [</wrap>//<wrap>:rem devnum</wrap>//<wrap>] [COMP=</wrap>//<wrap>n</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** |<WRAP><wrap>ÊÊ¬¬¬ </wrap>//<wrap>loc devnum </wrap>//<wrap>¬¬¬ </wrap>//<wrap>devtype </wrap>//<wrap>¬¬¬ </wrap>//<wrap>host</wrap>// </WRAP> |<WRAP><wrap>~¬¬¬ :3990 ¬¬¬®</wrap> <wrap>¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ⡿¬¬¬</wrap>//<wrap>:port </wrap>//<wrap>¬¬¬¯</wrap> </WRAP> | //<wrap>:rem devnum </wrap>//<wrap>¬¬¬ ⡿¬¬¬COMP=</wrap>//<wrap>n</wrap>// **//<wrap>9.4.2 Parameter</wrap>//** **//<wrap>loc_devnum </wrap>//**<wrap>This specifies the device address on the local Hercules instance.</wrap> **//<wrap>devtype </wrap>//****<wrap>x </wrap>**<wrap>This is the device type.</wrap> **//<wrap>host </wrap>//**<wrap>This specifies the host name or the IP address of the system where the Shared Device Server is running.</wrap> **//<wrap>port </wrap>//**<wrap>The port number on which the Shared Device Server is listening. If the port number is omitted then the default port (3990) is used.</wrap> **//<wrap>rem_devnum </wrap>//**<wrap>This is the device address of the device on the remote Hercules instance. If the remote device address is omitted then the default is the current device number on the local system.</wrap> **<wrap>COM P=//n //</wrap>**<wrap>This keyword requests that the data has to be transferred compressed between the client and the server. The argument //n //specifies the compression level (1-9). A value closer to 1 means less compression but also less processor time to perform the compression. A value closer to 9 means the data is compressed more but also more processor time is required to compress the data.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 608</wrap> <wrap>\\ </wrap>**//<wrap>9.4.3 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>There is a shared device server on the local host listening on port 3990 and we want to use its 0100 device as our 0100 device. The device statement will look like this:</wrap> <wrap>0100 3390 localhost:3990:0100</wrap> <wrap>Because the default port number is actually 3990 and the default remote device address is the same as the local device number the above statement (providing we do not have actually a file named 'localhost' ) could be shortened as follows:</wrap> <wrap>0100 3390 localhost</wrap> **<wrap>Example 2:</wrap>** <wrap>Device sharing can also be split between multiple instances. For example, suppose the following device definitions and system parameter for instance A:</wrap> <wrap>SHRDPORT 3990</wrap> <wrap>0100 3390 localhost:3991</wrap> <wrap>0101 3390 mvscat.dasd</wrap> <wrap>And for instance B we have the following device definitions and system parameter:</wrap> <wrap>SHRDPORT 3991</wrap> <wrap>0100 3390 mvsres.dasd</wrap> <wrap>0101 3390 localhost</wrap> <wrap>In this case each instance acts as both a client and a server. Both instances of Hercules are running on the same machine.</wrap> <wrap>The above examples may be clearer if we specify also all the default values. To show this the same configuration is used but in this case the Hercules instances are running on separate physical machines:</wrap> <wrap>Hercules instance A (machine IP 192.168.200.1):</wrap> |<WRAP><wrap>SHRDPORT</wrap> </WRAP> |<WRAP><wrap>3990</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>0100 3390</wrap> </WRAP> |<WRAP><wrap>192.168.200.2:3991:0100</wrap> </WRAP> |<WRAP><wrap>#</wrap> </WRAP> |<WRAP><wrap>Remote</wrap> </WRAP> |<WRAP><wrap>on</wrap> </WRAP> |<WRAP><wrap>192.168.200.2</wrap> </WRAP> |<WRAP><wrap>(mvsres.dasd)</wrap> </WRAP> | |<WRAP><wrap>0101 3390</wrap> </WRAP> |<WRAP><wrap>mvscat.dasd</wrap> </WRAP> |<WRAP><wrap>#</wrap> </WRAP> |<WRAP><wrap>Local</wrap> </WRAP> |<WRAP><wrap>on</wrap> </WRAP> |<WRAP><wrap>192.168.200.1</wrap> </WRAP> |<WRAP><wrap>(mvscat.dasd)</wrap> </WRAP> | |<WRAP><wrap>Hercules instance B (machine IP 192.168.200.2):</wrap> </WRAP> |||<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>SHRDPORT</wrap> </WRAP> |<WRAP><wrap>3991</wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> |<WRAP><wrap></wrap> </WRAP> | |<WRAP><wrap>0100 3390</wrap> </WRAP> |<WRAP><wrap>mvsres.dasd</wrap> </WRAP> |<WRAP><wrap>#</wrap> </WRAP> |<WRAP><wrap>Local</wrap> </WRAP> |<WRAP><wrap>on</wrap> </WRAP> |<WRAP><wrap>192.168.200.2</wrap> </WRAP> |<WRAP><wrap>(mvsres.dasd)</wrap> </WRAP> | |<WRAP><wrap>0101 3390</wrap> </WRAP> |<WRAP><wrap>192.168.200.1:3990:0101</wrap> </WRAP> |<WRAP><wrap>#</wrap> </WRAP> |<WRAP><wrap>Remote</wrap> </WRAP> |<WRAP><wrap>on</wrap> </WRAP> |<WRAP><wrap>192.168.200.1</wrap> </WRAP> |<WRAP><wrap>(mvscat.dasd)</wrap> </WRAP> | <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 609</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap></wrap>**<wrap>10. Hercules 3270 Logo</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>10.1 Function</wrap>** <wrap>The Hercules 3270 logo is the initial welcome screen that is presented when a 3270 terminal connects to a Hercules 3270 device. While in previous releases of Hercules this logo screen was hardcoded it can now be customized.</wrap> <wrap>The customized logo is stored in a plain text file which contains positioning orders, attributes and supports variable substitutions. Each line in the text file represents either an order statement or a plain text line. If no logo file is specified then Hercules uses a built-in default logo. Upon startup Hercules will first look in the current directory for a file called "herclogo.txt". The name of the logo file can also be specified as a startup option by using the "-b" flag. The file may also be specified using the "LOGOFILE" system parameter or can be changed during Hercules operation using the "HERCLOGO" console command.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>10.2 Order Commands</wrap>** <wrap>Order commands are used to set the current buffer position, set the highlight and/or protected attributes, to force a skip to a new line and to specify text alignment.</wrap> **//<wrap>10.2.1 Set Buffer Address</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap>@SBA </wrap>//<wrap>x,y</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** //<wrap>ÊÊ¬¬¬ </wrap>//<wrap>@SBA </wrap>//<wrap>¬¬¬ x,y</wrap>// <wrap>The Set Buffer Address order sets the current buffer position to row x and column y. Row and column both begin counting with zero.</wrap> **//<wrap>10.2.2 Set Field</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>@SF {H | P | HP}</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 610</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ</wrap>****<wrap>¬¬¬@SF ¬¬¬§¬¬¬ H¬¬¬¬§¬¬¬¬¬¬¬¬¬¬</wrap>**<wrap>¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> **<wrap>ª¬¬¬P¬¬¬¬«</wrap>** **<wrap>⡿¬¬¬HP¬¬¬</wrap>** <wrap>The Set Field order sets the highlight ("H") and/or protected ("P") attribute.</wrap> **//<wrap>10.2.3 New Line</wrap>//** **__<wrap>Descriptive</wrap>__****<wrap></wrap>** **<wrap>@NL</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>**<wrap>@NL</wrap>** <wrap>The New Line order forces a skip to a new line.</wrap> **//<wrap>10.2.4 Align</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>@ALIGN (NONE | LEFT | RIGHT | CENTER}</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>**<wrap>@ALIGN </wrap>**<wrap>¬¬¬§¬¬¬ </wrap>**<wrap>NONE</wrap>**<wrap>¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> **<wrap>I¬¬¬ LEFT </wrap>**<wrap>¬¬¬¬¬«</wrap> **<wrap>I¬¬¬ RIGHT </wrap>**<wrap>¬¬¬¬«</wrap> **<wrap>⡿¬¬¬ CENTER ¬¬¬¯</wrap>** <wrap>The Align order specifies the text alignment relative to the left and right borders of the terminal. When the alignment is other than "NONE" a new line is automatically inserted after each line of text. If the alignment is "NONE" then the text will be written without skipping to the next line.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 611</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>10.3 Variables</wrap>** <wrap>It is possible to imbed substitution variables in the outgoing text. Substitution is indicated by enclosing the variable name between "$(" and ")". The Hercules version as an example can be specified by the following string: $(VERSION)</wrap> <wrap>The following variables are defined. It is also possible to specify environment variable names.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(VERSION)</wrap> <wrap>The Hercules version.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(HOSTNAME)</wrap> <wrap>The host name, on which Hercules is running.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(HOSTOS)</wrap> <wrap>The host operating system.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(HOSTOSREL)</wrap> <wrap>The release of the host operating system.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(HOSTOSVER)</wrap> <wrap>The version of the host operating system.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(HOSTARCH) \\ The host architecture.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(HOSTNUMCPUS)</wrap> <wrap>The number of host CPUs. UP (Uniprocessor for one CPU), or MP=n (Multiprocessor for more</wrap> <wrap>than one CPUs).</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(LPARNAME)</wrap> <wrap>The LPAR name specified in the configuration file.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(CSS)</wrap> <wrap>The logical channel subsystem set or channel set for the terminal.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(SUBCHAN)</wrap> <wrap>The subchannel number for the terminal.</wrap> <wrap>·<wrap></wrap></wrap><wrap>$(CCUU), $(ccuu), $(CUU), $(cuu)</wrap> <wrap>Various forms of the device number of the terminal.</wrap> <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>10.4 Sample</wrap>** <wrap>The file "herclogo.txt" is provided in the Hercules distribution as a sample template. This sample reflects the contents of the built-in logo.</wrap> <wrap>@ALIGN NONE</wrap> <wrap>@SBA 0,0</wrap> <wrap>@SF P</wrap> <wrap>Hercules Version :</wrap> <wrap>@SF HP</wrap> <wrap>$(VERSION)</wrap> <wrap>@NL</wrap> <wrap>@SF P</wrap> <wrap>Host name :</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 612</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>@SF HP</wrap> <wrap>$(HOSTNAME)</wrap> <wrap>@NL</wrap> <wrap>@SF P</wrap> <wrap>Host OS :</wrap> <wrap>@SF HP</wrap> <wrap>$(HOSTOS)-$(HOSTOSREL) $(HOSTOSVER)</wrap> <wrap>@NL</wrap> <wrap>@SF P</wrap> <wrap>Host Architecture :</wrap> <wrap>@SF HP</wrap> <wrap>$(HOSTARCH)</wrap> <wrap>@NL</wrap> <wrap>@SF P</wrap> <wrap>Processors :</wrap> <wrap>@SF HP</wrap> <wrap>$(HOSTNUMCPUS)</wrap> <wrap>@NL</wrap> <wrap>@SF P</wrap> <wrap>Chanl Subsys :</wrap> <wrap>@SF HP</wrap> <wrap>$(CSS)</wrap> <wrap>@NL</wrap> <wrap>@SF P</wrap> <wrap>Device number :</wrap> <wrap>@SF HP</wrap> <wrap>$(CCUU)</wrap> <wrap>@NL</wrap> <wrap>@SF P</wrap> <wrap>Subchannel :</wrap> <wrap>@SF HP</wrap> <wrap>$(SUBCHAN)</wrap> <wrap>@SF P</wrap> <wrap>@ALIGN LEFT</wrap> <wrap>HHH HHH The S/370, ESA/390 and z/Architecture</wrap> <wrap>HHH HHH Emulator</wrap> <wrap>HHH HHH</wrap> <wrap>HHH HHH EEEE RRR CCC U U L EEEE SSS</wrap> <wrap>HHHHHHHHHHHHHHHH E R R C U U L E S</wrap> <wrap>HHHHHHHHHHHHHHHH EEE RRR C U U L EEE SS</wrap> <wrap>HHHHHHHHHHHHHHHH E R R C U U L E S</wrap> <wrap>HHH HHH EEEE R R CCC UU LLLL EEEE SSS</wrap> <wrap>HHH HHH</wrap> <wrap>HHH HHH</wrap> <wrap>HHH HHH I can’t believe it’s not a MAINFRAME</wrap> <wrap>Copyright (c) 1999-2010 Roger Bowler, Jan Jaeger, and others</wrap> **<wrap>Figure 350: Logo File</wrap>** <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 613</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>This above sample file results in the following Hercules Logo screen:</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap> |<WRAP>{{hercules:userref:bf:image103.jpg|}} </WRAP> |<WRAP><wrap>=i=</wrap> </WRAP> | **<wrap>File Edit Font Transfer Macro Options</wrap>****<wrap> Window</wrap>****<wrap> Help</wrap>** |<WRAP><wrap>a</wrap> </WRAP> ||<WRAP><wrap>••</wrap> </WRAP> |<WRAP><wrap>11</wrap> </WRAP> |<WRAP><wrap>■</wrap> </WRAP> |<WRAP><wrap>·<wrap></wrap></wrap>**<wrap></wrap>** </WRAP> |<WRAP><wrap>♦</wrap> </WRAP> |<WRAP>**<wrap>th</wrap>****<wrap>t</wrap>****<wrap></wrap>** </WRAP> |<WRAP><wrap>%%__%%%%__%%_ r</wrap> </WRAP> |<WRAP> </WRAP> | |<WRAP> </WRAP> |<WRAP><wrap>Hercules Version</wrap><wrap> :</wrap><wrap> 3.07</wrap> <wrap>Host Mame</wrap><wrap> :</wrap><wrap> GOOFY</wrap> <wrap>Host OS :</wrap><wrap> Mindows_HT-6 1 \\ </wrap><wrap>Host Architecture :</wrap><wrap> AMD64</wrap> <wrap>Processors :</wrap><wrap> MP=8 \\ </wrap><wrap>Channel Subsystem :</wrap><wrap> 0</wrap> <wrap>Device Humber :</wrap><wrap> 0010</wrap> <wrap>Subchannel :</wrap><wrap> 0005</wrap> <wrap>HHH HHH The S/370, ESA/390 and z/Architecture</wrap> <wrap>HHH HHH Emulator</wrap> <wrap>HHH HHH</wrap> **<wrap>HHH HHH </wrap>**<wrap>FFFF **RRR **</wrap>**<wrap>Crr </wrap>****<wrap>H H I </wrap>**<wrap>FFFF </wrap><wrap>ccc \\ HHHHHHHHHHHHHHHH E RRC UUL ES</wrap> **__<wrap>HHHHHHHHHHHHHHHH</wrap>__****<wrap></wrap>**<wrap>EEE RRR C U U L EEE SS</wrap> <wrap>HHHHHHHHHHHHHHHH E R R C </wrap>**<wrap>U U L E</wrap>** <wrap>HHH HHH EEEE R R CCC UU LLLL EEEE SSS</wrap> <wrap>HHH HHH</wrap> <wrap>HHH HHH</wrap> <wrap>HHH HHH I can't believe it's not a MAINFRAME</wrap> <wrap>Copyright (c) 1999-2010 Roger Bowler, Jan Jaeger, and others</wrap> </WRAP> |||||||| | | | | | | | | | | | | **<wrap>Mal </wrap>****<wrap>0.0 19/06/10 10/170 11:32 192.160.0.101 </wrap>**<wrap>2 </wrap>**<wrap>a 1,1</wrap>** **<wrap>Figure 351: Logo Screen</wrap>** <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image104.gif|}}</wrap></wrap><wrap></wrap> <wrap>\\ </wrap>\\ <wrap>Hercules Emulator V4.00 – User Reference Guide Page 614</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap></wrap>**<wrap>11. Starting the Hercules Emulator</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>11.1 Starting Hercules in Native Mode</wrap>** <wrap>Hercules can be manually started from a Windows Command Prompt or can be started by calling a batch file (the preferred way). In both cases the syntax is the same.</wrap> **//<wrap>11.1.1 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>HERCULES [{</wrap><wrap>-f </wrap>//<wrap>configfile </wrap>//<wrap>| </wrap><wrap>--</wrap><wrap>config=</wrap>//<wrap>configfile</wrap>//<wrap>}]</wrap> <wrap>[</wrap><wrap>{</wrap><wrap>-r </wrap>//<wrap>rcfile </wrap>//<wrap>| </wrap><wrap>--</wrap><wrap>rcfile=</wrap>//<wrap>rcfile</wrap>//<wrap>}]</wrap> <wrap>[{</wrap><wrap>-b </wrap>//<wrap>logofile </wrap>//<wrap>| </wrap><wrap>--</wrap><wrap>herclogo=</wrap>//<wrap>logofile</wrap>//<wrap>}]</wrap> <wrap>[{</wrap><wrap>-d </wrap><wrap>| </wrap><wrap>--</wrap><wrap>daemon}]</wrap> <wrap>[{</wrap><wrap>-p </wrap>//<wrap>dyndir </wrap>//<wrap>| </wrap><wrap>--</wrap><wrap>modpath=</wrap>//<wrap>dyndir</wrap>//<wrap>}]</wrap> <wrap>[{</wrap><wrap>-l </wrap>//<wrap>dynmod </wrap>//<wrap>[...] </wrap><wrap>| </wrap><wrap>--</wrap><wrap>ldmod=</wrap>//<wrap>dynmod </wrap>//<wrap>[...]}</wrap><wrap>]</wrap> <wrap>[{</wrap><wrap>-s </wrap>//<wrap>symbol=value </wrap>//<wrap>[...] </wrap><wrap>| </wrap><wrap>--</wrap><wrap>defsym=//symbol=value //[...]}]</wrap> <wrap>[{</wrap><wrap>-</wrap><wrap>v | </wrap><wrap>--</wrap><wrap>verbose}]</wrap> <wrap>[{</wrap><wrap>-h </wrap><wrap>| </wrap><wrap>--</wrap><wrap>help}] \\ </wrap><wrap>[></wrap>//<wrap>logfile</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ%%__%%_HERCULES%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%_§%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%%%__%%</wrap><wrap>¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>ª%%__%%%%__%%%%__%%_</wrap><wrap>-f </wrap>//<wrap>configfile </wrap>//<wrap>¬¬¬¬¬«</wrap> <wrap>⡿%%__%%_</wrap><wrap>--</wrap><wrap>config=</wrap>//<wrap>configfile </wrap>//<wrap>%%__%%_</wrap> <wrap>ª%%__%%%%__%%%%__%%</wrap><wrap>-r </wrap>//<wrap>rcfile </wrap>//<wrap>¬¬ \\ </wrap><wrap>⡿%%__%%_</wrap><wrap>--</wrap><wrap>rcfile=</wrap>//<wrap>rcfile</wrap>// <wrap>Ê</wrap><wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê</wrap> <wrap>ª%%__%%%%__%%%%__%%_ </wrap><wrap>-b </wrap>//<wrap>logofile </wrap>//<wrap>%%__%%%%__%%%%__%%_« ª%%__%%%%__%%%%__%% </wrap><wrap>-d ¬¬¬¬¬¬«</wrap> <wrap>⡿%%__%%_</wrap><wrap>--</wrap><wrap>herclogo=</wrap>//<wrap>logofile </wrap>//<wrap>%%__%%_i '%%__%%_ </wrap><wrap>--</wrap><wrap>daemon%%__%%_¯</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image105.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 615</wrap> <wrap>\\ </wrap><wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>{{hercules:userref:bf:image053.gif|}}{{hercules:userref:bf:image106.gif|}}{{hercules:userref:bf:image107.gif|}}{{hercules:userref:bf:image108.gif|}}{{hercules:userref:bf:image028.gif|}}{{hercules:userref:bf:image109.gif|}}{{hercules:userref:bf:image110.gif|}}{{hercules:userref:bf:image111.gif|}}<wrap><wrap>{{hercules:userref:bf:image105.gif|}}</wrap></wrap> <wrap>\\ </wrap>|<WRAP>**<wrap>-v</wrap>** **<wrap>--verbose</wrap>** **<wrap>-h \\ --help</wrap>** </WRAP> |<WRAP><wrap>Specifies that Hercules is to be started with “MSGLEVEL VERBOSE” which displays additional messages during configuration file processing.</wrap> <wrap>Display help information regarding the syntax of the command-line arguments.</wrap> </WRAP> | **<wrap>>//logfile //</wrap>**<wrap>This is an optional log file which will receive a copy of all messages displayed on the control panel.</wrap> **//<wrap>11.1.3 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Start Hercules using the configuration file “D:%%\%%MVS%%\%%CONF%%\%%MVS38J.CONF” and write all messages to the log file “D:%%\%%MVS%%\%%LOGS%%\%%HERCULES.LOG”.</wrap> <wrap>HERCULES -f </wrap>[[file:///D:/MVS/CONF/MVS38J.CONF|<wrap>D:%%\%%MVS%%\%%CONF%%\%%MVS38J.CONF</wrap>]]<wrap> >D:%%\%%MVS%%\%%LOGS%%\%%HERCULES.LOG</wrap> **<wrap>Example 2:</wrap>** <wrap>Start Hercules using the configuration file “D:%%\%%S390%%\%%CONF%%\%%zLINUX.CNF” and with a logofile called “zLINUX_Logo.txt”. Display additional messages during configuration file processing.</wrap> <wrap>HERCULES -f </wrap>[[file:///D:/S390/CONF/zLINUX.CNF|<wrap>D:%%\%%S390%%\%%CONF%%\%%zLINUX.CNF</wrap>]]<wrap> -b zLINUX_Logo.txt -v</wrap> **<wrap>Example 3:</wrap>** <wrap>Start Hercules using the configuration file “D:%%\%%S390%%\%%CONF%%\%%zLINUX.CNF” and define a symbol named "DASDPATH" that contains the path of the DASD files ("</wrap>[[file:///D:/MVS/DASD|<wrap>D:%%\%%MVS%%\%%DASD</wrap>]]<wrap>").</wrap> <wrap>HERCULES -f </wrap>[[file:///D:/MVS/CONF/MVS38J.CONF|<wrap>D:%%\%%MVS%%\%%CONF%%\%%MVS38J.CONF</wrap>]]<wrap> -s DASDPATH=D:%%\%%MVS%%\%%DASD</wrap> **<wrap>Example 4:</wrap>** <wrap>Start Hercules using the configuration file “D:%%\%%MVS%%\%%CONF%%\%%MVS38J.CONF” and automatically execute the panel commands contained in the run-commands file “D:%%\%%MVS%%\%%CONF%%\%%MVS38.RC”</wrap> <wrap>HERCULES -f </wrap>[[file:///D:/MVS/CONF/MVS38J.CONF|<wrap>D:%%\%%MVS%%\%%CONF%%\%%MVS38J.CONF</wrap>]]<wrap> -r </wrap>[[file:///D:/MVS/CONF/MVS38J.RC|<wrap>D:%%\%%MVS%%\%%CONF%%\%%MVS38J.RC</wrap>]]<wrap></wrap> <wrap><wrap>{{hercules:userref:bf:image105.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 617</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>11.2 Starting Hercules with the Windows GUI</wrap>** <wrap>The Windows GUI can be started by just clicking on the GUI icon. Then all necessary settings required to start Hercules can be specified using the GUI itself.</wrap> <wrap>Alternatively the Windows GUI may also be manually started from a Windows Command Prompt or can be started by calling a batch file (which is the preferred way of these two options). In both cases the syntax is the same.</wrap> **//<wrap>11.2.1 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>HERCGUI [-f </wrap>//<wrap>configfile</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ HERCGUI ¬¬¬§¬¬¬¬¬</wrap> <wrap>f </wrap>//<wrap>configfile</wrap>// **//<wrap>11.2.2 Parameter</wrap>//** **<wrap>-f //configfile //</wrap>**<wrap>This is the name of a configuration file. If the HercGUI is started with the name of a configuration file then the HercGUI will automatically “power on” Hercules once the HercGUI itself is started. This is called the “Auto-Power-On” feature. When using this feature in conjunction with a Hercules “.RC” (run commands) file it is possible to totally automate Hercules startup and IPL.</wrap> **//<wrap>11.2.3 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Start Hercules using the HercGUI with the “Auto-Power-On” feature using the configuration file “D:%%\%%MVS%%\%%CONF%%\%%MVS38J.CONF”.</wrap> <wrap>HERCGUI -f </wrap>[[file:///D:/MVS/CONF/MVS38J.CONF|<wrap>D:%%\%%MVS%%\%%CONF%%\%%MVS38J.CONF</wrap>]]<wrap></wrap> **<wrap>Example 2:</wrap>** <wrap>Start the HercGUI without a configuration file.</wrap> <wrap>HERCGUI</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 618</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>11.3 Starting Hercules with the Hercules Studio</wrap>** <wrap>The Hercules Studio can be started by navigating to the 'Applications -> System Tools -> Hercules Studio' menu entry and selecting it from there. Then all necessary settings required to start Hercules can be specified using the Hercules Studio itself.</wrap> <wrap>Alternatively the Hercules Studio may also be manually started from a command shell or can be started by calling a script file. In both cases the syntax is the same.</wrap> **//<wrap>11.3.1 Syntax</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** **<wrap>H</wrap>****<wrap>erculesStudio </wrap>****<wrap>[-f </wrap>****//<wrap>configfile</wrap>//****<wrap>] [-r </wrap>****//<wrap>rcfile</wrap>//****<wrap>]</wrap>** **__<wrap>Diagram </wrap>__****<wrap></wrap>** **<wrap>ÊÊ¬¬¬ </wrap>****<wrap>HerculesStudio </wrap>****<wrap>¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬</wrap>** **<wrap>f </wrap>****//<wrap>configfile</wrap>//** **<wrap>r </wrap>****//<wrap>rcfile</wrap>//** **//<wrap>11.3.2 Parameter</wrap>//** **<wrap>-f //configfile //</wrap>**<wrap>This is the name of a configuration file. If the Hercules Studio is started with the name of a configuration file then it will automatically “power on” Hercules once the Hercules Studio itself is started. This is called the “Auto-Power-On” feature. When using this feature in conjunction with a Hercules “.RC” (run-commands) file it is possible to totally automate Hercules startup and IPL.</wrap> **<wrap>-r //rcfile //</wrap>**<wrap>This is the name of an optional RC (run-commands) file. This file contains Hercules console commands that are issued exactly as if the commands were entered from the Hercules system console.</wrap> **//<wrap>11.3.3 Examples</wrap>//** **<wrap>Example 1:</wrap>** <wrap>Start Hercules Studio using the configuration file “mvs38j.cnf” and the run-commands file "autoipl.rc".</wrap> <wrap>HerculesStudio -f mvs38j.cnf –r autoipl.rc</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 619</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image017.gif|}}</wrap></wrap>**<wrap>12. The Run-Commands File</wrap>** <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>12.1 Function</wrap>** <wrap>Hercules supports the ability to have console commands automatically executed at startup via the 'run-commands' file. If the run-commands file is found to exist when Hercules starts then each line of the file is read and interpreted as a console command, exactly as if the command were entered from the HMC system console.</wrap> <wrap>The default filename for the run-commands file is "hercules.rc". The default name may be overridden by setting the "HERCULES_RC" environment variable.</wrap> <wrap>Except for the 'pause' command (see below), each command read from the run-commands file is logged to the console preceded by a “>”' (greater-than sign) character. Thus you can easily distinguish between console commands entered from the keyboard from those entered via the run-commands file.</wrap> <wrap>Comment lines starting with '#' are treated as "silent comments" and are thus not logged to the console whereas comment lines starting with '*' are treated as "loud comments" and //will //be logged.</wrap> <wrap><wrap>{{hercules:userref:bf:image013.gif|}}</wrap></wrap>**<wrap>12.2 Run-Commands File Statements</wrap>** <wrap>There is a number of different types of commands that can be specified within a run-commands file. These commands are the following:</wrap> |<WRAP><wrap>·</wrap><wrap></wrap> </WRAP> |<WRAP><wrap>“//herccmd//”</wrap> </WRAP> |<WRAP><wrap>(any valid Hercules console command)</wrap> </WRAP> | |<WRAP><wrap>·</wrap><wrap></wrap> </WRAP> |<WRAP><wrap>PAUSE</wrap> </WRAP> |<WRAP><wrap>(delay the processing of the next command)</wrap> </WRAP> | |<WRAP><wrap>·</wrap><wrap></wrap> </WRAP> |<WRAP><wrap>#</wrap> </WRAP> |<WRAP><wrap>(issue silent comment)</wrap> </WRAP> | |<WRAP><wrap>·</wrap><wrap></wrap> </WRAP> |<WRAP><wrap>*</wrap> </WRAP> |<WRAP><wrap>(issue loud comment)</wrap> </WRAP> | **//<wrap>12.2.1 Hercules Console Commands</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** //<wrap>herccmd</wrap>// **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap>//<wrap>herccmd</wrap>// <wrap>In the run-commands file any valid Hercules console command (“//herccmd//”) can be specified. This includes the ‘sh’ (shell) command. Each command that is read from the run-commands file is logged to the console preceded by a ‘>’' (“greater-than” sign) character. This is to distinguish between console commands entered manually from the keyboard from thosecommands entered via the run-commands file.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 620</wrap> <wrap>\\ </wrap><wrap>Examples:</wrap> <wrap>MAXRATES MIDNIGHT \\ IPL 0148</wrap> **//<wrap>12.2.2 PAUSE</wrap>//** <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap>**__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PAUSE {</wrap>//<wrap>nnn </wrap>//<wrap>| </wrap>//<wrap>nnn.nnn</wrap>//<wrap>}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ </wrap><wrap>PAUSE </wrap><wrap>¬¬¬§¬¬¬¬¬ </wrap>//<wrap>nnn </wrap>//__<wrap>¬</wrap>__<wrap></wrap> <wrap>L%%__%%_</wrap>//<wrap>nnn.nnn</wrap>// <wrap>A pause command is supported in order to introduce a brief delay before reading and processing the next line in the file. The value //nnn //can be any number from 1 to 999 and specifies the number of seconds to delay before reading the next line. Beginning with Hercules version 4.0 pause can also be specified for sub-second delays (e.g. "PAUSE 0.125" to delay the next command for 125 milliseconds).</wrap> <wrap>Examples:</wrap> <wrap>PAUSE 2</wrap> <wrap>PAUSE 0.375</wrap> **//<wrap>12.2.3 # (Silent Comment)</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap>\\ </wrap>**<wrap># [</wrap>//<wrap>comment</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ # ¬¬¬ </wrap>//<wrap>comment</wrap>// <wrap>Lines starting with '#' are treated as "silent comments". They are intended as comments just for the run-commands file itself and are thus not logged to the console. That means they are are not visible when Hercules is started and the run-commands file is executed.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 621</wrap> <wrap>\\ </wrap><wrap>Examples:</wrap> <wrap># ==================================================== \\ # This comment block will not be logged to the console</wrap> <wrap># ====================================================</wrap> **//<wrap>12.2.4 * (Loud Comment)</wrap>//** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>* [</wrap>//<wrap>comment</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ¬¬¬ * ¬¬¬ </wrap>//<wrap>comment</wrap>// <wrap>Lines starting with '*' are treated as "loud comments". They will be logged to the console and thus are visible when the run-commands file is executed.</wrap> <wrap>Examples:</wrap> <wrap><wrap>{{hercules:userref:bf:image112.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image112.gif|}}</wrap></wrap><wrap>*</wrap> <wrap>* This comment block will be logged to the console</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image113.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image113.gif|}}</wrap></wrap><wrap>*</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap>**<wrap>12.3 Automating Hercules Startup</wrap>** <wrap>Creative use of the run-commands file can completely automate Hercules startup. The next figure shows a sample run-commands file that does the following:</wrap> <wrap>·<wrap></wrap></wrap><wrap>“pause 1” – Wait one second before processing the first Hercules command. (1)</wrap> <wrap>·<wrap></wrap></wrap><wrap>“cmdlevel all” – Set the current command group to ALL. This allows that all Hercules commands can be issued. (2)</wrap> <wrap>·<wrap></wrap></wrap><wrap>“help” – Display all valid commands for the chosen command group that has been set before with CMDLEVEL. (3)</wrap> <wrap>·<wrap></wrap></wrap><wrap>“maxrates midnight” – Set the MAXRATES reporting interval to midnight to have the MIPS and I/O statistics issued date aligned. (4)</wrap> <wrap>·<wrap></wrap></wrap><wrap>“sh startgui "</wrap>[[file:///D:/MVS/TERMINALS.BAT|<wrap>D:%%\%%MVS%%\%%TERMINALS.BAT</wrap>]]<wrap>" – Execute the named batch file in the shell to start a couple of tn3270 sessions. See details below. (5)</wrap> <wrap>·<wrap></wrap></wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>“pause 3” – Wait three seconds until all tn3270 sessions have been successfully connected. (6)</wrap> <wrap>\\ </wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 622</wrap> <wrap>\\ </wrap><wrap>·<wrap></wrap></wrap><wrap><wrap>{{hercules:userref:bf:image114.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image114.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image114.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image114.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image115.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image115.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image115.gif|}}</wrap></wrap><wrap><wrap>{{hercules:userref:bf:image115.gif|}}</wrap></wrap><wrap>“ipl 0148” – Finally IPL MVS 3.8J from device address 148. (7)</wrap> |<WRAP><wrap># =============================== # Hercules RUN-COMMANDS (RC) File</wrap> <wrap># ===============================</wrap> <wrap># ---------------------------------------------------------------------- </wrap> <wrap># Wait 1 second before issuing Hercules commands (1)</wrap> <wrap># ---------------------------------------------------------------------- \\ pause 1</wrap> <wrap># ---------------------------------------------------------------------- </wrap> <wrap># Set command level to 'ALL' (2)</wrap> <wrap># ---------------------------------------------------------------------- \\ cmdlevel all</wrap> <wrap># ---------------------------------------------------------------------- </wrap> <wrap># Display all valid Hercules panel commands (3)</wrap> <wrap># ---------------------------------------------------------------------- \\ help</wrap> <wrap># ---------------------------------------------------------------------- </wrap> <wrap># Display and reset maxrates values (4)</wrap> <wrap># ---------------------------------------------------------------------- \\ maxrates midnight</wrap> <wrap># ---------------------------------------------------------------------- </wrap> <wrap># Start tn3270 sessions (5)</wrap> <wrap># ---------------------------------------------------------------------- \\ sh startgui "</wrap>[[file:///D:/MVS/TERMINALS.BAT|<wrap>D:%%\%%MVS%%\%%TERMINALS.BAT</wrap>]]<wrap>"</wrap> <wrap># ---------------------------------------------------------------------- </wrap> <wrap># Wait 3 second before IPL’ing MVS (6)</wrap> <wrap># ---------------------------------------------------------------------- \\ pause 3</wrap> <wrap># ---------------------------------------------------------------------- </wrap> <wrap># IPL MVS 3.8J (7)</wrap> <wrap># ---------------------------------------------------------------------- \\ ipl 0148</wrap> <wrap># ======== # (RC EOF)</wrap> <wrap># ========</wrap> </WRAP> | **<wrap>Figure 352: Run-commands (.rc) file</wrap>** <wrap>With the run-commands file shown above the Hercules startup is fully automated. After starting Hercules there is no manual intervention required until MVS is up and running.</wrap> <wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 623</wrap> <wrap>\\ </wrap><wrap>The next figure shows the batch file that is used in the run-commands file (step 5) to start the tn3270 sessions.</wrap> <wrap><wrap>|<WRAP><wrap>|<WRAP> </WRAP> | </wrap></WRAP> | </wrap></wrap><wrap>@ECHO OFF</wrap> <wrap>REM %%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%* REM Start master console and wait for connection to Hercules</wrap> <wrap>REM %%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%* START /D "</wrap>[[../../../../../../../Program|<wrap>C:%%\%%Program</wrap>]]<wrap> Files (x86)%%\%%TomBrennanSoftware%%\%%VistaTN3270" VistaTN3270.EXE MVS38J_MST.SES CHOICE /t 1 /d y</wrap> <wrap>REM %%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%% REM Start operator console and wait for connection to Hercules</wrap> <wrap>REM %%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%* START /D "</wrap>[[../../../../../../../Program|<wrap>C:%%\%%Program</wrap>]]<wrap> Files (x86)%%\%%TomBrennanSoftware%%\%%VistaTN3270" VistaTN3270.EXE MVS38J_OPR.SES CHOICE /t 1 /d y</wrap> <wrap>REM %%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%* REM Start TSO terminals and wait for connection to Hercules</wrap> <wrap>REM %%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%%%**%%* START /D "</wrap>[[../../../../../../../Program|<wrap>C:%%\%%Program</wrap>]]<wrap> Files (x86)%%\%%TomBrennanSoftware%%\%%VistaTN3270" VistaTN3270.EXE MVS38J_TSO.SES CHOICE /t 1 /d y</wrap> <wrap>START /D "</wrap>[[../../../../../../../Program|<wrap>C:%%\%%Program</wrap>]]<wrap> Files (x86)%%\%%TomBrennanSoftware%%\%%VistaTN3270" VistaTN3270.EXE MVS38J_TSO.SES</wrap> <wrap>EXIT</wrap> **<wrap>Figure 353: Batch file to start tn3270 sessions</wrap>** <wrap>The CHOICE command used in the batch file is to issue a delay before trying to connect the next tn3270 session.</wrap> <wrap>The “/t” parameter specifies the number of seconds to pause before a default choice is made. Option “/d” specifies the default choice that is issued after the timeout has expired. The character given as argument must be in the set of choices specified by the “/c” option (defaults are ‘Y’ and ‘N’).</wrap> <wrap>\\ </wrap><wrap><wrap>{{hercules:userref:bf:image010.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00 – User Reference Guide Page 624</wrap>