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

Hercules – Reference Summary

Version 3 Release 12
 Hercules System/370, ESA/390, z/Architecture Emulator

Hercules – Reference Summary

Version 3 Release 12

First Edition, November 30, 2015

HERS031200-00

Hercules Emulator V3.12 Page 2

Contents
Contents ................................................................................3
Tables .................................................................................... 4
1. Preface ......................................................................... 5
2. Hercules Configuration File ........................................... 6
3. System Parameter Descriptions .................................. 11
4. Device Definition Descriptions ..................................... 28
5. Hercules Console Commands ..................................... 40
6. Console Command Descriptions ................................. 46
7. Hercules Utilities ......................................................... 81
8. Shared Device Support ............................................... 93
9. Hercules 3270 Logo .................................................... 94
10. Starting the Hercules Emulator ............................... 96
11. Using the keyboard ................................................. 97
Appendix A: Supported DASD Device Types ..................... 100
Appendix B. Syntax............................................................ 103

Hercules Emulator V3.12 Page 3

Tables
Table 1: Hercules System Parameters ................................... 8
Table 2: Hercules Device Definitions .................................... 10
Table 3: Process Priority Conversions.................................. 27
Table 4: Thread Priority Conversions ................................... 27
Table 5: Default CU Types ................................................... 38
Table 6: Hercules Console Commands ................................ 45
Table 7: DASD Utilities......................................................... 81
Table 8: TAPE Utilities ......................................................... 82
Table 9: Miscellanious Utilities ............................................. 82
Table 10: Normal cursor handling ........................................ 98
Table 11: Extended cursor handling ..................................... 99
Table 12: Supported CKD DASD Devices .......................... 101
Table 13: Supported FBA DASD Devices .......................... 102
Table 14: Reading Syntax Descriptions.............................. 104
Table 15: Reading Syntax Diagrams .................................. 106

Hercules Emulator V3.12 Page 4

1. Preface

1.1 Edition information

This edition applies to the Hercules S/370, ESA/390 and
z/Architecture Emulator, Release 3.12.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 Revision Notice

Hercules Release: Version 3 Release 12 Modification 0
Publication Number: HERS031200
SoftCopy Name: HerculesReferenceSummary
Revision Number: HERS031200-00
Date: November 30, 2015

1.3 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:
[email protected]

Hercules Emulator V3.12 Page 5

2. Hercules Configuration File

2.1 System Parameters

System Parameter Description

# Comment line

* Comment line

ARCHMODE Initial architecture mode

ASN_AND_LX_REUSE ESAME ASN and LX REUSE

(ALRF) feature

AUTOMOUNT Tape automount root directory

AUTO_SCSI_MOUNT Automatic SCSI tape mounts

CCKD Compressed CKD DASD

options

CNSLPORT Telnet client port

CODEPAGE Codepage conversion table

CONKPALV Console and telnet clients

keep-alive option

CPUMODEL CPU model

CPUPRIO CPU thread process priority

CPUSERIAL CPU serial number

CPUVERID CPU version code

DEFSYM Define symbol

DEVPRIO Device threads process

priority

DEVTMAX Maximum number of device

threads

Hercules Emulator V3.12 Page 6

System Parameter Description

DIAG8CMD DIAGNOSE 8 cmd setting

ECPSVM ECPS:VM support status (VM)

ENGINES Processor engine type

HERCLOGO Hercules 3270 logo

HERCPRIO Hercules process priority

HTTPPORT HTTP server port

HTTPROOT HTTP server root directory

IGNORE Ignore subsequent INCLUDE

errors

INCLUDE Include configuration file

IODELAY I/O interrupt wait time (LINUX)

LDMOD Additional dynamic load

modules

LEGACYSENSEID SENSE ID CCW (x’E4’)

feature

LOADPARM IPL parameter

LOGOPT Log options

LPARNAME LPAR name returned by DIAG

x'204'

LPARNUM LPAR identification number

MAINSIZE Main storage in MB

MANUFACTURER Manufacturer name returned

by STSI instruction

MAXCPU Maximum number of CPUs

MODEL Model names returned by

STSI instruction

MODPATH Dynamic load module path

Hercules Emulator V3.12 Page 7

System Parameter Description

MOUNTED_TAPE_REINIT Control tape initialization

NUMCPU Number of emulated CPUs

NUMVEC Number of vector facilities

OSTAILOR Intended operating system

PANRATE Panel refresh rate

PANTITLE Hercules console panel title

PGMPRDOS Emulation of IFL HW

PLANT Plant name returned by STSI

instruction

SCLPROOT SCLP base directory

SHCMDOPT Shell command option

SHRDPORT Shared device server port

SYSEPOCH Base date for TOD clock

TIMERINT Internal timer update interval

TODDRAG TOD clock drag factor

TODPRIO Timer thread process priority

TRACEOPT Instruction trace display option

TZOFFSET TOD clock offset from GMT

XPNDSIZE Expanded storage in MB

YROFFSET TOD clock offset from actual

date

Table 1: Hercules System Parameters

Hercules Emulator V3.12 Page 8

2.2 Device Definitions

Device Type Device Emulated by

3270, 3278 Local non-SNA TN3270 client

display or printer connection

SYSG Integrated 3270 TN3270 client

(SYSG) console connection

1052, 3215 Console printer- Telnet client

keyboards connection

1052-C, 3215-C Integrated console Integrated on

printer-keyboards Hercules console

1442, 2501, Card readers Disk file(s), ASCII

3505 or EBCDIC

3525 Card punch Disk file, ASCII or

EBCDIC

1403, 3211 Line printers Disk file, ASCII

3410, 3420, Tape drives Disk file, CD-

3422, 3430, ROM or SCSI
3480, 3490, tape
3590, 9347,
8809

3088 Channel-to-Channel “CTCT” driver

Adapter

(( CTCI )) Channel-to-Channel “CTCI” TUN/TAP

link to host TCP/IP driver
stack

(( LCS )) IBM 2216 router, “LCS” (LAN

IBM 3172 running channel station)
ICP, TUN/TAP driver
IBM 8232 LCS
device,
LCS3172 driver of a
P/390,
IBM Open Systems
Adapter (OSA)

3310, 3370, FBA direct access Disk file

9332, 9335, storage devices
9336, 0671

Hercules Emulator V3.12 Page 9

Device Type Device Emulated by

2305, 2311, CKD direct access Disk file

2314, 3330, storage devices
3340, 3350,
3375, 3380,
3390, 9345

2703 Communication line TCP socket

Table 2: Hercules Device Definitions

Hercules Emulator V3.12 Page 10

3. System Parameter Descriptions

# or * (Comment lines)

Descriptive
# [anything]
or
* [anything]

Diagram
Êʬ¬ # ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ anything ¬¬¯
or
Êʬ¬ * ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ anything ¬¬¯

ARCHMODE (Initial architecture mode)

Descriptive
ARCHMODE {S/370 | ESA/390 | ESAME | z/ARCH}

Diagram
Êʬ¬ ARCHMODE ¬¬§¬¬ S/370 ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ ESA/390 ¬¬«
ª¬¬ ESAME ¬¬¬¬«
¬¬ z/ARCH ¬¬¬¯

ASN_AND_LX_REUSE / ALRF (ESAME ASN

and LX REUSE feature)

Descriptive
ASN AND LX REUSE {DISABLE | ENABLE}
or
ALRF {DISABLE | ENABLE}

Diagram
Êʬ¬ ASN AND LX REUSE ¬¬§¬¬ DISABLE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ENABLE ¬¬¬¯

Hercules Emulator V3.12 Page 11

 or

Êʬ¬ ALRF ¬¬§¬¬ DISABLE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬ ENABLE ¬¬¬¯

AUTOMOUNT (Tape automount root directory)

Descriptive
AUTOMOUNT [+ | -]directory
or
AUTOMOUNT {ADD directory | DEL directory}

Diagram
~¬¬ + ¬¬®
Êʬ¬ AUTOMOUNT ¬¬¦¬¬¬¬¬¬¬¦¬¬ directory ¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ - ¬¬¯
or

Êʬ¬ AUTOMOUNT ¬¬§¬¬ ADD directory ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬ DEL directory ¬¬¯

AUTO_SCSI_MOUNT (Automatic SCSI tape

mounts)

Descriptive
AUTO SCSI MOUNT {NO | YES | n}

Diagram
Êʬ¬ AUTO SCSI MOUNT ¬¬§¬¬ NO ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ YES ¬¬«
¬¬¬ n ¬¬¬¯

CCKD (Compressed CKD DASD options)

Descriptive
CCKD option=value [ ,option=value ... ]

where option can be:

[COMP={-1 | n}]
[,COMPPARM={-1 | n}]

Hercules Emulator V3.12 Page 12

[,RA={2 | n}]
[,RAQ={4 | n}]
[,RAT={2 | n}]
[,WR={2 | n}]
[,GCINT={10 | n}]
[,GCPARM={0 | n}]
[,NOSTRESS={0 | 1}]
[,FREEPEND={-1 | n}]
[,FSYNC={0 | 1}]
[,TRACE={0 | n}]
[,LINUXNULL={0 | 1}]
[,GCSTART={0 | 1}]

Diagram
~¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬®
Êʬ¬ CCKD ¬¬°¬¬« option=value ª¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

where option can be:

ª¬¬ COMP= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯
ª¬¬ COMPPARM= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ n ¬¬¯
ª¬¬ RA= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ n ¬¬¯

ª¬¬ RAQ= ¬¬§¬¬ 4 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ RAT= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ WR= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ GCINT= ¬¬§¬¬ 10 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¬¯

ª¬¬ GCPARM= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ NOSTRESS= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ 1 ¬¬¯

ª¬¬ FREEPEND= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¬¯

ª¬¬ FSYNC= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ 1 ¬¬¯

Hercules Emulator V3.12 Page 13

ª¬¬ TRACE= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ n ¬¬¯
ª¬¬ LINUXNULL= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬ GCSTART= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯

CNSLPORT (Telnet client port)

Descriptive
CNSLPORT {3270 | port | host:port}

Diagram
Êʬ¬ CNSLPORT ¬¬§¬¬¬¬¬ 3270 ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬ port ¬¬¬¬«
¬¬ host:port ¬¬¯

CODEPAGE (Codepage conversion table)

Descriptive
CODEPAGE {DEFAULT | codepage}

Diagram
Êʬ¬ CODEPAGE ¬¬§¬¬ DEFAULT ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ codepage ¬¬¯

CONKPALV (Console and telnet clients keep-

alive option)

Descriptive
CONKPALV {(3,1,10) | (idle,intv,count)}

Diagram
Êʬ¬ CONKPALV ¬¬§¬¬¬¬¬¬ (3,1,10) ¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ (idle,intv,count) ¬¬¯

CPUMODEL (CPU model)

Descriptive
CPUMODEL {0586 | model}

Hercules Emulator V3.12 Page 14

Diagram
Êʬ¬ CPUMODEL ¬¬§¬¬ 0586 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ model ¬¬¯

CPUPRIO (CPU thread process priority)

Descriptive
CPUPRIO {15 | nn}

Diagram
Êʬ¬ CPUPRIO ¬¬§¬¬ 15 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

CPUSERIAL (CPU serial number)

Descriptive
CPUSERIAL {000001 | serial}

Diagram
Êʬ¬ CPUSERIAL ¬¬§¬¬ 000001 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ serial ¬¬¯

CPUVERID (CPU version code)

Descriptive
CPUVERID 00 (For z/ARCH and ESAME)
CPUVERID {FD | verid} (For S/370 and ESA/390)

Diagram
For z/ARCH and ESAME:
Êʬ¬ CPUVERID ¬¬ 00 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

For S/370 and ESA/390:

Êʬ¬ CPUVERID ¬¬§¬¬¬¬ FD ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ verid ¬¬¯

Hercules Emulator V3.12 Page 15

DEFSYM (Define symbol)

Descriptive
DEFSYM symbol value

Diagram
Êʬ¬ DEFSYM ¬¬ symbol ¬¬ value ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

DEVPRIO (Device threads process priority)

Descriptive
DEVPRIO {8 | nn}

Diagram
Êʬ¬ DEVPRIO ¬¬§¬¬ 8 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

DEVTMAX (Maximum number of device

threads)

Descriptive
DEVTMAX {0 | -1 | 1-n}

Diagram
Êʬ¬ DEVTMAX ¬¬§¬¬¬ 0 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ -1 ¬¬¬«
¬¬ 1-n ¬¬¯

DIAG8CMD (DIAGNOSE 8 command setting)

Descriptive
DIAG8CMD {DISABLE | ENABLE [ECHO | NOECHO]}

Diagram
Êʬ¬ DIAG8CMD ¬¬§¬¬ DISABLE ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬ÊÍ
¬¬ ENABLE ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ ECHO ¬¬¬«
¬¬ NOECHO ¬¬¯

Hercules Emulator V3.12 Page 16

ECPSVM (ECPS:VM support status (VM))

Descriptive
ECPSVM {NO | YES | LEVEL nn}

Diagram
Êʬ¬ ECPSVM ¬¬§¬¬¬¬¬ NO ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬ YES ¬¬¬¬«
¬¬ LEVEL nn ¬¬¯

ENGINES (Processor engines type)

Descriptive
ENGINES [nn*] {CP | IL | AP | IP} [, ... ]

Diagram
~¬¬¬¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬¬¬¬¬®
Êʬ¬ ENGINES ¬¬°¬¬§¬¬¬¬¬¬¬¬¬§¬¬§¬¬ CP ¬¬§¬¬¨¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn* ¬¬¯ ª¬¬ IL ¬¬«
ª¬¬ AP ¬¬«
¬¬ IP ¬¬¯

HERCLOGO (Hercules 3270 logo)

Descriptive
HERCLOGO filename

Diagram
Êʬ¬ HERCLOGO ¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

HERCPRIO (Hercules process priority)

Descriptive
HERCPRIO {0 | nn}

Diagram
Êʬ¬ HERCPRIO ¬¬¬§¬¬ 0 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

Hercules Emulator V3.12 Page 17

HTTPPORT (HTTP server port)

Descriptive
HTTPPORT NONE | port {NOAUTH | AUTH userid password}

Diagram
Êʬ¬ HTTPPORT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ʬ¬§¬¬ NONE ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ port ¬¬§¬¬¬¬¬¬¬¬¬ NOAUTH ¬¬¬¬¬¬¬¬¬«
¬¬ AUTH userid password ¬¬¯

HTTPROOT (HTTP server root directory)

Descriptive
HTTPROOT path

Diagram
Êʬ¬ HTTPROOT ¬¬ path ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

IGNORE (Ignore subsequent INCLUDE errors)

Descriptive
IGNORE INCLUDE ERRORS

Diagram
Êʬ¬ IGNORE ¬¬ INCLUDE ERRORS ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

INCLUDE (Include configuration file)

Descriptive
INCLUDE filepath

Diagram
Êʬ¬ INCLUDE ¬¬ filepath ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

IODELAY (I/O interrupt wait time (LINUX))

Descriptive
IODELAY {0 | usecs [NOWARN]}

Hercules Emulator V3.12 Page 18

Diagram
Êʬ¬ IODELAY ¬¬§¬¬¬¬¬¬¬¬¬¬ 0 ¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ usecs ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ NOWARN ¬¬¯

LDMOD (Additional dynamic load modules)

Descriptive
LMOD module module module ...

Diagram
~¬¬¬¬¬¬¬¬¬¬¬¬®
Êʬ¬ LDMOD ¬¬°¬¬ module ¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

LEGACYSENSEID (SENSE ID CCW (x'E40) fea-

ture)

Descriptive
LEGACYSENSEID [{OFF | DISABLE} | {ON | ENABLE}]

Diagram
Êʬ¬ LEGACYSENSEID ¬¬§¬¬¬¬ OFF ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ DISABLE ¬¬«
ª¬¬¬¬ ON ¬¬¬¬¬«
¬¬ ENABLE ¬¬¬¯

LOADPARM (IPL parameter)

Descriptive
LOADPARM ipl parameter

Diagram
Êʬ¬ LOADPARM ¬¬ ipl parameter ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

LOGOPT (Log options)

Descriptive
LOGOPT {TIMESTAMP | TIME | NOTIMESTAMP | NOTIME}

Hercules Emulator V3.12 Page 19

Diagram
Êʬ¬ LOGOPT ¬¬§¬¬¬ TIMESTAMP ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬ TIME ¬¬¬¬¬¬«
ª¬¬ NOTIMESTAMP ¬¬«
¬¬¬¬ NOTIME ¬¬¬¬¬¯

LPARNAME (LPAR name returned by DIAG

x'204')

Descriptive
LPARNAME {HERCULES | lparname}

Diagram
Êʬ¬ LPARNAME ¬¬§¬¬ HERCULES ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ lparname ¬¬¯

LPARNUM (LPAR identification number)

Descriptive
LPARNUM {00 | nn}

Diagram
Êʬ¬ LPARNUM ¬¬§¬¬ 00 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

MAINSIZE (Main storage in MB)

Descriptive
MAINSIZE size

Diagram
Êʬ¬ MAINSIZE ¬¬ size ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

MANUFACTURER (Manufacturer name

returned STSI instruction)

Descriptive
MANUFACTURER {HRC | name}

Hercules Emulator V3.12 Page 20

Diagram
Êʬ¬ MANUFACTURER ¬¬§¬¬ HRC ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ name ¬¬¯

MAXCPU (Maximum number of CPUs)

Descriptive
MAXCPU {1 | nn}

Diagram
Êʬ¬ MAXCPU ¬¬§¬¬ 1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

MODEL (Model names retuned by STSI

instruction)

Descriptive
MODEL {EMULATOR | hardware model} [capacity model]
[perm capacity model] [temp capacity model]

Diagram
Êʬ¬ MODEL ¬¬§¬¬¬¬¬ EMULATOR ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ hardware model ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ capacity model ¬¬¯
ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ perm capacity model ¬¬¯
ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ temp capacity model ¬¬¯

MODPATH (Dynamic load module path)

Descriptive
MODPATH path

Diagram
Êʬ¬ MODPATH ¬¬ path ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V3.12 Page 21

MOUNTED_TAPE_REINIT (Control tape initiali-
zation)

Descriptive
MOUNTED TAPE REINIT {ALLOW | DISALLOW}

Diagram
Êʬ¬ MOUNTED TAPE REINIT ¬¬§¬¬¬¬ ALLOW ¬¬¬§¬¬¬¬¬¬¬¬¬¬ÊÍ
¼ ¼ ¬¬ DISALLOW ¬¬¯

NUMCPU (Number of emulated CPUs)

Descriptive
NUMCPU {1 | nn}

Diagram
Êʬ¬ NUMCPU ¬¬§¬¬ 1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

NUMVEC (Number of vector facilities)

Descriptive
NUMVEC {0 | nn}

Diagram
Êʬ¬ NUMVEC ¬¬§¬¬ 0 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

OSTAILOR (Intended operating system)

Descriptive
OSTAILOR {z/OS | OS/390 | VM | VSE | LINUX |
OPENSOLARIS | QUIET | NULL}

Hercules Emulator V3.12 Page 22

Diagram
Êʬ¬ OSTAILOR ¬¬§¬¬¬¬¬¬ z/OS ¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬ OS/390 ¬¬¬¬¬«
ª¬¬¬¬¬¬ VM ¬¬¬¬¬¬¬¬«
ª¬¬¬¬¬¬ VSE ¬¬¬¬¬¬¬«
ª¬¬¬¬¬ LINUX ¬¬¬¬¬¬«
ª¬¬ OPENSOLARIS ¬¬¬«
ª¬¬¬¬¬ QUIET ¬¬¬¬¬¬«
¬¬¬¬¬ NULL ¬¬¬¬¬¬¬¯

PANRATE (Panel refresh rate)

Descriptive
PANRATE {SLOW | FAST | rate}

Diagram
Êʬ¬ PANRATE ¬¬§¬¬ SLOW ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ FAST ¬¬«
¬¬ rate ¬¬¯

PANTITLE (Hercules console window title)

Descriptive
PANTITLE {text | "text text text"}

Diagram
Êʬ¬ PANTITLE ¬¬§¬¬¬¬¬¬¬¬ text ¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ "text text text" ¬¬¯

PGMPRDOS (Emulation of IFL HW)

Descriptive
PGMPRDOS {RESTRICTED | LICENSED}

Diagram
Êʬ¬ PGMPRDOS ¬¬§¬¬ RESTRICTED ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬ LICENSED ¬¬¬¯

PLANT (Plant name returned by STSI instruc-

tion)

Descriptive
PLANT {ZZ | name}

Hercules Emulator V3.12 Page 23

Diagram
Êʬ¬ PLANT ¬¬§¬¬¬ ZZ ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ name ¬¬¯

SCLPROOT (SCLP base directory)

Descriptive
SCLPROOT {NONE | directory}

Diagram
Êʬ¬ SCLPROOT ¬¬§¬¬¬¬ NONE ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ directory ¬¬¯

SHCMDOPT (Shell command option)

Descriptive
SHCMDOPT {DISABLE | NODIAG8}

Diagram
Êʬ¬ SHCMDOPT ¬¬§¬¬ DISABLE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ NODIAG8 ¬¬¯

SHRDPORT (Shared device server port)

Descriptive
SHRDPORT {3990 | port}

Diagram
Êʬ¬ SHRDPORT ¬¬§¬¬ 3990 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ port ¬¬¯

SYSEPOCH (Base date for TOD clock)

Descriptive
SYSEPOCH {1900 | 1960 | year [+years | -years]}

Diagram
Êʬ¬ SYSEPOCH ¬¬§¬¬ 1900 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ year ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ +years ¬¬«
¬¬ -years ¬¬¯

Hercules Emulator V3.12 Page 24

TIMERINT (Internal timer update interval)

Descriptive
TIMERINT {50 | interval}

Diagram
Êʬ¬ TIMERINT ¬¬§¬¬¬¬¬ 50 ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ interval ¬¬¯

TODDRAG (TOD clock drag factor)

Descriptive
TODDRAG {1.000000 | factor}

Diagram
Êʬ¬ TODDRAG ¬¬§¬¬ 1.000000 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬ factor ¬¬¬¯

TODPRIO (Timer thread process priority)

Descriptive
TODPRIO {-20 | nn}

Diagram
Êʬ¬ TODPRIO ¬¬§¬¬ -20 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¬¯

TRACEOPT (Instruction trace display option)

Descriptive
TRACEOPT {TRADITIONAL | REGSFIRST | NOREGS}

Diagram
Êʬ¬ TRACEOPT ¬¬§¬¬ TRADITIONAL ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ REGSFIRST ¬¬¬«
¬¬¬¬ NOREGS ¬¬¬¬¬¯

Hercules Emulator V3.12 Page 25

TZOFFSET (TOD clock offset from GMT)

Descriptive
TZOFFSET {0000 | +hhmm | -hhmm}

Diagram
Êʬ¬ TZOFFSET ¬¬§¬¬ 0000 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ +hhmm ¬¬«
¬¬ -hhmm ¬¬¯

XPNDSIZE (Expanded storage in MB)

Descriptive
XPNDSIZE size

Diagram
Êʬ¬ XPNDSIZE ¬¬ size ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

YROFFSET (TOD clock offset from actual

date)

Descriptive
YROFFSET {+years | -years}

Diagram
Êʬ¬ YROFFSET ¬¬§¬¬ +years ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ -years ¬¬¯

Hercules Emulator V3.12 Page 26

Process and Thread Priorities

Process Priorities

Unix Process Priority Windows Priority Class

-20 to -16 Realtime

-15 to -9 High

-8 to -1 Above Normal

0 to 7 Normal

8 to 15 Below Normal

16 to 20 Low

Table 3: Process Priority Conversions

Thread Priorities

Unix Thread Priority Windows Thread Priority

-20 to -16 Time Critical

-15 to -9 Highest

-8 to -1 Above Normal

0 to 7 Normal

8 to 15 Below Normal

16 to 19 Lowest

20 Idle

Table 4: Thread Priority Conversions

Hercules Emulator V3.12 Page 27

4. Device Definition Descriptions

Local non-SNA 3270 Devices

Descriptive
devaddr devtype [{groupname | *} [ipaddr [mask]]]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ * ¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ groupname ¬¬¯ ¬¬ ipaddr ¬¬§¬¬¬¬¬¬¬¬¬¬«
¬¬ mask ¬¬¯

Integrated 3270 (SYSG) Console

Descriptive
devaddr SYSG [{groupname | *} [ipaddr [mask]]]

Diagram
Êʬ¬ devaddr ¬¬ SYSG ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ * ¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ groupname ¬¬¯ ¬¬ ipaddr ¬¬§¬¬¬¬¬¬¬¬¬¬«
¬¬ mask ¬¬¯

Note: The device address is ignored for the integrated 3270

(SYSG) console.

Console Printer-Keyboard Devices

Descriptive
devaddr devtype [NOPROMPT]
[{groupname | *} [ipaddr [mask]]]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ NOPROMPT ¬¬¬¯

Hercules Emulator V3.12 Page 28

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ * ¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ groupname ¬¬¯ ¬¬ ipaddr ¬¬§¬¬¬¬¬¬¬¬¬¬«
¬¬ mask ¬¬¯

Integrated Console Printer-Keyboard Devices

Descriptive
devaddr devtype [prefix | / ]

Diagram
~¬¬¬¬¬ / ¬¬¬¬®
Êʬ¬ devaddr ¬¬ devtype ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ prefix ¬¬¯

Card Reader Devices

Descriptive
devaddr devtype filename [filename ... ]
[SOCKDEV] [EOF] [INTRQ] [MULTIFILE]
[EBCDIC [AUTOPAD]] [ASCII [TRUNC]]

Diagram
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
Êʬ¬ devaddr ¬¬ devtype ¬¬°¬¬ filename ¬¬¬¬¨¬¬¬¬¬¬¬¬¬¬Ê

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬Ê
¬¬ SOCKDEV ¬¬¯ ¬¬ EOF ¬¬¯ ¬¬ INTRQ ¬¬¯

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬Ê
¬¬ MULTIFILE ¬¬¯ ¬¬ EBCDIC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ AUTOPAD ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ASCII ¬¬§¬¬¬¬¬¬¬¬¬¬¬«
¬¬ TRUNC ¬¬¯

Card Punch Devices

Descriptive
devaddr devtype filename [ASCII] [CRLF] [NOCLEAR]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬ filename ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬Ê
¬¬ ASCII ¬¬¯

Hercules Emulator V3.12 Page 29

ʬ¬§¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ CLRF ¬¬¯ ¬¬ NOCLEAR ¬¬¯

Line Printer Devices

Descriptive
devaddr devtype filename [CRLF] [NOCLEAR]
or
devaddr devtype [host:]port SOCKDEV

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬ filename ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬Ê
¬¬ CLRF ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬ NOCLEAR ¬¬¬¯

or

Êʬ¬ devaddr ¬¬ devtype ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬ port ¬¬¬¬¬¬Ê

¬¬ host: ¬¬¯
ʬ¬ SOCKDEV ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Emulated Tape Devices

SCSI Tapes

Descriptive
devaddr devtype devname [--no-erg]
[--blkid-32 | --blkid-22]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬ devname ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ --no-erg ¬¬¯ ª¬¬ --blkid-32 ¬¬«
¬¬ --blkid-22 ¬¬¯

Optical Media Attach (OMA) virtual files

Descriptive
devaddr devtype tdf

Hercules Emulator V3.12 Page 30

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬ tdf ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

AWSTAPE virtual files

Descriptive
devaddr devtype {awsfile | *} [arguments]

where arguments are:

[MAXSIZE={n | 0} | MAXSIZEK={n | 0} | MAXSIZEM={n | 0}]

[EOTMARGIN=n]
[READONLY={0 | 1}]
[RO | NORING | RW | RING]
[DEONIRQ={0 | 1}]
[NOAUTOMOUNT]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬§¬¬ awsfile ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬¬¬¬ * ¬¬¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬« arguments ª¬¬¨¬¬¯

where arguments are:

ª¬¬§¬¬ MAXSIZE= ¬¬¬§¬¬ 0 ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

­ ¬¬ n ¬¬¯ ­
ª¬¬ MAXSIZEK= ¬¬§¬¬ 0 ¬¬§¬¬«
­ ¬¬ n ¬¬¯ ­
¬¬ MAXSIZEM= ¬¬§¬¬ 0 ¬¬§¬¬¯
¬¬ n ¬¬¯
ª¬¬ EOTMARGIN=n ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ READONLY= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ 1 ¬¬¯
ª¬¬§¬¬¬¬ RO ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ NORING ¬¬«
ª¬¬¬¬ RW ¬¬¬¬«
¬¬¬ RING ¬¬¬¯
ª¬¬ DEONIRQ= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬ NOAUTOMOUNT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

Hercules Emulator V3.12 Page 31

Fake Tape virtual files

Descriptive
devaddr devtype {fakefile | *} [arguments]

where arguments are:

[MAXSIZE={n | 0} | MAXSIZEK={n | 0} | MAXSIZEM={n | 0}]

[EOTMARGIN=n]
[READONLY={0 | 1}]
[RO | NORING | RW | RING]
[DEONIRQ={0 | 1}]
[NOAUTOMOUNT]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬§¬¬ fakefile ¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬¬¬¬ * ¬¬¬¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬« arguments ª¬¬¨¬¬¯

where arguments are:

ª¬¬§¬¬ MAXSIZE= ¬¬¬§¬¬ 0 ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

­ ¬¬ n ¬¬¯ ­
ª¬¬ MAXSIZEK= ¬¬§¬¬ 0 ¬¬§¬¬«
­ ¬¬ n ¬¬¯ ­
¬¬ MAXSIZEM= ¬¬§¬¬ 0 ¬¬§¬¬¯
¬¬ n ¬¬¯
ª¬¬ EOTMARGIN=n ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ READONLY= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ 1 ¬¬¯
ª¬¬§¬¬¬¬ RO ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ NORING ¬¬«
ª¬¬¬¬ RW ¬¬¬¬«
¬¬¬ RING ¬¬¬¯

ª¬¬ DEONIRQ= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ 1 ¬¬¯

ª¬¬ NOAUTOMOUNT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

Hercules Emulator V3.12 Page 32

HET virtual files

Descriptive
devaddr devtype {hetfile | *} [arguments]

where arguments are:

[AWSTAPE]
[COMPRESS={0 | 1}]
[IDRC={0 | 1}]
[METHOD={1 | 2}]
[LEVEL={n | 4}]
[CHUNKSIZE={nnnnn | 65535}]
[MAXSIZE={n | 0} | MAXSIZEK={n | 0} | MAXSIZEM={n | 0}]
[EOTMARGIN=n]
[READONLY={0 | 1}]
[STRICTSIZE={0 | 1}]
[RO | NORING | RW | RING]
[DEONIRQ={0 | 1}]
[NOAUTOMOUNT]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬§¬¬ hetfile ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬¬¬¬ * ¬¬¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬« arguments ª¬¬¨¬¬¯

where arguments are:

ª¬¬ AWSTAPE ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ COMPRESS= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ 1 ¬¬¯
ª¬¬ IDRC= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬ METHOD= ¬¬§¬¬ 1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 2 ¬¬¯
ª¬¬ LEVEL= ¬¬§¬¬ 4 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ n ¬¬¯
ª¬¬ CHUNKSIZE= ¬¬§¬¬ 65535 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ nnnnn ¬¬¯

Hercules Emulator V3.12 Page 33

ª¬¬§¬¬ MAXSIZE= ¬¬¬§¬¬ 0 ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
­ ¬¬ n ¬¬¯ ­
ª¬¬ MAXSIZEK= ¬¬§¬¬ 0 ¬¬§¬¬«
­ ¬¬ n ¬¬¯ ­
¬¬ MAXSIZEM= ¬¬§¬¬ 0 ¬¬§¬¬¯
¬¬ n ¬¬¯
ª¬¬ EOTMARGIN=n ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ READONLY= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬ STRICTSIZE= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬§¬¬¬¬ RO ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ NORING ¬¬«
ª¬¬¬¬ RW ¬¬¬¬«
¬¬¬ RING ¬¬¬¯
ª¬¬ DEONIRQ= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬ NOAUTOMOUNT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

Channel-to-Channel Adapters

CTCI (Channel-to-Channel link to TCP/IP stack)

Descriptive
devaddr CTCI [{-n | --dev} name]
[{-s | --netmask} mask]
[{-m | --macaddr}
mac | 00:00:5E:nn:nn:nn}]
[{-t | --mtu} mtu | 1500]
[{-i | --ibuff} {ibuff | 64}]
[{-k | --kbuff} {kbuff | 1024}]
[-d | --debug]
guestip hostip

Diagram
Êʬ¬ devaddr ¬¬ CTCI ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -n ¬¬¬§¬¬ name ¬¬¯
¬¬ --dev ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬¬ -s ¬¬¬¬¬§¬¬ mask ¬¬¯
¬¬ --netmask ¬¬¯

Hercules Emulator V3.12 Page 34

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -m ¬¬¬§¬¬§¬¬¬¬¬¬¬ mac ¬¬¬¬¬¬¬«
¬¬ --mac ¬¬¯ ¬¬ 00:00:5E:nn:nn:nn ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -t ¬¬¬§¬¬ mtu ¬¬¯
¬¬ --mtu ¬¬¯

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬ -i ¬¬¬¬§¬¬§¬¬ ibuff ¬¬«
¬¬ --ibuff ¬¬¯ ¬¬¬ 64 ¬¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬ -k ¬¬¬¬§¬¬§¬¬ kbuff ¬¬«
¬¬ --kbuff ¬¬¯ ¬¬ 1024 ¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ guestip ¬¬ hostip ¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬ -d ¬¬¬¬¬«
¬¬ --debug ¬¬¯

CTCT (Channel-to-Channel emulation via TCP

connection)

Descriptive
devaddr CTCT lport rhost rport bufsize

Diagram
Êʬ¬ devaddr ¬¬ CTCT ¬¬ lport ¬¬ rhost ¬¬ rport ¬¬¬¬¬Ê
ʬ¬ bufsize ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

CTCE (Enhanced Channel-to-Channel emulation via

TCP connection)

Descriptive
devaddr CTCE lport raddress rport [mtu [sml]]

Diagram
Êʬ¬ devaddr ¬¬ CTCE ¬¬ lport ¬¬ raddress ¬¬ rport ¬¬Ê

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ mtu ¬¬§¬¬¬¬¬¬¬¬¬«
¬¬ sml ¬¬¯

LCS (LAN Channel Station)

Descriptive
devaddr LCS [{-n | --dev} name]

Hercules Emulator V3.12 Page 35

 [{-o | --oat} file]
[{-m | --mac} mac]
[-d | --debug]
[guestip]

Diagram
Êʬ¬¬ devaddr ¬¬¬ LCS ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬ -n ¬¬¬¬§¬¬ name ¬¬¯
¬¬ --dev ¬¬¯
ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -o ¬¬¬¬¬§¬¬¬ file ¬¬¬¯
¬¬¬ --oat ¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬ -m ¬¬¬¬§¬¬ mac ¬¬¯
¬¬ --mac ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -d ¬¬¬¬¬«
¬¬ --debug ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ guestip ¬¬¯

OAT File Syntax

**********************************************
* Dev Mode Port Entry specific information
**********************************************
0400 IP 00 PRI 172.021.003.032
0402 IP 00 SEC 172.021.003.033
0404 IP 00 NO 172.021.003.038
0406 IP 01 NO 172.021.002.016
040E SNA 00
HWADD 00 02:00:FE:DF:00:42
HWADD 01 02:00:FE:DF:00:43
ROUTE 00 172.021.003.032 255.255.255.224

FBA DASD Devices

Descriptive
devaddr devtype filename [origin | 0] [numblks]
[sf=shadowfile] [SYNCIO]
or
devaddr devtype ipname [:port | :3990] [:devnum]

Hercules Emulator V3.12 Page 36

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
~¬¬¬¬¬ 0 ¬¬¬¬®
ʬ¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ origin ¬¬¯ ¬¬ numblks ¬¬¯

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ SF=shadowfile ¬¬¯ ¬¬ SYNCIO ¬¬¯

or

Êʬ¬ devaddr ¬¬ devtype ¬¬ ipname ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

~¬¬ :3990 ¬¬®

ʬ¬¦¬¬¬¬¬¬¬¬¬¬¬¦¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ÊÍ
¬¬ :port ¬¬¯ ¬¬ :devnum ¬¬¯ ¬¬ COMP=n ¬¬¯

CKD DASD Devices

Descriptive
devaddr devtype filename [sf=shadowfile]
[{NOSYNCIO | SYNCIO}] [READONLY]
[FAKEWRITE] [CU=type]
or
devaddr devtype ipname [:port | :3990] [:devnum]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬Ê
¬¬¬ SF=shadowfile ¬¬¬¯ ª¬¬ NOSYNCIO ¬¬«
¬¬¬ SYNCIO ¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ READONLY ¬¬¯ ¬¬ FAKEWRITE ¬¬¯

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ CU=type ¬¬¯
or

Êʬ¬ devaddr ¬¬ devtype ¬¬ ipname ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

~¬¬ :3990 ¬¬®
ʬ¬¦¬¬¬¬¬¬¬¬¬¬¬¦¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ÊÍ
¬¬ :port ¬¬¯ ¬¬ :devnum ¬¬¯ ¬¬ COMP=n ¬¬¯

Hercules Emulator V3.12 Page 37

Default CU Types

Device Type Default CU Type

2305, 2311, 2314 2841

3330, 3340, 3350, 3880

3375, 3380

3390 3990

9345 9343

Table 5: Default CU Types

Communication Lines (Preliminary 2703 BSC

Support)

Descriptive
devaddr devtype
DIAL={IN | OUT | INOUT | NO}
LHOST={hostname | ipaddress | *}
LPORT={servicename | port}
RHOST={hostname | ipaddress}
RPORT={servicename | port}
[RTO={0 | -1 | nnn | 3000}]
[PTO={0 | -1 | nnn | 3000}]
[ETO={0 | -1 | nnn | 10000}]

Diagram
Êʬ¬ devaddr ¬¬ devtype ¬¬ DIAL= ¬¬§¬¬¬ IN ¬¬¬¬§¬¬¬¬¬Ê
ª¬¬¬ OUT ¬¬¬«
ª¬¬ INOUT ¬¬«
¬¬¬ NO ¬¬¬¬¯
ʬ¬ LHOST= ¬¬§¬¬¬¬¬¬ * ¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬ hostname ¬¬¬«
¬¬ ipaddress ¬¬¯

ʬ¬ LPORT= ¬¬§¬¬ servicename ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

¬¬¬¬¬ port ¬¬¬¬¬¬¯

Hercules Emulator V3.12 Page 38

ʬ¬ RHOST= ¬¬§¬¬ hostname ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ ipaddress ¬¬¯

ʬ¬ RPORT= ¬¬§¬¬ servicename ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

¬¬¬¬¬ port ¬¬¬¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ RTO= ¬¬§¬¬ 3000 ¬¬«
ª¬¬¬ 0 ¬¬¬¬«
ª¬¬ -1 ¬¬¬¬«
¬¬ nnn ¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ PTO= ¬¬§¬¬ 3000 ¬¬«
ª¬¬¬ 0 ¬¬¬¬«
ª¬¬ -1 ¬¬¬¬«
¬¬ nnn ¬¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ETO= ¬¬§¬¬ 10000 ¬¬«
ª¬¬¬¬ 0 ¬¬¬¬«
ª¬¬¬ -1 ¬¬¬¬«
¬¬¬ nnn ¬¬¬¯

Hercules Emulator V3.12 Page 39

5. Hercules Console Commands

Command Description

!message SCP priority message

# Log comment to syslog

* Log comment to syslog

.reply SCP command

? List all commands / command specific

help (alias for help)

aea Display AEA (absolute-effective-

address) tables

aia Display AIA (absolute-instruction-

address) tables

ar Display access registers

archmode Set architecture mode

attach Configure device

auto_scsi_mount Automatic SCSI tape mounts

automount Show or update allowable tape

automount directories

b Set breakpoint

b+ Set breakpoint

b- Delete breakpoint

cache Cache command

cckd CCKD command

cd Change directory

cf Configure CPU online or offline

Hercules Emulator V3.12 Page 40

Command Description

cfall Configure all CPU’s online or offline

clocks Display TOD clock and CPU timer

cmdtgt Specify the command target

conkpalv Display / alter console TCP/IP keep-

alive settings

cpu Define target CPU for console display

and commands

cr Display or alter control registers

cscript Cancel a running script thread

ctc Enable / disable CTC debugging

define Rename device

defsym Define symbol

detach Remove device

devinit Reinitialize device

devlist List device or all devices

devtmax Display or set max device threads

ds Display subchannel

ecpsvm ECPS:VM commands

exit Terminate the emulator

ext Generate external interrupt

f{+/-} addr Mark frames usable / unusable

fpc Display floating point control registers

fpr Display floating point register

g Turn off instruction stepping and start

CPU

Hercules Emulator V3.12 Page 41

Command Description

gpr Display or alter general purpose

registers

hao Hercules Automatic Operator (HAO)

help List all commands / command specific

help

herc Send Hercules command

herclogo Read a new Hercules logo file

hst History of commands

i Generate I/O attention interrupt for

device

iodelay Display or set I/O delay value

ipending Display pending interrupts

ipl IPL normal from device xxxx

iplc IPL clear from device xxxx

k Display CCKD internal trace

ldmod Load a module

loadcore Load a core image file

loadparm Set IPL parameter

loadtext Load a text deck file

log Direct log output

logopt Change log options

lparname Display or define LPAR name

lparnum Display or set LPAR identification

number

lsdep List module dependencies

Hercules Emulator V3.12 Page 42

Command Description

lsmod List dynamic modules

maxrates Display maximum observed MIPS /

SIO rate or define new reporting
interval

message Display message on console like VM

mounted_tape_reinit Control tape initialization

msg Display message on console like VM

msghld Display or set timeout value of held

messages

msgnoh Display message on console like VM,

but without header

ostailor Specify intended operating system

panrate Display or set console refresh rate

pgmtrace Trace program interrupts

pr Display prefix register

pscp Send system control program priority

message

psw Display or alter program status word

ptt Set / display pthread trace

pwd Print working directory

qd Query DASD

quiet Toggle automatic refresh of console

display data

quit Terminate the emulator

r Display or alter real storage

restart Generate restart interrupt

Hercules Emulator V3.12 Page 43

resume Resume Hercules

rmmod Delete a module

s Instruction stepping

s+ Instruction stepping on

s- Instruction stepping off

s? Instruction stepping query

s{+/-} dev Turn CCW stepping on / off

savecore Save a core image file

sclproot Set or display SCLP base directory

scp Send system control program com-

mand

script Run a sequence of console

commands contained in a file

scsimount Automatic SCSI tape mounts

sf+ Create a new shadow file

sf- Remove a shadow file

sfc Compress a shadow file

sfd Display shadow file statistics

sfk Perform a chkdsk on the active

shadow file

sh Shell command

shrd SHRD command

sizeof Display size of structures

ssd Signal Shutdown

start Start CPU or printer device

startall Start all CPU’s

Hercules Emulator V3.12 Page 44

stop Stop CPU or printer device

stopall Stop all CPU’s

store Store CPU status at absolute zero

suspend Suspend Hercules

syncio Display syncio device statistics

sysclear Issue SYSTEM CLEAR RESET

manual operation

sysreset Issue SYSTEM RESET manual

operation

t Instruction trace

t+ Instruction trace on

t- Instruction trace off

t? Instruction trace query

t{+/-} CKD Turn CKD_KEY tracing on / off

t{+/-} dev Turn CCW tracing on / off

timerint Display or set timers update interval

tlb Display TLB tables

toddrag Display or set TOD clock drag factor

traceopt Instruction trace display option

tt32 Control / query CTCI-WIN functionality

u Disassemble storage

uptime Display Hercules Emulator uptime

v Display or alter virtual storage

version Display version information

Table 6: Hercules Console Commands

Hercules Emulator V3.12 Page 45

6. Console Command Descriptions

!message (SCP priority message)

Descriptive
!prio msg

Diagram
Êʬ¬ !prio message ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

# or * (Log comment to syslog)

Descriptive
# anytext
or
* anytext

Diagram
Êʬ¬ # ¬¬ anytext ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
or
Êʬ¬ * ¬¬ anytext ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

.reply (SCP command)

Descriptive
.reply

Diagram
Êʬ¬ .reply ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

? (List all commands / command specific

help)

Descriptive
? [command]

Hercules Emulator V3.12 Page 46

Diagram
Êʬ¬ ? ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ command ¬¬¯

AEA (Display AEA absolute-effective-address

tables)

Descriptive
AEA

Diagram
Êʬ¬ AEA ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

AIA (List AIA absolute-instruction-address

fields)

Descriptive
AIA

Diagram
Êʬ¬ AIA ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

AR (Display access registers)

Descriptive
AR

Diagram
Êʬ¬ AR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

ARCHMODE (Set architecture mode)

Descriptive
ARCHMODE [S/370 | ESA/390 | ESAME | z/ARCH]

Diagram
Êʬ¬ ARCHMODE ¬¬§¬¬ S/370 ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ ESA/390 ¬¬«
ª¬¬ ESAME ¬¬¬¬«
¬¬ z/ARCH ¬¬¬¯

Hercules Emulator V3.12 Page 47

ATTACH (Configure device)

Descriptive
ATTACH devn type [arguments [arguments ... ]]

Diagram
Êʬ¬ ATTACH ¬¬ devn ¬¬ devtype ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ argument ¬¬¨¬¬¯

AUTOMOUNT (Show or update allowable tape

automount directories)

Descriptive
AUTOMOUNT {ADD directory | DEL directory | LIST}
or
AUTOMOUNT [+ | -]directory

Diagram
~¬¬ + ¬¬®
Êʬ¬ AUTOMOUNT ¬¬¦¬¬¬¬¬¬¬¦¬¬ directory ¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ - ¬¬¯
or
Êʬ¬ AUTOMOUNT ¬¬§¬¬ ADD directory ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ DEL directory ¬¬¯

AUTO_SCSI_MOUNT (Automatic SCSI tape

mounts)

Descriptive
AUTO SCSI MOUNT [NO | YES | n]

Diagram
Êʬ¬ AUTO SCSI MOUNT ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¼ ¼ ª¬¬ NO ¬¬¬«
¼ ¼ ª¬¬ YES ¬¬«
¬¬ n ¬¬¬¬¯

Hercules Emulator V3.12 Page 48

B (Set breakpoint)

Descriptive
B {addr | addr–addr}

Diagram
Êʬ¬ B ¬¬§¬¬¬¬¬ addr ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ addr-addr ¬¬¬¯

B+ (Set breakpoint)

Descriptive
B+ {addr | addr–addr}

Diagram
Êʬ¬ B+ ¬¬§¬¬¬¬¬ addr ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ addr-addr ¬¬¬¯

B- (Delete breakpoint)

Descriptive
B-

Diagram
Êʬ¬ B- ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

CACHE (Cache command)

Descriptive
CACHE

Diagram
Êʬ¬ CACHE ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

CCKD (CCKD command)

Descriptive
CCKD [HELP | STATS | OPTS |

Hercules Emulator V3.12 Page 49

 option=value [,option=value ... ]]

where option can be:

[COMP={-1 | n}]
[,COMPPARM={-1 | n}]
[,RA={2 | n}]
[,RAQ={4 | n}]
[,RAT={2 | n}]
[,WR={2 | n}]
[,GCINT={5 | n}]
[,GCPARM={0 | n}]
[,NOSTRESS={0 | 1}]
[,FREEPEND={-1 | n}]
[,FSYNC={0 | 1}]
[,TRACE={0 | n}]
[,LINUXNULL={0 | 1}]
[,GCSTART={0 | 1}]

Diagram
~¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬®
Êʬ¬ CCKD ¬¬§¬¬°¬¬« option=value ª¬¬¨¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬¬¬¬¬ HELP ¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬ STATS ¬¬¬¬¬¬¬¬¬«
¬¬¬¬¬¬¬¬¬¬ OPTS ¬¬¬¬¬¬¬¬¬¬¯

where option can be:

ª¬¬ COMP= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬ n ¬¬¯

ª¬¬ COMPPARM= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬ n ¬¬¯

ª¬¬ RA= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ RAQ= ¬¬§¬¬ 4 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ RAT= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ WR= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ GCINT= ¬¬§¬¬ 5 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

Hercules Emulator V3.12 Page 50

ª¬¬ GCPARM= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ n ¬¬¯
ª¬¬ NOSTRESS= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬ FREEPEND= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ n ¬¬¯
ª¬¬ FSYNC= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬ TRACE= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ n ¬¬¯
ª¬¬ LINUXNULL= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯
ª¬¬ GCSTART= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ 1 ¬¬¯

CD (Change directory)

Descriptive
CD path

Diagram
Êʬ¬ CD ¬¬ path ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

CF (Configure CPU online or offline)

Descriptive
CF [ON | OFF]

Diagram
Êʬ¬ CF ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ ON ¬¬¬«
¬¬ OFF ¬¬¯

CFALL (Configure all CPUs online or offline)

Descriptive
CFALL [ON | OFF]

Hercules Emulator V3.12 Page 51

Diagram
Êʬ¬ CFALL ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ ON ¬¬¬«
¬¬ OFF ¬¬¯

CLOCKS (Display TOD clock and CPU timer)

Descriptive
CLOCKS

Diagram
Êʬ¬ CLOCKS ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

CMDTGT (Specify command target)

Descriptive
CMDTGT {HERC | SCP | PSCP | ?}

Diagram
Êʬ¬ CMDTGT ¬¬§¬¬ HERC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ SCP ¬¬¬«
ª¬¬ PSCP ¬¬«
¬¬¬ ? ¬¬¬¬¯

CONKPALV (Specifiy TCP/IP keep alive

settings)

Descriptive
CONKPALV (idle,intv,count)

Diagram
Êʬ¬ CONKPALV ¬¬ (idle,intv,count) ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

CPU (Define target CPU for console displays

and commands)

Descriptive
CPU hh

Hercules Emulator V3.12 Page 52

Diagram
Êʬ¬ CPU ¬¬ hh ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

CR (Display or alter control registers)

Descriptive
CR [nn=xxxxxxxx | nn=xxxxxxxxxxxxxxxx]

Diagram
Êʬ¬ CR ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ nn=xxxxxxxx ¬¬¬¬¬¬«
¬¬ nn=xxxxxxxxxxxxxxxx ¬¬¯

CSCRIPT (Cancel a running script thread)

Descriptive
CSCRIPT

Diagram
Êʬ¬ CSCRIPT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

CTC (Enable / disable debug packet tracing)

Descriptive
CTC DEBUG {ON | OFF} [devnum | ALL]

Diagram
~¬¬¬ ALL ¬¬¬¬®
Êʬ¬ CTC ¬¬ DEBUG ¬¬§¬¬ ON ¬¬¬§¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬ÊÍ
¬¬ OFF ¬¬¯ ¬¬ devnum ¬¬¯

DEFINE (Rename device)

Descriptive
DEFINE olddevice newdevice

Diagram
Êʬ¬ DEFINE ¬¬ olddevice ¬¬ newdevice ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V3.12 Page 53

DEFSYM (Define symbol)

Descriptive
DEFSYM [symbol [value]]

Diagram
Êʬ¬ DEFSYM ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ symbol ¬¬§¬¬¬¬¬¬¬¬¬¬¬«
¬¬ value ¬¬¯

DETACH (Remove device)

Descriptive
DETACH device

Diagram
Êʬ¬ DETACH ¬¬ device ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

DEVINIT (Reinitialize device)

Descriptive
DEVINIT devnum [argument [argument ... ]]

Diagram
Êʬ¬ DEVINIT ¬¬ devnum ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ argument ¬¬¨¬¬¯

DEVLIST (List all devices)

Descriptive
DEVLIST

Diagram
Êʬ¬ DEVLIST ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V3.12 Page 54

DEVTMAX (Display or set maximum device
threads)

Descriptive
DEVTMAX [-1 | 0 | 1-n]

Diagram
Êʬ¬ DEVTMAX ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ -1 ¬¬¬«
ª¬¬¬ 0 ¬¬¬«
¬¬ 1-n ¬¬¯

DS (Display subchannel)

Descriptive
DS devnum

Diagram
Êʬ¬ DS ¬¬ devnum ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

ECPSVM (ECPS:VM commands)

Descriptive
ECPSVM [HELP | STATS | DISABLE | ENABLE | DEBUG |
NODEBUG | LEVEL [nn]]

or (with abbreviated arguments)

ECPSVM [H | ST | DIS | EN | DEBUG | NO | L [nn]]

Diagram
Êʬ¬ ECPSVM ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ HELP ¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ STATS ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ DISABLE ¬¬¬¬¬¬¬¬¬¬«
ª¬¬ ENABLE ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ DEBUG ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ NODEBUG ¬¬¬¬¬¬¬¬¬¬«
¬¬¬ LEVEL ¬¬§¬¬¬¬¬¬¬¬«
¬¬ nn ¬¬¯

or (with abbreviated arguments)

Hercules Emulator V3.12 Page 55

Êʬ¬ ECPSVM ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬ H ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬ ST ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬ DIS ¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬ EN ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ DEBUG ¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬ NO ¬¬¬¬¬¬¬¬¬¬¬«
¬¬¬¬¬ L ¬¬§¬¬¬¬¬¬¬¬«
¬¬ nn ¬¬¯

EXIT (Terminate the emulator)

Descriptive
EXIT

Diagram
Êʬ¬ EXIT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

EXT (Generate external interrupt)

Descriptive
EXT

Diagram
Êʬ¬ EXT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

F{+/-} (Mark frames usable or unusable)

Descriptive
F{+ | -} addr

Diagram
Êʬ¬ F ¬¬§¬¬ + ¬¬§¬¬ addr ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ - ¬¬¯

FPC (Display floating point control register)

Descriptive
FPC

Hercules Emulator V3.12 Page 56

Diagram

Êʬ¬ FPC ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

FPR (Display floating point registers)

Descriptive
FPR

Diagram
Êʬ¬ FPR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

G (Turn off instruction stepping and start

CPU)

Descriptive
G

Diagram
Êʬ¬ G ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

GPR (Display or alter general purpose

registers)

Descriptive
GPR [nn=xxxxxxxx | nn=xxxxxxxxxxxxxxxx]

Diagram
Êʬ¬ GPR ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ nn=xxxxxxxx ¬¬¬¬¬¬«
¬¬ nn=xxxxxxxxxxxxxxxx ¬¬¯

HAO (Hercules Automatic Operator)

Descriptive
HAO TGT target
HAO CMD command
HAO LIST [nn]
HAO DEL nn

Hercules Emulator V3.12 Page 57

HAO CLEAR

Diagram
Êʬ¬ HAO ¬¬ TGT ¬¬ target ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Êʬ¬ HAO ¬¬ CMD ¬¬ command ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Êʬ¬ HAO ¬¬ LIST ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯
Êʬ¬ HAO ¬¬ DEL ¬¬ nn ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
Êʬ¬ HAO ¬¬ CLEAR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

HELP (List all commands / command specific

help)

Descriptive
HELP [command]

Diagram
Êʬ¬ HELP ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ command ¬¬¯

HERC (Send Hercules command)

Descriptive
HERC [cmd]

Diagram
Êʬ¬ HERC ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ cmd ¬¬¯

HERCLOGO (Load new Hercules logo file)

Descriptive
HERCLOGO [filename]

Diagram
Êʬ¬ HERCLOGO ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ filename ¬¬¯

Hercules Emulator V3.12 Page 58

HST (History of commands)

Descriptive
HST [-1]
HST [-]n
HST {L | 0}

Diagram
~¬¬ -1 ¬¬®
Êʬ¬ HST ¬¬¨¬¬¬¬¬¬¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
Êʬ¬ HST ¬¬§¬¬¬¬¬¬¬§¬¬ n ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ - ¬¬¯
Êʬ¬ HST ¬¬§¬¬ L ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ O ¬¬¯

I (Generate I/O attention interrupt for device)

Descriptive
I device

Diagram
Êʬ¬ I ¬¬ device ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

IODELAY (Display or set I/O delay value)

Descriptive
IODELAY [usecs [NOWARN]]

Diagram
Êʬ¬ IODELAY ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ usecs ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ NOWARN ¬¬¯

IPENDING (Display pending interrupts)

Descriptive
IPENDING

Diagram
Êʬ¬ IPENDING ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V3.12 Page 59

IPL (IPL normal from device xxxx)

Descriptive
IPL {devnum | filename} [PARM string]

Diagram
Êʬ¬ IPL ¬¬§¬¬¬ devnum ¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ÊÍ
¬¬ filename ¬¬¯ ¬¬ PARM ¬¬ string ¬¬¯

IPLC (IPL clear from device xxxx)

Descriptive
IPLC {devnum | filename} [PARM string]

Diagram
Êʬ IPLC ¬¬§¬¬¬ devnum ¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ÊÍ
¬¬ filename ¬¬¯ ¬¬ PARM ¬¬ string ¬¬¯

K (Display CCKD internal trace)

Descriptive
K

Diagram
Êʬ¬ K ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

LDMOD (Load a module)

Descriptive
LDMOD module

Diagram
Êʬ¬ LDMOD ¬¬ module ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

LOADCORE (Load a core image file)

Descriptive
LOADCORE filename [address | 0]

Hercules Emulator V3.12 Page 60

Diagram
~¬¬¬¬¬ 0 ¬¬¬¬¬®
Êʬ¬ LOADCORE ¬¬ filename ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ address ¬¬¯

LOADPARM (Set IPL parameter)

Descriptive
LOADPARM [ipl parameter]

Diagram
Êʬ¬ LOADPARM ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ipl parameter ¬¬¯

LOADTEXT (Load a text deck file)

Descriptive
LOADTEXT filename [address]

Diagram
Êʬ¬ LOADTEXT ¬¬ filename ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ address ¬¬¯

LOG (Direct log output)

Descriptive
LOG newfile

Diagram
Êʬ¬ LOG ¬¬ newfile ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

LOGOPT (Change logging options)

Descriptive
LOGOPT [TIMESTAMP | NOTIMESTAMP | TIME | NOTIME]

Hercules Emulator V3.12 Page 61

Diagram
Êʬ¬ LOGOPT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ TIMESTAMP ¬¬¬«
ª¬¬ NOTIMESTAMP ¬¬«
ª¬¬¬¬¬ TIME ¬¬¬¬¬¬«
¬¬¬¬ NOTIME ¬¬¬¬¬¯

LPARNAME (Display or define LPAR name)

Descriptive
LPARNAME [lparname]

Diagram
Êʬ¬ LPARNAME ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ lparname ¬¬¯

LPARNUM (Display or set LPAR identification

number)

Descriptive
LPARNUM [xx]

Diagram
Êʬ¬ LPARNUM ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ xx ¬¬¯

LSDEP (List module dependencies)

Descriptive
LSDEP

Diagram
Êʬ¬ LSDEP ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

LSMOD (List dynamic modules)

Descriptive
LSMOD

Hercules Emulator V3.12 Page 62

Diagram
Êʬ¬ LSMOD ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

MAXRATES (Display maximum observed

MIPS/SIO rate or define new reporting
interval)

Descriptive
MAXRATES [interval]

Diagram
Êʬ¬ MAXRATES ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ interval ¬¬¯

MESSAGE (Display message on console like

VM)

Descriptive
MESSAGE parms

Diagram
Êʬ¬ MESSAGE ¬¬ parms ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

MOUNTED_TAPE_REINIT (Control tape

initialization)

Descriptive
MOUNTED TAPE REINIT [ALLOW | DISALLOW]

Diagram
Êʬ¬ MOUNTED TAPE REINIT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬ÊÍ
¼ ¼ ª¬¬¬ ALLOW ¬¬¬¬«
¬¬ DISALLOW ¬¬¯

MSG (Display message on console like VM)

Descriptive
MSG parms

Hercules Emulator V3.12 Page 63

Diagram
Êʬ¬ MSG ¬¬ parms ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

MSGHLD (Display or set timeout of held

messages)

Descriptive
MSGHLD [nnn | INFO | CLEAR]

Diagram
Êʬ¬ MSGHOLD ¬¬§¬¬¬ nnn ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ INFO ¬¬¬«
¬¬ CLEAR ¬¬¯

MSGNOH (Display message on console like

VM, but without header)

Descriptive
MSG parms

Diagram
Êʬ¬ MSGNOH ¬¬ parms ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

OSTAILOR (Specify intended operating

system)

Descriptive
OSTAILOR [z/OS | OS/390 | VM | VSE | LINUX |
OPENSOLARIS | QUIET | NULL]

Diagram
Êʬ¬ OSTAILOR ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ z/OS ¬¬¬¬¬«
ª¬¬¬¬¬ OS/390 ¬¬¬¬«
ª¬¬¬¬¬¬ VM ¬¬¬¬¬¬¬«
ª¬¬¬¬¬¬ VSE ¬¬¬¬¬¬«
ª¬¬¬¬¬ LINUX ¬¬¬¬¬«
ª¬¬ OPENSOLARIS ¬¬«
ª¬¬¬¬¬ QUIET ¬¬¬¬¬«
¬¬¬¬¬ NULL ¬¬¬¬¬¬¯

Hercules Emulator V3.12 Page 64

PANRATE (Display or set pamel refresh rate)

Descriptive
PANRATE [SLOW | FAST | rate]

Diagram
Êʬ¬ PANRATE ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ SLOW ¬¬«
ª¬¬ FAST ¬¬«
¬¬ rate ¬¬¯

PGMTRACE (Trace program interrupts)

Descriptive
PGMTRACE [[-]intcode]

Diagram
Êʬ¬ PGMTRACE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬¬§¬¬ intcode ¬¬¯
¬¬ - ¬¬¯

PR (Display prefix register)

Descriptive
PR

Diagram
Êʬ¬ PR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

PSCP (Send system control program priority

message)

Descriptive
PSCP [cmd]

Diagram
Êʬ¬ PSCP ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ cmd ¬¬¯

Hercules Emulator V3.12 Page 65

PSW (Display or alter program status word)

Descriptive
PSW [operand=value [operand=value ... ]]

where operand is one of the following:

SM=xx
PK=nn
CMWP=x
AS=[PRI | SEC | HOME]
CC=n
PM=x
IA=xxxxxxxx
AM=[24 | 31 | 64]

Diagram
Êʬ¬ PSW ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬« operand=value ª¬¬¨¬¬¯

where operand is one of the following:

ª¬¬ SM=xx ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ PK=nn ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ CMWP=x ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ AS= ¬¬§¬¬ PRI ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ SEC ¬¬¬«
¬¬ HOME ¬¬¯
ª¬¬ CC=n ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ PM=x ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ IA=xxxxxxxx ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ AM= ¬¬§¬¬ 24 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ 31 ¬¬«
¬¬ 64 ¬¬¯

Hercules Emulator V3.12 Page 66

PTT (Set / display pthread trace)

Descriptive
PTT [NOERROR | ERROR]
[NOCONTROL | CONTROL]
[NOPROG | PROG]
[NOINTER | INTER]
[NOSIE | SIE]
[NOSIGNAL | SIGNAL]
[NOIO | IO]
[NOTIMER | TIMER]
[NOTHREADS | THREADS]
[NOLOCK | LOCK]
[NOTOD | TOD]
[NOLOGGER | LOGGER]
[NOWRAP | WRAP]
[TO=nnn] [mmmmm]

Diagram

~¬¬ NOERROR ¬¬® ~¬¬ NOCONTROL ¬¬®

Êʬ¬ PTT ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬Ê
¬¬¬ ERROR ¬¬¬¯ ¬¬¬ CONTROL ¬¬¬¯
~¬¬ NOPROG ¬¬® ~¬¬ NOINTER ¬¬® ~¬¬ NOSIE ¬¬®
ʬ¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬Ê
¬¬¬ PROG ¬¬¬¯ ¬¬¬ INTER ¬¬¬¯ ¬¬¬ SIE ¬¬¬¯
~¬¬ NOSIGNAL ¬¬® ~¬¬ NOIO ¬¬® ~¬¬ NOTIMER ¬¬®
ʬ¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬Ê
¬¬¬ SIGNAL ¬¬¬¯ ¬¬¬ IO ¬¬¬¯ ¬¬¬ TIMER ¬¬¬¯
~¬¬ NOTHREADS ¬¬® ~¬¬¬ LOCK ¬¬¬® ~¬¬¬ TOD ¬¬¬®
ʬ¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬Ê
¬¬¬ THREADS ¬¬¬¯ ¬¬ NOLOCK ¬¬¯ ¬¬ NOTOD ¬¬¯
~¬¬ NOLOGGER ¬¬® ~¬¬¬ WRAP ¬¬¬®
ʬ¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬Ê
¬¬¬ LOGGER ¬¬¬¯ ¬¬ NOWRAP ¬¬¯ ¬¬ TO=nnn ¬¬¯

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ mmmmm ¬¬¯

Hercules Emulator V3.12 Page 67

PWD (Print working directory)

Descriptive
PWD

Diagram
Êʬ¬ PWD ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

QD (Query DASD)

Descriptive
QD [address]

Diagram
Êʬ¬ QD ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ address ¬¬¯

QUIET (Toggle automatic refresh of console

display data)

Descriptive
QUIET

Diagram
Êʬ¬ QUIET ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

QUIT (Terminate the emulator)

Descriptive
QUIT

Diagram
Êʬ¬ QUIT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

R (Display or alter real storage)

Descriptive
R {addr | addr.length | addr-addr | addr=value}

Hercules Emulator V3.12 Page 68

Diagram
Êʬ¬ R ¬¬§¬¬¬¬¬¬ addr ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ addr.length ¬¬«
ª¬¬¬ addr-addr ¬¬¬«
¬¬ addr=value ¬¬¬¯

RESTART (Generate restart interrupt)

Descriptive
RESTART

Diagram
Êʬ¬ RESTART ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

RESUME (Resume Hercules)

Descriptive
RESUME

Diagram
Êʬ¬ RESUME ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

RMMOD (Delete a module)

Descriptive
RMMOD module

Diagram
Êʬ¬ RMMOD ¬¬ module ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

S (Instruction stepping)

Descriptive
S [addr-addr | addr:addr | addr.length | 0]

Diagram
Êʬ¬ S ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ addr-addr ¬¬¬«
ª¬¬¬ addr:addr ¬¬¬«
ª¬¬ addr.length ¬¬«
¬¬¬¬¬¬¬ 0 ¬¬¬¬¬¬¬¯

Hercules Emulator V3.12 Page 69

S+ (Instruction stepping on)

Descriptive
S+ [addr-addr | addr:addr | addr.length | 0]

Diagram
Êʬ¬ S+ ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ addr-addr ¬¬¬«
ª¬¬¬ addr:addr ¬¬¬«
ª¬¬ addr.length ¬¬«
¬¬¬¬¬¬¬ 0 ¬¬¬¬¬¬¬¯

S- (Instruction stepping off)

Descriptive
S-

Diagram
Êʬ¬ S- ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

S? (Instruction stepping query)

Descriptive
S?

Diagram
Êʬ¬ S? ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

S{+/-} dev (Turn CCW stepping on or off)

Descriptive
S{+ | -} devaddr

Diagram
Êʬ¬ S ¬¬§¬¬ + ¬¬§¬¬ devaddr ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ - ¬¬¯

Hercules Emulator V3.12 Page 70

SAVECORE (Save a core image to a file)

Descriptive
SAVECORE filename [start | *] [end | *]

Diagram
~¬¬¬¬ * ¬¬¬¬®
Êʬ¬ SAVECORE ¬¬ filename ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ start ¬¬¯
~¬¬¬ * ¬¬¬®
ʬ¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ end ¬¬¯

SCLPROOT (Set or display SCLP base direc-

tory)

Descriptive
SCLPROOT [NONE | directory]

Diagram
Êʬ¬ SCLPROOT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬ NONE ¬¬¬¬¬«
¬¬ directory ¬¬¯

SCP (Send system control program com-

mand)

Descriptive
SCP [cmd]

Diagram
Êʬ¬ SCP ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ cmd ¬¬¯

SCRIPT (Run a sequence of commands

contained in a file)

Descriptive
SCRIPT filename [filename ... ]

Hercules Emulator V3.12 Page 71

Diagram
Êʬ¬ SCRIPT ¬¬ filename ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ filename ¬¬¨¬¬¯

SCSIMOUNT (Automatic SCSI tape mounts)

Descriptive
SCSIMOUNT [NO | YES | n]

Diagram
Êʬ¬ SCSIMOUNT ¬¬§¬¬ NO ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ YES ¬¬«
¬¬ n ¬¬¬¬¯

SF+ (Create a new shadow file)

Descriptive
SF+ {device | *}

Diagram
Êʬ¬ SF+ ¬¬§¬¬ device ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬¬ * ¬¬¬¬¬¯

SF- (Remove a shadow file)

Descriptive
SF- {device | *} [MERGE | NOMERGE | FORCE]

Diagram
~¬¬¬ MERGE ¬¬¬®
Êʬ¬ SF- ¬¬§¬¬ device ¬¬§¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬¬ * ¬¬¬¬¬¯ ª¬¬ NOMERGE ¬¬«
¬¬¬ FORCE ¬¬¬¯

SFC (Compress a shadow file)

Descriptive
SFC {device | *}

Hercules Emulator V3.12 Page 72

Diagram
Êʬ¬ SFC ¬¬§¬¬ device ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬¬ * ¬¬¬¬¬¯

SFD (Display shadow file statistics)

Descriptive
SFD {device | *}

Diagram
Êʬ¬ SFD ¬¬§¬¬ device ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬¬ * ¬¬¬¬¬¯

SFK (Perform a chkdsk on the active shadow

file)

Descriptive
SFK {device | *} [n]

Diagram
Êʬ¬ SFK ¬¬§¬¬ device ¬¬§¬¬§¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬¬ * ¬¬¬¬¬¯ ¬¬ n ¬¬¯

SH (Shell command)

Descriptive
SH [STARTGUI] command [arg [arg ... ]]

Diagram
Êʬ¬ SH ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ STARTGUI ¬¬¯
ʬ¬ command ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ arg ¬¬¨¬¬¯

SHRD (SHRD Command)

Descriptive
SHRD TRACE[=n]

Hercules Emulator V3.12 Page 73

Diagram
Êʬ¬ SHRD ¬¬ TRACE ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ =n ¬¬¯

SIZEOF (Display size of structures)

Descriptive
SIZEOF

Diagram
Êʬ¬ SIZEOF ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

SSD (Signal shutdown)

Descriptive
SSD

Diagram
Êʬ¬ SSD ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

START (Start CPU or printer device)

Descriptive
START [devicenum]

Diagram
Êʬ¬ START ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ devicenum ¬¬¯

STARTALL (Start all CPUs)

Descriptive
STARTALL

Diagram
Êʬ¬ STARTALL ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V3.12 Page 74

STOP (Stop CPU or printer device)

Descriptive
STOP [devicenum]

Diagram
Êʬ¬ STOP ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ devicenum ¬¬¯

STOPALL (Stop all CPUs)

Descriptive
STOPALL

Diagram
Êʬ¬ STOPALL ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

STORE (Store CPU status)

Descriptive
STORE

Diagram
Êʬ¬ STORE ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

SUSPEND (Suspend Hercules)

Descriptive
SUSPEND

Diagram
Êʬ¬ SUSPEND ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

SYNCIO (Display SYNCIO device statistics)

Descriptive
SYNCIO

Hercules Emulator V3.12 Page 75

Diagram
Êʬ¬ SYNCIO ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

SYSCLEAR (Issue SYSTEM CLEAR RESET

manual operation)

Descriptive
SYSCLEAR

Diagram
Êʬ¬ SYSCLEAR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

SYSRESET (Issue SYSTEM RESET manual

operation)

Descriptive
SYSRESET

Diagram
Êʬ¬ SYSRESET ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

T (Instruction trace)

Descriptive
T [addr-addr | addr:addr | addr.length | 0]

Diagram
Êʬ¬ T ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ addr-addr ¬¬¬«
ª¬¬¬ addr:addr ¬¬¬«
ª¬¬ addr.length ¬¬«
¬¬¬¬¬¬¬ 0 ¬¬¬¬¬¬¬¯

T+ (Instruction trace on)

Descriptive
T+ [addr-addr | addr:addr | addr.length | 0]

Hercules Emulator V3.12 Page 76

Diagram
Êʬ¬ T+ ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ addr-addr ¬¬¬«
ª¬¬¬ addr:addr ¬¬¬«
ª¬¬ addr.length ¬¬«
¬¬¬¬¬¬¬ 0 ¬¬¬¬¬¬¬¯

T- (Instruction trace off)

Descriptive
T-

Diagram
Êʬ¬ T- ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

T? (Instruction trace query)

Descriptive
T?

Diagram
Êʬ¬ T? ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

T{+/-} CKD (Turn CKD_KEY tracing on or off)

Descriptive
T{+ | -}CKD

Diagram
Êʬ¬ T ¬¬§¬¬ + ¬¬§¬¬ CKD ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ - ¬¬¯

T{+/-} dev (Turn CCW tracing on or off)

Descriptive
T{+ | -}devaddr

Diagram
Êʬ¬ T ¬¬§¬¬ + ¬¬§¬¬ devaddr ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ - ¬¬¯

Hercules Emulator V3.12 Page 77

TIMERINT (Display or set timers update
interval)

Descriptive
TIMERINT [interval]

Diagram
Êʬ¬ TIMERINT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ interval ¬¬¯

TLB (Display TLB tables)

Descriptive
TLB

Diagram
Êʬ¬ TLB ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

TODDRAG (Display or set TOD clock drag

factor)

Descriptive
TODDRAG [factor]

Diagram
Êʬ¬ TODDRAG ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ factor ¬¬¯

TRACEOPT (Instruction trace display options)

Descriptive
TRACEOPT [TRADITIONAL | REGSFIRST | NOREGS]

Diagram
Êʬ¬ TRACEOPT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ TRADITIONAL ¬¬«
ª¬¬¬ REGSFIRST ¬¬¬«
¬¬¬¬ NOREGS ¬¬¬¬¬¯

Hercules Emulator V3.12 Page 78

TT32 (Control / query CTCI-WIN functionality)

Descriptive
TT32 {DEBUG | NODEBUG | STATS devnum}

Diagram
Êʬ¬ TT32 ¬¬§¬¬¬¬¬¬¬ DEBUG ¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬ NODEBUG ¬¬¬¬¬¬«
¬¬ STATS ¬¬ devnum ¬¬¯

U (Disassemble storage)

Descriptive
U address [.length]

Diagram
Êʬ¬ U ¬¬ address ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ .length ¬¬¯

UPTIME (Display Hercules Emulator uptime)

Descriptive
UPTIME

Diagram
Êʬ¬ UPTIME ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

V (Display or alter virtual storage)

Descriptive
V [P | S | H] {addr | addr.length | addr-addr |
addr=value}

Diagram
Êʬ¬ V ¬¬§¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬ addr ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ P ¬¬« ª¬¬ addr.length ¬¬«
ª¬¬ S ¬¬« ª¬¬¬ addr-addr ¬¬¬«
¬¬ H ¬¬¯ ¬¬ addr=value ¬¬¬¯

Hercules Emulator V3.12 Page 79

VERSION (Display version information)

Descriptive
VERSION

Diagram
Êʬ¬ VERSION ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V3.12 Page 80

7. Hercules Utilities

DASD Utilities

Utility Name Function

CCKDCDSK CCKD DASD file integrity verification,

recovery and repair utility

CCKDCOMP CCKD DASD file compression utility

CCKDDIAG CCKD DASD file diagnostics utility

CCKDSWAP CCKD DASD file swap-endian program

CKD2CCKD Copy CKD DASD file to CCKD DASD file

CCKD2CKD Copy CCKD DASD file to CKD DASD file

DASDCAT Display PDS datasets and members

DASDCONV DASD image file conversion program

DASDCOPY Copy DASD file to another DASD file

DASDINIT DASD image file creation

DASDISUP Fix XCTL tables in SVCLIB

DASDLOAD DASD loader program

DASDLS List datasets on a volume

DASDPDSU PDS unload utility

DASDSEQ Display sequential datasets

Table 7: DASD Utilities

Hercules Emulator V3.12 Page 81

TAPE Utilities

Utility Name Function

HETGET Extract files from an AWS or HET tape file

HETINIT Initialize an AWS or HET tape file

HETMAP Show information about a HET or AWS tape

file

HETUPD Update and/or copy an AWS or HET tape file

TAPECOPY Copy a SCSI tape to or from an AWSTAPE

disk file

TAPEMAP Show information about an AWS tape file

TAPESPLT Split an AWS tape file

Table 8: TAPE Utilities

Miscellanious Utilities

Utility Name Function

DMAP2HRC P/390 DEVMAP conversion program

Table 9: Miscellanious Utilities

Hercules Emulator V3.12 Page 82

CCKDCDSK (CCKD DASD file integrity
verification, recovery and repair utility)

Descriptive
CCKDCDSK [-option [-option ... ]] filename

Diagram
Êʬ¬ CCKDCDSK ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ filename ¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯

Options

-v (display version info and exit)

-f (force check even if OPENED bit is on)
-ro (open file read-only, no repairs)
-level (level of checking, 1-4)

CCKDCOMP (CCKD DASD file compression

utility)

Descriptive
CCKDCOMP [-option [-option ... ]] filename

Diagram
Êʬ¬ CCKDCOMP ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ filename ¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯

Options
-v (display version info and exit)

-f (force check even if OPENED bit is on)

-level (level of checking, 1-4

CCKDDIAG (CCKD DASD file diagnostics

utility)

Descriptive
CCKDDIAG [-option [-option ... ]] filename

Hercules Emulator V3.12 Page 83

Diagram
Êʬ¬ CCKDDIAG ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ filename ¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯

Options

-v (display version info and exit)

-d (display DEVHDR)
-c (display CDEVHDR)
-1 (display L1TAB [l = numeric one])
-g (enable debug output)

CKD track related options:

-a cc hh (display absolute CCHH data)
-r tt (display relative TT data)
-2 (display L2TAB related to –a or –r)
-t (display track data)
-x (hex display track / key data)
-o oo ll (hex display data at offset oo of
length ll)

CCKDSWAP (CCKD DASD file swap-endian

program)

Descriptive
CCKDSWAP filename

Diagram
Êʬ¬ CCKDSWAP ¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

DASDCAT (Display PDS datasets and

members)

Descriptive
DASDCAT -i image [SF=shadowfile] pdsname/spec:flags

Hercules Emulator V3.12 Page 84

Diagram
Êʬ¬ DASDCAT ¬¬¬¬¬ -i image ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬Ê
¬¬ SF=shadowfile ¬¬¯
ʬ¬ pdsname/spec:flags ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

DASDCONV (DASD image file conversion

program)

Descriptive
DASDCONV [-option [-option ... ]] {infile | -} outfile

Diagram

Êʬ¬ DASDCONV ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯

ʬ¬§¬¬ infile ¬¬§¬¬ outfile ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬¬¬ - ¬¬¬¬¬¯

Options

-r (replace output file)

-lfs (create single file even if > 2GB)
-q (quiet option, suppress progress
messages)

DASDCOPY (Copy DASD file to another DASD

file)

Descriptive
DASDCOPY [-option [-option ... ]] infile
[SF=shadowfile] outfile

Diagram
Êʬ¬ DASDCOPY ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯
ʬ¬ infile ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ outfile ¬¬¬¬¬¬¬¬ÊÍ
¬¬ SF=shadowfile ¬¬¯

Hercules Emulator V3.12 Page 85

Options

-v (display version info and help text)

-h (display help text and quit)
-q (quiet mode, suppress status)
-r (replace output file)
-z (compress using zlib (default))
-bz2 (compress using bzip2)
-0 (do not compress output [0 = zero])
-blks n (size of output FBA file)
-cyls n (size of output CKD file)
-a (create output CKD file with alternate
cylinders)
-lfs (create single file even if > 2GB)
-o type (output file type: CKD, CCKD, FBA,
CFBA)

DASDINIT (DASD image file creation)

Descriptive
DASDINIT [-option [-option ... ]] filename
devtype[-model] volser [size]

Diagram
Êʬ¬ DASDINIT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯
ʬ¬ filename ¬¬ devtype ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ volser ¬¬¬¬Ê
¬¬ -model ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ -size ¬¬¯

Options

-v (display version info and help text)

-z (build compressed DASD using zlib)
-bz2 (build compressed DASD usng bzip2)
-0 (build image file with no compression
[0 = zero])
-lfs (create single file even if > 2GB)

Hercules Emulator V3.12 Page 86

-a (include alternate cylinders)
-r (build raw DASD image file)
-linux (null track images will look like linux
DASDFMT’ed images)

DASDISUP (Fix XCTL tables in SVCLIB)

Descriptive
DASDISUP outfile [SF=shadowfile]

Diagram
Êʬ¬ DASDISUP ¬¬ outfile ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬ÊÍ
¬¬ SF=shadowfile ¬¬¯

DASDLOAD (DASD loader program)

Descriptive
DASDLOAD [-option [-option ... ]]
ctlfile outfile msglevel

Diagram
Êʬ¬ DASDLOAD ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯
ʬ¬ ctlfile ¬¬ outfile ¬¬ msglevel ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Options

-z (compress using zlib)

-bz2 (compress using bzip2)
-0 (do not compress output [0 = zero])
-lfs (create single file even if > 2GB)
-a (include alternate cylinders)

Control File
The control file is an ASCII text file consisting of a volume
statement followed by one dataset statement for each
dataset to be created.

Hercules Emulator V3.12 Page 87

Volume Statement

Descriptive
volser devtype[-model] [cyls [ipltext]]

Diagram
Êʬ¬ volser ¬¬ devtype ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ -model ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ cyls ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ ipltext ¬¬¯

Dataset Statement

Descriptive
dsname method units pri sec dir dsorg recfm lrecl ...
... blksize keylen

Diagram
Êʬ¬ dsname ¬¬ method ¬¬ units ¬¬ pri ¬¬ sec ¬¬ dir ¬¬Ê
ʬ¬ dsorg ¬¬ recfm ¬¬ lrecl ¬¬ blksize ¬¬ keylen ¬¬¬¬ÊÍ

DASDLS (List datasets on a volume)

Descriptive
DASDLS [-option [-option ... ]]
filename [SF=shadowfile]

Diagram
Êʬ¬ DASDLS ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯
ʬ¬ filename ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ SF=shadowfile ¬¬¯

Options
-info (Show Format 1 DSCB information)
-caldt (Display dates as YYYYMMMDD)
-refdt (Display last-referenced date)

-expdt (Display expiry date)

Hercules Emulator V3.12 Page 88

-hdr (Display column headers)

-dsnl[=n] (Reserve space for dataset names

up to n characters)
-yroffs[=n] (Add the year offset n to dates
before displaying them)

DASDPDSU (PDS unload utility)

Descriptive
DASDPDSU filename [SF=shadowfile] pdsname [ASCII]

Diagram
Êʬ¬ DASDPDSU ¬¬ filename ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬Ê
¬¬ SF=shadowfile ¬¬¯
ʬ¬ pdsname ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ASCII ¬¬¯

DASDSEQ (Display sequential datasets)

Descriptive
DASDSEQ [-DEBUG] [-EXPERT] [-ASCII] image
[SF=shadowfile] filespec

Diagram
Êʬ¬ DASDSEQ ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬Ê
¬¬ -DEBUG ¬¬¯ ¬¬ -EXPERT ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ image ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬Ê
¬¬ -ASCII ¬¬¯ ¬¬ SF=shadowfile ¬¬¯
ʬ¬ filespec ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

HETGET (Extract files from an AWS or HET

tape file)

Descriptive
HETGET tapefile outfile filenum

Diagram
Êʬ¬ HETGET ¬¬ tapefile ¬¬ outfile ¬¬ filenum ¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V3.12 Page 89

HETINIT (Initialize an AWS or HET tape file)

Descriptive
HETINIT [-option [-option ... ]] filename
[volser] [owner]

Diagram
Êʬ¬ HETINIT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯

ʬ¬ filename ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬ÊÍ

¬¬ volser ¬¬¯ ¬¬ owner ¬¬¯

Options

-d (disable compression, create AWSTAPE file)

-h (display usage summary)
-i (create IEHINITT formatted tape, default)
-n (create NL (non labeled) tape

HETMAP (Show information about a HET or

AWS tape file)

Descriptive
HETMAP [-option [-option ... ]] filename

Diagram
Êʬ¬ HETMAP ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯

ʬ¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Options

-a (print all label and file information,

default)
-d (print only dataset information)
-f (print only file information)
-h (display usage summary)
-l (print only label information)
-t (print TAPEMAP-compatible format output)

Hercules Emulator V3.12 Page 90

HETUPD (Update and/or copy an AWS or HET
tape file)

Descriptive
HETUPD [-option [-option ... ]] source [destination]

Diagram
Êʬ¬ HETUPD ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
¬¬°¬¬ -option ¬¬¨¬¬¯

ʬ¬ source ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬ destination ¬¬¯

Options
-1...9 (compression level (1=fast, 9=best))

-b (use bzlib compression)

-c n (set chunk size to n)
-d (decompress source tape file)
-h (display usage summary)
-r (rechunk tape file)
-s (strict AWSTAPE specification)
-v (verbose information)
-z (use zlib compression)

TAPECOPY (Copy a SCSI tape to or from an

AWSTAPE disk file)

Descriptive
TAPECOPY [tapedrive] [awsfile]
or
TAPECOPY [awsfile] [tapedrive]

Diagram
Êʬ¬ TAPECOPY ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ÊÍ
¬¬ tapedrive ¬¬¯ ¬¬ awsfile ¬¬¯
or
Êʬ¬ TAPECOPY ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ÊÍ
¬¬ awsfile ¬¬¯ ¬¬ tapedrive ¬¬¯

Hercules Emulator V3.12 Page 91

TAPEMAP (Show information about an AWS
tape file)

Descriptive
TAPEMAP filename

Diagram
Êʬ¬ TAPEMAP ¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

TAPESPLT (Split an AWS tape file)

Descriptive
TAPESPLT infile outfile count

Diagram
Êʬ¬ TAPESPLT ¬¬ infile ¬¬ outfile ¬¬ count ¬¬¬¬¬¬¬¬¬ÊÍ

DMAP2HRC (P/390 DEVMAP conversion

program)

Descriptive
DMAP2HRC filename

Diagram
Êʬ¬ DMAP2HRC ¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V3.12 Page 92

8. Shared Device Support

Descriptive
loc devnum devtype host[:port] [:rem devnum] [COMP=n]

Diagram
~¬¬ :3990 ¬¬®
Êʬ¬ loc devnum ¬¬ devtype ¬¬ host ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬Ê
¬¬ :port ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ :rem devnum ¬¬¯ ¬¬ COMP=n ¬¬¯

Hercules Emulator V3.12 Page 93

9. Hercules 3270 Logo

Set Buffer Address

Set Buffer Address to row x and column y.
@SBA x,y

Set Field
Set Field to highlight ("H") and/or protected ("P").
@SF {H | P | HP }

New Line
Force a skip to a new line.
@NL

Align
Specify text alignment.
@ALIGN {NONE | LEFT | RIGHT | CENTER }

Variables
$(VERSION)
The Hercules version.
$(HOSTNAME)
The host name, on which Hercules is running.
$(HOSTOS)
The host operating system.
$(HOSTOSREL)
The release of the host operating system.
$(HOSTOSVER)
The version of the host operating system.
$(HOSTARCH)
The host architecture.
$(HOSTNUMCPUS)
The number of host CPUs. UP (Uniprocessor for one CPU), or
MP=n (Multiprocessor for more than one CPUs).

Hercules Emulator V3.12 Page 94

$(LPARNAME)
The LPAR name specified in the configuration file.
$(CSS)
The logical channel subsystem set or channel set for the
terminal.
$(SUBCHAN)
The subchannel number for the terminal.
$(CCUU), $(ccuu), $(CUU), $(cuu)
Various forms of the device number of the terminal.

Hercules Emulator V3.12 Page 95

10. Starting the Hercules Emulator

Starting Hercules in Native Mode

Descriptive
HERCULES [-f configfile] [-d] [-b logofile] [-p dyndir]
[[-l dynmod] ... ] [>logfile]

Diagram
Êʬ¬ HERCULES ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬Ê
¬¬ -f configfile ¬¬¯ ¬¬ -d ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ -b logofile ¬¬¯ ¬¬ -p dyndir ¬¬¯
ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬ÊÍ
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­ ¬¬ >logfile ¬¬¯
¬¬°¬¬ -l dynmod ¬¬¨¬¬¯

Starting Hercules with the Windows GUI

Descriptive
HERCGUI [-f configfile]

Diagram
Êʬ¬ HERCGUI ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ -f configfile ¬¬¯

Starting Hercules with the Hercules Studio

Descriptive
HerculesStudio [-f configfile] [-r rcfile]

Diagram
Êʬ¬ HerculesStudio ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ -f configfile ¬¬¯

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ -r rcfile ¬¬¯

Hercules Emulator V3.12 Page 96

11. Using the keyboard

Normal cursor handling

The normal cursor handling is available on all platforms
(Windows and Unix).

Key Action

Erases the contents of the command

input area. If the command input
Esc
area is already empty, switches to
semi-graphical New Panel.

Deletes the character at the cursor

Del
position.

Backspace Erases the previous character.

Toggles between insert mode and

Insert
overlay mode.

Attempts to complete the partial file

name at the cursor position in the
Tab command input area. If more than
one possible file exists, a list of
matching file names is displayed.

Moves the cursor to the start of the

input in the command input area. If
Home
the command input area is empty,
scrolls the message area to the top.

Moves the cursor to the start of the

input in the command input area. If
End the command input area is empty,
scrolls the message area to the
bottom.

Scrolls the message area up one

Page Up
screen.

Scrolls the message area down one

Page Down
screen.

Recalls the previous command into

Up arrow
the input area.

Hercules Emulator V3.12 Page 97

Key Action

Recalls the next command into the

Down arrow
input area.

Moves cursor to the next character of

Right arrow
the input area.

Moves cursor to the previous

Left arrow
character of the input area.

Scrolls the message area up one

Ctrl + Up arrow
line.

Scrolls the message area down one

Ctrl + Down arrow
line.

Ctrl + Home Scrolls the message area to the top.

Scrolls the message area to the

Ctrl + End
bottom.

Table 10: Normal cursor handling

Extended cursor handling

The following additional keyboard functions are effective when
the Hercules Extended Cursor Handling feature is activated at
compile time. At present, this feature is activated on the
Windows platform only.

Key Action

Alt + Up arrow Moves cursor up one row.

Alt + Down arrow Moves cursor down one row.

Alt + Right arrow Moves cursor right one column.

Alt + Left arrow Moves cursor left one column.

If the cursor is outside the command

input area, moves cursor to the start of
Tab the input in the command input area.
Otherwise behaves like as described in
the previous table.

Hercules Emulator V3.12 Page 98

Key Action

If the cursor is outside the command

input area, moves cursor to the start of
Home the input in the command input area.
Otherwise behaves like as described in
the previous table.

If the cursor is outside the command

input area, moves cursor to the end of
End the input in the command input area.
Otherwise behaves like as described in
the previous table.

Table 11: Extended cursor handling

Hercules Emulator V3.12 Page 99

Appendix A: Supported DASD Device
Types
The symbol “[*]” in the size column means that any size can
be specified, else the size defaults to the first listed model.

CKD Devices

Devicetype-Model Cylinders Alternate

Cylinders

IBM 2311 [*]

IBM 2311-1 200 2

IBM 2314 [*]

IBM 2314 200 3

IBM 3330 [*]

IBM 3330-1 404 7

IBM 3330-2 808 7

IBM 3330-11 808 7

IBM 3340 [*]

IBM 3340-1 348 1

IBM 3340-35 348 1

IBM 3340-2 696 2

IBM 3340-70 696 2

IBM 3350 [*]

IBM 3350-1 555 5

IBM 3375 [*]

IBM 3375-1 959 1

IBM 3380 [*]

IBM 3380-1 885 1

Hercules Emulator V3.12 Page 100

Devicetype-Model Cylinders Alternate
Cylinders

IBM 3380-A 885 1

IBM 3380-B 885 1

IBM 3380-D 885 1

IBM 3380-J 885 1

IBM 3380-2 1770 2

IBM 3380-E 1770 2

IBM 3380-3 2665 3

IBM 3380-K 2665 3

EMC 3380 K+ 3339 3

EMC 3380 K++ 3993 3

IBM 3390 [*] 1

IBM 3390-1 1113 1

IBM 3390-2 2226 2

IBM 3390-3 3339 1

IBM 3390-9 10017 3

IBM 3390-27 32760 3

IBM 3390-54 65520 3

IBM 9345 [*]

IBM 9345-1 1440 0

IBM 9345-2 2156 0

Table 12: Supported CKD DASD Devices

Hercules Emulator V3.12 Page 101

FBA Devices

Devicetype-Model Blocks

IBM 3310 [*]

IBM 3310-1 125664

IBM 3370 [*]

IBM 3370-A1 558000

IBM 3370-B1 558000

IBM 3370-A2 712752

IBM 3370-B2 712752

IBM 9313 [*]

IBM 9313-1 246240

IBM 9332 [*]

IBM 9332-200 360036

IBM 9332-400 360036

IBM 9336-600 554800

IBM 9335 [*]

IBM 9335-1 804714

IBM 9336 [*]

IBM 9336-10 920115

IBM 9336-20 1672881

IBM 9336-25 1672881

IBM 0671-08 513072

IBM 0671 574560

IBM 0671-04 624456

Table 13: Supported FBA DASD Devices

Hercules Emulator V3.12 Page 102

Appendix B. Syntax
This book uses two kinds of describing the syntax of configu-
ration statements, console commands and utilities.These are
syntax descriptions and syntax diagrams.

B1. Reading Syntax Descriptions

Keywords are denoted with

upper case letters. Obey the
KEYWORDS spelling. In the actual state-
ments or commands they
can be coded in upper case
or lower case letters.

All user defined values are

denoted with lower case
variables italic letters. In the actual
statements or commands
they can be coded in upper
case or lower case letters.

Signifies that all, or some

portion, of the code ele-
ments between the braces
{ } are required elements. Note
that the braces are not part
of the statements and must
be not coded.

Signifies that all, or some

portion of the code ele-
ments between the square
brackets can optionally
[ ] appear but are not required
elements. Note that the
square brackets are not part
of the statements and must
be not coded.

The OR symbol signifies

that you may use only one
of the code elements or
| values from the possible
choices. Note that the OR
symbol is not part of the
statements and must be not
coded.

Hercules Emulator V3.12 Page 103

 Signifies that there can be
more than one value in a
xxx ,… comma delimited list. Note
that the dots are not part of
the statements and must be
not coded.

Signifies that there can be

more than one value in a
xxx … blank space delimited list.
Note that the dots are not
part of the statements and
must be not coded.

Table 14: Reading Syntax Descriptions

B2. Reading Syntax Diagrams

This symbol indicates

Êʬ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ the beginning of a
statement.

This symbol indicates

¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ the end of a state-
ment.

This symbol indicates

that the statement is
¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
continued on the next
line.

This symbol indicates

that the statement is a
ʬ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬
continuation from the
previous line.

A required element
(keyword or variable)
¬¬¬¬¬¬ required element ¬¬¬¬¬¬¬¬
appears on the main
path.

An optional element
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬ (keyword or variable)
¬¬¬ optional choice ¬¬¬¯ appears below the
main path.

Hercules Emulator V3.12 Page 104

 A required element
(keyword or variable)
¬¬¬§¬¬ required choice 1 ¬¬§¬¬¬¬ with selection. Only
ª¬¬ required choice 2 ¬¬«
¬¬ required choice 3 ¬¬¯ one of the available
options may be spe-
cified.

Optional elements
(keyword or variable)
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬ with selection are
ª¬¬ optional choice 2 ¬¬« shown below the main
¬¬ optional choice 3 ¬¬¯ line. Only one of the
available options may
be specified.

A keyword with
options. Only one of
the available options
¬¬¬ PARM= ¬¬§¬¬ option_1 ¬¬§¬¬¬¬ may be specified. The
ª¬¬ option 2 ¬¬«
¬¬ option 3 ¬¬¯ underscored option is
the default if the whole
keyword statement is
not coded.

Optional elements
(keyword or variable)
with selection are
shown below the main
line. If one element is
~¬¬ default choice 1 ¬¬¬® the default, it appears
¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬ above the main line.
ª¬¬ optional choice 1 ¬¬« Only one of the
¬¬ optional choice 2 ¬¬¯ available options may
be specified. If none of
these elements is
explicitly specified, the
default above the main
line is taken.

This is an optional,
repeatable element.
¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬
­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­ Specifying several
¬¬°¬ optional choice ¬¨¬¬¯ elements is allowed.
A character within the
arrow path means that
¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ repeated items have
­ ~¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬® ­ to be separated by
¬¬°¬ optional choice ¬¨¬¬¯ that character. Other-
wise the items are
separated by a blank.

Hercules Emulator V3.12 Page 105

 This is a required,
repeatable element.
Specifying several
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬® elements is allowed. A
¬¬¬¬°¬¬¬ required element ¬¬¨¬¬¬ character within the
arrow path means that
~¬¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬¬¬® repeated items have
¬¬¬¬°¬¬¬ required element ¬¬¨¬¬¬ to be separated by
that character. Other-
wise the items are
separated by a blank.

Reference to a syntax
¬¬¬¬¬¬¬¬¬¬« SEGMENT ª¬¬¬¬¬¬¬¬¬¬¬ segment, which is
described seperately.

This symbol indicates

a syntax segment
ª¬¬ SEGMENT= ¬§¬¬ value 1 ¬¬§¬¬«
¬¬ value 2 ¬¬¯ which is referenced
from the main syntax
diagram.

Keywords are denoted

with upper case
letters. Obey the
spelling. Lower case
letters are optional
and can be omitted
KEYWORDS
(for example DISable).
In the actual state-
ments or commands
they can be coded in
upper case or lower
case letters.

All user defined values

are denoted with lower
case italic letters.
They represent user
supplied names or
variables
values. In the actual
statements or com-
mands they can be
coded in upper case
or lower case letters.

Table 15: Reading Syntax Diagrams

Hercules Emulator V3.12 Page 106

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

Hercules Emulator V3.12

PPPP

Reference Summary

11.1.1.1.1.1

HERS031200-00
Version 3 Release 12
Hercules Emulator

Page 107