0% found this document useful (0 votes)

63 views152 pages

Hercules Reference Summary

This document provides reference information about the Hercules emulator, including its configuration file format and system parameters, device definitions, console commands, utilities, and other operational aspects. It describes the emulator's architecture, supported devices, and how to configure, start, and use the emulator.

Uploaded by

mano bsb

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

63 views152 pages

Hercules Reference Summary

Uploaded by

mano bsb

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 152

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

Hercules – Reference Summary

Version 4 Release 00

Draft - August 30, 2014

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

Hercules – Reference Summary

Version 4 Release 00

First Edition, August 30, 2014

HERS040000-00

Hercules Emulator V4.00 Page 2

Contents
Contents ................................................................................3
Tables .................................................................................... 4
1. Preface ......................................................................... 5
2. Hercules Configuration File ........................................... 6
3. System Parameter Descriptions .................................. 13
4. Device Definition Descriptions ..................................... 40
5. Hercules Console Commands ..................................... 55
6. Console Command Descriptions ................................. 65
7. Hercules Utilities ....................................................... 123
8. Shared Device Support ............................................. 136
9. Hercules 3270 Logo .................................................. 137
10. Starting the Hercules Emulator ............................. 139
11. Using the keyboard ............................................... 141
Appendix A: Supported DASD Device Types ..................... 145
Appendix B. Syntax............................................................ 148

Hercules Emulator V4.00 Page 3

Tables
Table 1: Hercules System Parameters ................................. 10
Table 2: Hercules Device Definitions .................................... 12
Table 3: Process Priority Conversions.................................. 39
Table 4: Thread Priority Conversions ................................... 39
Table 5: Default CU Types ................................................... 52
Table 6: Hercules Console Commands ................................ 64
Table 7: DASD Utilities....................................................... 123
Table 8: TAPE Utilities ....................................................... 124
Table 9: Miscellanious Utilities ........................................... 124
Table 10: Normal cursor handling ...................................... 142
Table 11: Extended cursor handling ................................... 143
Table 12: Extended cursor handling ................................... 143
Table 13: Supported CKD DASD Devices .......................... 146
Table 14: Supported FBA DASD Devices .......................... 147
Table 15: Reading Syntax Descriptions.............................. 149
Table 16: Reading Syntax Diagrams .................................. 151

Hercules Emulator V4.00 Page 4

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 Revision Notice

Hercules Release: Version 4 Release 00 Modification 0
Publication Number: HERS040000
SoftCopy Name: HerculesReferenceSummary
Revision Number: HERS040000-00
Date: August 30, 2014

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 V4.00 Page 5

2. Hercules Configuration File

2.1 System Parameters

System Parameter Description

# Comment line

* Comment line

ARCHLVL Set architecture level

ARCHMODE Initial architecture mode (alias

for ARCHLVL system para-
meter)

ASN_AND_LX_REUSE ESAME ASN and LX REUSE

(ALRF) feature (deprecated, use
ARCHLVL instead)

AUTO_SCSI_MOUNT Automatic SCSI tape mounts

(deprecated, use
SCSIMOUNT instead)

AUTOINIT Automatic creation of empty

tape files

AUTOMOUNT Tape automount root directory

CAPPING CPU capping feature

CCKD Compressed CKD DASD

options

CMDLEVEL Set command group

CMDLVL Alias for CMDLEVEL

CMDSEP Command line seperator

CNSLPORT Console port

CODEPAGE Codepage conversion table

Hercules Emulator V4.00 Page 6

System Parameter Description

CONKPALV Console and telnet clients

keep-alive option

CP_UPDT User character conversion

table

CPUIDFMT Set format BASIC / 0 / 1

STIDP generation

CPUMODEL CPU model number

CPUPRIO CPU thread process priority

CPUSERIAL CPU serial number

CPUVERID CPU version code

DEFSTORE Define main and expanded

storage

DEFSYM Define a symbol

DEVPRIO Device threads process

priority

DEVTMAX Maximum number of device

threads

DIAG8CMD DIAGNOSE 8 cmd option

ECPSVM ECPS:VM support status (VM)

ENGINES Processor engines type

HAO Hercules Automatic Operator

HERCLOGO Hercules logo file

HERCPRIO Hercules process priority

HTTP HTTP server configuration

HTTPPORT HTTP server port (depre-

cated, use HTTP instead)

Hercules Emulator V4.00 Page 7

System Parameter Description

HTTPROOT HTTP server root directory

(deprecated, use HTTP in-
stead)

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 Logging options

LPARNAME LPAR name returned by DIAG

x'204'

LPARNUM LPAR identification number

MAINSIZE Main storage size

MANUFACTURER STSI manufacturer code

MAXCPU Maximum number of CPUs

MAXRATES MIPS/SIO rate reporting

interval

MEMLOCK Lock Hercules memory

MODEL STSI model code

MODPATH Dynamic load module path

MOUNTED_TAPE_REINIT Control tape initialization

MSGHLD Timeout value of held

messages

MSGLEVEL Message display output

Hercules Emulator V4.00 Page 8

System Parameter Description

MSGLVL Message display output (alias

for MSGLEVEL)

NUMCPU Number of emulated CPUs

NUMVEC Number of vector facilities

OSTAILOR Tailor trace information for

specific operating system

PANRATE Console refresh rate

PANTITLE Console panel title

PGMPRDOS LPP license setting

PLANT STSI plant code

QUITMOUT Quit timeout value

REXX REXX interpreter settings

SCLPROOT SCLP base directory

SCPECHO Echo to console and history of

SCP replies

SCPIMPLY Pass non-Hercules com-

mands to the SCP

SCSIMOUNT Automatic SCSI tape mounts

SHCMDOPT Shell command option

SHOWDVOL1 Enable showing of DASD

volsers in device list

SHRDPORT Shared device server port

SRVPRIO Server threads priority

SYMPTOM Alias for TRACEOPT

SYSEPOCH Base date for TOD clock

TIMERINT Internal timer update interval

Hercules Emulator V4.00 Page 9

System Parameter Description

TODDRAG TOD clock drag factor

TODPRIO Timer thread process priority

TRACEOPT Instruction trace display option

TZOFFSET TOD clock offset from GMT

XPNDSIZE Expanded storage size

YROFFSET TOD clock offset from actual

date

Table 1: Hercules System Parameters

Hercules Emulator V4.00 Page 10

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)

Hercules Emulator V4.00 Page 11

Device Type Device Emulated by

((QETH)) OSA Express IP “QETH”

Layer 2 support (OSA/QDIO
only. Supported only Ethernet Adapter)
for Linux guests. TUN/TAP driver
TAP adapter must
be bridged to a local
LAN

3310, 3370, FBA direct access Disk file

9332, 9335, storage devices
9336, 0671

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 V4.00 Page 12

3. System Parameter Descriptions

# (Comment line)

Descriptive
# [anything]

Diagram
ÊÊ¬¬ # ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ anything ¬¬¯

* (Comment line)

Descriptive
* [anything]

Diagram
ÊÊ¬¬ * ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ anything ¬¬¯

ARCHLVL (Set architecture level)

Descriptive
ARCHLVL {S/370 | ESA/390 | ESAME | z/ARCH}
or
ARCHLVL {ENABLE | DISABLE} facility
[S/370 | ESA/390 | z/ARCH]
or
ARCHLVL {ENABLE | DISABLE} bitno
[S/370 | ESA/390 | z/ARCH]
or
ARCHLVL QUERY [facility | ALL]

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

Hercules Emulator V4.00 Page 13

ÊÊ¬¬ ARCHLVL ¬¬§¬¬ ENABLE ¬¬¬§¬¬ facility ¬¬¬¬¬¬¬¬¬¬¬¬Ê

¬¬ DISABLE ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ S/370 ¬¬¬¬«
ª¬¬ ESA/390 ¬¬«
¬¬ z/ARCH ¬¬¬¯
or
ÊÊ¬¬ ARCHLVL ¬¬§¬¬ ENABLE ¬¬¬§¬¬ bitno ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ DISABLE ¬¬¯
Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ S/370 ¬¬¬¬«
ª¬¬ ESA/390 ¬¬«
¬¬ z/ARCH ¬¬¬¯
or
~¬¬¬¬ ALL ¬¬¬¬¬®
ÊÊ¬¬ ARCHLVL ¬¬ QUERY ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ facility ¬¬¯

ARCHMODE (Initial architecture mode)

ARCHMODE is an alias for the ARCHLVL system parameter.

Please see ARCHLVL for details.

ASN_AND_LX_REUSE / ALRF (ESAME ASN

and LX REUSE feature)

The ASN_AND_LX_REUSE (ALRF) system parameter has

been deprecated.
Use “ARCHLVL ENABLE | DISABLE ASN_LX_REUSE”
instead.

AUTO_SCSI_MOUNT (Automatic SCSI tape

mounts)

The AUTO_SCSI_MOUNT system parameter has been

deprecated. Use “SCSIMOUNT” instead.

Hercules Emulator V4.00 Page 14

AUTOMOUNT (Tape automount root directory)

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

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

AUTOINIT (Automatic creation of empty tape

files)

Descriptive
AUTOINIT {ON | OFF}

Diagram
ÊÊ¬¬ AUTOINIT ¬¬§¬¬ ON ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ OFF ¬¬¯

CAPPING (CPU capping feature)

Descriptive
CAPPING {mips | OFF | 0}

Diagram

ÊÊ¬¬ CAPPING ¬¬§¬¬ mips ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

ª¬¬ OFF ¬¬¬«
¬¬¬ 0 ¬¬¬¬¯

CCKD (Compressed CKD DASD options)

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

Hercules Emulator V4.00 Page 15

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}]
[,TRACE={0 | n}]
[,LINUXNULL={0 | 1}]
[,GCSTART={0 | 1}]

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

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

CODEPAGE (Codepage conversion table)

Descriptive
CODEPAGE {DEFAULT | codepage | USER |
MAINT cmd [operands]}

Diagram
ÊÊ¬¬ CODEPAGE ¬¬§¬¬ DEFAULT ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ÊÍ
ª¬¬ codepage ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ USER ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ MAINT ¬¬ cmd ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ operands ¬¬¯

CONKPALV (Console and telnet clients keep-

alive option)

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

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

Hercules Emulator V4.00 Page 18

CP_UPDT (User character conversion table)

Descriptive
CP UPDT command [operands]

where command can be:

ALTER {EBCDIC | ASCII | G2H | H2G}

(pos,val[,pos,val]...)
DISPLAY {EBCDIC | ASCII | G2H | H2G }
EXPORT {EBCDIC | ASCII | G2H | H2G } filename
IMPORT {EBCDIC | ASCII | G2H | H2G } filename
REFERENCE [codepage]
RESET
TEST

Diagram
ÊÊ¬¬ CP UPDT ¬¬« command ª¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

where command can be:

~¬¬¬¬¬ , ¬¬¬¬¬®
ª¬¬ ALTER ¬¬§¬¬ EBCDIC ¬¬§¬ ( ¬¬°¬¬ pos,val ¬¬¨¬¬ ) ¬¬«
ª¬¬ ASCII ¬¬¬«
ª¬¬ G2H ¬¬¬¬¬«
¬¬ H2G ¬¬¬¬¬¯

ª¬¬ DISPLAY ¬¬§¬¬ EBCDIC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ ASCII ¬¬¬«
ª¬¬ G2H ¬¬¬¬¬«
¬¬ H2G ¬¬¬¬¬¯

ª¬¬ EXPORT ¬¬§¬¬ EBCDIC ¬¬§¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ ASCII ¬¬¬«
ª¬¬ G2H ¬¬¬¬¬«
¬¬ H2G ¬¬¬¬¬¯

ª¬¬ IMPORT ¬¬§¬¬ EBCDIC ¬¬§¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ ASCII ¬¬¬«
ª¬¬ G2H ¬¬¬¬¬«
¬¬ H2G ¬¬¬¬¬¯

ª¬¬ REFERENCE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ codepage ¬¬¯

ª¬¬ RESET ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

Hercules Emulator V4.00 Page 19

ª¬¬ TEST ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

CPUIDFMT (Set format BASIC / 0 / 1 STIDP ge-

neration)

Descriptive
CPUIDFMT {BASIC | 0 | 1}

Diagram
ÊÊ¬¬ CPUIDFMT ¬¬§¬¬ BASIC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬ 0 ¬¬¬¬«
¬¬¬¬ 1 ¬¬¬¬¯

CPUMODEL (CPU model number)

Descriptive
CPUMODEL {0586 | model}

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 ¬¬¯

Hercules Emulator V4.00 Page 20

CPUVERID (CPU version code)

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

Diagram
For z/ARCH and ESAME:
ÊÊ¬¬ CPUVERID ¬¬ 00 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
or
For S/370 and ESA/390:
ÊÊ¬¬ CPUVERID ¬¬§¬¬¬¬ FD ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ verid ¬¬¯

DEFSTORE (Define main and expanded

storage)

Descriptive

DEFSTORE {[MAIN msize[B | K | M | G | T | P | E]

[UNLOCK | LOCK]]
[{XSTOR | EXPANDED} xsize[M | G | T]
[UNLOCK | LOCK]]}

Diagram
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
ÊÊ¬¬ DEFSTORE ¬¬°¬¬« storagetype ª¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

~¬¬ M ¬¬® ~¬¬ UNLOCK ¬¬®

ª¬¬ MAIN ¬¬ msize ¬¬¦¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬«
ª¬¬ B ¬¬« ¬¬¬ LOCK ¬¬¬¯
ª¬¬ K ¬¬«
ª¬¬ G ¬¬«
ª¬¬ T ¬¬«
ª¬¬ P ¬¬«
¬¬ E ¬¬¯

~¬¬ M ¬¬®
ª¬¬§¬¬ XSTOR ¬¬¬¬¬§¬¬ xsize ¬¬¦¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ EXPANDED ¬¬¯ ª¬¬ G ¬¬«
¬¬ T ¬¬¯
~¬¬ UNLOCK ¬¬®
Ê¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬¬ LOCK ¬¬¬¯

Hercules Emulator V4.00 Page 21

DEFSYM (Define a 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 option)

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

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

Hercules Emulator V4.00 Page 22

ECPSVM (ECPS:VM support status (VM))

Descriptive
ECPSVM {Help | STats | DISable | ENable | DEBUG |
NOdebug | Level [nn]}

Diagram
ÊÊ¬¬ ECPSVM ¬¬§¬¬¬ Help ¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ STats ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ DISable ¬¬¬¬¬¬¬¬¬¬«
ª¬¬ ENable ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ DEBUG ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ NOdebug ¬¬¬¬¬¬¬¬¬¬«
¬¬¬ Level ¬¬§¬¬¬¬¬¬¬¬«
¬¬ nn ¬¬¯

ENGINES (Processor engines type)

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

Diagram
~¬¬¬¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬¬¬¬¬®

ÊÊ¬¬ ENGINES ¬¬°¬¬§¬¬¬¬¬¬¬¬¬§¬¬§¬¬ CP ¬¬§¬¬¨¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn* ¬¬¯ ª¬¬ IL ¬¬«
ª¬¬ AP ¬¬«
¬¬ IP ¬¬¯

HAO (Hercules Automatic Operator)

Descriptive
HAO command [operands]

where command can be:

TGT target
CMD consolecmd
DEL nn
CLEAR
LIST [nn]

Hercules Emulator V4.00 Page 23

Diagram
ÊÊ¬¬ HAO ¬¬« command ª¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

where command can be:

ª¬¬ TGT ¬¬ target ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ CMD ¬¬ consolecmd ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ DEL ¬¬ nn ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ CLEAR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ LIST ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ nn ¬¬¯

HERCLOGO (Hercules logo file)

Descriptive
HERCLOGO filename

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

HERCPRIO (Hercules process priority)

Descriptive
HERCPRIO {0 | nn}

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

HTTP (HTTP server configuration)

Descriptive
HTTP {START | STOP | ROOT path |
PORT port {NOAUTH | AUTH userid password}}

Hercules Emulator V4.00 Page 24

Diagram
ÊÊ¬¬ HTTP ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
Ê¬¬§¬¬ START ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ÊÍ
ª¬¬ STOP ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ ROOT ¬¬ path ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ PORT ¬¬ port ¬¬§¬¬¬¬¬¬¬¬¬ NOAUTH ¬¬¬¬¬¬¬¬¬«
¬¬ AUTH userid password ¬¬¯

HTTPPORT (HTTP server port)

The HTTPPORT system parameter has been deprecated.

Use “HTTP PORT” instead.

HTTPROOT (HTTP server root directory)

The HTTPROOT system parameter has been deprecated.

Use “HTTP ROOT” instead.

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 V4.00 Page 25

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 (Logging options)

Descriptive
LOGOPT {TIMESTAMP | TIME | NOTIMESTAMP | NOTIME}

Hercules Emulator V4.00 Page 26

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 {BASIC | 1 | n | nn}

Diagram
ÊÊ¬¬ LPARNUM ¬¬§¬¬ BASIC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ 1 ¬¬¬¬¬«
ª¬¬¬ n ¬¬¬¬¬«
¬¬¬ nn ¬¬¬¬¯

MAINSIZE (Main storage size)

Descriptive
MAINSIZE size[B | K | M | G | T | P | E]
[UNLOCK | LOCK]

Diagram
~¬¬ M ¬¬® ~¬¬ UNLOCK ¬¬®
ÊÊ¬¬ MAINSIZE ¬¬ size ¬¬¦¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬ÊÍ
ª¬¬ B ¬¬« ¬¬¬ LOCK ¬¬¬¯
ª¬¬ K ¬¬«
ª¬¬ G ¬¬«
ª¬¬ T ¬¬«
ª¬¬ P ¬¬«
¬¬ E ¬¬¯

Hercules Emulator V4.00 Page 27

MANUFACTURER (STSI manufacturer code)

Descriptive
MANUFACTURER {HRC | name}

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

MAXCPU (Maximum number of CPUs)

Descriptive
MAXCPU {1 | nn}

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

MAXRATES (MIPS/SIO rate reporting interval)

Descriptive
MAXRATES {interval | MIDNIGHT}

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

MEMLOCK (Lock Hercules memory)

Descriptive
MEMLOCK {ON | OFF}

Diagram
ÊÊ¬¬ MEMLOCK ¬¬§¬¬ ON ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ OFF ¬¬¯

Hercules Emulator V4.00 Page 28

MODEL (STSI model code)

Descriptive
MODEL {EMULATOR | hdwmod | = | *}
[EMULATOR | capmod | = | *
[prmmod | = | *
[tmpmod | = | *]]]

Diagram
ÊÊ¬¬ MODEL ¬¬§¬¬ EMULATOR ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬ hdwmod ¬¬¬«
ª¬¬¬¬¬ = ¬¬¬¬¬¬«
¬¬¬¬¬ * ¬¬¬¬¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ÊÍ
ª¬¬ EMULATOR ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ capmod ¬¬¬« ª¬¬ prmmod ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬¬ = ¬¬¬¬¬¬« ª¬¬¬¬ = ¬¬¬¬¬« ª¬¬ tmpmod ¬¬«
¬¬¬¬¬ * ¬¬¬¬¬¬¯ ¬¬¬¬ * ¬¬¬¬¬¯ ª¬¬¬¬ = ¬¬¬¬¬«
¬¬¬¬ * ¬¬¬¬¬¯

MODPATH (Dynamic load module path)

Descriptive
MODPATH path

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

MOUNTED_TAPE_REINIT (Control tape initiali-

zation)

Descriptive
MOUNTED TAPE REINIT {ENABLE | ALLOW |
DISABLE | DISALLOW}

Diagram
ÊÊ¬¬ MOUNTED TAPE REINIT ¬¬§¬¬ ENABLE ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ ALLOW ¬¬¬¬¬«
ª¬¬ DISABLE ¬¬¬«
¬¬ DISALLOW ¬¬¯

Hercules Emulator V4.00 Page 29

MSGHLD (Timeout of held messages)

Descriptive
MSGHLD {nnn | INFO | CLEAR}

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

MSGLEVEL (Message display output)

Descriptive
MSGLEVEL {option option ...}

where option can be:

ON | OFF | TEXT | TIME | NODEBUG |

[+ | -] DEBUG |
[+ | -] TAPE |
[+ | -] DASD |
[+ | -] COMM |
[+ | -] UR |
[+ | -] SCSI |
[+ | -] CTCA |
[+ | -] GRAF |
[+ | -] THREAD |
[+ | -] CHANNEL |
[+ | -] VERBOSE |
[+ | -] TERSE

Diagram
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
ÊÊ¬¬ MSGLEVEL ¬¬°¬¬« option ª¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

where option can be:

Hercules Emulator V4.00 Page 30

ª¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ ON ¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬¬¬¬ OFF ¬¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬¬¬¬ TEXT ¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬¬¬¬ TIME ¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬¬¬¬ NODEBUG ¬¬«
ª¬¬¬¬¬¬¬§¬¬§¬¬ DEBUG ¬¬¬¬«
ª¬¬ + ¬¬« ª¬¬ TAPE ¬¬¬¬¬«
¬¬ - ¬¬¯ ª¬¬ DASD ¬¬¬¬¬«
ª¬¬ COMM ¬¬¬¬¬«
ª¬¬ UR ¬¬¬¬¬¬¬«
ª¬¬ SCSI ¬¬¬¬¬«
ª¬¬ CTCA ¬¬¬¬¬«
ª¬¬ GRAF ¬¬¬¬¬«
ª¬¬ THREAD ¬¬¬«
ª¬¬ CHANNEL ¬¬«
ª¬¬ VERBOSE ¬¬«
¬¬ TERSE ¬¬¬¬¯

MSGLVL (Message display output)

MSGLVL is an alias for MSGLEVEL. See MSGLEVEL for
details.

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 (Tailor trace information for

specific operating system)

Descriptive
OSTAILOR {[+ | -] z/OS | OS/390 | VM | VSE | LINUX |
OPENSOLARIS | QUIET | NULL}

Hercules Emulator V4.00 Page 31

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

PANRATE (Console refresh rate)

Descriptive
PANRATE {SLOW | FAST | rate}

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

PANTITLE (Console window title)

Descriptive
PANTITLE {text | "text text text" | ""}

Diagram
ÊÊ¬¬ PANTITLE ¬¬§¬¬¬¬¬¬¬¬ text ¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ "text text text" ¬¬«
¬¬¬¬¬¬¬¬¬ "" ¬¬¬¬¬¬¬¬¬¯

PGMPRDOS (LPP license setting)

Descriptive
PGMPRDOS {RESTRICTED | LICENSED}

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

PLANT (STSI plant code)

Descriptive
PLANT {ZZ | name}

Hercules Emulator V4.00 Page 32

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

QUITMOUT (Quit timeout value)

Descriptive
QUITMOUT nn

Diagram
ÊÊ¬¬ QUITMOUT ¬¬ nn ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

REXX (REXX interpreter settings)

Descriptive
REXX option

where option can be:

ENABLE | START [REGINA | OOREXX]

DISABLE | STOP
PATHS | REXXPATHS {path [delimiter path ...] | RESET}
SYSPATH {ON | OFF | RESET}
EXTENSIONS | SUFFIXES {suffix
[delimiter suffix ...] | RESET}
RESOLVER {ON | OFF | RESET}
MSGLEVEL {0 | 1 | RESET}
MSGPREFIX {messageprefix | OFF | RESET}
ERRPREFIX {errorprefix | OFF | RESET}
MODE {COMMAND | SUBROUTINE}

Diagram
ÊÊ¬¬ REXX ¬¬« option ª¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

where option can be:

ª¬¬§¬¬ ENABLE ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ START ¬¬¬¯ ª¬¬ REGINA ¬¬«
¬¬ OOREXX ¬¬¯

Hercules Emulator V4.00 Page 33

ª¬¬§¬¬ DISABLE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬¬ STOP ¬¬¬¬¯

~¬¬ delimiter ¬¬®

ª¬¬§¬¬¬¬ PATHS ¬¬¬¬§¬¬§¬¬°¬¬¬ path ¬¬¬¬¬¬¨¬¬§¬¬¬¬¬¬¬¬¬«
¬¬ REXXPATHS ¬¬¯ ¬¬¬¬¬¬ RESET ¬¬¬¬¬¬¬¬¯

ª¬¬ SYSPATH ¬¬§¬¬¬ ON ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬ OFF ¬¬¬«
¬¬ RESET ¬¬¯

~¬¬ delimiter ¬¬®

ª¬¬§¬¬ EXTENSIONS ¬¬§¬¬§¬¬°¬¬¬ suffix ¬¬¬¬¨¬¬§¬¬¬¬¬¬¬¬«
¬¬¬ SUFFIXES ¬¬¬¯ ¬¬¬¬¬¬¬ RESET ¬¬¬¬¬¬¬¯

ª¬¬ RESOLVER ¬¬§¬¬¬ ON ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬ OFF ¬¬¬«
¬¬ RESET ¬¬¯

ª¬¬ MSGLEVEL ¬¬§¬¬¬¬ 0 ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬¬ 1 ¬¬¬¬«
¬¬ RESET ¬¬¯

ª¬¬ MSGPREFIX ¬¬§¬¬ messageprefix ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬¬¬¬¬ OFF ¬¬¬¬¬¬¬«
¬¬¬¬¬¬ RESET ¬¬¬¬¬¬¯

ª¬¬ ERRPREFIX ¬¬§¬¬ errorprefix ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬¬¬¬ OFF ¬¬¬¬¬¬«
¬¬¬¬¬ RESET ¬¬¬¬¬¯

ª¬¬ MODE ¬¬§¬¬¬ COMMAND ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ SUBROUTINE ¬¬¯

SCLPROOT (SCLP base directory)

Descriptive
SCLPROOT {NONE | directory}

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

Hercules Emulator V4.00 Page 34

SCPECHO (Echo to console and history of
SCP replies)

Descriptive
SCPECHO {OFF | ON}

Diagram
ÊÊ¬¬ SCPECHO ¬¬§¬¬ OFF ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ON ¬¬¬¯

SCPIMPLY (Pass non-Hercules commands to

the SCP)

Descriptive
SCPIMPLY {OFF | ON}

Diagram
ÊÊ¬¬ SCPIMPLY ¬¬§¬¬ OFF ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ON ¬¬¬¯

SCSIMOUNT (Automatic SCSI tape mounts)

Descriptive
SCSIMOUNT {NO | YES | n}

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

SHCMDOPT (Shell command option)

Descriptive
SHCMDOPT {DISABLE | ENABLE [DIAG8 | NODIAG8]}

Diagram
ÊÊ¬¬ SHCMDOPT ¬¬§¬¬ DISABLE ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ENABLE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ DIAG8 ¬¬¬«
¬¬ NODIAG8 ¬¬¯

Hercules Emulator V4.00 Page 35

SHOWDVOL1 (Enable showing of DASD vol-
sers in device list)

Descriptive
SHOWDVOL1 {NO | YES | ONLY}

Diagram
ÊÊ¬¬ SHOWDVOL1 ¬¬§¬¬ NO ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ YES ¬¬¬«
¬¬ ONLY ¬¬¯

SHRDPORT (Shared device server port)

Descriptive
SHRDPORT [3990 | port | START | STOP]

Diagram
ÊÊ¬¬ SHRDPORT ¬¬§¬¬ 3990 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ port ¬¬¬«
ª¬¬ START ¬¬«
¬¬ STOP ¬¬¬¯

SRVPRIO (Server threads priority)

Descriptive
SRVPRIO {4 | nn}

Diagram
ÊÊ¬¬ SRVPRIO ¬¬§¬¬ 4 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

SYSEPOCH (Base date for TOD clock)

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

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

Hercules Emulator V4.00 Page 36

SYMPTOM (Instruction trace display option)

SYMPTOM is an alias for the TRACEOPT system parameter.

Please see TRACEOPT for details.

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 V4.00 Page 37

TZOFFSET (TOD clock offset from GMT)

Descriptive
TZOFFSET {0000 | +hhmm | -hhmm}

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

XPNDSIZE (Expanded storage size)

Descriptive
XPNDSIZE size[M | G | T] [UNLOCK | LOCK]

Diagram
~¬¬ M ¬¬® ~¬¬ UNLOCK ¬¬®
ÊÊ¬¬ XPNDSIZE ¬¬ size ¬¬¦¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬ÊÍ
ª¬¬ G ¬¬« ¬¬¬ LOCK ¬¬¬¯
¬¬ T ¬¬¯

YROFFSET (TOD clock offset from actual

date)

Descriptive
YROFFSET {+years | -years}

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

Hercules Emulator V4.00 Page 38

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 V4.00 Page 39

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 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

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 V4.00 Page 40

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]

Hercules Emulator V4.00 Page 41

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

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

Line Printer Devices

Descriptive
devaddr devtype filename [CRLF] [NOCLEAR] [RAWCC]
[FCBCHECK | NOFCBCHECK] [OPTBROWSE | OPTPRINT]
[LPI={6 | lpi] [INDEX={0 | idx]
[LPP={66 | lpp}]
[FCB={1:1,07:2,13:3,...,49:10,55:11,61:12 |
l1:c1,l2:c2,l3:c3,...,l11:c11,l12:c12}]
or
devaddr devtype [host:]port SOCKDEV

Diagram
ÊÊ¬¬ devaddr ¬¬ devtype ¬¬ filename ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬Ê
¬¬ CLRF ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ NOCLEAR ¬¬¯ ¬¬ RAWCC ¬¬¯

~¬¬¬ FCBCHECK ¬¬¬®

Ê¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ NOFCBCHECK ¬¬¯

~¬¬ OPTBROWSE ¬¬¬® ~¬¬¬ LPI=6 ¬¬¬¬¬®

Ê¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ OPTPRINT ¬¬¬¬¯ ¬¬¬ LPI=lpi ¬¬¬¯

~¬¬ INDEX=0 ¬¬¬¬® ~¬¬¬ LPP=66 ¬¬¬¬®

Ê¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ INDEX=idx ¬¬¯ ¬¬¬ LPP=lpp ¬¬¬¯

~¬¬ FCB=1:1,7:2,13:3, ... ,55:11,61:12 ¬¬¬¬¬®

Ê¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬ÊÍ
¬¬ FCB=l1:c1,l2:c2, ... ,l11:c11,l12:c12 ¬¬¯

Hercules Emulator V4.00 Page 42

ÊÊ¬¬ 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

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

AWSTAPE virtual files

Descriptive
devaddr devtype {awsfile | *} [arguments]

where arguments can be:

[MAXSIZE={n[K | M | G | T] | 0} |
MAXSIZEK={n | 0} |
MAXSIZEM={n | 0}]
[EOTMARGIN=n[K | M | G | T]]
[READONLY={0 | 1}]
[RO | NORING | RW | RING]

Hercules Emulator V4.00 Page 43

[DEONIRQ={0 | 1}]
[NOAUTOMOUNT]

Diagram
ÊÊ¬¬ devaddr ¬¬ devtype ¬¬§¬¬ awsfile ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬¬¬¬ * ¬¬¬¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬« arguments ª¬¬¨¬¬¯

where arguments can be:

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

¬¬ n ¬¬§¬¬¬¬¬¬¬«
ª¬¬ K ¬¬«
ª¬¬ M ¬¬«
ª¬¬ G ¬¬«
¬¬ T ¬¬¯
ª¬¬ MAXSIZEK= ¬¬§¬¬ 0 ¬¬§¬¬§¬¬¬¬¬¬¬¯
¬¬ n ¬¬¯
¬¬ MAXSIZEM= ¬¬§¬¬ 0 ¬¬§¬¬¯
¬¬ n ¬¬¯

ª¬¬ EOTMARGIN= ¬¬ n ¬¬§¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ K ¬¬«
ª¬¬ M ¬¬«
ª¬¬ G ¬¬«
¬¬ T ¬¬¯

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

¬¬ 1 ¬¬¯

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

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

¬¬ 1 ¬¬¯

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

HET virtual files

Descriptive
devaddr devtype {hetfile | *} [arguments]

where arguments can be:

Hercules Emulator V4.00 Page 44

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

Diagram
ÊÊ¬¬ devaddr ¬¬ devtype ¬¬§¬¬ hetfile ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬¬¬¬ * ¬¬¬¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬« arguments ª¬¬¨¬¬¯

where arguments can be:

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

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

¬¬ 1 ¬¬¯

ª¬¬ IDRC= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ 1 ¬¬¯

ª¬¬ METHOD= ¬¬§¬¬ 1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ 2 ¬¬¯

ª¬¬ LEVEL= ¬¬§¬¬ 4 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ n ¬¬¯

ª¬¬ CHUNKSIZE= ¬¬§¬¬ 65535 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ nnnnn ¬¬¯

Hercules Emulator V4.00 Page 45

ª¬¬§¬¬ MAXSIZE= ¬¬¬§¬¬ 0 ¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ n ¬¬§¬¬¬¬¬¬¬«
ª¬¬ K ¬¬«
ª¬¬ M ¬¬«
ª¬¬ G ¬¬«
¬¬ T ¬¬¯
ª¬¬ MAXSIZEK= ¬¬§¬¬ 0 ¬¬§¬¬§¬¬¬¬¬¬¬¯
¬¬ n ¬¬¯
¬¬ MAXSIZEM= ¬¬§¬¬ 0 ¬¬§¬¬¯
¬¬ n ¬¬¯

[NOAUTOMOUNT]

Diagram
ÊÊ¬¬ devaddr ¬¬ devtype ¬¬§¬¬ fakefile ¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬¬¬¬ * ¬¬¬¬¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬« arguments ª¬¬¨¬¬¯

where arguments can be:

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

ª¬¬ EOTMARGIN= ¬¬ n ¬¬§¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ K ¬¬«
ª¬¬ M ¬¬«
ª¬¬ G ¬¬«
¬¬ T ¬¬¯

ª¬¬ READONLY= ¬¬§¬¬ 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]

Hercules Emulator V4.00 Page 47

[{-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 ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -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 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V4.00 Page 48

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]
[{-o | --oat} file]
[{-m | --mac} mac]
[-d | --debug]
[guestip]

Diagram
ÊÊ¬¬¬ devaddr ¬¬¬ LCS ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬ -n ¬¬¬¬§¬¬ name ¬¬¯
¬¬ --dev ¬¬¯

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -o ¬¬¬¬¬§¬¬¬ file ¬¬¬¯
¬¬¬ --oat ¬¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬ -m ¬¬¬¬§¬¬ mac ¬¬¯
¬¬ --mac ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -d ¬¬¬¬¬«
¬¬ --debug ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ guestip ¬¬¯

Hercules Emulator V4.00 Page 49

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

Diagram
ÊÊ¬¬ devaddr ¬¬ PTP ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -n ¬¬¬§¬¬ name ¬¬¯
¬¬ --dev ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -m ¬¬¬§¬¬ mac ¬¬¯
¬¬ --mac ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -t ¬¬¬§¬¬ mtu ¬¬¯
¬¬ --mtu ¬¬¯

Hercules Emulator V4.00 Page 50

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬ -k ¬¬¬¬§¬¬§¬¬ kbuff ¬¬«
¬¬ --kbuff ¬¬¯ ¬¬ 1024 ¬¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -4 ¬¬¬¬« ª¬¬¬¬ -6 ¬¬¬¬¬«
¬¬ --inet ¬¬¯ ¬¬ --inet6 ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬ -d ¬¬¬¬¬«
¬¬ --debug ¬¬¯

Ê¬¬ guest1 ¬¬ host1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ÊÍ

¬¬¬¬ guest2 ¬¬ host2 ¬¬¬¬¬¯

FBA DASD Devices

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

Diagram
ÊÊ¬¬ devaddr ¬¬ devtype ¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

~¬¬¬¬¬ 0 ¬¬¬¬®
Ê¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ origin ¬¬¯ ¬¬ numblks ¬¬¯

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

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

~¬¬ :3990 ¬¬®

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

Hercules Emulator V4.00 Page 51

4.1 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 ¬¬¯

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

~¬¬ :3990 ¬¬®

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

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

Hercules Emulator V4.00 Page 52

Communication Lines

Communication Line - BSC

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 ¬¬¬¬¬¬¯

Ê¬¬ RHOST= ¬¬§¬¬ hostname ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

¬¬ ipaddress ¬¬¯

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

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

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ RTO= ¬¬§¬¬ 3000 ¬¬«
ª¬¬¬ 0 ¬¬¬¬«
ª¬¬ -1 ¬¬¬¬«
¬¬ nnn ¬¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ PTO= ¬¬§¬¬ 3000 ¬¬«
ª¬¬¬ 0 ¬¬¬¬«
ª¬¬ -1 ¬¬¬¬«
¬¬ nnn ¬¬¬¯

Hercules Emulator V4.00 Page 53

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ ETO= ¬¬§¬¬ 10000 ¬¬«
ª¬¬¬¬ 0 ¬¬¬¬«
ª¬¬¬ -1 ¬¬¬¬«
¬¬¬ nnn ¬¬¬¯

Communication Line - TTY

Descriptive
devaddr devtype LPORT=port DIAL=IN TTY=1

Diagram
ÊÊ¬¬ devaddr ¬¬ devtype ¬¬ LPORT=port ¬¬ DIAL=IN ¬¬¬¬¬Ê
Ê¬¬ TTY=1 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V4.00 Page 54

5. Hercules Console Commands

Command Description

!message SCP priority message

# Silent comment

$locate Display and verify Hercules control

blocks

$test Custom test command

$zapcmd Enable or disable system parameters

and console commands

* Loud comment

.reply SCP command

? List all commands / command specific

help (alias for help)

aea Display AEA (absolute-effective-

address) tables

aia Display AIA (absolute-instruction-

addres) fields

ar Display access registers

archlvl Set architecture level

archmode Set architecture mode (alias for

ARCHLVL command)

attach Configure device

auto_scsi_mount Automatic SCSI tape mounts

(deprecated, use SCSIMOUNT
instead)

autoinit Display or set automatic creation of

empty tape files

Hercules Emulator V4.00 Page 55

Command Description

automount Display or update allowable tape

automount directories

b Set breakpoint

b+ Set breakpoint

b- Delete breakpoint

cache Execute cache related commands

cachestats Display cache statistics

capping Display or set CPU capping value

cckd CCKD command

cd Change directory

cf Configure current CPU online or

offline

cfall Configure all CPU’s online or offline

clocks Display TOD clock and CPU timer

cmdlevel Display or set current command group

cmdlvl Alias for cmdlevel command

cmdsep Display or set command line

seperator

cmdtgt Specify the command target

cnslport Display or set telnet client port

codepage Display or set codepage conversion

table

conkpalv Display / alter console TCP/IP keep-

alive settings

cp_updt Create or modify user character

conversion table

Hercules Emulator V4.00 Page 56

Command Description

cpu Define target CPU for console display

and commands

cpuidfmt Display or set format BASIC / 0 / 1

STIDP generation

cpumodel Display or set CPU model number

cpuprio Display or set CPU thread process

priority

cpuserial Display or set CPU serial number

cpuverid Display or set CPU version code

cr Display or alter control registers

cscript Cancel a running script thread

ctc Enable / disable CTC debugging

define Rename device

defstore Display or define main and expanded

storage values

defsym Define a symbol

delsym Delete a symbol

detach Remove device

devinit Reinitialize device

devlist List device, device class or all devices

devprio Display or set device threads process

priority

devtmax Display or set max device threads

diag8cmd Display or set DIAGNOSE 8

command option

dir Display file and directory listing

Hercules Emulator V4.00 Page 57

Command Description

ds Display subchannel

ecpsvm ECPS:VM commands

engines Set processor engines type

exec Execute a REXX script

exit Terminate the emulator

ext Generate external interrupt

fcb Display current FCB or load new FCB

image

fpc Display or alter floating point control

fpr Display or alter floating point registers

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

g Turn off instruction stepping and start

all CPUs

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

hercprio Display or set Hercules process

priority

hst History of commands

http Start, stop, modify or display HTTP

server

Hercules Emulator V4.00 Page 58

Command Description

i Generate I/O attention interrupt for

device

icount Display individual instruction counts

iodelay Display or set I/O delay value

ipending Display pending interrupts

ipl IPL Normal from device xxxx

iplc IPL Clear from device xxxx

(deprecated, use IPL with CLEAR
option instead)

k Display CCKD internal trace

kd Clear held messages

ldmod Load a module

legacysenseid Display or set SENSE ID CCW (x’E4’)

feature

loadcore Load a core image from a file

loadparm Set IPL parameter

loadtext Load a text deck file

log Direct logger output

logopt Display or set logging options

lparname Display or define LPAR name

lparnum Display or set LPAR identification

number

ls Display file and directory listing

lsdep List module dependencies

lsmod List dynamic modules

mainsize Display or set main storage size

Hercules Emulator V4.00 Page 59

Command Description

manufacturer Display or set STSI manufacturer

code

maxcpu Display or set maximum number of

CPUs

maxrates Display highest MIPS/SIO rate or set

a new reporting interval

memlock Lock Hercules memory

message Display message on console like VM

model Display or set STSI model code

modpath Display or set dynamic load module

path

mounted_tape_reinit Control tape initialization

msg Display message on console like VM

msghld Display or set timeout value of held

messages

msglevel Display or set the current message

display output

msglvl Display or set the current message

display output (alias for msglevel
command)

msgnoh Display message on console like VM,

but without header

mt Control magnetic tape operation

numcpu Display or set number of emulated

CPUs

numvec Display or set number of vector

facilities

ostailor Tailor trace information for specific

operating system

panrate Display or set console refresh rate

Hercules Emulator V4.00 Page 60

Command Description

pantitle Display or set console window title

pgmprdos Set LPP license setting

pgmtrace Trace program interrupts

plant Display or set STSI plant code

pr Display prefix register

pscp Send system control program priority

message

psw Display or alter program status word

ptp Enable / disable PTP debugging

ptt Display or set internal trace

pwd Print working directory

qcpuid Display CPU ID

qd Query DASD

qpfkeys Display the current PF key setings

qpid Display process ID of Hercules

qports Display TCP/IP ports in use

qproc Display processors type and utilization

qstor Display main and expanded storage

values

quiet Toggle automatic refresh of console

display data

quit Terminate the emulator

quitmout Dispay or set quit timeout value

r Display or alter real storage

Hercules Emulator V4.00 Page 61

Command Description

restart Generate restart interrupt

resume Resume Hercules

rexx Display or set REXX interpreter set-

tings

rmmod Delete a module

s Instruction stepping

s+ Instruction stepping on

s- Instruction stepping off

s? Instruction stepping query

savecore Save a core image to a file

sclproot Set or display SCLP base directory

scp Send system control program com-

mand

scpecho Display or set option to echo to

console and history of SCP replies

scpimply Display or set option to pass non-

Hercules commands to the SCP

script Run a sequence of console

commands contained in a file

scsimount Automatic SCSI tape mounts

sf+ Create a new shadow file

sf- Delete a shadow file

sfc Compress a shadow file

sfd Display shadow file statistics

sfk Perform a chkdsk on the active

shadow file

Hercules Emulator V4.00 Page 62

Command Description

sh Shell command

shcmdopt Display or set shell command option

showdvol1 Enable showing of DASD volsers in

device list

shrd Display or set shared device server

trace

shrdport Set shared device server port

sizeof Display size of structures

srvprio Display or set server threads priority

ssd Signal Shutdown

start Start CPU or printer / punch device

startall Start all CPU’s

stop Stop CPU or printer / punch device

stopall Stop all CPU’s

store Store CPU status at absolute zero

suspend Suspend Hercules

symptom Instruction trace display option (alias

for TRACEOPT command)

syncio Display syncio device statistics

sysclear SYSTEM CLEAR RESET manual

operation

sysepoch Set base date for TOD clock

sysreset SYSTEM RESET manual operation

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

t Instruction trace

Hercules Emulator V4.00 Page 63

Command Description

t+ Instruction trace on

t- Instruction trace off

t? Instruction trace query

timerint Display or set timers update interval

tlb Display TLB tables

toddrag Display or set TOD clock drag factor

todprio Display or set timer thread process

priority

traceopt Instruction trace display option

tt32 Control / query CTCI-WIN functionality

tzoffset Set TOD clock offset from GMT

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

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

u Disassemble storage

uptime Display Hercules Emulator uptime

v Display or alter virtual storage

version Display version information

xpndsize Display or set expanded storage size

yroffset Set TOD clock offset from actual date

Table 6: Hercules Console Commands

Hercules Emulator V4.00 Page 64

6. Console Command Descriptions

!message (SCP priority message)

Descriptive
!prio_msg

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

# (Silent comment)

Descriptive
# anytext

Diagram
ÊÊ¬¬ # ¬¬ anytext ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

$LOCATE (Display and verify Hercules control

blocks)

Descriptive
$LOCATE controlblock

Diagram
ÊÊ¬¬ $LOCATE ¬¬ controlblock ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

$TEST (Custom test command)

Descriptive
$TEST req_parms [opt_parms]

Diagram
ÊÊ¬¬ $TEST ¬¬ req_parms ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ opt_parms ¬¬¯

Hercules Emulator V4.00 Page 65

$ZAPCMD (Enable or disable system para-
meters and console commands)

Descriptive
$ZAPCMD cmdname [CFG | NOCFG | CMD | NOCMD]

Diagram
ÊÊ¬¬ $ZAPCMD ¬¬ cmdname ¬¬§¬¬ CFG ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ NOCFG ¬¬«
ª¬¬ CMD ¬¬¬¬«
¬¬ NOCMD ¬¬¯

* (Loud comment)

Descriptive
* anytext

Diagram
ÊÊ¬¬ * ¬¬ anytext ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

.reply (SCP command)

Descriptive
.any_reply

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

? (List all commands / command specific

help)

Descriptive
? [command | cmd*]

Diagram
ÊÊ¬¬ ? ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ command ¬¬«
¬¬¬ cmd* ¬¬¬¬¯

Hercules Emulator V4.00 Page 66

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 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

ARCHLVL (Set architecture level)

Descriptive
ARCHLVL [S/370 | ESA/390 | ESAME | z/ARCH]
or
ARCHLVL {ENABLE | DISABLE} facility
[S/370 | ESA/390 | z/ARCH]
or
ARCHLVL {ENABLE | DISABLE} bitno
[S/370 | ESA/390 | z/ARCH]
or

Hercules Emulator V4.00 Page 67

ARCHLVL QUERY [facility | ALL]

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

ÊÊ¬¬ ARCHLVL ¬¬§¬¬ ENABLE ¬¬¬§¬¬ facility ¬¬¬¬¬¬¬¬¬¬¬¬Ê

¬¬ DISABLE ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ S/370 ¬¬¬¬«
ª¬¬ ESA/390 ¬¬«
¬¬ z/ARCH ¬¬¬¯
or

ÊÊ¬¬ ARCHLVL ¬¬§¬¬ ENABLE ¬¬¬§¬¬ bitno ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

¬¬ DISABLE ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ S/370 ¬¬¬¬«
ª¬¬ ESA/390 ¬¬«
¬¬ z/ARCH ¬¬¬¯
or
~¬¬¬¬ ALL ¬¬¬¬¬®
ÊÊ¬¬ ARCHLVL ¬¬ QUERY ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ facility ¬¬¯

ARCHMODE (Set architecture mode)

ARCHMODE is an alias for the ARCHLVL console command.

Please see ARCHLVL for details.

ATTACH (Configure device)

Descriptive
ATTACH devn type [argument [argument ... ]]

Diagram
ÊÊ¬¬ ATTACH ¬¬ devn ¬¬ devtype ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

Hercules Emulator V4.00 Page 68

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬ argument ¬¬¨¬¬¯

AUTO_SCSI_MOUNT (Automatic SCSI tape

mounts)

The AUTO_SCSI_MOUNT console command has been

deprecated.
Use “SCSIMOUNT” instead.

AUTOINIT (Display or set automatic creation

of empty tape files)

Descriptive
AUTOINIT [ON | OFF]

Diagram
ÊÊ¬¬ AUTOINIT ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ ON ¬¬¬«
¬¬ OFF ¬¬¯

AUTOMOUNT (Display or update allowable

tape automount directories)

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

B (Set breakpoint)

Descriptive
B {addr | addr–addr}

Hercules Emulator V4.00 Page 69

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 (Execute cache related commands)

Descriptive
CACHE [DASD SYSTEM [ON | OFF]]

Diagram
ÊÊ¬¬ CACHE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ DASD SYSTEM ¬¬¬§¬¬¬¬¬¬¬¬¬«
ª¬¬ ON ¬¬¬«
¬¬ OFF ¬¬¯

CACHESTATS (Display cache statistics)

Descriptive
CACHESTATS

Diagram
ÊÊ¬¬ CACHESTATS ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V4.00 Page 70

CAPPING (Display or set CPU capping value)

Descriptive
CAPPING [mips | OFF | 0]

Diagram
ÊÊ¬¬ CAPPING ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ mips ¬¬«
ª¬¬ OFF ¬¬¬«
¬¬¬ 0 ¬¬¬¬¯

CCKD (CCKD command)

Descriptive
CCKD [HELP | STATS | OPTS |
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 ¬¬¬¬¬¬¬¬¬¬¯

Hercules Emulator V4.00 Page 71

CD (Change directory)

Descriptive
CD path

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

CF (Configure current CPU online or offline)

Descriptive
CF [ON | OFF]

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

CFALL (Configure all CPUs online or offline)

Descriptive
CFALL [ON | OFF]

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

CLOCKS (Display TOD clock and CPU timer)

Descriptive
CLOCKS

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

Hercules Emulator V4.00 Page 73

CMDLEVEL (Display or set current command
group)

Descriptive
CMDLEVEL [{+ | -} {ALL | OPERator | MAINT |
PROGrammer | CONFIG | DEVELoper |
DEBUG} [...]]

Diagram
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
ÊÊ¬¬ CMDLEVEL ¬¬°¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¨¬¬ÊÍ
ª¬¬ + ¬¬§¬¬§¬¬ ALL ¬¬¬¬¬¬¬¬¬«
¬¬ - ¬¬¯ ª¬¬ OPERator ¬¬¬¬«
ª¬¬ MAINT ¬¬¬¬¬¬¬«
ª¬¬ PROGrammer ¬¬«
ª¬¬ CONFIG ¬¬¬¬¬¬«
ª¬¬ DEVEL ¬¬¬¬¬¬¬«
¬¬ DEBUG ¬¬¬¬¬¬¬¯

CMDLVL (Display or set current command

group)
CMDLVL is an alias for CMDLEVEL. See CMDLEVEL for
details.

CMDSEP (Display or set command line

seperator)

Descriptive
CMDSEP [char | OFF]

Diagram
ÊÊ¬¬ CF ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ char ¬¬¬«
¬¬ OFF ¬¬¬¬¯

CMDTGT (Specify command target)

Descriptive
CMDTGT {HERC | SCP | PSCP | ?}

Hercules Emulator V4.00 Page 74

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

CNSLPORT (Display or set telnet client port)

Descriptive
CNSLPORT [port | host:port]

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

CODEPAGE (Display or set codepage con-

version table)

Descriptive
CODEPAGE [codepage | USER | MAINT cmd [operands]]

Diagram
ÊÊ¬¬ CODEPAGE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ÊÍ
ª¬¬ codepage ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ USER ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ MAINT ¬¬ cmd ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ operands ¬¬¯

CONKPALV (Specifiy TCP/IP keep alive

settings)

Descriptive
CONKPALV (idle,intv,count)

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

Hercules Emulator V4.00 Page 75

CP_UPDT (Create or modify user character
conversion table)

Descriptive
CP UPDT command [operands]

where command can be:

ALTER {EBCDIC | ASCII | G2H | H2G}

(pos,val[,pos,val]...)
DISPLAY {EBCDIC | ASCII | G2H | H2G }
EXPORT {EBCDIC | ASCII | G2H | H2G } filename
IMPORT {EBCDIC | ASCII | G2H | H2G } filename
REFERENCE [codepage]
RESET
TEST

Diagram
ÊÊ¬¬ CP UPDT ¬¬« command ª¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

where command can be:

~¬¬¬¬¬ , ¬¬¬¬¬®
ª¬¬ ALTER ¬¬§¬¬ EBCDIC ¬¬§¬ ( ¬¬°¬¬ pos,val ¬¬¨¬¬ ) ¬¬«
ª¬¬ ASCII ¬¬¬«
ª¬¬ G2H ¬¬¬¬¬«
¬¬ H2G ¬¬¬¬¬¯
ª¬¬ DISPLAY ¬¬§¬¬ EBCDIC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ ASCII ¬¬¬«
ª¬¬ G2H ¬¬¬¬¬«
¬¬ H2G ¬¬¬¬¬¯

ª¬¬ EXPORT ¬¬§¬¬ EBCDIC ¬¬§¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ ASCII ¬¬¬«
ª¬¬ G2H ¬¬¬¬¬«
¬¬ H2G ¬¬¬¬¬¯

ª¬¬ IMPORT ¬¬§¬¬ EBCDIC ¬¬§¬¬ filename ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ ASCII ¬¬¬«
ª¬¬ G2H ¬¬¬¬¬«
¬¬ H2G ¬¬¬¬¬¯

ª¬¬ REFERENCE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ codepage ¬¬¯

ª¬¬ RESET ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ TEST ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

Hercules Emulator V4.00 Page 76

CPU (Define target CPU for console displays
and commands)

Descriptive
CPU hh [cmd]

Diagram
ÊÊ¬¬ CPU ¬¬ hh ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ cmd ¬¬¯

CPUIDFMT (Display or set format BASIC / 0 / 1

STIDP generation)

Descriptive
CPUIDFMT [BASIC | 0 | 1]

Diagram
ÊÊ¬¬ CPUIDFMT ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ BASIC ¬¬«
ª¬¬¬¬ 0 ¬¬¬¬«
¬¬¬¬ 1 ¬¬¬¬¯

CPUMODEL (Display or set CPU model num-

ber)

Descriptive
CPUMODEL [model]

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

CPUPRIO (Display or set CPU thread process

priority)

Descriptive
CPUPRIO [nn]

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

Hercules Emulator V4.00 Page 77

CPUSERIAL (Display or set CPU serial num-
ber)

Descriptive
CPUMODEL [serial]

Diagram
ÊÊ¬¬ CPUMODEL¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ serial ¬¬¯

CPUVERID (Display or set CPU version code)

Descriptive
CPUVERID [verid]

Diagram
ÊÊ¬¬ CPUVERID¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ verid ¬¬¯

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 [* | ALL | id]

Diagram
ÊÊ¬¬ CSCRIPT ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ * ¬¬¬«
ª¬¬ ALL ¬¬«
¬¬ id ¬¬¬¯

Hercules Emulator V4.00 Page 78

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 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

DEFSTORE (Display or define main and ex-

panded storage values)

Descriptive
DEFSTORE [MAIN [msize[B | K | M | G | T | P | E]
[UNLOCK | LOCK]]]
[{XSTOR | EXPANDED} [msize[M | G | T]
[UNLOCK | LOCK]]]

Diagram
ÊÊ¬¬ DEFSTORE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬« storagetype ª¬¬¨¬¬¯

ª¬¬ MAIN ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬«

~¬¬ M ¬¬® ~¬¬ UNLOCK ¬¬®
¬¬ msize ¬¬¦¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¯
ª¬¬ B ¬¬« ¬¬¬ LOCK ¬¬¬¯
ª¬¬ K ¬¬«
ª¬¬ G ¬¬«
ª¬¬ T ¬¬«
ª¬¬ P ¬¬«
¬¬ E ¬¬¯

ª¬¬§¬¬ XSTOR ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

¬¬ EXPANDED ¬¬¯

Hercules Emulator V4.00 Page 79

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬«
~¬¬ M ¬¬® ~¬¬ UNLOCK ¬¬®
¬¬ xsize ¬¬¦¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¯
ª¬¬ G ¬¬« ¬¬¬ LOCK ¬¬¬¯
¬¬ T ¬¬¯

DEFSYM (Define a symbol)

Descriptive
DEFSYM [symbol [value]]

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

DELSYM (Delete a symbol)

Descriptive
DELSYM symbol

Diagram
ÊÊ¬¬ DELSYM ¬¬ symbol ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

DETACH (Remove device)

Descriptive
DETACH device

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

DEVINIT (Reinitialize device)

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

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

Hercules Emulator V4.00 Page 80

DEVLIST (List device, device class or all
devices)

Descriptive
DEVLIST [devnum | devclass]

Diagram
ÊÊ¬¬ DEVLIST ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ devnum ¬¬¬«
¬¬ devclass ¬¬¯

DEVPRIO (Display or set device threads

process priority)

Descriptive
DEVPRIO [nn]

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

DEVTMAX (Display or set maximum device

threads)

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

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

DIAG8CMD (Display or set DIAGNOSE 8

command option)

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

Hercules Emulator V4.00 Page 81

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

DIR (Display file and directory listing)

Descriptive
DIR

Diagram
ÊÊ¬¬ DIR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

DS (Display subchannel)

Descriptive
DS devnum

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

ECPSVM (ECPS:VM commands)

Diagram
ÊÊ¬¬ ECPSVM ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬ Help ¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ STats ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ DISable ¬¬¬¬¬¬¬¬¬¬«
ª¬¬ ENable ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ DEBUG ¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ NOdebug ¬¬¬¬¬¬¬¬¬¬«
¬¬¬ Level ¬¬§¬¬¬¬¬¬¬¬«
¬¬ nn ¬¬¯

Hercules Emulator V4.00 Page 82

ENGINES (Set processor engines type)

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

EXEC (Execute a REXX script)

Descriptive
EXEC [COMMAND | SUBROUTINE] rexx
[argument [argument ... ]]

Diagram
ÊÊ¬¬ EXEC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ rexx ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬ COMMAND ¬¬¬¬«
¬¬ SUBROUTINE ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬ argument ¬¬¨¬¬¯

EXIT (Terminate the emulator)

Descriptive
EXIT [FORCE]

Diagram
ÊÊ¬¬ EXIT ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ FORCE ¬¬¯

EXT (Generate external interrupt)

Descriptive
EXT

Hercules Emulator V4.00 Page 83

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

FCB (Display current FCB or load new FCB

image)

Descriptive
FCB devicenum [LPI=lpi] [LPP=lpp]
[FCB=l1:c1,l2:c2, ... ,l11:c11,l12:c12]

Diagram
ÊÊ¬¬ FCB ¬¬ devicenum ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ LPI=lpi ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ LPP=lpi ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ÊÍ
¬¬ FCB=l1:c1,l2:c2, ... ,l11:c11,l12:c12pi ¬¬¯

FPC (Display or alter floating point control

Descriptive
FPC [xxxxxxxx]

Diagram
ÊÊ¬¬ FPC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ xxxxxxxx ¬¬¯

FPR (Display or alter floating point registers)

Descriptive
FPR [nn=xxxxxxxxxxxxxxxx]

Diagram
ÊÊ¬¬ FPR ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn=xxxxxxxxxxxxxxxx ¬¬¯

Hercules Emulator V4.00 Page 84

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

Descriptive
F{+ | -} addr

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

G (Turn off instruction stepping and start all

CPUs)

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 command [operands]

where command can be:

TGT target
CMD consolecmd
DEL nn
CLEAR

Hercules Emulator V4.00 Page 85

LIST [nn]

Diagram
ÊÊ¬¬ HAO ¬¬« command ª¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

where command can be:

ª¬¬ TGT ¬¬ target ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ CMD ¬¬ consolecmd ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ DEL ¬¬ nn ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ CLEAR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ LIST ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ nn ¬¬¯

HELP (List all commands / command specific

help)

Descriptive
HELP [command | cmd*]

Diagram
ÊÊ¬¬ HELP ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ command ¬¬«
¬¬¬ cmd* ¬¬¬¬¯

HERC (Send Hercules command)

Descriptive
HERC [cmd]

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

HERCLOGO (Read a new Hercules logo file)

Descriptive
HERCLOGO [filename]

Hercules Emulator V4.00 Page 86

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

HERCPRIO (Display or set Hercules process

priority)

Descriptive
HERCPRIO [nn]

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

HST (History of commands)

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

Diagram
~¬¬ -1 ¬¬®
ÊÊ¬¬ HST ¬¬¨¬¬¬¬¬¬¬¬¨¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

ÊÊ¬¬ HST ¬¬§¬¬¬¬¬¬¬§¬¬ n ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

¬¬ - ¬¬¯
ÊÊ¬¬ HST ¬¬§¬¬ L ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ O ¬¬¯

HTTP (Start, stop, modify or display HTTP

server)

Descriptive
HTTP [START | STOP | ROOT path |
PORT port {NOAUTH | AUTH userid password}]

Diagram
ÊÊ¬¬ HTTP ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

Hercules Emulator V4.00 Page 87

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬ÊÍ
ª¬¬ START ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ STOP ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬ ROOT ¬¬ path ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ PORT ¬¬ port ¬¬§¬¬¬¬¬¬¬¬¬ NOAUTH ¬¬¬¬¬¬¬¬¬«
¬¬ AUTH userid password ¬¬¯

I (Generate I/O attention interrupt for device)

Descriptive
I device

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

ICOUNT (Display individual instruction

counts)

Descriptive
ICOUNT [SORT | CLEAR]

Diagram
ÊÊ¬¬ ICOUNT ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ SORT ¬¬¬«
¬¬ CLEAR ¬¬¯

IODELAY (Display or set I/O delay value)

Descriptive
IODELAY [usecs [NOWARN]]

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

IPENDING (Display pending interrupts)

Descriptive
IPENDING

Hercules Emulator V4.00 Page 88

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

IPL (IPL Normal from device xxxx)

Descriptive
IPL {devnum | filename}
[LOADPARM iplparm | PARM parmstring] [CLEAR]

Diagram
ÊÊ¬¬ IPL ¬¬§¬¬¬ devnum ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ filename ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ LOADPARM iplparm ¬¬« ¬¬ CLEAR ¬¬¯
¬¬ PARM parmstring ¬¬¬¯

IPLC (IPL Clear from device xxxx)

The IPLC console command has been deprecated.

Use “IPL CLEAR” instead.

K (Display CCKD internal trace)

Descriptive
K

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

KD (Alias of 'MSGHLD CLEAR')

Descriptive
KD

Diagram
ÊÊ¬¬ KD ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V4.00 Page 89

LDMOD (Load a module)

Descriptive
LMOD module [module [module ...]]

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

LEGACYSENSEID (Display or set SENSE ID

CCW (x'E40) feature)

Descriptive
LEGACYSENSEID [OFF | DISABLE | ON | ENABLE]

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

LOADCORE (Load a core image from a file)

Descriptive
LOADCORE filename [address | 0]

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

LOADPARM (Set IPL parameter)

Descriptive
LOADPARM [ipl parameter]

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

Hercules Emulator V4.00 Page 90

LOADTEXT (Load a text deck file)

Descriptive
LOADTEXT filename [address]

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

LOG (Direct logger output)

Descriptive
LOG [newfile | OFF]

Diagram
ÊÊ¬¬ LOG ¬¬§¬¬ newfile ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬¬ OFF ¬¬¬¬¯

LOGOPT (Display or set logging options)

Descriptive
LOGOPT [TIMESTAMP | NOTIMESTAMP | TIME | NOTIME]

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

LPARNAME (Display or define LPAR name)

Descriptive
LPARNAME [lparname]

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

Hercules Emulator V4.00 Page 91

LPARNUM (Display or set LPAR identification
number)

Descriptive
LPARNUM [BASIC | n | nn]

Diagram
ÊÊ¬¬ LPARNUM ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ BASIC ¬¬«
ª¬¬¬ n ¬¬¬¬¬«
¬¬¬ nn ¬¬¬¬¯

LS (Display file and directory listing)

Descriptive
LS

Diagram
ÊÊ¬¬ LS ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

LSDEP (List module dependencies)

Descriptive
LSDEP

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

LSMOD (List dynamic modules)

Descriptive
LSMOD

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

Hercules Emulator V4.00 Page 92

MAINSIZE (Display or set main storage size)

Descriptive
MAINSIZE [size[B | K | M | G | T | P | E]
[UNLOCK | LOCK]]

Diagram
ÊÊ¬¬ MAINSIZE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
~¬¬ M ¬¬®
¬¬ size ¬¬¦¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬ B ¬¬«
ª¬¬ K ¬¬«
ª¬¬ G ¬¬«
ª¬¬ T ¬¬«
ª¬¬ P ¬¬«
¬¬ E ¬¬¯

Ê¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬ UNLOCK ¬¬®
Ê¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¯
¬¬¬ LOCK ¬¬¬¯

MANUFACTURER (Display or set STSI manu-

facturer code)

Descriptive
MANUFACTURER [name]

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

MAXCPU (Display or set maximun number of

CPUs)

Descriptive
MAXCPU [nn]

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

Hercules Emulator V4.00 Page 93

MAXRATES (Display highest MIPS/SIO rate or
set new reporting interval)

Descriptive
MAXRATES [interval | MIDNIGHT]

Diagram
ÊÊ¬¬ MAXRATES ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ interval ¬¬«
¬¬ MIDNIGHT ¬¬¯

MEMLOCK (Lock Hercules memory)

Descriptive
MEMLOCK [ON | OFF]

Diagram
ÊÊ¬¬ MEMLOCK ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ ON ¬¬¬«
¬¬ OFF ¬¬¯

MESSAGE (Display message on console like

VM)

Descriptive
MESSAGE parms

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

MODEL (Display or set STSI model code)

Descriptive
MODEL [hdwmod | = | * [capmod | = | *
[prmmod | = | * [tmpmod | = | *]]]]

Diagram
ÊÊ¬¬ MODEL ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ hdwmod ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬ = ¬¬¬¬«
¬¬¬¬¬ * ¬¬¬¬¯

Hercules Emulator V4.00 Page 94

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬ÊÍ
ª¬¬ capmod ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬ = ¬¬¬¬¬« ª¬¬ prmmod ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬¬¬ * ¬¬¬¬¬¯ ª¬¬¬¬ = ¬¬¬¬¬« ª¬¬ tmpmod ¬¬«
¬¬¬¬ * ¬¬¬¬¬¯ ª¬¬¬¬ = ¬¬¬¬¬«
¬¬¬¬ * ¬¬¬¬¬¯

MODPATH (Display or set dynamic load

module path)

Descriptive
MODPATH [path]

Diagram
ÊÊ¬¬ MODPATH ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ path ¬¬¯

MOUNTED_TAPE_REINIT (Control tape

initialization)

Descriptive
MOUNTED TAPE REINIT [ENABLE | ALLOW |
DISABLE | DISALLOW]

Diagram
ÊÊ¬¬ MOUNTED TAPE REINIT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ ENABLE ¬¬¬¬«
ª¬¬ ALLOW ¬¬¬¬¬«
ª¬¬ DISABLE ¬¬¬«
¬¬ DISALLOW ¬¬¯

MSG (Display message on console like VM)

Descriptive
MSG parms

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

Hercules Emulator V4.00 Page 95

MSGHLD (Display or set timeout of held
messages)

Descriptive
MSGHLD {nnn | INFO | CLEAR}

Diagram
ÊÊ¬¬ MSGHLD ¬¬§¬¬¬ nnn ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ INFO ¬¬¬«
¬¬ CLEAR ¬¬¯

MSGLEVEL (Display or set the current

message display output)

Descriptive
MSGLEVEL [option option ...]

where option can be:

ON | OFF | TEXT | TIME | NODEBUG |

[+ | -] DEBUG |
[+ | -] TAPE |
[+ | -] DASD |
[+ | -] COMM |
[+ | -] UR |
[+ | -] SCSI |
[+ | -] CTCA |
[+ | -] GRAF |
[+ | -] THREAD |
[+ | -] CHANNEL |
[+ | -] VERBOSE |
[+ | -] TERSE

Diagram
ÊÊ¬¬ MSGLEVEL ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬« option ª¬¬¨¬¬¯

where option can be:

Hercules Emulator V4.00 Page 96

ª¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ ON ¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬¬¬¬ OFF ¬¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬¬¬¬ TEXT ¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬¬¬¬ TIME ¬¬¬¬¬«
ª¬¬¬¬¬¬¬¬¬¬¬¬¬ NODEBUG ¬¬«
ª¬¬¬¬¬¬¬§¬¬§¬¬ DEBUG ¬¬¬¬«
ª¬¬ + ¬¬« ª¬¬ TAPE ¬¬¬¬¬«
¬¬ - ¬¬¯ ª¬¬ DASD ¬¬¬¬¬«
ª¬¬ COMM ¬¬¬¬¬«
ª¬¬ UR ¬¬¬¬¬¬¬«
ª¬¬ SCSI ¬¬¬¬¬«
ª¬¬ CTCA ¬¬¬¬¬«
ª¬¬ GRAF ¬¬¬¬¬«
ª¬¬ THREAD ¬¬¬«
ª¬¬ CHANNEL ¬¬«
ª¬¬ VERBOSE ¬¬«
¬¬ TERSE ¬¬¬¬¯

MSGLVL (Display or set the current message

display output)
MSGLVL is an alias for MSGLEVEL.
See MSGLEVEL for details.

MSGNOH (Display message on console like

VM, but without header)

Descriptive
MSG parms

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

MT (Control magnetic tape operation)

Hercules Emulator V4.00 Page 97

DSE
DVOL1

Diagram

ÊÊ¬¬ MT ¬¬ device ¬¬« operation ª¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

where operation can be:

ª¬¬ REW ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

~¬¬¬ 1 ¬¬¬¬®
ª¬¬ ASF ¬¬¦¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ nnnn ¬¬¯

~¬¬¬ 1 ¬¬¬¬®
ª¬¬ FSF ¬¬¦¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ nnnn ¬¬¯

~¬¬¬ 1 ¬¬¬¬®
ª¬¬ BSF ¬¬¦¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ nnnn ¬¬¯

~¬¬¬ 1 ¬¬¬¬®
ª¬¬ FSR ¬¬¦¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ nnnn ¬¬¯

~¬¬¬ 1 ¬¬¬¬®
ª¬¬ BSR ¬¬¦¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ nnnn ¬¬¯

~¬¬¬ 1 ¬¬¬¬®
ª¬¬ WTM ¬¬¦¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ nnnn ¬¬¯

ª¬¬ DSE ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ DVOL1 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

NUMCPU (Display or set number of emulated

CPUs)

Descriptive
NUMCPU [nn]

Hercules Emulator V4.00 Page 98

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

NUMVEC (Display or set number of vector

facilities)

Descriptive
NUMVEC [nn]

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

OSTAILOR (Tailor trace information for spe-

cific 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 ¬¬¬¬¬¬¬¯

PANRATE (Display or set pamel refresh rate)

Descriptive
PANRATE [SLOW | FAST | rate]

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

Hercules Emulator V4.00 Page 99

PANTITLE (Hercules console window title)

Descriptive
PANTITLE [text | "text text text" | ""]

Diagram
ÊÊ¬¬ PANTITLE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬¬¬¬¬¬¬ text ¬¬¬¬¬¬¬¬«
ª¬¬ "text text text" ¬¬«
¬¬¬¬¬¬¬¬¬ "" ¬¬¬¬¬¬¬¬¬¯

PGMPRDOS (Set LPP license setting)

Descriptive
PGMPRDOS {RESTRICTED | LICENSED}

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

PGMTRACE (Trace program interrupts)

Descriptive
PGMTRACE [[-]intcode]

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

PLANT (Display or set STSI plant code)

Descriptive
MANUFACTURER [name]

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

Hercules Emulator V4.00 Page 100

PR (Display prefix register)

Descriptive
PR

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

PSCP (Send system control program priority

message)

Descriptive
PSCP [cmd]

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

PSW (Display or alter program status word)

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

where operand can be:

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

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

Hercules Emulator V4.00 Page 101

where operand can be:

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

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

ª¬¬ CMWP=x ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ AS= ¬¬§¬¬ PRI ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ SEC ¬¬¬«
¬¬ HOME ¬¬¯

ª¬¬ CC=n ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ PM=x ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

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

ª¬¬ AM= ¬¬§¬¬ 24 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬ 31 ¬¬«
¬¬ 64 ¬¬¯

PTP (Enable / disable PTP debugging)

Descriptive
PTP DEBUG {ON | OFF} [[devnum | ALL] [mask]]

Diagram
~¬¬¬ ALL ¬¬¬¬®
ÊÊ¬¬ PTP ¬¬ DEBUG ¬¬§¬¬ ON ¬¬¬§¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬Ê
¬¬ OFF ¬¬¯ ¬¬ devnum ¬¬¯
Ê¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ mask ¬¬¯

PTT (Display or set internal trace)

Hercules Emulator V4.00 Page 102

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 ¬¬¯

PWD (Print working directory)

Descriptive
PWD

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

Hercules Emulator V4.00 Page 103

QCPUID (Display CPU ID)

Descriptive
QCPUID

Diagram
ÊÊ¬¬ QCPUID ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

QD (Query DASD)

Descriptive
QD [address]

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

QPFKEYS (Display the current PF key set-

tings)

Descriptive
QPFKEYS

Diagram
ÊÊ¬¬ QPFKEYS ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

QPID (Display process ID of Hercules)

Descriptive
QPID

Diagram
ÊÊ¬¬ QPID ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

QPORTS (Display TCP/IP ports in use)

Descriptive
QPORTS

Hercules Emulator V4.00 Page 104

Diagram
ÊÊ¬¬ QPORTS ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

QPROC (Display processors type and utili-

zation)

Descriptive
QPROC

Diagram
ÊÊ¬¬ QPROC ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

QSTOR (Query main and expanded storage

values)

Descriptive
QSTOR

Diagram
ÊÊ¬¬ QSTOR ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

QUIET (Toggle automatic refresh of console

display data)

Descriptive
QUIET

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

QUIT (Terminate the emulator)

Descriptive
QUIT [FORCE]

Diagram
ÊÊ¬¬ QUIT ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ FORCE ¬¬¯

Hercules Emulator V4.00 Page 105

QUITMOUT (Display or set quit timeout value)

Descriptive
QUITMOUT [nn]

Diagram
ÊÊ¬¬ QUITMOUT ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

R (Display or alter real storage)

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

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

RESTART (Generate restart interrupt)

Descriptive
RESTART

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

RESUME (Resume Hercules)

Descriptive
RESUME

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

Hercules Emulator V4.00 Page 106

REXX (Display or set REXX interpreter set-
tings)

Descriptive
REXX [option]

where option can be:

ENABLE | START [REGINA | OOREXX]

Diagram
ÊÊ¬¬ REXX ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬« option ª¬¬¯
where option can be:

ª¬¬§¬¬ ENABLE ¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ START ¬¬¬¯ ª¬¬ REGINA ¬¬«
¬¬ OOREXX ¬¬¯

ª¬¬§¬¬ DISABLE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬ STOP ¬¬¬¬¯

~¬¬ delimiter ¬¬®

ª¬¬§¬¬¬¬ PATHS ¬¬¬¬§¬¬§¬¬°¬¬¬ path ¬¬¬¬¬¬¨¬¬§¬¬¬¬¬¬¬¬¬«
¬¬ REXXPATHS ¬¬¯ ¬¬¬¬¬¬ RESET ¬¬¬¬¬¬¬¬¯

ª¬¬ SYSPATH ¬¬§¬¬¬ ON ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬ OFF ¬¬¬«
¬¬ RESET ¬¬¯

~¬¬ delimiter ¬¬®

ª¬¬§¬¬ EXTENSIONS ¬¬§¬¬§¬¬°¬¬¬ suffix ¬¬¬¬¨¬¬§¬¬¬¬¬¬¬¬«
¬¬¬ SUFFIXES ¬¬¬¯ ¬¬¬¬¬¬¬ RESET ¬¬¬¬¬¬¬¯

Hercules Emulator V4.00 Page 107

ª¬¬ RESOLVER ¬¬§¬¬¬ ON ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
ª¬¬¬ OFF ¬¬¬«
¬¬ RESET ¬¬¯

ª¬¬ MSGLEVEL ¬¬§¬¬¬¬ 0 ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬¬ 1 ¬¬¬¬«
¬¬ RESET ¬¬¯

ª¬¬ MSGPREFIX ¬¬§¬¬ messageprefix ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬¬¬¬¬ OFF ¬¬¬¬¬¬¬«
¬¬¬¬¬¬ RESET ¬¬¬¬¬¬¯

ª¬¬ ERRPREFIX ¬¬§¬¬ errorprefix ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

ª¬¬¬¬¬¬ OFF ¬¬¬¬¬¬«
¬¬¬¬¬ RESET ¬¬¬¬¬¯

ª¬¬ MODE ¬¬§¬¬¬ COMMAND ¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬ SUBROUTINE ¬¬¯

RMMOD (Delete a module)

Descriptive
RMMOD module [module [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 ¬¬¬¬¬¬¬¯

S+ (Instruction stepping on)

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

Hercules Emulator V4.00 Page 108

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? ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

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]

Hercules Emulator V4.00 Page 109

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

SCP (Send system control program com-

mand)

Descriptive
SCP [cmd]

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

SCPECHO (Display or set option to echo to

console and history of SCP replies)

Descriptive
SCPECHO [OFF | ON]

Diagram
ÊÊ¬¬ SCPECHO ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ OFF ¬¬«
¬¬ ON ¬¬¬¯

SCPIMPLY (Display or set option to pass non-

Hercules commands to the SCP)

Descriptive
SCPIMPLY [OFF | ON]

Diagram
ÊÊ¬¬ SCPIMPLY ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ OFF ¬¬«
¬¬ ON ¬¬¬¯

Hercules Emulator V4.00 Page 110

SCRIPT (Run a sequence of commands con-
tained in a file)

Descriptive
SCRIPT [filename [filename ... ]]

Diagram
ÊÊ¬¬ SCRIPT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬ 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- (Delete a shadow file)

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

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

Hercules Emulator V4.00 Page 111

SFC (Compress a shadow file)

Descriptive
SFC {device | *}

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 ¬¬¨¬¬¯

Hercules Emulator V4.00 Page 112

SHCMDOPT (Display or set shell command
option)

Descriptive
SHCMDOPT [DISABLE | ENABLE [DIAG8 | NODIAG8]]

Diagram
ÊÊ¬¬ SHCMDOPT ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬ÊÍ
ª¬¬ DISABLE ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
~¬¬¬ DIAG8 ¬¬¬®
¬¬ ENABLE ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¯
¬¬ NODIAG8 ¬¬¯

SHOWDVOL1 (Enable showing of DASD vol-

sers in device list)

Descriptive
SHOWDVOL1 [NO | YES | ONLY]

Diagram
ÊÊ¬¬ SHOWDVOL1 ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ NO ¬¬¬¬«
ª¬¬ YES ¬¬¬«
¬¬ ONLY ¬¬¯

SHRD (Display or set shared device server

trace)

Descriptive
SHRD TRACE[=n]

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

SHRDPORT (Set shared device server port)

Descriptive
SHRDPORT [port | START | STOP]

Hercules Emulator V4.00 Page 113

Diagram
ÊÊ¬¬ SHRDPORT ¬¬§¬¬ port ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ START ¬¬«
¬¬ STOP ¬¬¬¯

SIZEOF (Display size of structures)

Descriptive
SIZEOF

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

SRVPRIO (Display or set server threads pro-

cess priority)

Descriptive
SRVPRIO [nn]

Diagram
ÊÊ¬¬ SRVPRIO ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

SSD (Signal shutdown)

Descriptive
SSD [FORCE]

Diagram
ÊÊ¬¬ SSD ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ FORCE ¬¬¯

START (Start CPU or printer / punch device)

Descriptive
START [devicenum]

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

Hercules Emulator V4.00 Page 114

STARTALL (Start all CPUs)

Descriptive
STARTALL

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

STOP (Stop CPU or printer / punch 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

Hercules Emulator V4.00 Page 115

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

SYMPTOM (Instruction trace display options)

SYMPTOM is an alias for the TRACEOPT console command.

Please see TRACEOPT for details.

SYNCIO (Display SYNCIO device statistics)

Descriptive
SYNCIO

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

SYSCLEAR (SYSTEM CLEAR RESET manual

operation)

Descriptive
SYSCLEAR

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

SYSEPOCH (Set base date for TOD clock)

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

Hercules Emulator V4.00 Page 116

SYSRESET (SYSTEM RESET manual
operation)

Descriptive
SYSRESET [NORMAL | CLEAR]

Diagram
ÊÊ¬¬ SYSRESET ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ NORMAL ¬¬«
¬¬ CLEAR ¬¬¬¯

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

Descriptive
S{+ | -} devaddr

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

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]

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

Hercules Emulator V4.00 Page 117

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 ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ - ¬¬¯

TIMERINT (Display or set timers update

interval)

Descriptive
TIMERINT [interval]

Hercules Emulator V4.00 Page 118

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 ¬¬¯

TODPRIO (Display or set timer thread process

priority)

Descriptive
TODPRIO [nn]

Diagram
ÊÊ¬¬ TODPRIO ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬ nn ¬¬¯

TRACEOPT (Instruction trace display options)

Descriptive
TRACEOPT [TRADITIONAL | REGSFIRST | NOREGS]

Hercules Emulator V4.00 Page 119

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

TT32 (Control / query CTCI-WIN functionality)

Descriptive
TT32 {DEBUG | NODEBUG | STATS devnum}

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

TZOFFSET (Set TOD clock offset from GMT)

Descriptive
TZOFFSET {0000 | +hhmm | -hhmm}

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

U (Disassemble storage)

Descriptive
U [R | V | P | H] {addr.length | addr-addr}

Diagram
ÊÊ¬¬ U ¬¬§¬¬¬¬¬¬¬§¬¬§¬¬ addr.length ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
ª¬¬ R ¬¬« ¬¬¬ addr-addr ¬¬¬¯
ª¬¬ V ¬¬«
ª¬¬ P ¬¬«
¬¬ H ¬¬¯

UPTIME (Display Hercules Emulator uptime)

Descriptive
UPTIME

Hercules Emulator V4.00 Page 120

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 ¬¬¬¯

VERSION (Display version information)

Descriptive
VERSION

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

XPNDSIZE (Display or set expanded storage

size)

Descriptive
XPNDSIZE [size[M | G | T] [UNLOCK | LOCK]]

Diagram
ÊÊ¬¬ XPNDSIZE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
~¬¬ M ¬¬®
¬¬ size ¬¬¦¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬ G ¬¬«
¬¬ T ¬¬¯

Ê¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬ UNLOCK ¬¬®
Ê¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¯
¬¬¬ LOCK ¬¬¬¯

Hercules Emulator V4.00 Page 121

YROFFSET (Set TOD clock offset from actual
date)

Descriptive
YROFFSET {+years | -years}

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

Hercules Emulator V4.00 Page 122

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

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 V4.00 Page 123

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

VMFPLC2 VM formatted tape utility

Table 8: TAPE Utilities

Miscellanious Utilities

Utility Name Function

DMAP2HRC P/390 DEVMAP conversion program

Table 9: Miscellanious Utilities

Hercules Emulator V4.00 Page 124

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 V4.00 Page 125

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 V4.00 Page 126

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 V4.00 Page 127

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 V4.00 Page 128

-a (include alternate cylinders)
-r (build raw DASD image file)
-b (make the wait PSW in the IPL1 record a
BC-mode PSW. If not specified the wait
PSW will be an EC-mode PSW)
-m (enable the wait PSW in the IPL1 record
for machine check interruptions)
-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)
-b (for a volume without IPL text, make the
wait PSW written to the IPL1 record a

Hercules Emulator V4.00 Page 129

BC-mode PSW. If not specified the wait
PSW will be an EC-mode PSW)
-m (for a volume without IPL text, make the
wait PSW written to the IPL1 record
enabled for machine checks)

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.

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]

Hercules Emulator V4.00 Page 130

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)
-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 ¬¬¯

Hercules Emulator V4.00 Page 131

Ê¬¬ filespec ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

HETGET (Extract files from an AWS or HET

tape file)

Descriptive
HETGET tapefile outfile filenum

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

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

Hercules Emulator V4.00 Page 132

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

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

Options

-a (print all label and file information,

default)
-bn (Print ‘n’ bytes per file, implies –s)
-d (print only dataset information)
-f (print only file information)
-h (display usage summary)
-l (print only label information)
-s (print dump of each data file in SLANAL
format)
-t (print TAPEMAP-compatible format output)

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)

Hercules Emulator V4.00 Page 133

-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 ¬¬¯

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 ¬¬¬¬¬¬¬¬¬ÊÍ

Hercules Emulator V4.00 Page 134

VMFPLC2 (VM formatted tape utility)

Descriptive
VMFPLC2 {DUMP controlfile outputfile | SCAN inputfile |
LOAD inputfile}

Diagram
ÊÊ¬¬ VMFPLC2 ¬¬§¬¬ DUMP controlfile outputfile ¬¬§¬¬¬ÊÍ
ª¬¬ SCAN inputfile ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«
¬¬ LOAD inputfile ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¯

Control File
Each line of the control file has the following format:

filename filetype filemode recfm lrecl type tapefile

DMAP2HRC (P/390 DEVMAP conversion

program)

Descriptive
DMAP2HRC filename

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

Hercules Emulator V4.00 Page 135

8. Shared Device Support

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

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

Hercules Emulator V4.00 Page 136

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 V4.00 Page 137

$(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 V4.00 Page 138

10. Starting the Hercules Emulator

Starting Hercules in Native Mode

Descriptive
HERCULES
[{-f configfile | --config=configfile}]
[{-r rcfile | --rcfile=rcfile}]
[{-b logofile | --herclogo=logofile}]
[{-d | --daemon}]
[{-p dyndir | --modpath=dyndir}]
[{-l dynmod [...] | --ldmod=dynmod [...]}]
[{-s symbol=value [...] | --defsym=symbol=value [...]}]
[{-v | --verbose}]
[{-h | --help}]
[>logfile]

Diagram
ÊÊ¬¬ HERCULES ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬¬ -f configfile ¬¬¬¬«
¬¬ --config=configfile ¬¬¯
Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬ -r rcfile ¬¬¬¬¬«
¬¬ --rcfile=rcfile ¬¬¯
Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬Ê
ª¬¬¬¬¬¬ -b logofile ¬¬¬¬¬¬« ª¬¬¬¬¬ -d ¬¬¬¬¬«
¬¬ --herclogo=logofile ¬¬¯ ¬¬ --daemon ¬¬¯

Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬¬ -p dyndir ¬¬¬¬¬«
¬¬ --modpath=dyndir ¬¬¯
Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬§¬¬¬¬¬ -l dynmod ¬¬¬¬¬§¬¬¨¬¬¯
¬¬ --ldmod= dynmod ¬¬¯

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬Ê
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬¬°¬¬§¬¬¬¬¬¬ -s symbol=value ¬¬¬¬¬¬§¬¬¨¬¬¬¯
¬¬¬ --defsym symbol=value ¬¬¬¯
Ê¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
ª¬¬¬¬¬¬ -v ¬¬¬¬¬« ª¬¬¬¬¬ -h ¬¬¬¬¬«
¬¬ --verbose ¬¬¯ ¬¬¬ --help ¬¬¬¯

Hercules Emulator V4.00 Page 139

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
¬¬¬ >logfile ¬¬¬¯

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 V4.00 Page 140

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 V4.00 Page 141

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 V4.00 Page 142

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

Windows event handler

The following table shows the trapped Windows events.

Key Action

Simulates the External Interrupt key

CTRL-Break
being pressed.

CTRL-C is currently caught, but there

CTRL-C
is no action taken.

The normal close button (the red "X"

box) has been disabled to prevent an
unintended shutdown of Hercules. The
Close close function via the Windows menu
("File -> Exit") however is still
available. In this case Hercules
initiates an immediate shutdown.

Shutdown ("Start -> Shut down -> Shut

Shutdown down") initiates an immediate
shutdown of Hercules.

Logoff ("Start -> Shut down -> Log off")

Logoff initiates an immediate shutdown of
Hercules.

Table 12: Extended cursor handling

Hercules Emulator V4.00 Page 143

Programmed Function Keys (PF Keys)
The Hercules console supports the usage of PF keys. The
command to be assigned to the PF key has to be defined with
a DEFSYM statement. This can be done through a DEFSYM
system parameter statement in the Hercules configuration file
or through a console command.
On Windows systems PF keys PF01 to PF48 are assignable,
on non-Windows systems PF01 to PF20. The following
special keys must be used to access the PF keys:
PF01-PF12 Press PF key only
PF13-PF24 Press SHIFT and PF key
PF25-PF36 Press CTRL and PF key
PF37-PF48 Press ALT and PF key

PF keys can be defined as follows:

Descriptive
DEFSYM PFnn "[SUBST] {IMMED | DELAY}
{HERC | SCP | PSCP}
command [&n | &* | &$ [...]]"

Diagram

ÊÊ¬¬ DEFSYM ¬¬ PFnn ¬¬ " ¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

¬¬ SUBST ¬¬¯
Ê¬¬§¬¬ IMMED ¬¬§¬¬§¬¬ HERC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê
¬¬ DELAY ¬¬¯ ª¬¬ SCP ¬¬¬«
¬¬ PSCP ¬¬¯
Ê¬¬ command ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬ " ¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
~¬¬¬¬¬¬¬¬¬¬¬¬¬¬®
¬¬°¬¬§¬¬ &n ¬¬§¬¬¨¬¬¯
ª¬¬ &* ¬¬«
¬¬ &$ ¬¬¯

Hercules Emulator V4.00 Page 144

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 [*]

Hercules Emulator V4.00 Page 145

Devicetype-Model Cylinders Alternate
Cylinders

IBM 3380-1 885 1

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 13: Supported CKD DASD Devices

Hercules Emulator V4.00 Page 146

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 14: Supported FBA DASD Devices

Hercules Emulator V4.00 Page 147

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

Syntax Element Description

Keywords are denoted with upper case

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

All user defined values are denoted with

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

Signifies that all, or some portion, of the

code elements 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 elements 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.

Signifies that there can be more than

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

Hercules Emulator V4.00 Page 148

Syntax Element Description

Signifies that there can be more than

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

Table 15: Reading Syntax Descriptions

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.

Hercules Emulator V4.00 Page 149

Symbol Description

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 V4.00 Page 150

Symbol Description

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 16: Reading Syntax Diagrams

Hercules Emulator V4.00 Page 151

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

Hercules Emulator V4.00

PPPP

Reference Summary

11.1.1.1.1.1

HERS040000-00
Version 4 Release 00
Hercules Emulator

Page 152

Windows Command Prompt A-N
From Everand
Windows Command Prompt A-N
Prometheus MMS
5/5 (2)
Mastering Proxmox - Second Edition
From Everand
Mastering Proxmox - Second Edition
Wasim Ahmed
No ratings yet
CS 1000 - 3000 & CENTUM VP ENGINEERING GUIDE (Standard Tools)
0% (1)
CS 1000 - 3000 & CENTUM VP ENGINEERING GUIDE (Standard Tools)
44 pages
Modbus Communication Card cm1241 rs232 PDF
No ratings yet
Modbus Communication Card cm1241 rs232 PDF
4 pages
Hercules Reference Summary
No ratings yet
Hercules Reference Summary
107 pages
Hercules - Reference Summary: Version 3 Release 07
No ratings yet
Hercules - Reference Summary: Version 3 Release 07
106 pages
The Hercules S/370, ESA/390, and Z/architecture Systems Emulator
No ratings yet
The Hercules S/370, ESA/390, and Z/architecture Systems Emulator
36 pages
Hercules Installation
No ratings yet
Hercules Installation
238 pages
Hercules-390.eu - Hercconf
No ratings yet
Hercules-390.eu - Hercconf
41 pages
Hercules General Info
No ratings yet
Hercules General Info
176 pages
Hercules V3.13.0 - Installation Guide - HEIG031300-00
No ratings yet
Hercules V3.13.0 - Installation Guide - HEIG031300-00
240 pages
Hercules - User Reference Guide: Hercules System/370, ESA/390, Z/architecture Emulator
No ratings yet
Hercules - User Reference Guide: Hercules System/370, ESA/390, Z/architecture Emulator
665 pages
Hercules - Installation Guide: Hercules System/370, ESA/390, Z/architecture Emulator
100% (1)
Hercules - Installation Guide: Hercules System/370, ESA/390, Z/architecture Emulator
127 pages
Hercules Installation Guide v4.0
No ratings yet
Hercules Installation Guide v4.0
249 pages
Hercules User Reference
No ratings yet
Hercules User Reference
478 pages
hercules
No ratings yet
hercules
2 pages
Hercules Messagesand Codes
No ratings yet
Hercules Messagesand Codes
169 pages
All-Products Esuprt Ser Stor Net Esuprt Poweredge Poweredge-1600sc User's Guide En-Us
No ratings yet
All-Products Esuprt Ser Stor Net Esuprt Poweredge Poweredge-1600sc User's Guide En-Us
43 pages
PSX Readme
No ratings yet
PSX Readme
8 pages
Hercules Messagesand Codes
No ratings yet
Hercules Messagesand Codes
680 pages
Practical Reverse Engineering: x86, x64, ARM, Windows Kernel, Reversing Tools, and Obfuscation
From Everand
Practical Reverse Engineering: x86, x64, ARM, Windows Kernel, Reversing Tools, and Obfuscation
Bruce Dang
No ratings yet
Poweredge Poweredge 600 SC User Guide 646cd44859943266515905
No ratings yet
Poweredge Poweredge 600 SC User Guide 646cd44859943266515905
35 pages
P SXfin
No ratings yet
P SXfin
6 pages
Poweredge-6800 User's Guide En-Us
No ratings yet
Poweredge-6800 User's Guide En-Us
31 pages
FMSX Dos
No ratings yet
FMSX Dos
5 pages
Steem SSE 4.1.2
No ratings yet
Steem SSE 4.1.2
6 pages
Mac On Fig
No ratings yet
Mac On Fig
449 pages
Learning Linux Binary Analysis: Learning Linux Binary Analysis
From Everand
Learning Linux Binary Analysis: Learning Linux Binary Analysis
Ryan "elfmaster" O'Neill
4/5 (1)
Readme
No ratings yet
Readme
7 pages
Hercules Emulator
No ratings yet
Hercules Emulator
24 pages
CT Consoles Components All Models
No ratings yet
CT Consoles Components All Models
16 pages
PCSX2 Fall
No ratings yet
PCSX2 Fall
2 pages
Eetop.cn Getting Started With Hercules
No ratings yet
Eetop.cn Getting Started With Hercules
502 pages
Herctut
No ratings yet
Herctut
502 pages
Hardware Configuration Features - Dell Precision WorkStation 420 Systems User's Guide
No ratings yet
Hardware Configuration Features - Dell Precision WorkStation 420 Systems User's Guide
15 pages
Hercules - Desenvolvedores Do Hercules - Relacao Dos Nomes PDF
No ratings yet
Hercules - Desenvolvedores Do Hercules - Relacao Dos Nomes PDF
70 pages
Dell™ Optiplex™ 380 Service Manual - Mini-Tower: Notes, Cautions, and Warnings
No ratings yet
Dell™ Optiplex™ 380 Service Manual - Mini-Tower: Notes, Cautions, and Warnings
54 pages
Pcxs2 Read
No ratings yet
Pcxs2 Read
4 pages
JUNOS OS For Dummies
From Everand
JUNOS OS For Dummies
Walter J. Goralski
No ratings yet
QUANTOM Fireball Lct15 Ata Jumpers
No ratings yet
QUANTOM Fireball Lct15 Ata Jumpers
3 pages
Diag Commands Alpine
100% (4)
Diag Commands Alpine
88 pages
IBM 360 Series Mainframe OSTL
No ratings yet
IBM 360 Series Mainframe OSTL
71 pages
PCSX2 1.4.0: Readme
No ratings yet
PCSX2 1.4.0: Readme
3 pages
PnE GDB Server Debug Configuration User Guide
No ratings yet
PnE GDB Server Debug Configuration User Guide
33 pages
Dell™ PowerEdge™ 2800 Systems User's Guide
No ratings yet
Dell™ PowerEdge™ 2800 Systems User's Guide
30 pages
Zoc English
No ratings yet
Zoc English
150 pages
1093970-1123905
No ratings yet
1093970-1123905
14 pages
PCSX2 Readme PDF
No ratings yet
PCSX2 Readme PDF
4 pages
1.1 Welcome To ZOC: Quick Start Guides
No ratings yet
1.1 Welcome To ZOC: Quick Start Guides
168 pages
sZ81 sZ81: sZ81 - A ZX81 and ZX80 Emulator Using SDL
No ratings yet
sZ81 sZ81: sZ81 - A ZX81 and ZX80 Emulator Using SDL
26 pages
Binary
No ratings yet
Binary
49 pages
All Products Esuprt Ser Stor Net Esuprt Poweredge Poweredge 500 User S Guide5 en Us 62b46254e0fae394330234
No ratings yet
All Products Esuprt Ser Stor Net Esuprt Poweredge Poweredge 500 User S Guide5 en Us 62b46254e0fae394330234
37 pages
Dell Precision™ Workstation M6500 Service Manual: Notes, Cautions, and Warnings
No ratings yet
Dell Precision™ Workstation M6500 Service Manual: Notes, Cautions, and Warnings
48 pages
Linux Services Deployment
From Everand
Linux Services Deployment
Fabian Mestre
No ratings yet
Hardinfo Report Rochmalia
No ratings yet
Hardinfo Report Rochmalia
12 pages
Report
No ratings yet
Report
75 pages
Zoc English
No ratings yet
Zoc English
166 pages
GeForce6100PM - M2 (2 - 0A) 47 PDF
No ratings yet
GeForce6100PM - M2 (2 - 0A) 47 PDF
1 page
UNIX Comandos
No ratings yet
UNIX Comandos
4 pages
COMO LIMPIAR CP PM CS 5.5
No ratings yet
COMO LIMPIAR CP PM CS 5.5
10 pages
Multicore DSP: From Algorithms to Real-time Implementation on the TMS320C66x SoC
From Everand
Multicore DSP: From Algorithms to Real-time Implementation on the TMS320C66x SoC
Naim Dahnoun
No ratings yet
COMPUTING BS6 (AutoRecovered)
No ratings yet
COMPUTING BS6 (AutoRecovered)
4 pages
Churyumov (Socionics) chapter 4 (part 1)
No ratings yet
Churyumov (Socionics) chapter 4 (part 1)
15 pages
Preparation of Drosophila Polytene Chromosome Squashes Practical Paper
No ratings yet
Preparation of Drosophila Polytene Chromosome Squashes Practical Paper
11 pages
FSA 8th Grade Countdown
No ratings yet
FSA 8th Grade Countdown
54 pages
St. John'S School Greater Noida West
No ratings yet
St. John'S School Greater Noida West
3 pages
A Study of Reconnaissance Surveillance UAV
100% (3)
A Study of Reconnaissance Surveillance UAV
99 pages
Application of Statistical Quality Control in Monitoring The Production, Packaging and Marketing Process of Sachet Water
No ratings yet
Application of Statistical Quality Control in Monitoring The Production, Packaging and Marketing Process of Sachet Water
15 pages
App3-ELC-SU-5270
No ratings yet
App3-ELC-SU-5270
29 pages
212MM212MMCH95
No ratings yet
212MM212MMCH95
26 pages
310SV+TurboSafe Rev.3
No ratings yet
310SV+TurboSafe Rev.3
2 pages
Phasefield
No ratings yet
Phasefield
3 pages
Session Assistant Professor (Economics) With Answer Key
No ratings yet
Session Assistant Professor (Economics) With Answer Key
10 pages
Iso 11666 (En1712)
No ratings yet
Iso 11666 (En1712)
24 pages
HE300 Cat 2015 64-65
No ratings yet
HE300 Cat 2015 64-65
2 pages
A Solar Observation Was Made in The Afternoon and The Following Quantities Have Been Determined
No ratings yet
A Solar Observation Was Made in The Afternoon and The Following Quantities Have Been Determined
5 pages
Catalogos Otto Bock
No ratings yet
Catalogos Otto Bock
31 pages
PED Lecture Notes 2021
No ratings yet
PED Lecture Notes 2021
53 pages
PHILIPS - 42PFL4506H Chassis TPM7.1E LA PDF
No ratings yet
PHILIPS - 42PFL4506H Chassis TPM7.1E LA PDF
83 pages
Score Template Orchestra
100% (1)
Score Template Orchestra
2 pages
Albumin
No ratings yet
Albumin
2 pages
Determination of The Surface Tension of Liquid Stainless Steel
No ratings yet
Determination of The Surface Tension of Liquid Stainless Steel
5 pages
Variable Switching Frequency PWM for Three-Phase
No ratings yet
Variable Switching Frequency PWM for Three-Phase
11 pages
Group-5 Fine Aggregates
No ratings yet
Group-5 Fine Aggregates
9 pages
42-0139!00!02-EXP, Antacid Analysis and Titration
0% (1)
42-0139!00!02-EXP, Antacid Analysis and Titration
18 pages
EMC Control Center
No ratings yet
EMC Control Center
3 pages
002 Testing of Hypothesis - One Sample
100% (1)
002 Testing of Hypothesis - One Sample
14 pages
What Is Lockbox in Account Receivables
No ratings yet
What Is Lockbox in Account Receivables
3 pages
Rs. 2,380 Rs. 1,985 Rs. 2,280 Rs. 2,280 Rs. 2,310 Rs. 1,740 Rs. 2,310
No ratings yet
Rs. 2,380 Rs. 1,985 Rs. 2,280 Rs. 2,280 Rs. 2,310 Rs. 1,740 Rs. 2,310
1 page
Unit 6
No ratings yet
Unit 6
18 pages