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

Hercules – Reference Summary

Version 4 Release 00

Draft - November 21, 2015

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

Hercules – Reference Summary

Version 4 Release 00

First Edition, November 21, 2015
HERS040000-00

1.         Preface

1.1 Edition information

This edition applies to the Hercules S/370, ESA/390 and z/Architecture Emulator, Release 4.00.0 and to all subsequent versions, releases and modifications until otherwise indicated in new editions. Make sure you are using the correct edition for the level of software you are using.

1.2 Revision Notice

Hercules Release:     Version 4 Release 00 Modification 0 Publication Number: HERS040000

SoftCopy Name:        HerculesReferenceSummary

Revision Number:      HERS040000-00

Date:                           November 21, 2015

1.3 Readers Comments

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

Send your comments by email to the Hercules-390 discussion group:

<wrap>hercules-390@yahoogroups.com</wrap>

Hercules Emulator V4.00                                             Page 5

2.        Hercules Configuration File

2.1 System Parameters

Hercules Emulator V4.00                                           Page 6

Hercules Emulator V4.00                                           Page 7

Hercules Emulator V4.00                                           Page 8

Hercules Emulator V4.00                                           Page 9

Table 1: Hercules System Parameters

Hercules Emulator V4.00                                             Page 10

2.2 Device Definitions

Hercules Emulator V4.00                                             Page 11

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

or

Êʬ¬ ARCHLVL ¬¬§¬¬ ENABLE ¬¬¬§¬¬ facility ¬¬¬¬¬¬¬¬¬¬¬¬Ê ⡿¬¬DISABLE ¬¬¯

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ª¬¬ S/370 ¬¬¬¬«

ª¬¬ ESA/390 ¬¬«
⡿¬¬z/ARCH ¬¬¬¯

or

Êʬ¬ ARCHLVL ¬¬§¬¬ ENABLE ¬¬¬§¬¬ bitno ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ⡿¬¬DISABLE ¬¬¯

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ª¬¬ S/370 ¬¬¬¬«

ª¬¬ ESA/390 ¬¬«
⡿¬¬z/ARCH ¬¬¬¯

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}

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

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

Hercules Emulator V4.00                                           Page 16

ª– GCPARM= –§– 0 –§——————————-« ⡿¬¬ n ^–

ª– NOSTRESS= –§– 0 –§—————————–« ⡿¬¬ 1 ^¬¬ª– FREEPEND= –§– -1 –§—————————-«

⡿¬¬ n ^—ª– FSYNC= –§– 0 –§——————————–«

⡿¬¬ 1 ¬¬¯ ª– TRACE= –§– 0 –§——————————–«

⡿¬¬ n ^–ª– LINUXNULL= –§– 0 –§—————————-«

⡿¬¬ 1 ¬¬

ª– GCSTART= –§– 0 –§——————————«

⡿¬¬ 1 ¬¬

CMDLEVEL (Set command group)

Descriptive

CMDLEVEL -} {ALL | </wrap>__<wrap>OPERator</wrap>__<wrap> | </wrap>__<wrap>MAINT</wrap>__<wrap> | </wrap>__<wrap>PROGrammer</wrap>__<wrap> | </wrap>__<wrap>CONFIGuration</wrap>__<wrap> | DEVELoper | DEBUG} [...]}</wrap> **__<wrap>Diagram</wrap>__****<wrap></wrap>** <wrap>~---------------------------------® ÊÊ-- CMDLEVEL --°-§-- + --§-§-- ALL ------------§-¨--ÊÍ</wrap> <wrap>⡿¬¬</wrap><wrap>- --¯ ª-- </wrap>__<wrap>OPERator</wrap>__<wrap> -------« ª-- </wrap>__<wrap>MAINT</wrap>__<wrap> ----------« ª-- </wrap>__<wrap>PROGrammer</wrap>__<wrap> -----« ª-- </wrap>__<wrap>CONFIGuration</wrap>__<wrap> --« ª-- DEVELoper ------« </wrap><wrap>⡿¬¬DEBUG ¬¬¬¬</wrap><wrap>------¯</wrap> <wrap>{{:hercules:refsum:bf:image022.gif|CMDLVL (Set command group)

CMDLVL is an alias for CMDLEVEL. See CMDLEVEL system parameter for details.

Hercules Emulator V4.00                                             Page 17

CMDSEP (Command line seperator)

Descriptive

CMDSEP {char | OFF}

Diagram

Êʬ¬ CF ¬¬§¬¬ char ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿¬¬OFF ¬¬¬¬

CNSLPORT (Console port)

Descriptive

CNSLPORT {3270 | port | host:port}

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 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

L¬¬ 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 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬«

⡿¬¬

¬¬¯

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

o.o.– LOGOPT –§— TIMESTAMP —§——————–o.Í

ª—– TIME ——«

ª– NOTIMESTAMP –«

⡿¬—

____  NOTIME —–¯

LPARNAME (LPAR name returned by DIAG x'204')

Descriptive

LPARNAME {HERCULES | 7parname}
Diagram

o.o.– LPARNAME –§– HERCULES –§———————o.Í ⡿¬¬7parname –

LPARNUM (LPAR identification number)

Descriptive

LPARNUM {BASIC | 1 | n | nn}

Diagram

o.o.– LPARNUM –§– BASIC –§————————-o.Í

ª— 1 —–«

ª— n —–«

⡿—

____  nn —-¯

MAINSIZE (Main storage size)

Descriptive

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

[UNLOCK | LOCK]

Diagram

~– M –® ~– UNLOCK

o.o.– 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:

Diagram

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

where option can be:

Hercules Emulator V4.00                                             Page 30

ª__§_____________ ON _______§

ª_____________ OFF ______« ª_____________ TEXT _____« ª_____________ TIME _____« ª_____________ NODEBUG __« ª_______§__§__ DEBUG ____« ª__ + __« ª__ TAPE _____« L¬¬- __¯ ª__ 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 | zVSE |

LINUX | OPENSOLARIS | QUIET | NULL}

Hercules Emulator V4.00                                             Page 31

Diagram

..– OSTAILOR –§——-§–§—— z/OS ——§

ª– + –« ª—– OS/390 —–«

⡿¬¬- –¯ ª——- VM ——-« ª—— VSE ——-« ª—– z/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 –§——————-.Í

⡿¬¬_ TICENSED ¬¬¬

Hercules Emulator V4.00                                             Page 32

PLANT (STSI plant code)

Descriptive

PLANT {ZZ | name}

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:

Hercules Emulator V4.00                                             Page 33

ª–§– ENABLE –§–§———

⡿¬¬

START ¬¬¬¯ ª– REGINA

⡿¬¬OOREXX

ª–§– 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 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬*Í L__ -years ¬¬

Hercules Emulator V4.00                                             Page 38

Process and Thread Priorities
Process Priorities

Table 3: Process Priority Conversions

Thread Priorities

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

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

ª¬¬¬¬¬¬ * ¬¬¬¬¬¬§¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

⡿¬¬ groupname ¬¬¯ ⡿¬¬ ipaddr ¬¬§¬¬¬¬¬¬¬¬¬¬«

⡿¬¬ mask ¬¬¯

Note: The device address is ignored for the integrated 3270 (SYSG) console.

Console Printer-Keyboard Devices

Descriptive

devaddr devtype [NOPROMPT]

[{groupname | *} [ipaddr [mask]]]

Diagram

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

⡿¬¬NOPROMPT¬¬¬¯

Hercules Emulator V4.00                                             Page 40

|

|

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 __i

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 –

or

Hercules Emulator V4.00                                             Page 42

|

|

|

ʬ¬ 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]

arguments

where arguments can be:

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

­                                             ⡿¬¬ n ¬¬§¬¬¬¬¬¬¬« ­

-                                                                   ª¬¬ K ¬¬« ­

­                                                                         ª¬¬M¬¬« ­

­                                                                           ª¬¬G¬¬« ­

-                                                                          ⡿¬¬T¬¬¯ ­

ª¬¬ MAXSIZEK= ¬¬§¬¬ 0 ¬¬§¬¬§¬¬¬¬¬¬¬¯

­                                          ⡿¬¬n ¬¬¯ ­
⡿¬¬MAXSIZEM= ¬¬§¬¬0 ¬¬§¬¬¯

⡿¬¬ n ¬¬

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

⡿_____*_____

⡿__°__I 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 __¯

ª__ READONLY= __§__ 0 __§____________________________«

⡿ØØ 1 ØØ

ª__ STRICTSIZE= __§__ 0 __§__________________________«

⡿ØØ 1 ØØ

ª__§____ RO ____§____________________________________«

ª__ NORING __«

ª____ RW ____«

⡿ØØØRING ___

ª__ DEONIRQ= __§__ 0 __§_____________________________«

⡿ØØ 1 ØØ

ª__ NOAUTOMOUNT _____________________________________« Fake Tape virtual files

Descriptive

devaddr devtype {fakefile | *} [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]

[DEONIRQ={0 | 1}]

Hercules Emulator V4.00                                           Page 46

[NOAUTOMOUNT]

Diagram

ÊÊ__ devaddr __ devtype __§__ fakefile __§___________Ê

⡿ØØØØØ*ØØØØØØ

arguments

where arguments can be:

ª__§__ MAXSIZE= ___§__ 0 __________§__§______________«

­                                           ⡿ØØ n __§_______« ­

­                                            ª__ K __« ­

­                                                                           ªØØMØØ« ­

­                                                                            ªØØGØØ« ­

­                                                                             ⡿ØØTØد ­

ª__ MAXSIZEK= __§__ 0 __§__§_______¯

­                           ⡿ØØ n Øد ­
⡿ØØMAXSIZEM=ØاØØ 0 __§__¯

⡿ØØ n __¯

ª__ 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 sport rhost rport bufsize

Diagram

ÊÊ– devaddr – CTCT – sport – 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

**********************************************

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

PTP (MPCPTP / PCPTP6 Channel-to-Channel link) Descriptive

devaddr PTP [{-n | –dev} name]

[{-m | –mac} mac]

[{-t | –mtu} mtu | 1500]

[{-i | –ibuff} {ibuff | 64}]

[{-k | –kbuff} {kbuff | 1024}]

[-4 | –inet]

[-6 | –inet6]

[-d | –debug]

guest1 host1
[guest2 host2]

Diagram

Êʬ¬ devaddr ¬¬ PTP ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬

ª¬¬¬¬ -n ¬¬¬§¬¬ name

⡿¬¬–dev ¬¬

ª¬¬¬¬ -m ¬¬¬§¬¬ mac
⡿¬¬–mac ¬¬

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ª¬¬¬¬ -t ¬¬¬§¬¬ mtu ¬¬¯ ⡿¬¬–mtu ¬¬

ʬ¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ª¬¬¬¬¬ -i ¬¬¬¬§¬¬§¬¬ ibuff ¬¬« ⡿¬¬–ibuff ¬¬¯ ⡿¬ ¬¬ 64 ¬¬¬¬¯

Hercules Emulator V4.00                                             Page 50

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

ª¬¬¬¬¬ -k ¬¬¬¬§¬¬§¬¬ kbuff ¬¬«

⡿¬¬–kbuff ¬¬I ⡿¬¬ 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

or

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

or

ÊÊ__ devaddr __ devtype __ ipname ___________________Ê

~__ :3990 __®

Ê__¦___________¦__§_____________§__§____________§___ÊÍ '¬¬ :port ¬¬¯ '¬¬ :devnum ¬¬¯ '¬¬ COMP=n __¯

Default CU Types

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

Hercules Emulator V4.00                                             Page 55

Hercules Emulator V4.00                                             Page 56

Hercules Emulator V4.00                                             Page 57

Hercules Emulator V4.00                                             Page 58

Hercules Emulator V4.00                                             Page 59

Hercules Emulator V4.00                                             Page 60

Hercules Emulator V4.00                                             Page 61

Hercules Emulator V4.00                                             Page 62

Hercules Emulator V4.00                                             Page 63

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

ABS (Display or alter absolute storage)

Descriptive

ABS {addr | addr.length | addr-addr | addr=value}

Diagram

Êʬ¬ ABS ¬¬§¬¬¬¬¬¬ addr ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

ª¬¬ addr.length ¬¬«

ª¬¬¬ addr-addr ¬¬¬«

⡿ØØaddr=value ¬¬¬¯

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___

Hercules Emulator V4.00                                             Page 67

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 ¬¬¬« ⡿..z/ARCH ¬¬¬¯

or

Êʬ¬ ARCHLVL ¬¬§¬¬ ENABLE ¬¬¬§¬¬ facility ¬¬¬¬¬¬¬¬¬¬¬¬Ê ⡿.. DISABLE ..

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

ª¬¬ S/370 ¬¬¬¬«

ª¬¬ ESA/390 ¬¬«

⡿.. zfARCH…¯

or

Êʬ¬ ARCHLVL ¬¬§¬¬ ENABLE ¬¬¬§¬¬ bitno ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ⡿.. DISABLE ¬¬

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

ª¬¬ S/370 ¬¬¬¬«

ª¬¬ ESA/390 ¬¬«

⡿.. zfARCH…¯

Hercules Emulator V4.00                                             Page 68

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

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

­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­

⡿¬¬°¬¬ 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}

Hercules Emulator V4.00                                             Page 69

or

AUTOMOUNT [+ | -]directory

Diagram

or

Êʬ¬ AUTOMOUNT ¬¬§¬¬ ADD directory ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
⡿ØØDEL directory ¬¬

B (Set breakpoint)

Descriptive

B {addr | addr–addr}

Diagram

Êʬ¬ B ¬¬§¬¬¬¬¬ addr ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿ØØ addr-addr ¬¬¬

B+ (Set breakpoint)

Descriptive

B+ {addr | addr–addr}

Diagram

Êʬ¬ B+ ¬¬§¬¬¬¬¬ addr ¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿ØØaddr-addr ¬¬¬

B- (Delete breakpoint)

Descriptive

B-

Diagram

Êʬ¬ B __ -

CACHE (Execute cache related commands)

Descriptive

CACHE [DASD SYSTEM [ON | OFF]]

Hercules Emulator V4.00                                             Page 70

Diagram

**¬¬ CACHE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬*Í

__ DASD SYSTEM___§_________«

ª¬¬ ON ¬¬¬«

__OFF__¯

CACHESTATS (Display cache statistics)

Descriptive
CACHESTATS

Diagram

**¬¬ CACHESTATS

CAPPING (Display or set CPU capping value)

Descriptive

CAPPING [mips | OFF | 0]
Diagram

**¬¬ CAPPING ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬*Í

ª¬¬ mips ¬¬«

ª¬¬ OFF ¬¬¬«

L___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}]

Hercules Emulator V4.00                                             Page 71

[,GCPARM={0 | n}]
[,NOSTRESS={0 | 1}]
[,FREEPEND={-1 | n}]
[,FSYNC={0 | 1}]
[,TRACE={0 | n}]
[,LINUXNULL={0 | 1}]
[,GCSTART={0 | 1}]

Diagram

~¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬® o.o.¬¬ CCKD ¬¬§¬¬°¬¬« option=value ª¬¬¨¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬o.Í

ª¬¬¬¬¬¬¬¬¬¬ HELP ¬¬¬¬¬¬¬¬¬¬« ª¬¬¬¬¬¬¬¬¬¬ STATS ¬¬¬¬¬¬¬¬¬« ⡿¬¬¬¬¬¬¬¬¬¬OPTS ¬¬¬¬¬¬¬¬¬¬¯ where option can be:

ª¬¬ COMP= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬¬ n ^¬¬

ª¬¬ COMPPARM= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬¬n ¬¬¯

ª¬¬ RA= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ n ¬¬¯

ª¬¬ RAQ= ¬¬§¬¬ 4 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ n ^¬¬

ª¬¬ RAT= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ n ¬¬¯

ª¬¬ WR= ¬¬§¬¬ 2 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ n ^¬¬

ª¬¬ GCINT= ¬¬§¬¬ 5 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ n ^¬¬

ª¬¬ GCPARM= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ n ^¬¬

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

⡿¬¬ 1 ^¬¬ª¬¬ FREEPEND= ¬¬§¬¬ -1 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ n ¬¬

Hercules Emulator V4.00                                           Page 72

ª¬¬ FSYNC= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ 1 ¬¬¯

ª¬¬ TRACE= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ n ¬¬

ª¬¬ LINUXNULL= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ 1 ¬¬

ª¬¬ GCSTART= ¬¬§¬¬ 0 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬« ⡿¬¬ 1 ¬¬

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

Hercules Emulator V4.00                                             Page 73

CLOCKS (Display TOD clock and CPU timer)

Descriptive

CLOCKS

Diagram

**¬¬ CLOCKS

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

Hercules Emulator V4.00                                             Page 74

CMDTGT (Specify command target)

Descriptive

CMDTGT {HERC | SCP | PSCP | ?}

Diagram

..¬¬ CMDTGT ¬¬§¬¬ HERC ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬.Í

ª¬¬ SCP ¬¬¬«

ª¬¬ PSCP ¬¬«

⡿¬¬¬ ? ¬¬¬¬¯

CNSLPORT (Display or set telnet client port)

Descriptive

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

CPUSERIAL (Display or set CPU serial num­ber)

Descriptive

CPUMODEL [serial]

Diagram

oo¬¬ CPUMODEL¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬oÍ ⡿ØØserial ¬¬¯

CPUVERID (Display or set CPU version code)

Descriptive

CPUVERID [verid]

Diagram

oo¬¬ CPUVERID¬¬§¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬oÍ ⡿ØØverid ¬¬¯

CR (Display or alter control registers)

Descriptive

CR [nn=xxxxxxxx | nn=xxxxxxxxxxxxxxxx]

Diagram

oo¬¬ CR ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§ ª¬¬¬¬¬¬ nn=xxxxxxxx ¬¬¬¬¬¬« ⡿ØØnn=xxxxxxxxxxxxxxxx ¬¬

CSCRIPT (Cancel a running script thread)

Descriptive

CSCRIPT [* | ALL | id]

Diagram

oo¬¬ CSCRIPT ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬oÍ

ª¬¬¬ * ¬¬¬« ª¬¬ 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)

|

| |

| |

| |

| |

|

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)

Descriptive

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

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} [, … ]

Diagram

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

­                                                                                                                                                        ­

Êʬ¬ ENGINES ¬¬°¬¬§¬¬¬¬¬¬¬¬¬§¬¬§¬¬ CP ¬¬§¬¬¨¬¬¬¬¬¬¬¬¬ÊÍ

⡿¬¬nn* ¬¬¯ ª¬¬ IL ¬¬«

ª¬¬ AP ¬¬«

⡿¬¬

______  IP ¬¬¯

EXEC (Execute a REXX script)

Descriptive

EXEC [COMMAND | SUBROUTINE] rexx
[argument [argument … ]]

Diagram

|

| |

| |

|

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

­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬® ­
⡿¬¬°¬¬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 register)

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 ¬¬¬¬ L__ 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}

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

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

LEGACYSENSEID (Display or set SENSE ID CCW (x'E40) feature)

Descriptive

LEGACYSENSEID [OFF | DISABLE | ON | ENABLE]

Diagram

Êʬ¬ LEGACYSENSEID ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê4 ª¬¬¬¬ OFF ¬¬¬¬« ª¬¬ DISABLE ¬¬« ª¬¬¬¬ ON ¬¬¬¬¬« ⡿¬¬ENABLE ¬¬¬¯

LOADCORE (Load a core image from a file)

Descriptive

LOADCORE filename [address | 0]

LOADPARM (Set IPL parameter)

Descriptive

LOADPARM [ipl parameter]

Diagram

Êʬ¬ LOADPARM ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê4
⡿¬¬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

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)

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

L__ CLEAR__¯

MSGLEVEL (Display or set the current message display output)

Descriptive

MSGLEVEL [option option …]

where option can be:

Diagram

Êʬ¬ MSGLEVEL ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬

­ ~¬¬¬¬¬¬¬¬¬¬
⡿__°__« option

where option can be:

Hercules Emulator V4.00                                             Page 96

ª__§_____________ ON _______§

ª_____________ OFF ______« ª_____________ TEXT _____« ª_____________ TIME _____« ª_____________ NODEBUG __« ª_______§__§__ DEBUG ____« ª__ + __« ª__ TAPE _____« L¬¬- __¯ ª__ 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)

Descriptive

MT device operation

where operation can be:

REW

ASF [nnnn | 1]

FSF [nnnn | 1]

BSF [nnnn | 1]

FSR [nnnn | 1]

BSR [nnnn | 1]

WTM [nnnn | 1]

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

 ¬¬¯

NUMVEC (Display or set number of vector facilities)

Descriptive

NUMVEC [nn]

Diagram

Êʬ¬ NUMVEC ¬¬§¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿¬¬

 ¬¬¯

OSTAILOR (Tailor trace information for spe­cific operating system)

Descriptive

OSTAILOR -] z/OS | OS/390 | VM | VSE | z/VSE | LINUX | OPENSOLARIS | QUIET | NULL]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>Êʬ¬ OSTAILOR</wrap> <wrap>+ ¬¬« ª¬¬¬¬¬¬ z/OS ¬¬¬¬¬¬«</wrap> <wrap>- ¬¬¯ ª¬¬¬¬¬ OS/390 ¬¬¬¬¬« ª¬¬¬¬¬¬¬ VM ¬¬¬¬¬¬¬« ª¬¬¬¬¬¬ VSE ¬¬¬¬¬¬¬« ª¬¬¬¬¬ z/VSE ¬¬¬¬¬¬« ª¬¬¬¬¬ LINUX ¬¬¬¬¬¬« ª¬¬ OPENSOLARIS ¬¬¬</wrap>__<wrap>«</wrap>__<wrap> ª¬¬¬¬¬ QUIET ¬¬¬¬¬¬« </wrap><wrap>⡿¬¬¬¬¬NULL ¬¬¬¬¬¬¬¯</wrap> <wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap>**<wrap>PANRATE (Display or set pamel refresh rate)</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PANRATE [SLOW | FAST | </wrap>//<wrap>rate</wrap>//<wrap>]</wrap> **__<wrap>Diagram</wrap>__****<wrap></wrap>** <wrap>Êʬ¬ PANRATE ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ</wrap> <wrap>ª¬¬ SLOW ¬¬«</wrap> <wrap>ª¬¬ FAST ¬¬«</wrap> <wrap>⡿¬</wrap><wrap>¬ </wrap>//<wrap>rate </wrap>//<wrap>¬¬¯</wrap> <wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00                                             Page 99</wrap> <wrap>\\ </wrap><wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap>**<wrap>PANTITLE (Hercules console window title)</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PANTITLE [</wrap>//<wrap>text </wrap>//<wrap>| </wrap>//<wrap>"text text text" </wrap>//<wrap>| ""]</wrap> |<WRAP>**__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>Êʬ¬ PANTITLE</wrap> </WRAP> |<WRAP><wrap>¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬Ê4 ª¬¬¬¬¬¬¬¬ </wrap>//<wrap>text </wrap>//<wrap>¬¬¬¬¬¬¬¬«</wrap> <wrap>ª¬¬ </wrap>//<wrap>"text text text" </wrap>//<wrap>¬¬«</wrap> <wrap>⡿¬¬¬¬¬¬¬¬¬</wrap><wrap>"" ¬¬¬¬¬¬¬¬¬¯</wrap> </WRAP> | <wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap>**<wrap>PGMPRDOS (Set LPP license setting)</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PGMPRDOS {RESTRICTED | LICENSED}</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>Êʬ¬ PGMPRDOS ¬¬§¬¬ RESTRICTED ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê4 </wrap><wrap>⡿¬¬¬LICENSED ¬¬¬</wrap> <wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap>**<wrap>PGMTRACE (Trace program interrupts)</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PGMTRACE [[-]</wrap>//<wrap>intcode</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>Êʬ¬ PGMTRACE ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê4 \\ ª¬¬¬¬¬¬¬§¬¬ </wrap>//<wrap>intcode </wrap>//<wrap>¬¬¯ </wrap><wrap>⡿¬¬ </wrap><wrap>- ¬¬¯</wrap> <wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap>**<wrap>PLANT (Display or set STSI plant code)</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>MANUFACTURER [</wrap>//<wrap>name</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>Êʬ¬ MANUFACTURER ¬¬§¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê4 </wrap><wrap>⡿¬¬</wrap>//<wrap>name </wrap>//<wrap>¬¬¯</wrap> <wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap><wrap>Hercules Emulator V4.00                                             Page 100</wrap> <wrap>\\ </wrap><wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap>**<wrap>PR (Display prefix register)</wrap>** **__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>PR</wrap> **__<wrap>Diagram</wrap>__****<wrap></wrap>** <wrap>Êʬ¬ PR _  </wrap> <wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap>**<wrap>PSCP (Send system control program priority message)</wrap>** **__<wrap>Descriptive</wrap>__****<wrap></wrap>** <wrap>PSCP [</wrap>//<wrap>cmd</wrap>//<wrap>]</wrap> **__<wrap>Diagram </wrap>__****<wrap></wrap>** <wrap>ÊÊ</wrap><wrap>¬¬ PSCP ¬¬§¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿¬¬</wrap>//<wrap>cmd </wrap>//<wrap>¬¬¯</wrap> <wrap><wrap>{{:hercules:refsum:bf:image007.gif|}}</wrap></wrap>**<wrap>PSW (Display or alter program status word)</wrap>** **__<wrap>Descriptive </wrap>__****<wrap></wrap>** <wrap>PSW [</wrap>//<wrap>operand=value </wrap>//<wrap>[</wrap>//<wrap>operand=value </wrap>//<wrap>...

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

­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬
⡿¬¬°¬¬I operand=value

Hercules Emulator V4.00                                             Page 101

|

| [NOSIGNAL | SIGNAL]
[NOIO | IO]

[NOTIMER | TIMER]
[NOTHREADS | THREADS]

[NOLOCK | LOCK]
[NOTOD | TOD]

[NOLOGGER | LOGGER]
[NOWRAP | WRAP]
[TO=nnn] [mmmmm]

Diagram

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

Êʬ¬ PTT ¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬Ê

⡿¬¬¬ERROR ¬¬¬¯ ⡿¬ ¬¬ CONTROL ¬¬¬¯

PROG

INTER

~¬¬ NOPROG ¬¬® ~¬¬ NOINTER ¬¬® ~¬¬ NOSIE ¬¬®

ʬ¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¦¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬Ê

⡿¬¬¬

¬¬¬¯ ⡿¬¬¬

¬¬¬¯ ⡿¬¬¬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 device information)

Descriptive

QD [devnum | devclass]
Diagram

..¬¬ QD ¬¬§¬¬¬¬¬¬¬¬¬¬¬

ª¬¬¬ devnum
⡿ج devclass

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]

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

ª–§– 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 | *]

~¬¬¬ * ¬¬¬®

ʬ¬¦¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ ⡿ØØ 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

6.1 SCRIPT (Run a sequence of commands contained 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 __«

L__ 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 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬*Í L¬¬ 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]}

Diagram

**¬¬ SYSEPOCH ¬¬§¬¬ 1900 ¬¬¬¬¬¬¬¬¬¬¬¬ ª¬¬ 1960 ¬¬¬¬¬¬¬¬¬¬¬¬ ⡿ØØyear ¬¬§¬¬¬¬¬¬¬¬¬

ª¬¬ +years

⡿ØØ-years

Hercules Emulator V4.00                                            Page 116

SYSRESET (SYSTEM RESET manual operation)

Descriptive

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 ¬¬® I

*¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¯

⡿¬¬¬ LOCK ¬¬¬¯

Hercules Emulator V4.00                                             Page 121

YROFFSET (Set TOD clock offset from actual date)

Descriptive

YROFFSET {+years | -years}

Diagram

Êʬ¬ YROFFSET ¬¬§¬¬ +years ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ L¬¬ -years ¬¬

Hercules Emulator V4.00                                             Page 122

7.        Hercules Utilities

DASD Utilities

Table 7: DASD Utilities

Hercules Emulator V4.00                                           Page 123

TAPE Utilities

|

|

|

Table 8: TAPE Utilities

Miscellanious Utilities

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

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

-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 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬*Í

L¬¬ SF=shadowfile ¬¬¯

DASDLOAD (DASD loader program)

Descriptive

DASDLOAD [-option [-option … ]]
ctlfile outfile ,nsglevel

Diagram

**¬¬ DASDLOAD ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬*

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

*¬¬ ctlfile ¬¬ outfile ¬¬ ,nsglevel ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬*Í

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

¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê ⡿ØØ-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 ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬*

L 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]

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

L__ -f configfile ¬¬¯

Starting Hercules with the Hercules Studio

Descriptive

HERCULESSTUDIO [-f configfile] [-r rcfile]

Diagram

Êʬ¬ HERCULESSTUDIO ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬Ê

L_ -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).

Hercules Emulator V4.00                                             Page 141

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.

Hercules Emulator V4.00                                             Page 142

Table 11: Extended cursor handling

Windows event handler

The following table shows the trapped Windows events.

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

­ ~¬¬¬¬¬¬¬¬¬¬¬¬¬¬® I

⡿¬¬°¬¬§¬_ &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

Hercules Emulator V4.00                                            Page 145

Table 13: Supported CKD DASD Devices

Hercules Emulator V4.00                                            Page 146

FBA Devices

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

Hercules Emulator V4.00                                            Page 148

Table 15: Reading Syntax Descriptions

B2. Reading Syntax Diagrams

Hercules Emulator V4.00                                            Page 149

Hercules Emulator V4.00                                             Page 150

Table 16: Reading Syntax Diagrams

Hercules Emulator V4.00                                             Page 151

|

|||| |

Hercules Emulator V4.00                                             Page 152