Hercules – Operations and Utilities Guide

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

Hercules ? Operations and Utilities Guide

Version 4 Release 00

Draft - November 21, 2015

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

Hercules ? Operations and Utilities Guide

Version 4 Release 00

First Edition, November 21, 2015 HEOP040000-00

Hercules Emulator V4.00 ? Operations and Utilities Guide

Page 2

Contents

Contents ........................................................................................................................................................3 Figures ........................................................................................................................................................... 5 Tables ............................................................................................................................................................7 1. Preface ...................................................................................................................................................8

1.1 Edition information ..........................................................................................................................8 1.2 What this book is about...................................................................................................................8 1.3 Who should read this book .............................................................................................................8 1.4 What you need to know to understand this book............................................................................8 1.5 How to use this book.......................................................................................................................8 1.6 Revision Notice ...............................................................................................................................8 1.7 Readers Comments ........................................................................................................................9 1.8 Legal Advice....................................................................................................................................9 1.9 Trademarks .....................................................................................................................................9 1.10 Acknowledgements ...................................................................................................................10 2. Related Publications ............................................................................................................................11 2.1 Hercules ? General Information ....................................................................................................11 2.2 Hercules ? Installation Guide ........................................................................................................11 2.3 Hercules ? User Reference Guide ................................................................................................11 2.4 Hercules ? Operations and Utilities Guide ....................................................................................11 2.5 Hercules ? Messages and Codes .................................................................................................11 2.6 Hercules ? Reference Summary...................................................................................................11 3. Summary of changes ...........................................................................................................................12 3.1 Version 4, First Edition (HEOP040000-00) ...................................................................................12 Part I: Hercules Operations .........................................................................................................................13 4. Hercules Operations ............................................................................................................................14 4.1 Starting the Emulator ....................................................................................................................14 4.2 The Console Panel........................................................................................................................14 4.3 The Device and Status Panel .......................................................................................................18 4.4 The Web Browser Interface ..........................................................................................................24 4.5 Graphical User Interfaces (GUIs)..................................................................................................36 Part II: Hercules Supplied Utilities ...............................................................................................................37 5. Hercules Supplied Utilities ...................................................................................................................38 5.1 Overview .......................................................................................................................................38 5.2 CCKDCDSK (CCKD DASD file integrity verification, recovery and repair utility) .........................41 5.3 CCKDCOMP (CCKD DASD file compression utility) ....................................................................43 5.4 CCKDDIAG (CCKD DASD file diagnostics utility) ........................................................................45 5.5 CCKDSWAP (CCKD DASD file swap-endian program) ...............................................................48 5.6 DASDCAT (Display PDS datasets and members) .......................................................................49 5.7 DASDCONV (DASD image file conversion program)...................................................................53 5.8 DASDCOPY (Copy DASD file to another DASD file) ...................................................................55 5.9 DASDINIT (DASD image file creation)..........................................................................................57 5.10 DASDISUP (Fix XCTL tables in SVCLIB) .................................................................................60 5.11 DASDLOAD (DASD loader program)........................................................................................62 5.12 DASDLS (List datasets on a volume)........................................................................................70

Hercules Emulator V4.00 ? Operations and Utilities Guide

Page 3

5.13 DASDPDSU (PDS unload utility)...............................................................................................74 5.14 DASDSEQ (Display sequential datasets) .................................................................................76 5.15 HETGET (Extract files from an AWS or HET tape file) .............................................................78 5.16 HETINIT (Initialize an AWS or HET tape file)............................................................................80 5.17 HETMAP (Show information about a HET or AWS tape file)...................................................82 5.18 HETUPD (Update and/or copy an AWS or HET tape file) ........................................................87 5.19 TAPECOPY (Copy a SCSI tape to or from an AWSTAPE disk file) .........................................89 5.20 TAPEMAP (Show information about an AWS tape file) ............................................................91 5.21 TAPESPLT (Split an AWS tape file)..........................................................................................93 5.22 DMAP2HRC (P/390 DEVMAP conversion program) ................................................................95 5.23 VMFPLC2 (VM formatted tape utility) .......................................................................................96 Part III: Third-Party Utilities..........................................................................................................................99 6. Third Party Utilities .............................................................................................................................100 6.1 FTAPE (SCSI Tape Test Utility)..................................................................................................100 6.2 HercPrt (Remote Hercules Printer Spooler) ...............................................................................108 6.3 PRTPUB (Mainframe Print Publishing Pprogram) ......................................................................125 Part IV: Mainframe Utilities ........................................................................................................................129 7. Mainframe Utilities..............................................................................................................................130 7.1 AWSSL (AWS virtual tape) .........................................................................................................130 7.2 AWSUTIL (AWS format tape file generation utility) ....................................................................135 7.3 RAWSTAPE (Reverse AWSTAPE utility) ...................................................................................137 7.4 VTTS (Virtual tape transportation system)..................................................................................138 Appendix A: Supported DASD Device Types............................................................................................141 Appendix B. Syntax ...................................................................................................................................144 B.1 Reading Syntax Descriptions ..........................................................................................................144 B.2 Reading Syntax Diagrams...............................................................................................................145 B.3 Sample Syntax Description .............................................................................................................147 B.4 Sample Syntax Diagram..................................................................................................................148 Appendix C. Links......................................................................................................................................149

Hercules Emulator V4.00 ? Operations and Utilities Guide

Page 4

Figures

Figure 1: Hercules Console Panel.............................................................................................................. 14 Figure 2: Console Panel - Window Title ..................................................................................................... 15 Figure 3: Console Panel ? Log Area .......................................................................................................... 16 Figure 4: Console Panel ? Command Line ................................................................................................ 16 Figure 5: Console Panel ? Status Line....................................................................................................... 17 Figure 6: Hercules Device and Status Panel.............................................................................................. 18 Figure 7: Hercules Help Panel ................................................................................................................... 19 Figure 8: Device and Status Panel ? Title Line .......................................................................................... 20 Figure 9: Device and Status Panel ? Register Area................................................................................... 20 Figure 10: Device and Status Panel ? Operator Area ................................................................................ 21 Figure 11: Device and Status Panel ? CPU Utilization Bar........................................................................ 22 Figure 12: Device and Status Panel ? Peripherals Area ............................................................................ 23 Figure 13: Web Browser Interface ? Logon................................................................................................ 24 Figure 14: Web Browser Interface ? Main Screen ..................................................................................... 25 Figure 15: Web Browser Interface ? System Log....................................................................................... 26 Figure 16: Web Browser Interface ? IPL .................................................................................................... 27 Figure 17: Web Browser Interface ? Register Selection ............................................................................ 27 Figure 18: Web Browser Interface ? Registers Details .............................................................................. 28 Figure 19: Web Browser Interface ? Storage ............................................................................................. 29 Figure 20: Web Browser Interface ? Miscellaneous................................................................................... 30 Figure 21: Web Browser Interface ? Devices............................................................................................. 31 Figure 22: Web Browser Interface ? Subchannel Details .......................................................................... 32 Figure 23: Web Browser Interface ? Version Info ...................................................................................... 33 Figure 24: Web Browser Interface ? CPU ................................................................................................. 33 Figure 25: Web Browser Interface ? GPRs ................................................................................................ 34 Figure 26: Web Browser Interface ? CRs................................................................................................... 34 Figure 27: Web Browser Interface ? PSW ................................................................................................. 35 Figure 28: Web Browser Interface ? Documentation ................................................................................. 35 Figure 29: CCKDCDSK utility output .......................................................................................................... 42 Figure 30: CCKDCOMP utility output ......................................................................................................... 44 Figure 31: CCKDDIAG utility output ........................................................................................................... 47 Figure 32: CCKDSWAP utility output ......................................................................................................... 48 Figure 33: DASDCAT utility output (create PDS member list) ................................................................... 50 Figure 34: DASDCAT utility output (list a member from a PDS) ................................................................ 51 Figure 35: DASDCAT utility output (list all members of a PDS)................................................................. 52 Figure 36: DASDCONV utility output.......................................................................................................... 54 Figure 37: DASDCOPY utility output .......................................................................................................... 56 Figure 38: DASDINIT utility output ............................................................................................................. 59 Figure 39: DASDISUP utility output............................................................................................................ 61 Figure 40: DASDLOAD utility output (XMIT method, message level 1) ..................................................... 67 Figure 41: DASDLOAD utility output (XMIT method, message level 3) ..................................................... 68 Figure 42: DASDLOAD utility output (SEQ method, message level 5) ...................................................... 69 Figure 43: DASDLS utility output (extended information) .......................................................................... 72 Figure 44: DASDLS utility output (extended information) .......................................................................... 73

Hercules Emulator V4.00 ? Operations and Utilities Guide

Page 5

Figure 45: DASDPDSU utility output .......................................................................................................... 75 Figure 46: DASDSEQ utility output ............................................................................................................ 77 Figure 47: HETGET utility output ............................................................................................................... 79 Figure 48: HETINIT utility output ................................................................................................................ 81 Figure 49: HETMAP utility output (print all label and file information)........................................................ 85 Figure 50: HETMAP utility output (print only dataset information) ............................................................. 85 Figure 51: HETMAP utility output (TAPEMAP compatible output)............................................................. 86 Figure 52: HETUPD utility output ............................................................................................................... 88 Figure 53: TAPECOPY utility output .......................................................................................................... 90 Figure 54: TAPEMAP utility output (map AWS tape file) ........................................................................... 92 Figure 55: TAPESPLT utility output............................................................................................................ 94 Figure 56: FTAPE utility output (display status) ....................................................................................... 107 Figure 57: HercPrt Program Options Page .............................................................................................. 109 Figure 58: HercPrt PDF Options Page ..................................................................................................... 111 Figure 59: Job Seperator Control File Sample ......................................................................................... 123 Figure 60: HercPrt Report Sample ........................................................................................................... 124 Figure 61: AWSSL JCL (Create AWS virtual tape) .................................................................................. 133 Figure 62: AWSSL JCL (Create datasets from AWS virtual tape) ........................................................... 134 Figure 63: AWSUTIL utility JCL................................................................................................................ 136 Figure 64: RAWSTAPE utility JCL ........................................................................................................... 137 Figure 65: IEBGENER JCL for RAWSTAPE utility................................................................................... 137 Figure 66: VTT2DISK utility JCL. ............................................................................................................. 139 Figure 67: VTT2TAPE utility JCL ............................................................................................................. 139 Figure 68: VTT2CNVU utility JCL............................................................................................................. 140 Figure 69: Sample Syntax Description ..................................................................................................... 148 Figure 70: Sample Syntax Diagram ......................................................................................................... 148

Hercules Emulator V4.00 ? Operations and Utilities Guide

Page 6

Tables

Table 1: DASD image file maintenance utilites .......................................................................................... 38 Table 2: TAPE file maintenance utilities ..................................................................................................... 39 Table 3: Miscellaneous utilities................................................................................................................... 39 Table 4: Third party utilities ........................................................................................................................ 39 Table 5: Mainframe utilities......................................................................................................................... 40 Table 6: Sample Control Files .................................................................................................................. 114 Table 7: HercPrt PDF and RTF Options................................................................................................... 118 Table 8: HercPrt ASA Control Characters and ASCII Equivalents........................................................... 121 Table 9: Supported CKD DASD Devices ................................................................................................. 142 Table 10: Supported FBA DASD Devices ................................................................................................ 143 Table 11: Reading Syntax Descriptions ................................................................................................... 144 Table 12: Reading Syntax Diagrams........................................................................................................ 147

Hercules Emulator V4.00 ? Operations and Utilities Guide

Page 7

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 Hercules utilities as well as thirdparty utilities. For guidance in installation of Hercules, for a general overview or for reference information, 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 utilities related to the Hercules Emulator. You can go through the book chapter by chapter or you can use the book as a reference for all questions regarding the Hercules utilities.

1.6 Revision Notice

Hercules Release:

Version 4 Release 00 Modification 0

Publication Number: HEOP040000

SoftCopy Name:

HerculesOperationsandUtilities

Revision Number:

HEOP040000-00

Date:

November 21, 2015

Hercules Emulator V4.00 ? Operations and Utilities Guide

Page 8

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download