User Reference Guide

Total Page:16

File Type:pdf, Size:1020Kb

User Reference Guide Hercules System/370, ESA/390, z/Architecture Emulator Hercules – User Reference Guide Version 3 Release 07 Contents Contents ........................................................................................................................................................2 Figures...........................................................................................................................................................8 Tables..........................................................................................................................................................14 1. Preface .................................................................................................................................................15 1.1 Edition information ........................................................................................................................15 1.2 What this book is about.................................................................................................................15 1.3 Who should read this book ...........................................................................................................15 1.4 What you need to know to understand this book..........................................................................15 1.5 How to use this book.....................................................................................................................15 1.6 Revision Notice .............................................................................................................................15 1.7 Readers Comments ......................................................................................................................16 1.8 Legal Advice..................................................................................................................................16 1.9 Trademarks ...................................................................................................................................16 1.10 Acknowledgements ...................................................................................................................17 2. Related Publications ............................................................................................................................18 2.1 Hercules Emulator – General Information ....................................................................................18 2.2 Hercules Emulator – Installation Guide ........................................................................................18 2.3 Hercules Emulator – User Reference Guide ................................................................................18 2.4 Hercules Emulator – Messages and Codes .................................................................................18 2.5 Hercules Emulator – Reference Summary ...................................................................................18 3. Hercules Configuration File..................................................................................................................19 3.1 The Configuration File...................................................................................................................19 3.2 System Parameters.......................................................................................................................19 3.3 Device Definitions .........................................................................................................................21 3.4 Coding Rules.................................................................................................................................22 3.5 Record Format ..............................................................................................................................23 3.6 Sample Configuration File.............................................................................................................24 3.7 Symbol Substitution ......................................................................................................................26 3.8 Enhanced Symbol Substitution.....................................................................................................28 4. System Parameter Descriptions...........................................................................................................30 4.1 # or * (Comment lines) ..................................................................................................................30 4.2 ARCHMODE (Initial architecture mode) .......................................................................................31 4.3 ASN_AND_LX_REUSE / ALRF (ESAME ASN and LX REUSE feature) .....................................32 4.4 AUTOMOUNT (Tape automount root directory) ...........................................................................34 4.5 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts).................................................................36 4.6 CCKD (Compressed CKD DASD options)....................................................................................37 4.7 CNSLPORT (Telnet client port) ....................................................................................................42 4.8 CODEPAGE (Codepage conversion table) ..................................................................................43 4.9 CONKPALV (Console and telnet clients keep-alive option) .........................................................45 4.10 CPUMODEL (CPU model) ........................................................................................................47 4.11 CPUPRIO (CPU thread process priority) ..................................................................................48 4.12 CPUSERIAL (CPU serial number) ............................................................................................49 4.13 CPUVERID (CPU version code) ...............................................................................................50 4.14 DEFSYM (Define symbol) .........................................................................................................51 4.15 DEVPRIO (Device threads process priority) .............................................................................52 4.16 DEVTMAX (Maximum number of device threads) ....................................................................53 4.17 DIAG8CMD (DIAGNOSE 8 command setting) .........................................................................55 4.18 ECPSVM (ECPS:VM support status (VM)) ...............................................................................57 4.19 ENGINES (Processor engine type)...........................................................................................59 4.20 HERCLOGO (Hercules 3270 logo) ...........................................................................................61 4.21 HERCPRIO (Hercules process priority) ....................................................................................62 4.22 HTTPPORT (HTTP server port)................................................................................................63 4.23 HTTPROOT (HTTP server root directory).................................................................................65 4.24 IGNORE (Ignore subsequent INCLUDE errors)........................................................................66 4.25 INCLUDE (Include configuration file) ........................................................................................67 Hercules Emulator – User Reference Guide Page 2 4.26 IODELAY (I/O interrupt wait time (LINUX)) ...............................................................................68 4.27 LDMOD (Additional dynamic load modules) .............................................................................69 4.28 LEGACYSENSEID (SENSE ID CCW (x'E4') feature)...............................................................70 4.29 LOADPARM (IPL parameter) ....................................................................................................71 4.30 LOGOPT (Log options) .............................................................................................................72 4.31 LPARNAME (LPAR name returned by DIAG x'204') ................................................................73 4.32 LPARNUM (LPAR identification number)..................................................................................74 4.33 MAINSIZE (Main storage in MB)...............................................................................................75 4.34 MANUFACTURER (Manufacturer name returned by STSI instruction)....................................76 4.35 MAXCPU (Maximum number of CPUs) ....................................................................................77 4.36 MODEL (Model names returned by STSI instruction)...............................................................78 4.37 MODPATH (Dynamic load module path) ..................................................................................80 4.38 MOUNTED_TAPE_REINIT (Control tape initialization) ............................................................81 4.39 NUMCPU (Number of emulated CPUs) ....................................................................................82 4.40 NUMVEC (Number of vector facilities)......................................................................................83 4.41 OSTAILOR (Intended operating system) ..................................................................................84
Recommended publications
  • VALIDATED PRODUCTS LIST 1992 No.2
    NISTIR 4820 (Supersedes NISTIR 4739) VALIDATED PRODUCTS LIST 1992 No. 2 Programming Languages Database Language SQL Graphics GOSIP POSIX Security Judy B. Kailey U.S. DEPARTMENT OF COMMERCE Technology Administration National Institute of Standards and Technoiogy Computer Systems Laboratory Software Standards Validation Group Gaithersburg, MD 20899 “QC — TOO .U56 4820 NIST 1992 N I STIR 482 (Supersedes NISTIR 4739) ' O VALIDATED PRODUCTS LIST 1992 No.2 Programming Languages Database Language SQL Graphics GOSIP POSiX Security Judy B. Kailey U.S. DEPARTMENT OF COMMERCE Technology Administration National Institute of Standards and Technology Computer Systems Laboratory Software Standards Validation Group Gaithersburg, MD 20899 April 1992 (Supersedes January 1992 Issue) U.S. DEPARTMENT OF COMMERCE Barbara Hackman Franklin, Secretary TECHNOLOGY ADMINISTRATION Robert M. White, Linder Secretary for Technology NATIONAL INSTITUTE OF STANDARDS AND TECHNOLOGY John W. Lyons, Director FOREWORD The Validated Products List (formerly called the Validated Processor List) is a collection of registers describing implementations of Federal Information Processing Standards (FTPS) that have been validated for conformance to FTPS. The Validated Products List also contains information about the organizations, test methods and procedures that support the validation programs for the FTPS identified in this document. The Validated Products List is updated quarterly. lii ' " M'- v^,.^.:v;/i'fr•i•:‘fey^^?4 .•:, .V.' ini‘,r^f' isfc'^feV VihV'’, !iV.V I t: 4 #> vm- 'at' Mil! .M'? Of'S8r'»'' SIVS 'V-tv. ','V ..(Vi feiii yA ' r' ' '4: ,. = r,: 0 r^'-' ".V.^l , ;‘ • » JjTT ;»»!£ ... •':«5(4i ' |i“' T" •.(''’'ia\.':l'"' f*l, r-’i"' i'-" '.:"::'.".vi ';... '('?. .;r'H vl. '' ' " .. i.” -' f-j'" , '' '(^ • '.v;.» .
    [Show full text]
  • Hercules General Information
    Hercules System/370, ESA/390, z/Architecture Emulator Hercules – General Information Version 3 Release 06 Contents Contents ........................................................................................................................................................2 Figures...........................................................................................................................................................7 Tables............................................................................................................................................................9 1. Preface .............................................................................................................................................10 1.1 Edition information ........................................................................................................................10 1.2 What this book is about.................................................................................................................10 1.3 Who should read this book ...........................................................................................................10 1.4 What you need to know to understand this book..........................................................................10 1.5 How to use this book.....................................................................................................................10 1.6 Revision Notice .............................................................................................................................10
    [Show full text]
  • The MVS 3.8J Tur(N)Key System
    Terminal CUU0C0 Date 10.11.13 Time 20:00:00 ************ **** ***** || ** ** ** ** ** ||| ** ** ** ** ** |||| ** ** ** || || |l _,,,---,,_ ** ** ** || || ZZZzz /,'.-'`' -. ;-;;, ** **** || || |,4- ) )-,_. ,( ( ''-' ** ***** || || '---''(_/--' `-')_) ** ** ** || || |||||||||| ** ** ** ||||||||||| The MVS 3.8j ** ** ** || Tur(n)key System ** ** ** || ****** **** *** |||||| TK3 created by Volker Bandke [email protected] TK4- update by Juergen Winkelmann [email protected] see TK4-.CREDITS for complete credits MVS 3.8j Level 8505 Logon ===> RUNNING TK4- The MVS 3.8j Tur(n)key 4- System OS/VS2 MVS 3.8j Service Level 8505 Tur(n)key Level 4- Version 1.00 User’s Manual November 2013 ********************************************************************** * * * This User’s Manual applies to the MVS 3.8j Tur(n)key 4- System. * * * ********************************************************************** * * * MVS 3.8j Tur(n)key 4- ("TK4-") is a ready to use OS/VS2 MVS 3.8j * * system built specifically to run under the Hercules System/370, * * ESA/390, and z/Architecture Emulator. It is an extension of the * * original MVS Tur(n)key Version 3 System ("TK3") created by Volker * * Bandke in 2002. See Appendix A for credits and copyrights. * * * * Note: TK4- does not claim to be a new release of the original TK3 * * system, hence its name is TK4-, not TK4. * * * ********************************************************************** * * * Jürgen Winkelmann, [email protected], November 2013 * * * **********************************************************************
    [Show full text]
  • MTS on Wikipedia Snapshot Taken 9 January 2011
    MTS on Wikipedia Snapshot taken 9 January 2011 PDF generated using the open source mwlib toolkit. See http://code.pediapress.com/ for more information. PDF generated at: Sun, 09 Jan 2011 13:08:01 UTC Contents Articles Michigan Terminal System 1 MTS system architecture 17 IBM System/360 Model 67 40 MAD programming language 46 UBC PLUS 55 Micro DBMS 57 Bruce Arden 58 Bernard Galler 59 TSS/360 60 References Article Sources and Contributors 64 Image Sources, Licenses and Contributors 65 Article Licenses License 66 Michigan Terminal System 1 Michigan Terminal System The MTS welcome screen as seen through a 3270 terminal emulator. Company / developer University of Michigan and 7 other universities in the U.S., Canada, and the UK Programmed in various languages, mostly 360/370 Assembler Working state Historic Initial release 1967 Latest stable release 6.0 / 1988 (final) Available language(s) English Available programming Assembler, FORTRAN, PL/I, PLUS, ALGOL W, Pascal, C, LISP, SNOBOL4, COBOL, PL360, languages(s) MAD/I, GOM (Good Old Mad), APL, and many more Supported platforms IBM S/360-67, IBM S/370 and successors History of IBM mainframe operating systems On early mainframe computers: • GM OS & GM-NAA I/O 1955 • BESYS 1957 • UMES 1958 • SOS 1959 • IBSYS 1960 • CTSS 1961 On S/360 and successors: • BOS/360 1965 • TOS/360 1965 • TSS/360 1967 • MTS 1967 • ORVYL 1967 • MUSIC 1972 • MUSIC/SP 1985 • DOS/360 and successors 1966 • DOS/VS 1972 • DOS/VSE 1980s • VSE/SP late 1980s • VSE/ESA 1991 • z/VSE 2005 Michigan Terminal System 2 • OS/360 and successors
    [Show full text]
  • MVS Tools & Tricks
    MVS Tools & Tricks BY SAM GOLOB Retro MVS Computing would bet that five years ago, no one As an aside, I would also like to point out and 574 contain more collected utilities I could have predicted the enormity of that Hercules is a great boon for MVS that work on MVS 3.8. this development. As most revolutionary retirees and for MVS people who do not To find out more about the Hercules ideas go, this one started as someone’s have access to an MVS system. It used to be and MVS 3.8 improvement effort, go to dream and was developed into a workable impossible to work with MVS unless you the Hercules-390 news group at solution to the extent that (even though not had a mainframe or an expensive P/390 at www.yahoogroups.com. The spin-off many people might admit it) it is on the your disposal, and as soon as you would H390-MVS news group is useful as well. verge of making a major impact in the lives leave a company, all substantial MVS work These sites contain downloadable files of MVS systems programmers. would have to stop. Now, it is possible for and programs. This idea, which is not completely in iso- you to set up a complete “turnkey MVS Some of the user-written MVS utilities lation, is the free Linux-based S/390 system” on your home PC in less than 15 written for MVS 3.8 that are new will also instruction simulator called Hercules. minutes under Windows and be able to work on OS/390 and z/OS systems, so we Hercules has been ported to Windows and access TSO.
    [Show full text]
  • Hercules V3.13.0
    Hercules System/370, ESA/390, z/Architecture Emulator Hercules – General Information Version 3 Release 13 Hercules System/370, ESA/390, z/Architecture Emulator Hercules – General Information Version 3 Release 13 First Edition, May 06, 2018 HEGI031300-00 Hercules Emulator V3.13 – General Information Page 2 Contents Contents ........................................................................................................................................................ 3 Figures ......................................................................................................................................................... 10 Tables .......................................................................................................................................................... 12 1. Preface ................................................................................................................................................. 13 1.1 Edition information ........................................................................................................................ 13 1.2 What this book is about ................................................................................................................. 13 1.3 Who should read this book ........................................................................................................... 13 1.4 What you need to know to understand this book .......................................................................... 13 1.5 How to use this book ....................................................................................................................
    [Show full text]
  • Hercules – "Mainframe Iron in Software"
    Hercules – "mainframe iron in software" Jeff Savit Disclaimer • Everything in this presentation is Jeff's opinion, and not that of his employer or anybody else, probably. – So, what else is new? • Also, I am not a lawyer, so don't take anything I say as gospel if it has a legal implication. Or, even if it doesn't What is Hercules? • Software implementation (emulator) of mainframe hardware: – S/370, ESA/390, z/Architecture – a variety of I/O devices • About 110 kloc of multi-threaded C • Open sourced, portable, based on gcc – By Roger Bowler, Jay Maynard, Jan Jaeger, Greg Smith, Volker Bandke, David "Fish" Trout, and other volunteers Why? • If you don't have access to the Real Thing • If you have access to the Real Thing, but in- office time just isn't enough • Development • Hobbyist "retrocomputing" • Major geek value: surprise your friends by showing them MVS on your laptop Hercules Runs on: • Windows 98, NT, 2000 using Cygwin – Provides Unix APIs Herc uses, esp: threads – Go to sources.redhat.com/cygwin • Linux (including Linux/390) – So, you can run Linux under Hercules under Linux under... • Solaris • iMac OS/X • (Rumored) Alpha, OS/2 Emulated Architectures • S/370 – Uniprocessor only • S/390, ESA • z/Architecture (64-bit) • Architecture selected via configuration file or console command Emulated Devices • Local non-SNA 3270 • Printer/console (1052, 3215) • Card reader/punch (2501, 2540, 3505, 3525) • Printer (1403, 3211) • Tape (3420, 3480) • DASD: (3310, 3370, 9336; 2311, 2314, 3330, 3350, 3375, 3380, 3390) • CTCA and networking
    [Show full text]
  • Hercules – User Reference Guide
    Hercules System/370, ESA/390, z/Architecture Emulator Hercules – User Reference Guide Version 3 Contents 1. Preface .............................................................................................................................................13 1.1 Edition information ........................................................................................................................13 1.2 What this book is about.................................................................................................................13 1.3 Who should read this book ...........................................................................................................13 1.4 What you need to know to understand this book..........................................................................13 1.5 How to use this book.....................................................................................................................13 1.6 Revision Notice .............................................................................................................................13 1.7 Readers Comments ......................................................................................................................14 1.8 Legal Advice..................................................................................................................................14 1.9 Trademarks...................................................................................................................................14 1.10 Acknowledgements
    [Show full text]
  • 1. Define CP Directory Entry for the SSLSERV Virtual Machine. 2
    ------------------------------------------------- ----------------- SSLSERV DIRECT ---------------- ------------------------------------------------- USER SSLSERV XXXXXXXX 128M 1G G ACCOUNT 200 TCPIP CPU 0 BASE CPU 1 1. Define CP directory entry for the IPL 100 SSLSERV virtual machine. IUCV ALLOW IUCV ANY MACHINE ESA 4 OPTION ACCT MAXCONN 1024 QUICKDSP SVMSTAT SHARE RELATIVE 3000 DEDICATE 06D2 06D2 DEDICATE 06D3 06D3 CONSOLE 0009 3215 T MDISK 0100 3390 startcyl 300 volume ------------------------------------------------- --------------- Hercules Linux Host ------------- ------------------------------------------------- [hercuser@zhost tape]$ wget -O- http://wotho.ethz.ch/sslserv/sslserv.agz | zcat >sslserv.aws --2011-12-21 14:31:53-- http://wotho.ethz.ch/sslserv/sslserv.agz Resolving wotho.ethz.ch... 82.130.118.35 Connecting to wotho.ethz.ch|82.130.118.35|:80... connected. HTTP request sent, awaiting response... 200 OK 2. Download and unpack the AWS Length: 51727413 (49M) [text/plain] tape containing the SSL server Saving to: `STDOUT' appliance. Use the procedure 100%[=======================================================>] 51,727,413 24.6M/s in 2.0s shown here or any other method 2011-12-21 14:31:55 (24.6 MB/s) - `-' saved [51727413/51727413] of choice. [hercuser@zhost tape]$ ls -l -rw-r--r-- 1 hercuser hercules 221814258 Dec 21 14:31 sslserv.aws [hercuser@zhost tape]$ ------------------------------------------------- ---------------- Hercules Console --------------- ------------------------------------------------- attach 06D2.2 LCS -n /dev/net/tun -m zv:ms:sl:hw:ad 192.168.118.116 HHCLC073I 06D2: TAP device tap2 opened 3. Attach an LCS device to your z/VM devinit 590 tape/sslserv.aws readonly=1 LPAR (if not already done through HHCTA004I 0590: tape/sslserv.aws is a AWS Format tape file your configuration file). Load the HHCTA066I 0590: option 'readonly' accepted.
    [Show full text]
  • Hercules Installation Guide
    Hercules System/370, ESA/390, z/Architecture Emulator Hercules – Installation Guide Version 3 Release 07 Hercules System/370, ESA/390, z/Architecture Emulator Hercules – Installation Guide Version 3 Release 07 Fourth Edition, November 30, 2012 HEIG030700-03 Hercules Emulator - Installation Guide Page 2 Contents Contents ........................................................................................................................................................ 3 Figures ........................................................................................................................................................... 6 Tables ............................................................................................................................................................ 9 1. Preface ................................................................................................................................................. 10 1.1 Edition information ........................................................................................................................ 10 1.2 What this book is about ................................................................................................................. 10 1.3 Who should read this book ........................................................................................................... 10 1.4 What you need to know to understand this book .......................................................................... 10 1.5 How to use this book ....................................................................................................................
    [Show full text]
  • New Users of Hercules Wanting a VM/CMS Environment by Greg Hartwig (Greg at Hartwig Dot Com), 2004-08
    New Users of Hercules Wanting a VM/CMS Environment by Greg Hartwig (greg at hartwig dot com), 2004-08 I've just gotten through setting up a VM/CMS environment using Hercules as a new user and I found that there seems to be some holes in the documentation. Maybe it was just me, but much of the documentation assumed that I knew stuff that I didn't. So I wanted to write this guide to help others go through this. I hope this is helpful. Installation and setup Installation The first step would be to install Hercules. This will give you a big, empty (fake) IBM mainframe on your desktop but no sofware for it whatsoever. The next step is to get some software! Several operating systems are available (VM, MVS, MVT, Linux), but I'm concerned with VM/CMS here. The good news is that when you're done, you will have a functioning VM and CMS operating system to play with! The bad news is that it's VM/370 R6 from around 1977. That means no XEDIT, no REXX, no EXEC2 even. You will have to become familiar with the EDIT editor and the original EXEC language. Besides Hercules, you will need a 3270 terminal emulator. These are available for every platform (tn3270, x3270, etc.). You will need this to connect to your mainframe. You will probably also need a telnet program. I've gotten by without using telnet but it's a good idea to get that set up also while you're at it.
    [Show full text]
  • Celebrating 50 Years of Campus-Wide Computing
    Celebrating 50 Years of Campus-wide Computing The IBM System/360-67 and the Michigan Terminal System 13:30–17:00 Thursday 13 June 2019 Event Space, Urban Sciences Building, Newcastle Helix Jointly organised by the School of Computing and the IT Service (NUIT) School of Computing and IT Service The History of Computing at Newcastle University Thursday 13th June 2019, 13:30 Event Space, Urban Sciences Building, Newcastle Helix, NE4 5TG Souvenir Collection Celebrating 50 Years of Campus-wide Computing – 2019 NUMAC and the IBM System/360-67 – 2019 NUMAC Inauguration – 1968 IBM System/360 Model 67 (Wikipedia) The Michigan Terminal System (Wikipedia) Program and Addressing Structure in a Time-Sharing Environment et al – 1966 Virtual Memory (Wikipedia) Extracts from the Directors’ Reports – 1965-1989 The Personal Computer Revolution – 2019 Roger Broughton – 2017 Newcastle University Celebrating 50 Years of Campus-wide Computing The IBM System/360-67 and the Michigan Terminal System 13:30–17:00 Thursday 13 June 2019 Event Space, Urban Sciences Building, Newcastle Helix Jointly organised by the School of Computing, and the IT Service Two of the most significant developments in the 65 year history of computing at Newcastle University were the acquisition of a giant IBM System/360-67 mainframe computer in 1967, and subsequently the adoption of the Michigan Terminal System. MTS was the operating system which enabled the full potential of the Model 67 – a variant member of the System/360 Series, the first to be equipped with the sort of memory paging facilities that years later were incorporated in all IBM’s computers – to be realized.
    [Show full text]